From e006fdd7f35cc89ce9ecacf0aece1d51be197504 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Sat, 6 Jan 2024 09:42:19 +0100
Subject: [PATCH 001/267] add bch-guru to showcase section

---
 website/docs/showcase.md       |   8 ++++++++
 website/static/img/bchguru.jpg | Bin 0 -> 25057 bytes
 2 files changed, 8 insertions(+)
 create mode 100644 website/static/img/bchguru.jpg

diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index 1c953d65..d336a911 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -36,6 +36,14 @@ Bitcats Heroes is the first collectibele NFT series on Bitcoin Cash. The project
 
 Cash-Ninjas is a collectibele NFT project on Bitcoin Cash which focuses on building open-source tooling! The Cash-Ninjas project uses CashScript for its non-custodial, multi-threaded minting contract. The contract is open source for others to inspect and use the contract code. The Cash-Ninjas minting page uses wallet connect to allow minting directly from the user's smart contract wallet.
 
+## BCH Guru
+
+<div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
+    <a href="https://bch.guru/" target="_blank"><img style={{borderRadius: '100%'}} src="/img/bchguru.jpg" /></a>
+</div>
+
+BCH Guru is a non-custodial price-prediction platform and a collectible NFT project. BCH Guru uses CashScript for its price-prediction smart contracts to have players commit to a secret price-prediction. The project was the first to pioneer integration with CashConnect, which allows wallets to recognize the smart contract template and understand contract details.
+
 ## Unspent Phi
 
 <div style={{textAlign: 'center', width: '50%', margin: 'auto', marginBottom: '20px'}}>
diff --git a/website/static/img/bchguru.jpg b/website/static/img/bchguru.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..92cd8fc9b75937d2c50ade5ec53a4eaaff1a512e
GIT binary patch
literal 25057
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

literal 0
HcmV?d00001


From dc566a7b379926e26df626435a5f6966d234f25c Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 10 Jan 2024 10:20:00 +0100
Subject: [PATCH 002/267] Move the JestExtensions file into the src directory

---
 packages/cashscript/{ => src}/test/JestExtensions.ts | 2 +-
 packages/cashscript/test/LibauthTemplate.test.ts     | 2 +-
 packages/cashscript/tsconfig.build.json              | 1 -
 3 files changed, 2 insertions(+), 3 deletions(-)
 rename packages/cashscript/{ => src}/test/JestExtensions.ts (98%)

diff --git a/packages/cashscript/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
similarity index 98%
rename from packages/cashscript/test/JestExtensions.ts
rename to packages/cashscript/src/test/JestExtensions.ts
index 76e0185b..7d4de86a 100644
--- a/packages/cashscript/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -1,7 +1,7 @@
 import { MatcherContext } from '@jest/expect';
 import { SyncExpectationResult } from 'expect';
 import { printExpected, printReceived, matcherHint } from 'jest-matcher-utils';
-import { Transaction } from '../src/index.js';
+import { Transaction } from '../index.js';
 
 export {};
 
diff --git a/packages/cashscript/test/LibauthTemplate.test.ts b/packages/cashscript/test/LibauthTemplate.test.ts
index 9eb9cd8f..20d57139 100644
--- a/packages/cashscript/test/LibauthTemplate.test.ts
+++ b/packages/cashscript/test/LibauthTemplate.test.ts
@@ -3,7 +3,7 @@ import { Contract, MockNetworkProvider, SignatureTemplate } from '../src/index.j
 import {
   alicePriv, alicePub, bobPriv, bobPub,
 } from './fixture/vars.js';
-import './JestExtensions.js';
+import '../src/test/JestExtensions.js';
 import { randomUtxo } from '../src/utils.js';
 
 describe('Libauth template generation tests', () => {
diff --git a/packages/cashscript/tsconfig.build.json b/packages/cashscript/tsconfig.build.json
index 48a56f11..e4239e0e 100644
--- a/packages/cashscript/tsconfig.build.json
+++ b/packages/cashscript/tsconfig.build.json
@@ -7,7 +7,6 @@
 
   "include": [
     "src/**/*",
-    "test/JestExtensions.ts",
   ],
 
   "exclude": [

From a79bb34d39e535b40b81b14dd3414d5b7cd0fa3c Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 10 Jan 2024 10:21:47 +0100
Subject: [PATCH 003/267] Bump version to 0.10.0-next.1

---
 examples/package.json            | 6 +++---
 packages/cashc/package.json      | 4 ++--
 packages/cashc/src/index.ts      | 2 +-
 packages/cashscript/package.json | 4 ++--
 packages/utils/package.json      | 2 +-
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index e839702d..4c8e350a 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.0-next.0",
+  "version": "0.10.0-next.1",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -14,8 +14,8 @@
     "@bitauth/libauth": "^2.0.0-alpha.8",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
-    "cashc": "^0.10.0-next.0",
-    "cashscript": "^0.10.0-next.0",
+    "cashc": "^0.10.0-next.1",
+    "cashscript": "^0.10.0-next.1",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index f6509938..17039dcd 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.0-next.0",
+  "version": "0.10.0-next.1",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0-alpha.8",
-    "@cashscript/utils": "^0.10.0-next.0",
+    "@cashscript/utils": "^0.10.0-next.1",
     "antlr4ts": "^0.5.0-alpha.4",
     "commander": "^7.1.0",
     "semver": "^7.3.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 28b8f48e..eb8f7e76 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.0-next.0';
+export const version = '0.10.0-next.1';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index d17f0464..3a091e3d 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.0-next.0",
+  "version": "0.10.0-next.1",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0-alpha.8",
-    "@cashscript/utils": "^0.10.0-next.0",
+    "@cashscript/utils": "^0.10.0-next.1",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 9eb99c0d..b0f49088 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.0-next.0",
+  "version": "0.10.0-next.1",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From 40c575741c526637ce43b20ec664ac8a0e84d606 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 10 Jan 2024 10:27:27 +0100
Subject: [PATCH 004/267] Add DEVELOPMENT.md

---
 DEVELOPMENT.md | 7 +++++++
 1 file changed, 7 insertions(+)
 create mode 100644 DEVELOPMENT.md

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
new file mode 100644
index 00000000..007830f7
--- /dev/null
+++ b/DEVELOPMENT.md
@@ -0,0 +1,7 @@
+We use yarn workspaces + lerna for monorepo management. So to get started, clone this repository and run `yarn` in the root directory to install all dependencies for all packages.
+
+When updating code in one package, you can run `yarn build` in the root directory to build all packages so the changes get propagated to the other packages as well.
+
+### Publishing a release
+
+To publish a new release, we use `yarn update-version 'x.x.x'` in the root directory to bump the version before release, and then `yarn publish-all` in the root directory to publish the release. In case of a tagged release (such as `next`), we use `yarn publish-all --dist-tag <tag name>` to publish the release with the specified tag.

From 1370c6b1b1489b96964b6df4a860709cd73a06cc Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 10 Jan 2024 10:33:44 +0100
Subject: [PATCH 005/267] Fix tests

---
 packages/utils/test/bitauth-script.test.ts    |  4 +-
 .../test/fixtures/bitauth-script.fixture.ts   | 82 +++++++++----------
 2 files changed, 43 insertions(+), 43 deletions(-)

diff --git a/packages/utils/test/bitauth-script.test.ts b/packages/utils/test/bitauth-script.test.ts
index fda79864..4e74961d 100644
--- a/packages/utils/test/bitauth-script.test.ts
+++ b/packages/utils/test/bitauth-script.test.ts
@@ -16,8 +16,8 @@ describe('Libauth Script formatting', () => {
       });
 
       it('should format script as debugging output for BitAuth IDE', () => {
-        expect(formatBitAuthScript(scriptBytecode, fixture.sourceMap, fixture.sourceCode))
-          .toBe(fixture.expectedBitAuthScript);
+        const expectedBitAuthScript = fixture.expectedBitAuthScript.replace(/^\n+/, '').replace(/\n+$/, '');
+        expect(formatBitAuthScript(scriptBytecode, fixture.sourceMap, fixture.sourceCode)).toBe(expectedBitAuthScript);
       });
     });
   });
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index 63c760be..8bf67016 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -127,13 +127,13 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
     sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9;24:31:24:32:0;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
     expectedLineToOpcodeMap: {
       9: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
-      13: [Op.OP_0, Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_2, Op.OP_ROLL, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUAL, Op.OP_VERIFY],
+      13: [new Uint8Array([]), Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_2, Op.OP_ROLL, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUAL, Op.OP_VERIFY],
       15: [hexToBin('e803')],
       16: [Op.OP_INPUTINDEX, Op.OP_UTXOVALUE],
-      17: [Op.OP_0, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_2, Op.OP_PICK, Op.OP_SUB],
-      21: [Op.OP_0, Op.OP_PICK, Op.OP_5, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_ADD, Op.OP_LESSTHANOREQUAL, Op.OP_IF],
-      22: [Op.OP_0, Op.OP_OUTPUTVALUE, Op.OP_2, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      24: [Op.OP_0, Op.OP_OUTPUTVALUE, Op.OP_5, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      17: [new Uint8Array([]), Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_2, Op.OP_PICK, Op.OP_SUB],
+      21: [new Uint8Array([]), Op.OP_PICK, Op.OP_5, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_ADD, Op.OP_LESSTHANOREQUAL, Op.OP_IF],
+      22: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_2, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      24: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_5, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
       25: [Op.OP_1, Op.OP_OUTPUTBYTECODE, Op.OP_INPUTINDEX, Op.OP_UTXOBYTECODE, Op.OP_EQUAL, Op.OP_VERIFY],
       26: [Op.OP_1, Op.OP_OUTPUTVALUE, Op.OP_1, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
       27: [Op.OP_ELSE, Op.OP_ENDIF],
@@ -164,41 +164,41 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
       34: 'OP_ENDIF',
     },
     expectedBitAuthScript: `
-                                                                                             /*                                                                                                                    */
-                                                                                             /* pragma cashscript >=0.8.0;                                                                                         */
-                                                                                             /*                                                                                                                    */
-                                                                                             /* /* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                        */
-                                                                                             /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */
-                                                                                             /*  * of covenants in CashScript.                                                                                     */
-                                                                                             /*  * The time checking has been removed so it can be tested without time requirements.                               */
-                                                                                             /*  */                                                                                                                */
-    OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {                                 */
-                                                                                             /*     function receive() {                                                                                           */
-                                                                                             /*         // require(tx.age >= period);                                                                              */
-                                                                                             /*                                                                                                                    */
-    OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         // Check that the first output sends to the recipient                                                      */
-                                                                                             /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */
-    <0xe803>                                                                                 /*                                                                                                                    */
-    OP_INPUTINDEX OP_UTXOVALUE                                                               /*         int minerFee = 1000;                                                                                       */
-    OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */
-                                                                                             /*         int changeValue = currentValue - pledge - minerFee;                                                        */
-                                                                                             /*                                                                                                                    */
-                                                                                             /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */
-    OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */
-    OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*         if (changeValue <= pledge + minerFee) {                                                                    */
-                                                                                             /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */
-    OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*         } else {                                                                                                   */
-    OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[0].value == pledge);                                                                */
-    OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */
-    OP_ELSE OP_ENDIF                                                                         /*             require(tx.outputs[1].value == changeValue);                                                           */
-    OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*         }                                                                                                          */
-                                                                                             /*     }                                                                                                              */
-    OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*                                                                                                                    */
-    OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */
-    OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(hash160(pk) == funder);                                                                            */
-    OP_NIP OP_NIP                                                                            /*         require(checkSig(s, pk));                                                                                  */
-    OP_ENDIF                                                                                 /*     }                                                                                                              */
-                                                                                             /* }                                                                                                                  */
-`,
+                                                                                         /*                                                                                                                    */
+                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */
+                                                                                         /*                                                                                                                    */
+                                                                                         /* /* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                        */
+                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */
+                                                                                         /*  * of covenants in CashScript.                                                                                     */
+                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */
+                                                                                         /*  */                                                                                                                */
+OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {                                 */
+                                                                                         /*     function receive() {                                                                                           */
+                                                                                         /*         // require(tx.age >= period);                                                                              */
+                                                                                         /*                                                                                                                    */
+OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         // Check that the first output sends to the recipient                                                      */
+                                                                                         /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */
+<0xe803>                                                                                 /*                                                                                                                    */
+OP_INPUTINDEX OP_UTXOVALUE                                                               /*         int minerFee = 1000;                                                                                       */
+OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */
+                                                                                         /*         int changeValue = currentValue - pledge - minerFee;                                                        */
+                                                                                         /*                                                                                                                    */
+                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */
+OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */
+OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*         if (changeValue <= pledge + minerFee) {                                                                    */
+                                                                                         /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */
+OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*         } else {                                                                                                   */
+OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[0].value == pledge);                                                                */
+OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */
+OP_ELSE OP_ENDIF                                                                         /*             require(tx.outputs[1].value == changeValue);                                                           */
+OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*         }                                                                                                          */
+                                                                                         /*     }                                                                                                              */
+OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*                                                                                                                    */
+OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */
+OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(hash160(pk) == funder);                                                                            */
+OP_NIP OP_NIP                                                                            /*         require(checkSig(s, pk));                                                                                  */
+OP_ENDIF                                                                                 /*     }                                                                                                              */
+                                                                                         /* }                                                                                                                  */
+`.replace(/^\n+/, '').replace(/\n+$/, ''),
   },
 ];

From 591f71f3c980f54be3b14ef578889d1c4f4d4d9e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 10 Jan 2024 10:50:14 +0100
Subject: [PATCH 006/267] Fix interfaces import

---
 .gitignore                                 | 2 ++
 packages/cashscript/src/LibauthTemplate.ts | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index f2b6e1e1..1945b137 100644
--- a/.gitignore
+++ b/.gitignore
@@ -105,3 +105,5 @@ typings/
 
 # DynamoDB Local files
 .dynamodb/
+
+manual-test.ts
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 4e16aa40..cfc2018e 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -30,7 +30,7 @@ import {
   LibauthOutput,
   Utxo,
   isUtxoP2PKH,
-} from '../src/interfaces.js';
+} from './interfaces.js';
 import { Argument, encodeArgument as csEncodeArgument } from './Argument.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';

From 61950f8f8d4e62d60ff1bf38c74591286791fe68 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 10 Jan 2024 10:53:02 +0100
Subject: [PATCH 007/267] Bump version to 0.10.0-next.2

---
 examples/package.json            | 6 +++---
 packages/cashc/package.json      | 4 ++--
 packages/cashc/src/index.ts      | 2 +-
 packages/cashscript/package.json | 4 ++--
 packages/utils/package.json      | 2 +-
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index 4c8e350a..a6faa511 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.0-next.1",
+  "version": "0.10.0-next.2",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -14,8 +14,8 @@
     "@bitauth/libauth": "^2.0.0-alpha.8",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
-    "cashc": "^0.10.0-next.1",
-    "cashscript": "^0.10.0-next.1",
+    "cashc": "^0.10.0-next.2",
+    "cashscript": "^0.10.0-next.2",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 17039dcd..b0216a8c 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.0-next.1",
+  "version": "0.10.0-next.2",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0-alpha.8",
-    "@cashscript/utils": "^0.10.0-next.1",
+    "@cashscript/utils": "^0.10.0-next.2",
     "antlr4ts": "^0.5.0-alpha.4",
     "commander": "^7.1.0",
     "semver": "^7.3.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index eb8f7e76..4273a82c 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.0-next.1';
+export const version = '0.10.0-next.2';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 3a091e3d..d85b4006 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.0-next.1",
+  "version": "0.10.0-next.2",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0-alpha.8",
-    "@cashscript/utils": "^0.10.0-next.1",
+    "@cashscript/utils": "^0.10.0-next.2",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index b0f49088..30e6c48c 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.0-next.1",
+  "version": "0.10.0-next.2",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From 23f2f6fc78f6a911dfe559404be7741aa824e791 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 10 Jan 2024 10:55:11 +0100
Subject: [PATCH 008/267] Increase size of 'randomUtxo' for test purposes

---
 packages/cashscript/src/utils.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index a35f64b9..c9601ad3 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -343,7 +343,7 @@ export const randomUtxo = (defaults?: Partial<Utxo>): Utxo => ({
   ...{
     txid: binToHex(sha256(bigIntToVmNumber(randomInt()))),
     vout: Math.floor(Math.random() * 10),
-    satoshis: 20000n + randomInt(),
+    satoshis: 100_000n + randomInt(),
   },
   ...defaults,
 });
@@ -351,7 +351,7 @@ export const randomUtxo = (defaults?: Partial<Utxo>): Utxo => ({
 export const randomToken = (defaults?: Partial<TokenDetails>): TokenDetails => ({
   ...{
     category: binToHex(sha256(bigIntToVmNumber(randomInt()))),
-    amount: 10000n + randomInt(),
+    amount: 100_000n + randomInt(),
   },
   ...defaults,
 });

From 08268ba871a154cb4ffb6b66577ee7a97dce034e Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Wed, 10 Jan 2024 11:04:43 +0100
Subject: [PATCH 009/267] add BCHouse to showcase section (#181)

---
 website/docs/showcase.md       |   8 ++
 website/static/img/bchouse.svg | 146 +++++++++++++++++++++++++++++++++
 2 files changed, 154 insertions(+)
 create mode 100644 website/static/img/bchouse.svg

diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index d336a911..bf55e6cd 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -44,6 +44,14 @@ Cash-Ninjas is a collectibele NFT project on Bitcoin Cash which focuses on build
 
 BCH Guru is a non-custodial price-prediction platform and a collectible NFT project. BCH Guru uses CashScript for its price-prediction smart contracts to have players commit to a secret price-prediction. The project was the first to pioneer integration with CashConnect, which allows wallets to recognize the smart contract template and understand contract details.
 
+## BCHouse
+
+<div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
+    <a href="https://bchouse.fly.dev/" target="_blank"><img style={{borderRadius: '100%'}} src="/img/bchouse.svg" /></a>
+</div>
+
+BCHouse is a brand new BCH social media site and the first CashTokens-based crowdfunding application on Bitcoin Cash. BCHouse uses CashScript for the crowdfunding smart contract to allow an unlimited number of contributions to a campaign and to enable any BCH wallet to pledge by using forwarding addresses.
+
 ## Unspent Phi
 
 <div style={{textAlign: 'center', width: '50%', margin: 'auto', marginBottom: '20px'}}>
diff --git a/website/static/img/bchouse.svg b/website/static/img/bchouse.svg
new file mode 100644
index 00000000..82924e18
--- /dev/null
+++ b/website/static/img/bchouse.svg
@@ -0,0 +1,146 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+
+<svg
+   width="800px"
+   height="800px"
+   viewBox="0 0 45 45"
+   fill="none"
+   version="1.1"
+   id="svg17"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <g
+     clip-path="url(#clip0_2_1369)"
+     id="g17"
+     style="display:inline;fill:#0ac18e;fill-opacity:1">
+    <g
+       id="g23"
+       style="fill:#0ac18e;fill-opacity:1">
+      <path
+         d="M 29.502687,17.099202 C 29.338359,12.800399 25.654798,9.1089502 18.704409,5.9065392 L 17.676377,5.4424657 16.648345,5.9065392 C 9.5362589,9.1838835 5.8448089,12.972614 5.8448089,17.40025 v 1.314618 l 2.629238,-0.0013 h 2.6292371 13.146186 2.629238 l 2.629237,0.0013 V 17.40025 Z"
+         fill="#3c3c3c"
+         id="path2094"
+         style="display:inline;fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
+      <path
+         d="M 25.564089,25.665374 H 9.7807779 V 17.780291 H 25.564089 Z"
+         stroke="#3c3c3c"
+         stroke-width="2"
+         stroke-linecap="round"
+         stroke-linejoin="round"
+         id="path2"
+         style="display:inline;fill:#0ac18e;fill-opacity:1;stroke:#0ac18e;stroke-opacity:1" />
+    </g>
+    <g
+       id="g22"
+       style="display:inline;fill:#0ac18e;fill-opacity:1">
+      <path
+         d="m 36.677875,10.142357 c 0.494297,1.832578 0.717782,3.857091 0.717782,6.32463 0,3.084095 -0.786142,6.155045 -2.343965,9.202331 l -2.997331,-0.0013 c 1.814174,-3.093298 2.712059,-6.156359 2.712059,-9.201016 0,-2.530641 -0.249778,-4.486793 -0.797974,-6.232607 1.208135,-2.3124139 2.112592,-2.3124139 2.709429,-0.09202 z"
+         fill="#3c3c3c"
+         id="path4"
+         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
+      <path
+         d="m 36.2125,7.3172415 c 2.805396,0.3733517 -1.695858,4.6629525 -2.244054,2.9171385 -1.024088,0.506129 -1.745813,1.530216 -1.824691,2.730463 l -0.0066,0.215598 h -2.629237 c 0,-2.563507 1.630127,-4.744459 3.909676,-5.5674103 -0.195878,-0.9018284 3.132736,-1.0622119 2.794879,-0.2957892 z"
+         fill="#3c3c3c"
+         id="path5"
+         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
+      <path
+         d="m 36.2125,7.3172415 c 2.805396,0.3733517 4.987663,2.7120585 5.12044,5.5845005 l 0.0066,0.278699 h -2.629237 c 0,-1.371148 -0.838727,-2.545102 -2.032401,-3.038084 C 35.828631,9.5205424 35.154232,9.1747976 33.417621,7.6130307 33.221743,6.7112023 36.550357,6.5508188 36.2125,7.3172415 Z"
+         fill="#3c3c3c"
+         id="path6"
+         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
+      <path
+         d="M 36.2125,7.3172415 C 35.960093,7.4355572 34.517957,8.0021578 33.417621,7.6130307 33.221743,6.7112023 32.171362,5.9500381 30.822564,5.9500381 c -1.425047,0 -2.514866,0.8492437 -2.62135,1.8181176 l -0.0079,0.1538104 h -2.629237 c 0,-2.5990011 2.401808,-4.6011653 5.258475,-4.6011653 1.553879,0 2.973667,0.5928931 3.94517,1.5512501 0.970189,-0.9596717 1.782623,1.6787679 1.444766,2.4451906 z"
+         fill="#3c3c3c"
+         id="path7"
+         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
+      <path
+         d="m 38.710276,3.3208008 c 2.764643,0 5.103349,1.8746462 5.250586,4.3513877 l 0.0079,0.2497776 h -2.629237 c 0,-1.030661 -1.129258,-1.971928 -2.629237,-1.971928 -1.197618,0 -2.159919,0.6007807 -2.497776,1.3672034 -0.115686,0.1787881 -1.142404,0.1906197 -2.794879,0.2957892 -0.195878,-0.9018284 0.37861,-3.6993368 1.350113,-2.7409798 0.970189,-0.9596717 2.388662,-1.5512501 3.942542,-1.5512501 z"
+         fill="#3c3c3c"
+         id="path8"
+         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
+    </g>
+    <mask
+       id="mask0_2_1369"
+       maskUnits="userSpaceOnUse"
+       x="-17"
+       y="-18"
+       width="80"
+       height="81">
+      <path
+         d="m 63,-17.5 h -80 v 80 h 80 z"
+         fill="#f2ddbb"
+         id="path9" />
+    </mask>
+    <g
+       mask="url(#mask0_2_1369)"
+       id="g12"
+       transform="matrix(1.3146186,0,0,1.3146186,-5.3294492,-7.1961488)"
+       style="display:inline;fill:#0ac18e;fill-opacity:1">
+      <path
+         d="m 31.556,28 c 1.119,0.001 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 c -1.119,0 -2.201,-0.411 -3.017,-1.176 C 32.767,30.225 32.175,30 31.556,30 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L 23.872,30.636 C 23.433,30.225 22.842,30 22.222,30 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C 14.1,30.225 13.509,30 12.889,30 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.74501,1.116 -2.77801,1.17 l -0.23901,0.006 v -2 c 0.551,0 1.07901,-0.178 1.49801,-0.506 l 0.15199,-0.13 C 10.688,28.411 11.77,28.001 12.889,28 c 1.119,0.001 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.62,0 1.211,-0.225 1.649,-0.636 0.816,-0.765 1.898,-1.175 3.018,-1.176 z"
+         fill="#3c3c3c"
+         id="path10"
+         style="fill:#0ac18e;fill-opacity:1" />
+      <path
+         d="m 59.209,28 c 1.119,0.001 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 c -1.119,0 -2.201,-0.411 -3.017,-1.176 C 60.42,30.225 59.828,30 59.209,30 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L 51.525,30.636 C 51.086,30.225 50.495,30 49.875,30 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C 41.753,30.225 41.162,30 40.542,30 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.745,1.116 -2.778,1.17 l -0.239,0.006 v -2 c 0.551,0 1.079,-0.178 1.498,-0.506 l 0.152,-0.13 c 0.816,-0.765 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.62,0 1.211,-0.225 1.649,-0.636 0.816,-0.765 1.898,-1.175 3.018,-1.176 z"
+         fill="#3c3c3c"
+         id="path11"
+         style="fill:#0ac18e;fill-opacity:1" />
+      <path
+         d="m 3.709,28 c 1.119,0.001 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 C 7.256,31.812 6.174,31.401 5.358,30.636 4.92,30.225 4.328,30 3.709,30 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898001,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L -3.975,30.636 C -4.414,30.225 -5.005,30 -5.625,30 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C -13.747,30.225 -14.338,30 -14.958,30 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.745,1.116 -2.778,1.17 l -0.239,0.006 v -2 c 0.551,0 1.079,-0.178 1.498,-0.506 l 0.152,-0.13 c 0.816,-0.765 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.620001,0 1.211,-0.225 1.649,-0.636 C 1.507,28.411 2.589,28.001 3.709,28 Z"
+         fill="#3c3c3c"
+         id="path12"
+         style="fill:#0ac18e;fill-opacity:1" />
+    </g>
+    <mask
+       id="mask1_2_1369"
+       maskUnits="userSpaceOnUse"
+       x="-17"
+       y="-18"
+       width="80"
+       height="81">
+      <path
+         d="m 63,-17.5 h -80 v 80 h 80 z"
+         fill="#f2ddbb"
+         id="path13" />
+    </mask>
+    <g
+       mask="url(#mask1_2_1369)"
+       id="g16"
+       transform="matrix(1.3146186,0,0,1.3146186,-5.3294492,-7.1961488)"
+       style="display:inline;fill:#0ac18e;fill-opacity:1">
+      <path
+         d="m 31.556,33 c 1.119,10e-4 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 c -1.119,0 -2.201,-0.411 -3.017,-1.176 C 32.767,35.225 32.175,35 31.556,35 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L 23.872,35.636 C 23.433,35.225 22.842,35 22.222,35 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C 14.1,35.225 13.509,35 12.889,35 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.74501,1.116 -2.77801,1.17 l -0.23901,0.006 v -2 c 0.551,0 1.07901,-0.178 1.49801,-0.506 l 0.15199,-0.13 C 10.688,33.411 11.77,33.001 12.889,33 c 1.119,10e-4 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.62,0 1.211,-0.225 1.649,-0.636 0.816,-0.765 1.898,-1.175 3.018,-1.176 z"
+         fill="#3c3c3c"
+         id="path14"
+         style="fill:#0ac18e;fill-opacity:1" />
+      <path
+         d="m 59.209,33 c 1.119,10e-4 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 c -1.119,0 -2.201,-0.411 -3.017,-1.176 C 60.42,35.225 59.828,35 59.209,35 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L 51.525,35.636 C 51.086,35.225 50.495,35 49.875,35 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C 41.753,35.225 41.162,35 40.542,35 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.745,1.116 -2.778,1.17 l -0.239,0.006 v -2 c 0.551,0 1.079,-0.178 1.498,-0.506 l 0.152,-0.13 c 0.816,-0.765 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.62,0 1.211,-0.225 1.649,-0.636 0.816,-0.765 1.898,-1.175 3.018,-1.176 z"
+         fill="#3c3c3c"
+         id="path15"
+         style="fill:#0ac18e;fill-opacity:1" />
+      <path
+         d="m 3.709,33 c 1.119,10e-4 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 C 7.256,36.812 6.174,36.401 5.358,35.636 4.92,35.225 4.328,35 3.709,35 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898001,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L -3.975,35.636 C -4.414,35.225 -5.005,35 -5.625,35 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C -13.747,35.225 -14.338,35 -14.958,35 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.745,1.116 -2.778,1.17 l -0.239,0.006 v -2 c 0.551,0 1.079,-0.178 1.498,-0.506 l 0.152,-0.13 c 0.816,-0.765 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.620001,0 1.211,-0.225 1.649,-0.636 C 1.507,33.411 2.589,33.001 3.709,33 Z"
+         fill="#3c3c3c"
+         id="path16"
+         style="fill:#0ac18e;fill-opacity:1" />
+    </g>
+  </g>
+  <defs
+     id="defs17">
+    <clipPath
+       id="clip0_2_1369">
+      <rect
+         width="45"
+         height="45"
+         fill="white"
+         id="rect17" />
+    </clipPath>
+  </defs>
+  <path
+     id="symbol_1_"
+     class="st1"
+     d="m 20.453518,14.463763 c -0.478593,-1.085294 -1.57839,-1.31734 -2.924734,-1.092545 l -0.432665,-1.677492 -1.020032,0.263468 0.425417,1.672657 c -0.268302,0.06768 -0.543857,0.125697 -0.816992,0.20304 l -0.425417,-1.662989 -1.020029,0.263467 0.432667,1.677492 c -0.219961,0.06285 -2.059399,0.534188 -2.059399,0.534188 l 0.280387,1.092544 c 0,0 0.749311,-0.210292 0.742061,-0.193371 0.415746,-0.108764 0.611534,0.09911 0.703386,0.29489 l 1.18923,4.59739 c 0.01449,0.132939 -0.0097,0.360154 -0.29489,0.437501 0.01692,0.0097 -0.742061,0.190953 -0.742061,0.190953 l 0.111181,1.27383 c 0,0 1.822518,-0.466507 2.061816,-0.526934 l 0.437501,1.696828 1.020031,-0.263467 -0.437503,-1.708915 c 0.280389,-0.06527 0.553524,-0.13294 0.819409,-0.20304 l 0.435084,1.699246 1.020031,-0.263466 -0.4375,-1.694413 c 1.571136,-0.381906 2.680601,-1.372932 2.453391,-2.888475 -0.145029,-0.913677 -1.143305,-1.66299 -1.972382,-1.747588 0.510015,-0.452004 0.768648,-1.111882 0.452004,-1.974799 z m -0.490679,4.000357 c 0.20304,1.50104 -1.882947,1.684744 -2.57183,1.866028 l -0.59945,-2.245519 c 0.6913,-0.181284 2.828047,-0.942681 3.17128,0.379491 z M 18.70593,15.406444 c 0.215123,1.33426 -1.568721,1.488956 -2.143999,1.6364 l -0.546273,-2.037645 c 0.577696,-0.14261 2.252771,-0.83391 2.690272,0.401245 z"
+     style="fill:#ffffff;stroke-width:0.0241713" />
+</svg>

From c39f140f8d6a5698738be198870840a838bc52fd Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Wed, 10 Jan 2024 11:05:35 +0100
Subject: [PATCH 010/267] add CashTokens-studio to showcase (#182)

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
---
 website/docs/showcase.md                 |   8 ++++++++
 website/static/img/cashtokens-studio.png | Bin 0 -> 222469 bytes
 2 files changed, 8 insertions(+)
 create mode 100644 website/static/img/cashtokens-studio.png

diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index bf55e6cd..d375afe5 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -44,6 +44,14 @@ Cash-Ninjas is a collectibele NFT project on Bitcoin Cash which focuses on build
 
 BCH Guru is a non-custodial price-prediction platform and a collectible NFT project. BCH Guru uses CashScript for its price-prediction smart contracts to have players commit to a secret price-prediction. The project was the first to pioneer integration with CashConnect, which allows wallets to recognize the smart contract template and understand contract details.
 
+## CashTokens Studio
+
+<div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
+    <a href="https://cashtokens.studio" target="_blank"><img style={{borderRadius: '100%'}} src="/img/cashtokens-studio.png" /></a>
+</div>
+
+The CashTokens Studio is an application for creating CashTokens and for their managing metadata updates and reserved supply. The CashTokens Studio uses CashScript to lock the AuthUTXO in an AuthGuard contract to prevent accidentally spending the authority to be able to update the token's metadata or release reserved supply.
+
 ## BCHouse
 
 <div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
diff --git a/website/static/img/cashtokens-studio.png b/website/static/img/cashtokens-studio.png
new file mode 100644
index 0000000000000000000000000000000000000000..6c2f162d19bc75f6da02d2bfa4aa345584e843d9
GIT binary patch
literal 222469
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

literal 0
HcmV?d00001


From f74b8ab6008486a9a219f14b4712425f7ac6f344 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 10 Jan 2024 16:02:24 +0100
Subject: [PATCH 011/267] Move from antlr4ts to ANTLR's official TypeScript
 target (#184)

---
 .eslintrc.cjs                                 |    2 +-
 DEVELOPMENT.md                                |   27 +
 packages/cashc/package.json                   |    5 +-
 packages/cashc/src/ast/AstBuilder.ts          |  100 +-
 packages/cashc/src/ast/Location.ts            |   11 +-
 packages/cashc/src/ast/Pragma.ts              |    4 +-
 .../cashc/src/ast/ThrowingErrorListener.ts    |   10 +-
 packages/cashc/src/compiler.ts                |    8 +-
 packages/cashc/src/grammar/CashScript.interp  |    2 +-
 .../cashc/src/grammar/CashScriptLexer.interp  |    2 +-
 packages/cashc/src/grammar/CashScriptLexer.ts |  823 ++++---
 .../cashc/src/grammar/CashScriptParser.ts     | 1921 ++++++++---------
 .../cashc/src/grammar/CashScriptVisitor.ts    |  279 +--
 packages/cashc/test/ast/Location.test.ts      |   17 +
 yarn.lock                                     |   13 +-
 15 files changed, 1556 insertions(+), 1668 deletions(-)
 create mode 100644 DEVELOPMENT.md

diff --git a/.eslintrc.cjs b/.eslintrc.cjs
index 3ee079db..cda597db 100644
--- a/.eslintrc.cjs
+++ b/.eslintrc.cjs
@@ -18,7 +18,7 @@ module.exports = {
     'max-len': ['error', { code: 120, ignoreStrings: true, ignoreTemplateLiterals: true }],
     'import/no-cycle': 0, // Needed for AST -> AstVisitor -> AST
     'class-methods-use-this': 0, // I don't like this rule
-    'no-underscore-dangle': 0, // antlr4ts automatically uses this
+    'no-underscore-dangle': 0, // antlr automatically uses this
     'no-param-reassign': 0, // Makes visitors returning the node object easier
     '@typescript-eslint/lines-between-class-members': [ // Makes defining interfaces / abstract classes easier
       'error',
diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
new file mode 100644
index 00000000..d40018f4
--- /dev/null
+++ b/DEVELOPMENT.md
@@ -0,0 +1,27 @@
+## cashc
+
+### Prerequisites
+
+In order to use the `antlr` command line tool when updating CashScript's grammar file, you need to have it installed.
+
+On macOS you can install it using Homebrew:
+
+```bash
+brew install antlr
+```
+
+On Linux you can install it using apt:
+
+```bash
+sudo apt install antlr4
+```
+
+For other platforms, refer to the [Antlr website](https://www.antlr.org/).
+
+### Updating the grammar
+
+When updating the grammar file in `src/grammar/CashScript.g4`, we also need to make sure that the generated parser is updated. To do this, run the following command in the `packages/cashc` directory:
+
+```bash
+yarn antlr
+``````
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 80c4d410..207c5ed5 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -34,7 +34,7 @@
     "test": "test"
   },
   "scripts": {
-    "antlr": "antlr4ts -visitor -no-listener src/grammar/CashScript.g4",
+    "antlr": "antlr -Dlanguage=TypeScript -visitor -no-listener src/grammar/CashScript.g4",
     "postantlr": "find src/grammar -type f -name '*.ts' | xargs sed -i '' 's|\\(import .* \".*/.*\\)\";|\\1\\.js\";|g'",
     "build": "yarn clean && yarn compile",
     "build:test": "yarn clean:test && yarn compile:test && cpy './test/**/*.cash' ./dist-test/test",
@@ -51,7 +51,7 @@
   "dependencies": {
     "@bitauth/libauth": "^2.0.0-alpha.8",
     "@cashscript/utils": "^0.9.2",
-    "antlr4ts": "^0.5.0-alpha.4",
+    "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.3.4"
   },
@@ -59,7 +59,6 @@
     "@jest/globals": "^29.4.1",
     "@types/node": "^18.11.18",
     "@types/semver": "^7.3.4",
-    "antlr4ts-cli": "^0.5.0-alpha.4",
     "cpy-cli": "^4.2.0",
     "eslint": "^7.20.0",
     "jest": "^29.4.1",
diff --git a/packages/cashc/src/ast/AstBuilder.ts b/packages/cashc/src/ast/AstBuilder.ts
index dc435a0f..af08961d 100644
--- a/packages/cashc/src/ast/AstBuilder.ts
+++ b/packages/cashc/src/ast/AstBuilder.ts
@@ -1,8 +1,6 @@
+import { ParseTree, ParseTreeVisitor } from 'antlr4';
 import { hexToBin } from '@bitauth/libauth';
 import { parseType } from '@cashscript/utils';
-import { AbstractParseTreeVisitor } from 'antlr4ts/tree/AbstractParseTreeVisitor.js';
-import { ParseTree } from 'antlr4ts/tree/ParseTree.js';
-import { TerminalNode } from 'antlr4ts/tree/TerminalNode.js';
 import semver from 'semver';
 import {
   Node,
@@ -46,7 +44,6 @@ import type {
   FunctionCallContext,
   CastContext,
   LiteralContext,
-  NumberLiteralContext,
   SourceFileContext,
   BlockContext,
   TimeOpStatementContext,
@@ -63,8 +60,9 @@ import type {
   InstantiationContext,
   NullaryOpContext,
   UnaryIntrospectionOpContext,
+  StatementContext,
 } from '../grammar/CashScriptParser.js';
-import type { CashScriptVisitor } from '../grammar/CashScriptVisitor.js';
+import CashScriptVisitor from '../grammar/CashScriptVisitor.js';
 import { Location } from './Location.js';
 import {
   NumberUnit,
@@ -75,7 +73,7 @@ import { version } from '../index.js';
 import { ParseError, VersionError } from '../Errors.js';
 
 export default class AstBuilder
-  extends AbstractParseTreeVisitor<Node>
+  extends ParseTreeVisitor<Node>
   implements CashScriptVisitor<Node> {
   constructor(private tree: ParseTree) {
     super();
@@ -90,7 +88,7 @@ export default class AstBuilder
   }
 
   visitSourceFile(ctx: SourceFileContext): SourceFileNode {
-    ctx.pragmaDirective().forEach((pragma) => {
+    ctx.pragmaDirective_list().forEach((pragma) => {
       this.processPragma(pragma);
     });
 
@@ -101,15 +99,15 @@ export default class AstBuilder
   }
 
   processPragma(ctx: PragmaDirectiveContext): void {
-    const pragmaName = getPragmaName(ctx.pragmaName().text);
+    const pragmaName = getPragmaName(ctx.pragmaName().getText());
     if (pragmaName !== PragmaName.CASHSCRIPT) throw new Error(); // Shouldn't happen
 
     // Strip any -beta tags
     const actualVersion = version.replace(/-.*/g, '');
 
-    ctx.pragmaValue().versionConstraint().forEach((constraint) => {
+    ctx.pragmaValue().versionConstraint_list().forEach((constraint) => {
       const op = getVersionOpFromCtx(constraint.versionOperator());
-      const versionConstraint = `${op}${constraint.VersionLiteral().text}`;
+      const versionConstraint = `${op}${constraint.VersionLiteral().getText()}`;
       if (!semver.satisfies(actualVersion, versionConstraint)) {
         throw new VersionError(actualVersion, versionConstraint);
       }
@@ -117,18 +115,18 @@ export default class AstBuilder
   }
 
   visitContractDefinition(ctx: ContractDefinitionContext): ContractNode {
-    const name = ctx.Identifier().text;
-    const parameters = ctx.parameterList().parameter().map((p) => this.visit(p) as ParameterNode);
-    const functions = ctx.functionDefinition().map((f) => this.visit(f) as FunctionDefinitionNode);
+    const name = ctx.Identifier().getText();
+    const parameters = ctx.parameterList().parameter_list().map((p) => this.visit(p) as ParameterNode);
+    const functions = ctx.functionDefinition_list().map((f) => this.visit(f) as FunctionDefinitionNode);
     const contract = new ContractNode(name, parameters, functions);
     contract.location = Location.fromCtx(ctx);
     return contract;
   }
 
   visitFunctionDefinition(ctx: FunctionDefinitionContext): FunctionDefinitionNode {
-    const name = ctx.Identifier().text;
-    const parameters = ctx.parameterList().parameter().map((p) => this.visit(p) as ParameterNode);
-    const statements = ctx.statement().map((s) => this.visit(s) as StatementNode);
+    const name = ctx.Identifier().getText();
+    const parameters = ctx.parameterList().parameter_list().map((p) => this.visit(p) as ParameterNode);
+    const statements = ctx.statement_list().map((s) => this.visit(s) as StatementNode);
     const block = new BlockNode(statements);
     block.location = Location.fromCtx(ctx);
 
@@ -138,17 +136,22 @@ export default class AstBuilder
   }
 
   visitParameter(ctx: ParameterContext): ParameterNode {
-    const type = parseType(ctx.typeName().text);
-    const name = ctx.Identifier().text;
+    const type = parseType(ctx.typeName().getText());
+    const name = ctx.Identifier().getText();
     const parameter = new ParameterNode(type, name);
     parameter.location = Location.fromCtx(ctx);
     return parameter;
   }
 
+  visitStatement(ctx: StatementContext): StatementNode {
+    // Statement nodes only have a single child, so we can just visit that child
+    return this.visit(ctx.getChild(0));
+  }
+
   visitVariableDefinition(ctx: VariableDefinitionContext): VariableDefinitionNode {
-    const type = parseType(ctx.typeName().text);
-    const modifiers = ctx.modifier().map((modifier) => modifier.text);
-    const name = ctx.Identifier().text;
+    const type = parseType(ctx.typeName().getText());
+    const modifiers = ctx.modifier_list().map((modifier) => modifier.getText());
+    const name = ctx.Identifier().getText();
     const expression = this.visit(ctx.expression());
     const variableDefinition = new VariableDefinitionNode(type, modifiers, name, expression);
     variableDefinition.location = Location.fromCtx(ctx);
@@ -157,18 +160,19 @@ export default class AstBuilder
 
   visitTupleAssignment(ctx: TupleAssignmentContext): TupleAssignmentNode {
     const expression = this.visit(ctx.expression());
-    const names = ctx.Identifier();
-    const types = ctx.typeName();
-    const [var1, var2] = names.map((name, i) => (
-      { name: name.text, type: parseType(types[i].text) }
-    ));
+    const names = ctx.Identifier_list();
+    const types = ctx.typeName_list();
+    const [var1, var2] = names.map((name, i) => ({
+      name: name.getText(),
+      type: parseType(types[i].getText()),
+    }));
     const tupleAssignment = new TupleAssignmentNode(var1, var2, expression);
     tupleAssignment.location = Location.fromCtx(ctx);
     return tupleAssignment;
   }
 
   visitAssignStatement(ctx: AssignStatementContext): AssignNode {
-    const identifier = new IdentifierNode(ctx.Identifier().text);
+    const identifier = new IdentifierNode(ctx.Identifier().getText());
     identifier.location = Location.fromToken(ctx.Identifier().symbol);
 
     const expression = this.visit(ctx.expression());
@@ -179,7 +183,7 @@ export default class AstBuilder
 
   visitTimeOpStatement(ctx: TimeOpStatementContext): TimeOpNode {
     const expression = this.visit(ctx.expression());
-    const timeOp = new TimeOpNode(ctx.TxVar().text as TimeOp, expression);
+    const timeOp = new TimeOpNode(ctx.TxVar().getText() as TimeOp, expression);
     timeOp.location = Location.fromCtx(ctx);
 
     return timeOp;
@@ -202,7 +206,7 @@ export default class AstBuilder
   }
 
   visitBlock(ctx: BlockContext): BlockNode {
-    const statements = ctx.statement().map((s) => this.visit(s) as StatementNode);
+    const statements = ctx.statement_list().map((s) => this.visit(s) as StatementNode);
     const block = new BlockNode(statements);
     block.location = Location.fromCtx(ctx);
     return block;
@@ -213,7 +217,7 @@ export default class AstBuilder
   }
 
   visitCast(ctx: CastContext): CastNode {
-    const type = parseType(ctx.typeName().text);
+    const type = parseType(ctx.typeName().getText());
     const expression = this.visit(ctx._castable);
     const size = ctx._size && this.visit(ctx._size);
     const cast = new CastNode(type, expression, size);
@@ -226,18 +230,18 @@ export default class AstBuilder
   }
 
   visitFunctionCall(ctx: FunctionCallContext): FunctionCallNode {
-    const identifier = new IdentifierNode(ctx.Identifier().text as string);
+    const identifier = new IdentifierNode(ctx.Identifier().getText());
     identifier.location = Location.fromToken(ctx.Identifier().symbol);
-    const parameters = ctx.expressionList().expression().map((e) => this.visit(e));
+    const parameters = ctx.expressionList().expression_list().map((e) => this.visit(e));
     const functionCall = new FunctionCallNode(identifier, parameters);
     functionCall.location = Location.fromCtx(ctx);
     return functionCall;
   }
 
   visitInstantiation(ctx: InstantiationContext): InstantiationNode {
-    const identifier = new IdentifierNode(ctx.Identifier().text as string);
+    const identifier = new IdentifierNode(ctx.Identifier().getText());
     identifier.location = Location.fromToken(ctx.Identifier().symbol);
-    const parameters = ctx.expressionList().expression().map((e) => this.visit(e));
+    const parameters = ctx.expressionList().expression_list().map((e) => this.visit(e));
     const instantiation = new InstantiationNode(identifier, parameters);
     instantiation.location = Location.fromCtx(ctx);
     return instantiation;
@@ -245,14 +249,14 @@ export default class AstBuilder
 
   visitTupleIndexOp(ctx: TupleIndexOpContext): TupleIndexOpNode {
     const tuple = this.visit(ctx.expression());
-    const index = parseInt(ctx._index.text as string, 10);
+    const index = parseInt(ctx._index.text, 10);
     const tupleIndexOp = new TupleIndexOpNode(tuple, index);
     tupleIndexOp.location = Location.fromCtx(ctx);
     return tupleIndexOp;
   }
 
   visitNullaryOp(ctx: NullaryOpContext): NullaryOpNode {
-    const operator = ctx.text as NullaryOperator;
+    const operator = ctx.getText() as NullaryOperator;
     const nullaryOp = new NullaryOpNode(operator);
     nullaryOp.location = Location.fromCtx(ctx);
     return nullaryOp;
@@ -284,14 +288,14 @@ export default class AstBuilder
   }
 
   visitArray(ctx: ArrayContext): ArrayNode {
-    const elements = ctx.expression().map((e) => this.visit(e));
+    const elements = ctx.expression_list().map((e) => this.visit(e));
     const array = new ArrayNode(elements);
     array.location = Location.fromCtx(ctx);
     return array;
   }
 
   visitIdentifier(ctx: IdentifierContext): IdentifierNode {
-    const identifier = new IdentifierNode((ctx.Identifier() as TerminalNode).text);
+    const identifier = new IdentifierNode(ctx.Identifier().getText());
     identifier.location = Location.fromCtx(ctx);
     return identifier;
   }
@@ -325,7 +329,7 @@ export default class AstBuilder
   }
 
   createBooleanLiteral(ctx: LiteralContext): BoolLiteralNode {
-    const boolString = (ctx.BooleanLiteral() as TerminalNode).text;
+    const boolString = ctx.BooleanLiteral().getText();
     const boolValue = boolString === 'true';
     const booleanLiteral = new BoolLiteralNode(boolValue);
     booleanLiteral.location = Location.fromCtx(ctx);
@@ -333,9 +337,9 @@ export default class AstBuilder
   }
 
   createIntLiteral(ctx: LiteralContext): IntLiteralNode {
-    const numberCtx = ctx.numberLiteral() as NumberLiteralContext;
-    const numberString = numberCtx.NumberLiteral().text;
-    const numberUnit = numberCtx.NumberUnit()?.text;
+    const numberCtx = ctx.numberLiteral();
+    const numberString = numberCtx.NumberLiteral().getText();
+    const numberUnit = numberCtx.NumberUnit()?.getText();
     const numberValue = BigInt(numberString) * BigInt(numberUnit ? NumberUnit[numberUnit.toUpperCase()] : 1);
     const intLiteral = new IntLiteralNode(numberValue);
     intLiteral.location = Location.fromCtx(ctx);
@@ -343,7 +347,7 @@ export default class AstBuilder
   }
 
   createStringLiteral(ctx: LiteralContext): StringLiteralNode {
-    const rawString = (ctx.StringLiteral() as TerminalNode).text;
+    const rawString = ctx.StringLiteral().getText();
     const stringValue = rawString.substring(1, rawString.length - 1);
     const quote = rawString.substring(0, 1);
     const stringLiteral = new StringLiteralNode(stringValue, quote);
@@ -352,7 +356,7 @@ export default class AstBuilder
   }
 
   createDateLiteral(ctx: LiteralContext): IntLiteralNode {
-    const rawString = (ctx.DateLiteral() as TerminalNode).text;
+    const rawString = ctx.DateLiteral().getText();
     const stringValue = rawString.substring(6, rawString.length - 2).trim();
 
     if (!/^\d\d\d\d-\d\d-\d\dT\d\d:\d\d:\d\d$/.test(stringValue)) {
@@ -371,10 +375,16 @@ export default class AstBuilder
   }
 
   createHexLiteral(ctx: LiteralContext): HexLiteralNode {
-    const hexString = (ctx.HexLiteral() as TerminalNode).text;
+    const hexString = ctx.HexLiteral().getText();
     const hexValue = hexToBin(hexString.substring(2));
     const hexLiteral = new HexLiteralNode(hexValue);
     hexLiteral.location = Location.fromCtx(ctx);
     return hexLiteral;
   }
+
+  // For safety reasons, we throw an error when the "default" visitChildren is called. *All* nodes
+  // must have a custom visit method, so that we can be sure that we've covered all cases.
+  visitChildren(): Node {
+    throw new Error('Safety Warning: Unhandled node in AST builder');
+  }
 }
diff --git a/packages/cashc/src/ast/Location.ts b/packages/cashc/src/ast/Location.ts
index 93109ea0..c1e59eaf 100644
--- a/packages/cashc/src/ast/Location.ts
+++ b/packages/cashc/src/ast/Location.ts
@@ -1,5 +1,4 @@
-import type { ParserRuleContext } from 'antlr4ts/ParserRuleContext.js';
-import type { Token } from 'antlr4ts';
+import type { ParserRuleContext, Token } from 'antlr4';
 
 export class Location {
   constructor(public start: Point, public end: Point) {}
@@ -8,8 +7,8 @@ export class Location {
     const stop = ctx.stop?.text ? ctx.stop : ctx.start;
     const textLength = (stop.text ?? '').length;
 
-    const start = new Point(ctx.start.line, ctx.start.charPositionInLine);
-    const end = new Point(stop.line, stop.charPositionInLine + textLength);
+    const start = new Point(ctx.start.line, ctx.start.column);
+    const end = new Point(stop.line, stop.column + textLength);
 
     return new Location(start, end);
   }
@@ -17,8 +16,8 @@ export class Location {
   static fromToken(token: Token): Location | undefined {
     const textLength = (token.text ?? '').length;
 
-    const start = new Point(token.line, token.charPositionInLine);
-    const end = new Point(token.line, token.charPositionInLine + textLength);
+    const start = new Point(token.line, token.column);
+    const end = new Point(token.line, token.column + textLength);
 
     return new Location(start, end);
   }
diff --git a/packages/cashc/src/ast/Pragma.ts b/packages/cashc/src/ast/Pragma.ts
index 2b67694c..be0c9b19 100644
--- a/packages/cashc/src/ast/Pragma.ts
+++ b/packages/cashc/src/ast/Pragma.ts
@@ -1,4 +1,4 @@
-import { VersionOperatorContext } from '../grammar/CashScriptParser.js';
+import type { VersionOperatorContext } from '../grammar/CashScriptParser.js';
 
 export enum PragmaName {
   CASHSCRIPT = 'cashscript',
@@ -19,5 +19,5 @@ export function getPragmaName(name: string): PragmaName {
 }
 
 export function getVersionOpFromCtx(ctx?: VersionOperatorContext): VersionOp {
-  return <VersionOp>(ctx ? ctx.text : '=');
+  return <VersionOp>(ctx ? ctx.getText() : '=');
 }
diff --git a/packages/cashc/src/ast/ThrowingErrorListener.ts b/packages/cashc/src/ast/ThrowingErrorListener.ts
index dafe6530..9d07f81a 100644
--- a/packages/cashc/src/ast/ThrowingErrorListener.ts
+++ b/packages/cashc/src/ast/ThrowingErrorListener.ts
@@ -1,5 +1,5 @@
 /* eslint-disable @typescript-eslint/no-unused-vars */
-import { ANTLRErrorListener, RecognitionException, Recognizer } from 'antlr4ts';
+import { ErrorListener, RecognitionException, Recognizer } from 'antlr4';
 import { ParseError } from '../Errors.js';
 import { Point } from './Location.js';
 
@@ -7,12 +7,12 @@ import { Point } from './Location.js';
  * ANTLR Error Listener that immediately throws on error. This is used so that
  * ANTLR doesn't attempt any error recovery during lexing/parsing and fails early.
  */
-export default class ThrowingErrorListener implements ANTLRErrorListener<any> {
+export default class ThrowingErrorListener<TSymbol> extends ErrorListener<TSymbol> {
   static readonly INSTANCE = new ThrowingErrorListener();
 
-  syntaxError<T>(
-    recognizer: Recognizer<T, any>,
-    offendingSymbol: T,
+  syntaxError(
+    recognizer: Recognizer<TSymbol>,
+    offendingSymbol: TSymbol,
     line: number,
     charPositionInLine: number,
     message: string,
diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index e5779275..5f4d56d7 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -1,13 +1,13 @@
+import { CharStream, CommonTokenStream } from 'antlr4';
 import { Artifact, optimiseBytecode } from '@cashscript/utils';
-import { ANTLRInputStream, CommonTokenStream } from 'antlr4ts';
 import fs, { PathLike } from 'fs';
 import { generateArtifact } from './artifact/Artifact.js';
 import { Ast } from './ast/AST.js';
 import AstBuilder from './ast/AstBuilder.js';
 import ThrowingErrorListener from './ast/ThrowingErrorListener.js';
 import GenerateTargetTraversal from './generation/GenerateTargetTraversal.js';
-import { CashScriptLexer } from './grammar/CashScriptLexer.js';
-import { CashScriptParser } from './grammar/CashScriptParser.js';
+import CashScriptLexer from './grammar/CashScriptLexer.js';
+import CashScriptParser from './grammar/CashScriptParser.js';
 import SymbolTableTraversal from './semantic/SymbolTableTraversal.js';
 import TypeCheckTraversal from './semantic/TypeCheckTraversal.js';
 import EnsureFinalRequireTraversal from './semantic/EnsureFinalRequireTraversal.js';
@@ -39,7 +39,7 @@ export function compileFile(codeFile: PathLike): Artifact {
 
 export function parseCode(code: string): Ast {
   // Lexing (throwing on errors)
-  const inputStream = new ANTLRInputStream(code);
+  const inputStream = new CharStream(code);
   const lexer = new CashScriptLexer(inputStream);
   lexer.removeErrorListeners();
   lexer.addErrorListener(ThrowingErrorListener.INSTANCE);
diff --git a/packages/cashc/src/grammar/CashScript.interp b/packages/cashc/src/grammar/CashScript.interp
index ae258f62..46ee4da6 100644
--- a/packages/cashc/src/grammar/CashScript.interp
+++ b/packages/cashc/src/grammar/CashScript.interp
@@ -175,4 +175,4 @@ typeName
 
 
 atn:
-[3, 51485, 51898, 1421, 44986, 20307, 1543, 60043, 49729, 3, 73, 324, 4, 2, 9, 2, 4, 3, 9, 3, 4, 4, 9, 4, 4, 5, 9, 5, 4, 6, 9, 6, 4, 7, 9, 7, 4, 8, 9, 8, 4, 9, 9, 9, 4, 10, 9, 10, 4, 11, 9, 11, 4, 12, 9, 12, 4, 13, 9, 13, 4, 14, 9, 14, 4, 15, 9, 15, 4, 16, 9, 16, 4, 17, 9, 17, 4, 18, 9, 18, 4, 19, 9, 19, 4, 20, 9, 20, 4, 21, 9, 21, 4, 22, 9, 22, 4, 23, 9, 23, 4, 24, 9, 24, 4, 25, 9, 25, 4, 26, 9, 26, 3, 2, 7, 2, 54, 10, 2, 12, 2, 14, 2, 57, 11, 2, 3, 2, 3, 2, 3, 2, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 4, 3, 4, 3, 5, 3, 5, 5, 5, 71, 10, 5, 3, 6, 5, 6, 74, 10, 6, 3, 6, 3, 6, 3, 7, 3, 7, 3, 8, 3, 8, 3, 8, 3, 8, 3, 8, 7, 8, 85, 10, 8, 12, 8, 14, 8, 88, 11, 8, 3, 8, 3, 8, 3, 9, 3, 9, 3, 9, 3, 9, 3, 9, 7, 9, 97, 10, 9, 12, 9, 14, 9, 100, 11, 9, 3, 9, 3, 9, 3, 10, 3, 10, 3, 10, 3, 10, 7, 10, 108, 10, 10, 12, 10, 14, 10, 111, 11, 10, 3, 10, 5, 10, 114, 10, 10, 5, 10, 116, 10, 10, 3, 10, 3, 10, 3, 11, 3, 11, 3, 11, 3, 12, 3, 12, 7, 12, 125, 10, 12, 12, 12, 14, 12, 128, 11, 12, 3, 12, 3, 12, 5, 12, 132, 10, 12, 3, 13, 3, 13, 3, 13, 3, 13, 3, 13, 3, 13, 5, 13, 140, 10, 13, 3, 14, 3, 14, 7, 14, 144, 10, 14, 12, 14, 14, 14, 147, 11, 14, 3, 14, 3, 14, 3, 14, 3, 14, 3, 14, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 16, 3, 16, 3, 16, 3, 16, 3, 16, 3, 17, 3, 17, 3, 17, 3, 17, 3, 17, 3, 17, 3, 17, 3, 17, 3, 18, 3, 18, 3, 18, 3, 18, 3, 18, 3, 18, 3, 19, 3, 19, 3, 19, 3, 19, 3, 19, 3, 19, 3, 19, 5, 19, 189, 10, 19, 3, 20, 3, 20, 3, 20, 3, 21, 3, 21, 3, 21, 3, 21, 7, 21, 198, 10, 21, 12, 21, 14, 21, 201, 11, 21, 3, 21, 5, 21, 204, 10, 21, 5, 21, 206, 10, 21, 3, 21, 3, 21, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 5, 22, 220, 10, 22, 3, 22, 5, 22, 223, 10, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 7, 22, 249, 10, 22, 12, 22, 14, 22, 252, 11, 22, 3, 22, 5, 22, 255, 10, 22, 5, 22, 257, 10, 22, 3, 22, 3, 22, 3, 22, 3, 22, 5, 22, 263, 10, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 3, 22, 7, 22, 304, 10, 22, 12, 22, 14, 22, 307, 11, 22, 3, 23, 3, 23, 3, 24, 3, 24, 3, 24, 3, 24, 3, 24, 5, 24, 316, 10, 24, 3, 25, 3, 25, 5, 25, 320, 10, 25, 3, 26, 3, 26, 3, 26, 2, 2, 3, 42, 27, 2, 2, 4, 2, 6, 2, 8, 2, 10, 2, 12, 2, 14, 2, 16, 2, 18, 2, 20, 2, 22, 2, 24, 2, 26, 2, 28, 2, 30, 2, 32, 2, 34, 2, 36, 2, 38, 2, 40, 2, 42, 2, 44, 2, 46, 2, 48, 2, 50, 2, 2, 12, 3, 2, 6, 12, 3, 2, 27, 31, 4, 2, 27, 31, 33, 36, 3, 2, 40, 41, 3, 2, 42, 44, 4, 2, 41, 41, 45, 45, 3, 2, 8, 11, 3, 2, 46, 47, 3, 2, 37, 38, 4, 2, 53, 58, 63, 63, 2, 350, 2, 55, 3, 2, 2, 2, 4, 61, 3, 2, 2, 2, 6, 66, 3, 2, 2, 2, 8, 68, 3, 2, 2, 2, 10, 73, 3, 2, 2, 2, 12, 77, 3, 2, 2, 2, 14, 79, 3, 2, 2, 2, 16, 91, 3, 2, 2, 2, 18, 103, 3, 2, 2, 2, 20, 119, 3, 2, 2, 2, 22, 131, 3, 2, 2, 2, 24, 139, 3, 2, 2, 2, 26, 141, 3, 2, 2, 2, 28, 153, 3, 2, 2, 2, 30, 162, 3, 2, 2, 2, 32, 167, 3, 2, 2, 2, 34, 175, 3, 2, 2, 2, 36, 181, 3, 2, 2, 2, 38, 190, 3, 2, 2, 2, 40, 193, 3, 2, 2, 2, 42, 262, 3, 2, 2, 2, 44, 308, 3, 2, 2, 2, 46, 315, 3, 2, 2, 2, 48, 317, 3, 2, 2, 2, 50, 321, 3, 2, 2, 2, 52, 54, 5, 4, 3, 2, 53, 52, 3, 2, 2, 2, 54, 57, 3, 2, 2, 2, 55, 53, 3, 2, 2, 2, 55, 56, 3, 2, 2, 2, 56, 58, 3, 2, 2, 2, 57, 55, 3, 2, 2, 2, 58, 59, 5, 14, 8, 2, 59, 60, 7, 2, 2, 3, 60, 3, 3, 2, 2, 2, 61, 62, 7, 3, 2, 2, 62, 63, 5, 6, 4, 2, 63, 64, 5, 8, 5, 2, 64, 65, 7, 4, 2, 2, 65, 5, 3, 2, 2, 2, 66, 67, 7, 5, 2, 2, 67, 7, 3, 2, 2, 2, 68, 70, 5, 10, 6, 2, 69, 71, 5, 10, 6, 2, 70, 69, 3, 2, 2, 2, 70, 71, 3, 2, 2, 2, 71, 9, 3, 2, 2, 2, 72, 74, 5, 12, 7, 2, 73, 72, 3, 2, 2, 2, 73, 74, 3, 2, 2, 2, 74, 75, 3, 2, 2, 2, 75, 76, 7, 59, 2, 2, 76, 11, 3, 2, 2, 2, 77, 78, 9, 2, 2, 2, 78, 13, 3, 2, 2, 2, 79, 80, 7, 13, 2, 2, 80, 81, 7, 70, 2, 2, 81, 82, 5, 18, 10, 2, 82, 86, 7, 14, 2, 2, 83, 85, 5, 16, 9, 2, 84, 83, 3, 2, 2, 2, 85, 88, 3, 2, 2, 2, 86, 84, 3, 2, 2, 2, 86, 87, 3, 2, 2, 2, 87, 89, 3, 2, 2, 2, 88, 86, 3, 2, 2, 2, 89, 90, 7, 15, 2, 2, 90, 15, 3, 2, 2, 2, 91, 92, 7, 16, 2, 2, 92, 93, 7, 70, 2, 2, 93, 94, 5, 18, 10, 2, 94, 98, 7, 14, 2, 2, 95, 97, 5, 24, 13, 2, 96, 95, 3, 2, 2, 2, 97, 100, 3, 2, 2, 2, 98, 96, 3, 2, 2, 2, 98, 99, 3, 2, 2, 2, 99, 101, 3, 2, 2, 2, 100, 98, 3, 2, 2, 2, 101, 102, 7, 15, 2, 2, 102, 17, 3, 2, 2, 2, 103, 115, 7, 17, 2, 2, 104, 109, 5, 20, 11, 2, 105, 106, 7, 18, 2, 2, 106, 108, 5, 20, 11, 2, 107, 105, 3, 2, 2, 2, 108, 111, 3, 2, 2, 2, 109, 107, 3, 2, 2, 2, 109, 110, 3, 2, 2, 2, 110, 113, 3, 2, 2, 2, 111, 109, 3, 2, 2, 2, 112, 114, 7, 18, 2, 2, 113, 112, 3, 2, 2, 2, 113, 114, 3, 2, 2, 2, 114, 116, 3, 2, 2, 2, 115, 104, 3, 2, 2, 2, 115, 116, 3, 2, 2, 2, 116, 117, 3, 2, 2, 2, 117, 118, 7, 19, 2, 2, 118, 19, 3, 2, 2, 2, 119, 120, 5, 50, 26, 2, 120, 121, 7, 70, 2, 2, 121, 21, 3, 2, 2, 2, 122, 126, 7, 14, 2, 2, 123, 125, 5, 24, 13, 2, 124, 123, 3, 2, 2, 2, 125, 128, 3, 2, 2, 2, 126, 124, 3, 2, 2, 2, 126, 127, 3, 2, 2, 2, 127, 129, 3, 2, 2, 2, 128, 126, 3, 2, 2, 2, 129, 132, 7, 15, 2, 2, 130, 132, 5, 24, 13, 2, 131, 122, 3, 2, 2, 2, 131, 130, 3, 2, 2, 2, 132, 23, 3, 2, 2, 2, 133, 140, 5, 26, 14, 2, 134, 140, 5, 28, 15, 2, 135, 140, 5, 30, 16, 2, 136, 140, 5, 32, 17, 2, 137, 140, 5, 34, 18, 2, 138, 140, 5, 36, 19, 2, 139, 133, 3, 2, 2, 2, 139, 134, 3, 2, 2, 2, 139, 135, 3, 2, 2, 2, 139, 136, 3, 2, 2, 2, 139, 137, 3, 2, 2, 2, 139, 138, 3, 2, 2, 2, 140, 25, 3, 2, 2, 2, 141, 145, 5, 50, 26, 2, 142, 144, 5, 44, 23, 2, 143, 142, 3, 2, 2, 2, 144, 147, 3, 2, 2, 2, 145, 143, 3, 2, 2, 2, 145, 146, 3, 2, 2, 2, 146, 148, 3, 2, 2, 2, 147, 145, 3, 2, 2, 2, 148, 149, 7, 70, 2, 2, 149, 150, 7, 12, 2, 2, 150, 151, 5, 42, 22, 2, 151, 152, 7, 4, 2, 2, 152, 27, 3, 2, 2, 2, 153, 154, 5, 50, 26, 2, 154, 155, 7, 70, 2, 2, 155, 156, 7, 18, 2, 2, 156, 157, 5, 50, 26, 2, 157, 158, 7, 70, 2, 2, 158, 159, 7, 12, 2, 2, 159, 160, 5, 42, 22, 2, 160, 161, 7, 4, 2, 2, 161, 29, 3, 2, 2, 2, 162, 163, 7, 70, 2, 2, 163, 164, 7, 12, 2, 2, 164, 165, 5, 42, 22, 2, 165, 166, 7, 4, 2, 2, 166, 31, 3, 2, 2, 2, 167, 168, 7, 20, 2, 2, 168, 169, 7, 17, 2, 2, 169, 170, 7, 68, 2, 2, 170, 171, 7, 8, 2, 2, 171, 172, 5, 42, 22, 2, 172, 173, 7, 19, 2, 2, 173, 174, 7, 4, 2, 2, 174, 33, 3, 2, 2, 2, 175, 176, 7, 20, 2, 2, 176, 177, 7, 17, 2, 2, 177, 178, 5, 42, 22, 2, 178, 179, 7, 19, 2, 2, 179, 180, 7, 4, 2, 2, 180, 35, 3, 2, 2, 2, 181, 182, 7, 21, 2, 2, 182, 183, 7, 17, 2, 2, 183, 184, 5, 42, 22, 2, 184, 185, 7, 19, 2, 2, 185, 188, 5, 22, 12, 2, 186, 187, 7, 22, 2, 2, 187, 189, 5, 22, 12, 2, 188, 186, 3, 2, 2, 2, 188, 189, 3, 2, 2, 2, 189, 37, 3, 2, 2, 2, 190, 191, 7, 70, 2, 2, 191, 192, 5, 40, 21, 2, 192, 39, 3, 2, 2, 2, 193, 205, 7, 17, 2, 2, 194, 199, 5, 42, 22, 2, 195, 196, 7, 18, 2, 2, 196, 198, 5, 42, 22, 2, 197, 195, 3, 2, 2, 2, 198, 201, 3, 2, 2, 2, 199, 197, 3, 2, 2, 2, 199, 200, 3, 2, 2, 2, 200, 203, 3, 2, 2, 2, 201, 199, 3, 2, 2, 2, 202, 204, 7, 18, 2, 2, 203, 202, 3, 2, 2, 2, 203, 204, 3, 2, 2, 2, 204, 206, 3, 2, 2, 2, 205, 194, 3, 2, 2, 2, 205, 206, 3, 2, 2, 2, 206, 207, 3, 2, 2, 2, 207, 208, 7, 19, 2, 2, 208, 41, 3, 2, 2, 2, 209, 210, 8, 22, 1, 2, 210, 211, 7, 17, 2, 2, 211, 212, 5, 42, 22, 2, 212, 213, 7, 19, 2, 2, 213, 263, 3, 2, 2, 2, 214, 215, 5, 50, 26, 2, 215, 216, 7, 17, 2, 2, 216, 219, 5, 42, 22, 2, 217, 218, 7, 18, 2, 2, 218, 220, 5, 42, 22, 2, 219, 217, 3, 2, 2, 2, 219, 220, 3, 2, 2, 2, 220, 222, 3, 2, 2, 2, 221, 223, 7, 18, 2, 2, 222, 221, 3, 2, 2, 2, 222, 223, 3, 2, 2, 2, 223, 224, 3, 2, 2, 2, 224, 225, 7, 19, 2, 2, 225, 263, 3, 2, 2, 2, 226, 263, 5, 38, 20, 2, 227, 228, 7, 23, 2, 2, 228, 229, 7, 70, 2, 2, 229, 263, 5, 40, 21, 2, 230, 231, 7, 26, 2, 2, 231, 232, 7, 24, 2, 2, 232, 233, 5, 42, 22, 2, 233, 234, 7, 25, 2, 2, 234, 235, 9, 3, 2, 2, 235, 263, 3, 2, 2, 2, 236, 237, 7, 32, 2, 2, 237, 238, 7, 24, 2, 2, 238, 239, 5, 42, 22, 2, 239, 240, 7, 25, 2, 2, 240, 241, 9, 4, 2, 2, 241, 263, 3, 2, 2, 2, 242, 243, 9, 5, 2, 2, 243, 263, 5, 42, 22, 16, 244, 256, 7, 24, 2, 2, 245, 250, 5, 42, 22, 2, 246, 247, 7, 18, 2, 2, 247, 249, 5, 42, 22, 2, 248, 246, 3, 2, 2, 2, 249, 252, 3, 2, 2, 2, 250, 248, 3, 2, 2, 2, 250, 251, 3, 2, 2, 2, 251, 254, 3, 2, 2, 2, 252, 250, 3, 2, 2, 2, 253, 255, 7, 18, 2, 2, 254, 253, 3, 2, 2, 2, 254, 255, 3, 2, 2, 2, 255, 257, 3, 2, 2, 2, 256, 245, 3, 2, 2, 2, 256, 257, 3, 2, 2, 2, 257, 258, 3, 2, 2, 2, 258, 263, 7, 25, 2, 2, 259, 263, 7, 69, 2, 2, 260, 263, 7, 70, 2, 2, 261, 263, 5, 46, 24, 2, 262, 209, 3, 2, 2, 2, 262, 214, 3, 2, 2, 2, 262, 226, 3, 2, 2, 2, 262, 227, 3, 2, 2, 2, 262, 230, 3, 2, 2, 2, 262, 236, 3, 2, 2, 2, 262, 242, 3, 2, 2, 2, 262, 244, 3, 2, 2, 2, 262, 259, 3, 2, 2, 2, 262, 260, 3, 2, 2, 2, 262, 261, 3, 2, 2, 2, 263, 305, 3, 2, 2, 2, 264, 265, 12, 15, 2, 2, 265, 266, 9, 6, 2, 2, 266, 304, 5, 42, 22, 16, 267, 268, 12, 14, 2, 2, 268, 269, 9, 7, 2, 2, 269, 304, 5, 42, 22, 15, 270, 271, 12, 13, 2, 2, 271, 272, 9, 8, 2, 2, 272, 304, 5, 42, 22, 14, 273, 274, 12, 12, 2, 2, 274, 275, 9, 9, 2, 2, 275, 304, 5, 42, 22, 13, 276, 277, 12, 11, 2, 2, 277, 278, 7, 48, 2, 2, 278, 304, 5, 42, 22, 12, 279, 280, 12, 10, 2, 2, 280, 281, 7, 6, 2, 2, 281, 304, 5, 42, 22, 11, 282, 283, 12, 9, 2, 2, 283, 284, 7, 49, 2, 2, 284, 304, 5, 42, 22, 10, 285, 286, 12, 8, 2, 2, 286, 287, 7, 50, 2, 2, 287, 304, 5, 42, 22, 9, 288, 289, 12, 7, 2, 2, 289, 290, 7, 51, 2, 2, 290, 304, 5, 42, 22, 8, 291, 292, 12, 21, 2, 2, 292, 293, 7, 24, 2, 2, 293, 294, 7, 62, 2, 2, 294, 304, 7, 25, 2, 2, 295, 296, 12, 18, 2, 2, 296, 304, 9, 10, 2, 2, 297, 298, 12, 17, 2, 2, 298, 299, 7, 39, 2, 2, 299, 300, 7, 17, 2, 2, 300, 301, 5, 42, 22, 2, 301, 302, 7, 19, 2, 2, 302, 304, 3, 2, 2, 2, 303, 264, 3, 2, 2, 2, 303, 267, 3, 2, 2, 2, 303, 270, 3, 2, 2, 2, 303, 273, 3, 2, 2, 2, 303, 276, 3, 2, 2, 2, 303, 279, 3, 2, 2, 2, 303, 282, 3, 2, 2, 2, 303, 285, 3, 2, 2, 2, 303, 288, 3, 2, 2, 2, 303, 291, 3, 2, 2, 2, 303, 295, 3, 2, 2, 2, 303, 297, 3, 2, 2, 2, 304, 307, 3, 2, 2, 2, 305, 303, 3, 2, 2, 2, 305, 306, 3, 2, 2, 2, 306, 43, 3, 2, 2, 2, 307, 305, 3, 2, 2, 2, 308, 309, 7, 52, 2, 2, 309, 45, 3, 2, 2, 2, 310, 316, 7, 60, 2, 2, 311, 316, 5, 48, 25, 2, 312, 316, 7, 65, 2, 2, 313, 316, 7, 66, 2, 2, 314, 316, 7, 67, 2, 2, 315, 310, 3, 2, 2, 2, 315, 311, 3, 2, 2, 2, 315, 312, 3, 2, 2, 2, 315, 313, 3, 2, 2, 2, 315, 314, 3, 2, 2, 2, 316, 47, 3, 2, 2, 2, 317, 319, 7, 62, 2, 2, 318, 320, 7, 61, 2, 2, 319, 318, 3, 2, 2, 2, 319, 320, 3, 2, 2, 2, 320, 49, 3, 2, 2, 2, 321, 322, 9, 11, 2, 2, 322, 51, 3, 2, 2, 2, 28, 55, 70, 73, 86, 98, 109, 113, 115, 126, 131, 139, 145, 188, 199, 203, 205, 219, 222, 250, 254, 256, 262, 303, 305, 315, 319]
\ No newline at end of file
+[4, 1, 71, 322, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 1, 0, 5, 0, 52, 8, 0, 10, 0, 12, 0, 55, 9, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 1, 2, 1, 3, 1, 3, 3, 3, 69, 8, 3, 1, 4, 3, 4, 72, 8, 4, 1, 4, 1, 4, 1, 5, 1, 5, 1, 6, 1, 6, 1, 6, 1, 6, 1, 6, 5, 6, 83, 8, 6, 10, 6, 12, 6, 86, 9, 6, 1, 6, 1, 6, 1, 7, 1, 7, 1, 7, 1, 7, 1, 7, 5, 7, 95, 8, 7, 10, 7, 12, 7, 98, 9, 7, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 8, 5, 8, 106, 8, 8, 10, 8, 12, 8, 109, 9, 8, 1, 8, 3, 8, 112, 8, 8, 3, 8, 114, 8, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 9, 1, 10, 1, 10, 5, 10, 123, 8, 10, 10, 10, 12, 10, 126, 9, 10, 1, 10, 1, 10, 3, 10, 130, 8, 10, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 3, 11, 138, 8, 11, 1, 12, 1, 12, 5, 12, 142, 8, 12, 10, 12, 12, 12, 145, 9, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 14, 1, 14, 1, 14, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 16, 1, 16, 1, 16, 1, 16, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 3, 17, 187, 8, 17, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 19, 1, 19, 5, 19, 196, 8, 19, 10, 19, 12, 19, 199, 9, 19, 1, 19, 3, 19, 202, 8, 19, 3, 19, 204, 8, 19, 1, 19, 1, 19, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 3, 20, 218, 8, 20, 1, 20, 3, 20, 221, 8, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 5, 20, 247, 8, 20, 10, 20, 12, 20, 250, 9, 20, 1, 20, 3, 20, 253, 8, 20, 3, 20, 255, 8, 20, 1, 20, 1, 20, 1, 20, 1, 20, 3, 20, 261, 8, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 5, 20, 302, 8, 20, 10, 20, 12, 20, 305, 9, 20, 1, 21, 1, 21, 1, 22, 1, 22, 1, 22, 1, 22, 1, 22, 3, 22, 314, 8, 22, 1, 23, 1, 23, 3, 23, 318, 8, 23, 1, 24, 1, 24, 1, 24, 0, 1, 40, 25, 0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, 0, 10, 1, 0, 4, 10, 1, 0, 25, 29, 2, 0, 25, 29, 31, 34, 1, 0, 38, 39, 1, 0, 40, 42, 2, 0, 39, 39, 43, 43, 1, 0, 6, 9, 1, 0, 44, 45, 1, 0, 35, 36, 2, 0, 51, 56, 61, 61, 348, 0, 53, 1, 0, 0, 0, 2, 59, 1, 0, 0, 0, 4, 64, 1, 0, 0, 0, 6, 66, 1, 0, 0, 0, 8, 71, 1, 0, 0, 0, 10, 75, 1, 0, 0, 0, 12, 77, 1, 0, 0, 0, 14, 89, 1, 0, 0, 0, 16, 101, 1, 0, 0, 0, 18, 117, 1, 0, 0, 0, 20, 129, 1, 0, 0, 0, 22, 137, 1, 0, 0, 0, 24, 139, 1, 0, 0, 0, 26, 151, 1, 0, 0, 0, 28, 160, 1, 0, 0, 0, 30, 165, 1, 0, 0, 0, 32, 173, 1, 0, 0, 0, 34, 179, 1, 0, 0, 0, 36, 188, 1, 0, 0, 0, 38, 191, 1, 0, 0, 0, 40, 260, 1, 0, 0, 0, 42, 306, 1, 0, 0, 0, 44, 313, 1, 0, 0, 0, 46, 315, 1, 0, 0, 0, 48, 319, 1, 0, 0, 0, 50, 52, 3, 2, 1, 0, 51, 50, 1, 0, 0, 0, 52, 55, 1, 0, 0, 0, 53, 51, 1, 0, 0, 0, 53, 54, 1, 0, 0, 0, 54, 56, 1, 0, 0, 0, 55, 53, 1, 0, 0, 0, 56, 57, 3, 12, 6, 0, 57, 58, 5, 0, 0, 1, 58, 1, 1, 0, 0, 0, 59, 60, 5, 1, 0, 0, 60, 61, 3, 4, 2, 0, 61, 62, 3, 6, 3, 0, 62, 63, 5, 2, 0, 0, 63, 3, 1, 0, 0, 0, 64, 65, 5, 3, 0, 0, 65, 5, 1, 0, 0, 0, 66, 68, 3, 8, 4, 0, 67, 69, 3, 8, 4, 0, 68, 67, 1, 0, 0, 0, 68, 69, 1, 0, 0, 0, 69, 7, 1, 0, 0, 0, 70, 72, 3, 10, 5, 0, 71, 70, 1, 0, 0, 0, 71, 72, 1, 0, 0, 0, 72, 73, 1, 0, 0, 0, 73, 74, 5, 57, 0, 0, 74, 9, 1, 0, 0, 0, 75, 76, 7, 0, 0, 0, 76, 11, 1, 0, 0, 0, 77, 78, 5, 11, 0, 0, 78, 79, 5, 68, 0, 0, 79, 80, 3, 16, 8, 0, 80, 84, 5, 12, 0, 0, 81, 83, 3, 14, 7, 0, 82, 81, 1, 0, 0, 0, 83, 86, 1, 0, 0, 0, 84, 82, 1, 0, 0, 0, 84, 85, 1, 0, 0, 0, 85, 87, 1, 0, 0, 0, 86, 84, 1, 0, 0, 0, 87, 88, 5, 13, 0, 0, 88, 13, 1, 0, 0, 0, 89, 90, 5, 14, 0, 0, 90, 91, 5, 68, 0, 0, 91, 92, 3, 16, 8, 0, 92, 96, 5, 12, 0, 0, 93, 95, 3, 22, 11, 0, 94, 93, 1, 0, 0, 0, 95, 98, 1, 0, 0, 0, 96, 94, 1, 0, 0, 0, 96, 97, 1, 0, 0, 0, 97, 99, 1, 0, 0, 0, 98, 96, 1, 0, 0, 0, 99, 100, 5, 13, 0, 0, 100, 15, 1, 0, 0, 0, 101, 113, 5, 15, 0, 0, 102, 107, 3, 18, 9, 0, 103, 104, 5, 16, 0, 0, 104, 106, 3, 18, 9, 0, 105, 103, 1, 0, 0, 0, 106, 109, 1, 0, 0, 0, 107, 105, 1, 0, 0, 0, 107, 108, 1, 0, 0, 0, 108, 111, 1, 0, 0, 0, 109, 107, 1, 0, 0, 0, 110, 112, 5, 16, 0, 0, 111, 110, 1, 0, 0, 0, 111, 112, 1, 0, 0, 0, 112, 114, 1, 0, 0, 0, 113, 102, 1, 0, 0, 0, 113, 114, 1, 0, 0, 0, 114, 115, 1, 0, 0, 0, 115, 116, 5, 17, 0, 0, 116, 17, 1, 0, 0, 0, 117, 118, 3, 48, 24, 0, 118, 119, 5, 68, 0, 0, 119, 19, 1, 0, 0, 0, 120, 124, 5, 12, 0, 0, 121, 123, 3, 22, 11, 0, 122, 121, 1, 0, 0, 0, 123, 126, 1, 0, 0, 0, 124, 122, 1, 0, 0, 0, 124, 125, 1, 0, 0, 0, 125, 127, 1, 0, 0, 0, 126, 124, 1, 0, 0, 0, 127, 130, 5, 13, 0, 0, 128, 130, 3, 22, 11, 0, 129, 120, 1, 0, 0, 0, 129, 128, 1, 0, 0, 0, 130, 21, 1, 0, 0, 0, 131, 138, 3, 24, 12, 0, 132, 138, 3, 26, 13, 0, 133, 138, 3, 28, 14, 0, 134, 138, 3, 30, 15, 0, 135, 138, 3, 32, 16, 0, 136, 138, 3, 34, 17, 0, 137, 131, 1, 0, 0, 0, 137, 132, 1, 0, 0, 0, 137, 133, 1, 0, 0, 0, 137, 134, 1, 0, 0, 0, 137, 135, 1, 0, 0, 0, 137, 136, 1, 0, 0, 0, 138, 23, 1, 0, 0, 0, 139, 143, 3, 48, 24, 0, 140, 142, 3, 42, 21, 0, 141, 140, 1, 0, 0, 0, 142, 145, 1, 0, 0, 0, 143, 141, 1, 0, 0, 0, 143, 144, 1, 0, 0, 0, 144, 146, 1, 0, 0, 0, 145, 143, 1, 0, 0, 0, 146, 147, 5, 68, 0, 0, 147, 148, 5, 10, 0, 0, 148, 149, 3, 40, 20, 0, 149, 150, 5, 2, 0, 0, 150, 25, 1, 0, 0, 0, 151, 152, 3, 48, 24, 0, 152, 153, 5, 68, 0, 0, 153, 154, 5, 16, 0, 0, 154, 155, 3, 48, 24, 0, 155, 156, 5, 68, 0, 0, 156, 157, 5, 10, 0, 0, 157, 158, 3, 40, 20, 0, 158, 159, 5, 2, 0, 0, 159, 27, 1, 0, 0, 0, 160, 161, 5, 68, 0, 0, 161, 162, 5, 10, 0, 0, 162, 163, 3, 40, 20, 0, 163, 164, 5, 2, 0, 0, 164, 29, 1, 0, 0, 0, 165, 166, 5, 18, 0, 0, 166, 167, 5, 15, 0, 0, 167, 168, 5, 66, 0, 0, 168, 169, 5, 6, 0, 0, 169, 170, 3, 40, 20, 0, 170, 171, 5, 17, 0, 0, 171, 172, 5, 2, 0, 0, 172, 31, 1, 0, 0, 0, 173, 174, 5, 18, 0, 0, 174, 175, 5, 15, 0, 0, 175, 176, 3, 40, 20, 0, 176, 177, 5, 17, 0, 0, 177, 178, 5, 2, 0, 0, 178, 33, 1, 0, 0, 0, 179, 180, 5, 19, 0, 0, 180, 181, 5, 15, 0, 0, 181, 182, 3, 40, 20, 0, 182, 183, 5, 17, 0, 0, 183, 186, 3, 20, 10, 0, 184, 185, 5, 20, 0, 0, 185, 187, 3, 20, 10, 0, 186, 184, 1, 0, 0, 0, 186, 187, 1, 0, 0, 0, 187, 35, 1, 0, 0, 0, 188, 189, 5, 68, 0, 0, 189, 190, 3, 38, 19, 0, 190, 37, 1, 0, 0, 0, 191, 203, 5, 15, 0, 0, 192, 197, 3, 40, 20, 0, 193, 194, 5, 16, 0, 0, 194, 196, 3, 40, 20, 0, 195, 193, 1, 0, 0, 0, 196, 199, 1, 0, 0, 0, 197, 195, 1, 0, 0, 0, 197, 198, 1, 0, 0, 0, 198, 201, 1, 0, 0, 0, 199, 197, 1, 0, 0, 0, 200, 202, 5, 16, 0, 0, 201, 200, 1, 0, 0, 0, 201, 202, 1, 0, 0, 0, 202, 204, 1, 0, 0, 0, 203, 192, 1, 0, 0, 0, 203, 204, 1, 0, 0, 0, 204, 205, 1, 0, 0, 0, 205, 206, 5, 17, 0, 0, 206, 39, 1, 0, 0, 0, 207, 208, 6, 20, -1, 0, 208, 209, 5, 15, 0, 0, 209, 210, 3, 40, 20, 0, 210, 211, 5, 17, 0, 0, 211, 261, 1, 0, 0, 0, 212, 213, 3, 48, 24, 0, 213, 214, 5, 15, 0, 0, 214, 217, 3, 40, 20, 0, 215, 216, 5, 16, 0, 0, 216, 218, 3, 40, 20, 0, 217, 215, 1, 0, 0, 0, 217, 218, 1, 0, 0, 0, 218, 220, 1, 0, 0, 0, 219, 221, 5, 16, 0, 0, 220, 219, 1, 0, 0, 0, 220, 221, 1, 0, 0, 0, 221, 222, 1, 0, 0, 0, 222, 223, 5, 17, 0, 0, 223, 261, 1, 0, 0, 0, 224, 261, 3, 36, 18, 0, 225, 226, 5, 21, 0, 0, 226, 227, 5, 68, 0, 0, 227, 261, 3, 38, 19, 0, 228, 229, 5, 24, 0, 0, 229, 230, 5, 22, 0, 0, 230, 231, 3, 40, 20, 0, 231, 232, 5, 23, 0, 0, 232, 233, 7, 1, 0, 0, 233, 261, 1, 0, 0, 0, 234, 235, 5, 30, 0, 0, 235, 236, 5, 22, 0, 0, 236, 237, 3, 40, 20, 0, 237, 238, 5, 23, 0, 0, 238, 239, 7, 2, 0, 0, 239, 261, 1, 0, 0, 0, 240, 241, 7, 3, 0, 0, 241, 261, 3, 40, 20, 14, 242, 254, 5, 22, 0, 0, 243, 248, 3, 40, 20, 0, 244, 245, 5, 16, 0, 0, 245, 247, 3, 40, 20, 0, 246, 244, 1, 0, 0, 0, 247, 250, 1, 0, 0, 0, 248, 246, 1, 0, 0, 0, 248, 249, 1, 0, 0, 0, 249, 252, 1, 0, 0, 0, 250, 248, 1, 0, 0, 0, 251, 253, 5, 16, 0, 0, 252, 251, 1, 0, 0, 0, 252, 253, 1, 0, 0, 0, 253, 255, 1, 0, 0, 0, 254, 243, 1, 0, 0, 0, 254, 255, 1, 0, 0, 0, 255, 256, 1, 0, 0, 0, 256, 261, 5, 23, 0, 0, 257, 261, 5, 67, 0, 0, 258, 261, 5, 68, 0, 0, 259, 261, 3, 44, 22, 0, 260, 207, 1, 0, 0, 0, 260, 212, 1, 0, 0, 0, 260, 224, 1, 0, 0, 0, 260, 225, 1, 0, 0, 0, 260, 228, 1, 0, 0, 0, 260, 234, 1, 0, 0, 0, 260, 240, 1, 0, 0, 0, 260, 242, 1, 0, 0, 0, 260, 257, 1, 0, 0, 0, 260, 258, 1, 0, 0, 0, 260, 259, 1, 0, 0, 0, 261, 303, 1, 0, 0, 0, 262, 263, 10, 13, 0, 0, 263, 264, 7, 4, 0, 0, 264, 302, 3, 40, 20, 14, 265, 266, 10, 12, 0, 0, 266, 267, 7, 5, 0, 0, 267, 302, 3, 40, 20, 13, 268, 269, 10, 11, 0, 0, 269, 270, 7, 6, 0, 0, 270, 302, 3, 40, 20, 12, 271, 272, 10, 10, 0, 0, 272, 273, 7, 7, 0, 0, 273, 302, 3, 40, 20, 11, 274, 275, 10, 9, 0, 0, 275, 276, 5, 46, 0, 0, 276, 302, 3, 40, 20, 10, 277, 278, 10, 8, 0, 0, 278, 279, 5, 4, 0, 0, 279, 302, 3, 40, 20, 9, 280, 281, 10, 7, 0, 0, 281, 282, 5, 47, 0, 0, 282, 302, 3, 40, 20, 8, 283, 284, 10, 6, 0, 0, 284, 285, 5, 48, 0, 0, 285, 302, 3, 40, 20, 7, 286, 287, 10, 5, 0, 0, 287, 288, 5, 49, 0, 0, 288, 302, 3, 40, 20, 6, 289, 290, 10, 19, 0, 0, 290, 291, 5, 22, 0, 0, 291, 292, 5, 60, 0, 0, 292, 302, 5, 23, 0, 0, 293, 294, 10, 16, 0, 0, 294, 302, 7, 8, 0, 0, 295, 296, 10, 15, 0, 0, 296, 297, 5, 37, 0, 0, 297, 298, 5, 15, 0, 0, 298, 299, 3, 40, 20, 0, 299, 300, 5, 17, 0, 0, 300, 302, 1, 0, 0, 0, 301, 262, 1, 0, 0, 0, 301, 265, 1, 0, 0, 0, 301, 268, 1, 0, 0, 0, 301, 271, 1, 0, 0, 0, 301, 274, 1, 0, 0, 0, 301, 277, 1, 0, 0, 0, 301, 280, 1, 0, 0, 0, 301, 283, 1, 0, 0, 0, 301, 286, 1, 0, 0, 0, 301, 289, 1, 0, 0, 0, 301, 293, 1, 0, 0, 0, 301, 295, 1, 0, 0, 0, 302, 305, 1, 0, 0, 0, 303, 301, 1, 0, 0, 0, 303, 304, 1, 0, 0, 0, 304, 41, 1, 0, 0, 0, 305, 303, 1, 0, 0, 0, 306, 307, 5, 50, 0, 0, 307, 43, 1, 0, 0, 0, 308, 314, 5, 58, 0, 0, 309, 314, 3, 46, 23, 0, 310, 314, 5, 63, 0, 0, 311, 314, 5, 64, 0, 0, 312, 314, 5, 65, 0, 0, 313, 308, 1, 0, 0, 0, 313, 309, 1, 0, 0, 0, 313, 310, 1, 0, 0, 0, 313, 311, 1, 0, 0, 0, 313, 312, 1, 0, 0, 0, 314, 45, 1, 0, 0, 0, 315, 317, 5, 60, 0, 0, 316, 318, 5, 59, 0, 0, 317, 316, 1, 0, 0, 0, 317, 318, 1, 0, 0, 0, 318, 47, 1, 0, 0, 0, 319, 320, 7, 9, 0, 0, 320, 49, 1, 0, 0, 0, 26, 53, 68, 71, 84, 96, 107, 111, 113, 124, 129, 137, 143, 186, 197, 201, 203, 217, 220, 248, 252, 254, 260, 301, 303, 313, 317]
\ No newline at end of file
diff --git a/packages/cashc/src/grammar/CashScriptLexer.interp b/packages/cashc/src/grammar/CashScriptLexer.interp
index 65c158ce..3670f3d0 100644
--- a/packages/cashc/src/grammar/CashScriptLexer.interp
+++ b/packages/cashc/src/grammar/CashScriptLexer.interp
@@ -227,4 +227,4 @@ mode names:
 DEFAULT_MODE
 
 atn:
-[3, 51485, 51898, 1421, 44986, 20307, 1543, 60043, 49729, 2, 73, 808, 8, 1, 4, 2, 9, 2, 4, 3, 9, 3, 4, 4, 9, 4, 4, 5, 9, 5, 4, 6, 9, 6, 4, 7, 9, 7, 4, 8, 9, 8, 4, 9, 9, 9, 4, 10, 9, 10, 4, 11, 9, 11, 4, 12, 9, 12, 4, 13, 9, 13, 4, 14, 9, 14, 4, 15, 9, 15, 4, 16, 9, 16, 4, 17, 9, 17, 4, 18, 9, 18, 4, 19, 9, 19, 4, 20, 9, 20, 4, 21, 9, 21, 4, 22, 9, 22, 4, 23, 9, 23, 4, 24, 9, 24, 4, 25, 9, 25, 4, 26, 9, 26, 4, 27, 9, 27, 4, 28, 9, 28, 4, 29, 9, 29, 4, 30, 9, 30, 4, 31, 9, 31, 4, 32, 9, 32, 4, 33, 9, 33, 4, 34, 9, 34, 4, 35, 9, 35, 4, 36, 9, 36, 4, 37, 9, 37, 4, 38, 9, 38, 4, 39, 9, 39, 4, 40, 9, 40, 4, 41, 9, 41, 4, 42, 9, 42, 4, 43, 9, 43, 4, 44, 9, 44, 4, 45, 9, 45, 4, 46, 9, 46, 4, 47, 9, 47, 4, 48, 9, 48, 4, 49, 9, 49, 4, 50, 9, 50, 4, 51, 9, 51, 4, 52, 9, 52, 4, 53, 9, 53, 4, 54, 9, 54, 4, 55, 9, 55, 4, 56, 9, 56, 4, 57, 9, 57, 4, 58, 9, 58, 4, 59, 9, 59, 4, 60, 9, 60, 4, 61, 9, 61, 4, 62, 9, 62, 4, 63, 9, 63, 4, 64, 9, 64, 4, 65, 9, 65, 4, 66, 9, 66, 4, 67, 9, 67, 4, 68, 9, 68, 4, 69, 9, 69, 4, 70, 9, 70, 4, 71, 9, 71, 4, 72, 9, 72, 3, 2, 3, 2, 3, 2, 3, 2, 3, 2, 3, 2, 3, 2, 3, 3, 3, 3, 3, 4, 3, 4, 3, 4, 3, 4, 3, 4, 3, 4, 3, 4, 3, 4, 3, 4, 3, 4, 3, 4, 3, 5, 3, 5, 3, 6, 3, 6, 3, 7, 3, 7, 3, 7, 3, 8, 3, 8, 3, 9, 3, 9, 3, 10, 3, 10, 3, 10, 3, 11, 3, 11, 3, 12, 3, 12, 3, 12, 3, 12, 3, 12, 3, 12, 3, 12, 3, 12, 3, 12, 3, 13, 3, 13, 3, 14, 3, 14, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 15, 3, 16, 3, 16, 3, 17, 3, 17, 3, 18, 3, 18, 3, 19, 3, 19, 3, 19, 3, 19, 3, 19, 3, 19, 3, 19, 3, 19, 3, 20, 3, 20, 3, 20, 3, 21, 3, 21, 3, 21, 3, 21, 3, 21, 3, 22, 3, 22, 3, 22, 3, 22, 3, 23, 3, 23, 3, 24, 3, 24, 3, 25, 3, 25, 3, 25, 3, 25, 3, 25, 3, 25, 3, 25, 3, 25, 3, 25, 3, 25, 3, 25, 3, 26, 3, 26, 3, 26, 3, 26, 3, 26, 3, 26, 3, 26, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 27, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 28, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 29, 3, 30, 3, 30, 3, 30, 3, 30, 3, 30, 3, 30, 3, 30, 3, 30, 3, 30, 3, 30, 3, 30, 3, 30, 3, 30, 3, 31, 3, 31, 3, 31, 3, 31, 3, 31, 3, 31, 3, 31, 3, 31, 3, 31, 3, 31, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 32, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 33, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 34, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 35, 3, 36, 3, 36, 3, 36, 3, 36, 3, 36, 3, 36, 3, 36, 3, 36, 3, 36, 3, 36, 3, 36, 3, 37, 3, 37, 3, 37, 3, 37, 3, 37, 3, 37, 3, 37, 3, 37, 3, 38, 3, 38, 3, 38, 3, 38, 3, 38, 3, 38, 3, 38, 3, 39, 3, 39, 3, 40, 3, 40, 3, 41, 3, 41, 3, 42, 3, 42, 3, 43, 3, 43, 3, 44, 3, 44, 3, 45, 3, 45, 3, 45, 3, 46, 3, 46, 3, 46, 3, 47, 3, 47, 3, 48, 3, 48, 3, 49, 3, 49, 3, 49, 3, 50, 3, 50, 3, 50, 3, 51, 3, 51, 3, 51, 3, 51, 3, 51, 3, 51, 3, 51, 3, 51, 3, 51, 3, 52, 3, 52, 3, 52, 3, 52, 3, 53, 3, 53, 3, 53, 3, 53, 3, 53, 3, 54, 3, 54, 3, 54, 3, 54, 3, 54, 3, 54, 3, 54, 3, 55, 3, 55, 3, 55, 3, 55, 3, 55, 3, 55, 3, 55, 3, 56, 3, 56, 3, 56, 3, 56, 3, 57, 3, 57, 3, 57, 3, 57, 3, 57, 3, 57, 3, 57, 3, 57, 3, 58, 6, 58, 496, 10, 58, 13, 58, 14, 58, 497, 3, 58, 3, 58, 6, 58, 502, 10, 58, 13, 58, 14, 58, 503, 3, 58, 3, 58, 6, 58, 508, 10, 58, 13, 58, 14, 58, 509, 3, 59, 3, 59, 3, 59, 3, 59, 3, 59, 3, 59, 3, 59, 3, 59, 3, 59, 5, 59, 521, 10, 59, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 3, 60, 5, 60, 580, 10, 60, 3, 61, 5, 61, 583, 10, 61, 3, 61, 6, 61, 586, 10, 61, 13, 61, 14, 61, 587, 3, 61, 3, 61, 6, 61, 592, 10, 61, 13, 61, 14, 61, 593, 5, 61, 596, 10, 61, 3, 62, 3, 62, 3, 62, 3, 62, 3, 62, 3, 62, 3, 62, 5, 62, 605, 10, 62, 3, 62, 3, 62, 3, 62, 3, 62, 5, 62, 611, 10, 62, 3, 63, 3, 63, 7, 63, 615, 10, 63, 12, 63, 14, 63, 618, 11, 63, 3, 64, 3, 64, 3, 64, 3, 64, 7, 64, 624, 10, 64, 12, 64, 14, 64, 627, 11, 64, 3, 64, 3, 64, 3, 64, 3, 64, 3, 64, 7, 64, 634, 10, 64, 12, 64, 14, 64, 637, 11, 64, 3, 64, 5, 64, 640, 10, 64, 3, 65, 3, 65, 3, 65, 3, 65, 3, 65, 3, 65, 3, 65, 3, 65, 3, 65, 3, 66, 3, 66, 3, 66, 7, 66, 654, 10, 66, 12, 66, 14, 66, 657, 11, 66, 3, 67, 3, 67, 3, 67, 3, 67, 3, 67, 3, 67, 3, 67, 3, 67, 3, 67, 3, 67, 3, 67, 3, 67, 3, 67, 5, 67, 672, 10, 67, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 3, 68, 5, 68, 768, 10, 68, 3, 69, 3, 69, 7, 69, 772, 10, 69, 12, 69, 14, 69, 775, 11, 69, 3, 70, 6, 70, 778, 10, 70, 13, 70, 14, 70, 779, 3, 70, 3, 70, 3, 71, 3, 71, 3, 71, 3, 71, 7, 71, 788, 10, 71, 12, 71, 14, 71, 791, 11, 71, 3, 71, 3, 71, 3, 71, 3, 71, 3, 71, 3, 72, 3, 72, 3, 72, 3, 72, 7, 72, 802, 10, 72, 12, 72, 14, 72, 805, 11, 72, 3, 72, 3, 72, 5, 625, 635, 789, 2, 2, 73, 3, 2, 3, 5, 2, 4, 7, 2, 5, 9, 2, 6, 11, 2, 7, 13, 2, 8, 15, 2, 9, 17, 2, 10, 19, 2, 11, 21, 2, 12, 23, 2, 13, 25, 2, 14, 27, 2, 15, 29, 2, 16, 31, 2, 17, 33, 2, 18, 35, 2, 19, 37, 2, 20, 39, 2, 21, 41, 2, 22, 43, 2, 23, 45, 2, 24, 47, 2, 25, 49, 2, 26, 51, 2, 27, 53, 2, 28, 55, 2, 29, 57, 2, 30, 59, 2, 31, 61, 2, 32, 63, 2, 33, 65, 2, 34, 67, 2, 35, 69, 2, 36, 71, 2, 37, 73, 2, 38, 75, 2, 39, 77, 2, 40, 79, 2, 41, 81, 2, 42, 83, 2, 43, 85, 2, 44, 87, 2, 45, 89, 2, 46, 91, 2, 47, 93, 2, 48, 95, 2, 49, 97, 2, 50, 99, 2, 51, 101, 2, 52, 103, 2, 53, 105, 2, 54, 107, 2, 55, 109, 2, 56, 111, 2, 57, 113, 2, 58, 115, 2, 59, 117, 2, 60, 119, 2, 61, 121, 2, 62, 123, 2, 63, 125, 2, 64, 127, 2, 65, 129, 2, 66, 131, 2, 67, 133, 2, 68, 135, 2, 69, 137, 2, 70, 139, 2, 71, 141, 2, 72, 143, 2, 73, 3, 2, 14, 3, 2, 50, 59, 3, 2, 47, 47, 4, 2, 71, 71, 103, 103, 3, 2, 51, 59, 5, 2, 12, 12, 15, 15, 36, 36, 5, 2, 12, 12, 15, 15, 41, 41, 4, 2, 90, 90, 122, 122, 5, 2, 50, 59, 67, 72, 99, 104, 4, 2, 67, 92, 99, 124, 6, 2, 50, 59, 67, 92, 97, 97, 99, 124, 5, 2, 11, 12, 14, 15, 34, 34, 4, 2, 12, 12, 15, 15, 2, 843, 2, 3, 3, 2, 2, 2, 2, 5, 3, 2, 2, 2, 2, 7, 3, 2, 2, 2, 2, 9, 3, 2, 2, 2, 2, 11, 3, 2, 2, 2, 2, 13, 3, 2, 2, 2, 2, 15, 3, 2, 2, 2, 2, 17, 3, 2, 2, 2, 2, 19, 3, 2, 2, 2, 2, 21, 3, 2, 2, 2, 2, 23, 3, 2, 2, 2, 2, 25, 3, 2, 2, 2, 2, 27, 3, 2, 2, 2, 2, 29, 3, 2, 2, 2, 2, 31, 3, 2, 2, 2, 2, 33, 3, 2, 2, 2, 2, 35, 3, 2, 2, 2, 2, 37, 3, 2, 2, 2, 2, 39, 3, 2, 2, 2, 2, 41, 3, 2, 2, 2, 2, 43, 3, 2, 2, 2, 2, 45, 3, 2, 2, 2, 2, 47, 3, 2, 2, 2, 2, 49, 3, 2, 2, 2, 2, 51, 3, 2, 2, 2, 2, 53, 3, 2, 2, 2, 2, 55, 3, 2, 2, 2, 2, 57, 3, 2, 2, 2, 2, 59, 3, 2, 2, 2, 2, 61, 3, 2, 2, 2, 2, 63, 3, 2, 2, 2, 2, 65, 3, 2, 2, 2, 2, 67, 3, 2, 2, 2, 2, 69, 3, 2, 2, 2, 2, 71, 3, 2, 2, 2, 2, 73, 3, 2, 2, 2, 2, 75, 3, 2, 2, 2, 2, 77, 3, 2, 2, 2, 2, 79, 3, 2, 2, 2, 2, 81, 3, 2, 2, 2, 2, 83, 3, 2, 2, 2, 2, 85, 3, 2, 2, 2, 2, 87, 3, 2, 2, 2, 2, 89, 3, 2, 2, 2, 2, 91, 3, 2, 2, 2, 2, 93, 3, 2, 2, 2, 2, 95, 3, 2, 2, 2, 2, 97, 3, 2, 2, 2, 2, 99, 3, 2, 2, 2, 2, 101, 3, 2, 2, 2, 2, 103, 3, 2, 2, 2, 2, 105, 3, 2, 2, 2, 2, 107, 3, 2, 2, 2, 2, 109, 3, 2, 2, 2, 2, 111, 3, 2, 2, 2, 2, 113, 3, 2, 2, 2, 2, 115, 3, 2, 2, 2, 2, 117, 3, 2, 2, 2, 2, 119, 3, 2, 2, 2, 2, 121, 3, 2, 2, 2, 2, 123, 3, 2, 2, 2, 2, 125, 3, 2, 2, 2, 2, 127, 3, 2, 2, 2, 2, 129, 3, 2, 2, 2, 2, 131, 3, 2, 2, 2, 2, 133, 3, 2, 2, 2, 2, 135, 3, 2, 2, 2, 2, 137, 3, 2, 2, 2, 2, 139, 3, 2, 2, 2, 2, 141, 3, 2, 2, 2, 2, 143, 3, 2, 2, 2, 3, 145, 3, 2, 2, 2, 5, 152, 3, 2, 2, 2, 7, 154, 3, 2, 2, 2, 9, 165, 3, 2, 2, 2, 11, 167, 3, 2, 2, 2, 13, 169, 3, 2, 2, 2, 15, 172, 3, 2, 2, 2, 17, 174, 3, 2, 2, 2, 19, 176, 3, 2, 2, 2, 21, 179, 3, 2, 2, 2, 23, 181, 3, 2, 2, 2, 25, 190, 3, 2, 2, 2, 27, 192, 3, 2, 2, 2, 29, 194, 3, 2, 2, 2, 31, 203, 3, 2, 2, 2, 33, 205, 3, 2, 2, 2, 35, 207, 3, 2, 2, 2, 37, 209, 3, 2, 2, 2, 39, 217, 3, 2, 2, 2, 41, 220, 3, 2, 2, 2, 43, 225, 3, 2, 2, 2, 45, 229, 3, 2, 2, 2, 47, 231, 3, 2, 2, 2, 49, 233, 3, 2, 2, 2, 51, 244, 3, 2, 2, 2, 53, 251, 3, 2, 2, 2, 55, 268, 3, 2, 2, 2, 57, 283, 3, 2, 2, 2, 59, 298, 3, 2, 2, 2, 61, 311, 3, 2, 2, 2, 63, 321, 3, 2, 2, 2, 65, 346, 3, 2, 2, 2, 67, 361, 3, 2, 2, 2, 69, 380, 3, 2, 2, 2, 71, 396, 3, 2, 2, 2, 73, 407, 3, 2, 2, 2, 75, 415, 3, 2, 2, 2, 77, 422, 3, 2, 2, 2, 79, 424, 3, 2, 2, 2, 81, 426, 3, 2, 2, 2, 83, 428, 3, 2, 2, 2, 85, 430, 3, 2, 2, 2, 87, 432, 3, 2, 2, 2, 89, 434, 3, 2, 2, 2, 91, 437, 3, 2, 2, 2, 93, 440, 3, 2, 2, 2, 95, 442, 3, 2, 2, 2, 97, 444, 3, 2, 2, 2, 99, 447, 3, 2, 2, 2, 101, 450, 3, 2, 2, 2, 103, 459, 3, 2, 2, 2, 105, 463, 3, 2, 2, 2, 107, 468, 3, 2, 2, 2, 109, 475, 3, 2, 2, 2, 111, 482, 3, 2, 2, 2, 113, 486, 3, 2, 2, 2, 115, 495, 3, 2, 2, 2, 117, 520, 3, 2, 2, 2, 119, 579, 3, 2, 2, 2, 121, 582, 3, 2, 2, 2, 123, 610, 3, 2, 2, 2, 125, 612, 3, 2, 2, 2, 127, 639, 3, 2, 2, 2, 129, 641, 3, 2, 2, 2, 131, 650, 3, 2, 2, 2, 133, 671, 3, 2, 2, 2, 135, 767, 3, 2, 2, 2, 137, 769, 3, 2, 2, 2, 139, 777, 3, 2, 2, 2, 141, 783, 3, 2, 2, 2, 143, 797, 3, 2, 2, 2, 145, 146, 7, 114, 2, 2, 146, 147, 7, 116, 2, 2, 147, 148, 7, 99, 2, 2, 148, 149, 7, 105, 2, 2, 149, 150, 7, 111, 2, 2, 150, 151, 7, 99, 2, 2, 151, 4, 3, 2, 2, 2, 152, 153, 7, 61, 2, 2, 153, 6, 3, 2, 2, 2, 154, 155, 7, 101, 2, 2, 155, 156, 7, 99, 2, 2, 156, 157, 7, 117, 2, 2, 157, 158, 7, 106, 2, 2, 158, 159, 7, 117, 2, 2, 159, 160, 7, 101, 2, 2, 160, 161, 7, 116, 2, 2, 161, 162, 7, 107, 2, 2, 162, 163, 7, 114, 2, 2, 163, 164, 7, 118, 2, 2, 164, 8, 3, 2, 2, 2, 165, 166, 7, 96, 2, 2, 166, 10, 3, 2, 2, 2, 167, 168, 7, 128, 2, 2, 168, 12, 3, 2, 2, 2, 169, 170, 7, 64, 2, 2, 170, 171, 7, 63, 2, 2, 171, 14, 3, 2, 2, 2, 172, 173, 7, 64, 2, 2, 173, 16, 3, 2, 2, 2, 174, 175, 7, 62, 2, 2, 175, 18, 3, 2, 2, 2, 176, 177, 7, 62, 2, 2, 177, 178, 7, 63, 2, 2, 178, 20, 3, 2, 2, 2, 179, 180, 7, 63, 2, 2, 180, 22, 3, 2, 2, 2, 181, 182, 7, 101, 2, 2, 182, 183, 7, 113, 2, 2, 183, 184, 7, 112, 2, 2, 184, 185, 7, 118, 2, 2, 185, 186, 7, 116, 2, 2, 186, 187, 7, 99, 2, 2, 187, 188, 7, 101, 2, 2, 188, 189, 7, 118, 2, 2, 189, 24, 3, 2, 2, 2, 190, 191, 7, 125, 2, 2, 191, 26, 3, 2, 2, 2, 192, 193, 7, 127, 2, 2, 193, 28, 3, 2, 2, 2, 194, 195, 7, 104, 2, 2, 195, 196, 7, 119, 2, 2, 196, 197, 7, 112, 2, 2, 197, 198, 7, 101, 2, 2, 198, 199, 7, 118, 2, 2, 199, 200, 7, 107, 2, 2, 200, 201, 7, 113, 2, 2, 201, 202, 7, 112, 2, 2, 202, 30, 3, 2, 2, 2, 203, 204, 7, 42, 2, 2, 204, 32, 3, 2, 2, 2, 205, 206, 7, 46, 2, 2, 206, 34, 3, 2, 2, 2, 207, 208, 7, 43, 2, 2, 208, 36, 3, 2, 2, 2, 209, 210, 7, 116, 2, 2, 210, 211, 7, 103, 2, 2, 211, 212, 7, 115, 2, 2, 212, 213, 7, 119, 2, 2, 213, 214, 7, 107, 2, 2, 214, 215, 7, 116, 2, 2, 215, 216, 7, 103, 2, 2, 216, 38, 3, 2, 2, 2, 217, 218, 7, 107, 2, 2, 218, 219, 7, 104, 2, 2, 219, 40, 3, 2, 2, 2, 220, 221, 7, 103, 2, 2, 221, 222, 7, 110, 2, 2, 222, 223, 7, 117, 2, 2, 223, 224, 7, 103, 2, 2, 224, 42, 3, 2, 2, 2, 225, 226, 7, 112, 2, 2, 226, 227, 7, 103, 2, 2, 227, 228, 7, 121, 2, 2, 228, 44, 3, 2, 2, 2, 229, 230, 7, 93, 2, 2, 230, 46, 3, 2, 2, 2, 231, 232, 7, 95, 2, 2, 232, 48, 3, 2, 2, 2, 233, 234, 7, 118, 2, 2, 234, 235, 7, 122, 2, 2, 235, 236, 7, 48, 2, 2, 236, 237, 7, 113, 2, 2, 237, 238, 7, 119, 2, 2, 238, 239, 7, 118, 2, 2, 239, 240, 7, 114, 2, 2, 240, 241, 7, 119, 2, 2, 241, 242, 7, 118, 2, 2, 242, 243, 7, 117, 2, 2, 243, 50, 3, 2, 2, 2, 244, 245, 7, 48, 2, 2, 245, 246, 7, 120, 2, 2, 246, 247, 7, 99, 2, 2, 247, 248, 7, 110, 2, 2, 248, 249, 7, 119, 2, 2, 249, 250, 7, 103, 2, 2, 250, 52, 3, 2, 2, 2, 251, 252, 7, 48, 2, 2, 252, 253, 7, 110, 2, 2, 253, 254, 7, 113, 2, 2, 254, 255, 7, 101, 2, 2, 255, 256, 7, 109, 2, 2, 256, 257, 7, 107, 2, 2, 257, 258, 7, 112, 2, 2, 258, 259, 7, 105, 2, 2, 259, 260, 7, 68, 2, 2, 260, 261, 7, 123, 2, 2, 261, 262, 7, 118, 2, 2, 262, 263, 7, 103, 2, 2, 263, 264, 7, 101, 2, 2, 264, 265, 7, 113, 2, 2, 265, 266, 7, 102, 2, 2, 266, 267, 7, 103, 2, 2, 267, 54, 3, 2, 2, 2, 268, 269, 7, 48, 2, 2, 269, 270, 7, 118, 2, 2, 270, 271, 7, 113, 2, 2, 271, 272, 7, 109, 2, 2, 272, 273, 7, 103, 2, 2, 273, 274, 7, 112, 2, 2, 274, 275, 7, 69, 2, 2, 275, 276, 7, 99, 2, 2, 276, 277, 7, 118, 2, 2, 277, 278, 7, 103, 2, 2, 278, 279, 7, 105, 2, 2, 279, 280, 7, 113, 2, 2, 280, 281, 7, 116, 2, 2, 281, 282, 7, 123, 2, 2, 282, 56, 3, 2, 2, 2, 283, 284, 7, 48, 2, 2, 284, 285, 7, 112, 2, 2, 285, 286, 7, 104, 2, 2, 286, 287, 7, 118, 2, 2, 287, 288, 7, 69, 2, 2, 288, 289, 7, 113, 2, 2, 289, 290, 7, 111, 2, 2, 290, 291, 7, 111, 2, 2, 291, 292, 7, 107, 2, 2, 292, 293, 7, 118, 2, 2, 293, 294, 7, 111, 2, 2, 294, 295, 7, 103, 2, 2, 295, 296, 7, 112, 2, 2, 296, 297, 7, 118, 2, 2, 297, 58, 3, 2, 2, 2, 298, 299, 7, 48, 2, 2, 299, 300, 7, 118, 2, 2, 300, 301, 7, 113, 2, 2, 301, 302, 7, 109, 2, 2, 302, 303, 7, 103, 2, 2, 303, 304, 7, 112, 2, 2, 304, 305, 7, 67, 2, 2, 305, 306, 7, 111, 2, 2, 306, 307, 7, 113, 2, 2, 307, 308, 7, 119, 2, 2, 308, 309, 7, 112, 2, 2, 309, 310, 7, 118, 2, 2, 310, 60, 3, 2, 2, 2, 311, 312, 7, 118, 2, 2, 312, 313, 7, 122, 2, 2, 313, 314, 7, 48, 2, 2, 314, 315, 7, 107, 2, 2, 315, 316, 7, 112, 2, 2, 316, 317, 7, 114, 2, 2, 317, 318, 7, 119, 2, 2, 318, 319, 7, 118, 2, 2, 319, 320, 7, 117, 2, 2, 320, 62, 3, 2, 2, 2, 321, 322, 7, 48, 2, 2, 322, 323, 7, 113, 2, 2, 323, 324, 7, 119, 2, 2, 324, 325, 7, 118, 2, 2, 325, 326, 7, 114, 2, 2, 326, 327, 7, 113, 2, 2, 327, 328, 7, 107, 2, 2, 328, 329, 7, 112, 2, 2, 329, 330, 7, 118, 2, 2, 330, 331, 7, 86, 2, 2, 331, 332, 7, 116, 2, 2, 332, 333, 7, 99, 2, 2, 333, 334, 7, 112, 2, 2, 334, 335, 7, 117, 2, 2, 335, 336, 7, 99, 2, 2, 336, 337, 7, 101, 2, 2, 337, 338, 7, 118, 2, 2, 338, 339, 7, 107, 2, 2, 339, 340, 7, 113, 2, 2, 340, 341, 7, 112, 2, 2, 341, 342, 7, 74, 2, 2, 342, 343, 7, 99, 2, 2, 343, 344, 7, 117, 2, 2, 344, 345, 7, 106, 2, 2, 345, 64, 3, 2, 2, 2, 346, 347, 7, 48, 2, 2, 347, 348, 7, 113, 2, 2, 348, 349, 7, 119, 2, 2, 349, 350, 7, 118, 2, 2, 350, 351, 7, 114, 2, 2, 351, 352, 7, 113, 2, 2, 352, 353, 7, 107, 2, 2, 353, 354, 7, 112, 2, 2, 354, 355, 7, 118, 2, 2, 355, 356, 7, 75, 2, 2, 356, 357, 7, 112, 2, 2, 357, 358, 7, 102, 2, 2, 358, 359, 7, 103, 2, 2, 359, 360, 7, 122, 2, 2, 360, 66, 3, 2, 2, 2, 361, 362, 7, 48, 2, 2, 362, 363, 7, 119, 2, 2, 363, 364, 7, 112, 2, 2, 364, 365, 7, 110, 2, 2, 365, 366, 7, 113, 2, 2, 366, 367, 7, 101, 2, 2, 367, 368, 7, 109, 2, 2, 368, 369, 7, 107, 2, 2, 369, 370, 7, 112, 2, 2, 370, 371, 7, 105, 2, 2, 371, 372, 7, 68, 2, 2, 372, 373, 7, 123, 2, 2, 373, 374, 7, 118, 2, 2, 374, 375, 7, 103, 2, 2, 375, 376, 7, 101, 2, 2, 376, 377, 7, 113, 2, 2, 377, 378, 7, 102, 2, 2, 378, 379, 7, 103, 2, 2, 379, 68, 3, 2, 2, 2, 380, 381, 7, 48, 2, 2, 381, 382, 7, 117, 2, 2, 382, 383, 7, 103, 2, 2, 383, 384, 7, 115, 2, 2, 384, 385, 7, 119, 2, 2, 385, 386, 7, 103, 2, 2, 386, 387, 7, 112, 2, 2, 387, 388, 7, 101, 2, 2, 388, 389, 7, 103, 2, 2, 389, 390, 7, 80, 2, 2, 390, 391, 7, 119, 2, 2, 391, 392, 7, 111, 2, 2, 392, 393, 7, 100, 2, 2, 393, 394, 7, 103, 2, 2, 394, 395, 7, 116, 2, 2, 395, 70, 3, 2, 2, 2, 396, 397, 7, 48, 2, 2, 397, 398, 7, 116, 2, 2, 398, 399, 7, 103, 2, 2, 399, 400, 7, 120, 2, 2, 400, 401, 7, 103, 2, 2, 401, 402, 7, 116, 2, 2, 402, 403, 7, 117, 2, 2, 403, 404, 7, 103, 2, 2, 404, 405, 7, 42, 2, 2, 405, 406, 7, 43, 2, 2, 406, 72, 3, 2, 2, 2, 407, 408, 7, 48, 2, 2, 408, 409, 7, 110, 2, 2, 409, 410, 7, 103, 2, 2, 410, 411, 7, 112, 2, 2, 411, 412, 7, 105, 2, 2, 412, 413, 7, 118, 2, 2, 413, 414, 7, 106, 2, 2, 414, 74, 3, 2, 2, 2, 415, 416, 7, 48, 2, 2, 416, 417, 7, 117, 2, 2, 417, 418, 7, 114, 2, 2, 418, 419, 7, 110, 2, 2, 419, 420, 7, 107, 2, 2, 420, 421, 7, 118, 2, 2, 421, 76, 3, 2, 2, 2, 422, 423, 7, 35, 2, 2, 423, 78, 3, 2, 2, 2, 424, 425, 7, 47, 2, 2, 425, 80, 3, 2, 2, 2, 426, 427, 7, 44, 2, 2, 427, 82, 3, 2, 2, 2, 428, 429, 7, 49, 2, 2, 429, 84, 3, 2, 2, 2, 430, 431, 7, 39, 2, 2, 431, 86, 3, 2, 2, 2, 432, 433, 7, 45, 2, 2, 433, 88, 3, 2, 2, 2, 434, 435, 7, 63, 2, 2, 435, 436, 7, 63, 2, 2, 436, 90, 3, 2, 2, 2, 437, 438, 7, 35, 2, 2, 438, 439, 7, 63, 2, 2, 439, 92, 3, 2, 2, 2, 440, 441, 7, 40, 2, 2, 441, 94, 3, 2, 2, 2, 442, 443, 7, 126, 2, 2, 443, 96, 3, 2, 2, 2, 444, 445, 7, 40, 2, 2, 445, 446, 7, 40, 2, 2, 446, 98, 3, 2, 2, 2, 447, 448, 7, 126, 2, 2, 448, 449, 7, 126, 2, 2, 449, 100, 3, 2, 2, 2, 450, 451, 7, 101, 2, 2, 451, 452, 7, 113, 2, 2, 452, 453, 7, 112, 2, 2, 453, 454, 7, 117, 2, 2, 454, 455, 7, 118, 2, 2, 455, 456, 7, 99, 2, 2, 456, 457, 7, 112, 2, 2, 457, 458, 7, 118, 2, 2, 458, 102, 3, 2, 2, 2, 459, 460, 7, 107, 2, 2, 460, 461, 7, 112, 2, 2, 461, 462, 7, 118, 2, 2, 462, 104, 3, 2, 2, 2, 463, 464, 7, 100, 2, 2, 464, 465, 7, 113, 2, 2, 465, 466, 7, 113, 2, 2, 466, 467, 7, 110, 2, 2, 467, 106, 3, 2, 2, 2, 468, 469, 7, 117, 2, 2, 469, 470, 7, 118, 2, 2, 470, 471, 7, 116, 2, 2, 471, 472, 7, 107, 2, 2, 472, 473, 7, 112, 2, 2, 473, 474, 7, 105, 2, 2, 474, 108, 3, 2, 2, 2, 475, 476, 7, 114, 2, 2, 476, 477, 7, 119, 2, 2, 477, 478, 7, 100, 2, 2, 478, 479, 7, 109, 2, 2, 479, 480, 7, 103, 2, 2, 480, 481, 7, 123, 2, 2, 481, 110, 3, 2, 2, 2, 482, 483, 7, 117, 2, 2, 483, 484, 7, 107, 2, 2, 484, 485, 7, 105, 2, 2, 485, 112, 3, 2, 2, 2, 486, 487, 7, 102, 2, 2, 487, 488, 7, 99, 2, 2, 488, 489, 7, 118, 2, 2, 489, 490, 7, 99, 2, 2, 490, 491, 7, 117, 2, 2, 491, 492, 7, 107, 2, 2, 492, 493, 7, 105, 2, 2, 493, 114, 3, 2, 2, 2, 494, 496, 9, 2, 2, 2, 495, 494, 3, 2, 2, 2, 496, 497, 3, 2, 2, 2, 497, 495, 3, 2, 2, 2, 497, 498, 3, 2, 2, 2, 498, 499, 3, 2, 2, 2, 499, 501, 7, 48, 2, 2, 500, 502, 9, 2, 2, 2, 501, 500, 3, 2, 2, 2, 502, 503, 3, 2, 2, 2, 503, 501, 3, 2, 2, 2, 503, 504, 3, 2, 2, 2, 504, 505, 3, 2, 2, 2, 505, 507, 7, 48, 2, 2, 506, 508, 9, 2, 2, 2, 507, 506, 3, 2, 2, 2, 508, 509, 3, 2, 2, 2, 509, 507, 3, 2, 2, 2, 509, 510, 3, 2, 2, 2, 510, 116, 3, 2, 2, 2, 511, 512, 7, 118, 2, 2, 512, 513, 7, 116, 2, 2, 513, 514, 7, 119, 2, 2, 514, 521, 7, 103, 2, 2, 515, 516, 7, 104, 2, 2, 516, 517, 7, 99, 2, 2, 517, 518, 7, 110, 2, 2, 518, 519, 7, 117, 2, 2, 519, 521, 7, 103, 2, 2, 520, 511, 3, 2, 2, 2, 520, 515, 3, 2, 2, 2, 521, 118, 3, 2, 2, 2, 522, 523, 7, 117, 2, 2, 523, 524, 7, 99, 2, 2, 524, 525, 7, 118, 2, 2, 525, 526, 7, 113, 2, 2, 526, 527, 7, 117, 2, 2, 527, 528, 7, 106, 2, 2, 528, 529, 7, 107, 2, 2, 529, 580, 7, 117, 2, 2, 530, 531, 7, 117, 2, 2, 531, 532, 7, 99, 2, 2, 532, 533, 7, 118, 2, 2, 533, 580, 7, 117, 2, 2, 534, 535, 7, 104, 2, 2, 535, 536, 7, 107, 2, 2, 536, 537, 7, 112, 2, 2, 537, 538, 7, 112, 2, 2, 538, 539, 7, 103, 2, 2, 539, 580, 7, 123, 2, 2, 540, 541, 7, 100, 2, 2, 541, 542, 7, 107, 2, 2, 542, 543, 7, 118, 2, 2, 543, 580, 7, 117, 2, 2, 544, 545, 7, 100, 2, 2, 545, 546, 7, 107, 2, 2, 546, 547, 7, 118, 2, 2, 547, 548, 7, 101, 2, 2, 548, 549, 7, 113, 2, 2, 549, 550, 7, 107, 2, 2, 550, 580, 7, 112, 2, 2, 551, 552, 7, 117, 2, 2, 552, 553, 7, 103, 2, 2, 553, 554, 7, 101, 2, 2, 554, 555, 7, 113, 2, 2, 555, 556, 7, 112, 2, 2, 556, 557, 7, 102, 2, 2, 557, 580, 7, 117, 2, 2, 558, 559, 7, 111, 2, 2, 559, 560, 7, 107, 2, 2, 560, 561, 7, 112, 2, 2, 561, 562, 7, 119, 2, 2, 562, 563, 7, 118, 2, 2, 563, 564, 7, 103, 2, 2, 564, 580, 7, 117, 2, 2, 565, 566, 7, 106, 2, 2, 566, 567, 7, 113, 2, 2, 567, 568, 7, 119, 2, 2, 568, 569, 7, 116, 2, 2, 569, 580, 7, 117, 2, 2, 570, 571, 7, 102, 2, 2, 571, 572, 7, 99, 2, 2, 572, 573, 7, 123, 2, 2, 573, 580, 7, 117, 2, 2, 574, 575, 7, 121, 2, 2, 575, 576, 7, 103, 2, 2, 576, 577, 7, 103, 2, 2, 577, 578, 7, 109, 2, 2, 578, 580, 7, 117, 2, 2, 579, 522, 3, 2, 2, 2, 579, 530, 3, 2, 2, 2, 579, 534, 3, 2, 2, 2, 579, 540, 3, 2, 2, 2, 579, 544, 3, 2, 2, 2, 579, 551, 3, 2, 2, 2, 579, 558, 3, 2, 2, 2, 579, 565, 3, 2, 2, 2, 579, 570, 3, 2, 2, 2, 579, 574, 3, 2, 2, 2, 580, 120, 3, 2, 2, 2, 581, 583, 9, 3, 2, 2, 582, 581, 3, 2, 2, 2, 582, 583, 3, 2, 2, 2, 583, 585, 3, 2, 2, 2, 584, 586, 9, 2, 2, 2, 585, 584, 3, 2, 2, 2, 586, 587, 3, 2, 2, 2, 587, 585, 3, 2, 2, 2, 587, 588, 3, 2, 2, 2, 588, 595, 3, 2, 2, 2, 589, 591, 9, 4, 2, 2, 590, 592, 9, 2, 2, 2, 591, 590, 3, 2, 2, 2, 592, 593, 3, 2, 2, 2, 593, 591, 3, 2, 2, 2, 593, 594, 3, 2, 2, 2, 594, 596, 3, 2, 2, 2, 595, 589, 3, 2, 2, 2, 595, 596, 3, 2, 2, 2, 596, 122, 3, 2, 2, 2, 597, 598, 7, 100, 2, 2, 598, 599, 7, 123, 2, 2, 599, 600, 7, 118, 2, 2, 600, 601, 7, 103, 2, 2, 601, 602, 7, 117, 2, 2, 602, 604, 3, 2, 2, 2, 603, 605, 5, 125, 63, 2, 604, 603, 3, 2, 2, 2, 604, 605, 3, 2, 2, 2, 605, 611, 3, 2, 2, 2, 606, 607, 7, 100, 2, 2, 607, 608, 7, 123, 2, 2, 608, 609, 7, 118, 2, 2, 609, 611, 7, 103, 2, 2, 610, 597, 3, 2, 2, 2, 610, 606, 3, 2, 2, 2, 611, 124, 3, 2, 2, 2, 612, 616, 9, 5, 2, 2, 613, 615, 9, 2, 2, 2, 614, 613, 3, 2, 2, 2, 615, 618, 3, 2, 2, 2, 616, 614, 3, 2, 2, 2, 616, 617, 3, 2, 2, 2, 617, 126, 3, 2, 2, 2, 618, 616, 3, 2, 2, 2, 619, 625, 7, 36, 2, 2, 620, 621, 7, 94, 2, 2, 621, 624, 7, 36, 2, 2, 622, 624, 10, 6, 2, 2, 623, 620, 3, 2, 2, 2, 623, 622, 3, 2, 2, 2, 624, 627, 3, 2, 2, 2, 625, 626, 3, 2, 2, 2, 625, 623, 3, 2, 2, 2, 626, 628, 3, 2, 2, 2, 627, 625, 3, 2, 2, 2, 628, 640, 7, 36, 2, 2, 629, 635, 7, 41, 2, 2, 630, 631, 7, 94, 2, 2, 631, 634, 7, 41, 2, 2, 632, 634, 10, 7, 2, 2, 633, 630, 3, 2, 2, 2, 633, 632, 3, 2, 2, 2, 634, 637, 3, 2, 2, 2, 635, 636, 3, 2, 2, 2, 635, 633, 3, 2, 2, 2, 636, 638, 3, 2, 2, 2, 637, 635, 3, 2, 2, 2, 638, 640, 7, 41, 2, 2, 639, 619, 3, 2, 2, 2, 639, 629, 3, 2, 2, 2, 640, 128, 3, 2, 2, 2, 641, 642, 7, 102, 2, 2, 642, 643, 7, 99, 2, 2, 643, 644, 7, 118, 2, 2, 644, 645, 7, 103, 2, 2, 645, 646, 7, 42, 2, 2, 646, 647, 3, 2, 2, 2, 647, 648, 5, 127, 64, 2, 648, 649, 7, 43, 2, 2, 649, 130, 3, 2, 2, 2, 650, 651, 7, 50, 2, 2, 651, 655, 9, 8, 2, 2, 652, 654, 9, 9, 2, 2, 653, 652, 3, 2, 2, 2, 654, 657, 3, 2, 2, 2, 655, 653, 3, 2, 2, 2, 655, 656, 3, 2, 2, 2, 656, 132, 3, 2, 2, 2, 657, 655, 3, 2, 2, 2, 658, 659, 7, 118, 2, 2, 659, 660, 7, 122, 2, 2, 660, 661, 7, 48, 2, 2, 661, 662, 7, 99, 2, 2, 662, 663, 7, 105, 2, 2, 663, 672, 7, 103, 2, 2, 664, 665, 7, 118, 2, 2, 665, 666, 7, 122, 2, 2, 666, 667, 7, 48, 2, 2, 667, 668, 7, 118, 2, 2, 668, 669, 7, 107, 2, 2, 669, 670, 7, 111, 2, 2, 670, 672, 7, 103, 2, 2, 671, 658, 3, 2, 2, 2, 671, 664, 3, 2, 2, 2, 672, 134, 3, 2, 2, 2, 673, 674, 7, 118, 2, 2, 674, 675, 7, 106, 2, 2, 675, 676, 7, 107, 2, 2, 676, 677, 7, 117, 2, 2, 677, 678, 7, 48, 2, 2, 678, 679, 7, 99, 2, 2, 679, 680, 7, 101, 2, 2, 680, 681, 7, 118, 2, 2, 681, 682, 7, 107, 2, 2, 682, 683, 7, 120, 2, 2, 683, 684, 7, 103, 2, 2, 684, 685, 7, 75, 2, 2, 685, 686, 7, 112, 2, 2, 686, 687, 7, 114, 2, 2, 687, 688, 7, 119, 2, 2, 688, 689, 7, 118, 2, 2, 689, 690, 7, 75, 2, 2, 690, 691, 7, 112, 2, 2, 691, 692, 7, 102, 2, 2, 692, 693, 7, 103, 2, 2, 693, 768, 7, 122, 2, 2, 694, 695, 7, 118, 2, 2, 695, 696, 7, 106, 2, 2, 696, 697, 7, 107, 2, 2, 697, 698, 7, 117, 2, 2, 698, 699, 7, 48, 2, 2, 699, 700, 7, 99, 2, 2, 700, 701, 7, 101, 2, 2, 701, 702, 7, 118, 2, 2, 702, 703, 7, 107, 2, 2, 703, 704, 7, 120, 2, 2, 704, 705, 7, 103, 2, 2, 705, 706, 7, 68, 2, 2, 706, 707, 7, 123, 2, 2, 707, 708, 7, 118, 2, 2, 708, 709, 7, 103, 2, 2, 709, 710, 7, 101, 2, 2, 710, 711, 7, 113, 2, 2, 711, 712, 7, 102, 2, 2, 712, 768, 7, 103, 2, 2, 713, 714, 7, 118, 2, 2, 714, 715, 7, 122, 2, 2, 715, 716, 7, 48, 2, 2, 716, 717, 7, 107, 2, 2, 717, 718, 7, 112, 2, 2, 718, 719, 7, 114, 2, 2, 719, 720, 7, 119, 2, 2, 720, 721, 7, 118, 2, 2, 721, 722, 7, 117, 2, 2, 722, 723, 7, 48, 2, 2, 723, 724, 7, 110, 2, 2, 724, 725, 7, 103, 2, 2, 725, 726, 7, 112, 2, 2, 726, 727, 7, 105, 2, 2, 727, 728, 7, 118, 2, 2, 728, 768, 7, 106, 2, 2, 729, 730, 7, 118, 2, 2, 730, 731, 7, 122, 2, 2, 731, 732, 7, 48, 2, 2, 732, 733, 7, 113, 2, 2, 733, 734, 7, 119, 2, 2, 734, 735, 7, 118, 2, 2, 735, 736, 7, 114, 2, 2, 736, 737, 7, 119, 2, 2, 737, 738, 7, 118, 2, 2, 738, 739, 7, 117, 2, 2, 739, 740, 7, 48, 2, 2, 740, 741, 7, 110, 2, 2, 741, 742, 7, 103, 2, 2, 742, 743, 7, 112, 2, 2, 743, 744, 7, 105, 2, 2, 744, 745, 7, 118, 2, 2, 745, 768, 7, 106, 2, 2, 746, 747, 7, 118, 2, 2, 747, 748, 7, 122, 2, 2, 748, 749, 7, 48, 2, 2, 749, 750, 7, 120, 2, 2, 750, 751, 7, 103, 2, 2, 751, 752, 7, 116, 2, 2, 752, 753, 7, 117, 2, 2, 753, 754, 7, 107, 2, 2, 754, 755, 7, 113, 2, 2, 755, 768, 7, 112, 2, 2, 756, 757, 7, 118, 2, 2, 757, 758, 7, 122, 2, 2, 758, 759, 7, 48, 2, 2, 759, 760, 7, 110, 2, 2, 760, 761, 7, 113, 2, 2, 761, 762, 7, 101, 2, 2, 762, 763, 7, 109, 2, 2, 763, 764, 7, 118, 2, 2, 764, 765, 7, 107, 2, 2, 765, 766, 7, 111, 2, 2, 766, 768, 7, 103, 2, 2, 767, 673, 3, 2, 2, 2, 767, 694, 3, 2, 2, 2, 767, 713, 3, 2, 2, 2, 767, 729, 3, 2, 2, 2, 767, 746, 3, 2, 2, 2, 767, 756, 3, 2, 2, 2, 768, 136, 3, 2, 2, 2, 769, 773, 9, 10, 2, 2, 770, 772, 9, 11, 2, 2, 771, 770, 3, 2, 2, 2, 772, 775, 3, 2, 2, 2, 773, 771, 3, 2, 2, 2, 773, 774, 3, 2, 2, 2, 774, 138, 3, 2, 2, 2, 775, 773, 3, 2, 2, 2, 776, 778, 9, 12, 2, 2, 777, 776, 3, 2, 2, 2, 778, 779, 3, 2, 2, 2, 779, 777, 3, 2, 2, 2, 779, 780, 3, 2, 2, 2, 780, 781, 3, 2, 2, 2, 781, 782, 8, 70, 2, 2, 782, 140, 3, 2, 2, 2, 783, 784, 7, 49, 2, 2, 784, 785, 7, 44, 2, 2, 785, 789, 3, 2, 2, 2, 786, 788, 11, 2, 2, 2, 787, 786, 3, 2, 2, 2, 788, 791, 3, 2, 2, 2, 789, 790, 3, 2, 2, 2, 789, 787, 3, 2, 2, 2, 790, 792, 3, 2, 2, 2, 791, 789, 3, 2, 2, 2, 792, 793, 7, 44, 2, 2, 793, 794, 7, 49, 2, 2, 794, 795, 3, 2, 2, 2, 795, 796, 8, 71, 3, 2, 796, 142, 3, 2, 2, 2, 797, 798, 7, 49, 2, 2, 798, 799, 7, 49, 2, 2, 799, 803, 3, 2, 2, 2, 800, 802, 10, 13, 2, 2, 801, 800, 3, 2, 2, 2, 802, 805, 3, 2, 2, 2, 803, 801, 3, 2, 2, 2, 803, 804, 3, 2, 2, 2, 804, 806, 3, 2, 2, 2, 805, 803, 3, 2, 2, 2, 806, 807, 8, 72, 3, 2, 807, 144, 3, 2, 2, 2, 27, 2, 497, 503, 509, 520, 579, 582, 587, 593, 595, 604, 610, 616, 623, 625, 633, 635, 639, 655, 671, 767, 773, 779, 789, 803, 4, 8, 2, 2, 2, 3, 2]
\ No newline at end of file
+[4, 0, 71, 806, 6, -1, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 2, 25, 7, 25, 2, 26, 7, 26, 2, 27, 7, 27, 2, 28, 7, 28, 2, 29, 7, 29, 2, 30, 7, 30, 2, 31, 7, 31, 2, 32, 7, 32, 2, 33, 7, 33, 2, 34, 7, 34, 2, 35, 7, 35, 2, 36, 7, 36, 2, 37, 7, 37, 2, 38, 7, 38, 2, 39, 7, 39, 2, 40, 7, 40, 2, 41, 7, 41, 2, 42, 7, 42, 2, 43, 7, 43, 2, 44, 7, 44, 2, 45, 7, 45, 2, 46, 7, 46, 2, 47, 7, 47, 2, 48, 7, 48, 2, 49, 7, 49, 2, 50, 7, 50, 2, 51, 7, 51, 2, 52, 7, 52, 2, 53, 7, 53, 2, 54, 7, 54, 2, 55, 7, 55, 2, 56, 7, 56, 2, 57, 7, 57, 2, 58, 7, 58, 2, 59, 7, 59, 2, 60, 7, 60, 2, 61, 7, 61, 2, 62, 7, 62, 2, 63, 7, 63, 2, 64, 7, 64, 2, 65, 7, 65, 2, 66, 7, 66, 2, 67, 7, 67, 2, 68, 7, 68, 2, 69, 7, 69, 2, 70, 7, 70, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 3, 1, 3, 1, 4, 1, 4, 1, 5, 1, 5, 1, 5, 1, 6, 1, 6, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 11, 1, 11, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 15, 1, 15, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 19, 1, 19, 1, 19, 1, 20, 1, 20, 1, 20, 1, 20, 1, 21, 1, 21, 1, 22, 1, 22, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 37, 1, 37, 1, 38, 1, 38, 1, 39, 1, 39, 1, 40, 1, 40, 1, 41, 1, 41, 1, 42, 1, 42, 1, 43, 1, 43, 1, 43, 1, 44, 1, 44, 1, 44, 1, 45, 1, 45, 1, 46, 1, 46, 1, 47, 1, 47, 1, 47, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49, 1, 49, 1, 49, 1, 49, 1, 49, 1, 49, 1, 49, 1, 49, 1, 50, 1, 50, 1, 50, 1, 50, 1, 51, 1, 51, 1, 51, 1, 51, 1, 51, 1, 52, 1, 52, 1, 52, 1, 52, 1, 52, 1, 52, 1, 52, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 54, 1, 54, 1, 54, 1, 54, 1, 55, 1, 55, 1, 55, 1, 55, 1, 55, 1, 55, 1, 55, 1, 55, 1, 56, 4, 56, 494, 8, 56, 11, 56, 12, 56, 495, 1, 56, 1, 56, 4, 56, 500, 8, 56, 11, 56, 12, 56, 501, 1, 56, 1, 56, 4, 56, 506, 8, 56, 11, 56, 12, 56, 507, 1, 57, 1, 57, 1, 57, 1, 57, 1, 57, 1, 57, 1, 57, 1, 57, 1, 57, 3, 57, 519, 8, 57, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 3, 58, 578, 8, 58, 1, 59, 3, 59, 581, 8, 59, 1, 59, 4, 59, 584, 8, 59, 11, 59, 12, 59, 585, 1, 59, 1, 59, 4, 59, 590, 8, 59, 11, 59, 12, 59, 591, 3, 59, 594, 8, 59, 1, 60, 1, 60, 1, 60, 1, 60, 1, 60, 1, 60, 1, 60, 3, 60, 603, 8, 60, 1, 60, 1, 60, 1, 60, 1, 60, 3, 60, 609, 8, 60, 1, 61, 1, 61, 5, 61, 613, 8, 61, 10, 61, 12, 61, 616, 9, 61, 1, 62, 1, 62, 1, 62, 1, 62, 5, 62, 622, 8, 62, 10, 62, 12, 62, 625, 9, 62, 1, 62, 1, 62, 1, 62, 1, 62, 1, 62, 5, 62, 632, 8, 62, 10, 62, 12, 62, 635, 9, 62, 1, 62, 3, 62, 638, 8, 62, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 64, 1, 64, 1, 64, 5, 64, 652, 8, 64, 10, 64, 12, 64, 655, 9, 64, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 3, 65, 670, 8, 65, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 3, 66, 766, 8, 66, 1, 67, 1, 67, 5, 67, 770, 8, 67, 10, 67, 12, 67, 773, 9, 67, 1, 68, 4, 68, 776, 8, 68, 11, 68, 12, 68, 777, 1, 68, 1, 68, 1, 69, 1, 69, 1, 69, 1, 69, 5, 69, 786, 8, 69, 10, 69, 12, 69, 789, 9, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 70, 1, 70, 1, 70, 1, 70, 5, 70, 800, 8, 70, 10, 70, 12, 70, 803, 9, 70, 1, 70, 1, 70, 3, 623, 633, 787, 0, 71, 1, 1, 3, 2, 5, 3, 7, 4, 9, 5, 11, 6, 13, 7, 15, 8, 17, 9, 19, 10, 21, 11, 23, 12, 25, 13, 27, 14, 29, 15, 31, 16, 33, 17, 35, 18, 37, 19, 39, 20, 41, 21, 43, 22, 45, 23, 47, 24, 49, 25, 51, 26, 53, 27, 55, 28, 57, 29, 59, 30, 61, 31, 63, 32, 65, 33, 67, 34, 69, 35, 71, 36, 73, 37, 75, 38, 77, 39, 79, 40, 81, 41, 83, 42, 85, 43, 87, 44, 89, 45, 91, 46, 93, 47, 95, 48, 97, 49, 99, 50, 101, 51, 103, 52, 105, 53, 107, 54, 109, 55, 111, 56, 113, 57, 115, 58, 117, 59, 119, 60, 121, 61, 123, 62, 125, 63, 127, 64, 129, 65, 131, 66, 133, 67, 135, 68, 137, 69, 139, 70, 141, 71, 1, 0, 12, 1, 0, 48, 57, 1, 0, 45, 45, 2, 0, 69, 69, 101, 101, 1, 0, 49, 57, 3, 0, 10, 10, 13, 13, 34, 34, 3, 0, 10, 10, 13, 13, 39, 39, 2, 0, 88, 88, 120, 120, 3, 0, 48, 57, 65, 70, 97, 102, 2, 0, 65, 90, 97, 122, 4, 0, 48, 57, 65, 90, 95, 95, 97, 122, 3, 0, 9, 10, 12, 13, 32, 32, 2, 0, 10, 10, 13, 13, 841, 0, 1, 1, 0, 0, 0, 0, 3, 1, 0, 0, 0, 0, 5, 1, 0, 0, 0, 0, 7, 1, 0, 0, 0, 0, 9, 1, 0, 0, 0, 0, 11, 1, 0, 0, 0, 0, 13, 1, 0, 0, 0, 0, 15, 1, 0, 0, 0, 0, 17, 1, 0, 0, 0, 0, 19, 1, 0, 0, 0, 0, 21, 1, 0, 0, 0, 0, 23, 1, 0, 0, 0, 0, 25, 1, 0, 0, 0, 0, 27, 1, 0, 0, 0, 0, 29, 1, 0, 0, 0, 0, 31, 1, 0, 0, 0, 0, 33, 1, 0, 0, 0, 0, 35, 1, 0, 0, 0, 0, 37, 1, 0, 0, 0, 0, 39, 1, 0, 0, 0, 0, 41, 1, 0, 0, 0, 0, 43, 1, 0, 0, 0, 0, 45, 1, 0, 0, 0, 0, 47, 1, 0, 0, 0, 0, 49, 1, 0, 0, 0, 0, 51, 1, 0, 0, 0, 0, 53, 1, 0, 0, 0, 0, 55, 1, 0, 0, 0, 0, 57, 1, 0, 0, 0, 0, 59, 1, 0, 0, 0, 0, 61, 1, 0, 0, 0, 0, 63, 1, 0, 0, 0, 0, 65, 1, 0, 0, 0, 0, 67, 1, 0, 0, 0, 0, 69, 1, 0, 0, 0, 0, 71, 1, 0, 0, 0, 0, 73, 1, 0, 0, 0, 0, 75, 1, 0, 0, 0, 0, 77, 1, 0, 0, 0, 0, 79, 1, 0, 0, 0, 0, 81, 1, 0, 0, 0, 0, 83, 1, 0, 0, 0, 0, 85, 1, 0, 0, 0, 0, 87, 1, 0, 0, 0, 0, 89, 1, 0, 0, 0, 0, 91, 1, 0, 0, 0, 0, 93, 1, 0, 0, 0, 0, 95, 1, 0, 0, 0, 0, 97, 1, 0, 0, 0, 0, 99, 1, 0, 0, 0, 0, 101, 1, 0, 0, 0, 0, 103, 1, 0, 0, 0, 0, 105, 1, 0, 0, 0, 0, 107, 1, 0, 0, 0, 0, 109, 1, 0, 0, 0, 0, 111, 1, 0, 0, 0, 0, 113, 1, 0, 0, 0, 0, 115, 1, 0, 0, 0, 0, 117, 1, 0, 0, 0, 0, 119, 1, 0, 0, 0, 0, 121, 1, 0, 0, 0, 0, 123, 1, 0, 0, 0, 0, 125, 1, 0, 0, 0, 0, 127, 1, 0, 0, 0, 0, 129, 1, 0, 0, 0, 0, 131, 1, 0, 0, 0, 0, 133, 1, 0, 0, 0, 0, 135, 1, 0, 0, 0, 0, 137, 1, 0, 0, 0, 0, 139, 1, 0, 0, 0, 0, 141, 1, 0, 0, 0, 1, 143, 1, 0, 0, 0, 3, 150, 1, 0, 0, 0, 5, 152, 1, 0, 0, 0, 7, 163, 1, 0, 0, 0, 9, 165, 1, 0, 0, 0, 11, 167, 1, 0, 0, 0, 13, 170, 1, 0, 0, 0, 15, 172, 1, 0, 0, 0, 17, 174, 1, 0, 0, 0, 19, 177, 1, 0, 0, 0, 21, 179, 1, 0, 0, 0, 23, 188, 1, 0, 0, 0, 25, 190, 1, 0, 0, 0, 27, 192, 1, 0, 0, 0, 29, 201, 1, 0, 0, 0, 31, 203, 1, 0, 0, 0, 33, 205, 1, 0, 0, 0, 35, 207, 1, 0, 0, 0, 37, 215, 1, 0, 0, 0, 39, 218, 1, 0, 0, 0, 41, 223, 1, 0, 0, 0, 43, 227, 1, 0, 0, 0, 45, 229, 1, 0, 0, 0, 47, 231, 1, 0, 0, 0, 49, 242, 1, 0, 0, 0, 51, 249, 1, 0, 0, 0, 53, 266, 1, 0, 0, 0, 55, 281, 1, 0, 0, 0, 57, 296, 1, 0, 0, 0, 59, 309, 1, 0, 0, 0, 61, 319, 1, 0, 0, 0, 63, 344, 1, 0, 0, 0, 65, 359, 1, 0, 0, 0, 67, 378, 1, 0, 0, 0, 69, 394, 1, 0, 0, 0, 71, 405, 1, 0, 0, 0, 73, 413, 1, 0, 0, 0, 75, 420, 1, 0, 0, 0, 77, 422, 1, 0, 0, 0, 79, 424, 1, 0, 0, 0, 81, 426, 1, 0, 0, 0, 83, 428, 1, 0, 0, 0, 85, 430, 1, 0, 0, 0, 87, 432, 1, 0, 0, 0, 89, 435, 1, 0, 0, 0, 91, 438, 1, 0, 0, 0, 93, 440, 1, 0, 0, 0, 95, 442, 1, 0, 0, 0, 97, 445, 1, 0, 0, 0, 99, 448, 1, 0, 0, 0, 101, 457, 1, 0, 0, 0, 103, 461, 1, 0, 0, 0, 105, 466, 1, 0, 0, 0, 107, 473, 1, 0, 0, 0, 109, 480, 1, 0, 0, 0, 111, 484, 1, 0, 0, 0, 113, 493, 1, 0, 0, 0, 115, 518, 1, 0, 0, 0, 117, 577, 1, 0, 0, 0, 119, 580, 1, 0, 0, 0, 121, 608, 1, 0, 0, 0, 123, 610, 1, 0, 0, 0, 125, 637, 1, 0, 0, 0, 127, 639, 1, 0, 0, 0, 129, 648, 1, 0, 0, 0, 131, 669, 1, 0, 0, 0, 133, 765, 1, 0, 0, 0, 135, 767, 1, 0, 0, 0, 137, 775, 1, 0, 0, 0, 139, 781, 1, 0, 0, 0, 141, 795, 1, 0, 0, 0, 143, 144, 5, 112, 0, 0, 144, 145, 5, 114, 0, 0, 145, 146, 5, 97, 0, 0, 146, 147, 5, 103, 0, 0, 147, 148, 5, 109, 0, 0, 148, 149, 5, 97, 0, 0, 149, 2, 1, 0, 0, 0, 150, 151, 5, 59, 0, 0, 151, 4, 1, 0, 0, 0, 152, 153, 5, 99, 0, 0, 153, 154, 5, 97, 0, 0, 154, 155, 5, 115, 0, 0, 155, 156, 5, 104, 0, 0, 156, 157, 5, 115, 0, 0, 157, 158, 5, 99, 0, 0, 158, 159, 5, 114, 0, 0, 159, 160, 5, 105, 0, 0, 160, 161, 5, 112, 0, 0, 161, 162, 5, 116, 0, 0, 162, 6, 1, 0, 0, 0, 163, 164, 5, 94, 0, 0, 164, 8, 1, 0, 0, 0, 165, 166, 5, 126, 0, 0, 166, 10, 1, 0, 0, 0, 167, 168, 5, 62, 0, 0, 168, 169, 5, 61, 0, 0, 169, 12, 1, 0, 0, 0, 170, 171, 5, 62, 0, 0, 171, 14, 1, 0, 0, 0, 172, 173, 5, 60, 0, 0, 173, 16, 1, 0, 0, 0, 174, 175, 5, 60, 0, 0, 175, 176, 5, 61, 0, 0, 176, 18, 1, 0, 0, 0, 177, 178, 5, 61, 0, 0, 178, 20, 1, 0, 0, 0, 179, 180, 5, 99, 0, 0, 180, 181, 5, 111, 0, 0, 181, 182, 5, 110, 0, 0, 182, 183, 5, 116, 0, 0, 183, 184, 5, 114, 0, 0, 184, 185, 5, 97, 0, 0, 185, 186, 5, 99, 0, 0, 186, 187, 5, 116, 0, 0, 187, 22, 1, 0, 0, 0, 188, 189, 5, 123, 0, 0, 189, 24, 1, 0, 0, 0, 190, 191, 5, 125, 0, 0, 191, 26, 1, 0, 0, 0, 192, 193, 5, 102, 0, 0, 193, 194, 5, 117, 0, 0, 194, 195, 5, 110, 0, 0, 195, 196, 5, 99, 0, 0, 196, 197, 5, 116, 0, 0, 197, 198, 5, 105, 0, 0, 198, 199, 5, 111, 0, 0, 199, 200, 5, 110, 0, 0, 200, 28, 1, 0, 0, 0, 201, 202, 5, 40, 0, 0, 202, 30, 1, 0, 0, 0, 203, 204, 5, 44, 0, 0, 204, 32, 1, 0, 0, 0, 205, 206, 5, 41, 0, 0, 206, 34, 1, 0, 0, 0, 207, 208, 5, 114, 0, 0, 208, 209, 5, 101, 0, 0, 209, 210, 5, 113, 0, 0, 210, 211, 5, 117, 0, 0, 211, 212, 5, 105, 0, 0, 212, 213, 5, 114, 0, 0, 213, 214, 5, 101, 0, 0, 214, 36, 1, 0, 0, 0, 215, 216, 5, 105, 0, 0, 216, 217, 5, 102, 0, 0, 217, 38, 1, 0, 0, 0, 218, 219, 5, 101, 0, 0, 219, 220, 5, 108, 0, 0, 220, 221, 5, 115, 0, 0, 221, 222, 5, 101, 0, 0, 222, 40, 1, 0, 0, 0, 223, 224, 5, 110, 0, 0, 224, 225, 5, 101, 0, 0, 225, 226, 5, 119, 0, 0, 226, 42, 1, 0, 0, 0, 227, 228, 5, 91, 0, 0, 228, 44, 1, 0, 0, 0, 229, 230, 5, 93, 0, 0, 230, 46, 1, 0, 0, 0, 231, 232, 5, 116, 0, 0, 232, 233, 5, 120, 0, 0, 233, 234, 5, 46, 0, 0, 234, 235, 5, 111, 0, 0, 235, 236, 5, 117, 0, 0, 236, 237, 5, 116, 0, 0, 237, 238, 5, 112, 0, 0, 238, 239, 5, 117, 0, 0, 239, 240, 5, 116, 0, 0, 240, 241, 5, 115, 0, 0, 241, 48, 1, 0, 0, 0, 242, 243, 5, 46, 0, 0, 243, 244, 5, 118, 0, 0, 244, 245, 5, 97, 0, 0, 245, 246, 5, 108, 0, 0, 246, 247, 5, 117, 0, 0, 247, 248, 5, 101, 0, 0, 248, 50, 1, 0, 0, 0, 249, 250, 5, 46, 0, 0, 250, 251, 5, 108, 0, 0, 251, 252, 5, 111, 0, 0, 252, 253, 5, 99, 0, 0, 253, 254, 5, 107, 0, 0, 254, 255, 5, 105, 0, 0, 255, 256, 5, 110, 0, 0, 256, 257, 5, 103, 0, 0, 257, 258, 5, 66, 0, 0, 258, 259, 5, 121, 0, 0, 259, 260, 5, 116, 0, 0, 260, 261, 5, 101, 0, 0, 261, 262, 5, 99, 0, 0, 262, 263, 5, 111, 0, 0, 263, 264, 5, 100, 0, 0, 264, 265, 5, 101, 0, 0, 265, 52, 1, 0, 0, 0, 266, 267, 5, 46, 0, 0, 267, 268, 5, 116, 0, 0, 268, 269, 5, 111, 0, 0, 269, 270, 5, 107, 0, 0, 270, 271, 5, 101, 0, 0, 271, 272, 5, 110, 0, 0, 272, 273, 5, 67, 0, 0, 273, 274, 5, 97, 0, 0, 274, 275, 5, 116, 0, 0, 275, 276, 5, 101, 0, 0, 276, 277, 5, 103, 0, 0, 277, 278, 5, 111, 0, 0, 278, 279, 5, 114, 0, 0, 279, 280, 5, 121, 0, 0, 280, 54, 1, 0, 0, 0, 281, 282, 5, 46, 0, 0, 282, 283, 5, 110, 0, 0, 283, 284, 5, 102, 0, 0, 284, 285, 5, 116, 0, 0, 285, 286, 5, 67, 0, 0, 286, 287, 5, 111, 0, 0, 287, 288, 5, 109, 0, 0, 288, 289, 5, 109, 0, 0, 289, 290, 5, 105, 0, 0, 290, 291, 5, 116, 0, 0, 291, 292, 5, 109, 0, 0, 292, 293, 5, 101, 0, 0, 293, 294, 5, 110, 0, 0, 294, 295, 5, 116, 0, 0, 295, 56, 1, 0, 0, 0, 296, 297, 5, 46, 0, 0, 297, 298, 5, 116, 0, 0, 298, 299, 5, 111, 0, 0, 299, 300, 5, 107, 0, 0, 300, 301, 5, 101, 0, 0, 301, 302, 5, 110, 0, 0, 302, 303, 5, 65, 0, 0, 303, 304, 5, 109, 0, 0, 304, 305, 5, 111, 0, 0, 305, 306, 5, 117, 0, 0, 306, 307, 5, 110, 0, 0, 307, 308, 5, 116, 0, 0, 308, 58, 1, 0, 0, 0, 309, 310, 5, 116, 0, 0, 310, 311, 5, 120, 0, 0, 311, 312, 5, 46, 0, 0, 312, 313, 5, 105, 0, 0, 313, 314, 5, 110, 0, 0, 314, 315, 5, 112, 0, 0, 315, 316, 5, 117, 0, 0, 316, 317, 5, 116, 0, 0, 317, 318, 5, 115, 0, 0, 318, 60, 1, 0, 0, 0, 319, 320, 5, 46, 0, 0, 320, 321, 5, 111, 0, 0, 321, 322, 5, 117, 0, 0, 322, 323, 5, 116, 0, 0, 323, 324, 5, 112, 0, 0, 324, 325, 5, 111, 0, 0, 325, 326, 5, 105, 0, 0, 326, 327, 5, 110, 0, 0, 327, 328, 5, 116, 0, 0, 328, 329, 5, 84, 0, 0, 329, 330, 5, 114, 0, 0, 330, 331, 5, 97, 0, 0, 331, 332, 5, 110, 0, 0, 332, 333, 5, 115, 0, 0, 333, 334, 5, 97, 0, 0, 334, 335, 5, 99, 0, 0, 335, 336, 5, 116, 0, 0, 336, 337, 5, 105, 0, 0, 337, 338, 5, 111, 0, 0, 338, 339, 5, 110, 0, 0, 339, 340, 5, 72, 0, 0, 340, 341, 5, 97, 0, 0, 341, 342, 5, 115, 0, 0, 342, 343, 5, 104, 0, 0, 343, 62, 1, 0, 0, 0, 344, 345, 5, 46, 0, 0, 345, 346, 5, 111, 0, 0, 346, 347, 5, 117, 0, 0, 347, 348, 5, 116, 0, 0, 348, 349, 5, 112, 0, 0, 349, 350, 5, 111, 0, 0, 350, 351, 5, 105, 0, 0, 351, 352, 5, 110, 0, 0, 352, 353, 5, 116, 0, 0, 353, 354, 5, 73, 0, 0, 354, 355, 5, 110, 0, 0, 355, 356, 5, 100, 0, 0, 356, 357, 5, 101, 0, 0, 357, 358, 5, 120, 0, 0, 358, 64, 1, 0, 0, 0, 359, 360, 5, 46, 0, 0, 360, 361, 5, 117, 0, 0, 361, 362, 5, 110, 0, 0, 362, 363, 5, 108, 0, 0, 363, 364, 5, 111, 0, 0, 364, 365, 5, 99, 0, 0, 365, 366, 5, 107, 0, 0, 366, 367, 5, 105, 0, 0, 367, 368, 5, 110, 0, 0, 368, 369, 5, 103, 0, 0, 369, 370, 5, 66, 0, 0, 370, 371, 5, 121, 0, 0, 371, 372, 5, 116, 0, 0, 372, 373, 5, 101, 0, 0, 373, 374, 5, 99, 0, 0, 374, 375, 5, 111, 0, 0, 375, 376, 5, 100, 0, 0, 376, 377, 5, 101, 0, 0, 377, 66, 1, 0, 0, 0, 378, 379, 5, 46, 0, 0, 379, 380, 5, 115, 0, 0, 380, 381, 5, 101, 0, 0, 381, 382, 5, 113, 0, 0, 382, 383, 5, 117, 0, 0, 383, 384, 5, 101, 0, 0, 384, 385, 5, 110, 0, 0, 385, 386, 5, 99, 0, 0, 386, 387, 5, 101, 0, 0, 387, 388, 5, 78, 0, 0, 388, 389, 5, 117, 0, 0, 389, 390, 5, 109, 0, 0, 390, 391, 5, 98, 0, 0, 391, 392, 5, 101, 0, 0, 392, 393, 5, 114, 0, 0, 393, 68, 1, 0, 0, 0, 394, 395, 5, 46, 0, 0, 395, 396, 5, 114, 0, 0, 396, 397, 5, 101, 0, 0, 397, 398, 5, 118, 0, 0, 398, 399, 5, 101, 0, 0, 399, 400, 5, 114, 0, 0, 400, 401, 5, 115, 0, 0, 401, 402, 5, 101, 0, 0, 402, 403, 5, 40, 0, 0, 403, 404, 5, 41, 0, 0, 404, 70, 1, 0, 0, 0, 405, 406, 5, 46, 0, 0, 406, 407, 5, 108, 0, 0, 407, 408, 5, 101, 0, 0, 408, 409, 5, 110, 0, 0, 409, 410, 5, 103, 0, 0, 410, 411, 5, 116, 0, 0, 411, 412, 5, 104, 0, 0, 412, 72, 1, 0, 0, 0, 413, 414, 5, 46, 0, 0, 414, 415, 5, 115, 0, 0, 415, 416, 5, 112, 0, 0, 416, 417, 5, 108, 0, 0, 417, 418, 5, 105, 0, 0, 418, 419, 5, 116, 0, 0, 419, 74, 1, 0, 0, 0, 420, 421, 5, 33, 0, 0, 421, 76, 1, 0, 0, 0, 422, 423, 5, 45, 0, 0, 423, 78, 1, 0, 0, 0, 424, 425, 5, 42, 0, 0, 425, 80, 1, 0, 0, 0, 426, 427, 5, 47, 0, 0, 427, 82, 1, 0, 0, 0, 428, 429, 5, 37, 0, 0, 429, 84, 1, 0, 0, 0, 430, 431, 5, 43, 0, 0, 431, 86, 1, 0, 0, 0, 432, 433, 5, 61, 0, 0, 433, 434, 5, 61, 0, 0, 434, 88, 1, 0, 0, 0, 435, 436, 5, 33, 0, 0, 436, 437, 5, 61, 0, 0, 437, 90, 1, 0, 0, 0, 438, 439, 5, 38, 0, 0, 439, 92, 1, 0, 0, 0, 440, 441, 5, 124, 0, 0, 441, 94, 1, 0, 0, 0, 442, 443, 5, 38, 0, 0, 443, 444, 5, 38, 0, 0, 444, 96, 1, 0, 0, 0, 445, 446, 5, 124, 0, 0, 446, 447, 5, 124, 0, 0, 447, 98, 1, 0, 0, 0, 448, 449, 5, 99, 0, 0, 449, 450, 5, 111, 0, 0, 450, 451, 5, 110, 0, 0, 451, 452, 5, 115, 0, 0, 452, 453, 5, 116, 0, 0, 453, 454, 5, 97, 0, 0, 454, 455, 5, 110, 0, 0, 455, 456, 5, 116, 0, 0, 456, 100, 1, 0, 0, 0, 457, 458, 5, 105, 0, 0, 458, 459, 5, 110, 0, 0, 459, 460, 5, 116, 0, 0, 460, 102, 1, 0, 0, 0, 461, 462, 5, 98, 0, 0, 462, 463, 5, 111, 0, 0, 463, 464, 5, 111, 0, 0, 464, 465, 5, 108, 0, 0, 465, 104, 1, 0, 0, 0, 466, 467, 5, 115, 0, 0, 467, 468, 5, 116, 0, 0, 468, 469, 5, 114, 0, 0, 469, 470, 5, 105, 0, 0, 470, 471, 5, 110, 0, 0, 471, 472, 5, 103, 0, 0, 472, 106, 1, 0, 0, 0, 473, 474, 5, 112, 0, 0, 474, 475, 5, 117, 0, 0, 475, 476, 5, 98, 0, 0, 476, 477, 5, 107, 0, 0, 477, 478, 5, 101, 0, 0, 478, 479, 5, 121, 0, 0, 479, 108, 1, 0, 0, 0, 480, 481, 5, 115, 0, 0, 481, 482, 5, 105, 0, 0, 482, 483, 5, 103, 0, 0, 483, 110, 1, 0, 0, 0, 484, 485, 5, 100, 0, 0, 485, 486, 5, 97, 0, 0, 486, 487, 5, 116, 0, 0, 487, 488, 5, 97, 0, 0, 488, 489, 5, 115, 0, 0, 489, 490, 5, 105, 0, 0, 490, 491, 5, 103, 0, 0, 491, 112, 1, 0, 0, 0, 492, 494, 7, 0, 0, 0, 493, 492, 1, 0, 0, 0, 494, 495, 1, 0, 0, 0, 495, 493, 1, 0, 0, 0, 495, 496, 1, 0, 0, 0, 496, 497, 1, 0, 0, 0, 497, 499, 5, 46, 0, 0, 498, 500, 7, 0, 0, 0, 499, 498, 1, 0, 0, 0, 500, 501, 1, 0, 0, 0, 501, 499, 1, 0, 0, 0, 501, 502, 1, 0, 0, 0, 502, 503, 1, 0, 0, 0, 503, 505, 5, 46, 0, 0, 504, 506, 7, 0, 0, 0, 505, 504, 1, 0, 0, 0, 506, 507, 1, 0, 0, 0, 507, 505, 1, 0, 0, 0, 507, 508, 1, 0, 0, 0, 508, 114, 1, 0, 0, 0, 509, 510, 5, 116, 0, 0, 510, 511, 5, 114, 0, 0, 511, 512, 5, 117, 0, 0, 512, 519, 5, 101, 0, 0, 513, 514, 5, 102, 0, 0, 514, 515, 5, 97, 0, 0, 515, 516, 5, 108, 0, 0, 516, 517, 5, 115, 0, 0, 517, 519, 5, 101, 0, 0, 518, 509, 1, 0, 0, 0, 518, 513, 1, 0, 0, 0, 519, 116, 1, 0, 0, 0, 520, 521, 5, 115, 0, 0, 521, 522, 5, 97, 0, 0, 522, 523, 5, 116, 0, 0, 523, 524, 5, 111, 0, 0, 524, 525, 5, 115, 0, 0, 525, 526, 5, 104, 0, 0, 526, 527, 5, 105, 0, 0, 527, 578, 5, 115, 0, 0, 528, 529, 5, 115, 0, 0, 529, 530, 5, 97, 0, 0, 530, 531, 5, 116, 0, 0, 531, 578, 5, 115, 0, 0, 532, 533, 5, 102, 0, 0, 533, 534, 5, 105, 0, 0, 534, 535, 5, 110, 0, 0, 535, 536, 5, 110, 0, 0, 536, 537, 5, 101, 0, 0, 537, 578, 5, 121, 0, 0, 538, 539, 5, 98, 0, 0, 539, 540, 5, 105, 0, 0, 540, 541, 5, 116, 0, 0, 541, 578, 5, 115, 0, 0, 542, 543, 5, 98, 0, 0, 543, 544, 5, 105, 0, 0, 544, 545, 5, 116, 0, 0, 545, 546, 5, 99, 0, 0, 546, 547, 5, 111, 0, 0, 547, 548, 5, 105, 0, 0, 548, 578, 5, 110, 0, 0, 549, 550, 5, 115, 0, 0, 550, 551, 5, 101, 0, 0, 551, 552, 5, 99, 0, 0, 552, 553, 5, 111, 0, 0, 553, 554, 5, 110, 0, 0, 554, 555, 5, 100, 0, 0, 555, 578, 5, 115, 0, 0, 556, 557, 5, 109, 0, 0, 557, 558, 5, 105, 0, 0, 558, 559, 5, 110, 0, 0, 559, 560, 5, 117, 0, 0, 560, 561, 5, 116, 0, 0, 561, 562, 5, 101, 0, 0, 562, 578, 5, 115, 0, 0, 563, 564, 5, 104, 0, 0, 564, 565, 5, 111, 0, 0, 565, 566, 5, 117, 0, 0, 566, 567, 5, 114, 0, 0, 567, 578, 5, 115, 0, 0, 568, 569, 5, 100, 0, 0, 569, 570, 5, 97, 0, 0, 570, 571, 5, 121, 0, 0, 571, 578, 5, 115, 0, 0, 572, 573, 5, 119, 0, 0, 573, 574, 5, 101, 0, 0, 574, 575, 5, 101, 0, 0, 575, 576, 5, 107, 0, 0, 576, 578, 5, 115, 0, 0, 577, 520, 1, 0, 0, 0, 577, 528, 1, 0, 0, 0, 577, 532, 1, 0, 0, 0, 577, 538, 1, 0, 0, 0, 577, 542, 1, 0, 0, 0, 577, 549, 1, 0, 0, 0, 577, 556, 1, 0, 0, 0, 577, 563, 1, 0, 0, 0, 577, 568, 1, 0, 0, 0, 577, 572, 1, 0, 0, 0, 578, 118, 1, 0, 0, 0, 579, 581, 7, 1, 0, 0, 580, 579, 1, 0, 0, 0, 580, 581, 1, 0, 0, 0, 581, 583, 1, 0, 0, 0, 582, 584, 7, 0, 0, 0, 583, 582, 1, 0, 0, 0, 584, 585, 1, 0, 0, 0, 585, 583, 1, 0, 0, 0, 585, 586, 1, 0, 0, 0, 586, 593, 1, 0, 0, 0, 587, 589, 7, 2, 0, 0, 588, 590, 7, 0, 0, 0, 589, 588, 1, 0, 0, 0, 590, 591, 1, 0, 0, 0, 591, 589, 1, 0, 0, 0, 591, 592, 1, 0, 0, 0, 592, 594, 1, 0, 0, 0, 593, 587, 1, 0, 0, 0, 593, 594, 1, 0, 0, 0, 594, 120, 1, 0, 0, 0, 595, 596, 5, 98, 0, 0, 596, 597, 5, 121, 0, 0, 597, 598, 5, 116, 0, 0, 598, 599, 5, 101, 0, 0, 599, 600, 5, 115, 0, 0, 600, 602, 1, 0, 0, 0, 601, 603, 3, 123, 61, 0, 602, 601, 1, 0, 0, 0, 602, 603, 1, 0, 0, 0, 603, 609, 1, 0, 0, 0, 604, 605, 5, 98, 0, 0, 605, 606, 5, 121, 0, 0, 606, 607, 5, 116, 0, 0, 607, 609, 5, 101, 0, 0, 608, 595, 1, 0, 0, 0, 608, 604, 1, 0, 0, 0, 609, 122, 1, 0, 0, 0, 610, 614, 7, 3, 0, 0, 611, 613, 7, 0, 0, 0, 612, 611, 1, 0, 0, 0, 613, 616, 1, 0, 0, 0, 614, 612, 1, 0, 0, 0, 614, 615, 1, 0, 0, 0, 615, 124, 1, 0, 0, 0, 616, 614, 1, 0, 0, 0, 617, 623, 5, 34, 0, 0, 618, 619, 5, 92, 0, 0, 619, 622, 5, 34, 0, 0, 620, 622, 8, 4, 0, 0, 621, 618, 1, 0, 0, 0, 621, 620, 1, 0, 0, 0, 622, 625, 1, 0, 0, 0, 623, 624, 1, 0, 0, 0, 623, 621, 1, 0, 0, 0, 624, 626, 1, 0, 0, 0, 625, 623, 1, 0, 0, 0, 626, 638, 5, 34, 0, 0, 627, 633, 5, 39, 0, 0, 628, 629, 5, 92, 0, 0, 629, 632, 5, 39, 0, 0, 630, 632, 8, 5, 0, 0, 631, 628, 1, 0, 0, 0, 631, 630, 1, 0, 0, 0, 632, 635, 1, 0, 0, 0, 633, 634, 1, 0, 0, 0, 633, 631, 1, 0, 0, 0, 634, 636, 1, 0, 0, 0, 635, 633, 1, 0, 0, 0, 636, 638, 5, 39, 0, 0, 637, 617, 1, 0, 0, 0, 637, 627, 1, 0, 0, 0, 638, 126, 1, 0, 0, 0, 639, 640, 5, 100, 0, 0, 640, 641, 5, 97, 0, 0, 641, 642, 5, 116, 0, 0, 642, 643, 5, 101, 0, 0, 643, 644, 5, 40, 0, 0, 644, 645, 1, 0, 0, 0, 645, 646, 3, 125, 62, 0, 646, 647, 5, 41, 0, 0, 647, 128, 1, 0, 0, 0, 648, 649, 5, 48, 0, 0, 649, 653, 7, 6, 0, 0, 650, 652, 7, 7, 0, 0, 651, 650, 1, 0, 0, 0, 652, 655, 1, 0, 0, 0, 653, 651, 1, 0, 0, 0, 653, 654, 1, 0, 0, 0, 654, 130, 1, 0, 0, 0, 655, 653, 1, 0, 0, 0, 656, 657, 5, 116, 0, 0, 657, 658, 5, 120, 0, 0, 658, 659, 5, 46, 0, 0, 659, 660, 5, 97, 0, 0, 660, 661, 5, 103, 0, 0, 661, 670, 5, 101, 0, 0, 662, 663, 5, 116, 0, 0, 663, 664, 5, 120, 0, 0, 664, 665, 5, 46, 0, 0, 665, 666, 5, 116, 0, 0, 666, 667, 5, 105, 0, 0, 667, 668, 5, 109, 0, 0, 668, 670, 5, 101, 0, 0, 669, 656, 1, 0, 0, 0, 669, 662, 1, 0, 0, 0, 670, 132, 1, 0, 0, 0, 671, 672, 5, 116, 0, 0, 672, 673, 5, 104, 0, 0, 673, 674, 5, 105, 0, 0, 674, 675, 5, 115, 0, 0, 675, 676, 5, 46, 0, 0, 676, 677, 5, 97, 0, 0, 677, 678, 5, 99, 0, 0, 678, 679, 5, 116, 0, 0, 679, 680, 5, 105, 0, 0, 680, 681, 5, 118, 0, 0, 681, 682, 5, 101, 0, 0, 682, 683, 5, 73, 0, 0, 683, 684, 5, 110, 0, 0, 684, 685, 5, 112, 0, 0, 685, 686, 5, 117, 0, 0, 686, 687, 5, 116, 0, 0, 687, 688, 5, 73, 0, 0, 688, 689, 5, 110, 0, 0, 689, 690, 5, 100, 0, 0, 690, 691, 5, 101, 0, 0, 691, 766, 5, 120, 0, 0, 692, 693, 5, 116, 0, 0, 693, 694, 5, 104, 0, 0, 694, 695, 5, 105, 0, 0, 695, 696, 5, 115, 0, 0, 696, 697, 5, 46, 0, 0, 697, 698, 5, 97, 0, 0, 698, 699, 5, 99, 0, 0, 699, 700, 5, 116, 0, 0, 700, 701, 5, 105, 0, 0, 701, 702, 5, 118, 0, 0, 702, 703, 5, 101, 0, 0, 703, 704, 5, 66, 0, 0, 704, 705, 5, 121, 0, 0, 705, 706, 5, 116, 0, 0, 706, 707, 5, 101, 0, 0, 707, 708, 5, 99, 0, 0, 708, 709, 5, 111, 0, 0, 709, 710, 5, 100, 0, 0, 710, 766, 5, 101, 0, 0, 711, 712, 5, 116, 0, 0, 712, 713, 5, 120, 0, 0, 713, 714, 5, 46, 0, 0, 714, 715, 5, 105, 0, 0, 715, 716, 5, 110, 0, 0, 716, 717, 5, 112, 0, 0, 717, 718, 5, 117, 0, 0, 718, 719, 5, 116, 0, 0, 719, 720, 5, 115, 0, 0, 720, 721, 5, 46, 0, 0, 721, 722, 5, 108, 0, 0, 722, 723, 5, 101, 0, 0, 723, 724, 5, 110, 0, 0, 724, 725, 5, 103, 0, 0, 725, 726, 5, 116, 0, 0, 726, 766, 5, 104, 0, 0, 727, 728, 5, 116, 0, 0, 728, 729, 5, 120, 0, 0, 729, 730, 5, 46, 0, 0, 730, 731, 5, 111, 0, 0, 731, 732, 5, 117, 0, 0, 732, 733, 5, 116, 0, 0, 733, 734, 5, 112, 0, 0, 734, 735, 5, 117, 0, 0, 735, 736, 5, 116, 0, 0, 736, 737, 5, 115, 0, 0, 737, 738, 5, 46, 0, 0, 738, 739, 5, 108, 0, 0, 739, 740, 5, 101, 0, 0, 740, 741, 5, 110, 0, 0, 741, 742, 5, 103, 0, 0, 742, 743, 5, 116, 0, 0, 743, 766, 5, 104, 0, 0, 744, 745, 5, 116, 0, 0, 745, 746, 5, 120, 0, 0, 746, 747, 5, 46, 0, 0, 747, 748, 5, 118, 0, 0, 748, 749, 5, 101, 0, 0, 749, 750, 5, 114, 0, 0, 750, 751, 5, 115, 0, 0, 751, 752, 5, 105, 0, 0, 752, 753, 5, 111, 0, 0, 753, 766, 5, 110, 0, 0, 754, 755, 5, 116, 0, 0, 755, 756, 5, 120, 0, 0, 756, 757, 5, 46, 0, 0, 757, 758, 5, 108, 0, 0, 758, 759, 5, 111, 0, 0, 759, 760, 5, 99, 0, 0, 760, 761, 5, 107, 0, 0, 761, 762, 5, 116, 0, 0, 762, 763, 5, 105, 0, 0, 763, 764, 5, 109, 0, 0, 764, 766, 5, 101, 0, 0, 765, 671, 1, 0, 0, 0, 765, 692, 1, 0, 0, 0, 765, 711, 1, 0, 0, 0, 765, 727, 1, 0, 0, 0, 765, 744, 1, 0, 0, 0, 765, 754, 1, 0, 0, 0, 766, 134, 1, 0, 0, 0, 767, 771, 7, 8, 0, 0, 768, 770, 7, 9, 0, 0, 769, 768, 1, 0, 0, 0, 770, 773, 1, 0, 0, 0, 771, 769, 1, 0, 0, 0, 771, 772, 1, 0, 0, 0, 772, 136, 1, 0, 0, 0, 773, 771, 1, 0, 0, 0, 774, 776, 7, 10, 0, 0, 775, 774, 1, 0, 0, 0, 776, 777, 1, 0, 0, 0, 777, 775, 1, 0, 0, 0, 777, 778, 1, 0, 0, 0, 778, 779, 1, 0, 0, 0, 779, 780, 6, 68, 0, 0, 780, 138, 1, 0, 0, 0, 781, 782, 5, 47, 0, 0, 782, 783, 5, 42, 0, 0, 783, 787, 1, 0, 0, 0, 784, 786, 9, 0, 0, 0, 785, 784, 1, 0, 0, 0, 786, 789, 1, 0, 0, 0, 787, 788, 1, 0, 0, 0, 787, 785, 1, 0, 0, 0, 788, 790, 1, 0, 0, 0, 789, 787, 1, 0, 0, 0, 790, 791, 5, 42, 0, 0, 791, 792, 5, 47, 0, 0, 792, 793, 1, 0, 0, 0, 793, 794, 6, 69, 1, 0, 794, 140, 1, 0, 0, 0, 795, 796, 5, 47, 0, 0, 796, 797, 5, 47, 0, 0, 797, 801, 1, 0, 0, 0, 798, 800, 8, 11, 0, 0, 799, 798, 1, 0, 0, 0, 800, 803, 1, 0, 0, 0, 801, 799, 1, 0, 0, 0, 801, 802, 1, 0, 0, 0, 802, 804, 1, 0, 0, 0, 803, 801, 1, 0, 0, 0, 804, 805, 6, 70, 1, 0, 805, 142, 1, 0, 0, 0, 25, 0, 495, 501, 507, 518, 577, 580, 585, 591, 593, 602, 608, 614, 621, 623, 631, 633, 637, 653, 669, 765, 771, 777, 787, 801, 2, 6, 0, 0, 0, 1, 0]
\ No newline at end of file
diff --git a/packages/cashc/src/grammar/CashScriptLexer.ts b/packages/cashc/src/grammar/CashScriptLexer.ts
index 43c82253..5fc6f298 100644
--- a/packages/cashc/src/grammar/CashScriptLexer.ts
+++ b/packages/cashc/src/grammar/CashScriptLexer.ts
@@ -1,21 +1,17 @@
-// Generated from src/grammar/CashScript.g4 by ANTLR 4.9.0-SNAPSHOT
-
-
-import { ATN } from "antlr4ts/atn/ATN.js";
-import { ATNDeserializer } from "antlr4ts/atn/ATNDeserializer.js";
-import { CharStream } from "antlr4ts/CharStream.js";
-import { Lexer } from "antlr4ts/Lexer.js";
-import { LexerATNSimulator } from "antlr4ts/atn/LexerATNSimulator.js";
-import { NotNull } from "antlr4ts/Decorators.js";
-import { Override } from "antlr4ts/Decorators.js";
-import { RuleContext } from "antlr4ts/RuleContext.js";
-import { Vocabulary } from "antlr4ts/Vocabulary.js";
-import { VocabularyImpl } from "antlr4ts/VocabularyImpl.js";
-
-import * as Utils from "antlr4ts/misc/Utils.js";
-
-
-export class CashScriptLexer extends Lexer {
+// Generated from src/grammar/CashScript.g4 by ANTLR 4.13.1
+// noinspection ES6UnusedImports,JSUnusedGlobalSymbols,JSUnusedLocalSymbols
+import {
+	ATN,
+	ATNDeserializer,
+	CharStream,
+	DecisionState, DFA,
+	Lexer,
+	LexerATNSimulator,
+	RuleContext,
+	PredictionContextCache,
+	Token
+} from "antlr4";
+export default class CashScriptLexer extends Lexer {
 	public static readonly T__0 = 1;
 	public static readonly T__1 = 2;
 	public static readonly T__2 = 3;
@@ -87,16 +83,88 @@ export class CashScriptLexer extends Lexer {
 	public static readonly WHITESPACE = 69;
 	public static readonly COMMENT = 70;
 	public static readonly LINE_COMMENT = 71;
+	public static readonly EOF = Token.EOF;
 
-	// tslint:disable:no-trailing-whitespace
-	public static readonly channelNames: string[] = [
-		"DEFAULT_TOKEN_CHANNEL", "HIDDEN",
-	];
-
-	// tslint:disable:no-trailing-whitespace
-	public static readonly modeNames: string[] = [
-		"DEFAULT_MODE",
-	];
+	public static readonly channelNames: string[] = [ "DEFAULT_TOKEN_CHANNEL", "HIDDEN" ];
+	public static readonly literalNames: (string | null)[] = [ null, "'pragma'", 
+                                                            "';'", "'cashscript'", 
+                                                            "'^'", "'~'", 
+                                                            "'>='", "'>'", 
+                                                            "'<'", "'<='", 
+                                                            "'='", "'contract'", 
+                                                            "'{'", "'}'", 
+                                                            "'function'", 
+                                                            "'('", "','", 
+                                                            "')'", "'require'", 
+                                                            "'if'", "'else'", 
+                                                            "'new'", "'['", 
+                                                            "']'", "'tx.outputs'", 
+                                                            "'.value'", 
+                                                            "'.lockingBytecode'", 
+                                                            "'.tokenCategory'", 
+                                                            "'.nftCommitment'", 
+                                                            "'.tokenAmount'", 
+                                                            "'tx.inputs'", 
+                                                            "'.outpointTransactionHash'", 
+                                                            "'.outpointIndex'", 
+                                                            "'.unlockingBytecode'", 
+                                                            "'.sequenceNumber'", 
+                                                            "'.reverse()'", 
+                                                            "'.length'", 
+                                                            "'.split'", 
+                                                            "'!'", "'-'", 
+                                                            "'*'", "'/'", 
+                                                            "'%'", "'+'", 
+                                                            "'=='", "'!='", 
+                                                            "'&'", "'|'", 
+                                                            "'&&'", "'||'", 
+                                                            "'constant'", 
+                                                            "'int'", "'bool'", 
+                                                            "'string'", 
+                                                            "'pubkey'", 
+                                                            "'sig'", "'datasig'" ];
+	public static readonly symbolicNames: (string | null)[] = [ null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, "VersionLiteral", 
+                                                             "BooleanLiteral", 
+                                                             "NumberUnit", 
+                                                             "NumberLiteral", 
+                                                             "Bytes", "Bound", 
+                                                             "StringLiteral", 
+                                                             "DateLiteral", 
+                                                             "HexLiteral", 
+                                                             "TxVar", "NullaryOp", 
+                                                             "Identifier", 
+                                                             "WHITESPACE", 
+                                                             "COMMENT", 
+                                                             "LINE_COMMENT" ];
+	public static readonly modeNames: string[] = [ "DEFAULT_MODE", ];
 
 	public static readonly ruleNames: string[] = [
 		"T__0", "T__1", "T__2", "T__3", "T__4", "T__5", "T__6", "T__7", "T__8", 
@@ -111,452 +179,299 @@ export class CashScriptLexer extends Lexer {
 		"COMMENT", "LINE_COMMENT",
 	];
 
-	private static readonly _LITERAL_NAMES: Array<string | undefined> = [
-		undefined, "'pragma'", "';'", "'cashscript'", "'^'", "'~'", "'>='", "'>'", 
-		"'<'", "'<='", "'='", "'contract'", "'{'", "'}'", "'function'", "'('", 
-		"','", "')'", "'require'", "'if'", "'else'", "'new'", "'['", "']'", "'tx.outputs'", 
-		"'.value'", "'.lockingBytecode'", "'.tokenCategory'", "'.nftCommitment'", 
-		"'.tokenAmount'", "'tx.inputs'", "'.outpointTransactionHash'", "'.outpointIndex'", 
-		"'.unlockingBytecode'", "'.sequenceNumber'", "'.reverse()'", "'.length'", 
-		"'.split'", "'!'", "'-'", "'*'", "'/'", "'%'", "'+'", "'=='", "'!='", 
-		"'&'", "'|'", "'&&'", "'||'", "'constant'", "'int'", "'bool'", "'string'", 
-		"'pubkey'", "'sig'", "'datasig'",
-	];
-	private static readonly _SYMBOLIC_NAMES: Array<string | undefined> = [
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, "VersionLiteral", "BooleanLiteral", "NumberUnit", "NumberLiteral", 
-		"Bytes", "Bound", "StringLiteral", "DateLiteral", "HexLiteral", "TxVar", 
-		"NullaryOp", "Identifier", "WHITESPACE", "COMMENT", "LINE_COMMENT",
-	];
-	public static readonly VOCABULARY: Vocabulary = new VocabularyImpl(CashScriptLexer._LITERAL_NAMES, CashScriptLexer._SYMBOLIC_NAMES, []);
-
-	// @Override
-	// @NotNull
-	public get vocabulary(): Vocabulary {
-		return CashScriptLexer.VOCABULARY;
-	}
-	// tslint:enable:no-trailing-whitespace
-
 
 	constructor(input: CharStream) {
 		super(input);
-		this._interp = new LexerATNSimulator(CashScriptLexer._ATN, this);
+		this._interp = new LexerATNSimulator(this, CashScriptLexer._ATN, CashScriptLexer.DecisionsToDFA, new PredictionContextCache());
 	}
 
-	// @Override
 	public get grammarFileName(): string { return "CashScript.g4"; }
 
-	// @Override
+	public get literalNames(): (string | null)[] { return CashScriptLexer.literalNames; }
+	public get symbolicNames(): (string | null)[] { return CashScriptLexer.symbolicNames; }
 	public get ruleNames(): string[] { return CashScriptLexer.ruleNames; }
 
-	// @Override
-	public get serializedATN(): string { return CashScriptLexer._serializedATN; }
+	public get serializedATN(): number[] { return CashScriptLexer._serializedATN; }
 
-	// @Override
 	public get channelNames(): string[] { return CashScriptLexer.channelNames; }
 
-	// @Override
 	public get modeNames(): string[] { return CashScriptLexer.modeNames; }
 
-	private static readonly _serializedATNSegments: number = 2;
-	private static readonly _serializedATNSegment0: string =
-		"\x03\uC91D\uCABA\u058D\uAFBA\u4F53\u0607\uEA8B\uC241\x02I\u0328\b\x01" +
-		"\x04\x02\t\x02\x04\x03\t\x03\x04\x04\t\x04\x04\x05\t\x05\x04\x06\t\x06" +
-		"\x04\x07\t\x07\x04\b\t\b\x04\t\t\t\x04\n\t\n\x04\v\t\v\x04\f\t\f\x04\r" +
-		"\t\r\x04\x0E\t\x0E\x04\x0F\t\x0F\x04\x10\t\x10\x04\x11\t\x11\x04\x12\t" +
-		"\x12\x04\x13\t\x13\x04\x14\t\x14\x04\x15\t\x15\x04\x16\t\x16\x04\x17\t" +
-		"\x17\x04\x18\t\x18\x04\x19\t\x19\x04\x1A\t\x1A\x04\x1B\t\x1B\x04\x1C\t" +
-		"\x1C\x04\x1D\t\x1D\x04\x1E\t\x1E\x04\x1F\t\x1F\x04 \t \x04!\t!\x04\"\t" +
-		"\"\x04#\t#\x04$\t$\x04%\t%\x04&\t&\x04\'\t\'\x04(\t(\x04)\t)\x04*\t*\x04" +
-		"+\t+\x04,\t,\x04-\t-\x04.\t.\x04/\t/\x040\t0\x041\t1\x042\t2\x043\t3\x04" +
-		"4\t4\x045\t5\x046\t6\x047\t7\x048\t8\x049\t9\x04:\t:\x04;\t;\x04<\t<\x04" +
-		"=\t=\x04>\t>\x04?\t?\x04@\t@\x04A\tA\x04B\tB\x04C\tC\x04D\tD\x04E\tE\x04" +
-		"F\tF\x04G\tG\x04H\tH\x03\x02\x03\x02\x03\x02\x03\x02\x03\x02\x03\x02\x03" +
-		"\x02\x03\x03\x03\x03\x03\x04\x03\x04\x03\x04\x03\x04\x03\x04\x03\x04\x03" +
-		"\x04\x03\x04\x03\x04\x03\x04\x03\x04\x03\x05\x03\x05\x03\x06\x03\x06\x03" +
-		"\x07\x03\x07\x03\x07\x03\b\x03\b\x03\t\x03\t\x03\n\x03\n\x03\n\x03\v\x03" +
-		"\v\x03\f\x03\f\x03\f\x03\f\x03\f\x03\f\x03\f\x03\f\x03\f\x03\r\x03\r\x03" +
-		"\x0E\x03\x0E\x03\x0F\x03\x0F\x03\x0F\x03\x0F\x03\x0F\x03\x0F\x03\x0F\x03" +
-		"\x0F\x03\x0F\x03\x10\x03\x10\x03\x11\x03\x11\x03\x12\x03\x12\x03\x13\x03" +
-		"\x13\x03\x13\x03\x13\x03\x13\x03\x13\x03\x13\x03\x13\x03\x14\x03\x14\x03" +
-		"\x14\x03\x15\x03\x15\x03\x15\x03\x15\x03\x15\x03\x16\x03\x16\x03\x16\x03" +
-		"\x16\x03\x17\x03\x17\x03\x18\x03\x18\x03\x19\x03\x19\x03\x19\x03\x19\x03" +
-		"\x19\x03\x19\x03\x19\x03\x19\x03\x19\x03\x19\x03\x19\x03\x1A\x03\x1A\x03" +
-		"\x1A\x03\x1A\x03\x1A\x03\x1A\x03\x1A\x03\x1B\x03\x1B\x03\x1B\x03\x1B\x03" +
-		"\x1B\x03\x1B\x03\x1B\x03\x1B\x03\x1B\x03\x1B\x03\x1B\x03\x1B\x03\x1B\x03" +
-		"\x1B\x03\x1B\x03\x1B\x03\x1B\x03\x1C\x03\x1C\x03\x1C\x03\x1C\x03\x1C\x03" +
-		"\x1C\x03\x1C\x03\x1C\x03\x1C\x03\x1C\x03\x1C\x03\x1C\x03\x1C\x03\x1C\x03" +
-		"\x1C\x03\x1D\x03\x1D\x03\x1D\x03\x1D\x03\x1D\x03\x1D\x03\x1D\x03\x1D\x03" +
-		"\x1D\x03\x1D\x03\x1D\x03\x1D\x03\x1D\x03\x1D\x03\x1D\x03\x1E\x03\x1E\x03" +
-		"\x1E\x03\x1E\x03\x1E\x03\x1E\x03\x1E\x03\x1E\x03\x1E\x03\x1E\x03\x1E\x03" +
-		"\x1E\x03\x1E\x03\x1F\x03\x1F\x03\x1F\x03\x1F\x03\x1F\x03\x1F\x03\x1F\x03" +
-		"\x1F\x03\x1F\x03\x1F\x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03" +
-		" \x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03 \x03" +
-		" \x03 \x03!\x03!\x03!\x03!\x03!\x03!\x03!\x03!\x03!\x03!\x03!\x03!\x03" +
-		"!\x03!\x03!\x03\"\x03\"\x03\"\x03\"\x03\"\x03\"\x03\"\x03\"\x03\"\x03" +
-		"\"\x03\"\x03\"\x03\"\x03\"\x03\"\x03\"\x03\"\x03\"\x03\"\x03#\x03#\x03" +
-		"#\x03#\x03#\x03#\x03#\x03#\x03#\x03#\x03#\x03#\x03#\x03#\x03#\x03#\x03" +
-		"$\x03$\x03$\x03$\x03$\x03$\x03$\x03$\x03$\x03$\x03$\x03%\x03%\x03%\x03" +
-		"%\x03%\x03%\x03%\x03%\x03&\x03&\x03&\x03&\x03&\x03&\x03&\x03\'\x03\'\x03" +
-		"(\x03(\x03)\x03)\x03*\x03*\x03+\x03+\x03,\x03,\x03-\x03-\x03-\x03.\x03" +
-		".\x03.\x03/\x03/\x030\x030\x031\x031\x031\x032\x032\x032\x033\x033\x03" +
-		"3\x033\x033\x033\x033\x033\x033\x034\x034\x034\x034\x035\x035\x035\x03" +
-		"5\x035\x036\x036\x036\x036\x036\x036\x036\x037\x037\x037\x037\x037\x03" +
-		"7\x037\x038\x038\x038\x038\x039\x039\x039\x039\x039\x039\x039\x039\x03" +
-		":\x06:\u01F0\n:\r:\x0E:\u01F1\x03:\x03:\x06:\u01F6\n:\r:\x0E:\u01F7\x03" +
-		":\x03:\x06:\u01FC\n:\r:\x0E:\u01FD\x03;\x03;\x03;\x03;\x03;\x03;\x03;" +
-		"\x03;\x03;\x05;\u0209\n;\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<" +
-		"\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03" +
-		"<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03" +
-		"<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03<\x03" +
-		"<\x03<\x03<\x03<\x03<\x03<\x03<\x05<\u0244\n<\x03=\x05=\u0247\n=\x03=" +
-		"\x06=\u024A\n=\r=\x0E=\u024B\x03=\x03=\x06=\u0250\n=\r=\x0E=\u0251\x05" +
-		"=\u0254\n=\x03>\x03>\x03>\x03>\x03>\x03>\x03>\x05>\u025D\n>\x03>\x03>" +
-		"\x03>\x03>\x05>\u0263\n>\x03?\x03?\x07?\u0267\n?\f?\x0E?\u026A\v?\x03" +
-		"@\x03@\x03@\x03@\x07@\u0270\n@\f@\x0E@\u0273\v@\x03@\x03@\x03@\x03@\x03" +
-		"@\x07@\u027A\n@\f@\x0E@\u027D\v@\x03@\x05@\u0280\n@\x03A\x03A\x03A\x03" +
-		"A\x03A\x03A\x03A\x03A\x03A\x03B\x03B\x03B\x07B\u028E\nB\fB\x0EB\u0291" +
-		"\vB\x03C\x03C\x03C\x03C\x03C\x03C\x03C\x03C\x03C\x03C\x03C\x03C\x03C\x05" +
-		"C\u02A0\nC\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03" +
-		"D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03" +
-		"D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03" +
-		"D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03" +
-		"D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03" +
-		"D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03" +
-		"D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x03D\x05D\u0300" +
-		"\nD\x03E\x03E\x07E\u0304\nE\fE\x0EE\u0307\vE\x03F\x06F\u030A\nF\rF\x0E" +
-		"F\u030B\x03F\x03F\x03G\x03G\x03G\x03G\x07G\u0314\nG\fG\x0EG\u0317\vG\x03" +
-		"G\x03G\x03G\x03G\x03G\x03H\x03H\x03H\x03H\x07H\u0322\nH\fH\x0EH\u0325" +
-		"\vH\x03H\x03H\x05\u0271\u027B\u0315\x02\x02I\x03\x02\x03\x05\x02\x04\x07" +
-		"\x02\x05\t\x02\x06\v\x02\x07\r\x02\b\x0F\x02\t\x11\x02\n\x13\x02\v\x15" +
-		"\x02\f\x17\x02\r\x19\x02\x0E\x1B\x02\x0F\x1D\x02\x10\x1F\x02\x11!\x02" +
-		"\x12#\x02\x13%\x02\x14\'\x02\x15)\x02\x16+\x02\x17-\x02\x18/\x02\x191" +
-		"\x02\x1A3\x02\x1B5\x02\x1C7\x02\x1D9\x02\x1E;\x02\x1F=\x02 ?\x02!A\x02" +
-		"\"C\x02#E\x02$G\x02%I\x02&K\x02\'M\x02(O\x02)Q\x02*S\x02+U\x02,W\x02-" +
-		"Y\x02.[\x02/]\x020_\x021a\x022c\x023e\x024g\x025i\x026k\x027m\x028o\x02" +
-		"9q\x02:s\x02;u\x02<w\x02=y\x02>{\x02?}\x02@\x7F\x02A\x81\x02B\x83\x02" +
-		"C\x85\x02D\x87\x02E\x89\x02F\x8B\x02G\x8D\x02H\x8F\x02I\x03\x02\x0E\x03" +
-		"\x022;\x03\x02//\x04\x02GGgg\x03\x023;\x05\x02\f\f\x0F\x0F$$\x05\x02\f" +
-		"\f\x0F\x0F))\x04\x02ZZzz\x05\x022;CHch\x04\x02C\\c|\x06\x022;C\\aac|\x05" +
-		"\x02\v\f\x0E\x0F\"\"\x04\x02\f\f\x0F\x0F\x02\u034B\x02\x03\x03\x02\x02" +
-		"\x02\x02\x05\x03\x02\x02\x02\x02\x07\x03\x02\x02\x02\x02\t\x03\x02\x02" +
-		"\x02\x02\v\x03\x02\x02\x02\x02\r\x03\x02\x02\x02\x02\x0F\x03\x02\x02\x02" +
-		"\x02\x11\x03\x02\x02\x02\x02\x13\x03\x02\x02\x02\x02\x15\x03\x02\x02\x02" +
-		"\x02\x17\x03\x02\x02\x02\x02\x19\x03\x02\x02\x02\x02\x1B\x03\x02\x02\x02" +
-		"\x02\x1D\x03\x02\x02\x02\x02\x1F\x03\x02\x02\x02\x02!\x03\x02\x02\x02" +
-		"\x02#\x03\x02\x02\x02\x02%\x03\x02\x02\x02\x02\'\x03\x02\x02\x02\x02)" +
-		"\x03\x02\x02\x02\x02+\x03\x02\x02\x02\x02-\x03\x02\x02\x02\x02/\x03\x02" +
-		"\x02\x02\x021\x03\x02\x02\x02\x023\x03\x02\x02\x02\x025\x03\x02\x02\x02" +
-		"\x027\x03\x02\x02\x02\x029\x03\x02\x02\x02\x02;\x03\x02\x02\x02\x02=\x03" +
-		"\x02\x02\x02\x02?\x03\x02\x02\x02\x02A\x03\x02\x02\x02\x02C\x03\x02\x02" +
-		"\x02\x02E\x03\x02\x02\x02\x02G\x03\x02\x02\x02\x02I\x03\x02\x02\x02\x02" +
-		"K\x03\x02\x02\x02\x02M\x03\x02\x02\x02\x02O\x03\x02\x02\x02\x02Q\x03\x02" +
-		"\x02\x02\x02S\x03\x02\x02\x02\x02U\x03\x02\x02\x02\x02W\x03\x02\x02\x02" +
-		"\x02Y\x03\x02\x02\x02\x02[\x03\x02\x02\x02\x02]\x03\x02\x02\x02\x02_\x03" +
-		"\x02\x02\x02\x02a\x03\x02\x02\x02\x02c\x03\x02\x02\x02\x02e\x03\x02\x02" +
-		"\x02\x02g\x03\x02\x02\x02\x02i\x03\x02\x02\x02\x02k\x03\x02\x02\x02\x02" +
-		"m\x03\x02\x02\x02\x02o\x03\x02\x02\x02\x02q\x03\x02\x02\x02\x02s\x03\x02" +
-		"\x02\x02\x02u\x03\x02\x02\x02\x02w\x03\x02\x02\x02\x02y\x03\x02\x02\x02" +
-		"\x02{\x03\x02\x02\x02\x02}\x03\x02\x02\x02\x02\x7F\x03\x02\x02\x02\x02" +
-		"\x81\x03\x02\x02\x02\x02\x83\x03\x02\x02\x02\x02\x85\x03\x02\x02\x02\x02" +
-		"\x87\x03\x02\x02\x02\x02\x89\x03\x02\x02\x02\x02\x8B\x03\x02\x02\x02\x02" +
-		"\x8D\x03\x02\x02\x02\x02\x8F\x03\x02\x02\x02\x03\x91\x03\x02\x02\x02\x05" +
-		"\x98\x03\x02\x02\x02\x07\x9A\x03\x02\x02\x02\t\xA5\x03\x02\x02\x02\v\xA7" +
-		"\x03\x02\x02\x02\r\xA9\x03\x02\x02\x02\x0F\xAC\x03\x02\x02\x02\x11\xAE" +
-		"\x03\x02\x02\x02\x13\xB0\x03\x02\x02\x02\x15\xB3\x03\x02\x02\x02\x17\xB5" +
-		"\x03\x02\x02\x02\x19\xBE\x03\x02\x02\x02\x1B\xC0\x03\x02\x02\x02\x1D\xC2" +
-		"\x03\x02\x02\x02\x1F\xCB\x03\x02\x02\x02!\xCD\x03\x02\x02\x02#\xCF\x03" +
-		"\x02\x02\x02%\xD1\x03\x02\x02\x02\'\xD9\x03\x02\x02\x02)\xDC\x03\x02\x02" +
-		"\x02+\xE1\x03\x02\x02\x02-\xE5\x03\x02\x02\x02/\xE7\x03\x02\x02\x021\xE9" +
-		"\x03\x02\x02\x023\xF4\x03\x02\x02\x025\xFB\x03\x02\x02\x027\u010C\x03" +
-		"\x02\x02\x029\u011B\x03\x02\x02\x02;\u012A\x03\x02\x02\x02=\u0137\x03" +
-		"\x02\x02\x02?\u0141\x03\x02\x02\x02A\u015A\x03\x02\x02\x02C\u0169\x03" +
-		"\x02\x02\x02E\u017C\x03\x02\x02\x02G\u018C\x03\x02\x02\x02I\u0197\x03" +
-		"\x02\x02\x02K\u019F\x03\x02\x02\x02M\u01A6\x03\x02\x02\x02O\u01A8\x03" +
-		"\x02\x02\x02Q\u01AA\x03\x02\x02\x02S\u01AC\x03\x02\x02\x02U\u01AE\x03" +
-		"\x02\x02\x02W\u01B0\x03\x02\x02\x02Y\u01B2\x03\x02\x02\x02[\u01B5\x03" +
-		"\x02\x02\x02]\u01B8\x03\x02\x02\x02_\u01BA\x03\x02\x02\x02a\u01BC\x03" +
-		"\x02\x02\x02c\u01BF\x03\x02\x02\x02e\u01C2\x03\x02\x02\x02g\u01CB\x03" +
-		"\x02\x02\x02i\u01CF\x03\x02\x02\x02k\u01D4\x03\x02\x02\x02m\u01DB\x03" +
-		"\x02\x02\x02o\u01E2\x03\x02\x02\x02q\u01E6\x03\x02\x02\x02s\u01EF\x03" +
-		"\x02\x02\x02u\u0208\x03\x02\x02\x02w\u0243\x03\x02\x02\x02y\u0246\x03" +
-		"\x02\x02\x02{\u0262\x03\x02\x02\x02}\u0264\x03\x02\x02\x02\x7F\u027F\x03" +
-		"\x02\x02\x02\x81\u0281\x03\x02\x02\x02\x83\u028A\x03\x02\x02\x02\x85\u029F" +
-		"\x03\x02\x02\x02\x87\u02FF\x03\x02\x02\x02\x89\u0301\x03\x02\x02\x02\x8B" +
-		"\u0309\x03\x02\x02\x02\x8D\u030F\x03\x02\x02\x02\x8F\u031D\x03\x02\x02" +
-		"\x02\x91\x92\x07r\x02\x02\x92\x93\x07t\x02\x02\x93\x94\x07c\x02\x02\x94" +
-		"\x95\x07i\x02\x02\x95\x96\x07o\x02\x02\x96\x97\x07c\x02\x02\x97\x04\x03" +
-		"\x02\x02\x02\x98\x99\x07=\x02\x02\x99\x06\x03\x02\x02\x02\x9A\x9B\x07" +
-		"e\x02\x02\x9B\x9C\x07c\x02\x02\x9C\x9D\x07u\x02\x02\x9D\x9E\x07j\x02\x02" +
-		"\x9E\x9F\x07u\x02\x02\x9F\xA0\x07e\x02\x02\xA0\xA1\x07t\x02\x02\xA1\xA2" +
-		"\x07k\x02\x02\xA2\xA3\x07r\x02\x02\xA3\xA4\x07v\x02\x02\xA4\b\x03\x02" +
-		"\x02\x02\xA5\xA6\x07`\x02\x02\xA6\n\x03\x02\x02\x02\xA7\xA8\x07\x80\x02" +
-		"\x02\xA8\f\x03\x02\x02\x02\xA9\xAA\x07@\x02\x02\xAA\xAB\x07?\x02\x02\xAB" +
-		"\x0E\x03\x02\x02\x02\xAC\xAD\x07@\x02\x02\xAD\x10\x03\x02\x02\x02\xAE" +
-		"\xAF\x07>\x02\x02\xAF\x12\x03\x02\x02\x02\xB0\xB1\x07>\x02\x02\xB1\xB2" +
-		"\x07?\x02\x02\xB2\x14\x03\x02\x02\x02\xB3\xB4\x07?\x02\x02\xB4\x16\x03" +
-		"\x02\x02\x02\xB5\xB6\x07e\x02\x02\xB6\xB7\x07q\x02\x02\xB7\xB8\x07p\x02" +
-		"\x02\xB8\xB9\x07v\x02\x02\xB9\xBA\x07t\x02\x02\xBA\xBB\x07c\x02\x02\xBB" +
-		"\xBC\x07e\x02\x02\xBC\xBD\x07v\x02\x02\xBD\x18\x03\x02\x02\x02\xBE\xBF" +
-		"\x07}\x02\x02\xBF\x1A\x03\x02\x02\x02\xC0\xC1\x07\x7F\x02\x02\xC1\x1C" +
-		"\x03\x02\x02\x02\xC2\xC3\x07h\x02\x02\xC3\xC4\x07w\x02\x02\xC4\xC5\x07" +
-		"p\x02\x02\xC5\xC6\x07e\x02\x02\xC6\xC7\x07v\x02\x02\xC7\xC8\x07k\x02\x02" +
-		"\xC8\xC9\x07q\x02\x02\xC9\xCA\x07p\x02\x02\xCA\x1E\x03\x02\x02\x02\xCB" +
-		"\xCC\x07*\x02\x02\xCC \x03\x02\x02\x02\xCD\xCE\x07.\x02\x02\xCE\"\x03" +
-		"\x02\x02\x02\xCF\xD0\x07+\x02\x02\xD0$\x03\x02\x02\x02\xD1\xD2\x07t\x02" +
-		"\x02\xD2\xD3\x07g\x02\x02\xD3\xD4\x07s\x02\x02\xD4\xD5\x07w\x02\x02\xD5" +
-		"\xD6\x07k\x02\x02\xD6\xD7\x07t\x02\x02\xD7\xD8\x07g\x02\x02\xD8&\x03\x02" +
-		"\x02\x02\xD9\xDA\x07k\x02\x02\xDA\xDB\x07h\x02\x02\xDB(\x03\x02\x02\x02" +
-		"\xDC\xDD\x07g\x02\x02\xDD\xDE\x07n\x02\x02\xDE\xDF\x07u\x02\x02\xDF\xE0" +
-		"\x07g\x02\x02\xE0*\x03\x02\x02\x02\xE1\xE2\x07p\x02\x02\xE2\xE3\x07g\x02" +
-		"\x02\xE3\xE4\x07y\x02\x02\xE4,\x03\x02\x02\x02\xE5\xE6\x07]\x02\x02\xE6" +
-		".\x03\x02\x02\x02\xE7\xE8\x07_\x02\x02\xE80\x03\x02\x02\x02\xE9\xEA\x07" +
-		"v\x02\x02\xEA\xEB\x07z\x02\x02\xEB\xEC\x070\x02\x02\xEC\xED\x07q\x02\x02" +
-		"\xED\xEE\x07w\x02\x02\xEE\xEF\x07v\x02\x02\xEF\xF0\x07r\x02\x02\xF0\xF1" +
-		"\x07w\x02\x02\xF1\xF2\x07v\x02\x02\xF2\xF3\x07u\x02\x02\xF32\x03\x02\x02" +
-		"\x02\xF4\xF5\x070\x02\x02\xF5\xF6\x07x\x02\x02\xF6\xF7\x07c\x02\x02\xF7" +
-		"\xF8\x07n\x02\x02\xF8\xF9\x07w\x02\x02\xF9\xFA\x07g\x02\x02\xFA4\x03\x02" +
-		"\x02\x02\xFB\xFC\x070\x02\x02\xFC\xFD\x07n\x02\x02\xFD\xFE\x07q\x02\x02" +
-		"\xFE\xFF\x07e\x02\x02\xFF\u0100\x07m\x02\x02\u0100\u0101\x07k\x02\x02" +
-		"\u0101\u0102\x07p\x02\x02\u0102\u0103\x07i\x02\x02\u0103\u0104\x07D\x02" +
-		"\x02\u0104\u0105\x07{\x02\x02\u0105\u0106\x07v\x02\x02\u0106\u0107\x07" +
-		"g\x02\x02\u0107\u0108\x07e\x02\x02\u0108\u0109\x07q\x02\x02\u0109\u010A" +
-		"\x07f\x02\x02\u010A\u010B\x07g\x02\x02\u010B6\x03\x02\x02\x02\u010C\u010D" +
-		"\x070\x02\x02\u010D\u010E\x07v\x02\x02\u010E\u010F\x07q\x02\x02\u010F" +
-		"\u0110\x07m\x02\x02\u0110\u0111\x07g\x02\x02\u0111\u0112\x07p\x02\x02" +
-		"\u0112\u0113\x07E\x02\x02\u0113\u0114\x07c\x02\x02\u0114\u0115\x07v\x02" +
-		"\x02\u0115\u0116\x07g\x02\x02\u0116\u0117\x07i\x02\x02\u0117\u0118\x07" +
-		"q\x02\x02\u0118\u0119\x07t\x02\x02\u0119\u011A\x07{\x02\x02\u011A8\x03" +
-		"\x02\x02\x02\u011B\u011C\x070\x02\x02\u011C\u011D\x07p\x02\x02\u011D\u011E" +
-		"\x07h\x02\x02\u011E\u011F\x07v\x02\x02\u011F\u0120\x07E\x02\x02\u0120" +
-		"\u0121\x07q\x02\x02\u0121\u0122\x07o\x02\x02\u0122\u0123\x07o\x02\x02" +
-		"\u0123\u0124\x07k\x02\x02\u0124\u0125\x07v\x02\x02\u0125\u0126\x07o\x02" +
-		"\x02\u0126\u0127\x07g\x02\x02\u0127\u0128\x07p\x02\x02\u0128\u0129\x07" +
-		"v\x02\x02\u0129:\x03\x02\x02\x02\u012A\u012B\x070\x02\x02\u012B\u012C" +
-		"\x07v\x02\x02\u012C\u012D\x07q\x02\x02\u012D\u012E\x07m\x02\x02\u012E" +
-		"\u012F\x07g\x02\x02\u012F\u0130\x07p\x02\x02\u0130\u0131\x07C\x02\x02" +
-		"\u0131\u0132\x07o\x02\x02\u0132\u0133\x07q\x02\x02\u0133\u0134\x07w\x02" +
-		"\x02\u0134\u0135\x07p\x02\x02\u0135\u0136\x07v\x02\x02\u0136<\x03\x02" +
-		"\x02\x02\u0137\u0138\x07v\x02\x02\u0138\u0139\x07z\x02\x02\u0139\u013A" +
-		"\x070\x02\x02\u013A\u013B\x07k\x02\x02\u013B\u013C\x07p\x02\x02\u013C" +
-		"\u013D\x07r\x02\x02\u013D\u013E\x07w\x02\x02\u013E\u013F\x07v\x02\x02" +
-		"\u013F\u0140\x07u\x02\x02\u0140>\x03\x02\x02\x02\u0141\u0142\x070\x02" +
-		"\x02\u0142\u0143\x07q\x02\x02\u0143\u0144\x07w\x02\x02\u0144\u0145\x07" +
-		"v\x02\x02\u0145\u0146\x07r\x02\x02\u0146\u0147\x07q\x02\x02\u0147\u0148" +
-		"\x07k\x02\x02\u0148\u0149\x07p\x02\x02\u0149\u014A\x07v\x02\x02\u014A" +
-		"\u014B\x07V\x02\x02\u014B\u014C\x07t\x02\x02\u014C\u014D\x07c\x02\x02" +
-		"\u014D\u014E\x07p\x02\x02\u014E\u014F\x07u\x02\x02\u014F\u0150\x07c\x02" +
-		"\x02\u0150\u0151\x07e\x02\x02\u0151\u0152\x07v\x02\x02\u0152\u0153\x07" +
-		"k\x02\x02\u0153\u0154\x07q\x02\x02\u0154\u0155\x07p\x02\x02\u0155\u0156" +
-		"\x07J\x02\x02\u0156\u0157\x07c\x02\x02\u0157\u0158\x07u\x02\x02\u0158" +
-		"\u0159\x07j\x02\x02\u0159@\x03\x02\x02\x02\u015A\u015B\x070\x02\x02\u015B" +
-		"\u015C\x07q\x02\x02\u015C\u015D\x07w\x02\x02\u015D\u015E\x07v\x02\x02" +
-		"\u015E\u015F\x07r\x02\x02\u015F\u0160\x07q\x02\x02\u0160\u0161\x07k\x02" +
-		"\x02\u0161\u0162\x07p\x02\x02\u0162\u0163\x07v\x02\x02\u0163\u0164\x07" +
-		"K\x02\x02\u0164\u0165\x07p\x02\x02\u0165\u0166\x07f\x02\x02\u0166\u0167" +
-		"\x07g\x02\x02\u0167\u0168\x07z\x02\x02\u0168B\x03\x02\x02\x02\u0169\u016A" +
-		"\x070\x02\x02\u016A\u016B\x07w\x02\x02\u016B\u016C\x07p\x02\x02\u016C" +
-		"\u016D\x07n\x02\x02\u016D\u016E\x07q\x02\x02\u016E\u016F\x07e\x02\x02" +
-		"\u016F\u0170\x07m\x02\x02\u0170\u0171\x07k\x02\x02\u0171\u0172\x07p\x02" +
-		"\x02\u0172\u0173\x07i\x02\x02\u0173\u0174\x07D\x02\x02\u0174\u0175\x07" +
-		"{\x02\x02\u0175\u0176\x07v\x02\x02\u0176\u0177\x07g\x02\x02\u0177\u0178" +
-		"\x07e\x02\x02\u0178\u0179\x07q\x02\x02\u0179\u017A\x07f\x02\x02\u017A" +
-		"\u017B\x07g\x02\x02\u017BD\x03\x02\x02\x02\u017C\u017D\x070\x02\x02\u017D" +
-		"\u017E\x07u\x02\x02\u017E\u017F\x07g\x02\x02\u017F\u0180\x07s\x02\x02" +
-		"\u0180\u0181\x07w\x02\x02\u0181\u0182\x07g\x02\x02\u0182\u0183\x07p\x02" +
-		"\x02\u0183\u0184\x07e\x02\x02\u0184\u0185\x07g\x02\x02\u0185\u0186\x07" +
-		"P\x02\x02\u0186\u0187\x07w\x02\x02\u0187\u0188\x07o\x02\x02\u0188\u0189" +
-		"\x07d\x02\x02\u0189\u018A\x07g\x02\x02\u018A\u018B\x07t\x02\x02\u018B" +
-		"F\x03\x02\x02\x02\u018C\u018D\x070\x02\x02\u018D\u018E\x07t\x02\x02\u018E" +
-		"\u018F\x07g\x02\x02\u018F\u0190\x07x\x02\x02\u0190\u0191\x07g\x02\x02" +
-		"\u0191\u0192\x07t\x02\x02\u0192\u0193\x07u\x02\x02\u0193\u0194\x07g\x02" +
-		"\x02\u0194\u0195\x07*\x02\x02\u0195\u0196\x07+\x02\x02\u0196H\x03\x02" +
-		"\x02\x02\u0197\u0198\x070\x02\x02\u0198\u0199\x07n\x02\x02\u0199\u019A" +
-		"\x07g\x02\x02\u019A\u019B\x07p\x02\x02\u019B\u019C\x07i\x02\x02\u019C" +
-		"\u019D\x07v\x02\x02\u019D\u019E\x07j\x02\x02\u019EJ\x03\x02\x02\x02\u019F" +
-		"\u01A0\x070\x02\x02\u01A0\u01A1\x07u\x02\x02\u01A1\u01A2\x07r\x02\x02" +
-		"\u01A2\u01A3\x07n\x02\x02\u01A3\u01A4\x07k\x02\x02\u01A4\u01A5\x07v\x02" +
-		"\x02\u01A5L\x03\x02\x02\x02\u01A6\u01A7\x07#\x02\x02\u01A7N\x03\x02\x02" +
-		"\x02\u01A8\u01A9\x07/\x02\x02\u01A9P\x03\x02\x02\x02\u01AA\u01AB\x07," +
-		"\x02\x02\u01ABR\x03\x02\x02\x02\u01AC\u01AD\x071\x02\x02\u01ADT\x03\x02" +
-		"\x02\x02\u01AE\u01AF\x07\'\x02\x02\u01AFV\x03\x02\x02\x02\u01B0\u01B1" +
-		"\x07-\x02\x02\u01B1X\x03\x02\x02\x02\u01B2\u01B3\x07?\x02\x02\u01B3\u01B4" +
-		"\x07?\x02\x02\u01B4Z\x03\x02\x02\x02\u01B5\u01B6\x07#\x02\x02\u01B6\u01B7" +
-		"\x07?\x02\x02\u01B7\\\x03\x02\x02\x02\u01B8\u01B9\x07(\x02\x02\u01B9^" +
-		"\x03\x02\x02\x02\u01BA\u01BB\x07~\x02\x02\u01BB`\x03\x02\x02\x02\u01BC" +
-		"\u01BD\x07(\x02\x02\u01BD\u01BE\x07(\x02\x02\u01BEb\x03\x02\x02\x02\u01BF" +
-		"\u01C0\x07~\x02\x02\u01C0\u01C1\x07~\x02\x02\u01C1d\x03\x02\x02\x02\u01C2" +
-		"\u01C3\x07e\x02\x02\u01C3\u01C4\x07q\x02\x02\u01C4\u01C5\x07p\x02\x02" +
-		"\u01C5\u01C6\x07u\x02\x02\u01C6\u01C7\x07v\x02\x02\u01C7\u01C8\x07c\x02" +
-		"\x02\u01C8\u01C9\x07p\x02\x02\u01C9\u01CA\x07v\x02\x02\u01CAf\x03\x02" +
-		"\x02\x02\u01CB\u01CC\x07k\x02\x02\u01CC\u01CD\x07p\x02\x02\u01CD\u01CE" +
-		"\x07v\x02\x02\u01CEh\x03\x02\x02\x02\u01CF\u01D0\x07d\x02\x02\u01D0\u01D1" +
-		"\x07q\x02\x02\u01D1\u01D2\x07q\x02\x02\u01D2\u01D3\x07n\x02\x02\u01D3" +
-		"j\x03\x02\x02\x02\u01D4\u01D5\x07u\x02\x02\u01D5\u01D6\x07v\x02\x02\u01D6" +
-		"\u01D7\x07t\x02\x02\u01D7\u01D8\x07k\x02\x02\u01D8\u01D9\x07p\x02\x02" +
-		"\u01D9\u01DA\x07i\x02\x02\u01DAl\x03\x02\x02\x02\u01DB\u01DC\x07r\x02" +
-		"\x02\u01DC\u01DD\x07w\x02\x02\u01DD\u01DE\x07d\x02\x02\u01DE\u01DF\x07" +
-		"m\x02\x02\u01DF\u01E0\x07g\x02\x02\u01E0\u01E1\x07{\x02\x02\u01E1n\x03" +
-		"\x02\x02\x02\u01E2\u01E3\x07u\x02\x02\u01E3\u01E4\x07k\x02\x02\u01E4\u01E5" +
-		"\x07i\x02\x02\u01E5p\x03\x02\x02\x02\u01E6\u01E7\x07f\x02\x02\u01E7\u01E8" +
-		"\x07c\x02\x02\u01E8\u01E9\x07v\x02\x02\u01E9\u01EA\x07c\x02\x02\u01EA" +
-		"\u01EB\x07u\x02\x02\u01EB\u01EC\x07k\x02\x02\u01EC\u01ED\x07i\x02\x02" +
-		"\u01EDr\x03\x02\x02\x02\u01EE\u01F0\t\x02\x02\x02\u01EF\u01EE\x03\x02" +
-		"\x02\x02\u01F0\u01F1\x03\x02\x02\x02\u01F1\u01EF\x03\x02\x02\x02\u01F1" +
-		"\u01F2\x03\x02\x02\x02\u01F2\u01F3\x03\x02\x02\x02\u01F3\u01F5\x070\x02" +
-		"\x02\u01F4\u01F6\t\x02\x02\x02\u01F5\u01F4\x03\x02\x02\x02\u01F6\u01F7" +
-		"\x03\x02\x02\x02\u01F7\u01F5\x03\x02\x02\x02\u01F7\u01F8\x03\x02\x02\x02" +
-		"\u01F8\u01F9\x03\x02\x02\x02\u01F9\u01FB\x070\x02\x02\u01FA\u01FC\t\x02" +
-		"\x02\x02\u01FB\u01FA";
-	private static readonly _serializedATNSegment1: string =
-		"\x03\x02\x02\x02\u01FC\u01FD\x03\x02\x02\x02\u01FD\u01FB\x03\x02\x02\x02" +
-		"\u01FD\u01FE\x03\x02\x02\x02\u01FEt\x03\x02\x02\x02\u01FF\u0200\x07v\x02" +
-		"\x02\u0200\u0201\x07t\x02\x02\u0201\u0202\x07w\x02\x02\u0202\u0209\x07" +
-		"g\x02\x02\u0203\u0204\x07h\x02\x02\u0204\u0205\x07c\x02\x02\u0205\u0206" +
-		"\x07n\x02\x02\u0206\u0207\x07u\x02\x02\u0207\u0209\x07g\x02\x02\u0208" +
-		"\u01FF\x03\x02\x02\x02\u0208\u0203\x03\x02\x02\x02\u0209v\x03\x02\x02" +
-		"\x02\u020A\u020B\x07u\x02\x02\u020B\u020C\x07c\x02\x02\u020C\u020D\x07" +
-		"v\x02\x02\u020D\u020E\x07q\x02\x02\u020E\u020F\x07u\x02\x02\u020F\u0210" +
-		"\x07j\x02\x02\u0210\u0211\x07k\x02\x02\u0211\u0244\x07u\x02\x02\u0212" +
-		"\u0213\x07u\x02\x02\u0213\u0214\x07c\x02\x02\u0214\u0215\x07v\x02\x02" +
-		"\u0215\u0244\x07u\x02\x02\u0216\u0217\x07h\x02\x02\u0217\u0218\x07k\x02" +
-		"\x02\u0218\u0219\x07p\x02\x02\u0219\u021A\x07p\x02\x02\u021A\u021B\x07" +
-		"g\x02\x02\u021B\u0244\x07{\x02\x02\u021C\u021D\x07d\x02\x02\u021D\u021E" +
-		"\x07k\x02\x02\u021E\u021F\x07v\x02\x02\u021F\u0244\x07u\x02\x02\u0220" +
-		"\u0221\x07d\x02\x02\u0221\u0222\x07k\x02\x02\u0222\u0223\x07v\x02\x02" +
-		"\u0223\u0224\x07e\x02\x02\u0224\u0225\x07q\x02\x02\u0225\u0226\x07k\x02" +
-		"\x02\u0226\u0244\x07p\x02\x02\u0227\u0228\x07u\x02\x02\u0228\u0229\x07" +
-		"g\x02\x02\u0229\u022A\x07e\x02\x02\u022A\u022B\x07q\x02\x02\u022B\u022C" +
-		"\x07p\x02\x02\u022C\u022D\x07f\x02\x02\u022D\u0244\x07u\x02\x02\u022E" +
-		"\u022F\x07o\x02\x02\u022F\u0230\x07k\x02\x02\u0230\u0231\x07p\x02\x02" +
-		"\u0231\u0232\x07w\x02\x02\u0232\u0233\x07v\x02\x02\u0233\u0234\x07g\x02" +
-		"\x02\u0234\u0244\x07u\x02\x02\u0235\u0236\x07j\x02\x02\u0236\u0237\x07" +
-		"q\x02\x02\u0237\u0238\x07w\x02\x02\u0238\u0239\x07t\x02\x02\u0239\u0244" +
-		"\x07u\x02\x02\u023A\u023B\x07f\x02\x02\u023B\u023C\x07c\x02\x02\u023C" +
-		"\u023D\x07{\x02\x02\u023D\u0244\x07u\x02\x02\u023E\u023F\x07y\x02\x02" +
-		"\u023F\u0240\x07g\x02\x02\u0240\u0241\x07g\x02\x02\u0241\u0242\x07m\x02" +
-		"\x02\u0242\u0244\x07u\x02\x02\u0243\u020A\x03\x02\x02\x02\u0243\u0212" +
-		"\x03\x02\x02\x02\u0243\u0216\x03\x02\x02\x02\u0243\u021C\x03\x02\x02\x02" +
-		"\u0243\u0220\x03\x02\x02\x02\u0243\u0227\x03\x02\x02\x02\u0243\u022E\x03" +
-		"\x02\x02\x02\u0243\u0235\x03\x02\x02\x02\u0243\u023A\x03\x02\x02\x02\u0243" +
-		"\u023E\x03\x02\x02\x02\u0244x\x03\x02\x02\x02\u0245\u0247\t\x03\x02\x02" +
-		"\u0246\u0245\x03\x02\x02\x02\u0246\u0247\x03\x02\x02\x02\u0247\u0249\x03" +
-		"\x02\x02\x02\u0248\u024A\t\x02\x02\x02\u0249\u0248\x03\x02\x02\x02\u024A" +
-		"\u024B\x03\x02\x02\x02\u024B\u0249\x03\x02\x02\x02\u024B\u024C\x03\x02" +
-		"\x02\x02\u024C\u0253\x03\x02\x02\x02\u024D\u024F\t\x04\x02\x02\u024E\u0250" +
-		"\t\x02\x02\x02\u024F\u024E\x03\x02\x02\x02\u0250\u0251\x03\x02\x02\x02" +
-		"\u0251\u024F\x03\x02\x02\x02\u0251\u0252\x03\x02\x02\x02\u0252\u0254\x03" +
-		"\x02\x02\x02\u0253\u024D\x03\x02\x02\x02\u0253\u0254\x03\x02\x02\x02\u0254" +
-		"z\x03\x02\x02\x02\u0255\u0256\x07d\x02\x02\u0256\u0257\x07{\x02\x02\u0257" +
-		"\u0258\x07v\x02\x02\u0258\u0259\x07g\x02\x02\u0259\u025A\x07u\x02\x02" +
-		"\u025A\u025C\x03\x02\x02\x02\u025B\u025D\x05}?\x02\u025C\u025B\x03\x02" +
-		"\x02\x02\u025C\u025D\x03\x02\x02\x02\u025D\u0263\x03\x02\x02\x02\u025E" +
-		"\u025F\x07d\x02\x02\u025F\u0260\x07{\x02\x02\u0260\u0261\x07v\x02\x02" +
-		"\u0261\u0263\x07g\x02\x02\u0262\u0255\x03\x02\x02\x02\u0262\u025E\x03" +
-		"\x02\x02\x02\u0263|\x03\x02\x02\x02\u0264\u0268\t\x05\x02\x02\u0265\u0267" +
-		"\t\x02\x02\x02\u0266\u0265\x03\x02\x02\x02\u0267\u026A\x03\x02\x02\x02" +
-		"\u0268\u0266\x03\x02\x02\x02\u0268\u0269\x03\x02\x02\x02\u0269~\x03\x02" +
-		"\x02\x02\u026A\u0268\x03\x02\x02\x02\u026B\u0271\x07$\x02\x02\u026C\u026D" +
-		"\x07^\x02\x02\u026D\u0270\x07$\x02\x02\u026E\u0270\n\x06\x02\x02\u026F" +
-		"\u026C\x03\x02\x02\x02\u026F\u026E\x03\x02\x02\x02\u0270\u0273\x03\x02" +
-		"\x02\x02\u0271\u0272\x03\x02\x02\x02\u0271\u026F\x03\x02\x02\x02\u0272" +
-		"\u0274\x03\x02\x02\x02\u0273\u0271\x03\x02\x02\x02\u0274\u0280\x07$\x02" +
-		"\x02\u0275\u027B\x07)\x02\x02\u0276\u0277\x07^\x02\x02\u0277\u027A\x07" +
-		")\x02\x02\u0278\u027A\n\x07\x02\x02\u0279\u0276\x03\x02\x02\x02\u0279" +
-		"\u0278\x03\x02\x02\x02\u027A\u027D\x03\x02\x02\x02\u027B\u027C\x03\x02" +
-		"\x02\x02\u027B\u0279\x03\x02\x02\x02\u027C\u027E\x03\x02\x02\x02\u027D" +
-		"\u027B\x03\x02\x02\x02\u027E\u0280\x07)\x02\x02\u027F\u026B\x03\x02\x02" +
-		"\x02\u027F\u0275\x03\x02\x02\x02\u0280\x80\x03\x02\x02\x02\u0281\u0282" +
-		"\x07f\x02\x02\u0282\u0283\x07c\x02\x02\u0283\u0284\x07v\x02\x02\u0284" +
-		"\u0285\x07g\x02\x02\u0285\u0286\x07*\x02\x02\u0286\u0287\x03\x02\x02\x02" +
-		"\u0287\u0288\x05\x7F@\x02\u0288\u0289\x07+\x02\x02\u0289\x82\x03\x02\x02" +
-		"\x02\u028A\u028B\x072\x02\x02\u028B\u028F\t\b\x02\x02\u028C\u028E\t\t" +
-		"\x02\x02\u028D\u028C\x03\x02\x02\x02\u028E\u0291\x03\x02\x02\x02\u028F" +
-		"\u028D\x03\x02\x02\x02\u028F\u0290\x03\x02\x02\x02\u0290\x84\x03\x02\x02" +
-		"\x02\u0291\u028F\x03\x02\x02\x02\u0292\u0293\x07v\x02\x02\u0293\u0294" +
-		"\x07z\x02\x02\u0294\u0295\x070\x02\x02\u0295\u0296\x07c\x02\x02\u0296" +
-		"\u0297\x07i\x02\x02\u0297\u02A0\x07g\x02\x02\u0298\u0299\x07v\x02\x02" +
-		"\u0299\u029A\x07z\x02\x02\u029A\u029B\x070\x02\x02\u029B\u029C\x07v\x02" +
-		"\x02\u029C\u029D\x07k\x02\x02\u029D\u029E\x07o\x02\x02\u029E\u02A0\x07" +
-		"g\x02\x02\u029F\u0292\x03\x02\x02\x02\u029F\u0298\x03\x02\x02\x02\u02A0" +
-		"\x86\x03\x02\x02\x02\u02A1\u02A2\x07v\x02\x02\u02A2\u02A3\x07j\x02\x02" +
-		"\u02A3\u02A4\x07k\x02\x02\u02A4\u02A5\x07u\x02\x02\u02A5\u02A6\x070\x02" +
-		"\x02\u02A6\u02A7\x07c\x02\x02\u02A7\u02A8\x07e\x02\x02\u02A8\u02A9\x07" +
-		"v\x02\x02\u02A9\u02AA\x07k\x02\x02\u02AA\u02AB\x07x\x02\x02\u02AB\u02AC" +
-		"\x07g\x02\x02\u02AC\u02AD\x07K\x02\x02\u02AD\u02AE\x07p\x02\x02\u02AE" +
-		"\u02AF\x07r\x02\x02\u02AF\u02B0\x07w\x02\x02\u02B0\u02B1\x07v\x02\x02" +
-		"\u02B1\u02B2\x07K\x02\x02\u02B2\u02B3\x07p\x02\x02\u02B3\u02B4\x07f\x02" +
-		"\x02\u02B4\u02B5\x07g\x02\x02\u02B5\u0300\x07z\x02\x02\u02B6\u02B7\x07" +
-		"v\x02\x02\u02B7\u02B8\x07j\x02\x02\u02B8\u02B9\x07k\x02\x02\u02B9\u02BA" +
-		"\x07u\x02\x02\u02BA\u02BB\x070\x02\x02\u02BB\u02BC\x07c\x02\x02\u02BC" +
-		"\u02BD\x07e\x02\x02\u02BD\u02BE\x07v\x02\x02\u02BE\u02BF\x07k\x02\x02" +
-		"\u02BF\u02C0\x07x\x02\x02\u02C0\u02C1\x07g\x02\x02\u02C1\u02C2\x07D\x02" +
-		"\x02\u02C2\u02C3\x07{\x02\x02\u02C3\u02C4\x07v\x02\x02\u02C4\u02C5\x07" +
-		"g\x02\x02\u02C5\u02C6\x07e\x02\x02\u02C6\u02C7\x07q\x02\x02\u02C7\u02C8" +
-		"\x07f\x02\x02\u02C8\u0300\x07g\x02\x02\u02C9\u02CA\x07v\x02\x02\u02CA" +
-		"\u02CB\x07z\x02\x02\u02CB\u02CC\x070\x02\x02\u02CC\u02CD\x07k\x02\x02" +
-		"\u02CD\u02CE\x07p\x02\x02\u02CE\u02CF\x07r\x02\x02\u02CF\u02D0\x07w\x02" +
-		"\x02\u02D0\u02D1\x07v\x02\x02\u02D1\u02D2\x07u\x02\x02\u02D2\u02D3\x07" +
-		"0\x02\x02\u02D3\u02D4\x07n\x02\x02\u02D4\u02D5\x07g\x02\x02\u02D5\u02D6" +
-		"\x07p\x02\x02\u02D6\u02D7\x07i\x02\x02\u02D7\u02D8\x07v\x02\x02\u02D8" +
-		"\u0300\x07j\x02\x02\u02D9\u02DA\x07v\x02\x02\u02DA\u02DB\x07z\x02\x02" +
-		"\u02DB\u02DC\x070\x02\x02\u02DC\u02DD\x07q\x02\x02\u02DD\u02DE\x07w\x02" +
-		"\x02\u02DE\u02DF\x07v\x02\x02\u02DF\u02E0\x07r\x02\x02\u02E0\u02E1\x07" +
-		"w\x02\x02\u02E1\u02E2\x07v\x02\x02\u02E2\u02E3\x07u\x02\x02\u02E3\u02E4" +
-		"\x070\x02\x02\u02E4\u02E5\x07n\x02\x02\u02E5\u02E6\x07g\x02\x02\u02E6" +
-		"\u02E7\x07p\x02\x02\u02E7\u02E8\x07i\x02\x02\u02E8\u02E9\x07v\x02\x02" +
-		"\u02E9\u0300\x07j\x02\x02\u02EA\u02EB\x07v\x02\x02\u02EB\u02EC\x07z\x02" +
-		"\x02\u02EC\u02ED\x070\x02\x02\u02ED\u02EE\x07x\x02\x02\u02EE\u02EF\x07" +
-		"g\x02\x02\u02EF\u02F0\x07t\x02\x02\u02F0\u02F1\x07u\x02\x02\u02F1\u02F2" +
-		"\x07k\x02\x02\u02F2\u02F3\x07q\x02\x02\u02F3\u0300\x07p\x02\x02\u02F4" +
-		"\u02F5\x07v\x02\x02\u02F5\u02F6\x07z\x02\x02\u02F6\u02F7\x070\x02\x02" +
-		"\u02F7\u02F8\x07n\x02\x02\u02F8\u02F9\x07q\x02\x02\u02F9\u02FA\x07e\x02" +
-		"\x02\u02FA\u02FB\x07m\x02\x02\u02FB\u02FC\x07v\x02\x02\u02FC\u02FD\x07" +
-		"k\x02\x02\u02FD\u02FE\x07o\x02\x02\u02FE\u0300\x07g\x02\x02\u02FF\u02A1" +
-		"\x03\x02\x02\x02\u02FF\u02B6\x03\x02\x02\x02\u02FF\u02C9\x03\x02\x02\x02" +
-		"\u02FF\u02D9\x03\x02\x02\x02\u02FF\u02EA\x03\x02\x02\x02\u02FF\u02F4\x03" +
-		"\x02\x02\x02\u0300\x88\x03\x02\x02\x02\u0301\u0305\t\n\x02\x02\u0302\u0304" +
-		"\t\v\x02\x02\u0303\u0302\x03\x02\x02\x02\u0304\u0307\x03\x02\x02\x02\u0305" +
-		"\u0303\x03\x02\x02\x02\u0305\u0306\x03\x02\x02\x02\u0306\x8A\x03\x02\x02" +
-		"\x02\u0307\u0305\x03\x02\x02\x02\u0308\u030A\t\f\x02\x02\u0309\u0308\x03" +
-		"\x02\x02\x02\u030A\u030B\x03\x02\x02\x02\u030B\u0309\x03\x02\x02\x02\u030B" +
-		"\u030C\x03\x02\x02\x02\u030C\u030D\x03\x02\x02\x02\u030D\u030E\bF\x02" +
-		"\x02\u030E\x8C\x03\x02\x02\x02\u030F\u0310\x071\x02\x02\u0310\u0311\x07" +
-		",\x02\x02\u0311\u0315\x03\x02\x02\x02\u0312\u0314\v\x02\x02\x02\u0313" +
-		"\u0312\x03\x02\x02\x02\u0314\u0317\x03\x02\x02\x02\u0315\u0316\x03\x02" +
-		"\x02\x02\u0315\u0313\x03\x02\x02\x02\u0316\u0318\x03\x02\x02\x02\u0317" +
-		"\u0315\x03\x02\x02\x02\u0318\u0319\x07,\x02\x02\u0319\u031A\x071\x02\x02" +
-		"\u031A\u031B\x03\x02\x02\x02\u031B\u031C\bG\x03\x02\u031C\x8E\x03\x02" +
-		"\x02\x02\u031D\u031E\x071\x02\x02\u031E\u031F\x071\x02\x02\u031F\u0323" +
-		"\x03\x02\x02\x02\u0320\u0322\n\r\x02\x02\u0321\u0320\x03\x02\x02\x02\u0322" +
-		"\u0325\x03\x02\x02\x02\u0323\u0321\x03\x02\x02\x02\u0323\u0324\x03\x02" +
-		"\x02\x02\u0324\u0326\x03\x02\x02\x02\u0325\u0323\x03\x02\x02\x02\u0326" +
-		"\u0327\bH\x03\x02\u0327\x90\x03\x02\x02\x02\x1B\x02\u01F1\u01F7\u01FD" +
-		"\u0208\u0243\u0246\u024B\u0251\u0253\u025C\u0262\u0268\u026F\u0271\u0279" +
-		"\u027B\u027F\u028F\u029F\u02FF\u0305\u030B\u0315\u0323\x04\b\x02\x02\x02" +
-		"\x03\x02";
-	public static readonly _serializedATN: string = Utils.join(
-		[
-			CashScriptLexer._serializedATNSegment0,
-			CashScriptLexer._serializedATNSegment1,
-		],
-		"",
-	);
-	public static __ATN: ATN;
+	public static readonly _serializedATN: number[] = [4,0,71,806,6,-1,2,0,
+	7,0,2,1,7,1,2,2,7,2,2,3,7,3,2,4,7,4,2,5,7,5,2,6,7,6,2,7,7,7,2,8,7,8,2,9,
+	7,9,2,10,7,10,2,11,7,11,2,12,7,12,2,13,7,13,2,14,7,14,2,15,7,15,2,16,7,
+	16,2,17,7,17,2,18,7,18,2,19,7,19,2,20,7,20,2,21,7,21,2,22,7,22,2,23,7,23,
+	2,24,7,24,2,25,7,25,2,26,7,26,2,27,7,27,2,28,7,28,2,29,7,29,2,30,7,30,2,
+	31,7,31,2,32,7,32,2,33,7,33,2,34,7,34,2,35,7,35,2,36,7,36,2,37,7,37,2,38,
+	7,38,2,39,7,39,2,40,7,40,2,41,7,41,2,42,7,42,2,43,7,43,2,44,7,44,2,45,7,
+	45,2,46,7,46,2,47,7,47,2,48,7,48,2,49,7,49,2,50,7,50,2,51,7,51,2,52,7,52,
+	2,53,7,53,2,54,7,54,2,55,7,55,2,56,7,56,2,57,7,57,2,58,7,58,2,59,7,59,2,
+	60,7,60,2,61,7,61,2,62,7,62,2,63,7,63,2,64,7,64,2,65,7,65,2,66,7,66,2,67,
+	7,67,2,68,7,68,2,69,7,69,2,70,7,70,1,0,1,0,1,0,1,0,1,0,1,0,1,0,1,1,1,1,
+	1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,3,1,3,1,4,1,4,1,5,1,5,1,5,
+	1,6,1,6,1,7,1,7,1,8,1,8,1,8,1,9,1,9,1,10,1,10,1,10,1,10,1,10,1,10,1,10,
+	1,10,1,10,1,11,1,11,1,12,1,12,1,13,1,13,1,13,1,13,1,13,1,13,1,13,1,13,1,
+	13,1,14,1,14,1,15,1,15,1,16,1,16,1,17,1,17,1,17,1,17,1,17,1,17,1,17,1,17,
+	1,18,1,18,1,18,1,19,1,19,1,19,1,19,1,19,1,20,1,20,1,20,1,20,1,21,1,21,1,
+	22,1,22,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,24,1,24,
+	1,24,1,24,1,24,1,24,1,24,1,25,1,25,1,25,1,25,1,25,1,25,1,25,1,25,1,25,1,
+	25,1,25,1,25,1,25,1,25,1,25,1,25,1,25,1,26,1,26,1,26,1,26,1,26,1,26,1,26,
+	1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,27,1,27,1,27,1,27,1,27,1,27,1,
+	27,1,27,1,27,1,27,1,27,1,27,1,27,1,27,1,27,1,28,1,28,1,28,1,28,1,28,1,28,
+	1,28,1,28,1,28,1,28,1,28,1,28,1,28,1,29,1,29,1,29,1,29,1,29,1,29,1,29,1,
+	29,1,29,1,29,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,
+	1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,31,1,
+	31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,32,
+	1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,
+	32,1,32,1,32,1,32,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,
+	1,33,1,33,1,33,1,33,1,33,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,
+	34,1,34,1,35,1,35,1,35,1,35,1,35,1,35,1,35,1,35,1,36,1,36,1,36,1,36,1,36,
+	1,36,1,36,1,37,1,37,1,38,1,38,1,39,1,39,1,40,1,40,1,41,1,41,1,42,1,42,1,
+	43,1,43,1,43,1,44,1,44,1,44,1,45,1,45,1,46,1,46,1,47,1,47,1,47,1,48,1,48,
+	1,48,1,49,1,49,1,49,1,49,1,49,1,49,1,49,1,49,1,49,1,50,1,50,1,50,1,50,1,
+	51,1,51,1,51,1,51,1,51,1,52,1,52,1,52,1,52,1,52,1,52,1,52,1,53,1,53,1,53,
+	1,53,1,53,1,53,1,53,1,54,1,54,1,54,1,54,1,55,1,55,1,55,1,55,1,55,1,55,1,
+	55,1,55,1,56,4,56,494,8,56,11,56,12,56,495,1,56,1,56,4,56,500,8,56,11,56,
+	12,56,501,1,56,1,56,4,56,506,8,56,11,56,12,56,507,1,57,1,57,1,57,1,57,1,
+	57,1,57,1,57,1,57,1,57,3,57,519,8,57,1,58,1,58,1,58,1,58,1,58,1,58,1,58,
+	1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,
+	58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,
+	1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,
+	58,1,58,1,58,1,58,1,58,1,58,1,58,3,58,578,8,58,1,59,3,59,581,8,59,1,59,
+	4,59,584,8,59,11,59,12,59,585,1,59,1,59,4,59,590,8,59,11,59,12,59,591,3,
+	59,594,8,59,1,60,1,60,1,60,1,60,1,60,1,60,1,60,3,60,603,8,60,1,60,1,60,
+	1,60,1,60,3,60,609,8,60,1,61,1,61,5,61,613,8,61,10,61,12,61,616,9,61,1,
+	62,1,62,1,62,1,62,5,62,622,8,62,10,62,12,62,625,9,62,1,62,1,62,1,62,1,62,
+	1,62,5,62,632,8,62,10,62,12,62,635,9,62,1,62,3,62,638,8,62,1,63,1,63,1,
+	63,1,63,1,63,1,63,1,63,1,63,1,63,1,64,1,64,1,64,5,64,652,8,64,10,64,12,
+	64,655,9,64,1,65,1,65,1,65,1,65,1,65,1,65,1,65,1,65,1,65,1,65,1,65,1,65,
+	1,65,3,65,670,8,65,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,
+	66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,
+	1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,
+	66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,
+	1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,
+	66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,
+	1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,3,66,766,8,66,1,
+	67,1,67,5,67,770,8,67,10,67,12,67,773,9,67,1,68,4,68,776,8,68,11,68,12,
+	68,777,1,68,1,68,1,69,1,69,1,69,1,69,5,69,786,8,69,10,69,12,69,789,9,69,
+	1,69,1,69,1,69,1,69,1,69,1,70,1,70,1,70,1,70,5,70,800,8,70,10,70,12,70,
+	803,9,70,1,70,1,70,3,623,633,787,0,71,1,1,3,2,5,3,7,4,9,5,11,6,13,7,15,
+	8,17,9,19,10,21,11,23,12,25,13,27,14,29,15,31,16,33,17,35,18,37,19,39,20,
+	41,21,43,22,45,23,47,24,49,25,51,26,53,27,55,28,57,29,59,30,61,31,63,32,
+	65,33,67,34,69,35,71,36,73,37,75,38,77,39,79,40,81,41,83,42,85,43,87,44,
+	89,45,91,46,93,47,95,48,97,49,99,50,101,51,103,52,105,53,107,54,109,55,
+	111,56,113,57,115,58,117,59,119,60,121,61,123,62,125,63,127,64,129,65,131,
+	66,133,67,135,68,137,69,139,70,141,71,1,0,12,1,0,48,57,1,0,45,45,2,0,69,
+	69,101,101,1,0,49,57,3,0,10,10,13,13,34,34,3,0,10,10,13,13,39,39,2,0,88,
+	88,120,120,3,0,48,57,65,70,97,102,2,0,65,90,97,122,4,0,48,57,65,90,95,95,
+	97,122,3,0,9,10,12,13,32,32,2,0,10,10,13,13,841,0,1,1,0,0,0,0,3,1,0,0,0,
+	0,5,1,0,0,0,0,7,1,0,0,0,0,9,1,0,0,0,0,11,1,0,0,0,0,13,1,0,0,0,0,15,1,0,
+	0,0,0,17,1,0,0,0,0,19,1,0,0,0,0,21,1,0,0,0,0,23,1,0,0,0,0,25,1,0,0,0,0,
+	27,1,0,0,0,0,29,1,0,0,0,0,31,1,0,0,0,0,33,1,0,0,0,0,35,1,0,0,0,0,37,1,0,
+	0,0,0,39,1,0,0,0,0,41,1,0,0,0,0,43,1,0,0,0,0,45,1,0,0,0,0,47,1,0,0,0,0,
+	49,1,0,0,0,0,51,1,0,0,0,0,53,1,0,0,0,0,55,1,0,0,0,0,57,1,0,0,0,0,59,1,0,
+	0,0,0,61,1,0,0,0,0,63,1,0,0,0,0,65,1,0,0,0,0,67,1,0,0,0,0,69,1,0,0,0,0,
+	71,1,0,0,0,0,73,1,0,0,0,0,75,1,0,0,0,0,77,1,0,0,0,0,79,1,0,0,0,0,81,1,0,
+	0,0,0,83,1,0,0,0,0,85,1,0,0,0,0,87,1,0,0,0,0,89,1,0,0,0,0,91,1,0,0,0,0,
+	93,1,0,0,0,0,95,1,0,0,0,0,97,1,0,0,0,0,99,1,0,0,0,0,101,1,0,0,0,0,103,1,
+	0,0,0,0,105,1,0,0,0,0,107,1,0,0,0,0,109,1,0,0,0,0,111,1,0,0,0,0,113,1,0,
+	0,0,0,115,1,0,0,0,0,117,1,0,0,0,0,119,1,0,0,0,0,121,1,0,0,0,0,123,1,0,0,
+	0,0,125,1,0,0,0,0,127,1,0,0,0,0,129,1,0,0,0,0,131,1,0,0,0,0,133,1,0,0,0,
+	0,135,1,0,0,0,0,137,1,0,0,0,0,139,1,0,0,0,0,141,1,0,0,0,1,143,1,0,0,0,3,
+	150,1,0,0,0,5,152,1,0,0,0,7,163,1,0,0,0,9,165,1,0,0,0,11,167,1,0,0,0,13,
+	170,1,0,0,0,15,172,1,0,0,0,17,174,1,0,0,0,19,177,1,0,0,0,21,179,1,0,0,0,
+	23,188,1,0,0,0,25,190,1,0,0,0,27,192,1,0,0,0,29,201,1,0,0,0,31,203,1,0,
+	0,0,33,205,1,0,0,0,35,207,1,0,0,0,37,215,1,0,0,0,39,218,1,0,0,0,41,223,
+	1,0,0,0,43,227,1,0,0,0,45,229,1,0,0,0,47,231,1,0,0,0,49,242,1,0,0,0,51,
+	249,1,0,0,0,53,266,1,0,0,0,55,281,1,0,0,0,57,296,1,0,0,0,59,309,1,0,0,0,
+	61,319,1,0,0,0,63,344,1,0,0,0,65,359,1,0,0,0,67,378,1,0,0,0,69,394,1,0,
+	0,0,71,405,1,0,0,0,73,413,1,0,0,0,75,420,1,0,0,0,77,422,1,0,0,0,79,424,
+	1,0,0,0,81,426,1,0,0,0,83,428,1,0,0,0,85,430,1,0,0,0,87,432,1,0,0,0,89,
+	435,1,0,0,0,91,438,1,0,0,0,93,440,1,0,0,0,95,442,1,0,0,0,97,445,1,0,0,0,
+	99,448,1,0,0,0,101,457,1,0,0,0,103,461,1,0,0,0,105,466,1,0,0,0,107,473,
+	1,0,0,0,109,480,1,0,0,0,111,484,1,0,0,0,113,493,1,0,0,0,115,518,1,0,0,0,
+	117,577,1,0,0,0,119,580,1,0,0,0,121,608,1,0,0,0,123,610,1,0,0,0,125,637,
+	1,0,0,0,127,639,1,0,0,0,129,648,1,0,0,0,131,669,1,0,0,0,133,765,1,0,0,0,
+	135,767,1,0,0,0,137,775,1,0,0,0,139,781,1,0,0,0,141,795,1,0,0,0,143,144,
+	5,112,0,0,144,145,5,114,0,0,145,146,5,97,0,0,146,147,5,103,0,0,147,148,
+	5,109,0,0,148,149,5,97,0,0,149,2,1,0,0,0,150,151,5,59,0,0,151,4,1,0,0,0,
+	152,153,5,99,0,0,153,154,5,97,0,0,154,155,5,115,0,0,155,156,5,104,0,0,156,
+	157,5,115,0,0,157,158,5,99,0,0,158,159,5,114,0,0,159,160,5,105,0,0,160,
+	161,5,112,0,0,161,162,5,116,0,0,162,6,1,0,0,0,163,164,5,94,0,0,164,8,1,
+	0,0,0,165,166,5,126,0,0,166,10,1,0,0,0,167,168,5,62,0,0,168,169,5,61,0,
+	0,169,12,1,0,0,0,170,171,5,62,0,0,171,14,1,0,0,0,172,173,5,60,0,0,173,16,
+	1,0,0,0,174,175,5,60,0,0,175,176,5,61,0,0,176,18,1,0,0,0,177,178,5,61,0,
+	0,178,20,1,0,0,0,179,180,5,99,0,0,180,181,5,111,0,0,181,182,5,110,0,0,182,
+	183,5,116,0,0,183,184,5,114,0,0,184,185,5,97,0,0,185,186,5,99,0,0,186,187,
+	5,116,0,0,187,22,1,0,0,0,188,189,5,123,0,0,189,24,1,0,0,0,190,191,5,125,
+	0,0,191,26,1,0,0,0,192,193,5,102,0,0,193,194,5,117,0,0,194,195,5,110,0,
+	0,195,196,5,99,0,0,196,197,5,116,0,0,197,198,5,105,0,0,198,199,5,111,0,
+	0,199,200,5,110,0,0,200,28,1,0,0,0,201,202,5,40,0,0,202,30,1,0,0,0,203,
+	204,5,44,0,0,204,32,1,0,0,0,205,206,5,41,0,0,206,34,1,0,0,0,207,208,5,114,
+	0,0,208,209,5,101,0,0,209,210,5,113,0,0,210,211,5,117,0,0,211,212,5,105,
+	0,0,212,213,5,114,0,0,213,214,5,101,0,0,214,36,1,0,0,0,215,216,5,105,0,
+	0,216,217,5,102,0,0,217,38,1,0,0,0,218,219,5,101,0,0,219,220,5,108,0,0,
+	220,221,5,115,0,0,221,222,5,101,0,0,222,40,1,0,0,0,223,224,5,110,0,0,224,
+	225,5,101,0,0,225,226,5,119,0,0,226,42,1,0,0,0,227,228,5,91,0,0,228,44,
+	1,0,0,0,229,230,5,93,0,0,230,46,1,0,0,0,231,232,5,116,0,0,232,233,5,120,
+	0,0,233,234,5,46,0,0,234,235,5,111,0,0,235,236,5,117,0,0,236,237,5,116,
+	0,0,237,238,5,112,0,0,238,239,5,117,0,0,239,240,5,116,0,0,240,241,5,115,
+	0,0,241,48,1,0,0,0,242,243,5,46,0,0,243,244,5,118,0,0,244,245,5,97,0,0,
+	245,246,5,108,0,0,246,247,5,117,0,0,247,248,5,101,0,0,248,50,1,0,0,0,249,
+	250,5,46,0,0,250,251,5,108,0,0,251,252,5,111,0,0,252,253,5,99,0,0,253,254,
+	5,107,0,0,254,255,5,105,0,0,255,256,5,110,0,0,256,257,5,103,0,0,257,258,
+	5,66,0,0,258,259,5,121,0,0,259,260,5,116,0,0,260,261,5,101,0,0,261,262,
+	5,99,0,0,262,263,5,111,0,0,263,264,5,100,0,0,264,265,5,101,0,0,265,52,1,
+	0,0,0,266,267,5,46,0,0,267,268,5,116,0,0,268,269,5,111,0,0,269,270,5,107,
+	0,0,270,271,5,101,0,0,271,272,5,110,0,0,272,273,5,67,0,0,273,274,5,97,0,
+	0,274,275,5,116,0,0,275,276,5,101,0,0,276,277,5,103,0,0,277,278,5,111,0,
+	0,278,279,5,114,0,0,279,280,5,121,0,0,280,54,1,0,0,0,281,282,5,46,0,0,282,
+	283,5,110,0,0,283,284,5,102,0,0,284,285,5,116,0,0,285,286,5,67,0,0,286,
+	287,5,111,0,0,287,288,5,109,0,0,288,289,5,109,0,0,289,290,5,105,0,0,290,
+	291,5,116,0,0,291,292,5,109,0,0,292,293,5,101,0,0,293,294,5,110,0,0,294,
+	295,5,116,0,0,295,56,1,0,0,0,296,297,5,46,0,0,297,298,5,116,0,0,298,299,
+	5,111,0,0,299,300,5,107,0,0,300,301,5,101,0,0,301,302,5,110,0,0,302,303,
+	5,65,0,0,303,304,5,109,0,0,304,305,5,111,0,0,305,306,5,117,0,0,306,307,
+	5,110,0,0,307,308,5,116,0,0,308,58,1,0,0,0,309,310,5,116,0,0,310,311,5,
+	120,0,0,311,312,5,46,0,0,312,313,5,105,0,0,313,314,5,110,0,0,314,315,5,
+	112,0,0,315,316,5,117,0,0,316,317,5,116,0,0,317,318,5,115,0,0,318,60,1,
+	0,0,0,319,320,5,46,0,0,320,321,5,111,0,0,321,322,5,117,0,0,322,323,5,116,
+	0,0,323,324,5,112,0,0,324,325,5,111,0,0,325,326,5,105,0,0,326,327,5,110,
+	0,0,327,328,5,116,0,0,328,329,5,84,0,0,329,330,5,114,0,0,330,331,5,97,0,
+	0,331,332,5,110,0,0,332,333,5,115,0,0,333,334,5,97,0,0,334,335,5,99,0,0,
+	335,336,5,116,0,0,336,337,5,105,0,0,337,338,5,111,0,0,338,339,5,110,0,0,
+	339,340,5,72,0,0,340,341,5,97,0,0,341,342,5,115,0,0,342,343,5,104,0,0,343,
+	62,1,0,0,0,344,345,5,46,0,0,345,346,5,111,0,0,346,347,5,117,0,0,347,348,
+	5,116,0,0,348,349,5,112,0,0,349,350,5,111,0,0,350,351,5,105,0,0,351,352,
+	5,110,0,0,352,353,5,116,0,0,353,354,5,73,0,0,354,355,5,110,0,0,355,356,
+	5,100,0,0,356,357,5,101,0,0,357,358,5,120,0,0,358,64,1,0,0,0,359,360,5,
+	46,0,0,360,361,5,117,0,0,361,362,5,110,0,0,362,363,5,108,0,0,363,364,5,
+	111,0,0,364,365,5,99,0,0,365,366,5,107,0,0,366,367,5,105,0,0,367,368,5,
+	110,0,0,368,369,5,103,0,0,369,370,5,66,0,0,370,371,5,121,0,0,371,372,5,
+	116,0,0,372,373,5,101,0,0,373,374,5,99,0,0,374,375,5,111,0,0,375,376,5,
+	100,0,0,376,377,5,101,0,0,377,66,1,0,0,0,378,379,5,46,0,0,379,380,5,115,
+	0,0,380,381,5,101,0,0,381,382,5,113,0,0,382,383,5,117,0,0,383,384,5,101,
+	0,0,384,385,5,110,0,0,385,386,5,99,0,0,386,387,5,101,0,0,387,388,5,78,0,
+	0,388,389,5,117,0,0,389,390,5,109,0,0,390,391,5,98,0,0,391,392,5,101,0,
+	0,392,393,5,114,0,0,393,68,1,0,0,0,394,395,5,46,0,0,395,396,5,114,0,0,396,
+	397,5,101,0,0,397,398,5,118,0,0,398,399,5,101,0,0,399,400,5,114,0,0,400,
+	401,5,115,0,0,401,402,5,101,0,0,402,403,5,40,0,0,403,404,5,41,0,0,404,70,
+	1,0,0,0,405,406,5,46,0,0,406,407,5,108,0,0,407,408,5,101,0,0,408,409,5,
+	110,0,0,409,410,5,103,0,0,410,411,5,116,0,0,411,412,5,104,0,0,412,72,1,
+	0,0,0,413,414,5,46,0,0,414,415,5,115,0,0,415,416,5,112,0,0,416,417,5,108,
+	0,0,417,418,5,105,0,0,418,419,5,116,0,0,419,74,1,0,0,0,420,421,5,33,0,0,
+	421,76,1,0,0,0,422,423,5,45,0,0,423,78,1,0,0,0,424,425,5,42,0,0,425,80,
+	1,0,0,0,426,427,5,47,0,0,427,82,1,0,0,0,428,429,5,37,0,0,429,84,1,0,0,0,
+	430,431,5,43,0,0,431,86,1,0,0,0,432,433,5,61,0,0,433,434,5,61,0,0,434,88,
+	1,0,0,0,435,436,5,33,0,0,436,437,5,61,0,0,437,90,1,0,0,0,438,439,5,38,0,
+	0,439,92,1,0,0,0,440,441,5,124,0,0,441,94,1,0,0,0,442,443,5,38,0,0,443,
+	444,5,38,0,0,444,96,1,0,0,0,445,446,5,124,0,0,446,447,5,124,0,0,447,98,
+	1,0,0,0,448,449,5,99,0,0,449,450,5,111,0,0,450,451,5,110,0,0,451,452,5,
+	115,0,0,452,453,5,116,0,0,453,454,5,97,0,0,454,455,5,110,0,0,455,456,5,
+	116,0,0,456,100,1,0,0,0,457,458,5,105,0,0,458,459,5,110,0,0,459,460,5,116,
+	0,0,460,102,1,0,0,0,461,462,5,98,0,0,462,463,5,111,0,0,463,464,5,111,0,
+	0,464,465,5,108,0,0,465,104,1,0,0,0,466,467,5,115,0,0,467,468,5,116,0,0,
+	468,469,5,114,0,0,469,470,5,105,0,0,470,471,5,110,0,0,471,472,5,103,0,0,
+	472,106,1,0,0,0,473,474,5,112,0,0,474,475,5,117,0,0,475,476,5,98,0,0,476,
+	477,5,107,0,0,477,478,5,101,0,0,478,479,5,121,0,0,479,108,1,0,0,0,480,481,
+	5,115,0,0,481,482,5,105,0,0,482,483,5,103,0,0,483,110,1,0,0,0,484,485,5,
+	100,0,0,485,486,5,97,0,0,486,487,5,116,0,0,487,488,5,97,0,0,488,489,5,115,
+	0,0,489,490,5,105,0,0,490,491,5,103,0,0,491,112,1,0,0,0,492,494,7,0,0,0,
+	493,492,1,0,0,0,494,495,1,0,0,0,495,493,1,0,0,0,495,496,1,0,0,0,496,497,
+	1,0,0,0,497,499,5,46,0,0,498,500,7,0,0,0,499,498,1,0,0,0,500,501,1,0,0,
+	0,501,499,1,0,0,0,501,502,1,0,0,0,502,503,1,0,0,0,503,505,5,46,0,0,504,
+	506,7,0,0,0,505,504,1,0,0,0,506,507,1,0,0,0,507,505,1,0,0,0,507,508,1,0,
+	0,0,508,114,1,0,0,0,509,510,5,116,0,0,510,511,5,114,0,0,511,512,5,117,0,
+	0,512,519,5,101,0,0,513,514,5,102,0,0,514,515,5,97,0,0,515,516,5,108,0,
+	0,516,517,5,115,0,0,517,519,5,101,0,0,518,509,1,0,0,0,518,513,1,0,0,0,519,
+	116,1,0,0,0,520,521,5,115,0,0,521,522,5,97,0,0,522,523,5,116,0,0,523,524,
+	5,111,0,0,524,525,5,115,0,0,525,526,5,104,0,0,526,527,5,105,0,0,527,578,
+	5,115,0,0,528,529,5,115,0,0,529,530,5,97,0,0,530,531,5,116,0,0,531,578,
+	5,115,0,0,532,533,5,102,0,0,533,534,5,105,0,0,534,535,5,110,0,0,535,536,
+	5,110,0,0,536,537,5,101,0,0,537,578,5,121,0,0,538,539,5,98,0,0,539,540,
+	5,105,0,0,540,541,5,116,0,0,541,578,5,115,0,0,542,543,5,98,0,0,543,544,
+	5,105,0,0,544,545,5,116,0,0,545,546,5,99,0,0,546,547,5,111,0,0,547,548,
+	5,105,0,0,548,578,5,110,0,0,549,550,5,115,0,0,550,551,5,101,0,0,551,552,
+	5,99,0,0,552,553,5,111,0,0,553,554,5,110,0,0,554,555,5,100,0,0,555,578,
+	5,115,0,0,556,557,5,109,0,0,557,558,5,105,0,0,558,559,5,110,0,0,559,560,
+	5,117,0,0,560,561,5,116,0,0,561,562,5,101,0,0,562,578,5,115,0,0,563,564,
+	5,104,0,0,564,565,5,111,0,0,565,566,5,117,0,0,566,567,5,114,0,0,567,578,
+	5,115,0,0,568,569,5,100,0,0,569,570,5,97,0,0,570,571,5,121,0,0,571,578,
+	5,115,0,0,572,573,5,119,0,0,573,574,5,101,0,0,574,575,5,101,0,0,575,576,
+	5,107,0,0,576,578,5,115,0,0,577,520,1,0,0,0,577,528,1,0,0,0,577,532,1,0,
+	0,0,577,538,1,0,0,0,577,542,1,0,0,0,577,549,1,0,0,0,577,556,1,0,0,0,577,
+	563,1,0,0,0,577,568,1,0,0,0,577,572,1,0,0,0,578,118,1,0,0,0,579,581,7,1,
+	0,0,580,579,1,0,0,0,580,581,1,0,0,0,581,583,1,0,0,0,582,584,7,0,0,0,583,
+	582,1,0,0,0,584,585,1,0,0,0,585,583,1,0,0,0,585,586,1,0,0,0,586,593,1,0,
+	0,0,587,589,7,2,0,0,588,590,7,0,0,0,589,588,1,0,0,0,590,591,1,0,0,0,591,
+	589,1,0,0,0,591,592,1,0,0,0,592,594,1,0,0,0,593,587,1,0,0,0,593,594,1,0,
+	0,0,594,120,1,0,0,0,595,596,5,98,0,0,596,597,5,121,0,0,597,598,5,116,0,
+	0,598,599,5,101,0,0,599,600,5,115,0,0,600,602,1,0,0,0,601,603,3,123,61,
+	0,602,601,1,0,0,0,602,603,1,0,0,0,603,609,1,0,0,0,604,605,5,98,0,0,605,
+	606,5,121,0,0,606,607,5,116,0,0,607,609,5,101,0,0,608,595,1,0,0,0,608,604,
+	1,0,0,0,609,122,1,0,0,0,610,614,7,3,0,0,611,613,7,0,0,0,612,611,1,0,0,0,
+	613,616,1,0,0,0,614,612,1,0,0,0,614,615,1,0,0,0,615,124,1,0,0,0,616,614,
+	1,0,0,0,617,623,5,34,0,0,618,619,5,92,0,0,619,622,5,34,0,0,620,622,8,4,
+	0,0,621,618,1,0,0,0,621,620,1,0,0,0,622,625,1,0,0,0,623,624,1,0,0,0,623,
+	621,1,0,0,0,624,626,1,0,0,0,625,623,1,0,0,0,626,638,5,34,0,0,627,633,5,
+	39,0,0,628,629,5,92,0,0,629,632,5,39,0,0,630,632,8,5,0,0,631,628,1,0,0,
+	0,631,630,1,0,0,0,632,635,1,0,0,0,633,634,1,0,0,0,633,631,1,0,0,0,634,636,
+	1,0,0,0,635,633,1,0,0,0,636,638,5,39,0,0,637,617,1,0,0,0,637,627,1,0,0,
+	0,638,126,1,0,0,0,639,640,5,100,0,0,640,641,5,97,0,0,641,642,5,116,0,0,
+	642,643,5,101,0,0,643,644,5,40,0,0,644,645,1,0,0,0,645,646,3,125,62,0,646,
+	647,5,41,0,0,647,128,1,0,0,0,648,649,5,48,0,0,649,653,7,6,0,0,650,652,7,
+	7,0,0,651,650,1,0,0,0,652,655,1,0,0,0,653,651,1,0,0,0,653,654,1,0,0,0,654,
+	130,1,0,0,0,655,653,1,0,0,0,656,657,5,116,0,0,657,658,5,120,0,0,658,659,
+	5,46,0,0,659,660,5,97,0,0,660,661,5,103,0,0,661,670,5,101,0,0,662,663,5,
+	116,0,0,663,664,5,120,0,0,664,665,5,46,0,0,665,666,5,116,0,0,666,667,5,
+	105,0,0,667,668,5,109,0,0,668,670,5,101,0,0,669,656,1,0,0,0,669,662,1,0,
+	0,0,670,132,1,0,0,0,671,672,5,116,0,0,672,673,5,104,0,0,673,674,5,105,0,
+	0,674,675,5,115,0,0,675,676,5,46,0,0,676,677,5,97,0,0,677,678,5,99,0,0,
+	678,679,5,116,0,0,679,680,5,105,0,0,680,681,5,118,0,0,681,682,5,101,0,0,
+	682,683,5,73,0,0,683,684,5,110,0,0,684,685,5,112,0,0,685,686,5,117,0,0,
+	686,687,5,116,0,0,687,688,5,73,0,0,688,689,5,110,0,0,689,690,5,100,0,0,
+	690,691,5,101,0,0,691,766,5,120,0,0,692,693,5,116,0,0,693,694,5,104,0,0,
+	694,695,5,105,0,0,695,696,5,115,0,0,696,697,5,46,0,0,697,698,5,97,0,0,698,
+	699,5,99,0,0,699,700,5,116,0,0,700,701,5,105,0,0,701,702,5,118,0,0,702,
+	703,5,101,0,0,703,704,5,66,0,0,704,705,5,121,0,0,705,706,5,116,0,0,706,
+	707,5,101,0,0,707,708,5,99,0,0,708,709,5,111,0,0,709,710,5,100,0,0,710,
+	766,5,101,0,0,711,712,5,116,0,0,712,713,5,120,0,0,713,714,5,46,0,0,714,
+	715,5,105,0,0,715,716,5,110,0,0,716,717,5,112,0,0,717,718,5,117,0,0,718,
+	719,5,116,0,0,719,720,5,115,0,0,720,721,5,46,0,0,721,722,5,108,0,0,722,
+	723,5,101,0,0,723,724,5,110,0,0,724,725,5,103,0,0,725,726,5,116,0,0,726,
+	766,5,104,0,0,727,728,5,116,0,0,728,729,5,120,0,0,729,730,5,46,0,0,730,
+	731,5,111,0,0,731,732,5,117,0,0,732,733,5,116,0,0,733,734,5,112,0,0,734,
+	735,5,117,0,0,735,736,5,116,0,0,736,737,5,115,0,0,737,738,5,46,0,0,738,
+	739,5,108,0,0,739,740,5,101,0,0,740,741,5,110,0,0,741,742,5,103,0,0,742,
+	743,5,116,0,0,743,766,5,104,0,0,744,745,5,116,0,0,745,746,5,120,0,0,746,
+	747,5,46,0,0,747,748,5,118,0,0,748,749,5,101,0,0,749,750,5,114,0,0,750,
+	751,5,115,0,0,751,752,5,105,0,0,752,753,5,111,0,0,753,766,5,110,0,0,754,
+	755,5,116,0,0,755,756,5,120,0,0,756,757,5,46,0,0,757,758,5,108,0,0,758,
+	759,5,111,0,0,759,760,5,99,0,0,760,761,5,107,0,0,761,762,5,116,0,0,762,
+	763,5,105,0,0,763,764,5,109,0,0,764,766,5,101,0,0,765,671,1,0,0,0,765,692,
+	1,0,0,0,765,711,1,0,0,0,765,727,1,0,0,0,765,744,1,0,0,0,765,754,1,0,0,0,
+	766,134,1,0,0,0,767,771,7,8,0,0,768,770,7,9,0,0,769,768,1,0,0,0,770,773,
+	1,0,0,0,771,769,1,0,0,0,771,772,1,0,0,0,772,136,1,0,0,0,773,771,1,0,0,0,
+	774,776,7,10,0,0,775,774,1,0,0,0,776,777,1,0,0,0,777,775,1,0,0,0,777,778,
+	1,0,0,0,778,779,1,0,0,0,779,780,6,68,0,0,780,138,1,0,0,0,781,782,5,47,0,
+	0,782,783,5,42,0,0,783,787,1,0,0,0,784,786,9,0,0,0,785,784,1,0,0,0,786,
+	789,1,0,0,0,787,788,1,0,0,0,787,785,1,0,0,0,788,790,1,0,0,0,789,787,1,0,
+	0,0,790,791,5,42,0,0,791,792,5,47,0,0,792,793,1,0,0,0,793,794,6,69,1,0,
+	794,140,1,0,0,0,795,796,5,47,0,0,796,797,5,47,0,0,797,801,1,0,0,0,798,800,
+	8,11,0,0,799,798,1,0,0,0,800,803,1,0,0,0,801,799,1,0,0,0,801,802,1,0,0,
+	0,802,804,1,0,0,0,803,801,1,0,0,0,804,805,6,70,1,0,805,142,1,0,0,0,25,0,
+	495,501,507,518,577,580,585,591,593,602,608,614,621,623,631,633,637,653,
+	669,765,771,777,787,801,2,6,0,0,0,1,0];
+
+	private static __ATN: ATN;
 	public static get _ATN(): ATN {
 		if (!CashScriptLexer.__ATN) {
-			CashScriptLexer.__ATN = new ATNDeserializer().deserialize(Utils.toCharArray(CashScriptLexer._serializedATN));
+			CashScriptLexer.__ATN = new ATNDeserializer().deserialize(CashScriptLexer._serializedATN);
 		}
 
 		return CashScriptLexer.__ATN;
 	}
 
-}
 
+	static DecisionsToDFA = CashScriptLexer._ATN.decisionToState.map( (ds: DecisionState, index: number) => new DFA(ds, index) );
+}
\ No newline at end of file
diff --git a/packages/cashc/src/grammar/CashScriptParser.ts b/packages/cashc/src/grammar/CashScriptParser.ts
index 0ea98f31..b9cf3939 100644
--- a/packages/cashc/src/grammar/CashScriptParser.ts
+++ b/packages/cashc/src/grammar/CashScriptParser.ts
@@ -1,32 +1,23 @@
-// Generated from src/grammar/CashScript.g4 by ANTLR 4.9.0-SNAPSHOT
-
-
-import { ATN } from "antlr4ts/atn/ATN.js";
-import { ATNDeserializer } from "antlr4ts/atn/ATNDeserializer.js";
-import { FailedPredicateException } from "antlr4ts/FailedPredicateException.js";
-import { NotNull } from "antlr4ts/Decorators.js";
-import { NoViableAltException } from "antlr4ts/NoViableAltException.js";
-import { Override } from "antlr4ts/Decorators.js";
-import { Parser } from "antlr4ts/Parser.js";
-import { ParserRuleContext } from "antlr4ts/ParserRuleContext.js";
-import { ParserATNSimulator } from "antlr4ts/atn/ParserATNSimulator.js";
-import { ParseTreeListener } from "antlr4ts/tree/ParseTreeListener.js";
-import { ParseTreeVisitor } from "antlr4ts/tree/ParseTreeVisitor.js";
-import { RecognitionException } from "antlr4ts/RecognitionException.js";
-import { RuleContext } from "antlr4ts/RuleContext.js";
-//import { RuleVersion } from "antlr4ts/RuleVersion.js";
-import { TerminalNode } from "antlr4ts/tree/TerminalNode.js";
-import { Token } from "antlr4ts/Token.js";
-import { TokenStream } from "antlr4ts/TokenStream.js";
-import { Vocabulary } from "antlr4ts/Vocabulary.js";
-import { VocabularyImpl } from "antlr4ts/VocabularyImpl.js";
-
-import * as Utils from "antlr4ts/misc/Utils.js";
-
-import { CashScriptVisitor } from "./CashScriptVisitor.js";
-
-
-export class CashScriptParser extends Parser {
+// Generated from src/grammar/CashScript.g4 by ANTLR 4.13.1
+// noinspection ES6UnusedImports,JSUnusedGlobalSymbols,JSUnusedLocalSymbols
+
+import {
+	ATN,
+	ATNDeserializer, DecisionState, DFA, FailedPredicateException,
+	RecognitionException, NoViableAltException, BailErrorStrategy,
+	Parser, ParserATNSimulator,
+	RuleContext, ParserRuleContext, PredictionMode, PredictionContextCache,
+	TerminalNode, RuleNode,
+	Token, TokenStream,
+	Interval, IntervalSet
+} from 'antlr4';
+import CashScriptVisitor from "./CashScriptVisitor.js";
+
+// for running tests with parameters, TODO: discuss strategy for typed parameters in CI
+// eslint-disable-next-line no-unused-vars
+type int = number;
+
+export default class CashScriptParser extends Parser {
 	public static readonly T__0 = 1;
 	public static readonly T__1 = 2;
 	public static readonly T__2 = 3;
@@ -98,6 +89,7 @@ export class CashScriptParser extends Parser {
 	public static readonly WHITESPACE = 69;
 	public static readonly COMMENT = 70;
 	public static readonly LINE_COMMENT = 71;
+	public static readonly EOF = Token.EOF;
 	public static readonly RULE_sourceFile = 0;
 	public static readonly RULE_pragmaDirective = 1;
 	public static readonly RULE_pragmaName = 2;
@@ -123,6 +115,84 @@ export class CashScriptParser extends Parser {
 	public static readonly RULE_literal = 22;
 	public static readonly RULE_numberLiteral = 23;
 	public static readonly RULE_typeName = 24;
+	public static readonly literalNames: (string | null)[] = [ null, "'pragma'", 
+                                                            "';'", "'cashscript'", 
+                                                            "'^'", "'~'", 
+                                                            "'>='", "'>'", 
+                                                            "'<'", "'<='", 
+                                                            "'='", "'contract'", 
+                                                            "'{'", "'}'", 
+                                                            "'function'", 
+                                                            "'('", "','", 
+                                                            "')'", "'require'", 
+                                                            "'if'", "'else'", 
+                                                            "'new'", "'['", 
+                                                            "']'", "'tx.outputs'", 
+                                                            "'.value'", 
+                                                            "'.lockingBytecode'", 
+                                                            "'.tokenCategory'", 
+                                                            "'.nftCommitment'", 
+                                                            "'.tokenAmount'", 
+                                                            "'tx.inputs'", 
+                                                            "'.outpointTransactionHash'", 
+                                                            "'.outpointIndex'", 
+                                                            "'.unlockingBytecode'", 
+                                                            "'.sequenceNumber'", 
+                                                            "'.reverse()'", 
+                                                            "'.length'", 
+                                                            "'.split'", 
+                                                            "'!'", "'-'", 
+                                                            "'*'", "'/'", 
+                                                            "'%'", "'+'", 
+                                                            "'=='", "'!='", 
+                                                            "'&'", "'|'", 
+                                                            "'&&'", "'||'", 
+                                                            "'constant'", 
+                                                            "'int'", "'bool'", 
+                                                            "'string'", 
+                                                            "'pubkey'", 
+                                                            "'sig'", "'datasig'" ];
+	public static readonly symbolicNames: (string | null)[] = [ null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, "VersionLiteral", 
+                                                             "BooleanLiteral", 
+                                                             "NumberUnit", 
+                                                             "NumberLiteral", 
+                                                             "Bytes", "Bound", 
+                                                             "StringLiteral", 
+                                                             "DateLiteral", 
+                                                             "HexLiteral", 
+                                                             "TxVar", "NullaryOp", 
+                                                             "Identifier", 
+                                                             "WHITESPACE", 
+                                                             "COMMENT", 
+                                                             "LINE_COMMENT" ];
 	// tslint:disable:no-trailing-whitespace
 	public static readonly ruleNames: string[] = [
 		"sourceFile", "pragmaDirective", "pragmaName", "pragmaValue", "versionConstraint", 
@@ -132,48 +202,11 @@ export class CashScriptParser extends Parser {
 		"functionCall", "expressionList", "expression", "modifier", "literal", 
 		"numberLiteral", "typeName",
 	];
-
-	private static readonly _LITERAL_NAMES: Array<string | undefined> = [
-		undefined, "'pragma'", "';'", "'cashscript'", "'^'", "'~'", "'>='", "'>'", 
-		"'<'", "'<='", "'='", "'contract'", "'{'", "'}'", "'function'", "'('", 
-		"','", "')'", "'require'", "'if'", "'else'", "'new'", "'['", "']'", "'tx.outputs'", 
-		"'.value'", "'.lockingBytecode'", "'.tokenCategory'", "'.nftCommitment'", 
-		"'.tokenAmount'", "'tx.inputs'", "'.outpointTransactionHash'", "'.outpointIndex'", 
-		"'.unlockingBytecode'", "'.sequenceNumber'", "'.reverse()'", "'.length'", 
-		"'.split'", "'!'", "'-'", "'*'", "'/'", "'%'", "'+'", "'=='", "'!='", 
-		"'&'", "'|'", "'&&'", "'||'", "'constant'", "'int'", "'bool'", "'string'", 
-		"'pubkey'", "'sig'", "'datasig'",
-	];
-	private static readonly _SYMBOLIC_NAMES: Array<string | undefined> = [
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, undefined, undefined, undefined, undefined, undefined, undefined, 
-		undefined, "VersionLiteral", "BooleanLiteral", "NumberUnit", "NumberLiteral", 
-		"Bytes", "Bound", "StringLiteral", "DateLiteral", "HexLiteral", "TxVar", 
-		"NullaryOp", "Identifier", "WHITESPACE", "COMMENT", "LINE_COMMENT",
-	];
-	public static readonly VOCABULARY: Vocabulary = new VocabularyImpl(CashScriptParser._LITERAL_NAMES, CashScriptParser._SYMBOLIC_NAMES, []);
-
-	// @Override
-	// @NotNull
-	public get vocabulary(): Vocabulary {
-		return CashScriptParser.VOCABULARY;
-	}
-	// tslint:enable:no-trailing-whitespace
-
-	// @Override
 	public get grammarFileName(): string { return "CashScript.g4"; }
-
-	// @Override
+	public get literalNames(): (string | null)[] { return CashScriptParser.literalNames; }
+	public get symbolicNames(): (string | null)[] { return CashScriptParser.symbolicNames; }
 	public get ruleNames(): string[] { return CashScriptParser.ruleNames; }
-
-	// @Override
-	public get serializedATN(): string { return CashScriptParser._serializedATN; }
+	public get serializedATN(): number[] { return CashScriptParser._serializedATN; }
 
 	protected createFailedPredicateException(predicate?: string, message?: string): FailedPredicateException {
 		return new FailedPredicateException(this, predicate, message);
@@ -181,20 +214,20 @@ export class CashScriptParser extends Parser {
 
 	constructor(input: TokenStream) {
 		super(input);
-		this._interp = new ParserATNSimulator(CashScriptParser._ATN, this);
+		this._interp = new ParserATNSimulator(this, CashScriptParser._ATN, CashScriptParser.DecisionsToDFA, new PredictionContextCache());
 	}
 	// @RuleVersion(0)
 	public sourceFile(): SourceFileContext {
-		let _localctx: SourceFileContext = new SourceFileContext(this._ctx, this.state);
-		this.enterRule(_localctx, 0, CashScriptParser.RULE_sourceFile);
+		let localctx: SourceFileContext = new SourceFileContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 0, CashScriptParser.RULE_sourceFile);
 		let _la: number;
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 53;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			while (_la === CashScriptParser.T__0) {
+			while (_la===1) {
 				{
 				{
 				this.state = 50;
@@ -213,7 +246,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -223,14 +256,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public pragmaDirective(): PragmaDirectiveContext {
-		let _localctx: PragmaDirectiveContext = new PragmaDirectiveContext(this._ctx, this.state);
-		this.enterRule(_localctx, 2, CashScriptParser.RULE_pragmaDirective);
+		let localctx: PragmaDirectiveContext = new PragmaDirectiveContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 2, CashScriptParser.RULE_pragmaDirective);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 59;
 			this.match(CashScriptParser.T__0);
@@ -244,7 +277,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -254,14 +287,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public pragmaName(): PragmaNameContext {
-		let _localctx: PragmaNameContext = new PragmaNameContext(this._ctx, this.state);
-		this.enterRule(_localctx, 4, CashScriptParser.RULE_pragmaName);
+		let localctx: PragmaNameContext = new PragmaNameContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 4, CashScriptParser.RULE_pragmaName);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 64;
 			this.match(CashScriptParser.T__2);
@@ -269,7 +302,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -279,22 +312,22 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public pragmaValue(): PragmaValueContext {
-		let _localctx: PragmaValueContext = new PragmaValueContext(this._ctx, this.state);
-		this.enterRule(_localctx, 6, CashScriptParser.RULE_pragmaValue);
+		let localctx: PragmaValueContext = new PragmaValueContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 6, CashScriptParser.RULE_pragmaValue);
 		let _la: number;
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 66;
 			this.versionConstraint();
 			this.state = 68;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & ((1 << CashScriptParser.T__3) | (1 << CashScriptParser.T__4) | (1 << CashScriptParser.T__5) | (1 << CashScriptParser.T__6) | (1 << CashScriptParser.T__7) | (1 << CashScriptParser.T__8) | (1 << CashScriptParser.T__9))) !== 0) || _la === CashScriptParser.VersionLiteral) {
+			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2032) !== 0) || _la===57) {
 				{
 				this.state = 67;
 				this.versionConstraint();
@@ -305,7 +338,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -315,20 +348,20 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public versionConstraint(): VersionConstraintContext {
-		let _localctx: VersionConstraintContext = new VersionConstraintContext(this._ctx, this.state);
-		this.enterRule(_localctx, 8, CashScriptParser.RULE_versionConstraint);
+		let localctx: VersionConstraintContext = new VersionConstraintContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 8, CashScriptParser.RULE_versionConstraint);
 		let _la: number;
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 71;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & ((1 << CashScriptParser.T__3) | (1 << CashScriptParser.T__4) | (1 << CashScriptParser.T__5) | (1 << CashScriptParser.T__6) | (1 << CashScriptParser.T__7) | (1 << CashScriptParser.T__8) | (1 << CashScriptParser.T__9))) !== 0)) {
+			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2032) !== 0)) {
 				{
 				this.state = 70;
 				this.versionOperator();
@@ -341,7 +374,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -351,33 +384,30 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public versionOperator(): VersionOperatorContext {
-		let _localctx: VersionOperatorContext = new VersionOperatorContext(this._ctx, this.state);
-		this.enterRule(_localctx, 10, CashScriptParser.RULE_versionOperator);
+		let localctx: VersionOperatorContext = new VersionOperatorContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 10, CashScriptParser.RULE_versionOperator);
 		let _la: number;
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 75;
 			_la = this._input.LA(1);
-			if (!((((_la) & ~0x1F) === 0 && ((1 << _la) & ((1 << CashScriptParser.T__3) | (1 << CashScriptParser.T__4) | (1 << CashScriptParser.T__5) | (1 << CashScriptParser.T__6) | (1 << CashScriptParser.T__7) | (1 << CashScriptParser.T__8) | (1 << CashScriptParser.T__9))) !== 0))) {
+			if(!((((_la) & ~0x1F) === 0 && ((1 << _la) & 2032) !== 0))) {
 			this._errHandler.recoverInline(this);
-			} else {
-				if (this._input.LA(1) === Token.EOF) {
-					this.matchedEOF = true;
-				}
-
+			}
+			else {
 				this._errHandler.reportMatch(this);
-				this.consume();
+			    this.consume();
 			}
 			}
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -387,15 +417,15 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public contractDefinition(): ContractDefinitionContext {
-		let _localctx: ContractDefinitionContext = new ContractDefinitionContext(this._ctx, this.state);
-		this.enterRule(_localctx, 12, CashScriptParser.RULE_contractDefinition);
+		let localctx: ContractDefinitionContext = new ContractDefinitionContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 12, CashScriptParser.RULE_contractDefinition);
 		let _la: number;
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 77;
 			this.match(CashScriptParser.T__10);
@@ -408,7 +438,7 @@ export class CashScriptParser extends Parser {
 			this.state = 84;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			while (_la === CashScriptParser.T__13) {
+			while (_la===14) {
 				{
 				{
 				this.state = 81;
@@ -425,7 +455,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -435,15 +465,15 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public functionDefinition(): FunctionDefinitionContext {
-		let _localctx: FunctionDefinitionContext = new FunctionDefinitionContext(this._ctx, this.state);
-		this.enterRule(_localctx, 14, CashScriptParser.RULE_functionDefinition);
+		let localctx: FunctionDefinitionContext = new FunctionDefinitionContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 14, CashScriptParser.RULE_functionDefinition);
 		let _la: number;
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 89;
 			this.match(CashScriptParser.T__13);
@@ -456,7 +486,7 @@ export class CashScriptParser extends Parser {
 			this.state = 96;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			while (_la === CashScriptParser.T__17 || _la === CashScriptParser.T__18 || ((((_la - 51)) & ~0x1F) === 0 && ((1 << (_la - 51)) & ((1 << (CashScriptParser.T__50 - 51)) | (1 << (CashScriptParser.T__51 - 51)) | (1 << (CashScriptParser.T__52 - 51)) | (1 << (CashScriptParser.T__53 - 51)) | (1 << (CashScriptParser.T__54 - 51)) | (1 << (CashScriptParser.T__55 - 51)) | (1 << (CashScriptParser.Bytes - 51)) | (1 << (CashScriptParser.Identifier - 51)))) !== 0)) {
+			while (_la===18 || _la===19 || ((((_la - 51)) & ~0x1F) === 0 && ((1 << (_la - 51)) & 132159) !== 0)) {
 				{
 				{
 				this.state = 93;
@@ -473,7 +503,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -483,29 +513,29 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public parameterList(): ParameterListContext {
-		let _localctx: ParameterListContext = new ParameterListContext(this._ctx, this.state);
-		this.enterRule(_localctx, 16, CashScriptParser.RULE_parameterList);
+		let localctx: ParameterListContext = new ParameterListContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 16, CashScriptParser.RULE_parameterList);
 		let _la: number;
 		try {
 			let _alt: number;
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 101;
 			this.match(CashScriptParser.T__14);
 			this.state = 113;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			if (((((_la - 51)) & ~0x1F) === 0 && ((1 << (_la - 51)) & ((1 << (CashScriptParser.T__50 - 51)) | (1 << (CashScriptParser.T__51 - 51)) | (1 << (CashScriptParser.T__52 - 51)) | (1 << (CashScriptParser.T__53 - 51)) | (1 << (CashScriptParser.T__54 - 51)) | (1 << (CashScriptParser.T__55 - 51)) | (1 << (CashScriptParser.Bytes - 51)))) !== 0)) {
+			if (((((_la - 51)) & ~0x1F) === 0 && ((1 << (_la - 51)) & 1087) !== 0)) {
 				{
 				this.state = 102;
 				this.parameter();
 				this.state = 107;
 				this._errHandler.sync(this);
-				_alt = this.interpreter.adaptivePredict(this._input, 5, this._ctx);
+				_alt = this._interp.adaptivePredict(this._input, 5, this._ctx);
 				while (_alt !== 2 && _alt !== ATN.INVALID_ALT_NUMBER) {
 					if (_alt === 1) {
 						{
@@ -519,12 +549,12 @@ export class CashScriptParser extends Parser {
 					}
 					this.state = 109;
 					this._errHandler.sync(this);
-					_alt = this.interpreter.adaptivePredict(this._input, 5, this._ctx);
+					_alt = this._interp.adaptivePredict(this._input, 5, this._ctx);
 				}
 				this.state = 111;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
-				if (_la === CashScriptParser.T__15) {
+				if (_la===16) {
 					{
 					this.state = 110;
 					this.match(CashScriptParser.T__15);
@@ -540,7 +570,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -550,14 +580,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public parameter(): ParameterContext {
-		let _localctx: ParameterContext = new ParameterContext(this._ctx, this.state);
-		this.enterRule(_localctx, 18, CashScriptParser.RULE_parameter);
+		let localctx: ParameterContext = new ParameterContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 18, CashScriptParser.RULE_parameter);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 117;
 			this.typeName();
@@ -567,7 +597,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -577,26 +607,26 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public block(): BlockContext {
-		let _localctx: BlockContext = new BlockContext(this._ctx, this.state);
-		this.enterRule(_localctx, 20, CashScriptParser.RULE_block);
+		let localctx: BlockContext = new BlockContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 20, CashScriptParser.RULE_block);
 		let _la: number;
 		try {
 			this.state = 129;
 			this._errHandler.sync(this);
 			switch (this._input.LA(1)) {
-			case CashScriptParser.T__11:
-				this.enterOuterAlt(_localctx, 1);
+			case 12:
+				this.enterOuterAlt(localctx, 1);
 				{
 				this.state = 120;
 				this.match(CashScriptParser.T__11);
 				this.state = 124;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
-				while (_la === CashScriptParser.T__17 || _la === CashScriptParser.T__18 || ((((_la - 51)) & ~0x1F) === 0 && ((1 << (_la - 51)) & ((1 << (CashScriptParser.T__50 - 51)) | (1 << (CashScriptParser.T__51 - 51)) | (1 << (CashScriptParser.T__52 - 51)) | (1 << (CashScriptParser.T__53 - 51)) | (1 << (CashScriptParser.T__54 - 51)) | (1 << (CashScriptParser.T__55 - 51)) | (1 << (CashScriptParser.Bytes - 51)) | (1 << (CashScriptParser.Identifier - 51)))) !== 0)) {
+				while (_la===18 || _la===19 || ((((_la - 51)) & ~0x1F) === 0 && ((1 << (_la - 51)) & 132159) !== 0)) {
 					{
 					{
 					this.state = 121;
@@ -611,17 +641,17 @@ export class CashScriptParser extends Parser {
 				this.match(CashScriptParser.T__12);
 				}
 				break;
-			case CashScriptParser.T__17:
-			case CashScriptParser.T__18:
-			case CashScriptParser.T__50:
-			case CashScriptParser.T__51:
-			case CashScriptParser.T__52:
-			case CashScriptParser.T__53:
-			case CashScriptParser.T__54:
-			case CashScriptParser.T__55:
-			case CashScriptParser.Bytes:
-			case CashScriptParser.Identifier:
-				this.enterOuterAlt(_localctx, 2);
+			case 18:
+			case 19:
+			case 51:
+			case 52:
+			case 53:
+			case 54:
+			case 55:
+			case 56:
+			case 61:
+			case 68:
+				this.enterOuterAlt(localctx, 2);
 				{
 				this.state = 128;
 				this.statement();
@@ -633,7 +663,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -643,58 +673,53 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public statement(): StatementContext {
-		let _localctx: StatementContext = new StatementContext(this._ctx, this.state);
-		this.enterRule(_localctx, 22, CashScriptParser.RULE_statement);
+		let localctx: StatementContext = new StatementContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 22, CashScriptParser.RULE_statement);
 		try {
 			this.state = 137;
 			this._errHandler.sync(this);
-			switch ( this.interpreter.adaptivePredict(this._input, 10, this._ctx) ) {
+			switch ( this._interp.adaptivePredict(this._input, 10, this._ctx) ) {
 			case 1:
-				this.enterOuterAlt(_localctx, 1);
+				this.enterOuterAlt(localctx, 1);
 				{
 				this.state = 131;
 				this.variableDefinition();
 				}
 				break;
-
 			case 2:
-				this.enterOuterAlt(_localctx, 2);
+				this.enterOuterAlt(localctx, 2);
 				{
 				this.state = 132;
 				this.tupleAssignment();
 				}
 				break;
-
 			case 3:
-				this.enterOuterAlt(_localctx, 3);
+				this.enterOuterAlt(localctx, 3);
 				{
 				this.state = 133;
 				this.assignStatement();
 				}
 				break;
-
 			case 4:
-				this.enterOuterAlt(_localctx, 4);
+				this.enterOuterAlt(localctx, 4);
 				{
 				this.state = 134;
 				this.timeOpStatement();
 				}
 				break;
-
 			case 5:
-				this.enterOuterAlt(_localctx, 5);
+				this.enterOuterAlt(localctx, 5);
 				{
 				this.state = 135;
 				this.requireStatement();
 				}
 				break;
-
 			case 6:
-				this.enterOuterAlt(_localctx, 6);
+				this.enterOuterAlt(localctx, 6);
 				{
 				this.state = 136;
 				this.ifStatement();
@@ -704,7 +729,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -714,22 +739,22 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public variableDefinition(): VariableDefinitionContext {
-		let _localctx: VariableDefinitionContext = new VariableDefinitionContext(this._ctx, this.state);
-		this.enterRule(_localctx, 24, CashScriptParser.RULE_variableDefinition);
+		let localctx: VariableDefinitionContext = new VariableDefinitionContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 24, CashScriptParser.RULE_variableDefinition);
 		let _la: number;
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 139;
 			this.typeName();
 			this.state = 143;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			while (_la === CashScriptParser.T__49) {
+			while (_la===50) {
 				{
 				{
 				this.state = 140;
@@ -752,7 +777,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -762,14 +787,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public tupleAssignment(): TupleAssignmentContext {
-		let _localctx: TupleAssignmentContext = new TupleAssignmentContext(this._ctx, this.state);
-		this.enterRule(_localctx, 26, CashScriptParser.RULE_tupleAssignment);
+		let localctx: TupleAssignmentContext = new TupleAssignmentContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 26, CashScriptParser.RULE_tupleAssignment);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 151;
 			this.typeName();
@@ -791,7 +816,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -801,14 +826,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public assignStatement(): AssignStatementContext {
-		let _localctx: AssignStatementContext = new AssignStatementContext(this._ctx, this.state);
-		this.enterRule(_localctx, 28, CashScriptParser.RULE_assignStatement);
+		let localctx: AssignStatementContext = new AssignStatementContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 28, CashScriptParser.RULE_assignStatement);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 160;
 			this.match(CashScriptParser.Identifier);
@@ -822,7 +847,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -832,14 +857,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public timeOpStatement(): TimeOpStatementContext {
-		let _localctx: TimeOpStatementContext = new TimeOpStatementContext(this._ctx, this.state);
-		this.enterRule(_localctx, 30, CashScriptParser.RULE_timeOpStatement);
+		let localctx: TimeOpStatementContext = new TimeOpStatementContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 30, CashScriptParser.RULE_timeOpStatement);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 165;
 			this.match(CashScriptParser.T__17);
@@ -859,7 +884,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -869,14 +894,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public requireStatement(): RequireStatementContext {
-		let _localctx: RequireStatementContext = new RequireStatementContext(this._ctx, this.state);
-		this.enterRule(_localctx, 32, CashScriptParser.RULE_requireStatement);
+		let localctx: RequireStatementContext = new RequireStatementContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 32, CashScriptParser.RULE_requireStatement);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 173;
 			this.match(CashScriptParser.T__17);
@@ -892,7 +917,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -902,14 +927,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public ifStatement(): IfStatementContext {
-		let _localctx: IfStatementContext = new IfStatementContext(this._ctx, this.state);
-		this.enterRule(_localctx, 34, CashScriptParser.RULE_ifStatement);
+		let localctx: IfStatementContext = new IfStatementContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 34, CashScriptParser.RULE_ifStatement);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 179;
 			this.match(CashScriptParser.T__18);
@@ -920,16 +945,16 @@ export class CashScriptParser extends Parser {
 			this.state = 182;
 			this.match(CashScriptParser.T__16);
 			this.state = 183;
-			_localctx._ifBlock = this.block();
+			localctx._ifBlock = this.block();
 			this.state = 186;
 			this._errHandler.sync(this);
-			switch ( this.interpreter.adaptivePredict(this._input, 12, this._ctx) ) {
+			switch ( this._interp.adaptivePredict(this._input, 12, this._ctx) ) {
 			case 1:
 				{
 				this.state = 184;
 				this.match(CashScriptParser.T__19);
 				this.state = 185;
-				_localctx._elseBlock = this.block();
+				localctx._elseBlock = this.block();
 				}
 				break;
 			}
@@ -937,7 +962,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -947,14 +972,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public functionCall(): FunctionCallContext {
-		let _localctx: FunctionCallContext = new FunctionCallContext(this._ctx, this.state);
-		this.enterRule(_localctx, 36, CashScriptParser.RULE_functionCall);
+		let localctx: FunctionCallContext = new FunctionCallContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 36, CashScriptParser.RULE_functionCall);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 188;
 			this.match(CashScriptParser.Identifier);
@@ -964,7 +989,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -974,29 +999,29 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public expressionList(): ExpressionListContext {
-		let _localctx: ExpressionListContext = new ExpressionListContext(this._ctx, this.state);
-		this.enterRule(_localctx, 38, CashScriptParser.RULE_expressionList);
+		let localctx: ExpressionListContext = new ExpressionListContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 38, CashScriptParser.RULE_expressionList);
 		let _la: number;
 		try {
 			let _alt: number;
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 191;
 			this.match(CashScriptParser.T__14);
 			this.state = 203;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & ((1 << CashScriptParser.T__14) | (1 << CashScriptParser.T__20) | (1 << CashScriptParser.T__21) | (1 << CashScriptParser.T__23) | (1 << CashScriptParser.T__29))) !== 0) || ((((_la - 38)) & ~0x1F) === 0 && ((1 << (_la - 38)) & ((1 << (CashScriptParser.T__37 - 38)) | (1 << (CashScriptParser.T__38 - 38)) | (1 << (CashScriptParser.T__50 - 38)) | (1 << (CashScriptParser.T__51 - 38)) | (1 << (CashScriptParser.T__52 - 38)) | (1 << (CashScriptParser.T__53 - 38)) | (1 << (CashScriptParser.T__54 - 38)) | (1 << (CashScriptParser.T__55 - 38)) | (1 << (CashScriptParser.BooleanLiteral - 38)) | (1 << (CashScriptParser.NumberLiteral - 38)) | (1 << (CashScriptParser.Bytes - 38)) | (1 << (CashScriptParser.StringLiteral - 38)) | (1 << (CashScriptParser.DateLiteral - 38)) | (1 << (CashScriptParser.HexLiteral - 38)) | (1 << (CashScriptParser.NullaryOp - 38)) | (1 << (CashScriptParser.Identifier - 38)))) !== 0)) {
+			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 1096843264) !== 0) || ((((_la - 38)) & ~0x1F) === 0 && ((1 << (_la - 38)) & 1859641347) !== 0)) {
 				{
 				this.state = 192;
 				this.expression(0);
 				this.state = 197;
 				this._errHandler.sync(this);
-				_alt = this.interpreter.adaptivePredict(this._input, 13, this._ctx);
+				_alt = this._interp.adaptivePredict(this._input, 13, this._ctx);
 				while (_alt !== 2 && _alt !== ATN.INVALID_ALT_NUMBER) {
 					if (_alt === 1) {
 						{
@@ -1010,12 +1035,12 @@ export class CashScriptParser extends Parser {
 					}
 					this.state = 199;
 					this._errHandler.sync(this);
-					_alt = this.interpreter.adaptivePredict(this._input, 13, this._ctx);
+					_alt = this._interp.adaptivePredict(this._input, 13, this._ctx);
 				}
 				this.state = 201;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
-				if (_la === CashScriptParser.T__15) {
+				if (_la===16) {
 					{
 					this.state = 200;
 					this.match(CashScriptParser.T__15);
@@ -1031,7 +1056,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -1041,7 +1066,7 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 
 	public expression(): ExpressionContext;
@@ -1054,23 +1079,23 @@ export class CashScriptParser extends Parser {
 
 		let _parentctx: ParserRuleContext = this._ctx;
 		let _parentState: number = this.state;
-		let _localctx: ExpressionContext = new ExpressionContext(this._ctx, _parentState);
-		let _prevctx: ExpressionContext = _localctx;
+		let localctx: ExpressionContext = new ExpressionContext(this, this._ctx, _parentState);
+		let _prevctx: ExpressionContext = localctx;
 		let _startState: number = 40;
-		this.enterRecursionRule(_localctx, 40, CashScriptParser.RULE_expression, _p);
+		this.enterRecursionRule(localctx, 40, CashScriptParser.RULE_expression, _p);
 		let _la: number;
 		try {
 			let _alt: number;
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 260;
 			this._errHandler.sync(this);
-			switch ( this.interpreter.adaptivePredict(this._input, 21, this._ctx) ) {
+			switch ( this._interp.adaptivePredict(this._input, 21, this._ctx) ) {
 			case 1:
 				{
-				_localctx = new ParenthesisedContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new ParenthesisedContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 
 				this.state = 208;
 				this.match(CashScriptParser.T__14);
@@ -1080,34 +1105,33 @@ export class CashScriptParser extends Parser {
 				this.match(CashScriptParser.T__16);
 				}
 				break;
-
 			case 2:
 				{
-				_localctx = new CastContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new CastContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 212;
 				this.typeName();
 				this.state = 213;
 				this.match(CashScriptParser.T__14);
 				this.state = 214;
-				(_localctx as CastContext)._castable = this.expression(0);
+				(localctx as CastContext)._castable = this.expression(0);
 				this.state = 217;
 				this._errHandler.sync(this);
-				switch ( this.interpreter.adaptivePredict(this._input, 16, this._ctx) ) {
+				switch ( this._interp.adaptivePredict(this._input, 16, this._ctx) ) {
 				case 1:
 					{
 					this.state = 215;
 					this.match(CashScriptParser.T__15);
 					this.state = 216;
-					(_localctx as CastContext)._size = this.expression(0);
+					(localctx as CastContext)._size = this.expression(0);
 					}
 					break;
 				}
 				this.state = 220;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
-				if (_la === CashScriptParser.T__15) {
+				if (_la===16) {
 					{
 					this.state = 219;
 					this.match(CashScriptParser.T__15);
@@ -1118,22 +1142,20 @@ export class CashScriptParser extends Parser {
 				this.match(CashScriptParser.T__16);
 				}
 				break;
-
 			case 3:
 				{
-				_localctx = new FunctionCallExpressionContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new FunctionCallExpressionContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 224;
 				this.functionCall();
 				}
 				break;
-
 			case 4:
 				{
-				_localctx = new InstantiationContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new InstantiationContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 225;
 				this.match(CashScriptParser.T__20);
 				this.state = 226;
@@ -1142,14 +1164,13 @@ export class CashScriptParser extends Parser {
 				this.expressionList();
 				}
 				break;
-
 			case 5:
 				{
-				_localctx = new UnaryIntrospectionOpContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new UnaryIntrospectionOpContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 228;
-				(_localctx as UnaryIntrospectionOpContext)._scope = this.match(CashScriptParser.T__23);
+				(localctx as UnaryIntrospectionOpContext)._scope = this.match(CashScriptParser.T__23);
 				this.state = 229;
 				this.match(CashScriptParser.T__21);
 				this.state = 230;
@@ -1157,28 +1178,24 @@ export class CashScriptParser extends Parser {
 				this.state = 231;
 				this.match(CashScriptParser.T__22);
 				this.state = 232;
-				(_localctx as UnaryIntrospectionOpContext)._op = this._input.LT(1);
+				(localctx as UnaryIntrospectionOpContext)._op = this._input.LT(1);
 				_la = this._input.LA(1);
-				if (!((((_la) & ~0x1F) === 0 && ((1 << _la) & ((1 << CashScriptParser.T__24) | (1 << CashScriptParser.T__25) | (1 << CashScriptParser.T__26) | (1 << CashScriptParser.T__27) | (1 << CashScriptParser.T__28))) !== 0))) {
-					(_localctx as UnaryIntrospectionOpContext)._op = this._errHandler.recoverInline(this);
-				} else {
-					if (this._input.LA(1) === Token.EOF) {
-						this.matchedEOF = true;
-					}
-
+				if(!((((_la) & ~0x1F) === 0 && ((1 << _la) & 1040187392) !== 0))) {
+				    (localctx as UnaryIntrospectionOpContext)._op = this._errHandler.recoverInline(this);
+				}
+				else {
 					this._errHandler.reportMatch(this);
-					this.consume();
+				    this.consume();
 				}
 				}
 				break;
-
 			case 6:
 				{
-				_localctx = new UnaryIntrospectionOpContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new UnaryIntrospectionOpContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 234;
-				(_localctx as UnaryIntrospectionOpContext)._scope = this.match(CashScriptParser.T__29);
+				(localctx as UnaryIntrospectionOpContext)._scope = this.match(CashScriptParser.T__29);
 				this.state = 235;
 				this.match(CashScriptParser.T__21);
 				this.state = 236;
@@ -1186,61 +1203,53 @@ export class CashScriptParser extends Parser {
 				this.state = 237;
 				this.match(CashScriptParser.T__22);
 				this.state = 238;
-				(_localctx as UnaryIntrospectionOpContext)._op = this._input.LT(1);
+				(localctx as UnaryIntrospectionOpContext)._op = this._input.LT(1);
 				_la = this._input.LA(1);
-				if (!(((((_la - 25)) & ~0x1F) === 0 && ((1 << (_la - 25)) & ((1 << (CashScriptParser.T__24 - 25)) | (1 << (CashScriptParser.T__25 - 25)) | (1 << (CashScriptParser.T__26 - 25)) | (1 << (CashScriptParser.T__27 - 25)) | (1 << (CashScriptParser.T__28 - 25)) | (1 << (CashScriptParser.T__30 - 25)) | (1 << (CashScriptParser.T__31 - 25)) | (1 << (CashScriptParser.T__32 - 25)) | (1 << (CashScriptParser.T__33 - 25)))) !== 0))) {
-					(_localctx as UnaryIntrospectionOpContext)._op = this._errHandler.recoverInline(this);
-				} else {
-					if (this._input.LA(1) === Token.EOF) {
-						this.matchedEOF = true;
-					}
-
+				if(!(((((_la - 25)) & ~0x1F) === 0 && ((1 << (_la - 25)) & 991) !== 0))) {
+				    (localctx as UnaryIntrospectionOpContext)._op = this._errHandler.recoverInline(this);
+				}
+				else {
 					this._errHandler.reportMatch(this);
-					this.consume();
+				    this.consume();
 				}
 				}
 				break;
-
 			case 7:
 				{
-				_localctx = new UnaryOpContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new UnaryOpContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 240;
-				(_localctx as UnaryOpContext)._op = this._input.LT(1);
+				(localctx as UnaryOpContext)._op = this._input.LT(1);
 				_la = this._input.LA(1);
-				if (!(_la === CashScriptParser.T__37 || _la === CashScriptParser.T__38)) {
-					(_localctx as UnaryOpContext)._op = this._errHandler.recoverInline(this);
-				} else {
-					if (this._input.LA(1) === Token.EOF) {
-						this.matchedEOF = true;
-					}
-
+				if(!(_la===38 || _la===39)) {
+				    (localctx as UnaryOpContext)._op = this._errHandler.recoverInline(this);
+				}
+				else {
 					this._errHandler.reportMatch(this);
-					this.consume();
+				    this.consume();
 				}
 				this.state = 241;
 				this.expression(14);
 				}
 				break;
-
 			case 8:
 				{
-				_localctx = new ArrayContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new ArrayContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 242;
 				this.match(CashScriptParser.T__21);
 				this.state = 254;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
-				if ((((_la) & ~0x1F) === 0 && ((1 << _la) & ((1 << CashScriptParser.T__14) | (1 << CashScriptParser.T__20) | (1 << CashScriptParser.T__21) | (1 << CashScriptParser.T__23) | (1 << CashScriptParser.T__29))) !== 0) || ((((_la - 38)) & ~0x1F) === 0 && ((1 << (_la - 38)) & ((1 << (CashScriptParser.T__37 - 38)) | (1 << (CashScriptParser.T__38 - 38)) | (1 << (CashScriptParser.T__50 - 38)) | (1 << (CashScriptParser.T__51 - 38)) | (1 << (CashScriptParser.T__52 - 38)) | (1 << (CashScriptParser.T__53 - 38)) | (1 << (CashScriptParser.T__54 - 38)) | (1 << (CashScriptParser.T__55 - 38)) | (1 << (CashScriptParser.BooleanLiteral - 38)) | (1 << (CashScriptParser.NumberLiteral - 38)) | (1 << (CashScriptParser.Bytes - 38)) | (1 << (CashScriptParser.StringLiteral - 38)) | (1 << (CashScriptParser.DateLiteral - 38)) | (1 << (CashScriptParser.HexLiteral - 38)) | (1 << (CashScriptParser.NullaryOp - 38)) | (1 << (CashScriptParser.Identifier - 38)))) !== 0)) {
+				if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 1096843264) !== 0) || ((((_la - 38)) & ~0x1F) === 0 && ((1 << (_la - 38)) & 1859641347) !== 0)) {
 					{
 					this.state = 243;
 					this.expression(0);
 					this.state = 248;
 					this._errHandler.sync(this);
-					_alt = this.interpreter.adaptivePredict(this._input, 18, this._ctx);
+					_alt = this._interp.adaptivePredict(this._input, 18, this._ctx);
 					while (_alt !== 2 && _alt !== ATN.INVALID_ALT_NUMBER) {
 						if (_alt === 1) {
 							{
@@ -1254,12 +1263,12 @@ export class CashScriptParser extends Parser {
 						}
 						this.state = 250;
 						this._errHandler.sync(this);
-						_alt = this.interpreter.adaptivePredict(this._input, 18, this._ctx);
+						_alt = this._interp.adaptivePredict(this._input, 18, this._ctx);
 					}
 					this.state = 252;
 					this._errHandler.sync(this);
 					_la = this._input.LA(1);
-					if (_la === CashScriptParser.T__15) {
+					if (_la===16) {
 						{
 						this.state = 251;
 						this.match(CashScriptParser.T__15);
@@ -1273,243 +1282,219 @@ export class CashScriptParser extends Parser {
 				this.match(CashScriptParser.T__22);
 				}
 				break;
-
 			case 9:
 				{
-				_localctx = new NullaryOpContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new NullaryOpContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 257;
 				this.match(CashScriptParser.NullaryOp);
 				}
 				break;
-
 			case 10:
 				{
-				_localctx = new IdentifierContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new IdentifierContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 258;
 				this.match(CashScriptParser.Identifier);
 				}
 				break;
-
 			case 11:
 				{
-				_localctx = new LiteralExpressionContext(_localctx);
-				this._ctx = _localctx;
-				_prevctx = _localctx;
+				localctx = new LiteralExpressionContext(this, localctx);
+				this._ctx = localctx;
+				_prevctx = localctx;
 				this.state = 259;
 				this.literal();
 				}
 				break;
 			}
-			this._ctx._stop = this._input.tryLT(-1);
+			this._ctx.stop = this._input.LT(-1);
 			this.state = 303;
 			this._errHandler.sync(this);
-			_alt = this.interpreter.adaptivePredict(this._input, 23, this._ctx);
+			_alt = this._interp.adaptivePredict(this._input, 23, this._ctx);
 			while (_alt !== 2 && _alt !== ATN.INVALID_ALT_NUMBER) {
 				if (_alt === 1) {
 					if (this._parseListeners != null) {
 						this.triggerExitRuleEvent();
 					}
-					_prevctx = _localctx;
+					_prevctx = localctx;
 					{
 					this.state = 301;
 					this._errHandler.sync(this);
-					switch ( this.interpreter.adaptivePredict(this._input, 22, this._ctx) ) {
+					switch ( this._interp.adaptivePredict(this._input, 22, this._ctx) ) {
 					case 1:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 262;
 						if (!(this.precpred(this._ctx, 13))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 13)");
 						}
 						this.state = 263;
-						(_localctx as BinaryOpContext)._op = this._input.LT(1);
+						(localctx as BinaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
-						if (!(((((_la - 40)) & ~0x1F) === 0 && ((1 << (_la - 40)) & ((1 << (CashScriptParser.T__39 - 40)) | (1 << (CashScriptParser.T__40 - 40)) | (1 << (CashScriptParser.T__41 - 40)))) !== 0))) {
-							(_localctx as BinaryOpContext)._op = this._errHandler.recoverInline(this);
-						} else {
-							if (this._input.LA(1) === Token.EOF) {
-								this.matchedEOF = true;
-							}
-
+						if(!(((((_la - 40)) & ~0x1F) === 0 && ((1 << (_la - 40)) & 7) !== 0))) {
+						    (localctx as BinaryOpContext)._op = this._errHandler.recoverInline(this);
+						}
+						else {
 							this._errHandler.reportMatch(this);
-							this.consume();
+						    this.consume();
 						}
 						this.state = 264;
-						(_localctx as BinaryOpContext)._right = this.expression(14);
+						(localctx as BinaryOpContext)._right = this.expression(14);
 						}
 						break;
-
 					case 2:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 265;
 						if (!(this.precpred(this._ctx, 12))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 12)");
 						}
 						this.state = 266;
-						(_localctx as BinaryOpContext)._op = this._input.LT(1);
+						(localctx as BinaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
-						if (!(_la === CashScriptParser.T__38 || _la === CashScriptParser.T__42)) {
-							(_localctx as BinaryOpContext)._op = this._errHandler.recoverInline(this);
-						} else {
-							if (this._input.LA(1) === Token.EOF) {
-								this.matchedEOF = true;
-							}
-
+						if(!(_la===39 || _la===43)) {
+						    (localctx as BinaryOpContext)._op = this._errHandler.recoverInline(this);
+						}
+						else {
 							this._errHandler.reportMatch(this);
-							this.consume();
+						    this.consume();
 						}
 						this.state = 267;
-						(_localctx as BinaryOpContext)._right = this.expression(13);
+						(localctx as BinaryOpContext)._right = this.expression(13);
 						}
 						break;
-
 					case 3:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 268;
 						if (!(this.precpred(this._ctx, 11))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 11)");
 						}
 						this.state = 269;
-						(_localctx as BinaryOpContext)._op = this._input.LT(1);
+						(localctx as BinaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
-						if (!((((_la) & ~0x1F) === 0 && ((1 << _la) & ((1 << CashScriptParser.T__5) | (1 << CashScriptParser.T__6) | (1 << CashScriptParser.T__7) | (1 << CashScriptParser.T__8))) !== 0))) {
-							(_localctx as BinaryOpContext)._op = this._errHandler.recoverInline(this);
-						} else {
-							if (this._input.LA(1) === Token.EOF) {
-								this.matchedEOF = true;
-							}
-
+						if(!((((_la) & ~0x1F) === 0 && ((1 << _la) & 960) !== 0))) {
+						    (localctx as BinaryOpContext)._op = this._errHandler.recoverInline(this);
+						}
+						else {
 							this._errHandler.reportMatch(this);
-							this.consume();
+						    this.consume();
 						}
 						this.state = 270;
-						(_localctx as BinaryOpContext)._right = this.expression(12);
+						(localctx as BinaryOpContext)._right = this.expression(12);
 						}
 						break;
-
 					case 4:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 271;
 						if (!(this.precpred(this._ctx, 10))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 10)");
 						}
 						this.state = 272;
-						(_localctx as BinaryOpContext)._op = this._input.LT(1);
+						(localctx as BinaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
-						if (!(_la === CashScriptParser.T__43 || _la === CashScriptParser.T__44)) {
-							(_localctx as BinaryOpContext)._op = this._errHandler.recoverInline(this);
-						} else {
-							if (this._input.LA(1) === Token.EOF) {
-								this.matchedEOF = true;
-							}
-
+						if(!(_la===44 || _la===45)) {
+						    (localctx as BinaryOpContext)._op = this._errHandler.recoverInline(this);
+						}
+						else {
 							this._errHandler.reportMatch(this);
-							this.consume();
+						    this.consume();
 						}
 						this.state = 273;
-						(_localctx as BinaryOpContext)._right = this.expression(11);
+						(localctx as BinaryOpContext)._right = this.expression(11);
 						}
 						break;
-
 					case 5:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 274;
 						if (!(this.precpred(this._ctx, 9))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 9)");
 						}
 						this.state = 275;
-						(_localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__45);
+						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__45);
 						this.state = 276;
-						(_localctx as BinaryOpContext)._right = this.expression(10);
+						(localctx as BinaryOpContext)._right = this.expression(10);
 						}
 						break;
-
 					case 6:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 277;
 						if (!(this.precpred(this._ctx, 8))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 8)");
 						}
 						this.state = 278;
-						(_localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__3);
+						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__3);
 						this.state = 279;
-						(_localctx as BinaryOpContext)._right = this.expression(9);
+						(localctx as BinaryOpContext)._right = this.expression(9);
 						}
 						break;
-
 					case 7:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 280;
 						if (!(this.precpred(this._ctx, 7))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 7)");
 						}
 						this.state = 281;
-						(_localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__46);
+						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__46);
 						this.state = 282;
-						(_localctx as BinaryOpContext)._right = this.expression(8);
+						(localctx as BinaryOpContext)._right = this.expression(8);
 						}
 						break;
-
 					case 8:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 283;
 						if (!(this.precpred(this._ctx, 6))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 6)");
 						}
 						this.state = 284;
-						(_localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__47);
+						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__47);
 						this.state = 285;
-						(_localctx as BinaryOpContext)._right = this.expression(7);
+						(localctx as BinaryOpContext)._right = this.expression(7);
 						}
 						break;
-
 					case 9:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 286;
 						if (!(this.precpred(this._ctx, 5))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 5)");
 						}
 						this.state = 287;
-						(_localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__48);
+						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__48);
 						this.state = 288;
-						(_localctx as BinaryOpContext)._right = this.expression(6);
+						(localctx as BinaryOpContext)._right = this.expression(6);
 						}
 						break;
-
 					case 10:
 						{
-						_localctx = new TupleIndexOpContext(new ExpressionContext(_parentctx, _parentState));
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new TupleIndexOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 289;
 						if (!(this.precpred(this._ctx, 19))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 19)");
@@ -1517,51 +1502,46 @@ export class CashScriptParser extends Parser {
 						this.state = 290;
 						this.match(CashScriptParser.T__21);
 						this.state = 291;
-						(_localctx as TupleIndexOpContext)._index = this.match(CashScriptParser.NumberLiteral);
+						(localctx as TupleIndexOpContext)._index = this.match(CashScriptParser.NumberLiteral);
 						this.state = 292;
 						this.match(CashScriptParser.T__22);
 						}
 						break;
-
 					case 11:
 						{
-						_localctx = new UnaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new UnaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 293;
 						if (!(this.precpred(this._ctx, 16))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 16)");
 						}
 						this.state = 294;
-						(_localctx as UnaryOpContext)._op = this._input.LT(1);
+						(localctx as UnaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
-						if (!(_la === CashScriptParser.T__34 || _la === CashScriptParser.T__35)) {
-							(_localctx as UnaryOpContext)._op = this._errHandler.recoverInline(this);
-						} else {
-							if (this._input.LA(1) === Token.EOF) {
-								this.matchedEOF = true;
-							}
-
+						if(!(_la===35 || _la===36)) {
+						    (localctx as UnaryOpContext)._op = this._errHandler.recoverInline(this);
+						}
+						else {
 							this._errHandler.reportMatch(this);
-							this.consume();
+						    this.consume();
 						}
 						}
 						break;
-
 					case 12:
 						{
-						_localctx = new BinaryOpContext(new ExpressionContext(_parentctx, _parentState));
-						(_localctx as BinaryOpContext)._left = _prevctx;
-						this.pushNewRecursionContext(_localctx, _startState, CashScriptParser.RULE_expression);
+						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
+						(localctx as BinaryOpContext)._left = _prevctx;
+						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
 						this.state = 295;
 						if (!(this.precpred(this._ctx, 15))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 15)");
 						}
 						this.state = 296;
-						(_localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__36);
+						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__36);
 						this.state = 297;
 						this.match(CashScriptParser.T__14);
 						this.state = 298;
-						(_localctx as BinaryOpContext)._right = this.expression(0);
+						(localctx as BinaryOpContext)._right = this.expression(0);
 						this.state = 299;
 						this.match(CashScriptParser.T__16);
 						}
@@ -1571,13 +1551,13 @@ export class CashScriptParser extends Parser {
 				}
 				this.state = 305;
 				this._errHandler.sync(this);
-				_alt = this.interpreter.adaptivePredict(this._input, 23, this._ctx);
+				_alt = this._interp.adaptivePredict(this._input, 23, this._ctx);
 			}
 			}
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -1587,14 +1567,14 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.unrollRecursionContexts(_parentctx);
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public modifier(): ModifierContext {
-		let _localctx: ModifierContext = new ModifierContext(this._ctx, this.state);
-		this.enterRule(_localctx, 42, CashScriptParser.RULE_modifier);
+		let localctx: ModifierContext = new ModifierContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 42, CashScriptParser.RULE_modifier);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 306;
 			this.match(CashScriptParser.T__49);
@@ -1602,7 +1582,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -1612,46 +1592,46 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public literal(): LiteralContext {
-		let _localctx: LiteralContext = new LiteralContext(this._ctx, this.state);
-		this.enterRule(_localctx, 44, CashScriptParser.RULE_literal);
+		let localctx: LiteralContext = new LiteralContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 44, CashScriptParser.RULE_literal);
 		try {
 			this.state = 313;
 			this._errHandler.sync(this);
 			switch (this._input.LA(1)) {
-			case CashScriptParser.BooleanLiteral:
-				this.enterOuterAlt(_localctx, 1);
+			case 58:
+				this.enterOuterAlt(localctx, 1);
 				{
 				this.state = 308;
 				this.match(CashScriptParser.BooleanLiteral);
 				}
 				break;
-			case CashScriptParser.NumberLiteral:
-				this.enterOuterAlt(_localctx, 2);
+			case 60:
+				this.enterOuterAlt(localctx, 2);
 				{
 				this.state = 309;
 				this.numberLiteral();
 				}
 				break;
-			case CashScriptParser.StringLiteral:
-				this.enterOuterAlt(_localctx, 3);
+			case 63:
+				this.enterOuterAlt(localctx, 3);
 				{
 				this.state = 310;
 				this.match(CashScriptParser.StringLiteral);
 				}
 				break;
-			case CashScriptParser.DateLiteral:
-				this.enterOuterAlt(_localctx, 4);
+			case 64:
+				this.enterOuterAlt(localctx, 4);
 				{
 				this.state = 311;
 				this.match(CashScriptParser.DateLiteral);
 				}
 				break;
-			case CashScriptParser.HexLiteral:
-				this.enterOuterAlt(_localctx, 5);
+			case 65:
+				this.enterOuterAlt(localctx, 5);
 				{
 				this.state = 312;
 				this.match(CashScriptParser.HexLiteral);
@@ -1663,7 +1643,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -1673,20 +1653,20 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public numberLiteral(): NumberLiteralContext {
-		let _localctx: NumberLiteralContext = new NumberLiteralContext(this._ctx, this.state);
-		this.enterRule(_localctx, 46, CashScriptParser.RULE_numberLiteral);
+		let localctx: NumberLiteralContext = new NumberLiteralContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 46, CashScriptParser.RULE_numberLiteral);
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 315;
 			this.match(CashScriptParser.NumberLiteral);
 			this.state = 317;
 			this._errHandler.sync(this);
-			switch ( this.interpreter.adaptivePredict(this._input, 25, this._ctx) ) {
+			switch ( this._interp.adaptivePredict(this._input, 25, this._ctx) ) {
 			case 1:
 				{
 				this.state = 316;
@@ -1698,7 +1678,7 @@ export class CashScriptParser extends Parser {
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -1708,33 +1688,30 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 	// @RuleVersion(0)
 	public typeName(): TypeNameContext {
-		let _localctx: TypeNameContext = new TypeNameContext(this._ctx, this.state);
-		this.enterRule(_localctx, 48, CashScriptParser.RULE_typeName);
+		let localctx: TypeNameContext = new TypeNameContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 48, CashScriptParser.RULE_typeName);
 		let _la: number;
 		try {
-			this.enterOuterAlt(_localctx, 1);
+			this.enterOuterAlt(localctx, 1);
 			{
 			this.state = 319;
 			_la = this._input.LA(1);
-			if (!(((((_la - 51)) & ~0x1F) === 0 && ((1 << (_la - 51)) & ((1 << (CashScriptParser.T__50 - 51)) | (1 << (CashScriptParser.T__51 - 51)) | (1 << (CashScriptParser.T__52 - 51)) | (1 << (CashScriptParser.T__53 - 51)) | (1 << (CashScriptParser.T__54 - 51)) | (1 << (CashScriptParser.T__55 - 51)) | (1 << (CashScriptParser.Bytes - 51)))) !== 0))) {
+			if(!(((((_la - 51)) & ~0x1F) === 0 && ((1 << (_la - 51)) & 1087) !== 0))) {
 			this._errHandler.recoverInline(this);
-			} else {
-				if (this._input.LA(1) === Token.EOF) {
-					this.matchedEOF = true;
-				}
-
+			}
+			else {
 				this._errHandler.reportMatch(this);
-				this.consume();
+			    this.consume();
 			}
 			}
 		}
 		catch (re) {
 			if (re instanceof RecognitionException) {
-				_localctx.exception = re;
+				localctx.exception = re;
 				this._errHandler.reportError(this, re);
 				this._errHandler.recover(this, re);
 			} else {
@@ -1744,240 +1721,187 @@ export class CashScriptParser extends Parser {
 		finally {
 			this.exitRule();
 		}
-		return _localctx;
+		return localctx;
 	}
 
-	public sempred(_localctx: RuleContext, ruleIndex: number, predIndex: number): boolean {
+	public sempred(localctx: RuleContext, ruleIndex: number, predIndex: number): boolean {
 		switch (ruleIndex) {
 		case 20:
-			return this.expression_sempred(_localctx as ExpressionContext, predIndex);
+			return this.expression_sempred(localctx as ExpressionContext, predIndex);
 		}
 		return true;
 	}
-	private expression_sempred(_localctx: ExpressionContext, predIndex: number): boolean {
+	private expression_sempred(localctx: ExpressionContext, predIndex: number): boolean {
 		switch (predIndex) {
 		case 0:
 			return this.precpred(this._ctx, 13);
-
 		case 1:
 			return this.precpred(this._ctx, 12);
-
 		case 2:
 			return this.precpred(this._ctx, 11);
-
 		case 3:
 			return this.precpred(this._ctx, 10);
-
 		case 4:
 			return this.precpred(this._ctx, 9);
-
 		case 5:
 			return this.precpred(this._ctx, 8);
-
 		case 6:
 			return this.precpred(this._ctx, 7);
-
 		case 7:
 			return this.precpred(this._ctx, 6);
-
 		case 8:
 			return this.precpred(this._ctx, 5);
-
 		case 9:
 			return this.precpred(this._ctx, 19);
-
 		case 10:
 			return this.precpred(this._ctx, 16);
-
 		case 11:
 			return this.precpred(this._ctx, 15);
 		}
 		return true;
 	}
 
-	public static readonly _serializedATN: string =
-		"\x03\uC91D\uCABA\u058D\uAFBA\u4F53\u0607\uEA8B\uC241\x03I\u0144\x04\x02" +
-		"\t\x02\x04\x03\t\x03\x04\x04\t\x04\x04\x05\t\x05\x04\x06\t\x06\x04\x07" +
-		"\t\x07\x04\b\t\b\x04\t\t\t\x04\n\t\n\x04\v\t\v\x04\f\t\f\x04\r\t\r\x04" +
-		"\x0E\t\x0E\x04\x0F\t\x0F\x04\x10\t\x10\x04\x11\t\x11\x04\x12\t\x12\x04" +
-		"\x13\t\x13\x04\x14\t\x14\x04\x15\t\x15\x04\x16\t\x16\x04\x17\t\x17\x04" +
-		"\x18\t\x18\x04\x19\t\x19\x04\x1A\t\x1A\x03\x02\x07\x026\n\x02\f\x02\x0E" +
-		"\x029\v\x02\x03\x02\x03\x02\x03\x02\x03\x03\x03\x03\x03\x03\x03\x03\x03" +
-		"\x03\x03\x04\x03\x04\x03\x05\x03\x05\x05\x05G\n\x05\x03\x06\x05\x06J\n" +
-		"\x06\x03\x06\x03\x06\x03\x07\x03\x07\x03\b\x03\b\x03\b\x03\b\x03\b\x07" +
-		"\bU\n\b\f\b\x0E\bX\v\b\x03\b\x03\b\x03\t\x03\t\x03\t\x03\t\x03\t\x07\t" +
-		"a\n\t\f\t\x0E\td\v\t\x03\t\x03\t\x03\n\x03\n\x03\n\x03\n\x07\nl\n\n\f" +
-		"\n\x0E\no\v\n\x03\n\x05\nr\n\n\x05\nt\n\n\x03\n\x03\n\x03\v\x03\v\x03" +
-		"\v\x03\f\x03\f\x07\f}\n\f\f\f\x0E\f\x80\v\f\x03\f\x03\f\x05\f\x84\n\f" +
-		"\x03\r\x03\r\x03\r\x03\r\x03\r\x03\r\x05\r\x8C\n\r\x03\x0E\x03\x0E\x07" +
-		"\x0E\x90\n\x0E\f\x0E\x0E\x0E\x93\v\x0E\x03\x0E\x03\x0E\x03\x0E\x03\x0E" +
-		"\x03\x0E\x03\x0F\x03\x0F\x03\x0F\x03\x0F\x03\x0F\x03\x0F\x03\x0F\x03\x0F" +
-		"\x03\x0F\x03\x10\x03\x10\x03\x10\x03\x10\x03\x10\x03\x11\x03\x11\x03\x11" +
-		"\x03\x11\x03\x11\x03\x11\x03\x11\x03\x11\x03\x12\x03\x12\x03\x12\x03\x12" +
-		"\x03\x12\x03\x12\x03\x13\x03\x13\x03\x13\x03\x13\x03\x13\x03\x13\x03\x13" +
-		"\x05\x13\xBD\n\x13\x03\x14\x03\x14\x03\x14\x03\x15\x03\x15\x03\x15\x03" +
-		"\x15\x07\x15\xC6\n\x15\f\x15\x0E\x15\xC9\v\x15\x03\x15\x05\x15\xCC\n\x15" +
-		"\x05\x15\xCE\n\x15\x03\x15\x03\x15\x03\x16\x03\x16\x03\x16\x03\x16\x03" +
-		"\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x05\x16\xDC\n\x16\x03\x16" +
-		"\x05\x16\xDF\n\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03" +
-		"\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03" +
-		"\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x07" +
-		"\x16\xF9\n\x16\f\x16\x0E\x16\xFC\v\x16\x03\x16\x05\x16\xFF\n\x16\x05\x16" +
-		"\u0101\n\x16\x03\x16\x03\x16\x03\x16\x03\x16\x05\x16\u0107\n\x16\x03\x16" +
-		"\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16" +
-		"\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16" +
-		"\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16" +
-		"\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16\x03\x16" +
-		"\x03\x16\x03\x16\x07\x16\u0130\n\x16\f\x16\x0E\x16\u0133\v\x16\x03\x17" +
-		"\x03\x17\x03\x18\x03\x18\x03\x18\x03\x18\x03\x18\x05\x18\u013C\n\x18\x03" +
-		"\x19\x03\x19\x05\x19\u0140\n\x19\x03\x1A\x03\x1A\x03\x1A\x02\x02\x03*" +
-		"\x1B\x02\x02\x04\x02\x06\x02\b\x02\n\x02\f\x02\x0E\x02\x10\x02\x12\x02" +
-		"\x14\x02\x16\x02\x18\x02\x1A\x02\x1C\x02\x1E\x02 \x02\"\x02$\x02&\x02" +
-		"(\x02*\x02,\x02.\x020\x022\x02\x02\f\x03\x02\x06\f\x03\x02\x1B\x1F\x04" +
-		"\x02\x1B\x1F!$\x03\x02()\x03\x02*,\x04\x02))--\x03\x02\b\v\x03\x02./\x03" +
-		"\x02%&\x04\x025:??\x02\u015E\x027\x03\x02\x02\x02\x04=\x03\x02\x02\x02" +
-		"\x06B\x03\x02\x02\x02\bD\x03\x02\x02\x02\nI\x03\x02\x02\x02\fM\x03\x02" +
-		"\x02\x02\x0EO\x03\x02\x02\x02\x10[\x03\x02\x02\x02\x12g\x03\x02\x02\x02" +
-		"\x14w\x03\x02\x02\x02\x16\x83\x03\x02\x02\x02\x18\x8B\x03\x02\x02\x02" +
-		"\x1A\x8D\x03\x02\x02\x02\x1C\x99\x03\x02\x02\x02\x1E\xA2\x03\x02\x02\x02" +
-		" \xA7\x03\x02\x02\x02\"\xAF\x03\x02\x02\x02$\xB5\x03\x02\x02\x02&\xBE" +
-		"\x03\x02\x02\x02(\xC1\x03\x02\x02\x02*\u0106\x03\x02\x02\x02,\u0134\x03" +
-		"\x02\x02\x02.\u013B\x03\x02\x02\x020\u013D\x03\x02\x02\x022\u0141\x03" +
-		"\x02\x02\x0246\x05\x04\x03\x0254\x03\x02\x02\x0269\x03\x02\x02\x0275\x03" +
-		"\x02\x02\x0278\x03\x02\x02\x028:\x03\x02\x02\x0297\x03\x02\x02\x02:;\x05" +
-		"\x0E\b\x02;<\x07\x02\x02\x03<\x03\x03\x02\x02\x02=>\x07\x03\x02\x02>?" +
-		"\x05\x06\x04\x02?@\x05\b\x05\x02@A\x07\x04\x02\x02A\x05\x03\x02\x02\x02" +
-		"BC\x07\x05\x02\x02C\x07\x03\x02\x02\x02DF\x05\n\x06\x02EG\x05\n\x06\x02" +
-		"FE\x03\x02\x02\x02FG\x03\x02\x02\x02G\t\x03\x02\x02\x02HJ\x05\f\x07\x02" +
-		"IH\x03\x02\x02\x02IJ\x03\x02\x02\x02JK\x03\x02\x02\x02KL\x07;\x02\x02" +
-		"L\v\x03\x02\x02\x02MN\t\x02\x02\x02N\r\x03\x02\x02\x02OP\x07\r\x02\x02" +
-		"PQ\x07F\x02\x02QR\x05\x12\n\x02RV\x07\x0E\x02\x02SU\x05\x10\t\x02TS\x03" +
-		"\x02\x02\x02UX\x03\x02\x02\x02VT\x03\x02\x02\x02VW\x03\x02\x02\x02WY\x03" +
-		"\x02\x02\x02XV\x03\x02\x02\x02YZ\x07\x0F\x02\x02Z\x0F\x03\x02\x02\x02" +
-		"[\\\x07\x10\x02\x02\\]\x07F\x02\x02]^\x05\x12\n\x02^b\x07\x0E\x02\x02" +
-		"_a\x05\x18\r\x02`_\x03\x02\x02\x02ad\x03\x02\x02\x02b`\x03\x02\x02\x02" +
-		"bc\x03\x02\x02\x02ce\x03\x02\x02\x02db\x03\x02\x02\x02ef\x07\x0F\x02\x02" +
-		"f\x11\x03\x02\x02\x02gs\x07\x11\x02\x02hm\x05\x14\v\x02ij\x07\x12\x02" +
-		"\x02jl\x05\x14\v\x02ki\x03\x02\x02\x02lo\x03\x02\x02\x02mk\x03\x02\x02" +
-		"\x02mn\x03\x02\x02\x02nq\x03\x02\x02\x02om\x03\x02\x02\x02pr\x07\x12\x02" +
-		"\x02qp\x03\x02\x02\x02qr\x03\x02\x02\x02rt\x03\x02\x02\x02sh\x03\x02\x02" +
-		"\x02st\x03\x02\x02\x02tu\x03\x02\x02\x02uv\x07\x13\x02\x02v\x13\x03\x02" +
-		"\x02\x02wx\x052\x1A\x02xy\x07F\x02\x02y\x15\x03\x02\x02\x02z~\x07\x0E" +
-		"\x02\x02{}\x05\x18\r\x02|{\x03\x02\x02\x02}\x80\x03\x02\x02\x02~|\x03" +
-		"\x02\x02\x02~\x7F\x03\x02\x02\x02\x7F\x81\x03\x02\x02\x02\x80~\x03\x02" +
-		"\x02\x02\x81\x84\x07\x0F\x02\x02\x82\x84\x05\x18\r\x02\x83z\x03\x02\x02" +
-		"\x02\x83\x82\x03\x02\x02\x02\x84\x17\x03\x02\x02\x02\x85\x8C\x05\x1A\x0E" +
-		"\x02\x86\x8C\x05\x1C\x0F\x02\x87\x8C\x05\x1E\x10\x02\x88\x8C\x05 \x11" +
-		"\x02\x89\x8C\x05\"\x12\x02\x8A\x8C\x05$\x13\x02\x8B\x85\x03\x02\x02\x02" +
-		"\x8B\x86\x03\x02\x02\x02\x8B\x87\x03\x02\x02\x02\x8B\x88\x03\x02\x02\x02" +
-		"\x8B\x89\x03\x02\x02\x02\x8B\x8A\x03\x02\x02\x02\x8C\x19\x03\x02\x02\x02" +
-		"\x8D\x91\x052\x1A\x02\x8E\x90\x05,\x17\x02\x8F\x8E\x03\x02\x02\x02\x90" +
-		"\x93\x03\x02\x02\x02\x91\x8F\x03\x02\x02\x02\x91\x92\x03\x02\x02\x02\x92" +
-		"\x94\x03\x02\x02\x02\x93\x91\x03\x02\x02\x02\x94\x95\x07F\x02\x02\x95" +
-		"\x96\x07\f\x02\x02\x96\x97\x05*\x16\x02\x97\x98\x07\x04\x02\x02\x98\x1B" +
-		"\x03\x02\x02\x02\x99\x9A\x052\x1A\x02\x9A\x9B\x07F\x02\x02\x9B\x9C\x07" +
-		"\x12\x02\x02\x9C\x9D\x052\x1A\x02\x9D\x9E\x07F\x02\x02\x9E\x9F\x07\f\x02" +
-		"\x02\x9F\xA0\x05*\x16\x02\xA0\xA1\x07\x04\x02\x02\xA1\x1D\x03\x02\x02" +
-		"\x02\xA2\xA3\x07F\x02\x02\xA3\xA4\x07\f\x02\x02\xA4\xA5\x05*\x16\x02\xA5" +
-		"\xA6\x07\x04\x02\x02\xA6\x1F\x03\x02\x02\x02\xA7\xA8\x07\x14\x02\x02\xA8" +
-		"\xA9\x07\x11\x02\x02\xA9\xAA\x07D\x02\x02\xAA\xAB\x07\b\x02\x02\xAB\xAC" +
-		"\x05*\x16\x02\xAC\xAD\x07\x13\x02\x02\xAD\xAE\x07\x04\x02\x02\xAE!\x03" +
-		"\x02\x02\x02\xAF\xB0\x07\x14\x02\x02\xB0\xB1\x07\x11\x02\x02\xB1\xB2\x05" +
-		"*\x16\x02\xB2\xB3\x07\x13\x02\x02\xB3\xB4\x07\x04\x02\x02\xB4#\x03\x02" +
-		"\x02\x02\xB5\xB6\x07\x15\x02\x02\xB6\xB7\x07\x11\x02\x02\xB7\xB8\x05*" +
-		"\x16\x02\xB8\xB9\x07\x13\x02\x02\xB9\xBC\x05\x16\f\x02\xBA\xBB\x07\x16" +
-		"\x02\x02\xBB\xBD\x05\x16\f\x02\xBC\xBA\x03\x02\x02\x02\xBC\xBD\x03\x02" +
-		"\x02\x02\xBD%\x03\x02\x02\x02\xBE\xBF\x07F\x02\x02\xBF\xC0\x05(\x15\x02" +
-		"\xC0\'\x03\x02\x02\x02\xC1\xCD\x07\x11\x02\x02\xC2\xC7\x05*\x16\x02\xC3" +
-		"\xC4\x07\x12\x02\x02\xC4\xC6\x05*\x16\x02\xC5\xC3\x03\x02\x02\x02\xC6" +
-		"\xC9\x03\x02\x02\x02\xC7\xC5\x03\x02\x02\x02\xC7\xC8\x03\x02\x02\x02\xC8" +
-		"\xCB\x03\x02\x02\x02\xC9\xC7\x03\x02\x02\x02\xCA\xCC\x07\x12\x02\x02\xCB" +
-		"\xCA\x03\x02\x02\x02\xCB\xCC\x03\x02\x02\x02\xCC\xCE\x03\x02\x02\x02\xCD" +
-		"\xC2\x03\x02\x02\x02\xCD\xCE\x03\x02\x02\x02\xCE\xCF\x03\x02\x02\x02\xCF" +
-		"\xD0\x07\x13\x02\x02\xD0)\x03\x02\x02\x02\xD1\xD2\b\x16\x01\x02\xD2\xD3" +
-		"\x07\x11\x02\x02\xD3\xD4\x05*\x16\x02\xD4\xD5\x07\x13\x02\x02\xD5\u0107" +
-		"\x03\x02\x02\x02\xD6\xD7\x052\x1A\x02\xD7\xD8\x07\x11\x02\x02\xD8\xDB" +
-		"\x05*\x16\x02\xD9\xDA\x07\x12\x02\x02\xDA\xDC\x05*\x16\x02\xDB\xD9\x03" +
-		"\x02\x02\x02\xDB\xDC\x03\x02\x02\x02\xDC\xDE\x03\x02\x02\x02\xDD\xDF\x07" +
-		"\x12\x02\x02\xDE\xDD\x03\x02\x02\x02\xDE\xDF\x03\x02\x02\x02\xDF\xE0\x03" +
-		"\x02\x02\x02\xE0\xE1\x07\x13\x02\x02\xE1\u0107\x03\x02\x02\x02\xE2\u0107" +
-		"\x05&\x14\x02\xE3\xE4\x07\x17\x02\x02\xE4\xE5\x07F\x02\x02\xE5\u0107\x05" +
-		"(\x15\x02\xE6\xE7\x07\x1A\x02\x02\xE7\xE8\x07\x18\x02\x02\xE8\xE9\x05" +
-		"*\x16\x02\xE9\xEA\x07\x19\x02\x02\xEA\xEB\t\x03\x02\x02\xEB\u0107\x03" +
-		"\x02\x02\x02\xEC\xED\x07 \x02\x02\xED\xEE\x07\x18\x02\x02\xEE\xEF\x05" +
-		"*\x16\x02\xEF\xF0\x07\x19\x02\x02\xF0\xF1\t\x04\x02\x02\xF1\u0107\x03" +
-		"\x02\x02\x02\xF2\xF3\t\x05\x02\x02\xF3\u0107\x05*\x16\x10\xF4\u0100\x07" +
-		"\x18\x02\x02\xF5\xFA\x05*\x16\x02\xF6\xF7\x07\x12\x02\x02\xF7\xF9\x05" +
-		"*\x16\x02\xF8\xF6\x03\x02\x02\x02\xF9\xFC\x03\x02\x02\x02\xFA\xF8\x03" +
-		"\x02\x02\x02\xFA\xFB\x03\x02\x02\x02\xFB\xFE\x03\x02\x02\x02\xFC\xFA\x03" +
-		"\x02\x02\x02\xFD\xFF\x07\x12\x02\x02\xFE\xFD\x03\x02\x02\x02\xFE\xFF\x03" +
-		"\x02\x02\x02\xFF\u0101\x03\x02\x02\x02\u0100\xF5\x03\x02\x02\x02\u0100" +
-		"\u0101\x03\x02\x02\x02\u0101\u0102\x03\x02\x02\x02\u0102\u0107\x07\x19" +
-		"\x02\x02\u0103\u0107\x07E\x02\x02\u0104\u0107\x07F\x02\x02\u0105\u0107" +
-		"\x05.\x18\x02\u0106\xD1\x03\x02\x02\x02\u0106\xD6\x03\x02\x02\x02\u0106" +
-		"\xE2\x03\x02\x02\x02\u0106\xE3\x03\x02\x02\x02\u0106\xE6\x03\x02\x02\x02" +
-		"\u0106\xEC\x03\x02\x02\x02\u0106\xF2\x03\x02\x02\x02\u0106\xF4\x03\x02" +
-		"\x02\x02\u0106\u0103\x03\x02\x02\x02\u0106\u0104\x03\x02\x02\x02\u0106" +
-		"\u0105\x03\x02\x02\x02\u0107\u0131\x03\x02\x02\x02\u0108\u0109\f\x0F\x02" +
-		"\x02\u0109\u010A\t\x06\x02\x02\u010A\u0130\x05*\x16\x10\u010B\u010C\f" +
-		"\x0E\x02\x02\u010C\u010D\t\x07\x02\x02\u010D\u0130\x05*\x16\x0F\u010E" +
-		"\u010F\f\r\x02\x02\u010F\u0110\t\b\x02\x02\u0110\u0130\x05*\x16\x0E\u0111" +
-		"\u0112\f\f\x02\x02\u0112\u0113\t\t\x02\x02\u0113\u0130\x05*\x16\r\u0114" +
-		"\u0115\f\v\x02\x02\u0115\u0116\x070\x02\x02\u0116\u0130\x05*\x16\f\u0117" +
-		"\u0118\f\n\x02\x02\u0118\u0119\x07\x06\x02\x02\u0119\u0130\x05*\x16\v" +
-		"\u011A\u011B\f\t\x02\x02\u011B\u011C\x071\x02\x02\u011C\u0130\x05*\x16" +
-		"\n\u011D\u011E\f\b\x02\x02\u011E\u011F\x072\x02\x02\u011F\u0130\x05*\x16" +
-		"\t\u0120\u0121\f\x07\x02\x02\u0121\u0122\x073\x02\x02\u0122\u0130\x05" +
-		"*\x16\b\u0123\u0124\f\x15\x02\x02\u0124\u0125\x07\x18\x02\x02\u0125\u0126" +
-		"\x07>\x02\x02\u0126\u0130\x07\x19\x02\x02\u0127\u0128\f\x12\x02\x02\u0128" +
-		"\u0130\t\n\x02\x02\u0129\u012A\f\x11\x02\x02\u012A\u012B\x07\'\x02\x02" +
-		"\u012B\u012C\x07\x11\x02\x02\u012C\u012D\x05*\x16\x02\u012D\u012E\x07" +
-		"\x13\x02\x02\u012E\u0130\x03\x02\x02\x02\u012F\u0108\x03\x02\x02\x02\u012F" +
-		"\u010B\x03\x02\x02\x02\u012F\u010E\x03\x02\x02\x02\u012F\u0111\x03\x02" +
-		"\x02\x02\u012F\u0114\x03\x02\x02\x02\u012F\u0117\x03\x02\x02\x02\u012F" +
-		"\u011A\x03\x02\x02\x02\u012F\u011D\x03\x02\x02\x02\u012F\u0120\x03\x02" +
-		"\x02\x02\u012F\u0123\x03\x02\x02\x02\u012F\u0127\x03\x02\x02\x02\u012F" +
-		"\u0129\x03\x02\x02\x02\u0130\u0133\x03\x02\x02\x02\u0131\u012F\x03\x02" +
-		"\x02\x02\u0131\u0132\x03\x02\x02\x02\u0132+\x03\x02\x02\x02\u0133\u0131" +
-		"\x03\x02\x02\x02\u0134\u0135\x074\x02\x02\u0135-\x03\x02\x02\x02\u0136" +
-		"\u013C\x07<\x02\x02\u0137\u013C\x050\x19\x02\u0138\u013C\x07A\x02\x02" +
-		"\u0139\u013C\x07B\x02\x02\u013A\u013C\x07C\x02\x02\u013B\u0136\x03\x02" +
-		"\x02\x02\u013B\u0137\x03\x02\x02\x02\u013B\u0138\x03\x02\x02\x02\u013B" +
-		"\u0139\x03\x02\x02\x02\u013B\u013A\x03\x02\x02\x02\u013C/\x03\x02\x02" +
-		"\x02\u013D\u013F\x07>\x02\x02\u013E\u0140\x07=\x02\x02\u013F\u013E\x03" +
-		"\x02\x02\x02\u013F\u0140\x03\x02\x02\x02\u01401\x03\x02\x02\x02\u0141" +
-		"\u0142\t\v\x02\x02\u01423\x03\x02\x02\x02\x1C7FIVbmqs~\x83\x8B\x91\xBC" +
-		"\xC7\xCB\xCD\xDB\xDE\xFA\xFE\u0100\u0106\u012F\u0131\u013B\u013F";
-	public static __ATN: ATN;
+	public static readonly _serializedATN: number[] = [4,1,71,322,2,0,7,0,2,
+	1,7,1,2,2,7,2,2,3,7,3,2,4,7,4,2,5,7,5,2,6,7,6,2,7,7,7,2,8,7,8,2,9,7,9,2,
+	10,7,10,2,11,7,11,2,12,7,12,2,13,7,13,2,14,7,14,2,15,7,15,2,16,7,16,2,17,
+	7,17,2,18,7,18,2,19,7,19,2,20,7,20,2,21,7,21,2,22,7,22,2,23,7,23,2,24,7,
+	24,1,0,5,0,52,8,0,10,0,12,0,55,9,0,1,0,1,0,1,0,1,1,1,1,1,1,1,1,1,1,1,2,
+	1,2,1,3,1,3,3,3,69,8,3,1,4,3,4,72,8,4,1,4,1,4,1,5,1,5,1,6,1,6,1,6,1,6,1,
+	6,5,6,83,8,6,10,6,12,6,86,9,6,1,6,1,6,1,7,1,7,1,7,1,7,1,7,5,7,95,8,7,10,
+	7,12,7,98,9,7,1,7,1,7,1,8,1,8,1,8,1,8,5,8,106,8,8,10,8,12,8,109,9,8,1,8,
+	3,8,112,8,8,3,8,114,8,8,1,8,1,8,1,9,1,9,1,9,1,10,1,10,5,10,123,8,10,10,
+	10,12,10,126,9,10,1,10,1,10,3,10,130,8,10,1,11,1,11,1,11,1,11,1,11,1,11,
+	3,11,138,8,11,1,12,1,12,5,12,142,8,12,10,12,12,12,145,9,12,1,12,1,12,1,
+	12,1,12,1,12,1,13,1,13,1,13,1,13,1,13,1,13,1,13,1,13,1,13,1,14,1,14,1,14,
+	1,14,1,14,1,15,1,15,1,15,1,15,1,15,1,15,1,15,1,15,1,16,1,16,1,16,1,16,1,
+	16,1,16,1,17,1,17,1,17,1,17,1,17,1,17,1,17,3,17,187,8,17,1,18,1,18,1,18,
+	1,19,1,19,1,19,1,19,5,19,196,8,19,10,19,12,19,199,9,19,1,19,3,19,202,8,
+	19,3,19,204,8,19,1,19,1,19,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,
+	1,20,3,20,218,8,20,1,20,3,20,221,8,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,
+	1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,
+	20,1,20,1,20,5,20,247,8,20,10,20,12,20,250,9,20,1,20,3,20,253,8,20,3,20,
+	255,8,20,1,20,1,20,1,20,1,20,3,20,261,8,20,1,20,1,20,1,20,1,20,1,20,1,20,
+	1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,
+	20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,
+	1,20,1,20,1,20,1,20,5,20,302,8,20,10,20,12,20,305,9,20,1,21,1,21,1,22,1,
+	22,1,22,1,22,1,22,3,22,314,8,22,1,23,1,23,3,23,318,8,23,1,24,1,24,1,24,
+	0,1,40,25,0,2,4,6,8,10,12,14,16,18,20,22,24,26,28,30,32,34,36,38,40,42,
+	44,46,48,0,10,1,0,4,10,1,0,25,29,2,0,25,29,31,34,1,0,38,39,1,0,40,42,2,
+	0,39,39,43,43,1,0,6,9,1,0,44,45,1,0,35,36,2,0,51,56,61,61,348,0,53,1,0,
+	0,0,2,59,1,0,0,0,4,64,1,0,0,0,6,66,1,0,0,0,8,71,1,0,0,0,10,75,1,0,0,0,12,
+	77,1,0,0,0,14,89,1,0,0,0,16,101,1,0,0,0,18,117,1,0,0,0,20,129,1,0,0,0,22,
+	137,1,0,0,0,24,139,1,0,0,0,26,151,1,0,0,0,28,160,1,0,0,0,30,165,1,0,0,0,
+	32,173,1,0,0,0,34,179,1,0,0,0,36,188,1,0,0,0,38,191,1,0,0,0,40,260,1,0,
+	0,0,42,306,1,0,0,0,44,313,1,0,0,0,46,315,1,0,0,0,48,319,1,0,0,0,50,52,3,
+	2,1,0,51,50,1,0,0,0,52,55,1,0,0,0,53,51,1,0,0,0,53,54,1,0,0,0,54,56,1,0,
+	0,0,55,53,1,0,0,0,56,57,3,12,6,0,57,58,5,0,0,1,58,1,1,0,0,0,59,60,5,1,0,
+	0,60,61,3,4,2,0,61,62,3,6,3,0,62,63,5,2,0,0,63,3,1,0,0,0,64,65,5,3,0,0,
+	65,5,1,0,0,0,66,68,3,8,4,0,67,69,3,8,4,0,68,67,1,0,0,0,68,69,1,0,0,0,69,
+	7,1,0,0,0,70,72,3,10,5,0,71,70,1,0,0,0,71,72,1,0,0,0,72,73,1,0,0,0,73,74,
+	5,57,0,0,74,9,1,0,0,0,75,76,7,0,0,0,76,11,1,0,0,0,77,78,5,11,0,0,78,79,
+	5,68,0,0,79,80,3,16,8,0,80,84,5,12,0,0,81,83,3,14,7,0,82,81,1,0,0,0,83,
+	86,1,0,0,0,84,82,1,0,0,0,84,85,1,0,0,0,85,87,1,0,0,0,86,84,1,0,0,0,87,88,
+	5,13,0,0,88,13,1,0,0,0,89,90,5,14,0,0,90,91,5,68,0,0,91,92,3,16,8,0,92,
+	96,5,12,0,0,93,95,3,22,11,0,94,93,1,0,0,0,95,98,1,0,0,0,96,94,1,0,0,0,96,
+	97,1,0,0,0,97,99,1,0,0,0,98,96,1,0,0,0,99,100,5,13,0,0,100,15,1,0,0,0,101,
+	113,5,15,0,0,102,107,3,18,9,0,103,104,5,16,0,0,104,106,3,18,9,0,105,103,
+	1,0,0,0,106,109,1,0,0,0,107,105,1,0,0,0,107,108,1,0,0,0,108,111,1,0,0,0,
+	109,107,1,0,0,0,110,112,5,16,0,0,111,110,1,0,0,0,111,112,1,0,0,0,112,114,
+	1,0,0,0,113,102,1,0,0,0,113,114,1,0,0,0,114,115,1,0,0,0,115,116,5,17,0,
+	0,116,17,1,0,0,0,117,118,3,48,24,0,118,119,5,68,0,0,119,19,1,0,0,0,120,
+	124,5,12,0,0,121,123,3,22,11,0,122,121,1,0,0,0,123,126,1,0,0,0,124,122,
+	1,0,0,0,124,125,1,0,0,0,125,127,1,0,0,0,126,124,1,0,0,0,127,130,5,13,0,
+	0,128,130,3,22,11,0,129,120,1,0,0,0,129,128,1,0,0,0,130,21,1,0,0,0,131,
+	138,3,24,12,0,132,138,3,26,13,0,133,138,3,28,14,0,134,138,3,30,15,0,135,
+	138,3,32,16,0,136,138,3,34,17,0,137,131,1,0,0,0,137,132,1,0,0,0,137,133,
+	1,0,0,0,137,134,1,0,0,0,137,135,1,0,0,0,137,136,1,0,0,0,138,23,1,0,0,0,
+	139,143,3,48,24,0,140,142,3,42,21,0,141,140,1,0,0,0,142,145,1,0,0,0,143,
+	141,1,0,0,0,143,144,1,0,0,0,144,146,1,0,0,0,145,143,1,0,0,0,146,147,5,68,
+	0,0,147,148,5,10,0,0,148,149,3,40,20,0,149,150,5,2,0,0,150,25,1,0,0,0,151,
+	152,3,48,24,0,152,153,5,68,0,0,153,154,5,16,0,0,154,155,3,48,24,0,155,156,
+	5,68,0,0,156,157,5,10,0,0,157,158,3,40,20,0,158,159,5,2,0,0,159,27,1,0,
+	0,0,160,161,5,68,0,0,161,162,5,10,0,0,162,163,3,40,20,0,163,164,5,2,0,0,
+	164,29,1,0,0,0,165,166,5,18,0,0,166,167,5,15,0,0,167,168,5,66,0,0,168,169,
+	5,6,0,0,169,170,3,40,20,0,170,171,5,17,0,0,171,172,5,2,0,0,172,31,1,0,0,
+	0,173,174,5,18,0,0,174,175,5,15,0,0,175,176,3,40,20,0,176,177,5,17,0,0,
+	177,178,5,2,0,0,178,33,1,0,0,0,179,180,5,19,0,0,180,181,5,15,0,0,181,182,
+	3,40,20,0,182,183,5,17,0,0,183,186,3,20,10,0,184,185,5,20,0,0,185,187,3,
+	20,10,0,186,184,1,0,0,0,186,187,1,0,0,0,187,35,1,0,0,0,188,189,5,68,0,0,
+	189,190,3,38,19,0,190,37,1,0,0,0,191,203,5,15,0,0,192,197,3,40,20,0,193,
+	194,5,16,0,0,194,196,3,40,20,0,195,193,1,0,0,0,196,199,1,0,0,0,197,195,
+	1,0,0,0,197,198,1,0,0,0,198,201,1,0,0,0,199,197,1,0,0,0,200,202,5,16,0,
+	0,201,200,1,0,0,0,201,202,1,0,0,0,202,204,1,0,0,0,203,192,1,0,0,0,203,204,
+	1,0,0,0,204,205,1,0,0,0,205,206,5,17,0,0,206,39,1,0,0,0,207,208,6,20,-1,
+	0,208,209,5,15,0,0,209,210,3,40,20,0,210,211,5,17,0,0,211,261,1,0,0,0,212,
+	213,3,48,24,0,213,214,5,15,0,0,214,217,3,40,20,0,215,216,5,16,0,0,216,218,
+	3,40,20,0,217,215,1,0,0,0,217,218,1,0,0,0,218,220,1,0,0,0,219,221,5,16,
+	0,0,220,219,1,0,0,0,220,221,1,0,0,0,221,222,1,0,0,0,222,223,5,17,0,0,223,
+	261,1,0,0,0,224,261,3,36,18,0,225,226,5,21,0,0,226,227,5,68,0,0,227,261,
+	3,38,19,0,228,229,5,24,0,0,229,230,5,22,0,0,230,231,3,40,20,0,231,232,5,
+	23,0,0,232,233,7,1,0,0,233,261,1,0,0,0,234,235,5,30,0,0,235,236,5,22,0,
+	0,236,237,3,40,20,0,237,238,5,23,0,0,238,239,7,2,0,0,239,261,1,0,0,0,240,
+	241,7,3,0,0,241,261,3,40,20,14,242,254,5,22,0,0,243,248,3,40,20,0,244,245,
+	5,16,0,0,245,247,3,40,20,0,246,244,1,0,0,0,247,250,1,0,0,0,248,246,1,0,
+	0,0,248,249,1,0,0,0,249,252,1,0,0,0,250,248,1,0,0,0,251,253,5,16,0,0,252,
+	251,1,0,0,0,252,253,1,0,0,0,253,255,1,0,0,0,254,243,1,0,0,0,254,255,1,0,
+	0,0,255,256,1,0,0,0,256,261,5,23,0,0,257,261,5,67,0,0,258,261,5,68,0,0,
+	259,261,3,44,22,0,260,207,1,0,0,0,260,212,1,0,0,0,260,224,1,0,0,0,260,225,
+	1,0,0,0,260,228,1,0,0,0,260,234,1,0,0,0,260,240,1,0,0,0,260,242,1,0,0,0,
+	260,257,1,0,0,0,260,258,1,0,0,0,260,259,1,0,0,0,261,303,1,0,0,0,262,263,
+	10,13,0,0,263,264,7,4,0,0,264,302,3,40,20,14,265,266,10,12,0,0,266,267,
+	7,5,0,0,267,302,3,40,20,13,268,269,10,11,0,0,269,270,7,6,0,0,270,302,3,
+	40,20,12,271,272,10,10,0,0,272,273,7,7,0,0,273,302,3,40,20,11,274,275,10,
+	9,0,0,275,276,5,46,0,0,276,302,3,40,20,10,277,278,10,8,0,0,278,279,5,4,
+	0,0,279,302,3,40,20,9,280,281,10,7,0,0,281,282,5,47,0,0,282,302,3,40,20,
+	8,283,284,10,6,0,0,284,285,5,48,0,0,285,302,3,40,20,7,286,287,10,5,0,0,
+	287,288,5,49,0,0,288,302,3,40,20,6,289,290,10,19,0,0,290,291,5,22,0,0,291,
+	292,5,60,0,0,292,302,5,23,0,0,293,294,10,16,0,0,294,302,7,8,0,0,295,296,
+	10,15,0,0,296,297,5,37,0,0,297,298,5,15,0,0,298,299,3,40,20,0,299,300,5,
+	17,0,0,300,302,1,0,0,0,301,262,1,0,0,0,301,265,1,0,0,0,301,268,1,0,0,0,
+	301,271,1,0,0,0,301,274,1,0,0,0,301,277,1,0,0,0,301,280,1,0,0,0,301,283,
+	1,0,0,0,301,286,1,0,0,0,301,289,1,0,0,0,301,293,1,0,0,0,301,295,1,0,0,0,
+	302,305,1,0,0,0,303,301,1,0,0,0,303,304,1,0,0,0,304,41,1,0,0,0,305,303,
+	1,0,0,0,306,307,5,50,0,0,307,43,1,0,0,0,308,314,5,58,0,0,309,314,3,46,23,
+	0,310,314,5,63,0,0,311,314,5,64,0,0,312,314,5,65,0,0,313,308,1,0,0,0,313,
+	309,1,0,0,0,313,310,1,0,0,0,313,311,1,0,0,0,313,312,1,0,0,0,314,45,1,0,
+	0,0,315,317,5,60,0,0,316,318,5,59,0,0,317,316,1,0,0,0,317,318,1,0,0,0,318,
+	47,1,0,0,0,319,320,7,9,0,0,320,49,1,0,0,0,26,53,68,71,84,96,107,111,113,
+	124,129,137,143,186,197,201,203,217,220,248,252,254,260,301,303,313,317];
+
+	private static __ATN: ATN;
 	public static get _ATN(): ATN {
 		if (!CashScriptParser.__ATN) {
-			CashScriptParser.__ATN = new ATNDeserializer().deserialize(Utils.toCharArray(CashScriptParser._serializedATN));
+			CashScriptParser.__ATN = new ATNDeserializer().deserialize(CashScriptParser._serializedATN);
 		}
 
 		return CashScriptParser.__ATN;
 	}
 
+
+	static DecisionsToDFA = CashScriptParser._ATN.decisionToState.map( (ds: DecisionState, index: number) => new DFA(ds, index) );
+
 }
 
 export class SourceFileContext extends ParserRuleContext {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
 	public contractDefinition(): ContractDefinitionContext {
-		return this.getRuleContext(0, ContractDefinitionContext);
-	}
-	public EOF(): TerminalNode { return this.getToken(CashScriptParser.EOF, 0); }
-	public pragmaDirective(): PragmaDirectiveContext[];
-	public pragmaDirective(i: number): PragmaDirectiveContext;
-	public pragmaDirective(i?: number): PragmaDirectiveContext | PragmaDirectiveContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(PragmaDirectiveContext);
-		} else {
-			return this.getRuleContext(i, PragmaDirectiveContext);
-		}
+		return this.getTypedRuleContext(ContractDefinitionContext, 0) as ContractDefinitionContext;
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+	public EOF(): TerminalNode {
+		return this.getToken(CashScriptParser.EOF, 0);
+	}
+	public pragmaDirective_list(): PragmaDirectiveContext[] {
+		return this.getTypedRuleContexts(PragmaDirectiveContext) as PragmaDirectiveContext[];
+	}
+	public pragmaDirective(i: number): PragmaDirectiveContext {
+		return this.getTypedRuleContext(PragmaDirectiveContext, i) as PragmaDirectiveContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_sourceFile;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_sourceFile; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitSourceFile) {
@@ -1990,18 +1914,20 @@ export class SourceFileContext extends ParserRuleContext {
 
 
 export class PragmaDirectiveContext extends ParserRuleContext {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
 	public pragmaName(): PragmaNameContext {
-		return this.getRuleContext(0, PragmaNameContext);
+		return this.getTypedRuleContext(PragmaNameContext, 0) as PragmaNameContext;
 	}
 	public pragmaValue(): PragmaValueContext {
-		return this.getRuleContext(0, PragmaValueContext);
+		return this.getTypedRuleContext(PragmaValueContext, 0) as PragmaValueContext;
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_pragmaDirective;
 	}
 	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_pragmaDirective; }
-	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitPragmaDirective) {
 			return visitor.visitPragmaDirective(this);
@@ -2013,11 +1939,13 @@ export class PragmaDirectiveContext extends ParserRuleContext {
 
 
 export class PragmaNameContext extends ParserRuleContext {
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_pragmaName;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_pragmaName; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitPragmaName) {
@@ -2030,20 +1958,19 @@ export class PragmaNameContext extends ParserRuleContext {
 
 
 export class PragmaValueContext extends ParserRuleContext {
-	public versionConstraint(): VersionConstraintContext[];
-	public versionConstraint(i: number): VersionConstraintContext;
-	public versionConstraint(i?: number): VersionConstraintContext | VersionConstraintContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(VersionConstraintContext);
-		} else {
-			return this.getRuleContext(i, VersionConstraintContext);
-		}
-	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public versionConstraint_list(): VersionConstraintContext[] {
+		return this.getTypedRuleContexts(VersionConstraintContext) as VersionConstraintContext[];
+	}
+	public versionConstraint(i: number): VersionConstraintContext {
+		return this.getTypedRuleContext(VersionConstraintContext, i) as VersionConstraintContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_pragmaValue;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_pragmaValue; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitPragmaValue) {
@@ -2056,15 +1983,19 @@ export class PragmaValueContext extends ParserRuleContext {
 
 
 export class VersionConstraintContext extends ParserRuleContext {
-	public VersionLiteral(): TerminalNode { return this.getToken(CashScriptParser.VersionLiteral, 0); }
-	public versionOperator(): VersionOperatorContext | undefined {
-		return this.tryGetRuleContext(0, VersionOperatorContext);
-	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public VersionLiteral(): TerminalNode {
+		return this.getToken(CashScriptParser.VersionLiteral, 0);
+	}
+	public versionOperator(): VersionOperatorContext {
+		return this.getTypedRuleContext(VersionOperatorContext, 0) as VersionOperatorContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_versionConstraint;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_versionConstraint; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitVersionConstraint) {
@@ -2077,11 +2008,13 @@ export class VersionConstraintContext extends ParserRuleContext {
 
 
 export class VersionOperatorContext extends ParserRuleContext {
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_versionOperator;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_versionOperator; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitVersionOperator) {
@@ -2094,24 +2027,25 @@ export class VersionOperatorContext extends ParserRuleContext {
 
 
 export class ContractDefinitionContext extends ParserRuleContext {
-	public Identifier(): TerminalNode { return this.getToken(CashScriptParser.Identifier, 0); }
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public Identifier(): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, 0);
+	}
 	public parameterList(): ParameterListContext {
-		return this.getRuleContext(0, ParameterListContext);
+		return this.getTypedRuleContext(ParameterListContext, 0) as ParameterListContext;
 	}
-	public functionDefinition(): FunctionDefinitionContext[];
-	public functionDefinition(i: number): FunctionDefinitionContext;
-	public functionDefinition(i?: number): FunctionDefinitionContext | FunctionDefinitionContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(FunctionDefinitionContext);
-		} else {
-			return this.getRuleContext(i, FunctionDefinitionContext);
-		}
+	public functionDefinition_list(): FunctionDefinitionContext[] {
+		return this.getTypedRuleContexts(FunctionDefinitionContext) as FunctionDefinitionContext[];
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+	public functionDefinition(i: number): FunctionDefinitionContext {
+		return this.getTypedRuleContext(FunctionDefinitionContext, i) as FunctionDefinitionContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_contractDefinition;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_contractDefinition; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitContractDefinition) {
@@ -2124,24 +2058,25 @@ export class ContractDefinitionContext extends ParserRuleContext {
 
 
 export class FunctionDefinitionContext extends ParserRuleContext {
-	public Identifier(): TerminalNode { return this.getToken(CashScriptParser.Identifier, 0); }
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public Identifier(): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, 0);
+	}
 	public parameterList(): ParameterListContext {
-		return this.getRuleContext(0, ParameterListContext);
+		return this.getTypedRuleContext(ParameterListContext, 0) as ParameterListContext;
 	}
-	public statement(): StatementContext[];
-	public statement(i: number): StatementContext;
-	public statement(i?: number): StatementContext | StatementContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(StatementContext);
-		} else {
-			return this.getRuleContext(i, StatementContext);
-		}
+	public statement_list(): StatementContext[] {
+		return this.getTypedRuleContexts(StatementContext) as StatementContext[];
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+	public statement(i: number): StatementContext {
+		return this.getTypedRuleContext(StatementContext, i) as StatementContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_functionDefinition;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_functionDefinition; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitFunctionDefinition) {
@@ -2154,20 +2089,19 @@ export class FunctionDefinitionContext extends ParserRuleContext {
 
 
 export class ParameterListContext extends ParserRuleContext {
-	public parameter(): ParameterContext[];
-	public parameter(i: number): ParameterContext;
-	public parameter(i?: number): ParameterContext | ParameterContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(ParameterContext);
-		} else {
-			return this.getRuleContext(i, ParameterContext);
-		}
-	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public parameter_list(): ParameterContext[] {
+		return this.getTypedRuleContexts(ParameterContext) as ParameterContext[];
+	}
+	public parameter(i: number): ParameterContext {
+		return this.getTypedRuleContext(ParameterContext, i) as ParameterContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_parameterList;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_parameterList; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitParameterList) {
@@ -2180,15 +2114,19 @@ export class ParameterListContext extends ParserRuleContext {
 
 
 export class ParameterContext extends ParserRuleContext {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
 	public typeName(): TypeNameContext {
-		return this.getRuleContext(0, TypeNameContext);
+		return this.getTypedRuleContext(TypeNameContext, 0) as TypeNameContext;
 	}
-	public Identifier(): TerminalNode { return this.getToken(CashScriptParser.Identifier, 0); }
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+	public Identifier(): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, 0);
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_parameter;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_parameter; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitParameter) {
@@ -2201,20 +2139,19 @@ export class ParameterContext extends ParserRuleContext {
 
 
 export class BlockContext extends ParserRuleContext {
-	public statement(): StatementContext[];
-	public statement(i: number): StatementContext;
-	public statement(i?: number): StatementContext | StatementContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(StatementContext);
-		} else {
-			return this.getRuleContext(i, StatementContext);
-		}
-	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public statement_list(): StatementContext[] {
+		return this.getTypedRuleContexts(StatementContext) as StatementContext[];
+	}
+	public statement(i: number): StatementContext {
+		return this.getTypedRuleContext(StatementContext, i) as StatementContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_block;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_block; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitBlock) {
@@ -2227,29 +2164,31 @@ export class BlockContext extends ParserRuleContext {
 
 
 export class StatementContext extends ParserRuleContext {
-	public variableDefinition(): VariableDefinitionContext | undefined {
-		return this.tryGetRuleContext(0, VariableDefinitionContext);
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
 	}
-	public tupleAssignment(): TupleAssignmentContext | undefined {
-		return this.tryGetRuleContext(0, TupleAssignmentContext);
+	public variableDefinition(): VariableDefinitionContext {
+		return this.getTypedRuleContext(VariableDefinitionContext, 0) as VariableDefinitionContext;
 	}
-	public assignStatement(): AssignStatementContext | undefined {
-		return this.tryGetRuleContext(0, AssignStatementContext);
+	public tupleAssignment(): TupleAssignmentContext {
+		return this.getTypedRuleContext(TupleAssignmentContext, 0) as TupleAssignmentContext;
 	}
-	public timeOpStatement(): TimeOpStatementContext | undefined {
-		return this.tryGetRuleContext(0, TimeOpStatementContext);
+	public assignStatement(): AssignStatementContext {
+		return this.getTypedRuleContext(AssignStatementContext, 0) as AssignStatementContext;
 	}
-	public requireStatement(): RequireStatementContext | undefined {
-		return this.tryGetRuleContext(0, RequireStatementContext);
+	public timeOpStatement(): TimeOpStatementContext {
+		return this.getTypedRuleContext(TimeOpStatementContext, 0) as TimeOpStatementContext;
 	}
-	public ifStatement(): IfStatementContext | undefined {
-		return this.tryGetRuleContext(0, IfStatementContext);
+	public requireStatement(): RequireStatementContext {
+		return this.getTypedRuleContext(RequireStatementContext, 0) as RequireStatementContext;
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+	public ifStatement(): IfStatementContext {
+		return this.getTypedRuleContext(IfStatementContext, 0) as IfStatementContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_statement;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_statement; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitStatement) {
@@ -2262,27 +2201,28 @@ export class StatementContext extends ParserRuleContext {
 
 
 export class VariableDefinitionContext extends ParserRuleContext {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
 	public typeName(): TypeNameContext {
-		return this.getRuleContext(0, TypeNameContext);
+		return this.getTypedRuleContext(TypeNameContext, 0) as TypeNameContext;
+	}
+	public Identifier(): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, 0);
 	}
-	public Identifier(): TerminalNode { return this.getToken(CashScriptParser.Identifier, 0); }
 	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
-	public modifier(): ModifierContext[];
-	public modifier(i: number): ModifierContext;
-	public modifier(i?: number): ModifierContext | ModifierContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(ModifierContext);
-		} else {
-			return this.getRuleContext(i, ModifierContext);
-		}
+	public modifier_list(): ModifierContext[] {
+		return this.getTypedRuleContexts(ModifierContext) as ModifierContext[];
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+	public modifier(i: number): ModifierContext {
+		return this.getTypedRuleContext(ModifierContext, i) as ModifierContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_variableDefinition;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_variableDefinition; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitVariableDefinition) {
@@ -2295,33 +2235,29 @@ export class VariableDefinitionContext extends ParserRuleContext {
 
 
 export class TupleAssignmentContext extends ParserRuleContext {
-	public typeName(): TypeNameContext[];
-	public typeName(i: number): TypeNameContext;
-	public typeName(i?: number): TypeNameContext | TypeNameContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(TypeNameContext);
-		} else {
-			return this.getRuleContext(i, TypeNameContext);
-		}
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
 	}
-	public Identifier(): TerminalNode[];
-	public Identifier(i: number): TerminalNode;
-	public Identifier(i?: number): TerminalNode | TerminalNode[] {
-		if (i === undefined) {
-			return this.getTokens(CashScriptParser.Identifier);
-		} else {
-			return this.getToken(CashScriptParser.Identifier, i);
-		}
+	public typeName_list(): TypeNameContext[] {
+		return this.getTypedRuleContexts(TypeNameContext) as TypeNameContext[];
+	}
+	public typeName(i: number): TypeNameContext {
+		return this.getTypedRuleContext(TypeNameContext, i) as TypeNameContext;
+	}
+	public Identifier_list(): TerminalNode[] {
+	    	return this.getTokens(CashScriptParser.Identifier);
+	}
+	public Identifier(i: number): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, i);
 	}
 	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_tupleAssignment;
 	}
 	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_tupleAssignment; }
-	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitTupleAssignment) {
 			return visitor.visitTupleAssignment(this);
@@ -2333,16 +2269,20 @@ export class TupleAssignmentContext extends ParserRuleContext {
 
 
 export class AssignStatementContext extends ParserRuleContext {
-	public Identifier(): TerminalNode { return this.getToken(CashScriptParser.Identifier, 0); }
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public Identifier(): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, 0);
+	}
 	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_assignStatement;
 	}
 	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_assignStatement; }
-	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitAssignStatement) {
 			return visitor.visitAssignStatement(this);
@@ -2354,16 +2294,20 @@ export class AssignStatementContext extends ParserRuleContext {
 
 
 export class TimeOpStatementContext extends ParserRuleContext {
-	public TxVar(): TerminalNode { return this.getToken(CashScriptParser.TxVar, 0); }
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public TxVar(): TerminalNode {
+		return this.getToken(CashScriptParser.TxVar, 0);
+	}
 	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_timeOpStatement;
 	}
 	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_timeOpStatement; }
-	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitTimeOpStatement) {
 			return visitor.visitTimeOpStatement(this);
@@ -2375,15 +2319,17 @@ export class TimeOpStatementContext extends ParserRuleContext {
 
 
 export class RequireStatementContext extends ParserRuleContext {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
 	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_requireStatement;
 	}
 	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_requireStatement; }
-	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitRequireStatement) {
 			return visitor.visitRequireStatement(this);
@@ -2397,23 +2343,22 @@ export class RequireStatementContext extends ParserRuleContext {
 export class IfStatementContext extends ParserRuleContext {
 	public _ifBlock!: BlockContext;
 	public _elseBlock!: BlockContext;
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
 	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
-	public block(): BlockContext[];
-	public block(i: number): BlockContext;
-	public block(i?: number): BlockContext | BlockContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(BlockContext);
-		} else {
-			return this.getRuleContext(i, BlockContext);
-		}
+	public block_list(): BlockContext[] {
+		return this.getTypedRuleContexts(BlockContext) as BlockContext[];
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+	public block(i: number): BlockContext {
+		return this.getTypedRuleContext(BlockContext, i) as BlockContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_ifStatement;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_ifStatement; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitIfStatement) {
@@ -2426,16 +2371,20 @@ export class IfStatementContext extends ParserRuleContext {
 
 
 export class FunctionCallContext extends ParserRuleContext {
-	public Identifier(): TerminalNode { return this.getToken(CashScriptParser.Identifier, 0); }
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public Identifier(): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, 0);
+	}
 	public expressionList(): ExpressionListContext {
-		return this.getRuleContext(0, ExpressionListContext);
+		return this.getTypedRuleContext(ExpressionListContext, 0) as ExpressionListContext;
 	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
-		super(parent, invokingState);
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_functionCall;
 	}
 	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_functionCall; }
-	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitFunctionCall) {
 			return visitor.visitFunctionCall(this);
@@ -2447,20 +2396,19 @@ export class FunctionCallContext extends ParserRuleContext {
 
 
 export class ExpressionListContext extends ParserRuleContext {
-	public expression(): ExpressionContext[];
-	public expression(i: number): ExpressionContext;
-	public expression(i?: number): ExpressionContext | ExpressionContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(ExpressionContext);
-		} else {
-			return this.getRuleContext(i, ExpressionContext);
-		}
-	}
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public expression_list(): ExpressionContext[] {
+		return this.getTypedRuleContexts(ExpressionContext) as ExpressionContext[];
+	}
+	public expression(i: number): ExpressionContext {
+		return this.getTypedRuleContext(ExpressionContext, i) as ExpressionContext;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_expressionList;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_expressionList; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitExpressionList) {
@@ -2473,205 +2421,198 @@ export class ExpressionListContext extends ParserRuleContext {
 
 
 export class ExpressionContext extends ParserRuleContext {
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_expression;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_expression; }
 	public copyFrom(ctx: ExpressionContext): void {
 		super.copyFrom(ctx);
 	}
 }
-export class ParenthesisedContext extends ExpressionContext {
-	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+export class CastContext extends ExpressionContext {
+	public _castable!: ExpressionContext;
+	public _size!: ExpressionContext;
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
 	}
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public typeName(): TypeNameContext {
+		return this.getTypedRuleContext(TypeNameContext, 0) as TypeNameContext;
+	}
+	public expression_list(): ExpressionContext[] {
+		return this.getTypedRuleContexts(ExpressionContext) as ExpressionContext[];
+	}
+	public expression(i: number): ExpressionContext {
+		return this.getTypedRuleContext(ExpressionContext, i) as ExpressionContext;
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitParenthesised) {
-			return visitor.visitParenthesised(this);
+		if (visitor.visitCast) {
+			return visitor.visitCast(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
-export class CastContext extends ExpressionContext {
-	public _castable!: ExpressionContext;
-	public _size!: ExpressionContext;
-	public typeName(): TypeNameContext {
-		return this.getRuleContext(0, TypeNameContext);
-	}
-	public expression(): ExpressionContext[];
-	public expression(i: number): ExpressionContext;
-	public expression(i?: number): ExpressionContext | ExpressionContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(ExpressionContext);
-		} else {
-			return this.getRuleContext(i, ExpressionContext);
-		}
+export class UnaryIntrospectionOpContext extends ExpressionContext {
+	public _scope!: Token;
+	public _op!: Token;
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
 	}
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public expression(): ExpressionContext {
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitCast) {
-			return visitor.visitCast(this);
+		if (visitor.visitUnaryIntrospectionOp) {
+			return visitor.visitUnaryIntrospectionOp(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
-export class FunctionCallExpressionContext extends ExpressionContext {
-	public functionCall(): FunctionCallContext {
-		return this.getRuleContext(0, FunctionCallContext);
+export class ArrayContext extends ExpressionContext {
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
+	}
+	public expression_list(): ExpressionContext[] {
+		return this.getTypedRuleContexts(ExpressionContext) as ExpressionContext[];
 	}
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public expression(i: number): ExpressionContext {
+		return this.getTypedRuleContext(ExpressionContext, i) as ExpressionContext;
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitFunctionCallExpression) {
-			return visitor.visitFunctionCallExpression(this);
+		if (visitor.visitArray) {
+			return visitor.visitArray(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
-export class InstantiationContext extends ExpressionContext {
-	public Identifier(): TerminalNode { return this.getToken(CashScriptParser.Identifier, 0); }
-	public expressionList(): ExpressionListContext {
-		return this.getRuleContext(0, ExpressionListContext);
+export class UnaryOpContext extends ExpressionContext {
+	public _op!: Token;
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
 	}
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public expression(): ExpressionContext {
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitInstantiation) {
-			return visitor.visitInstantiation(this);
+		if (visitor.visitUnaryOp) {
+			return visitor.visitUnaryOp(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
-export class TupleIndexOpContext extends ExpressionContext {
-	public _index!: Token;
-	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+export class IdentifierContext extends ExpressionContext {
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
 	}
-	public NumberLiteral(): TerminalNode { return this.getToken(CashScriptParser.NumberLiteral, 0); }
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public Identifier(): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, 0);
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitTupleIndexOp) {
-			return visitor.visitTupleIndexOp(this);
+		if (visitor.visitIdentifier) {
+			return visitor.visitIdentifier(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
-export class UnaryIntrospectionOpContext extends ExpressionContext {
-	public _scope!: Token;
-	public _op!: Token;
-	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+export class LiteralExpressionContext extends ExpressionContext {
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
 	}
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public literal(): LiteralContext {
+		return this.getTypedRuleContext(LiteralContext, 0) as LiteralContext;
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitUnaryIntrospectionOp) {
-			return visitor.visitUnaryIntrospectionOp(this);
+		if (visitor.visitLiteralExpression) {
+			return visitor.visitLiteralExpression(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
-export class UnaryOpContext extends ExpressionContext {
-	public _op!: Token;
+export class TupleIndexOpContext extends ExpressionContext {
+	public _index!: Token;
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
+	}
 	public expression(): ExpressionContext {
-		return this.getRuleContext(0, ExpressionContext);
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public NumberLiteral(): TerminalNode {
+		return this.getToken(CashScriptParser.NumberLiteral, 0);
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitUnaryOp) {
-			return visitor.visitUnaryOp(this);
+		if (visitor.visitTupleIndexOp) {
+			return visitor.visitTupleIndexOp(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
-export class BinaryOpContext extends ExpressionContext {
-	public _left!: ExpressionContext;
-	public _op!: Token;
-	public _right!: ExpressionContext;
-	public expression(): ExpressionContext[];
-	public expression(i: number): ExpressionContext;
-	public expression(i?: number): ExpressionContext | ExpressionContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(ExpressionContext);
-		} else {
-			return this.getRuleContext(i, ExpressionContext);
-		}
+export class InstantiationContext extends ExpressionContext {
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
 	}
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public Identifier(): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, 0);
+	}
+	public expressionList(): ExpressionListContext {
+		return this.getTypedRuleContext(ExpressionListContext, 0) as ExpressionListContext;
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitBinaryOp) {
-			return visitor.visitBinaryOp(this);
+		if (visitor.visitInstantiation) {
+			return visitor.visitInstantiation(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
-export class ArrayContext extends ExpressionContext {
-	public expression(): ExpressionContext[];
-	public expression(i: number): ExpressionContext;
-	public expression(i?: number): ExpressionContext | ExpressionContext[] {
-		if (i === undefined) {
-			return this.getRuleContexts(ExpressionContext);
-		} else {
-			return this.getRuleContext(i, ExpressionContext);
-		}
+export class FunctionCallExpressionContext extends ExpressionContext {
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
 	}
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public functionCall(): FunctionCallContext {
+		return this.getTypedRuleContext(FunctionCallContext, 0) as FunctionCallContext;
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitArray) {
-			return visitor.visitArray(this);
+		if (visitor.visitFunctionCallExpression) {
+			return visitor.visitFunctionCallExpression(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
 export class NullaryOpContext extends ExpressionContext {
-	public NullaryOp(): TerminalNode { return this.getToken(CashScriptParser.NullaryOp, 0); }
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
+	}
+	public NullaryOp(): TerminalNode {
+		return this.getToken(CashScriptParser.NullaryOp, 0);
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
@@ -2682,33 +2623,41 @@ export class NullaryOpContext extends ExpressionContext {
 		}
 	}
 }
-export class IdentifierContext extends ExpressionContext {
-	public Identifier(): TerminalNode { return this.getToken(CashScriptParser.Identifier, 0); }
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+export class ParenthesisedContext extends ExpressionContext {
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
+	}
+	public expression(): ExpressionContext {
+		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitIdentifier) {
-			return visitor.visitIdentifier(this);
+		if (visitor.visitParenthesised) {
+			return visitor.visitParenthesised(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
 	}
 }
-export class LiteralExpressionContext extends ExpressionContext {
-	public literal(): LiteralContext {
-		return this.getRuleContext(0, LiteralContext);
+export class BinaryOpContext extends ExpressionContext {
+	public _left!: ExpressionContext;
+	public _op!: Token;
+	public _right!: ExpressionContext;
+	constructor(parser: CashScriptParser, ctx: ExpressionContext) {
+		super(parser, ctx.parentCtx, ctx.invokingState);
+		super.copyFrom(ctx);
 	}
-	constructor(ctx: ExpressionContext) {
-		super(ctx.parent, ctx.invokingState);
-		this.copyFrom(ctx);
+	public expression_list(): ExpressionContext[] {
+		return this.getTypedRuleContexts(ExpressionContext) as ExpressionContext[];
+	}
+	public expression(i: number): ExpressionContext {
+		return this.getTypedRuleContext(ExpressionContext, i) as ExpressionContext;
 	}
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
-		if (visitor.visitLiteralExpression) {
-			return visitor.visitLiteralExpression(this);
+		if (visitor.visitBinaryOp) {
+			return visitor.visitBinaryOp(this);
 		} else {
 			return visitor.visitChildren(this);
 		}
@@ -2717,11 +2666,13 @@ export class LiteralExpressionContext extends ExpressionContext {
 
 
 export class ModifierContext extends ParserRuleContext {
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_modifier;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_modifier; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitModifier) {
@@ -2734,18 +2685,28 @@ export class ModifierContext extends ParserRuleContext {
 
 
 export class LiteralContext extends ParserRuleContext {
-	public BooleanLiteral(): TerminalNode | undefined { return this.tryGetToken(CashScriptParser.BooleanLiteral, 0); }
-	public numberLiteral(): NumberLiteralContext | undefined {
-		return this.tryGetRuleContext(0, NumberLiteralContext);
-	}
-	public StringLiteral(): TerminalNode | undefined { return this.tryGetToken(CashScriptParser.StringLiteral, 0); }
-	public DateLiteral(): TerminalNode | undefined { return this.tryGetToken(CashScriptParser.DateLiteral, 0); }
-	public HexLiteral(): TerminalNode | undefined { return this.tryGetToken(CashScriptParser.HexLiteral, 0); }
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public BooleanLiteral(): TerminalNode {
+		return this.getToken(CashScriptParser.BooleanLiteral, 0);
+	}
+	public numberLiteral(): NumberLiteralContext {
+		return this.getTypedRuleContext(NumberLiteralContext, 0) as NumberLiteralContext;
+	}
+	public StringLiteral(): TerminalNode {
+		return this.getToken(CashScriptParser.StringLiteral, 0);
+	}
+	public DateLiteral(): TerminalNode {
+		return this.getToken(CashScriptParser.DateLiteral, 0);
+	}
+	public HexLiteral(): TerminalNode {
+		return this.getToken(CashScriptParser.HexLiteral, 0);
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_literal;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_literal; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitLiteral) {
@@ -2758,13 +2719,19 @@ export class LiteralContext extends ParserRuleContext {
 
 
 export class NumberLiteralContext extends ParserRuleContext {
-	public NumberLiteral(): TerminalNode { return this.getToken(CashScriptParser.NumberLiteral, 0); }
-	public NumberUnit(): TerminalNode | undefined { return this.tryGetToken(CashScriptParser.NumberUnit, 0); }
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public NumberLiteral(): TerminalNode {
+		return this.getToken(CashScriptParser.NumberLiteral, 0);
+	}
+	public NumberUnit(): TerminalNode {
+		return this.getToken(CashScriptParser.NumberUnit, 0);
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_numberLiteral;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_numberLiteral; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitNumberLiteral) {
@@ -2777,12 +2744,16 @@ export class NumberLiteralContext extends ParserRuleContext {
 
 
 export class TypeNameContext extends ParserRuleContext {
-	public Bytes(): TerminalNode { return this.getToken(CashScriptParser.Bytes, 0); }
-	constructor(parent: ParserRuleContext | undefined, invokingState: number) {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public Bytes(): TerminalNode {
+		return this.getToken(CashScriptParser.Bytes, 0);
+	}
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_typeName;
 	}
-	// @Override
-	public get ruleIndex(): number { return CashScriptParser.RULE_typeName; }
 	// @Override
 	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
 		if (visitor.visitTypeName) {
@@ -2792,5 +2763,3 @@ export class TypeNameContext extends ParserRuleContext {
 		}
 	}
 }
-
-
diff --git a/packages/cashc/src/grammar/CashScriptVisitor.ts b/packages/cashc/src/grammar/CashScriptVisitor.ts
index d557ffef..f99a0bf0 100644
--- a/packages/cashc/src/grammar/CashScriptVisitor.ts
+++ b/packages/cashc/src/grammar/CashScriptVisitor.ts
@@ -1,45 +1,44 @@
-// Generated from src/grammar/CashScript.g4 by ANTLR 4.9.0-SNAPSHOT
-
-
-import { ParseTreeVisitor } from "antlr4ts/tree/ParseTreeVisitor.js";
-
-import { ParenthesisedContext } from "./CashScriptParser.js";
-import { CastContext } from "./CashScriptParser.js";
-import { FunctionCallExpressionContext } from "./CashScriptParser.js";
-import { InstantiationContext } from "./CashScriptParser.js";
-import { TupleIndexOpContext } from "./CashScriptParser.js";
-import { UnaryIntrospectionOpContext } from "./CashScriptParser.js";
-import { UnaryOpContext } from "./CashScriptParser.js";
-import { BinaryOpContext } from "./CashScriptParser.js";
-import { ArrayContext } from "./CashScriptParser.js";
-import { NullaryOpContext } from "./CashScriptParser.js";
-import { IdentifierContext } from "./CashScriptParser.js";
-import { LiteralExpressionContext } from "./CashScriptParser.js";
-import { SourceFileContext } from "./CashScriptParser.js";
-import { PragmaDirectiveContext } from "./CashScriptParser.js";
-import { PragmaNameContext } from "./CashScriptParser.js";
-import { PragmaValueContext } from "./CashScriptParser.js";
-import { VersionConstraintContext } from "./CashScriptParser.js";
-import { VersionOperatorContext } from "./CashScriptParser.js";
-import { ContractDefinitionContext } from "./CashScriptParser.js";
-import { FunctionDefinitionContext } from "./CashScriptParser.js";
-import { ParameterListContext } from "./CashScriptParser.js";
-import { ParameterContext } from "./CashScriptParser.js";
-import { BlockContext } from "./CashScriptParser.js";
-import { StatementContext } from "./CashScriptParser.js";
-import { VariableDefinitionContext } from "./CashScriptParser.js";
-import { TupleAssignmentContext } from "./CashScriptParser.js";
-import { AssignStatementContext } from "./CashScriptParser.js";
-import { TimeOpStatementContext } from "./CashScriptParser.js";
-import { RequireStatementContext } from "./CashScriptParser.js";
-import { IfStatementContext } from "./CashScriptParser.js";
-import { FunctionCallContext } from "./CashScriptParser.js";
-import { ExpressionListContext } from "./CashScriptParser.js";
-import { ExpressionContext } from "./CashScriptParser.js";
-import { ModifierContext } from "./CashScriptParser.js";
-import { LiteralContext } from "./CashScriptParser.js";
-import { NumberLiteralContext } from "./CashScriptParser.js";
-import { TypeNameContext } from "./CashScriptParser.js";
+// Generated from src/grammar/CashScript.g4 by ANTLR 4.13.1
+
+import {ParseTreeVisitor} from 'antlr4';
+
+
+import { SourceFileContext } from "./CashScriptParser";
+import { PragmaDirectiveContext } from "./CashScriptParser";
+import { PragmaNameContext } from "./CashScriptParser";
+import { PragmaValueContext } from "./CashScriptParser";
+import { VersionConstraintContext } from "./CashScriptParser";
+import { VersionOperatorContext } from "./CashScriptParser";
+import { ContractDefinitionContext } from "./CashScriptParser";
+import { FunctionDefinitionContext } from "./CashScriptParser";
+import { ParameterListContext } from "./CashScriptParser";
+import { ParameterContext } from "./CashScriptParser";
+import { BlockContext } from "./CashScriptParser";
+import { StatementContext } from "./CashScriptParser";
+import { VariableDefinitionContext } from "./CashScriptParser";
+import { TupleAssignmentContext } from "./CashScriptParser";
+import { AssignStatementContext } from "./CashScriptParser";
+import { TimeOpStatementContext } from "./CashScriptParser";
+import { RequireStatementContext } from "./CashScriptParser";
+import { IfStatementContext } from "./CashScriptParser";
+import { FunctionCallContext } from "./CashScriptParser";
+import { ExpressionListContext } from "./CashScriptParser";
+import { CastContext } from "./CashScriptParser";
+import { UnaryIntrospectionOpContext } from "./CashScriptParser";
+import { ArrayContext } from "./CashScriptParser";
+import { UnaryOpContext } from "./CashScriptParser";
+import { IdentifierContext } from "./CashScriptParser";
+import { LiteralExpressionContext } from "./CashScriptParser";
+import { TupleIndexOpContext } from "./CashScriptParser";
+import { InstantiationContext } from "./CashScriptParser";
+import { FunctionCallExpressionContext } from "./CashScriptParser";
+import { NullaryOpContext } from "./CashScriptParser";
+import { ParenthesisedContext } from "./CashScriptParser";
+import { BinaryOpContext } from "./CashScriptParser";
+import { ModifierContext } from "./CashScriptParser";
+import { LiteralContext } from "./CashScriptParser";
+import { NumberLiteralContext } from "./CashScriptParser";
+import { TypeNameContext } from "./CashScriptParser";
 
 
 /**
@@ -49,271 +48,229 @@ import { TypeNameContext } from "./CashScriptParser.js";
  * @param <Result> The return type of the visit operation. Use `void` for
  * operations with no return type.
  */
-export interface CashScriptVisitor<Result> extends ParseTreeVisitor<Result> {
+export default class CashScriptVisitor<Result> extends ParseTreeVisitor<Result> {
 	/**
-	 * Visit a parse tree produced by the `Parenthesised`
-	 * labeled alternative in `CashScriptParser.expression`.
-	 * @param ctx the parse tree
-	 * @return the visitor result
-	 */
-	visitParenthesised?: (ctx: ParenthesisedContext) => Result;
-
-	/**
-	 * Visit a parse tree produced by the `Cast`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.sourceFile`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitCast?: (ctx: CastContext) => Result;
-
+	visitSourceFile?: (ctx: SourceFileContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `FunctionCallExpression`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.pragmaDirective`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitFunctionCallExpression?: (ctx: FunctionCallExpressionContext) => Result;
-
+	visitPragmaDirective?: (ctx: PragmaDirectiveContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `Instantiation`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.pragmaName`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitInstantiation?: (ctx: InstantiationContext) => Result;
-
+	visitPragmaName?: (ctx: PragmaNameContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `TupleIndexOp`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.pragmaValue`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitTupleIndexOp?: (ctx: TupleIndexOpContext) => Result;
-
+	visitPragmaValue?: (ctx: PragmaValueContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `UnaryIntrospectionOp`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.versionConstraint`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitUnaryIntrospectionOp?: (ctx: UnaryIntrospectionOpContext) => Result;
-
+	visitVersionConstraint?: (ctx: VersionConstraintContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `UnaryOp`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.versionOperator`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitUnaryOp?: (ctx: UnaryOpContext) => Result;
-
+	visitVersionOperator?: (ctx: VersionOperatorContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `BinaryOp`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.contractDefinition`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitBinaryOp?: (ctx: BinaryOpContext) => Result;
-
+	visitContractDefinition?: (ctx: ContractDefinitionContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `Array`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.functionDefinition`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitArray?: (ctx: ArrayContext) => Result;
-
+	visitFunctionDefinition?: (ctx: FunctionDefinitionContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `NullaryOp`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.parameterList`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitNullaryOp?: (ctx: NullaryOpContext) => Result;
-
+	visitParameterList?: (ctx: ParameterListContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `Identifier`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.parameter`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitIdentifier?: (ctx: IdentifierContext) => Result;
-
+	visitParameter?: (ctx: ParameterContext) => Result;
 	/**
-	 * Visit a parse tree produced by the `LiteralExpression`
-	 * labeled alternative in `CashScriptParser.expression`.
+	 * Visit a parse tree produced by `CashScriptParser.block`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitLiteralExpression?: (ctx: LiteralExpressionContext) => Result;
-
+	visitBlock?: (ctx: BlockContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.sourceFile`.
+	 * Visit a parse tree produced by `CashScriptParser.statement`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitSourceFile?: (ctx: SourceFileContext) => Result;
-
+	visitStatement?: (ctx: StatementContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.pragmaDirective`.
+	 * Visit a parse tree produced by `CashScriptParser.variableDefinition`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitPragmaDirective?: (ctx: PragmaDirectiveContext) => Result;
-
+	visitVariableDefinition?: (ctx: VariableDefinitionContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.pragmaName`.
+	 * Visit a parse tree produced by `CashScriptParser.tupleAssignment`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitPragmaName?: (ctx: PragmaNameContext) => Result;
-
+	visitTupleAssignment?: (ctx: TupleAssignmentContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.pragmaValue`.
+	 * Visit a parse tree produced by `CashScriptParser.assignStatement`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitPragmaValue?: (ctx: PragmaValueContext) => Result;
-
+	visitAssignStatement?: (ctx: AssignStatementContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.versionConstraint`.
+	 * Visit a parse tree produced by `CashScriptParser.timeOpStatement`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitVersionConstraint?: (ctx: VersionConstraintContext) => Result;
-
+	visitTimeOpStatement?: (ctx: TimeOpStatementContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.versionOperator`.
+	 * Visit a parse tree produced by `CashScriptParser.requireStatement`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitVersionOperator?: (ctx: VersionOperatorContext) => Result;
-
+	visitRequireStatement?: (ctx: RequireStatementContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.contractDefinition`.
+	 * Visit a parse tree produced by `CashScriptParser.ifStatement`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitContractDefinition?: (ctx: ContractDefinitionContext) => Result;
-
+	visitIfStatement?: (ctx: IfStatementContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.functionDefinition`.
+	 * Visit a parse tree produced by `CashScriptParser.functionCall`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitFunctionDefinition?: (ctx: FunctionDefinitionContext) => Result;
-
+	visitFunctionCall?: (ctx: FunctionCallContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.parameterList`.
+	 * Visit a parse tree produced by `CashScriptParser.expressionList`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitParameterList?: (ctx: ParameterListContext) => Result;
-
+	visitExpressionList?: (ctx: ExpressionListContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.parameter`.
+	 * Visit a parse tree produced by the `Cast`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitParameter?: (ctx: ParameterContext) => Result;
-
+	visitCast?: (ctx: CastContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.block`.
+	 * Visit a parse tree produced by the `UnaryIntrospectionOp`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitBlock?: (ctx: BlockContext) => Result;
-
+	visitUnaryIntrospectionOp?: (ctx: UnaryIntrospectionOpContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.statement`.
+	 * Visit a parse tree produced by the `Array`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitStatement?: (ctx: StatementContext) => Result;
-
+	visitArray?: (ctx: ArrayContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.variableDefinition`.
+	 * Visit a parse tree produced by the `UnaryOp`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitVariableDefinition?: (ctx: VariableDefinitionContext) => Result;
-
+	visitUnaryOp?: (ctx: UnaryOpContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.tupleAssignment`.
+	 * Visit a parse tree produced by the `Identifier`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitTupleAssignment?: (ctx: TupleAssignmentContext) => Result;
-
+	visitIdentifier?: (ctx: IdentifierContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.assignStatement`.
+	 * Visit a parse tree produced by the `LiteralExpression`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitAssignStatement?: (ctx: AssignStatementContext) => Result;
-
+	visitLiteralExpression?: (ctx: LiteralExpressionContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.timeOpStatement`.
+	 * Visit a parse tree produced by the `TupleIndexOp`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitTimeOpStatement?: (ctx: TimeOpStatementContext) => Result;
-
+	visitTupleIndexOp?: (ctx: TupleIndexOpContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.requireStatement`.
+	 * Visit a parse tree produced by the `Instantiation`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitRequireStatement?: (ctx: RequireStatementContext) => Result;
-
+	visitInstantiation?: (ctx: InstantiationContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.ifStatement`.
+	 * Visit a parse tree produced by the `FunctionCallExpression`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitIfStatement?: (ctx: IfStatementContext) => Result;
-
+	visitFunctionCallExpression?: (ctx: FunctionCallExpressionContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.functionCall`.
+	 * Visit a parse tree produced by the `NullaryOp`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitFunctionCall?: (ctx: FunctionCallContext) => Result;
-
+	visitNullaryOp?: (ctx: NullaryOpContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.expressionList`.
+	 * Visit a parse tree produced by the `Parenthesised`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitExpressionList?: (ctx: ExpressionListContext) => Result;
-
+	visitParenthesised?: (ctx: ParenthesisedContext) => Result;
 	/**
-	 * Visit a parse tree produced by `CashScriptParser.expression`.
+	 * Visit a parse tree produced by the `BinaryOp`
+	 * labeled alternative in `CashScriptParser.expression`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
-	visitExpression?: (ctx: ExpressionContext) => Result;
-
+	visitBinaryOp?: (ctx: BinaryOpContext) => Result;
 	/**
 	 * Visit a parse tree produced by `CashScriptParser.modifier`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
 	visitModifier?: (ctx: ModifierContext) => Result;
-
 	/**
 	 * Visit a parse tree produced by `CashScriptParser.literal`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
 	visitLiteral?: (ctx: LiteralContext) => Result;
-
 	/**
 	 * Visit a parse tree produced by `CashScriptParser.numberLiteral`.
 	 * @param ctx the parse tree
 	 * @return the visitor result
 	 */
 	visitNumberLiteral?: (ctx: NumberLiteralContext) => Result;
-
 	/**
 	 * Visit a parse tree produced by `CashScriptParser.typeName`.
 	 * @param ctx the parse tree
diff --git a/packages/cashc/test/ast/Location.test.ts b/packages/cashc/test/ast/Location.test.ts
index 54c51769..9be8b326 100644
--- a/packages/cashc/test/ast/Location.test.ts
+++ b/packages/cashc/test/ast/Location.test.ts
@@ -12,4 +12,21 @@ describe('Location', () => {
     expect(f.location).toBeDefined();
     expect((f.location!).text(code)).toEqual('function hello(sig s, pubkey pk) {\n        require(checkSig(s, pk));\n    }');
   });
+
+  it('should set the correct location points', () => {
+    const code = fs.readFileSync(new URL('../valid-contract-files/simple_functions.cash', import.meta.url), { encoding: 'utf-8' });
+    const ast = parseCode(code);
+
+    const secondFunction = ast.contract.functions[1];
+
+    expect(secondFunction.location).toBeDefined();
+    expect(secondFunction.location!.start).toEqual({ line: 6, column: 4 });
+    expect(secondFunction.location!.end).toEqual({ line: 8, column: 5 });
+
+    const firstStatement = secondFunction.body.statements![0];
+
+    expect(firstStatement.location).toBeDefined();
+    expect(firstStatement.location!.start).toEqual({ line: 7, column: 8 });
+    expect(firstStatement.location!.end).toEqual({ line: 7, column: 29 });
+  });
 });
diff --git a/yarn.lock b/yarn.lock
index 826b83c2..da4f1363 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2715,15 +2715,10 @@ ansi-styles@^5.0.0:
   resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-5.2.0.tgz#07449690ad45777d1924ac2abb2fc8895dba836b"
   integrity sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==
 
-antlr4ts-cli@^0.5.0-alpha.4:
-  version "0.5.0-alpha.4"
-  resolved "https://registry.yarnpkg.com/antlr4ts-cli/-/antlr4ts-cli-0.5.0-alpha.4.tgz#f3bfc37f10131e78d7b981c397a2aaa0450b67f6"
-  integrity sha512-lVPVBTA2CVHRYILSKilL6Jd4hAumhSZZWA7UbQNQrmaSSj7dPmmYaN4bOmZG79cOy0lS00i4LY68JZZjZMWVrw==
-
-antlr4ts@^0.5.0-alpha.4:
-  version "0.5.0-alpha.4"
-  resolved "https://registry.yarnpkg.com/antlr4ts/-/antlr4ts-0.5.0-alpha.4.tgz#71702865a87478ed0b40c0709f422cf14d51652a"
-  integrity sha512-WPQDt1B74OfPv/IMS2ekXAKkTZIHl88uMetg6q3OTqgFxZ/dxDXI0EWLyZid/1Pe6hTftyg5N7gel5wNAGxXyQ==
+antlr4@^4.13.1-patch-1:
+  version "4.13.1-patch-1"
+  resolved "https://registry.yarnpkg.com/antlr4/-/antlr4-4.13.1-patch-1.tgz#946176f863f890964a050c4f18c47fd6f7e57602"
+  integrity sha512-OjFLWWLzDMV9rdFhpvroCWR4ooktNg9/nvVYSA5z28wuVpU36QUNuioR1XLnQtcjVlf8npjyz593PxnU/f/Cow==
 
 any-promise@^1.0.0:
   version "1.3.0"

From 01f9b9bb552c3c4d63b0c7c8f065a0e23b536ca6 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 10 Jan 2024 16:04:14 +0100
Subject: [PATCH 012/267] Bump version to 0.9.3 and update release notes

---
 examples/package.json                  | 6 +++---
 packages/cashc/package.json            | 4 ++--
 packages/cashc/src/index.ts            | 2 +-
 packages/cashscript/package.json       | 4 ++--
 packages/utils/package.json            | 2 +-
 website/docs/releases/release-notes.md | 5 +++++
 6 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index 2bb2f73b..41970230 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -11,8 +11,8 @@
     "@bitauth/libauth": "^2.0.0-alpha.8",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
-    "cashc": "^0.9.2",
-    "cashscript": "^0.9.2",
+    "cashc": "^0.9.3",
+    "cashscript": "^0.9.3",
     "typescript": "^4.9.5"
   }
 }
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 207c5ed5..236524f4 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0-alpha.8",
-    "@cashscript/utils": "^0.9.2",
+    "@cashscript/utils": "^0.9.3",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.3.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 57902d13..067593f4 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.9.2';
+export const version = '0.9.3';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 3e5caa7a..be8cf64b 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0-alpha.8",
-    "@cashscript/utils": "^0.9.2",
+    "@cashscript/utils": "^0.9.3",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 2eece0bf..144bf630 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 148ee32d..222fa905 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,6 +2,11 @@
 title: Release Notes
 ---
 
+## v0.9.3
+
+#### cashc compiler
+- :hammer_and_wrench: Migrate from antlr4ts to ANTLR's official TypeScript target to remove circular dependency issues.
+
 ## v0.9.2
 
 #### CashScript SDK

From 112779dc39569d41b28c15828bd179dcf6b7232a Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 18 Jan 2024 10:28:25 +0100
Subject: [PATCH 013/267] Update libauth to latest stable release

---
 packages/cashc/package.json                |  4 +--
 packages/cashscript/package.json           |  2 +-
 packages/cashscript/src/LibauthTemplate.ts | 40 +++++++++++-----------
 packages/cashscript/src/Transaction.ts     |  4 +--
 packages/cashscript/src/utils.ts           |  4 +--
 packages/utils/package.json                |  2 +-
 yarn.lock                                  |  5 +++
 7 files changed, 33 insertions(+), 28 deletions(-)

diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index b0216a8c..046a9b38 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -49,11 +49,11 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^2.0.0-alpha.8",
+    "@bitauth/libauth": "^2.0.0",
     "@cashscript/utils": "^0.10.0-next.2",
     "antlr4ts": "^0.5.0-alpha.4",
     "commander": "^7.1.0",
-    "semver": "^7.3.4"
+    "semver": "^7.5.4"
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index d85b4006..94587610 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -43,7 +43,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^2.0.0-alpha.8",
+    "@bitauth/libauth": "^2.0.0",
     "@cashscript/utils": "^0.10.0-next.2",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index cfc2018e..57bf0d3f 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -4,14 +4,14 @@ import {
 import {
   hash160,
   hexToBin,
-  AuthenticationTemplateScenarioTransactionOutput,
-  AuthenticationTemplateScenario,
+  WalletTemplateScenarioTransactionOutput,
+  WalletTemplateScenario,
   decodeTransaction,
   binToHex,
-  AuthenticationTemplate,
-  AuthenticationTemplateScenarioInput,
+  WalletTemplate,
+  WalletTemplateScenarioInput,
   TransactionBCH,
-  authenticationTemplateToCompilerConfiguration,
+  walletTemplateToCompilerConfiguration,
   createCompiler,
   createVirtualMachineBCHCHIPs,
   binToBase64,
@@ -22,7 +22,7 @@ import {
   AuthenticationVirtualMachine,
   ResolvedTransactionCommon,
   AuthenticationErrorCommon,
-  AuthenticationTemplateScenarioOutput,
+  WalletTemplateScenarioOutput,
 } from '@bitauth/libauth';
 import { deflate } from 'pako';
 import {
@@ -81,9 +81,9 @@ export const stringify = (any: any, spaces?: number): string => JSON.stringify(
 
 const zip = (a: any[], b: any[]): any[] => Array.from(Array(Math.max(b.length, a.length)), (_, i) => [a[i], b[i]]);
 
-const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransaction: Transaction): AuthenticationTemplateScenario['transaction'] => {
+const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransaction: Transaction): WalletTemplateScenario['transaction'] => {
   const contract = csTransaction.contract;
-  const result = ({} as AuthenticationTemplateScenario['transaction'])!;
+  const result = ({} as WalletTemplateScenario['transaction'])!;
 
   // only one 'slot' is allowed, otherwise {} must be used
   let inputSlotInserted = false;
@@ -118,7 +118,7 @@ const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransac
           : input.outpointTransactionHash,
       sequenceNumber: input.sequenceNumber,
       unlockingBytecode,
-    } as AuthenticationTemplateScenarioInput;
+    } as WalletTemplateScenarioInput;
   });
   result.locktime = libauthTransaction.locktime;
 
@@ -166,20 +166,20 @@ const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransac
             : lockingBytecode,
         token: output.token,
         valueSatoshis: Number(output.valueSatoshis),
-      } as AuthenticationTemplateScenarioTransactionOutput;
+      } as WalletTemplateScenarioTransactionOutput;
     },
   );
   result.version = libauthTransaction.version;
   return result;
 };
 
-const createScenarioSourceOutputs = (csTransaction: Transaction): Array<AuthenticationTemplateScenarioOutput<true>> => {
+const createScenarioSourceOutputs = (csTransaction: Transaction): Array<WalletTemplateScenarioOutput<true>> => {
   // only one 'slot' is allowed, otherwise {} must be used
   let inputSlotInserted = false;
   return csTransaction.inputs.map(
     (csInput) => {
       const signable = isUtxoP2PKH(csInput);
-      let lockingBytecode = {} as AuthenticationTemplateScenarioOutput<true>['lockingBytecode'];
+      let lockingBytecode = {} as WalletTemplateScenarioOutput<true>['lockingBytecode'];
       if (signable) {
         lockingBytecode = {
           script: 'p2pkh_placeholder_lock',
@@ -205,7 +205,7 @@ const createScenarioSourceOutputs = (csTransaction: Transaction): Array<Authenti
       const result = {
         lockingBytecode: lockingBytecode,
         valueSatoshis: Number(csInput.satoshis),
-      } as AuthenticationTemplateScenarioOutput<true>;
+      } as WalletTemplateScenarioOutput<true>;
 
       if (csInput.token) {
         result.token = {
@@ -232,7 +232,7 @@ export const buildTemplate = async ({
 }: {
   transaction: Transaction;
   transactionHex?: string;
-}): Promise<AuthenticationTemplate> => {
+}): Promise<WalletTemplate> => {
   const contract = transaction.contract;
   const txHex = transactionHex ?? await transaction.build();
 
@@ -278,7 +278,7 @@ export const buildTemplate = async ({
     name: contract.artifact.contractName,
     supported: ['BCH_SPEC'],
     version: 0,
-  } as AuthenticationTemplate;
+  } as WalletTemplate;
 
   // declaration of template variables and their types
   template.entities = {
@@ -464,7 +464,7 @@ export const buildTemplate = async ({
   return template;
 };
 
-export const getBitauthUri = (template: AuthenticationTemplate): string => {
+export const getBitauthUri = (template: WalletTemplate): string => {
   const base64toBase64Url = (base64: string): string => base64.replace(/\+/g, '-').replace(/\//g, '_');
   const payload = base64toBase64Url(
     binToBase64(deflate(utf8ToBin(stringify(template)))),
@@ -481,8 +481,8 @@ type Program = AuthenticationProgramCommon;
 type CreateProgramResult = { vm: VM, program: Program };
 
 // internal util. instantiates the virtual machine and compiles the template into a program
-const createProgram = (template: AuthenticationTemplate): CreateProgramResult => {
-  const configuration = authenticationTemplateToCompilerConfiguration(template);
+const createProgram = (template: WalletTemplate): CreateProgramResult => {
+  const configuration = walletTemplateToCompilerConfiguration(template);
   const vm = createVirtualMachineBCHCHIPs();
   const compiler = createCompiler(configuration);
 
@@ -505,7 +505,7 @@ const createProgram = (template: AuthenticationTemplate): CreateProgramResult =>
 };
 
 // evaluates the fully defined template, throws upon error
-export const evaluateTemplate = (template: AuthenticationTemplate): boolean => {
+export const evaluateTemplate = (template: WalletTemplate): boolean => {
   const { vm, program } = createProgram(template);
 
   const verifyResult = vm.verify(program);
@@ -520,7 +520,7 @@ export const evaluateTemplate = (template: AuthenticationTemplate): boolean => {
 export type DebugResult = AuthenticationProgramStateBCHCHIPs[];
 
 // debugs the template, optionally logging the execution data
-export const debugTemplate = (template: AuthenticationTemplate, artifact: Artifact): DebugResult => {
+export const debugTemplate = (template: WalletTemplate, artifact: Artifact): DebugResult => {
   const { vm, program } = createProgram(template);
 
   const debugResult = vm.debug(program);
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 62b69b61..8f4658d3 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -3,7 +3,7 @@ import {
   hexToBin,
   decodeTransaction,
   Transaction as LibauthTransaction,
-  AuthenticationTemplate,
+  WalletTemplate,
 } from '@bitauth/libauth';
 import delay from 'delay';
 import {
@@ -174,7 +174,7 @@ export class Transaction {
 
   async send(raw?: true): Promise<TransactionDetails | string> {
     const tx = await this.build();
-    let template: AuthenticationTemplate | undefined;
+    let template: WalletTemplate | undefined;
     try {
       if (this.contract.provider instanceof MockNetworkProvider) {
         template = await buildTemplate({
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index c9601ad3..cff75067 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -12,7 +12,7 @@ import {
   LockingBytecodeType,
   encodeTransactionOutput,
   isHex,
-  bigIntToCompactSize,
+  bigIntToCompactUint,
   AuthenticationErrorCommon,
   NonFungibleTokenCapability,
   bigIntToVmNumber,
@@ -155,7 +155,7 @@ export function getTxSizeWithoutInputs(outputs: Output[]): number {
   let size = VERSION_SIZE + LOCKTIME_SIZE;
   size += outputs.reduce((acc, output) => acc + getOutputSize(output), 0);
   // Add tx-out count (accounting for a potential change output)
-  size += bigIntToCompactSize(BigInt(outputs.length + 1)).byteLength;
+  size += bigIntToCompactUint(BigInt(outputs.length + 1)).byteLength;
 
   return size;
 }
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 30e6c48c..d2ff60f5 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -40,7 +40,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^2.0.0-alpha.8",
+    "@bitauth/libauth": "^2.0.0",
     "hash.js": "^1.1.7"
   },
   "devDependencies": {
diff --git a/yarn.lock b/yarn.lock
index 735c413f..6dd2c7f4 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -487,6 +487,11 @@
   resolved "https://registry.yarnpkg.com/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz#75a2e8b51cb758a7553d6804a5932d7aace75c39"
   integrity sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==
 
+"@bitauth/libauth@^2.0.0":
+  version "2.0.0"
+  resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-2.0.0.tgz#200a3c967bf1ab088a9ea17691ee354283aee0a6"
+  integrity sha512-wFnQtnJvz7S7jU7fQuBJzRQrVHk46DELd5s8D0F61bW567bKVVfMLbwNPCs12pzVckueQTlLwCS//I9skGI1zg==
+
 "@bitauth/libauth@^2.0.0-alpha.8":
   version "2.0.0-alpha.8"
   resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-2.0.0-alpha.8.tgz#352ade2075517f1548e05553e7bb1c5e1023d1fe"

From 5160555ef4c16ed1ea7b50243945236e2f89eae3 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 18 Jan 2024 11:07:41 +0100
Subject: [PATCH 014/267] Fix broken postantlr script after ANTLR updates

---
 packages/cashc/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index b7018aee..c7b449c3 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -35,7 +35,7 @@
   },
   "scripts": {
     "antlr": "antlr -Dlanguage=TypeScript -visitor -no-listener src/grammar/CashScript.g4",
-    "postantlr": "find src/grammar -type f -name '*.ts' | xargs sed -i '' 's|\\(import .* \".*/.*\\)\";|\\1\\.js\";|g'",
+    "postantlr": "find src/grammar -type f -name 'CashScriptVisitor.ts' | xargs sed -i '' 's|\\(import .* \".*/.*\\)\";|\\1\\.js\";|g'",
     "build": "yarn clean && yarn compile",
     "build:test": "yarn clean:test && yarn compile:test && cpy './test/**/*.cash' ./dist-test/test",
     "clean": "rm -rf ./dist",

From a42badd523d772fe7212726991a6ef5adec1400b Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 18 Jan 2024 12:05:26 +0100
Subject: [PATCH 015/267] Refactor of the ConsoleStatementNode and
 ConsoleParameterNode

---
 packages/cashc/src/ast/AST.ts                 |   39 +-
 packages/cashc/src/ast/AstBuilder.ts          |   17 +-
 packages/cashc/src/ast/AstTraversal.ts        |    4 -
 packages/cashc/src/ast/AstVisitor.ts          |    2 -
 packages/cashc/src/compiler.ts                |    5 +-
 .../src/generation/GenerateTargetTraversal.ts |   40 +-
 packages/cashc/src/grammar/CashScript.g4      |   13 +-
 packages/cashc/src/grammar/CashScript.interp  |    3 +-
 .../cashc/src/grammar/CashScriptParser.ts     | 1023 +++++++++--------
 .../cashc/src/grammar/CashScriptVisitor.ts    |    7 +
 .../src/print/OutputSourceCodeTraversal.ts    |   15 +
 .../src/semantic/SymbolTableTraversal.ts      |   13 -
 packages/cashc/test/ast/fixtures.ts           |    5 +-
 .../undefined_variable_in_console_log.cash    |    5 +
 14 files changed, 612 insertions(+), 579 deletions(-)
 create mode 100644 packages/cashc/test/compiler/UndefinedReferenceError/undefined_variable_in_console_log.cash

diff --git a/packages/cashc/src/ast/AST.ts b/packages/cashc/src/ast/AST.ts
index b12081dd..d6acd68a 100644
--- a/packages/cashc/src/ast/AST.ts
+++ b/packages/cashc/src/ast/AST.ts
@@ -4,6 +4,7 @@ import AstVisitor from './AstVisitor.js';
 import { BinaryOperator, NullaryOperator, UnaryOperator } from './Operator.js';
 import { Location } from './Location.js';
 import { SymbolTable, Symbol } from './SymbolTable.js';
+import { binToHex } from '@bitauth/libauth';
 
 export type Ast = SourceFileNode;
 
@@ -97,8 +98,8 @@ export class VariableDefinitionNode extends StatementNode implements Named, Type
 
 export class TupleAssignmentNode extends StatementNode {
   constructor(
-    public var1: { name:string, type:Type },
-    public var2: { name:string, type:Type },
+    public var1: { name: string, type: Type },
+    public var2: { name: string, type: Type },
     public tuple: ExpressionNode,
   ) {
     super();
@@ -299,9 +300,15 @@ export class IdentifierNode extends ExpressionNode implements Named {
   }
 }
 
-export abstract class LiteralNode extends ExpressionNode {}
+export abstract class LiteralNode<T = any> extends ExpressionNode {
+  public value: T;
 
-export class BoolLiteralNode extends LiteralNode {
+  toString(): string {
+    return `${this.value}`;
+  }
+}
+
+export class BoolLiteralNode extends LiteralNode<boolean> {
   constructor(
     public value: boolean,
   ) {
@@ -314,7 +321,7 @@ export class BoolLiteralNode extends LiteralNode {
   }
 }
 
-export class IntLiteralNode extends LiteralNode {
+export class IntLiteralNode extends LiteralNode<bigint> {
   constructor(
     public value: bigint,
   ) {
@@ -327,7 +334,7 @@ export class IntLiteralNode extends LiteralNode {
   }
 }
 
-export class StringLiteralNode extends LiteralNode {
+export class StringLiteralNode extends LiteralNode<string> {
   constructor(
     public value: string,
     public quote: string,
@@ -341,7 +348,7 @@ export class StringLiteralNode extends LiteralNode {
   }
 }
 
-export class HexLiteralNode extends LiteralNode {
+export class HexLiteralNode extends LiteralNode<Uint8Array> {
   constructor(
     public value: Uint8Array,
   ) {
@@ -349,6 +356,10 @@ export class HexLiteralNode extends LiteralNode {
     this.type = new BytesType(value.byteLength);
   }
 
+  toString(): string {
+    return `0x${binToHex(this.value)}`;
+  }
+
   accept<T>(visitor: AstVisitor<T>): T {
     return visitor.visitHexLiteral(this);
   }
@@ -366,16 +377,4 @@ export class ConsoleStatementNode extends Node {
   }
 }
 
-// TODO: Couldn't we just use existing nodes for this? e.g. IdentifierNode + StringLiteralNode etc.
-export class ConsoleParameterNode extends Node {
-  constructor(
-    public message?: string,
-    public identifier?: string,
-  ) {
-    super();
-  }
-
-  accept<T>(visitor: AstVisitor<T>): T {
-    return visitor.visitConsoleParameter(this);
-  }
-}
+export type ConsoleParameterNode = LiteralNode | IdentifierNode;
diff --git a/packages/cashc/src/ast/AstBuilder.ts b/packages/cashc/src/ast/AstBuilder.ts
index 8a51b174..a3510267 100644
--- a/packages/cashc/src/ast/AstBuilder.ts
+++ b/packages/cashc/src/ast/AstBuilder.ts
@@ -65,6 +65,7 @@ import type {
   ConsoleStatementContext,
   ConsoleParameterContext,
   StatementContext,
+  RequireMessageContext,
 } from '../grammar/CashScriptParser.js';
 import CashScriptVisitor from '../grammar/CashScriptVisitor.js';
 import { Location } from './Location.js';
@@ -187,7 +188,7 @@ export default class AstBuilder
 
   visitTimeOpStatement(ctx: TimeOpStatementContext): TimeOpNode {
     const expression = this.visit(ctx.expression());
-    const message = ctx.StringLiteral() ? this.createStringLiteral(ctx as any)?.value : undefined;
+    const message = ctx.requireMessage() ? this.createStringLiteral(ctx.requireMessage()).value : undefined;
     const timeOp = new TimeOpNode(ctx.TxVar().getText() as TimeOp, expression, message);
     timeOp.location = Location.fromCtx(ctx);
 
@@ -196,7 +197,7 @@ export default class AstBuilder
 
   visitRequireStatement(ctx: RequireStatementContext): RequireNode {
     const expression = this.visit(ctx.expression());
-    const message = ctx.StringLiteral() ? this.createStringLiteral(ctx as any)?.value : undefined;
+    const message = ctx.requireMessage() ? this.createStringLiteral(ctx.requireMessage()).value : undefined;
     const require = new RequireNode(expression, message);
     require.location = Location.fromCtx(ctx);
     return require;
@@ -352,7 +353,7 @@ export default class AstBuilder
     return intLiteral;
   }
 
-  createStringLiteral(ctx: LiteralContext): StringLiteralNode {
+  createStringLiteral(ctx: LiteralContext | RequireMessageContext): StringLiteralNode {
     const rawString = ctx.StringLiteral().getText();
     const stringValue = rawString.substring(1, rawString.length - 1);
     const quote = rawString.substring(0, 1);
@@ -392,20 +393,14 @@ export default class AstBuilder
     const parameters = ctx.consoleParameterList()
       .consoleParameter_list()
       .map((p) => this.visit(p) as ConsoleParameterNode);
+
     const node = new ConsoleStatementNode(parameters);
     node.location = Location.fromCtx(ctx);
-
     return node;
   }
 
   visitConsoleParameter(ctx: ConsoleParameterContext): ConsoleParameterNode {
-    let message = (ctx.BooleanLiteral() ?? ctx.HexLiteral() ?? ctx.NumberLiteral() ?? ctx.StringLiteral())?.getText();
-    if (message?.[0] === '"') {
-      message = message.slice(1, -1);
-    }
-    const identifier = ctx.Identifier()?.getText();
-
-    const node = new ConsoleParameterNode(message, identifier);
+    const node = ctx.literal() ? this.createLiteral(ctx.literal()) : new IdentifierNode(ctx.Identifier().getText());
     node.location = Location.fromCtx(ctx);
     return node;
   }
diff --git a/packages/cashc/src/ast/AstTraversal.ts b/packages/cashc/src/ast/AstTraversal.ts
index 15c99829..81e3f340 100644
--- a/packages/cashc/src/ast/AstTraversal.ts
+++ b/packages/cashc/src/ast/AstTraversal.ts
@@ -157,8 +157,4 @@ export default class AstTraversal extends AstVisitor<Node> {
     node.parameters = this.visitList(node.parameters) as ConsoleParameterNode[];
     return node;
   }
-
-  visitConsoleParameter(node: ConsoleParameterNode): Node {
-    return node;
-  }
 }
diff --git a/packages/cashc/src/ast/AstVisitor.ts b/packages/cashc/src/ast/AstVisitor.ts
index e846d3c2..e154b5d1 100644
--- a/packages/cashc/src/ast/AstVisitor.ts
+++ b/packages/cashc/src/ast/AstVisitor.ts
@@ -25,7 +25,6 @@ import {
   TupleAssignmentNode,
   NullaryOpNode,
   ConsoleStatementNode,
-  ConsoleParameterNode,
 } from './AST.js';
 
 export default abstract class AstVisitor<T> {
@@ -54,7 +53,6 @@ export default abstract class AstVisitor<T> {
   abstract visitStringLiteral(node: StringLiteralNode): T;
   abstract visitHexLiteral(node: HexLiteralNode): T;
   abstract visitConsoleStatement(node: ConsoleStatementNode): T;
-  abstract visitConsoleParameter(node: ConsoleParameterNode): T;
 
   visit(node: Node): T {
     return node.accept(this);
diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index 0701f577..8d8f2192 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -17,13 +17,12 @@ export function compileString(code: string): Artifact {
   let ast = parseCode(code);
 
   // Semantic analysis
-  const symbolTableTraversal = new SymbolTableTraversal();
-  ast = ast.accept(symbolTableTraversal) as Ast;
+  ast = ast.accept(new SymbolTableTraversal()) as Ast;
   ast = ast.accept(new TypeCheckTraversal()) as Ast;
   ast = ast.accept(new EnsureFinalRequireTraversal()) as Ast;
 
   // Code generation
-  const traversal = new GenerateTargetTraversal(symbolTableTraversal.logSymbols);
+  const traversal = new GenerateTargetTraversal();
   ast = ast.accept(traversal) as Ast;
 
   // Bytecode optimisation
diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 5bc1ea2f..3754ac2f 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -57,8 +57,6 @@ import {
   compileUnaryOp,
 } from './utils.js';
 import { Location } from '../ast/Location.js';
-import { ParseError } from '../Errors.js';
-import { Symbol } from '../ast/SymbolTable.js';
 
 export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   private locationData: LocationData = []; // detailed location data needed for sourcemap creation
@@ -72,10 +70,6 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   private currentFunction: FunctionDefinitionNode;
   private constructorParameterCount: number;
 
-  constructor(private logSymbols: Symbol[]) {
-    super();
-  }
-
   private emit(op: OpOrData | OpOrData[], location: LocationI, positionHint?: number): void {
     if (Array.isArray(op)) {
       op.forEach((element) => this.output.push(element as Op));
@@ -550,38 +544,24 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   visitConsoleStatement(node: ConsoleStatementNode): Node {
     // instruction pointer is the count of emitted opcodes + number of constructor data pushes
     const ip = this.output.length + this.constructorParameterCount;
-
     const { line } = node.location!.start;
 
+    // TODO: refactor to use a map instead of array (also in the artifact and other places where console logs and
+    // require statements are used)
     // check if log entry exists for the instruction pointer, create if not
     let index = this.consoleLogs.findIndex((entry: LogEntry) => entry.ip === ip);
     if (index === -1) {
-      index = this.consoleLogs.push({
-        ip,
-        line,
-        data: [],
-      }) - 1;
+      index = this.consoleLogs.push({ ip, line, data: [] }) - 1;
     }
 
     node.parameters.forEach((parameter: ConsoleParameterNode) => {
-      if (parameter.identifier) {
-        // we look for all symbols with identifier name
-        // then take the first which is declared in the nearest code block
-        const symbol = this.logSymbols
-          .filter((logSymbol) => logSymbol.name === parameter.identifier)
-          .sort((a, b) => b.definition?.location?.start.line! - a.definition?.location?.start.line!)[0];
-
-        if (!symbol) {
-          throw new ParseError(`Undefined reference to symbol ${parameter.identifier} at ${parameter.location?.start}`);
-        }
-
-        const stackIndex = this.getStackIndex(parameter.identifier);
-        this.consoleLogs[index].data.push({
-          stackIndex,
-          type: typeof symbol.type === 'string' ? symbol.type : symbol.toString(),
-        });
-      } else if (parameter.message) {
-        this.consoleLogs[index].data.push(parameter.message);
+      if (parameter instanceof IdentifierNode) {
+        const symbol = parameter.definition!;
+        const stackIndex = this.getStackIndex(parameter.name);
+        const type = typeof symbol.type === 'string' ? symbol.type : symbol.toString();
+        this.consoleLogs[index].data.push({ stackIndex, type });
+      } else {
+        this.consoleLogs[index].data.push(parameter.toString());
       }
     });
 
diff --git a/packages/cashc/src/grammar/CashScript.g4 b/packages/cashc/src/grammar/CashScript.g4
index a7890d08..bdbdbce6 100644
--- a/packages/cashc/src/grammar/CashScript.g4
+++ b/packages/cashc/src/grammar/CashScript.g4
@@ -68,11 +68,11 @@ assignStatement
     ;
 
 timeOpStatement
-    : 'require' '(' TxVar '>=' expression (',' StringLiteral)? ')' ';'
+    : 'require' '(' TxVar '>=' expression (',' requireMessage)? ')' ';'
     ;
 
 requireStatement
-    : 'require' '(' expression (',' StringLiteral)? ')' ';'
+    : 'require' '(' expression (',' requireMessage)? ')' ';'
     ;
 
 ifStatement
@@ -83,12 +83,13 @@ consoleStatement
     : 'console.log' consoleParameterList ';'
     ;
 
+requireMessage
+    : StringLiteral
+    ;
+
 consoleParameter
     : Identifier
-    | StringLiteral
-    | NumberLiteral
-    | HexLiteral
-    | BooleanLiteral
+    | literal
     ;
 
 consoleParameterList
diff --git a/packages/cashc/src/grammar/CashScript.interp b/packages/cashc/src/grammar/CashScript.interp
index fd6dd5e4..97221ccb 100644
--- a/packages/cashc/src/grammar/CashScript.interp
+++ b/packages/cashc/src/grammar/CashScript.interp
@@ -168,6 +168,7 @@ timeOpStatement
 requireStatement
 ifStatement
 consoleStatement
+requireMessage
 consoleParameter
 consoleParameterList
 functionCall
@@ -180,4 +181,4 @@ typeName
 
 
 atn:
-[4, 1, 72, 359, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 2, 25, 7, 25, 2, 26, 7, 26, 2, 27, 7, 27, 1, 0, 5, 0, 58, 8, 0, 10, 0, 12, 0, 61, 9, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 1, 2, 1, 3, 1, 3, 3, 3, 75, 8, 3, 1, 4, 3, 4, 78, 8, 4, 1, 4, 1, 4, 1, 5, 1, 5, 1, 6, 1, 6, 1, 6, 1, 6, 1, 6, 5, 6, 89, 8, 6, 10, 6, 12, 6, 92, 9, 6, 1, 6, 1, 6, 1, 7, 1, 7, 1, 7, 1, 7, 1, 7, 5, 7, 101, 8, 7, 10, 7, 12, 7, 104, 9, 7, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 8, 5, 8, 112, 8, 8, 10, 8, 12, 8, 115, 9, 8, 1, 8, 3, 8, 118, 8, 8, 3, 8, 120, 8, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 9, 1, 10, 1, 10, 5, 10, 129, 8, 10, 10, 10, 12, 10, 132, 9, 10, 1, 10, 1, 10, 3, 10, 136, 8, 10, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 3, 11, 145, 8, 11, 1, 12, 1, 12, 5, 12, 149, 8, 12, 10, 12, 12, 12, 152, 9, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 14, 1, 14, 1, 14, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 3, 15, 180, 8, 15, 1, 15, 1, 15, 1, 15, 1, 16, 1, 16, 1, 16, 1, 16, 1, 16, 3, 16, 190, 8, 16, 1, 16, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 3, 17, 202, 8, 17, 1, 18, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 20, 1, 20, 1, 20, 1, 20, 5, 20, 214, 8, 20, 10, 20, 12, 20, 217, 9, 20, 1, 20, 3, 20, 220, 8, 20, 3, 20, 222, 8, 20, 1, 20, 1, 20, 1, 21, 1, 21, 1, 21, 1, 22, 1, 22, 1, 22, 1, 22, 5, 22, 233, 8, 22, 10, 22, 12, 22, 236, 9, 22, 1, 22, 3, 22, 239, 8, 22, 3, 22, 241, 8, 22, 1, 22, 1, 22, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 3, 23, 255, 8, 23, 1, 23, 3, 23, 258, 8, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 5, 23, 284, 8, 23, 10, 23, 12, 23, 287, 9, 23, 1, 23, 3, 23, 290, 8, 23, 3, 23, 292, 8, 23, 1, 23, 1, 23, 1, 23, 1, 23, 3, 23, 298, 8, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 1, 23, 5, 23, 339, 8, 23, 10, 23, 12, 23, 342, 9, 23, 1, 24, 1, 24, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 3, 25, 351, 8, 25, 1, 26, 1, 26, 3, 26, 355, 8, 26, 1, 27, 1, 27, 1, 27, 0, 1, 46, 28, 0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, 52, 54, 0, 11, 1, 0, 4, 10, 5, 0, 59, 59, 61, 61, 64, 64, 66, 66, 69, 69, 1, 0, 26, 30, 2, 0, 26, 30, 32, 35, 1, 0, 39, 40, 1, 0, 41, 43, 2, 0, 40, 40, 44, 44, 1, 0, 6, 9, 1, 0, 45, 46, 1, 0, 36, 37, 2, 0, 52, 57, 62, 62, 388, 0, 59, 1, 0, 0, 0, 2, 65, 1, 0, 0, 0, 4, 70, 1, 0, 0, 0, 6, 72, 1, 0, 0, 0, 8, 77, 1, 0, 0, 0, 10, 81, 1, 0, 0, 0, 12, 83, 1, 0, 0, 0, 14, 95, 1, 0, 0, 0, 16, 107, 1, 0, 0, 0, 18, 123, 1, 0, 0, 0, 20, 135, 1, 0, 0, 0, 22, 144, 1, 0, 0, 0, 24, 146, 1, 0, 0, 0, 26, 158, 1, 0, 0, 0, 28, 167, 1, 0, 0, 0, 30, 172, 1, 0, 0, 0, 32, 184, 1, 0, 0, 0, 34, 194, 1, 0, 0, 0, 36, 203, 1, 0, 0, 0, 38, 207, 1, 0, 0, 0, 40, 209, 1, 0, 0, 0, 42, 225, 1, 0, 0, 0, 44, 228, 1, 0, 0, 0, 46, 297, 1, 0, 0, 0, 48, 343, 1, 0, 0, 0, 50, 350, 1, 0, 0, 0, 52, 352, 1, 0, 0, 0, 54, 356, 1, 0, 0, 0, 56, 58, 3, 2, 1, 0, 57, 56, 1, 0, 0, 0, 58, 61, 1, 0, 0, 0, 59, 57, 1, 0, 0, 0, 59, 60, 1, 0, 0, 0, 60, 62, 1, 0, 0, 0, 61, 59, 1, 0, 0, 0, 62, 63, 3, 12, 6, 0, 63, 64, 5, 0, 0, 1, 64, 1, 1, 0, 0, 0, 65, 66, 5, 1, 0, 0, 66, 67, 3, 4, 2, 0, 67, 68, 3, 6, 3, 0, 68, 69, 5, 2, 0, 0, 69, 3, 1, 0, 0, 0, 70, 71, 5, 3, 0, 0, 71, 5, 1, 0, 0, 0, 72, 74, 3, 8, 4, 0, 73, 75, 3, 8, 4, 0, 74, 73, 1, 0, 0, 0, 74, 75, 1, 0, 0, 0, 75, 7, 1, 0, 0, 0, 76, 78, 3, 10, 5, 0, 77, 76, 1, 0, 0, 0, 77, 78, 1, 0, 0, 0, 78, 79, 1, 0, 0, 0, 79, 80, 5, 58, 0, 0, 80, 9, 1, 0, 0, 0, 81, 82, 7, 0, 0, 0, 82, 11, 1, 0, 0, 0, 83, 84, 5, 11, 0, 0, 84, 85, 5, 69, 0, 0, 85, 86, 3, 16, 8, 0, 86, 90, 5, 12, 0, 0, 87, 89, 3, 14, 7, 0, 88, 87, 1, 0, 0, 0, 89, 92, 1, 0, 0, 0, 90, 88, 1, 0, 0, 0, 90, 91, 1, 0, 0, 0, 91, 93, 1, 0, 0, 0, 92, 90, 1, 0, 0, 0, 93, 94, 5, 13, 0, 0, 94, 13, 1, 0, 0, 0, 95, 96, 5, 14, 0, 0, 96, 97, 5, 69, 0, 0, 97, 98, 3, 16, 8, 0, 98, 102, 5, 12, 0, 0, 99, 101, 3, 22, 11, 0, 100, 99, 1, 0, 0, 0, 101, 104, 1, 0, 0, 0, 102, 100, 1, 0, 0, 0, 102, 103, 1, 0, 0, 0, 103, 105, 1, 0, 0, 0, 104, 102, 1, 0, 0, 0, 105, 106, 5, 13, 0, 0, 106, 15, 1, 0, 0, 0, 107, 119, 5, 15, 0, 0, 108, 113, 3, 18, 9, 0, 109, 110, 5, 16, 0, 0, 110, 112, 3, 18, 9, 0, 111, 109, 1, 0, 0, 0, 112, 115, 1, 0, 0, 0, 113, 111, 1, 0, 0, 0, 113, 114, 1, 0, 0, 0, 114, 117, 1, 0, 0, 0, 115, 113, 1, 0, 0, 0, 116, 118, 5, 16, 0, 0, 117, 116, 1, 0, 0, 0, 117, 118, 1, 0, 0, 0, 118, 120, 1, 0, 0, 0, 119, 108, 1, 0, 0, 0, 119, 120, 1, 0, 0, 0, 120, 121, 1, 0, 0, 0, 121, 122, 5, 17, 0, 0, 122, 17, 1, 0, 0, 0, 123, 124, 3, 54, 27, 0, 124, 125, 5, 69, 0, 0, 125, 19, 1, 0, 0, 0, 126, 130, 5, 12, 0, 0, 127, 129, 3, 22, 11, 0, 128, 127, 1, 0, 0, 0, 129, 132, 1, 0, 0, 0, 130, 128, 1, 0, 0, 0, 130, 131, 1, 0, 0, 0, 131, 133, 1, 0, 0, 0, 132, 130, 1, 0, 0, 0, 133, 136, 5, 13, 0, 0, 134, 136, 3, 22, 11, 0, 135, 126, 1, 0, 0, 0, 135, 134, 1, 0, 0, 0, 136, 21, 1, 0, 0, 0, 137, 145, 3, 24, 12, 0, 138, 145, 3, 26, 13, 0, 139, 145, 3, 28, 14, 0, 140, 145, 3, 30, 15, 0, 141, 145, 3, 32, 16, 0, 142, 145, 3, 34, 17, 0, 143, 145, 3, 36, 18, 0, 144, 137, 1, 0, 0, 0, 144, 138, 1, 0, 0, 0, 144, 139, 1, 0, 0, 0, 144, 140, 1, 0, 0, 0, 144, 141, 1, 0, 0, 0, 144, 142, 1, 0, 0, 0, 144, 143, 1, 0, 0, 0, 145, 23, 1, 0, 0, 0, 146, 150, 3, 54, 27, 0, 147, 149, 3, 48, 24, 0, 148, 147, 1, 0, 0, 0, 149, 152, 1, 0, 0, 0, 150, 148, 1, 0, 0, 0, 150, 151, 1, 0, 0, 0, 151, 153, 1, 0, 0, 0, 152, 150, 1, 0, 0, 0, 153, 154, 5, 69, 0, 0, 154, 155, 5, 10, 0, 0, 155, 156, 3, 46, 23, 0, 156, 157, 5, 2, 0, 0, 157, 25, 1, 0, 0, 0, 158, 159, 3, 54, 27, 0, 159, 160, 5, 69, 0, 0, 160, 161, 5, 16, 0, 0, 161, 162, 3, 54, 27, 0, 162, 163, 5, 69, 0, 0, 163, 164, 5, 10, 0, 0, 164, 165, 3, 46, 23, 0, 165, 166, 5, 2, 0, 0, 166, 27, 1, 0, 0, 0, 167, 168, 5, 69, 0, 0, 168, 169, 5, 10, 0, 0, 169, 170, 3, 46, 23, 0, 170, 171, 5, 2, 0, 0, 171, 29, 1, 0, 0, 0, 172, 173, 5, 18, 0, 0, 173, 174, 5, 15, 0, 0, 174, 175, 5, 67, 0, 0, 175, 176, 5, 6, 0, 0, 176, 179, 3, 46, 23, 0, 177, 178, 5, 16, 0, 0, 178, 180, 5, 64, 0, 0, 179, 177, 1, 0, 0, 0, 179, 180, 1, 0, 0, 0, 180, 181, 1, 0, 0, 0, 181, 182, 5, 17, 0, 0, 182, 183, 5, 2, 0, 0, 183, 31, 1, 0, 0, 0, 184, 185, 5, 18, 0, 0, 185, 186, 5, 15, 0, 0, 186, 189, 3, 46, 23, 0, 187, 188, 5, 16, 0, 0, 188, 190, 5, 64, 0, 0, 189, 187, 1, 0, 0, 0, 189, 190, 1, 0, 0, 0, 190, 191, 1, 0, 0, 0, 191, 192, 5, 17, 0, 0, 192, 193, 5, 2, 0, 0, 193, 33, 1, 0, 0, 0, 194, 195, 5, 19, 0, 0, 195, 196, 5, 15, 0, 0, 196, 197, 3, 46, 23, 0, 197, 198, 5, 17, 0, 0, 198, 201, 3, 20, 10, 0, 199, 200, 5, 20, 0, 0, 200, 202, 3, 20, 10, 0, 201, 199, 1, 0, 0, 0, 201, 202, 1, 0, 0, 0, 202, 35, 1, 0, 0, 0, 203, 204, 5, 21, 0, 0, 204, 205, 3, 40, 20, 0, 205, 206, 5, 2, 0, 0, 206, 37, 1, 0, 0, 0, 207, 208, 7, 1, 0, 0, 208, 39, 1, 0, 0, 0, 209, 221, 5, 15, 0, 0, 210, 215, 3, 38, 19, 0, 211, 212, 5, 16, 0, 0, 212, 214, 3, 38, 19, 0, 213, 211, 1, 0, 0, 0, 214, 217, 1, 0, 0, 0, 215, 213, 1, 0, 0, 0, 215, 216, 1, 0, 0, 0, 216, 219, 1, 0, 0, 0, 217, 215, 1, 0, 0, 0, 218, 220, 5, 16, 0, 0, 219, 218, 1, 0, 0, 0, 219, 220, 1, 0, 0, 0, 220, 222, 1, 0, 0, 0, 221, 210, 1, 0, 0, 0, 221, 222, 1, 0, 0, 0, 222, 223, 1, 0, 0, 0, 223, 224, 5, 17, 0, 0, 224, 41, 1, 0, 0, 0, 225, 226, 5, 69, 0, 0, 226, 227, 3, 44, 22, 0, 227, 43, 1, 0, 0, 0, 228, 240, 5, 15, 0, 0, 229, 234, 3, 46, 23, 0, 230, 231, 5, 16, 0, 0, 231, 233, 3, 46, 23, 0, 232, 230, 1, 0, 0, 0, 233, 236, 1, 0, 0, 0, 234, 232, 1, 0, 0, 0, 234, 235, 1, 0, 0, 0, 235, 238, 1, 0, 0, 0, 236, 234, 1, 0, 0, 0, 237, 239, 5, 16, 0, 0, 238, 237, 1, 0, 0, 0, 238, 239, 1, 0, 0, 0, 239, 241, 1, 0, 0, 0, 240, 229, 1, 0, 0, 0, 240, 241, 1, 0, 0, 0, 241, 242, 1, 0, 0, 0, 242, 243, 5, 17, 0, 0, 243, 45, 1, 0, 0, 0, 244, 245, 6, 23, -1, 0, 245, 246, 5, 15, 0, 0, 246, 247, 3, 46, 23, 0, 247, 248, 5, 17, 0, 0, 248, 298, 1, 0, 0, 0, 249, 250, 3, 54, 27, 0, 250, 251, 5, 15, 0, 0, 251, 254, 3, 46, 23, 0, 252, 253, 5, 16, 0, 0, 253, 255, 3, 46, 23, 0, 254, 252, 1, 0, 0, 0, 254, 255, 1, 0, 0, 0, 255, 257, 1, 0, 0, 0, 256, 258, 5, 16, 0, 0, 257, 256, 1, 0, 0, 0, 257, 258, 1, 0, 0, 0, 258, 259, 1, 0, 0, 0, 259, 260, 5, 17, 0, 0, 260, 298, 1, 0, 0, 0, 261, 298, 3, 42, 21, 0, 262, 263, 5, 22, 0, 0, 263, 264, 5, 69, 0, 0, 264, 298, 3, 44, 22, 0, 265, 266, 5, 25, 0, 0, 266, 267, 5, 23, 0, 0, 267, 268, 3, 46, 23, 0, 268, 269, 5, 24, 0, 0, 269, 270, 7, 2, 0, 0, 270, 298, 1, 0, 0, 0, 271, 272, 5, 31, 0, 0, 272, 273, 5, 23, 0, 0, 273, 274, 3, 46, 23, 0, 274, 275, 5, 24, 0, 0, 275, 276, 7, 3, 0, 0, 276, 298, 1, 0, 0, 0, 277, 278, 7, 4, 0, 0, 278, 298, 3, 46, 23, 14, 279, 291, 5, 23, 0, 0, 280, 285, 3, 46, 23, 0, 281, 282, 5, 16, 0, 0, 282, 284, 3, 46, 23, 0, 283, 281, 1, 0, 0, 0, 284, 287, 1, 0, 0, 0, 285, 283, 1, 0, 0, 0, 285, 286, 1, 0, 0, 0, 286, 289, 1, 0, 0, 0, 287, 285, 1, 0, 0, 0, 288, 290, 5, 16, 0, 0, 289, 288, 1, 0, 0, 0, 289, 290, 1, 0, 0, 0, 290, 292, 1, 0, 0, 0, 291, 280, 1, 0, 0, 0, 291, 292, 1, 0, 0, 0, 292, 293, 1, 0, 0, 0, 293, 298, 5, 24, 0, 0, 294, 298, 5, 68, 0, 0, 295, 298, 5, 69, 0, 0, 296, 298, 3, 50, 25, 0, 297, 244, 1, 0, 0, 0, 297, 249, 1, 0, 0, 0, 297, 261, 1, 0, 0, 0, 297, 262, 1, 0, 0, 0, 297, 265, 1, 0, 0, 0, 297, 271, 1, 0, 0, 0, 297, 277, 1, 0, 0, 0, 297, 279, 1, 0, 0, 0, 297, 294, 1, 0, 0, 0, 297, 295, 1, 0, 0, 0, 297, 296, 1, 0, 0, 0, 298, 340, 1, 0, 0, 0, 299, 300, 10, 13, 0, 0, 300, 301, 7, 5, 0, 0, 301, 339, 3, 46, 23, 14, 302, 303, 10, 12, 0, 0, 303, 304, 7, 6, 0, 0, 304, 339, 3, 46, 23, 13, 305, 306, 10, 11, 0, 0, 306, 307, 7, 7, 0, 0, 307, 339, 3, 46, 23, 12, 308, 309, 10, 10, 0, 0, 309, 310, 7, 8, 0, 0, 310, 339, 3, 46, 23, 11, 311, 312, 10, 9, 0, 0, 312, 313, 5, 47, 0, 0, 313, 339, 3, 46, 23, 10, 314, 315, 10, 8, 0, 0, 315, 316, 5, 4, 0, 0, 316, 339, 3, 46, 23, 9, 317, 318, 10, 7, 0, 0, 318, 319, 5, 48, 0, 0, 319, 339, 3, 46, 23, 8, 320, 321, 10, 6, 0, 0, 321, 322, 5, 49, 0, 0, 322, 339, 3, 46, 23, 7, 323, 324, 10, 5, 0, 0, 324, 325, 5, 50, 0, 0, 325, 339, 3, 46, 23, 6, 326, 327, 10, 19, 0, 0, 327, 328, 5, 23, 0, 0, 328, 329, 5, 61, 0, 0, 329, 339, 5, 24, 0, 0, 330, 331, 10, 16, 0, 0, 331, 339, 7, 9, 0, 0, 332, 333, 10, 15, 0, 0, 333, 334, 5, 38, 0, 0, 334, 335, 5, 15, 0, 0, 335, 336, 3, 46, 23, 0, 336, 337, 5, 17, 0, 0, 337, 339, 1, 0, 0, 0, 338, 299, 1, 0, 0, 0, 338, 302, 1, 0, 0, 0, 338, 305, 1, 0, 0, 0, 338, 308, 1, 0, 0, 0, 338, 311, 1, 0, 0, 0, 338, 314, 1, 0, 0, 0, 338, 317, 1, 0, 0, 0, 338, 320, 1, 0, 0, 0, 338, 323, 1, 0, 0, 0, 338, 326, 1, 0, 0, 0, 338, 330, 1, 0, 0, 0, 338, 332, 1, 0, 0, 0, 339, 342, 1, 0, 0, 0, 340, 338, 1, 0, 0, 0, 340, 341, 1, 0, 0, 0, 341, 47, 1, 0, 0, 0, 342, 340, 1, 0, 0, 0, 343, 344, 5, 51, 0, 0, 344, 49, 1, 0, 0, 0, 345, 351, 5, 59, 0, 0, 346, 351, 3, 52, 26, 0, 347, 351, 5, 64, 0, 0, 348, 351, 5, 65, 0, 0, 349, 351, 5, 66, 0, 0, 350, 345, 1, 0, 0, 0, 350, 346, 1, 0, 0, 0, 350, 347, 1, 0, 0, 0, 350, 348, 1, 0, 0, 0, 350, 349, 1, 0, 0, 0, 351, 51, 1, 0, 0, 0, 352, 354, 5, 61, 0, 0, 353, 355, 5, 60, 0, 0, 354, 353, 1, 0, 0, 0, 354, 355, 1, 0, 0, 0, 355, 53, 1, 0, 0, 0, 356, 357, 7, 10, 0, 0, 357, 55, 1, 0, 0, 0, 31, 59, 74, 77, 90, 102, 113, 117, 119, 130, 135, 144, 150, 179, 189, 201, 215, 219, 221, 234, 238, 240, 254, 257, 285, 289, 291, 297, 338, 340, 350, 354]
\ No newline at end of file
+[4, 1, 72, 365, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 2, 25, 7, 25, 2, 26, 7, 26, 2, 27, 7, 27, 2, 28, 7, 28, 1, 0, 5, 0, 60, 8, 0, 10, 0, 12, 0, 63, 9, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 1, 2, 1, 3, 1, 3, 3, 3, 77, 8, 3, 1, 4, 3, 4, 80, 8, 4, 1, 4, 1, 4, 1, 5, 1, 5, 1, 6, 1, 6, 1, 6, 1, 6, 1, 6, 5, 6, 91, 8, 6, 10, 6, 12, 6, 94, 9, 6, 1, 6, 1, 6, 1, 7, 1, 7, 1, 7, 1, 7, 1, 7, 5, 7, 103, 8, 7, 10, 7, 12, 7, 106, 9, 7, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 8, 5, 8, 114, 8, 8, 10, 8, 12, 8, 117, 9, 8, 1, 8, 3, 8, 120, 8, 8, 3, 8, 122, 8, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 9, 1, 10, 1, 10, 5, 10, 131, 8, 10, 10, 10, 12, 10, 134, 9, 10, 1, 10, 1, 10, 3, 10, 138, 8, 10, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 3, 11, 147, 8, 11, 1, 12, 1, 12, 5, 12, 151, 8, 12, 10, 12, 12, 12, 154, 9, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 14, 1, 14, 1, 14, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 3, 15, 182, 8, 15, 1, 15, 1, 15, 1, 15, 1, 16, 1, 16, 1, 16, 1, 16, 1, 16, 3, 16, 192, 8, 16, 1, 16, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 3, 17, 204, 8, 17, 1, 18, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 20, 1, 20, 3, 20, 214, 8, 20, 1, 21, 1, 21, 1, 21, 1, 21, 5, 21, 220, 8, 21, 10, 21, 12, 21, 223, 9, 21, 1, 21, 3, 21, 226, 8, 21, 3, 21, 228, 8, 21, 1, 21, 1, 21, 1, 22, 1, 22, 1, 22, 1, 23, 1, 23, 1, 23, 1, 23, 5, 23, 239, 8, 23, 10, 23, 12, 23, 242, 9, 23, 1, 23, 3, 23, 245, 8, 23, 3, 23, 247, 8, 23, 1, 23, 1, 23, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 3, 24, 261, 8, 24, 1, 24, 3, 24, 264, 8, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 5, 24, 290, 8, 24, 10, 24, 12, 24, 293, 9, 24, 1, 24, 3, 24, 296, 8, 24, 3, 24, 298, 8, 24, 1, 24, 1, 24, 1, 24, 1, 24, 3, 24, 304, 8, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 5, 24, 345, 8, 24, 10, 24, 12, 24, 348, 9, 24, 1, 25, 1, 25, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 3, 26, 357, 8, 26, 1, 27, 1, 27, 3, 27, 361, 8, 27, 1, 28, 1, 28, 1, 28, 0, 1, 48, 29, 0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, 52, 54, 56, 0, 10, 1, 0, 4, 10, 1, 0, 26, 30, 2, 0, 26, 30, 32, 35, 1, 0, 39, 40, 1, 0, 41, 43, 2, 0, 40, 40, 44, 44, 1, 0, 6, 9, 1, 0, 45, 46, 1, 0, 36, 37, 2, 0, 52, 57, 62, 62, 394, 0, 61, 1, 0, 0, 0, 2, 67, 1, 0, 0, 0, 4, 72, 1, 0, 0, 0, 6, 74, 1, 0, 0, 0, 8, 79, 1, 0, 0, 0, 10, 83, 1, 0, 0, 0, 12, 85, 1, 0, 0, 0, 14, 97, 1, 0, 0, 0, 16, 109, 1, 0, 0, 0, 18, 125, 1, 0, 0, 0, 20, 137, 1, 0, 0, 0, 22, 146, 1, 0, 0, 0, 24, 148, 1, 0, 0, 0, 26, 160, 1, 0, 0, 0, 28, 169, 1, 0, 0, 0, 30, 174, 1, 0, 0, 0, 32, 186, 1, 0, 0, 0, 34, 196, 1, 0, 0, 0, 36, 205, 1, 0, 0, 0, 38, 209, 1, 0, 0, 0, 40, 213, 1, 0, 0, 0, 42, 215, 1, 0, 0, 0, 44, 231, 1, 0, 0, 0, 46, 234, 1, 0, 0, 0, 48, 303, 1, 0, 0, 0, 50, 349, 1, 0, 0, 0, 52, 356, 1, 0, 0, 0, 54, 358, 1, 0, 0, 0, 56, 362, 1, 0, 0, 0, 58, 60, 3, 2, 1, 0, 59, 58, 1, 0, 0, 0, 60, 63, 1, 0, 0, 0, 61, 59, 1, 0, 0, 0, 61, 62, 1, 0, 0, 0, 62, 64, 1, 0, 0, 0, 63, 61, 1, 0, 0, 0, 64, 65, 3, 12, 6, 0, 65, 66, 5, 0, 0, 1, 66, 1, 1, 0, 0, 0, 67, 68, 5, 1, 0, 0, 68, 69, 3, 4, 2, 0, 69, 70, 3, 6, 3, 0, 70, 71, 5, 2, 0, 0, 71, 3, 1, 0, 0, 0, 72, 73, 5, 3, 0, 0, 73, 5, 1, 0, 0, 0, 74, 76, 3, 8, 4, 0, 75, 77, 3, 8, 4, 0, 76, 75, 1, 0, 0, 0, 76, 77, 1, 0, 0, 0, 77, 7, 1, 0, 0, 0, 78, 80, 3, 10, 5, 0, 79, 78, 1, 0, 0, 0, 79, 80, 1, 0, 0, 0, 80, 81, 1, 0, 0, 0, 81, 82, 5, 58, 0, 0, 82, 9, 1, 0, 0, 0, 83, 84, 7, 0, 0, 0, 84, 11, 1, 0, 0, 0, 85, 86, 5, 11, 0, 0, 86, 87, 5, 69, 0, 0, 87, 88, 3, 16, 8, 0, 88, 92, 5, 12, 0, 0, 89, 91, 3, 14, 7, 0, 90, 89, 1, 0, 0, 0, 91, 94, 1, 0, 0, 0, 92, 90, 1, 0, 0, 0, 92, 93, 1, 0, 0, 0, 93, 95, 1, 0, 0, 0, 94, 92, 1, 0, 0, 0, 95, 96, 5, 13, 0, 0, 96, 13, 1, 0, 0, 0, 97, 98, 5, 14, 0, 0, 98, 99, 5, 69, 0, 0, 99, 100, 3, 16, 8, 0, 100, 104, 5, 12, 0, 0, 101, 103, 3, 22, 11, 0, 102, 101, 1, 0, 0, 0, 103, 106, 1, 0, 0, 0, 104, 102, 1, 0, 0, 0, 104, 105, 1, 0, 0, 0, 105, 107, 1, 0, 0, 0, 106, 104, 1, 0, 0, 0, 107, 108, 5, 13, 0, 0, 108, 15, 1, 0, 0, 0, 109, 121, 5, 15, 0, 0, 110, 115, 3, 18, 9, 0, 111, 112, 5, 16, 0, 0, 112, 114, 3, 18, 9, 0, 113, 111, 1, 0, 0, 0, 114, 117, 1, 0, 0, 0, 115, 113, 1, 0, 0, 0, 115, 116, 1, 0, 0, 0, 116, 119, 1, 0, 0, 0, 117, 115, 1, 0, 0, 0, 118, 120, 5, 16, 0, 0, 119, 118, 1, 0, 0, 0, 119, 120, 1, 0, 0, 0, 120, 122, 1, 0, 0, 0, 121, 110, 1, 0, 0, 0, 121, 122, 1, 0, 0, 0, 122, 123, 1, 0, 0, 0, 123, 124, 5, 17, 0, 0, 124, 17, 1, 0, 0, 0, 125, 126, 3, 56, 28, 0, 126, 127, 5, 69, 0, 0, 127, 19, 1, 0, 0, 0, 128, 132, 5, 12, 0, 0, 129, 131, 3, 22, 11, 0, 130, 129, 1, 0, 0, 0, 131, 134, 1, 0, 0, 0, 132, 130, 1, 0, 0, 0, 132, 133, 1, 0, 0, 0, 133, 135, 1, 0, 0, 0, 134, 132, 1, 0, 0, 0, 135, 138, 5, 13, 0, 0, 136, 138, 3, 22, 11, 0, 137, 128, 1, 0, 0, 0, 137, 136, 1, 0, 0, 0, 138, 21, 1, 0, 0, 0, 139, 147, 3, 24, 12, 0, 140, 147, 3, 26, 13, 0, 141, 147, 3, 28, 14, 0, 142, 147, 3, 30, 15, 0, 143, 147, 3, 32, 16, 0, 144, 147, 3, 34, 17, 0, 145, 147, 3, 36, 18, 0, 146, 139, 1, 0, 0, 0, 146, 140, 1, 0, 0, 0, 146, 141, 1, 0, 0, 0, 146, 142, 1, 0, 0, 0, 146, 143, 1, 0, 0, 0, 146, 144, 1, 0, 0, 0, 146, 145, 1, 0, 0, 0, 147, 23, 1, 0, 0, 0, 148, 152, 3, 56, 28, 0, 149, 151, 3, 50, 25, 0, 150, 149, 1, 0, 0, 0, 151, 154, 1, 0, 0, 0, 152, 150, 1, 0, 0, 0, 152, 153, 1, 0, 0, 0, 153, 155, 1, 0, 0, 0, 154, 152, 1, 0, 0, 0, 155, 156, 5, 69, 0, 0, 156, 157, 5, 10, 0, 0, 157, 158, 3, 48, 24, 0, 158, 159, 5, 2, 0, 0, 159, 25, 1, 0, 0, 0, 160, 161, 3, 56, 28, 0, 161, 162, 5, 69, 0, 0, 162, 163, 5, 16, 0, 0, 163, 164, 3, 56, 28, 0, 164, 165, 5, 69, 0, 0, 165, 166, 5, 10, 0, 0, 166, 167, 3, 48, 24, 0, 167, 168, 5, 2, 0, 0, 168, 27, 1, 0, 0, 0, 169, 170, 5, 69, 0, 0, 170, 171, 5, 10, 0, 0, 171, 172, 3, 48, 24, 0, 172, 173, 5, 2, 0, 0, 173, 29, 1, 0, 0, 0, 174, 175, 5, 18, 0, 0, 175, 176, 5, 15, 0, 0, 176, 177, 5, 67, 0, 0, 177, 178, 5, 6, 0, 0, 178, 181, 3, 48, 24, 0, 179, 180, 5, 16, 0, 0, 180, 182, 3, 38, 19, 0, 181, 179, 1, 0, 0, 0, 181, 182, 1, 0, 0, 0, 182, 183, 1, 0, 0, 0, 183, 184, 5, 17, 0, 0, 184, 185, 5, 2, 0, 0, 185, 31, 1, 0, 0, 0, 186, 187, 5, 18, 0, 0, 187, 188, 5, 15, 0, 0, 188, 191, 3, 48, 24, 0, 189, 190, 5, 16, 0, 0, 190, 192, 3, 38, 19, 0, 191, 189, 1, 0, 0, 0, 191, 192, 1, 0, 0, 0, 192, 193, 1, 0, 0, 0, 193, 194, 5, 17, 0, 0, 194, 195, 5, 2, 0, 0, 195, 33, 1, 0, 0, 0, 196, 197, 5, 19, 0, 0, 197, 198, 5, 15, 0, 0, 198, 199, 3, 48, 24, 0, 199, 200, 5, 17, 0, 0, 200, 203, 3, 20, 10, 0, 201, 202, 5, 20, 0, 0, 202, 204, 3, 20, 10, 0, 203, 201, 1, 0, 0, 0, 203, 204, 1, 0, 0, 0, 204, 35, 1, 0, 0, 0, 205, 206, 5, 21, 0, 0, 206, 207, 3, 42, 21, 0, 207, 208, 5, 2, 0, 0, 208, 37, 1, 0, 0, 0, 209, 210, 5, 64, 0, 0, 210, 39, 1, 0, 0, 0, 211, 214, 5, 69, 0, 0, 212, 214, 3, 52, 26, 0, 213, 211, 1, 0, 0, 0, 213, 212, 1, 0, 0, 0, 214, 41, 1, 0, 0, 0, 215, 227, 5, 15, 0, 0, 216, 221, 3, 40, 20, 0, 217, 218, 5, 16, 0, 0, 218, 220, 3, 40, 20, 0, 219, 217, 1, 0, 0, 0, 220, 223, 1, 0, 0, 0, 221, 219, 1, 0, 0, 0, 221, 222, 1, 0, 0, 0, 222, 225, 1, 0, 0, 0, 223, 221, 1, 0, 0, 0, 224, 226, 5, 16, 0, 0, 225, 224, 1, 0, 0, 0, 225, 226, 1, 0, 0, 0, 226, 228, 1, 0, 0, 0, 227, 216, 1, 0, 0, 0, 227, 228, 1, 0, 0, 0, 228, 229, 1, 0, 0, 0, 229, 230, 5, 17, 0, 0, 230, 43, 1, 0, 0, 0, 231, 232, 5, 69, 0, 0, 232, 233, 3, 46, 23, 0, 233, 45, 1, 0, 0, 0, 234, 246, 5, 15, 0, 0, 235, 240, 3, 48, 24, 0, 236, 237, 5, 16, 0, 0, 237, 239, 3, 48, 24, 0, 238, 236, 1, 0, 0, 0, 239, 242, 1, 0, 0, 0, 240, 238, 1, 0, 0, 0, 240, 241, 1, 0, 0, 0, 241, 244, 1, 0, 0, 0, 242, 240, 1, 0, 0, 0, 243, 245, 5, 16, 0, 0, 244, 243, 1, 0, 0, 0, 244, 245, 1, 0, 0, 0, 245, 247, 1, 0, 0, 0, 246, 235, 1, 0, 0, 0, 246, 247, 1, 0, 0, 0, 247, 248, 1, 0, 0, 0, 248, 249, 5, 17, 0, 0, 249, 47, 1, 0, 0, 0, 250, 251, 6, 24, -1, 0, 251, 252, 5, 15, 0, 0, 252, 253, 3, 48, 24, 0, 253, 254, 5, 17, 0, 0, 254, 304, 1, 0, 0, 0, 255, 256, 3, 56, 28, 0, 256, 257, 5, 15, 0, 0, 257, 260, 3, 48, 24, 0, 258, 259, 5, 16, 0, 0, 259, 261, 3, 48, 24, 0, 260, 258, 1, 0, 0, 0, 260, 261, 1, 0, 0, 0, 261, 263, 1, 0, 0, 0, 262, 264, 5, 16, 0, 0, 263, 262, 1, 0, 0, 0, 263, 264, 1, 0, 0, 0, 264, 265, 1, 0, 0, 0, 265, 266, 5, 17, 0, 0, 266, 304, 1, 0, 0, 0, 267, 304, 3, 44, 22, 0, 268, 269, 5, 22, 0, 0, 269, 270, 5, 69, 0, 0, 270, 304, 3, 46, 23, 0, 271, 272, 5, 25, 0, 0, 272, 273, 5, 23, 0, 0, 273, 274, 3, 48, 24, 0, 274, 275, 5, 24, 0, 0, 275, 276, 7, 1, 0, 0, 276, 304, 1, 0, 0, 0, 277, 278, 5, 31, 0, 0, 278, 279, 5, 23, 0, 0, 279, 280, 3, 48, 24, 0, 280, 281, 5, 24, 0, 0, 281, 282, 7, 2, 0, 0, 282, 304, 1, 0, 0, 0, 283, 284, 7, 3, 0, 0, 284, 304, 3, 48, 24, 14, 285, 297, 5, 23, 0, 0, 286, 291, 3, 48, 24, 0, 287, 288, 5, 16, 0, 0, 288, 290, 3, 48, 24, 0, 289, 287, 1, 0, 0, 0, 290, 293, 1, 0, 0, 0, 291, 289, 1, 0, 0, 0, 291, 292, 1, 0, 0, 0, 292, 295, 1, 0, 0, 0, 293, 291, 1, 0, 0, 0, 294, 296, 5, 16, 0, 0, 295, 294, 1, 0, 0, 0, 295, 296, 1, 0, 0, 0, 296, 298, 1, 0, 0, 0, 297, 286, 1, 0, 0, 0, 297, 298, 1, 0, 0, 0, 298, 299, 1, 0, 0, 0, 299, 304, 5, 24, 0, 0, 300, 304, 5, 68, 0, 0, 301, 304, 5, 69, 0, 0, 302, 304, 3, 52, 26, 0, 303, 250, 1, 0, 0, 0, 303, 255, 1, 0, 0, 0, 303, 267, 1, 0, 0, 0, 303, 268, 1, 0, 0, 0, 303, 271, 1, 0, 0, 0, 303, 277, 1, 0, 0, 0, 303, 283, 1, 0, 0, 0, 303, 285, 1, 0, 0, 0, 303, 300, 1, 0, 0, 0, 303, 301, 1, 0, 0, 0, 303, 302, 1, 0, 0, 0, 304, 346, 1, 0, 0, 0, 305, 306, 10, 13, 0, 0, 306, 307, 7, 4, 0, 0, 307, 345, 3, 48, 24, 14, 308, 309, 10, 12, 0, 0, 309, 310, 7, 5, 0, 0, 310, 345, 3, 48, 24, 13, 311, 312, 10, 11, 0, 0, 312, 313, 7, 6, 0, 0, 313, 345, 3, 48, 24, 12, 314, 315, 10, 10, 0, 0, 315, 316, 7, 7, 0, 0, 316, 345, 3, 48, 24, 11, 317, 318, 10, 9, 0, 0, 318, 319, 5, 47, 0, 0, 319, 345, 3, 48, 24, 10, 320, 321, 10, 8, 0, 0, 321, 322, 5, 4, 0, 0, 322, 345, 3, 48, 24, 9, 323, 324, 10, 7, 0, 0, 324, 325, 5, 48, 0, 0, 325, 345, 3, 48, 24, 8, 326, 327, 10, 6, 0, 0, 327, 328, 5, 49, 0, 0, 328, 345, 3, 48, 24, 7, 329, 330, 10, 5, 0, 0, 330, 331, 5, 50, 0, 0, 331, 345, 3, 48, 24, 6, 332, 333, 10, 19, 0, 0, 333, 334, 5, 23, 0, 0, 334, 335, 5, 61, 0, 0, 335, 345, 5, 24, 0, 0, 336, 337, 10, 16, 0, 0, 337, 345, 7, 8, 0, 0, 338, 339, 10, 15, 0, 0, 339, 340, 5, 38, 0, 0, 340, 341, 5, 15, 0, 0, 341, 342, 3, 48, 24, 0, 342, 343, 5, 17, 0, 0, 343, 345, 1, 0, 0, 0, 344, 305, 1, 0, 0, 0, 344, 308, 1, 0, 0, 0, 344, 311, 1, 0, 0, 0, 344, 314, 1, 0, 0, 0, 344, 317, 1, 0, 0, 0, 344, 320, 1, 0, 0, 0, 344, 323, 1, 0, 0, 0, 344, 326, 1, 0, 0, 0, 344, 329, 1, 0, 0, 0, 344, 332, 1, 0, 0, 0, 344, 336, 1, 0, 0, 0, 344, 338, 1, 0, 0, 0, 345, 348, 1, 0, 0, 0, 346, 344, 1, 0, 0, 0, 346, 347, 1, 0, 0, 0, 347, 49, 1, 0, 0, 0, 348, 346, 1, 0, 0, 0, 349, 350, 5, 51, 0, 0, 350, 51, 1, 0, 0, 0, 351, 357, 5, 59, 0, 0, 352, 357, 3, 54, 27, 0, 353, 357, 5, 64, 0, 0, 354, 357, 5, 65, 0, 0, 355, 357, 5, 66, 0, 0, 356, 351, 1, 0, 0, 0, 356, 352, 1, 0, 0, 0, 356, 353, 1, 0, 0, 0, 356, 354, 1, 0, 0, 0, 356, 355, 1, 0, 0, 0, 357, 53, 1, 0, 0, 0, 358, 360, 5, 61, 0, 0, 359, 361, 5, 60, 0, 0, 360, 359, 1, 0, 0, 0, 360, 361, 1, 0, 0, 0, 361, 55, 1, 0, 0, 0, 362, 363, 7, 9, 0, 0, 363, 57, 1, 0, 0, 0, 32, 61, 76, 79, 92, 104, 115, 119, 121, 132, 137, 146, 152, 181, 191, 203, 213, 221, 225, 227, 240, 244, 246, 260, 263, 291, 295, 297, 303, 344, 346, 356, 360]
\ No newline at end of file
diff --git a/packages/cashc/src/grammar/CashScriptParser.ts b/packages/cashc/src/grammar/CashScriptParser.ts
index 88ca96fb..834c589b 100644
--- a/packages/cashc/src/grammar/CashScriptParser.ts
+++ b/packages/cashc/src/grammar/CashScriptParser.ts
@@ -110,104 +110,105 @@ export default class CashScriptParser extends Parser {
 	public static readonly RULE_requireStatement = 16;
 	public static readonly RULE_ifStatement = 17;
 	public static readonly RULE_consoleStatement = 18;
-	public static readonly RULE_consoleParameter = 19;
-	public static readonly RULE_consoleParameterList = 20;
-	public static readonly RULE_functionCall = 21;
-	public static readonly RULE_expressionList = 22;
-	public static readonly RULE_expression = 23;
-	public static readonly RULE_modifier = 24;
-	public static readonly RULE_literal = 25;
-	public static readonly RULE_numberLiteral = 26;
-	public static readonly RULE_typeName = 27;
-	public static readonly literalNames: (string | null)[] = [ null, "'pragma'",
-                                                            "';'", "'cashscript'",
-                                                            "'^'", "'~'",
-                                                            "'>='", "'>'",
-                                                            "'<'", "'<='",
-                                                            "'='", "'contract'",
-                                                            "'{'", "'}'",
-                                                            "'function'",
-                                                            "'('", "','",
-                                                            "')'", "'require'",
-                                                            "'if'", "'else'",
-                                                            "'console.log'",
-                                                            "'new'", "'['",
-                                                            "']'", "'tx.outputs'",
-                                                            "'.value'",
-                                                            "'.lockingBytecode'",
-                                                            "'.tokenCategory'",
-                                                            "'.nftCommitment'",
-                                                            "'.tokenAmount'",
-                                                            "'tx.inputs'",
-                                                            "'.outpointTransactionHash'",
-                                                            "'.outpointIndex'",
-                                                            "'.unlockingBytecode'",
-                                                            "'.sequenceNumber'",
-                                                            "'.reverse()'",
-                                                            "'.length'",
-                                                            "'.split'",
-                                                            "'!'", "'-'",
-                                                            "'*'", "'/'",
-                                                            "'%'", "'+'",
-                                                            "'=='", "'!='",
-                                                            "'&'", "'|'",
-                                                            "'&&'", "'||'",
-                                                            "'constant'",
-                                                            "'int'", "'bool'",
-                                                            "'string'",
-                                                            "'pubkey'",
+	public static readonly RULE_requireMessage = 19;
+	public static readonly RULE_consoleParameter = 20;
+	public static readonly RULE_consoleParameterList = 21;
+	public static readonly RULE_functionCall = 22;
+	public static readonly RULE_expressionList = 23;
+	public static readonly RULE_expression = 24;
+	public static readonly RULE_modifier = 25;
+	public static readonly RULE_literal = 26;
+	public static readonly RULE_numberLiteral = 27;
+	public static readonly RULE_typeName = 28;
+	public static readonly literalNames: (string | null)[] = [ null, "'pragma'", 
+                                                            "';'", "'cashscript'", 
+                                                            "'^'", "'~'", 
+                                                            "'>='", "'>'", 
+                                                            "'<'", "'<='", 
+                                                            "'='", "'contract'", 
+                                                            "'{'", "'}'", 
+                                                            "'function'", 
+                                                            "'('", "','", 
+                                                            "')'", "'require'", 
+                                                            "'if'", "'else'", 
+                                                            "'console.log'", 
+                                                            "'new'", "'['", 
+                                                            "']'", "'tx.outputs'", 
+                                                            "'.value'", 
+                                                            "'.lockingBytecode'", 
+                                                            "'.tokenCategory'", 
+                                                            "'.nftCommitment'", 
+                                                            "'.tokenAmount'", 
+                                                            "'tx.inputs'", 
+                                                            "'.outpointTransactionHash'", 
+                                                            "'.outpointIndex'", 
+                                                            "'.unlockingBytecode'", 
+                                                            "'.sequenceNumber'", 
+                                                            "'.reverse()'", 
+                                                            "'.length'", 
+                                                            "'.split'", 
+                                                            "'!'", "'-'", 
+                                                            "'*'", "'/'", 
+                                                            "'%'", "'+'", 
+                                                            "'=='", "'!='", 
+                                                            "'&'", "'|'", 
+                                                            "'&&'", "'||'", 
+                                                            "'constant'", 
+                                                            "'int'", "'bool'", 
+                                                            "'string'", 
+                                                            "'pubkey'", 
                                                             "'sig'", "'datasig'" ];
-	public static readonly symbolicNames: (string | null)[] = [ null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             null, null,
-                                                             "VersionLiteral",
-                                                             "BooleanLiteral",
-                                                             "NumberUnit",
-                                                             "NumberLiteral",
-                                                             "Bytes", "Bound",
-                                                             "StringLiteral",
-                                                             "DateLiteral",
-                                                             "HexLiteral",
-                                                             "TxVar", "NullaryOp",
-                                                             "Identifier",
-                                                             "WHITESPACE",
-                                                             "COMMENT",
+	public static readonly symbolicNames: (string | null)[] = [ null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             null, null, 
+                                                             "VersionLiteral", 
+                                                             "BooleanLiteral", 
+                                                             "NumberUnit", 
+                                                             "NumberLiteral", 
+                                                             "Bytes", "Bound", 
+                                                             "StringLiteral", 
+                                                             "DateLiteral", 
+                                                             "HexLiteral", 
+                                                             "TxVar", "NullaryOp", 
+                                                             "Identifier", 
+                                                             "WHITESPACE", 
+                                                             "COMMENT", 
                                                              "LINE_COMMENT" ];
 	// tslint:disable:no-trailing-whitespace
 	public static readonly ruleNames: string[] = [
-		"sourceFile", "pragmaDirective", "pragmaName", "pragmaValue", "versionConstraint",
-		"versionOperator", "contractDefinition", "functionDefinition", "parameterList",
-		"parameter", "block", "statement", "variableDefinition", "tupleAssignment",
-		"assignStatement", "timeOpStatement", "requireStatement", "ifStatement",
-		"consoleStatement", "consoleParameter", "consoleParameterList", "functionCall",
-		"expressionList", "expression", "modifier", "literal", "numberLiteral",
-		"typeName",
+		"sourceFile", "pragmaDirective", "pragmaName", "pragmaValue", "versionConstraint", 
+		"versionOperator", "contractDefinition", "functionDefinition", "parameterList", 
+		"parameter", "block", "statement", "variableDefinition", "tupleAssignment", 
+		"assignStatement", "timeOpStatement", "requireStatement", "ifStatement", 
+		"consoleStatement", "requireMessage", "consoleParameter", "consoleParameterList", 
+		"functionCall", "expressionList", "expression", "modifier", "literal", 
+		"numberLiteral", "typeName",
 	];
 	public get grammarFileName(): string { return "CashScript.g4"; }
 	public get literalNames(): (string | null)[] { return CashScriptParser.literalNames; }
@@ -231,23 +232,23 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 59;
+			this.state = 61;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			while (_la===1) {
 				{
 				{
-				this.state = 56;
+				this.state = 58;
 				this.pragmaDirective();
 				}
 				}
-				this.state = 61;
+				this.state = 63;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 			}
-			this.state = 62;
+			this.state = 64;
 			this.contractDefinition();
-			this.state = 63;
+			this.state = 65;
 			this.match(CashScriptParser.EOF);
 			}
 		}
@@ -272,13 +273,13 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 65;
+			this.state = 67;
 			this.match(CashScriptParser.T__0);
-			this.state = 66;
+			this.state = 68;
 			this.pragmaName();
-			this.state = 67;
+			this.state = 69;
 			this.pragmaValue();
-			this.state = 68;
+			this.state = 70;
 			this.match(CashScriptParser.T__1);
 			}
 		}
@@ -303,7 +304,7 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 70;
+			this.state = 72;
 			this.match(CashScriptParser.T__2);
 			}
 		}
@@ -329,14 +330,14 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 72;
-			this.versionConstraint();
 			this.state = 74;
+			this.versionConstraint();
+			this.state = 76;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2032) !== 0) || _la===58) {
 				{
-				this.state = 73;
+				this.state = 75;
 				this.versionConstraint();
 				}
 			}
@@ -365,17 +366,17 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 77;
+			this.state = 79;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2032) !== 0)) {
 				{
-				this.state = 76;
+				this.state = 78;
 				this.versionOperator();
 				}
 			}
 
-			this.state = 79;
+			this.state = 81;
 			this.match(CashScriptParser.VersionLiteral);
 			}
 		}
@@ -401,7 +402,7 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 81;
+			this.state = 83;
 			_la = this._input.LA(1);
 			if(!((((_la) & ~0x1F) === 0 && ((1 << _la) & 2032) !== 0))) {
 			this._errHandler.recoverInline(this);
@@ -434,29 +435,29 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 83;
+			this.state = 85;
 			this.match(CashScriptParser.T__10);
-			this.state = 84;
+			this.state = 86;
 			this.match(CashScriptParser.Identifier);
-			this.state = 85;
+			this.state = 87;
 			this.parameterList();
-			this.state = 86;
+			this.state = 88;
 			this.match(CashScriptParser.T__11);
-			this.state = 90;
+			this.state = 92;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			while (_la===14) {
 				{
 				{
-				this.state = 87;
+				this.state = 89;
 				this.functionDefinition();
 				}
 				}
-				this.state = 92;
+				this.state = 94;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 			}
-			this.state = 93;
+			this.state = 95;
 			this.match(CashScriptParser.T__12);
 			}
 		}
@@ -482,29 +483,29 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 95;
+			this.state = 97;
 			this.match(CashScriptParser.T__13);
-			this.state = 96;
+			this.state = 98;
 			this.match(CashScriptParser.Identifier);
-			this.state = 97;
+			this.state = 99;
 			this.parameterList();
-			this.state = 98;
+			this.state = 100;
 			this.match(CashScriptParser.T__11);
-			this.state = 102;
+			this.state = 104;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			while ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2883584) !== 0) || ((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 132159) !== 0)) {
 				{
 				{
-				this.state = 99;
+				this.state = 101;
 				this.statement();
 				}
 				}
-				this.state = 104;
+				this.state = 106;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 			}
-			this.state = 105;
+			this.state = 107;
 			this.match(CashScriptParser.T__12);
 			}
 		}
@@ -531,39 +532,39 @@ export default class CashScriptParser extends Parser {
 			let _alt: number;
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 107;
+			this.state = 109;
 			this.match(CashScriptParser.T__14);
-			this.state = 119;
+			this.state = 121;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			if (((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 1087) !== 0)) {
 				{
-				this.state = 108;
+				this.state = 110;
 				this.parameter();
-				this.state = 113;
+				this.state = 115;
 				this._errHandler.sync(this);
 				_alt = this._interp.adaptivePredict(this._input, 5, this._ctx);
 				while (_alt !== 2 && _alt !== ATN.INVALID_ALT_NUMBER) {
 					if (_alt === 1) {
 						{
 						{
-						this.state = 109;
+						this.state = 111;
 						this.match(CashScriptParser.T__15);
-						this.state = 110;
+						this.state = 112;
 						this.parameter();
 						}
 						}
 					}
-					this.state = 115;
+					this.state = 117;
 					this._errHandler.sync(this);
 					_alt = this._interp.adaptivePredict(this._input, 5, this._ctx);
 				}
-				this.state = 117;
+				this.state = 119;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 				if (_la===16) {
 					{
-					this.state = 116;
+					this.state = 118;
 					this.match(CashScriptParser.T__15);
 					}
 				}
@@ -571,7 +572,7 @@ export default class CashScriptParser extends Parser {
 				}
 			}
 
-			this.state = 121;
+			this.state = 123;
 			this.match(CashScriptParser.T__16);
 			}
 		}
@@ -596,9 +597,9 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 123;
+			this.state = 125;
 			this.typeName();
-			this.state = 124;
+			this.state = 126;
 			this.match(CashScriptParser.Identifier);
 			}
 		}
@@ -622,29 +623,29 @@ export default class CashScriptParser extends Parser {
 		this.enterRule(localctx, 20, CashScriptParser.RULE_block);
 		let _la: number;
 		try {
-			this.state = 135;
+			this.state = 137;
 			this._errHandler.sync(this);
 			switch (this._input.LA(1)) {
 			case 12:
 				this.enterOuterAlt(localctx, 1);
 				{
-				this.state = 126;
+				this.state = 128;
 				this.match(CashScriptParser.T__11);
-				this.state = 130;
+				this.state = 132;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 				while ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2883584) !== 0) || ((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 132159) !== 0)) {
 					{
 					{
-					this.state = 127;
+					this.state = 129;
 					this.statement();
 					}
 					}
-					this.state = 132;
+					this.state = 134;
 					this._errHandler.sync(this);
 					_la = this._input.LA(1);
 				}
-				this.state = 133;
+				this.state = 135;
 				this.match(CashScriptParser.T__12);
 				}
 				break;
@@ -661,7 +662,7 @@ export default class CashScriptParser extends Parser {
 			case 69:
 				this.enterOuterAlt(localctx, 2);
 				{
-				this.state = 134;
+				this.state = 136;
 				this.statement();
 				}
 				break;
@@ -688,55 +689,55 @@ export default class CashScriptParser extends Parser {
 		let localctx: StatementContext = new StatementContext(this, this._ctx, this.state);
 		this.enterRule(localctx, 22, CashScriptParser.RULE_statement);
 		try {
-			this.state = 144;
+			this.state = 146;
 			this._errHandler.sync(this);
 			switch ( this._interp.adaptivePredict(this._input, 10, this._ctx) ) {
 			case 1:
 				this.enterOuterAlt(localctx, 1);
 				{
-				this.state = 137;
+				this.state = 139;
 				this.variableDefinition();
 				}
 				break;
 			case 2:
 				this.enterOuterAlt(localctx, 2);
 				{
-				this.state = 138;
+				this.state = 140;
 				this.tupleAssignment();
 				}
 				break;
 			case 3:
 				this.enterOuterAlt(localctx, 3);
 				{
-				this.state = 139;
+				this.state = 141;
 				this.assignStatement();
 				}
 				break;
 			case 4:
 				this.enterOuterAlt(localctx, 4);
 				{
-				this.state = 140;
+				this.state = 142;
 				this.timeOpStatement();
 				}
 				break;
 			case 5:
 				this.enterOuterAlt(localctx, 5);
 				{
-				this.state = 141;
+				this.state = 143;
 				this.requireStatement();
 				}
 				break;
 			case 6:
 				this.enterOuterAlt(localctx, 6);
 				{
-				this.state = 142;
+				this.state = 144;
 				this.ifStatement();
 				}
 				break;
 			case 7:
 				this.enterOuterAlt(localctx, 7);
 				{
-				this.state = 143;
+				this.state = 145;
 				this.consoleStatement();
 				}
 				break;
@@ -764,29 +765,29 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 146;
+			this.state = 148;
 			this.typeName();
-			this.state = 150;
+			this.state = 152;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			while (_la===51) {
 				{
 				{
-				this.state = 147;
+				this.state = 149;
 				this.modifier();
 				}
 				}
-				this.state = 152;
+				this.state = 154;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 			}
-			this.state = 153;
+			this.state = 155;
 			this.match(CashScriptParser.Identifier);
-			this.state = 154;
+			this.state = 156;
 			this.match(CashScriptParser.T__9);
-			this.state = 155;
+			this.state = 157;
 			this.expression(0);
-			this.state = 156;
+			this.state = 158;
 			this.match(CashScriptParser.T__1);
 			}
 		}
@@ -811,21 +812,21 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 158;
+			this.state = 160;
 			this.typeName();
-			this.state = 159;
+			this.state = 161;
 			this.match(CashScriptParser.Identifier);
-			this.state = 160;
+			this.state = 162;
 			this.match(CashScriptParser.T__15);
-			this.state = 161;
+			this.state = 163;
 			this.typeName();
-			this.state = 162;
+			this.state = 164;
 			this.match(CashScriptParser.Identifier);
-			this.state = 163;
+			this.state = 165;
 			this.match(CashScriptParser.T__9);
-			this.state = 164;
+			this.state = 166;
 			this.expression(0);
-			this.state = 165;
+			this.state = 167;
 			this.match(CashScriptParser.T__1);
 			}
 		}
@@ -850,13 +851,13 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 167;
+			this.state = 169;
 			this.match(CashScriptParser.Identifier);
-			this.state = 168;
+			this.state = 170;
 			this.match(CashScriptParser.T__9);
-			this.state = 169;
+			this.state = 171;
 			this.expression(0);
-			this.state = 170;
+			this.state = 172;
 			this.match(CashScriptParser.T__1);
 			}
 		}
@@ -882,31 +883,31 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 172;
+			this.state = 174;
 			this.match(CashScriptParser.T__17);
-			this.state = 173;
+			this.state = 175;
 			this.match(CashScriptParser.T__14);
-			this.state = 174;
+			this.state = 176;
 			this.match(CashScriptParser.TxVar);
-			this.state = 175;
+			this.state = 177;
 			this.match(CashScriptParser.T__5);
-			this.state = 176;
+			this.state = 178;
 			this.expression(0);
-			this.state = 179;
+			this.state = 181;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			if (_la===16) {
 				{
-				this.state = 177;
+				this.state = 179;
 				this.match(CashScriptParser.T__15);
-				this.state = 178;
-				this.match(CashScriptParser.StringLiteral);
+				this.state = 180;
+				this.requireMessage();
 				}
 			}
 
-			this.state = 181;
+			this.state = 183;
 			this.match(CashScriptParser.T__16);
-			this.state = 182;
+			this.state = 184;
 			this.match(CashScriptParser.T__1);
 			}
 		}
@@ -932,27 +933,27 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 184;
+			this.state = 186;
 			this.match(CashScriptParser.T__17);
-			this.state = 185;
+			this.state = 187;
 			this.match(CashScriptParser.T__14);
-			this.state = 186;
+			this.state = 188;
 			this.expression(0);
-			this.state = 189;
+			this.state = 191;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			if (_la===16) {
 				{
-				this.state = 187;
+				this.state = 189;
 				this.match(CashScriptParser.T__15);
-				this.state = 188;
-				this.match(CashScriptParser.StringLiteral);
+				this.state = 190;
+				this.requireMessage();
 				}
 			}
 
-			this.state = 191;
+			this.state = 193;
 			this.match(CashScriptParser.T__16);
-			this.state = 192;
+			this.state = 194;
 			this.match(CashScriptParser.T__1);
 			}
 		}
@@ -977,24 +978,24 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 194;
+			this.state = 196;
 			this.match(CashScriptParser.T__18);
-			this.state = 195;
+			this.state = 197;
 			this.match(CashScriptParser.T__14);
-			this.state = 196;
+			this.state = 198;
 			this.expression(0);
-			this.state = 197;
+			this.state = 199;
 			this.match(CashScriptParser.T__16);
-			this.state = 198;
+			this.state = 200;
 			localctx._ifBlock = this.block();
-			this.state = 201;
+			this.state = 203;
 			this._errHandler.sync(this);
 			switch ( this._interp.adaptivePredict(this._input, 14, this._ctx) ) {
 			case 1:
 				{
-				this.state = 199;
+				this.state = 201;
 				this.match(CashScriptParser.T__19);
-				this.state = 200;
+				this.state = 202;
 				localctx._elseBlock = this.block();
 				}
 				break;
@@ -1022,11 +1023,11 @@ export default class CashScriptParser extends Parser {
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 203;
+			this.state = 205;
 			this.match(CashScriptParser.T__20);
-			this.state = 204;
+			this.state = 206;
 			this.consoleParameterList();
-			this.state = 205;
+			this.state = 207;
 			this.match(CashScriptParser.T__1);
 			}
 		}
@@ -1045,22 +1046,58 @@ export default class CashScriptParser extends Parser {
 		return localctx;
 	}
 	// @RuleVersion(0)
-	public consoleParameter(): ConsoleParameterContext {
-		let localctx: ConsoleParameterContext = new ConsoleParameterContext(this, this._ctx, this.state);
-		this.enterRule(localctx, 38, CashScriptParser.RULE_consoleParameter);
-		let _la: number;
+	public requireMessage(): RequireMessageContext {
+		let localctx: RequireMessageContext = new RequireMessageContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 38, CashScriptParser.RULE_requireMessage);
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 207;
-			_la = this._input.LA(1);
-			if(!(((((_la - 59)) & ~0x1F) === 0 && ((1 << (_la - 59)) & 1189) !== 0))) {
-			this._errHandler.recoverInline(this);
+			this.state = 209;
+			this.match(CashScriptParser.StringLiteral);
 			}
-			else {
-				this._errHandler.reportMatch(this);
-			    this.consume();
+		}
+		catch (re) {
+			if (re instanceof RecognitionException) {
+				localctx.exception = re;
+				this._errHandler.reportError(this, re);
+				this._errHandler.recover(this, re);
+			} else {
+				throw re;
 			}
+		}
+		finally {
+			this.exitRule();
+		}
+		return localctx;
+	}
+	// @RuleVersion(0)
+	public consoleParameter(): ConsoleParameterContext {
+		let localctx: ConsoleParameterContext = new ConsoleParameterContext(this, this._ctx, this.state);
+		this.enterRule(localctx, 40, CashScriptParser.RULE_consoleParameter);
+		try {
+			this.state = 213;
+			this._errHandler.sync(this);
+			switch (this._input.LA(1)) {
+			case 69:
+				this.enterOuterAlt(localctx, 1);
+				{
+				this.state = 211;
+				this.match(CashScriptParser.Identifier);
+				}
+				break;
+			case 59:
+			case 61:
+			case 64:
+			case 65:
+			case 66:
+				this.enterOuterAlt(localctx, 2);
+				{
+				this.state = 212;
+				this.literal();
+				}
+				break;
+			default:
+				throw new NoViableAltException(this);
 			}
 		}
 		catch (re) {
@@ -1080,45 +1117,45 @@ export default class CashScriptParser extends Parser {
 	// @RuleVersion(0)
 	public consoleParameterList(): ConsoleParameterListContext {
 		let localctx: ConsoleParameterListContext = new ConsoleParameterListContext(this, this._ctx, this.state);
-		this.enterRule(localctx, 40, CashScriptParser.RULE_consoleParameterList);
+		this.enterRule(localctx, 42, CashScriptParser.RULE_consoleParameterList);
 		let _la: number;
 		try {
 			let _alt: number;
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 209;
+			this.state = 215;
 			this.match(CashScriptParser.T__14);
-			this.state = 221;
+			this.state = 227;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			if (((((_la - 59)) & ~0x1F) === 0 && ((1 << (_la - 59)) & 1189) !== 0)) {
+			if (((((_la - 59)) & ~0x1F) === 0 && ((1 << (_la - 59)) & 1253) !== 0)) {
 				{
-				this.state = 210;
+				this.state = 216;
 				this.consoleParameter();
-				this.state = 215;
+				this.state = 221;
 				this._errHandler.sync(this);
-				_alt = this._interp.adaptivePredict(this._input, 15, this._ctx);
+				_alt = this._interp.adaptivePredict(this._input, 16, this._ctx);
 				while (_alt !== 2 && _alt !== ATN.INVALID_ALT_NUMBER) {
 					if (_alt === 1) {
 						{
 						{
-						this.state = 211;
+						this.state = 217;
 						this.match(CashScriptParser.T__15);
-						this.state = 212;
+						this.state = 218;
 						this.consoleParameter();
 						}
 						}
 					}
-					this.state = 217;
+					this.state = 223;
 					this._errHandler.sync(this);
-					_alt = this._interp.adaptivePredict(this._input, 15, this._ctx);
+					_alt = this._interp.adaptivePredict(this._input, 16, this._ctx);
 				}
-				this.state = 219;
+				this.state = 225;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 				if (_la===16) {
 					{
-					this.state = 218;
+					this.state = 224;
 					this.match(CashScriptParser.T__15);
 					}
 				}
@@ -1126,7 +1163,7 @@ export default class CashScriptParser extends Parser {
 				}
 			}
 
-			this.state = 223;
+			this.state = 229;
 			this.match(CashScriptParser.T__16);
 			}
 		}
@@ -1147,13 +1184,13 @@ export default class CashScriptParser extends Parser {
 	// @RuleVersion(0)
 	public functionCall(): FunctionCallContext {
 		let localctx: FunctionCallContext = new FunctionCallContext(this, this._ctx, this.state);
-		this.enterRule(localctx, 42, CashScriptParser.RULE_functionCall);
+		this.enterRule(localctx, 44, CashScriptParser.RULE_functionCall);
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 225;
+			this.state = 231;
 			this.match(CashScriptParser.Identifier);
-			this.state = 226;
+			this.state = 232;
 			this.expressionList();
 			}
 		}
@@ -1174,45 +1211,45 @@ export default class CashScriptParser extends Parser {
 	// @RuleVersion(0)
 	public expressionList(): ExpressionListContext {
 		let localctx: ExpressionListContext = new ExpressionListContext(this, this._ctx, this.state);
-		this.enterRule(localctx, 44, CashScriptParser.RULE_expressionList);
+		this.enterRule(localctx, 46, CashScriptParser.RULE_expressionList);
 		let _la: number;
 		try {
 			let _alt: number;
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 228;
+			this.state = 234;
 			this.match(CashScriptParser.T__14);
-			this.state = 240;
+			this.state = 246;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
 			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2193653760) !== 0) || ((((_la - 39)) & ~0x1F) === 0 && ((1 << (_la - 39)) & 1859641347) !== 0)) {
 				{
-				this.state = 229;
+				this.state = 235;
 				this.expression(0);
-				this.state = 234;
+				this.state = 240;
 				this._errHandler.sync(this);
-				_alt = this._interp.adaptivePredict(this._input, 18, this._ctx);
+				_alt = this._interp.adaptivePredict(this._input, 19, this._ctx);
 				while (_alt !== 2 && _alt !== ATN.INVALID_ALT_NUMBER) {
 					if (_alt === 1) {
 						{
 						{
-						this.state = 230;
+						this.state = 236;
 						this.match(CashScriptParser.T__15);
-						this.state = 231;
+						this.state = 237;
 						this.expression(0);
 						}
 						}
 					}
-					this.state = 236;
+					this.state = 242;
 					this._errHandler.sync(this);
-					_alt = this._interp.adaptivePredict(this._input, 18, this._ctx);
+					_alt = this._interp.adaptivePredict(this._input, 19, this._ctx);
 				}
-				this.state = 238;
+				this.state = 244;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 				if (_la===16) {
 					{
-					this.state = 237;
+					this.state = 243;
 					this.match(CashScriptParser.T__15);
 					}
 				}
@@ -1220,7 +1257,7 @@ export default class CashScriptParser extends Parser {
 				}
 			}
 
-			this.state = 242;
+			this.state = 248;
 			this.match(CashScriptParser.T__16);
 			}
 		}
@@ -1251,27 +1288,27 @@ export default class CashScriptParser extends Parser {
 		let _parentState: number = this.state;
 		let localctx: ExpressionContext = new ExpressionContext(this, this._ctx, _parentState);
 		let _prevctx: ExpressionContext = localctx;
-		let _startState: number = 46;
-		this.enterRecursionRule(localctx, 46, CashScriptParser.RULE_expression, _p);
+		let _startState: number = 48;
+		this.enterRecursionRule(localctx, 48, CashScriptParser.RULE_expression, _p);
 		let _la: number;
 		try {
 			let _alt: number;
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 297;
+			this.state = 303;
 			this._errHandler.sync(this);
-			switch ( this._interp.adaptivePredict(this._input, 26, this._ctx) ) {
+			switch ( this._interp.adaptivePredict(this._input, 27, this._ctx) ) {
 			case 1:
 				{
 				localctx = new ParenthesisedContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
 
-				this.state = 245;
+				this.state = 251;
 				this.match(CashScriptParser.T__14);
-				this.state = 246;
+				this.state = 252;
 				this.expression(0);
-				this.state = 247;
+				this.state = 253;
 				this.match(CashScriptParser.T__16);
 				}
 				break;
@@ -1280,35 +1317,35 @@ export default class CashScriptParser extends Parser {
 				localctx = new CastContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 249;
+				this.state = 255;
 				this.typeName();
-				this.state = 250;
+				this.state = 256;
 				this.match(CashScriptParser.T__14);
-				this.state = 251;
+				this.state = 257;
 				(localctx as CastContext)._castable = this.expression(0);
-				this.state = 254;
+				this.state = 260;
 				this._errHandler.sync(this);
-				switch ( this._interp.adaptivePredict(this._input, 21, this._ctx) ) {
+				switch ( this._interp.adaptivePredict(this._input, 22, this._ctx) ) {
 				case 1:
 					{
-					this.state = 252;
+					this.state = 258;
 					this.match(CashScriptParser.T__15);
-					this.state = 253;
+					this.state = 259;
 					(localctx as CastContext)._size = this.expression(0);
 					}
 					break;
 				}
-				this.state = 257;
+				this.state = 263;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 				if (_la===16) {
 					{
-					this.state = 256;
+					this.state = 262;
 					this.match(CashScriptParser.T__15);
 					}
 				}
 
-				this.state = 259;
+				this.state = 265;
 				this.match(CashScriptParser.T__16);
 				}
 				break;
@@ -1317,7 +1354,7 @@ export default class CashScriptParser extends Parser {
 				localctx = new FunctionCallExpressionContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 261;
+				this.state = 267;
 				this.functionCall();
 				}
 				break;
@@ -1326,11 +1363,11 @@ export default class CashScriptParser extends Parser {
 				localctx = new InstantiationContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 262;
+				this.state = 268;
 				this.match(CashScriptParser.T__21);
-				this.state = 263;
+				this.state = 269;
 				this.match(CashScriptParser.Identifier);
-				this.state = 264;
+				this.state = 270;
 				this.expressionList();
 				}
 				break;
@@ -1339,15 +1376,15 @@ export default class CashScriptParser extends Parser {
 				localctx = new UnaryIntrospectionOpContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 265;
+				this.state = 271;
 				(localctx as UnaryIntrospectionOpContext)._scope = this.match(CashScriptParser.T__24);
-				this.state = 266;
+				this.state = 272;
 				this.match(CashScriptParser.T__22);
-				this.state = 267;
+				this.state = 273;
 				this.expression(0);
-				this.state = 268;
+				this.state = 274;
 				this.match(CashScriptParser.T__23);
-				this.state = 269;
+				this.state = 275;
 				(localctx as UnaryIntrospectionOpContext)._op = this._input.LT(1);
 				_la = this._input.LA(1);
 				if(!((((_la) & ~0x1F) === 0 && ((1 << _la) & 2080374784) !== 0))) {
@@ -1364,15 +1401,15 @@ export default class CashScriptParser extends Parser {
 				localctx = new UnaryIntrospectionOpContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 271;
+				this.state = 277;
 				(localctx as UnaryIntrospectionOpContext)._scope = this.match(CashScriptParser.T__30);
-				this.state = 272;
+				this.state = 278;
 				this.match(CashScriptParser.T__22);
-				this.state = 273;
+				this.state = 279;
 				this.expression(0);
-				this.state = 274;
+				this.state = 280;
 				this.match(CashScriptParser.T__23);
-				this.state = 275;
+				this.state = 281;
 				(localctx as UnaryIntrospectionOpContext)._op = this._input.LT(1);
 				_la = this._input.LA(1);
 				if(!(((((_la - 26)) & ~0x1F) === 0 && ((1 << (_la - 26)) & 991) !== 0))) {
@@ -1389,7 +1426,7 @@ export default class CashScriptParser extends Parser {
 				localctx = new UnaryOpContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 277;
+				this.state = 283;
 				(localctx as UnaryOpContext)._op = this._input.LT(1);
 				_la = this._input.LA(1);
 				if(!(_la===39 || _la===40)) {
@@ -1399,7 +1436,7 @@ export default class CashScriptParser extends Parser {
 					this._errHandler.reportMatch(this);
 				    this.consume();
 				}
-				this.state = 278;
+				this.state = 284;
 				this.expression(14);
 				}
 				break;
@@ -1408,39 +1445,39 @@ export default class CashScriptParser extends Parser {
 				localctx = new ArrayContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 279;
+				this.state = 285;
 				this.match(CashScriptParser.T__22);
-				this.state = 291;
+				this.state = 297;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
 				if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2193653760) !== 0) || ((((_la - 39)) & ~0x1F) === 0 && ((1 << (_la - 39)) & 1859641347) !== 0)) {
 					{
-					this.state = 280;
+					this.state = 286;
 					this.expression(0);
-					this.state = 285;
+					this.state = 291;
 					this._errHandler.sync(this);
-					_alt = this._interp.adaptivePredict(this._input, 23, this._ctx);
+					_alt = this._interp.adaptivePredict(this._input, 24, this._ctx);
 					while (_alt !== 2 && _alt !== ATN.INVALID_ALT_NUMBER) {
 						if (_alt === 1) {
 							{
 							{
-							this.state = 281;
+							this.state = 287;
 							this.match(CashScriptParser.T__15);
-							this.state = 282;
+							this.state = 288;
 							this.expression(0);
 							}
 							}
 						}
-						this.state = 287;
+						this.state = 293;
 						this._errHandler.sync(this);
-						_alt = this._interp.adaptivePredict(this._input, 23, this._ctx);
+						_alt = this._interp.adaptivePredict(this._input, 24, this._ctx);
 					}
-					this.state = 289;
+					this.state = 295;
 					this._errHandler.sync(this);
 					_la = this._input.LA(1);
 					if (_la===16) {
 						{
-						this.state = 288;
+						this.state = 294;
 						this.match(CashScriptParser.T__15);
 						}
 					}
@@ -1448,7 +1485,7 @@ export default class CashScriptParser extends Parser {
 					}
 				}
 
-				this.state = 293;
+				this.state = 299;
 				this.match(CashScriptParser.T__23);
 				}
 				break;
@@ -1457,7 +1494,7 @@ export default class CashScriptParser extends Parser {
 				localctx = new NullaryOpContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 294;
+				this.state = 300;
 				this.match(CashScriptParser.NullaryOp);
 				}
 				break;
@@ -1466,7 +1503,7 @@ export default class CashScriptParser extends Parser {
 				localctx = new IdentifierContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 295;
+				this.state = 301;
 				this.match(CashScriptParser.Identifier);
 				}
 				break;
@@ -1475,15 +1512,15 @@ export default class CashScriptParser extends Parser {
 				localctx = new LiteralExpressionContext(this, localctx);
 				this._ctx = localctx;
 				_prevctx = localctx;
-				this.state = 296;
+				this.state = 302;
 				this.literal();
 				}
 				break;
 			}
 			this._ctx.stop = this._input.LT(-1);
-			this.state = 340;
+			this.state = 346;
 			this._errHandler.sync(this);
-			_alt = this._interp.adaptivePredict(this._input, 28, this._ctx);
+			_alt = this._interp.adaptivePredict(this._input, 29, this._ctx);
 			while (_alt !== 2 && _alt !== ATN.INVALID_ALT_NUMBER) {
 				if (_alt === 1) {
 					if (this._parseListeners != null) {
@@ -1491,19 +1528,19 @@ export default class CashScriptParser extends Parser {
 					}
 					_prevctx = localctx;
 					{
-					this.state = 338;
+					this.state = 344;
 					this._errHandler.sync(this);
-					switch ( this._interp.adaptivePredict(this._input, 27, this._ctx) ) {
+					switch ( this._interp.adaptivePredict(this._input, 28, this._ctx) ) {
 					case 1:
 						{
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 299;
+						this.state = 305;
 						if (!(this.precpred(this._ctx, 13))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 13)");
 						}
-						this.state = 300;
+						this.state = 306;
 						(localctx as BinaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
 						if(!(((((_la - 41)) & ~0x1F) === 0 && ((1 << (_la - 41)) & 7) !== 0))) {
@@ -1513,7 +1550,7 @@ export default class CashScriptParser extends Parser {
 							this._errHandler.reportMatch(this);
 						    this.consume();
 						}
-						this.state = 301;
+						this.state = 307;
 						(localctx as BinaryOpContext)._right = this.expression(14);
 						}
 						break;
@@ -1522,11 +1559,11 @@ export default class CashScriptParser extends Parser {
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 302;
+						this.state = 308;
 						if (!(this.precpred(this._ctx, 12))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 12)");
 						}
-						this.state = 303;
+						this.state = 309;
 						(localctx as BinaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
 						if(!(_la===40 || _la===44)) {
@@ -1536,7 +1573,7 @@ export default class CashScriptParser extends Parser {
 							this._errHandler.reportMatch(this);
 						    this.consume();
 						}
-						this.state = 304;
+						this.state = 310;
 						(localctx as BinaryOpContext)._right = this.expression(13);
 						}
 						break;
@@ -1545,11 +1582,11 @@ export default class CashScriptParser extends Parser {
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 305;
+						this.state = 311;
 						if (!(this.precpred(this._ctx, 11))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 11)");
 						}
-						this.state = 306;
+						this.state = 312;
 						(localctx as BinaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
 						if(!((((_la) & ~0x1F) === 0 && ((1 << _la) & 960) !== 0))) {
@@ -1559,7 +1596,7 @@ export default class CashScriptParser extends Parser {
 							this._errHandler.reportMatch(this);
 						    this.consume();
 						}
-						this.state = 307;
+						this.state = 313;
 						(localctx as BinaryOpContext)._right = this.expression(12);
 						}
 						break;
@@ -1568,11 +1605,11 @@ export default class CashScriptParser extends Parser {
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 308;
+						this.state = 314;
 						if (!(this.precpred(this._ctx, 10))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 10)");
 						}
-						this.state = 309;
+						this.state = 315;
 						(localctx as BinaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
 						if(!(_la===45 || _la===46)) {
@@ -1582,7 +1619,7 @@ export default class CashScriptParser extends Parser {
 							this._errHandler.reportMatch(this);
 						    this.consume();
 						}
-						this.state = 310;
+						this.state = 316;
 						(localctx as BinaryOpContext)._right = this.expression(11);
 						}
 						break;
@@ -1591,13 +1628,13 @@ export default class CashScriptParser extends Parser {
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 311;
+						this.state = 317;
 						if (!(this.precpred(this._ctx, 9))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 9)");
 						}
-						this.state = 312;
+						this.state = 318;
 						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__46);
-						this.state = 313;
+						this.state = 319;
 						(localctx as BinaryOpContext)._right = this.expression(10);
 						}
 						break;
@@ -1606,13 +1643,13 @@ export default class CashScriptParser extends Parser {
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 314;
+						this.state = 320;
 						if (!(this.precpred(this._ctx, 8))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 8)");
 						}
-						this.state = 315;
+						this.state = 321;
 						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__3);
-						this.state = 316;
+						this.state = 322;
 						(localctx as BinaryOpContext)._right = this.expression(9);
 						}
 						break;
@@ -1621,13 +1658,13 @@ export default class CashScriptParser extends Parser {
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 317;
+						this.state = 323;
 						if (!(this.precpred(this._ctx, 7))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 7)");
 						}
-						this.state = 318;
+						this.state = 324;
 						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__47);
-						this.state = 319;
+						this.state = 325;
 						(localctx as BinaryOpContext)._right = this.expression(8);
 						}
 						break;
@@ -1636,13 +1673,13 @@ export default class CashScriptParser extends Parser {
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 320;
+						this.state = 326;
 						if (!(this.precpred(this._ctx, 6))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 6)");
 						}
-						this.state = 321;
+						this.state = 327;
 						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__48);
-						this.state = 322;
+						this.state = 328;
 						(localctx as BinaryOpContext)._right = this.expression(7);
 						}
 						break;
@@ -1651,13 +1688,13 @@ export default class CashScriptParser extends Parser {
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 323;
+						this.state = 329;
 						if (!(this.precpred(this._ctx, 5))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 5)");
 						}
-						this.state = 324;
+						this.state = 330;
 						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__49);
-						this.state = 325;
+						this.state = 331;
 						(localctx as BinaryOpContext)._right = this.expression(6);
 						}
 						break;
@@ -1665,15 +1702,15 @@ export default class CashScriptParser extends Parser {
 						{
 						localctx = new TupleIndexOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 326;
+						this.state = 332;
 						if (!(this.precpred(this._ctx, 19))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 19)");
 						}
-						this.state = 327;
+						this.state = 333;
 						this.match(CashScriptParser.T__22);
-						this.state = 328;
+						this.state = 334;
 						(localctx as TupleIndexOpContext)._index = this.match(CashScriptParser.NumberLiteral);
-						this.state = 329;
+						this.state = 335;
 						this.match(CashScriptParser.T__23);
 						}
 						break;
@@ -1681,11 +1718,11 @@ export default class CashScriptParser extends Parser {
 						{
 						localctx = new UnaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 330;
+						this.state = 336;
 						if (!(this.precpred(this._ctx, 16))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 16)");
 						}
-						this.state = 331;
+						this.state = 337;
 						(localctx as UnaryOpContext)._op = this._input.LT(1);
 						_la = this._input.LA(1);
 						if(!(_la===36 || _la===37)) {
@@ -1702,26 +1739,26 @@ export default class CashScriptParser extends Parser {
 						localctx = new BinaryOpContext(this, new ExpressionContext(this, _parentctx, _parentState));
 						(localctx as BinaryOpContext)._left = _prevctx;
 						this.pushNewRecursionContext(localctx, _startState, CashScriptParser.RULE_expression);
-						this.state = 332;
+						this.state = 338;
 						if (!(this.precpred(this._ctx, 15))) {
 							throw this.createFailedPredicateException("this.precpred(this._ctx, 15)");
 						}
-						this.state = 333;
+						this.state = 339;
 						(localctx as BinaryOpContext)._op = this.match(CashScriptParser.T__37);
-						this.state = 334;
+						this.state = 340;
 						this.match(CashScriptParser.T__14);
-						this.state = 335;
+						this.state = 341;
 						(localctx as BinaryOpContext)._right = this.expression(0);
-						this.state = 336;
+						this.state = 342;
 						this.match(CashScriptParser.T__16);
 						}
 						break;
 					}
 					}
 				}
-				this.state = 342;
+				this.state = 348;
 				this._errHandler.sync(this);
-				_alt = this._interp.adaptivePredict(this._input, 28, this._ctx);
+				_alt = this._interp.adaptivePredict(this._input, 29, this._ctx);
 			}
 			}
 		}
@@ -1742,11 +1779,11 @@ export default class CashScriptParser extends Parser {
 	// @RuleVersion(0)
 	public modifier(): ModifierContext {
 		let localctx: ModifierContext = new ModifierContext(this, this._ctx, this.state);
-		this.enterRule(localctx, 48, CashScriptParser.RULE_modifier);
+		this.enterRule(localctx, 50, CashScriptParser.RULE_modifier);
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 343;
+			this.state = 349;
 			this.match(CashScriptParser.T__50);
 			}
 		}
@@ -1767,43 +1804,43 @@ export default class CashScriptParser extends Parser {
 	// @RuleVersion(0)
 	public literal(): LiteralContext {
 		let localctx: LiteralContext = new LiteralContext(this, this._ctx, this.state);
-		this.enterRule(localctx, 50, CashScriptParser.RULE_literal);
+		this.enterRule(localctx, 52, CashScriptParser.RULE_literal);
 		try {
-			this.state = 350;
+			this.state = 356;
 			this._errHandler.sync(this);
 			switch (this._input.LA(1)) {
 			case 59:
 				this.enterOuterAlt(localctx, 1);
 				{
-				this.state = 345;
+				this.state = 351;
 				this.match(CashScriptParser.BooleanLiteral);
 				}
 				break;
 			case 61:
 				this.enterOuterAlt(localctx, 2);
 				{
-				this.state = 346;
+				this.state = 352;
 				this.numberLiteral();
 				}
 				break;
 			case 64:
 				this.enterOuterAlt(localctx, 3);
 				{
-				this.state = 347;
+				this.state = 353;
 				this.match(CashScriptParser.StringLiteral);
 				}
 				break;
 			case 65:
 				this.enterOuterAlt(localctx, 4);
 				{
-				this.state = 348;
+				this.state = 354;
 				this.match(CashScriptParser.DateLiteral);
 				}
 				break;
 			case 66:
 				this.enterOuterAlt(localctx, 5);
 				{
-				this.state = 349;
+				this.state = 355;
 				this.match(CashScriptParser.HexLiteral);
 				}
 				break;
@@ -1828,18 +1865,18 @@ export default class CashScriptParser extends Parser {
 	// @RuleVersion(0)
 	public numberLiteral(): NumberLiteralContext {
 		let localctx: NumberLiteralContext = new NumberLiteralContext(this, this._ctx, this.state);
-		this.enterRule(localctx, 52, CashScriptParser.RULE_numberLiteral);
+		this.enterRule(localctx, 54, CashScriptParser.RULE_numberLiteral);
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 352;
+			this.state = 358;
 			this.match(CashScriptParser.NumberLiteral);
-			this.state = 354;
+			this.state = 360;
 			this._errHandler.sync(this);
-			switch ( this._interp.adaptivePredict(this._input, 30, this._ctx) ) {
+			switch ( this._interp.adaptivePredict(this._input, 31, this._ctx) ) {
 			case 1:
 				{
-				this.state = 353;
+				this.state = 359;
 				this.match(CashScriptParser.NumberUnit);
 				}
 				break;
@@ -1863,12 +1900,12 @@ export default class CashScriptParser extends Parser {
 	// @RuleVersion(0)
 	public typeName(): TypeNameContext {
 		let localctx: TypeNameContext = new TypeNameContext(this, this._ctx, this.state);
-		this.enterRule(localctx, 54, CashScriptParser.RULE_typeName);
+		this.enterRule(localctx, 56, CashScriptParser.RULE_typeName);
 		let _la: number;
 		try {
 			this.enterOuterAlt(localctx, 1);
 			{
-			this.state = 356;
+			this.state = 362;
 			_la = this._input.LA(1);
 			if(!(((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 1087) !== 0))) {
 			this._errHandler.recoverInline(this);
@@ -1896,7 +1933,7 @@ export default class CashScriptParser extends Parser {
 
 	public sempred(localctx: RuleContext, ruleIndex: number, predIndex: number): boolean {
 		switch (ruleIndex) {
-		case 23:
+		case 24:
 			return this.expression_sempred(localctx as ExpressionContext, predIndex);
 		}
 		return true;
@@ -1931,126 +1968,127 @@ export default class CashScriptParser extends Parser {
 		return true;
 	}
 
-	public static readonly _serializedATN: number[] = [4,1,72,359,2,0,7,0,2,
+	public static readonly _serializedATN: number[] = [4,1,72,365,2,0,7,0,2,
 	1,7,1,2,2,7,2,2,3,7,3,2,4,7,4,2,5,7,5,2,6,7,6,2,7,7,7,2,8,7,8,2,9,7,9,2,
 	10,7,10,2,11,7,11,2,12,7,12,2,13,7,13,2,14,7,14,2,15,7,15,2,16,7,16,2,17,
 	7,17,2,18,7,18,2,19,7,19,2,20,7,20,2,21,7,21,2,22,7,22,2,23,7,23,2,24,7,
-	24,2,25,7,25,2,26,7,26,2,27,7,27,1,0,5,0,58,8,0,10,0,12,0,61,9,0,1,0,1,
-	0,1,0,1,1,1,1,1,1,1,1,1,1,1,2,1,2,1,3,1,3,3,3,75,8,3,1,4,3,4,78,8,4,1,4,
-	1,4,1,5,1,5,1,6,1,6,1,6,1,6,1,6,5,6,89,8,6,10,6,12,6,92,9,6,1,6,1,6,1,7,
-	1,7,1,7,1,7,1,7,5,7,101,8,7,10,7,12,7,104,9,7,1,7,1,7,1,8,1,8,1,8,1,8,5,
-	8,112,8,8,10,8,12,8,115,9,8,1,8,3,8,118,8,8,3,8,120,8,8,1,8,1,8,1,9,1,9,
-	1,9,1,10,1,10,5,10,129,8,10,10,10,12,10,132,9,10,1,10,1,10,3,10,136,8,10,
-	1,11,1,11,1,11,1,11,1,11,1,11,1,11,3,11,145,8,11,1,12,1,12,5,12,149,8,12,
-	10,12,12,12,152,9,12,1,12,1,12,1,12,1,12,1,12,1,13,1,13,1,13,1,13,1,13,
-	1,13,1,13,1,13,1,13,1,14,1,14,1,14,1,14,1,14,1,15,1,15,1,15,1,15,1,15,1,
-	15,1,15,3,15,180,8,15,1,15,1,15,1,15,1,16,1,16,1,16,1,16,1,16,3,16,190,
-	8,16,1,16,1,16,1,16,1,17,1,17,1,17,1,17,1,17,1,17,1,17,3,17,202,8,17,1,
-	18,1,18,1,18,1,18,1,19,1,19,1,20,1,20,1,20,1,20,5,20,214,8,20,10,20,12,
-	20,217,9,20,1,20,3,20,220,8,20,3,20,222,8,20,1,20,1,20,1,21,1,21,1,21,1,
-	22,1,22,1,22,1,22,5,22,233,8,22,10,22,12,22,236,9,22,1,22,3,22,239,8,22,
-	3,22,241,8,22,1,22,1,22,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,
-	23,3,23,255,8,23,1,23,3,23,258,8,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,
-	1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,
-	23,1,23,1,23,5,23,284,8,23,10,23,12,23,287,9,23,1,23,3,23,290,8,23,3,23,
-	292,8,23,1,23,1,23,1,23,1,23,3,23,298,8,23,1,23,1,23,1,23,1,23,1,23,1,23,
-	1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,
-	23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,1,23,
-	1,23,1,23,1,23,1,23,5,23,339,8,23,10,23,12,23,342,9,23,1,24,1,24,1,25,1,
-	25,1,25,1,25,1,25,3,25,351,8,25,1,26,1,26,3,26,355,8,26,1,27,1,27,1,27,
-	0,1,46,28,0,2,4,6,8,10,12,14,16,18,20,22,24,26,28,30,32,34,36,38,40,42,
-	44,46,48,50,52,54,0,11,1,0,4,10,5,0,59,59,61,61,64,64,66,66,69,69,1,0,26,
-	30,2,0,26,30,32,35,1,0,39,40,1,0,41,43,2,0,40,40,44,44,1,0,6,9,1,0,45,46,
-	1,0,36,37,2,0,52,57,62,62,388,0,59,1,0,0,0,2,65,1,0,0,0,4,70,1,0,0,0,6,
-	72,1,0,0,0,8,77,1,0,0,0,10,81,1,0,0,0,12,83,1,0,0,0,14,95,1,0,0,0,16,107,
-	1,0,0,0,18,123,1,0,0,0,20,135,1,0,0,0,22,144,1,0,0,0,24,146,1,0,0,0,26,
-	158,1,0,0,0,28,167,1,0,0,0,30,172,1,0,0,0,32,184,1,0,0,0,34,194,1,0,0,0,
-	36,203,1,0,0,0,38,207,1,0,0,0,40,209,1,0,0,0,42,225,1,0,0,0,44,228,1,0,
-	0,0,46,297,1,0,0,0,48,343,1,0,0,0,50,350,1,0,0,0,52,352,1,0,0,0,54,356,
-	1,0,0,0,56,58,3,2,1,0,57,56,1,0,0,0,58,61,1,0,0,0,59,57,1,0,0,0,59,60,1,
-	0,0,0,60,62,1,0,0,0,61,59,1,0,0,0,62,63,3,12,6,0,63,64,5,0,0,1,64,1,1,0,
-	0,0,65,66,5,1,0,0,66,67,3,4,2,0,67,68,3,6,3,0,68,69,5,2,0,0,69,3,1,0,0,
-	0,70,71,5,3,0,0,71,5,1,0,0,0,72,74,3,8,4,0,73,75,3,8,4,0,74,73,1,0,0,0,
-	74,75,1,0,0,0,75,7,1,0,0,0,76,78,3,10,5,0,77,76,1,0,0,0,77,78,1,0,0,0,78,
-	79,1,0,0,0,79,80,5,58,0,0,80,9,1,0,0,0,81,82,7,0,0,0,82,11,1,0,0,0,83,84,
-	5,11,0,0,84,85,5,69,0,0,85,86,3,16,8,0,86,90,5,12,0,0,87,89,3,14,7,0,88,
-	87,1,0,0,0,89,92,1,0,0,0,90,88,1,0,0,0,90,91,1,0,0,0,91,93,1,0,0,0,92,90,
-	1,0,0,0,93,94,5,13,0,0,94,13,1,0,0,0,95,96,5,14,0,0,96,97,5,69,0,0,97,98,
-	3,16,8,0,98,102,5,12,0,0,99,101,3,22,11,0,100,99,1,0,0,0,101,104,1,0,0,
-	0,102,100,1,0,0,0,102,103,1,0,0,0,103,105,1,0,0,0,104,102,1,0,0,0,105,106,
-	5,13,0,0,106,15,1,0,0,0,107,119,5,15,0,0,108,113,3,18,9,0,109,110,5,16,
-	0,0,110,112,3,18,9,0,111,109,1,0,0,0,112,115,1,0,0,0,113,111,1,0,0,0,113,
-	114,1,0,0,0,114,117,1,0,0,0,115,113,1,0,0,0,116,118,5,16,0,0,117,116,1,
-	0,0,0,117,118,1,0,0,0,118,120,1,0,0,0,119,108,1,0,0,0,119,120,1,0,0,0,120,
-	121,1,0,0,0,121,122,5,17,0,0,122,17,1,0,0,0,123,124,3,54,27,0,124,125,5,
-	69,0,0,125,19,1,0,0,0,126,130,5,12,0,0,127,129,3,22,11,0,128,127,1,0,0,
-	0,129,132,1,0,0,0,130,128,1,0,0,0,130,131,1,0,0,0,131,133,1,0,0,0,132,130,
-	1,0,0,0,133,136,5,13,0,0,134,136,3,22,11,0,135,126,1,0,0,0,135,134,1,0,
-	0,0,136,21,1,0,0,0,137,145,3,24,12,0,138,145,3,26,13,0,139,145,3,28,14,
-	0,140,145,3,30,15,0,141,145,3,32,16,0,142,145,3,34,17,0,143,145,3,36,18,
-	0,144,137,1,0,0,0,144,138,1,0,0,0,144,139,1,0,0,0,144,140,1,0,0,0,144,141,
-	1,0,0,0,144,142,1,0,0,0,144,143,1,0,0,0,145,23,1,0,0,0,146,150,3,54,27,
-	0,147,149,3,48,24,0,148,147,1,0,0,0,149,152,1,0,0,0,150,148,1,0,0,0,150,
-	151,1,0,0,0,151,153,1,0,0,0,152,150,1,0,0,0,153,154,5,69,0,0,154,155,5,
-	10,0,0,155,156,3,46,23,0,156,157,5,2,0,0,157,25,1,0,0,0,158,159,3,54,27,
-	0,159,160,5,69,0,0,160,161,5,16,0,0,161,162,3,54,27,0,162,163,5,69,0,0,
-	163,164,5,10,0,0,164,165,3,46,23,0,165,166,5,2,0,0,166,27,1,0,0,0,167,168,
-	5,69,0,0,168,169,5,10,0,0,169,170,3,46,23,0,170,171,5,2,0,0,171,29,1,0,
-	0,0,172,173,5,18,0,0,173,174,5,15,0,0,174,175,5,67,0,0,175,176,5,6,0,0,
-	176,179,3,46,23,0,177,178,5,16,0,0,178,180,5,64,0,0,179,177,1,0,0,0,179,
-	180,1,0,0,0,180,181,1,0,0,0,181,182,5,17,0,0,182,183,5,2,0,0,183,31,1,0,
-	0,0,184,185,5,18,0,0,185,186,5,15,0,0,186,189,3,46,23,0,187,188,5,16,0,
-	0,188,190,5,64,0,0,189,187,1,0,0,0,189,190,1,0,0,0,190,191,1,0,0,0,191,
-	192,5,17,0,0,192,193,5,2,0,0,193,33,1,0,0,0,194,195,5,19,0,0,195,196,5,
-	15,0,0,196,197,3,46,23,0,197,198,5,17,0,0,198,201,3,20,10,0,199,200,5,20,
-	0,0,200,202,3,20,10,0,201,199,1,0,0,0,201,202,1,0,0,0,202,35,1,0,0,0,203,
-	204,5,21,0,0,204,205,3,40,20,0,205,206,5,2,0,0,206,37,1,0,0,0,207,208,7,
-	1,0,0,208,39,1,0,0,0,209,221,5,15,0,0,210,215,3,38,19,0,211,212,5,16,0,
-	0,212,214,3,38,19,0,213,211,1,0,0,0,214,217,1,0,0,0,215,213,1,0,0,0,215,
-	216,1,0,0,0,216,219,1,0,0,0,217,215,1,0,0,0,218,220,5,16,0,0,219,218,1,
-	0,0,0,219,220,1,0,0,0,220,222,1,0,0,0,221,210,1,0,0,0,221,222,1,0,0,0,222,
-	223,1,0,0,0,223,224,5,17,0,0,224,41,1,0,0,0,225,226,5,69,0,0,226,227,3,
-	44,22,0,227,43,1,0,0,0,228,240,5,15,0,0,229,234,3,46,23,0,230,231,5,16,
-	0,0,231,233,3,46,23,0,232,230,1,0,0,0,233,236,1,0,0,0,234,232,1,0,0,0,234,
-	235,1,0,0,0,235,238,1,0,0,0,236,234,1,0,0,0,237,239,5,16,0,0,238,237,1,
-	0,0,0,238,239,1,0,0,0,239,241,1,0,0,0,240,229,1,0,0,0,240,241,1,0,0,0,241,
-	242,1,0,0,0,242,243,5,17,0,0,243,45,1,0,0,0,244,245,6,23,-1,0,245,246,5,
-	15,0,0,246,247,3,46,23,0,247,248,5,17,0,0,248,298,1,0,0,0,249,250,3,54,
-	27,0,250,251,5,15,0,0,251,254,3,46,23,0,252,253,5,16,0,0,253,255,3,46,23,
-	0,254,252,1,0,0,0,254,255,1,0,0,0,255,257,1,0,0,0,256,258,5,16,0,0,257,
-	256,1,0,0,0,257,258,1,0,0,0,258,259,1,0,0,0,259,260,5,17,0,0,260,298,1,
-	0,0,0,261,298,3,42,21,0,262,263,5,22,0,0,263,264,5,69,0,0,264,298,3,44,
-	22,0,265,266,5,25,0,0,266,267,5,23,0,0,267,268,3,46,23,0,268,269,5,24,0,
-	0,269,270,7,2,0,0,270,298,1,0,0,0,271,272,5,31,0,0,272,273,5,23,0,0,273,
-	274,3,46,23,0,274,275,5,24,0,0,275,276,7,3,0,0,276,298,1,0,0,0,277,278,
-	7,4,0,0,278,298,3,46,23,14,279,291,5,23,0,0,280,285,3,46,23,0,281,282,5,
-	16,0,0,282,284,3,46,23,0,283,281,1,0,0,0,284,287,1,0,0,0,285,283,1,0,0,
-	0,285,286,1,0,0,0,286,289,1,0,0,0,287,285,1,0,0,0,288,290,5,16,0,0,289,
-	288,1,0,0,0,289,290,1,0,0,0,290,292,1,0,0,0,291,280,1,0,0,0,291,292,1,0,
-	0,0,292,293,1,0,0,0,293,298,5,24,0,0,294,298,5,68,0,0,295,298,5,69,0,0,
-	296,298,3,50,25,0,297,244,1,0,0,0,297,249,1,0,0,0,297,261,1,0,0,0,297,262,
-	1,0,0,0,297,265,1,0,0,0,297,271,1,0,0,0,297,277,1,0,0,0,297,279,1,0,0,0,
-	297,294,1,0,0,0,297,295,1,0,0,0,297,296,1,0,0,0,298,340,1,0,0,0,299,300,
-	10,13,0,0,300,301,7,5,0,0,301,339,3,46,23,14,302,303,10,12,0,0,303,304,
-	7,6,0,0,304,339,3,46,23,13,305,306,10,11,0,0,306,307,7,7,0,0,307,339,3,
-	46,23,12,308,309,10,10,0,0,309,310,7,8,0,0,310,339,3,46,23,11,311,312,10,
-	9,0,0,312,313,5,47,0,0,313,339,3,46,23,10,314,315,10,8,0,0,315,316,5,4,
-	0,0,316,339,3,46,23,9,317,318,10,7,0,0,318,319,5,48,0,0,319,339,3,46,23,
-	8,320,321,10,6,0,0,321,322,5,49,0,0,322,339,3,46,23,7,323,324,10,5,0,0,
-	324,325,5,50,0,0,325,339,3,46,23,6,326,327,10,19,0,0,327,328,5,23,0,0,328,
-	329,5,61,0,0,329,339,5,24,0,0,330,331,10,16,0,0,331,339,7,9,0,0,332,333,
-	10,15,0,0,333,334,5,38,0,0,334,335,5,15,0,0,335,336,3,46,23,0,336,337,5,
-	17,0,0,337,339,1,0,0,0,338,299,1,0,0,0,338,302,1,0,0,0,338,305,1,0,0,0,
-	338,308,1,0,0,0,338,311,1,0,0,0,338,314,1,0,0,0,338,317,1,0,0,0,338,320,
-	1,0,0,0,338,323,1,0,0,0,338,326,1,0,0,0,338,330,1,0,0,0,338,332,1,0,0,0,
-	339,342,1,0,0,0,340,338,1,0,0,0,340,341,1,0,0,0,341,47,1,0,0,0,342,340,
-	1,0,0,0,343,344,5,51,0,0,344,49,1,0,0,0,345,351,5,59,0,0,346,351,3,52,26,
-	0,347,351,5,64,0,0,348,351,5,65,0,0,349,351,5,66,0,0,350,345,1,0,0,0,350,
-	346,1,0,0,0,350,347,1,0,0,0,350,348,1,0,0,0,350,349,1,0,0,0,351,51,1,0,
-	0,0,352,354,5,61,0,0,353,355,5,60,0,0,354,353,1,0,0,0,354,355,1,0,0,0,355,
-	53,1,0,0,0,356,357,7,10,0,0,357,55,1,0,0,0,31,59,74,77,90,102,113,117,119,
-	130,135,144,150,179,189,201,215,219,221,234,238,240,254,257,285,289,291,
-	297,338,340,350,354];
+	24,2,25,7,25,2,26,7,26,2,27,7,27,2,28,7,28,1,0,5,0,60,8,0,10,0,12,0,63,
+	9,0,1,0,1,0,1,0,1,1,1,1,1,1,1,1,1,1,1,2,1,2,1,3,1,3,3,3,77,8,3,1,4,3,4,
+	80,8,4,1,4,1,4,1,5,1,5,1,6,1,6,1,6,1,6,1,6,5,6,91,8,6,10,6,12,6,94,9,6,
+	1,6,1,6,1,7,1,7,1,7,1,7,1,7,5,7,103,8,7,10,7,12,7,106,9,7,1,7,1,7,1,8,1,
+	8,1,8,1,8,5,8,114,8,8,10,8,12,8,117,9,8,1,8,3,8,120,8,8,3,8,122,8,8,1,8,
+	1,8,1,9,1,9,1,9,1,10,1,10,5,10,131,8,10,10,10,12,10,134,9,10,1,10,1,10,
+	3,10,138,8,10,1,11,1,11,1,11,1,11,1,11,1,11,1,11,3,11,147,8,11,1,12,1,12,
+	5,12,151,8,12,10,12,12,12,154,9,12,1,12,1,12,1,12,1,12,1,12,1,13,1,13,1,
+	13,1,13,1,13,1,13,1,13,1,13,1,13,1,14,1,14,1,14,1,14,1,14,1,15,1,15,1,15,
+	1,15,1,15,1,15,1,15,3,15,182,8,15,1,15,1,15,1,15,1,16,1,16,1,16,1,16,1,
+	16,3,16,192,8,16,1,16,1,16,1,16,1,17,1,17,1,17,1,17,1,17,1,17,1,17,3,17,
+	204,8,17,1,18,1,18,1,18,1,18,1,19,1,19,1,20,1,20,3,20,214,8,20,1,21,1,21,
+	1,21,1,21,5,21,220,8,21,10,21,12,21,223,9,21,1,21,3,21,226,8,21,3,21,228,
+	8,21,1,21,1,21,1,22,1,22,1,22,1,23,1,23,1,23,1,23,5,23,239,8,23,10,23,12,
+	23,242,9,23,1,23,3,23,245,8,23,3,23,247,8,23,1,23,1,23,1,24,1,24,1,24,1,
+	24,1,24,1,24,1,24,1,24,1,24,1,24,3,24,261,8,24,1,24,3,24,264,8,24,1,24,
+	1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,
+	24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,5,24,290,8,24,10,24,12,24,293,
+	9,24,1,24,3,24,296,8,24,3,24,298,8,24,1,24,1,24,1,24,1,24,3,24,304,8,24,
+	1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,
+	24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,
+	1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,5,24,345,8,24,10,24,12,
+	24,348,9,24,1,25,1,25,1,26,1,26,1,26,1,26,1,26,3,26,357,8,26,1,27,1,27,
+	3,27,361,8,27,1,28,1,28,1,28,0,1,48,29,0,2,4,6,8,10,12,14,16,18,20,22,24,
+	26,28,30,32,34,36,38,40,42,44,46,48,50,52,54,56,0,10,1,0,4,10,1,0,26,30,
+	2,0,26,30,32,35,1,0,39,40,1,0,41,43,2,0,40,40,44,44,1,0,6,9,1,0,45,46,1,
+	0,36,37,2,0,52,57,62,62,394,0,61,1,0,0,0,2,67,1,0,0,0,4,72,1,0,0,0,6,74,
+	1,0,0,0,8,79,1,0,0,0,10,83,1,0,0,0,12,85,1,0,0,0,14,97,1,0,0,0,16,109,1,
+	0,0,0,18,125,1,0,0,0,20,137,1,0,0,0,22,146,1,0,0,0,24,148,1,0,0,0,26,160,
+	1,0,0,0,28,169,1,0,0,0,30,174,1,0,0,0,32,186,1,0,0,0,34,196,1,0,0,0,36,
+	205,1,0,0,0,38,209,1,0,0,0,40,213,1,0,0,0,42,215,1,0,0,0,44,231,1,0,0,0,
+	46,234,1,0,0,0,48,303,1,0,0,0,50,349,1,0,0,0,52,356,1,0,0,0,54,358,1,0,
+	0,0,56,362,1,0,0,0,58,60,3,2,1,0,59,58,1,0,0,0,60,63,1,0,0,0,61,59,1,0,
+	0,0,61,62,1,0,0,0,62,64,1,0,0,0,63,61,1,0,0,0,64,65,3,12,6,0,65,66,5,0,
+	0,1,66,1,1,0,0,0,67,68,5,1,0,0,68,69,3,4,2,0,69,70,3,6,3,0,70,71,5,2,0,
+	0,71,3,1,0,0,0,72,73,5,3,0,0,73,5,1,0,0,0,74,76,3,8,4,0,75,77,3,8,4,0,76,
+	75,1,0,0,0,76,77,1,0,0,0,77,7,1,0,0,0,78,80,3,10,5,0,79,78,1,0,0,0,79,80,
+	1,0,0,0,80,81,1,0,0,0,81,82,5,58,0,0,82,9,1,0,0,0,83,84,7,0,0,0,84,11,1,
+	0,0,0,85,86,5,11,0,0,86,87,5,69,0,0,87,88,3,16,8,0,88,92,5,12,0,0,89,91,
+	3,14,7,0,90,89,1,0,0,0,91,94,1,0,0,0,92,90,1,0,0,0,92,93,1,0,0,0,93,95,
+	1,0,0,0,94,92,1,0,0,0,95,96,5,13,0,0,96,13,1,0,0,0,97,98,5,14,0,0,98,99,
+	5,69,0,0,99,100,3,16,8,0,100,104,5,12,0,0,101,103,3,22,11,0,102,101,1,0,
+	0,0,103,106,1,0,0,0,104,102,1,0,0,0,104,105,1,0,0,0,105,107,1,0,0,0,106,
+	104,1,0,0,0,107,108,5,13,0,0,108,15,1,0,0,0,109,121,5,15,0,0,110,115,3,
+	18,9,0,111,112,5,16,0,0,112,114,3,18,9,0,113,111,1,0,0,0,114,117,1,0,0,
+	0,115,113,1,0,0,0,115,116,1,0,0,0,116,119,1,0,0,0,117,115,1,0,0,0,118,120,
+	5,16,0,0,119,118,1,0,0,0,119,120,1,0,0,0,120,122,1,0,0,0,121,110,1,0,0,
+	0,121,122,1,0,0,0,122,123,1,0,0,0,123,124,5,17,0,0,124,17,1,0,0,0,125,126,
+	3,56,28,0,126,127,5,69,0,0,127,19,1,0,0,0,128,132,5,12,0,0,129,131,3,22,
+	11,0,130,129,1,0,0,0,131,134,1,0,0,0,132,130,1,0,0,0,132,133,1,0,0,0,133,
+	135,1,0,0,0,134,132,1,0,0,0,135,138,5,13,0,0,136,138,3,22,11,0,137,128,
+	1,0,0,0,137,136,1,0,0,0,138,21,1,0,0,0,139,147,3,24,12,0,140,147,3,26,13,
+	0,141,147,3,28,14,0,142,147,3,30,15,0,143,147,3,32,16,0,144,147,3,34,17,
+	0,145,147,3,36,18,0,146,139,1,0,0,0,146,140,1,0,0,0,146,141,1,0,0,0,146,
+	142,1,0,0,0,146,143,1,0,0,0,146,144,1,0,0,0,146,145,1,0,0,0,147,23,1,0,
+	0,0,148,152,3,56,28,0,149,151,3,50,25,0,150,149,1,0,0,0,151,154,1,0,0,0,
+	152,150,1,0,0,0,152,153,1,0,0,0,153,155,1,0,0,0,154,152,1,0,0,0,155,156,
+	5,69,0,0,156,157,5,10,0,0,157,158,3,48,24,0,158,159,5,2,0,0,159,25,1,0,
+	0,0,160,161,3,56,28,0,161,162,5,69,0,0,162,163,5,16,0,0,163,164,3,56,28,
+	0,164,165,5,69,0,0,165,166,5,10,0,0,166,167,3,48,24,0,167,168,5,2,0,0,168,
+	27,1,0,0,0,169,170,5,69,0,0,170,171,5,10,0,0,171,172,3,48,24,0,172,173,
+	5,2,0,0,173,29,1,0,0,0,174,175,5,18,0,0,175,176,5,15,0,0,176,177,5,67,0,
+	0,177,178,5,6,0,0,178,181,3,48,24,0,179,180,5,16,0,0,180,182,3,38,19,0,
+	181,179,1,0,0,0,181,182,1,0,0,0,182,183,1,0,0,0,183,184,5,17,0,0,184,185,
+	5,2,0,0,185,31,1,0,0,0,186,187,5,18,0,0,187,188,5,15,0,0,188,191,3,48,24,
+	0,189,190,5,16,0,0,190,192,3,38,19,0,191,189,1,0,0,0,191,192,1,0,0,0,192,
+	193,1,0,0,0,193,194,5,17,0,0,194,195,5,2,0,0,195,33,1,0,0,0,196,197,5,19,
+	0,0,197,198,5,15,0,0,198,199,3,48,24,0,199,200,5,17,0,0,200,203,3,20,10,
+	0,201,202,5,20,0,0,202,204,3,20,10,0,203,201,1,0,0,0,203,204,1,0,0,0,204,
+	35,1,0,0,0,205,206,5,21,0,0,206,207,3,42,21,0,207,208,5,2,0,0,208,37,1,
+	0,0,0,209,210,5,64,0,0,210,39,1,0,0,0,211,214,5,69,0,0,212,214,3,52,26,
+	0,213,211,1,0,0,0,213,212,1,0,0,0,214,41,1,0,0,0,215,227,5,15,0,0,216,221,
+	3,40,20,0,217,218,5,16,0,0,218,220,3,40,20,0,219,217,1,0,0,0,220,223,1,
+	0,0,0,221,219,1,0,0,0,221,222,1,0,0,0,222,225,1,0,0,0,223,221,1,0,0,0,224,
+	226,5,16,0,0,225,224,1,0,0,0,225,226,1,0,0,0,226,228,1,0,0,0,227,216,1,
+	0,0,0,227,228,1,0,0,0,228,229,1,0,0,0,229,230,5,17,0,0,230,43,1,0,0,0,231,
+	232,5,69,0,0,232,233,3,46,23,0,233,45,1,0,0,0,234,246,5,15,0,0,235,240,
+	3,48,24,0,236,237,5,16,0,0,237,239,3,48,24,0,238,236,1,0,0,0,239,242,1,
+	0,0,0,240,238,1,0,0,0,240,241,1,0,0,0,241,244,1,0,0,0,242,240,1,0,0,0,243,
+	245,5,16,0,0,244,243,1,0,0,0,244,245,1,0,0,0,245,247,1,0,0,0,246,235,1,
+	0,0,0,246,247,1,0,0,0,247,248,1,0,0,0,248,249,5,17,0,0,249,47,1,0,0,0,250,
+	251,6,24,-1,0,251,252,5,15,0,0,252,253,3,48,24,0,253,254,5,17,0,0,254,304,
+	1,0,0,0,255,256,3,56,28,0,256,257,5,15,0,0,257,260,3,48,24,0,258,259,5,
+	16,0,0,259,261,3,48,24,0,260,258,1,0,0,0,260,261,1,0,0,0,261,263,1,0,0,
+	0,262,264,5,16,0,0,263,262,1,0,0,0,263,264,1,0,0,0,264,265,1,0,0,0,265,
+	266,5,17,0,0,266,304,1,0,0,0,267,304,3,44,22,0,268,269,5,22,0,0,269,270,
+	5,69,0,0,270,304,3,46,23,0,271,272,5,25,0,0,272,273,5,23,0,0,273,274,3,
+	48,24,0,274,275,5,24,0,0,275,276,7,1,0,0,276,304,1,0,0,0,277,278,5,31,0,
+	0,278,279,5,23,0,0,279,280,3,48,24,0,280,281,5,24,0,0,281,282,7,2,0,0,282,
+	304,1,0,0,0,283,284,7,3,0,0,284,304,3,48,24,14,285,297,5,23,0,0,286,291,
+	3,48,24,0,287,288,5,16,0,0,288,290,3,48,24,0,289,287,1,0,0,0,290,293,1,
+	0,0,0,291,289,1,0,0,0,291,292,1,0,0,0,292,295,1,0,0,0,293,291,1,0,0,0,294,
+	296,5,16,0,0,295,294,1,0,0,0,295,296,1,0,0,0,296,298,1,0,0,0,297,286,1,
+	0,0,0,297,298,1,0,0,0,298,299,1,0,0,0,299,304,5,24,0,0,300,304,5,68,0,0,
+	301,304,5,69,0,0,302,304,3,52,26,0,303,250,1,0,0,0,303,255,1,0,0,0,303,
+	267,1,0,0,0,303,268,1,0,0,0,303,271,1,0,0,0,303,277,1,0,0,0,303,283,1,0,
+	0,0,303,285,1,0,0,0,303,300,1,0,0,0,303,301,1,0,0,0,303,302,1,0,0,0,304,
+	346,1,0,0,0,305,306,10,13,0,0,306,307,7,4,0,0,307,345,3,48,24,14,308,309,
+	10,12,0,0,309,310,7,5,0,0,310,345,3,48,24,13,311,312,10,11,0,0,312,313,
+	7,6,0,0,313,345,3,48,24,12,314,315,10,10,0,0,315,316,7,7,0,0,316,345,3,
+	48,24,11,317,318,10,9,0,0,318,319,5,47,0,0,319,345,3,48,24,10,320,321,10,
+	8,0,0,321,322,5,4,0,0,322,345,3,48,24,9,323,324,10,7,0,0,324,325,5,48,0,
+	0,325,345,3,48,24,8,326,327,10,6,0,0,327,328,5,49,0,0,328,345,3,48,24,7,
+	329,330,10,5,0,0,330,331,5,50,0,0,331,345,3,48,24,6,332,333,10,19,0,0,333,
+	334,5,23,0,0,334,335,5,61,0,0,335,345,5,24,0,0,336,337,10,16,0,0,337,345,
+	7,8,0,0,338,339,10,15,0,0,339,340,5,38,0,0,340,341,5,15,0,0,341,342,3,48,
+	24,0,342,343,5,17,0,0,343,345,1,0,0,0,344,305,1,0,0,0,344,308,1,0,0,0,344,
+	311,1,0,0,0,344,314,1,0,0,0,344,317,1,0,0,0,344,320,1,0,0,0,344,323,1,0,
+	0,0,344,326,1,0,0,0,344,329,1,0,0,0,344,332,1,0,0,0,344,336,1,0,0,0,344,
+	338,1,0,0,0,345,348,1,0,0,0,346,344,1,0,0,0,346,347,1,0,0,0,347,49,1,0,
+	0,0,348,346,1,0,0,0,349,350,5,51,0,0,350,51,1,0,0,0,351,357,5,59,0,0,352,
+	357,3,54,27,0,353,357,5,64,0,0,354,357,5,65,0,0,355,357,5,66,0,0,356,351,
+	1,0,0,0,356,352,1,0,0,0,356,353,1,0,0,0,356,354,1,0,0,0,356,355,1,0,0,0,
+	357,53,1,0,0,0,358,360,5,61,0,0,359,361,5,60,0,0,360,359,1,0,0,0,360,361,
+	1,0,0,0,361,55,1,0,0,0,362,363,7,9,0,0,363,57,1,0,0,0,32,61,76,79,92,104,
+	115,119,121,132,137,146,152,181,191,203,213,221,225,227,240,244,246,260,
+	263,291,295,297,303,344,346,356,360];
 
 	private static __ATN: ATN;
 	public static get _ATN(): ATN {
@@ -2491,8 +2529,8 @@ export class TimeOpStatementContext extends ParserRuleContext {
 	public expression(): ExpressionContext {
 		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
-	public StringLiteral(): TerminalNode {
-		return this.getToken(CashScriptParser.StringLiteral, 0);
+	public requireMessage(): RequireMessageContext {
+		return this.getTypedRuleContext(RequireMessageContext, 0) as RequireMessageContext;
 	}
     public get ruleIndex(): number {
     	return CashScriptParser.RULE_timeOpStatement;
@@ -2516,8 +2554,8 @@ export class RequireStatementContext extends ParserRuleContext {
 	public expression(): ExpressionContext {
 		return this.getTypedRuleContext(ExpressionContext, 0) as ExpressionContext;
 	}
-	public StringLiteral(): TerminalNode {
-		return this.getToken(CashScriptParser.StringLiteral, 0);
+	public requireMessage(): RequireMessageContext {
+		return this.getTypedRuleContext(RequireMessageContext, 0) as RequireMessageContext;
 	}
     public get ruleIndex(): number {
     	return CashScriptParser.RULE_requireStatement;
@@ -2585,25 +2623,38 @@ export class ConsoleStatementContext extends ParserRuleContext {
 }
 
 
-export class ConsoleParameterContext extends ParserRuleContext {
+export class RequireMessageContext extends ParserRuleContext {
 	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
 		super(parent, invokingState);
     	this.parser = parser;
 	}
-	public Identifier(): TerminalNode {
-		return this.getToken(CashScriptParser.Identifier, 0);
-	}
 	public StringLiteral(): TerminalNode {
 		return this.getToken(CashScriptParser.StringLiteral, 0);
 	}
-	public NumberLiteral(): TerminalNode {
-		return this.getToken(CashScriptParser.NumberLiteral, 0);
+    public get ruleIndex(): number {
+    	return CashScriptParser.RULE_requireMessage;
 	}
-	public HexLiteral(): TerminalNode {
-		return this.getToken(CashScriptParser.HexLiteral, 0);
+	// @Override
+	public accept<Result>(visitor: CashScriptVisitor<Result>): Result {
+		if (visitor.visitRequireMessage) {
+			return visitor.visitRequireMessage(this);
+		} else {
+			return visitor.visitChildren(this);
+		}
 	}
-	public BooleanLiteral(): TerminalNode {
-		return this.getToken(CashScriptParser.BooleanLiteral, 0);
+}
+
+
+export class ConsoleParameterContext extends ParserRuleContext {
+	constructor(parser?: CashScriptParser, parent?: ParserRuleContext, invokingState?: number) {
+		super(parent, invokingState);
+    	this.parser = parser;
+	}
+	public Identifier(): TerminalNode {
+		return this.getToken(CashScriptParser.Identifier, 0);
+	}
+	public literal(): LiteralContext {
+		return this.getTypedRuleContext(LiteralContext, 0) as LiteralContext;
 	}
     public get ruleIndex(): number {
     	return CashScriptParser.RULE_consoleParameter;
diff --git a/packages/cashc/src/grammar/CashScriptVisitor.ts b/packages/cashc/src/grammar/CashScriptVisitor.ts
index d944d212..c8579759 100644
--- a/packages/cashc/src/grammar/CashScriptVisitor.ts
+++ b/packages/cashc/src/grammar/CashScriptVisitor.ts
@@ -22,6 +22,7 @@ import { TimeOpStatementContext } from "./CashScriptParser.js";
 import { RequireStatementContext } from "./CashScriptParser.js";
 import { IfStatementContext } from "./CashScriptParser.js";
 import { ConsoleStatementContext } from "./CashScriptParser.js";
+import { RequireMessageContext } from "./CashScriptParser.js";
 import { ConsoleParameterContext } from "./CashScriptParser.js";
 import { ConsoleParameterListContext } from "./CashScriptParser.js";
 import { FunctionCallContext } from "./CashScriptParser.js";
@@ -166,6 +167,12 @@ export default class CashScriptVisitor<Result> extends ParseTreeVisitor<Result>
 	 * @return the visitor result
 	 */
 	visitConsoleStatement?: (ctx: ConsoleStatementContext) => Result;
+	/**
+	 * Visit a parse tree produced by `CashScriptParser.requireMessage`.
+	 * @param ctx the parse tree
+	 * @return the visitor result
+	 */
+	visitRequireMessage?: (ctx: RequireMessageContext) => Result;
 	/**
 	 * Visit a parse tree produced by `CashScriptParser.consoleParameter`.
 	 * @param ctx the parse tree
diff --git a/packages/cashc/src/print/OutputSourceCodeTraversal.ts b/packages/cashc/src/print/OutputSourceCodeTraversal.ts
index cc8580d1..1f33ae62 100644
--- a/packages/cashc/src/print/OutputSourceCodeTraversal.ts
+++ b/packages/cashc/src/print/OutputSourceCodeTraversal.ts
@@ -26,6 +26,8 @@ import {
   InstantiationNode,
   TupleAssignmentNode,
   NullaryOpNode,
+  ConsoleStatementNode,
+  ConsoleParameterNode,
 } from '../ast/AST.js';
 import AstTraversal from '../ast/AstTraversal.js';
 
@@ -134,7 +136,13 @@ export default class OutputSourceCodeTraversal extends AstTraversal {
   visitRequire(node: RequireNode): Node {
     this.addOutput('require(', true);
     node.expression = this.visit(node.expression);
+
+    if (node.message) {
+      this.addOutput(`, "${node.message}"`);
+    }
+
     this.addOutput(');\n');
+
     return node;
   }
 
@@ -154,6 +162,13 @@ export default class OutputSourceCodeTraversal extends AstTraversal {
     return node;
   }
 
+  visitConsoleStatement(node: ConsoleStatementNode): Node {
+    this.addOutput('console.log(', true);
+    node.parameters = this.visitCommaList(node.parameters) as ConsoleParameterNode[];
+    this.addOutput(');\n');
+    return node;
+  }
+
   visitBlock(node: BlockNode): Node {
     this.addOutput('{');
     this.outputSymbolTable(node.symbolTable);
diff --git a/packages/cashc/src/semantic/SymbolTableTraversal.ts b/packages/cashc/src/semantic/SymbolTableTraversal.ts
index 5e5fd5cc..3e7f2e92 100644
--- a/packages/cashc/src/semantic/SymbolTableTraversal.ts
+++ b/packages/cashc/src/semantic/SymbolTableTraversal.ts
@@ -12,7 +12,6 @@ import {
   InstantiationNode,
   AssignNode,
   TupleAssignmentNode,
-  ConsoleStatementNode,
 } from '../ast/AST.js';
 import AstTraversal from '../ast/AstTraversal.js';
 import { SymbolTable, Symbol, SymbolType } from '../ast/SymbolTable.js';
@@ -30,7 +29,6 @@ export default class SymbolTableTraversal extends AstTraversal {
   private functionNames: Map<string, boolean> = new Map<string, boolean>();
   private currentFunction: FunctionDefinitionNode;
   private expectedSymbolType: SymbolType = SymbolType.VARIABLE;
-  public logSymbols: Symbol[] = [];
 
   visitContract(node: ContractNode): Node {
     node.symbolTable = new SymbolTable(this.symbolTables[0]);
@@ -170,15 +168,4 @@ export default class SymbolTableTraversal extends AstTraversal {
 
     return node;
   }
-
-  visitConsoleStatement(node: ConsoleStatementNode): ConsoleStatementNode {
-    // there might be same-name symbols in different code scopes
-    // so we collect all symbols with their location, which will be analyzed later
-    const symbols = node.parameters
-      .map((parameter) => this.symbolTables[0].get(parameter.identifier!)!)
-      .filter((symbol) => symbol);
-
-    this.logSymbols.push(...symbols);
-    return node;
-  }
 }
diff --git a/packages/cashc/test/ast/fixtures.ts b/packages/cashc/test/ast/fixtures.ts
index 34d0933a..189a304a 100644
--- a/packages/cashc/test/ast/fixtures.ts
+++ b/packages/cashc/test/ast/fixtures.ts
@@ -25,7 +25,6 @@ import {
   UnaryOpNode,
   InstantiationNode,
   ConsoleStatementNode,
-  ConsoleParameterNode,
 } from '../../src/ast/AST.js';
 import { BinaryOperator, NullaryOperator, UnaryOperator } from '../../src/ast/Operator.js';
 import { Class, TimeOp } from '../../src/ast/Globals.js';
@@ -901,8 +900,8 @@ export const fixtures: Fixture[] = [
             [new ParameterNode(PrimitiveType.INT, 'value')],
             new BlockNode([
               new ConsoleStatementNode([
-                new ConsoleParameterNode(undefined, 'value'),
-                new ConsoleParameterNode('test'),
+                new IdentifierNode('value'),
+                new StringLiteralNode('test', '"'),
               ]),
               new RequireNode(
                 new BinaryOpNode(
diff --git a/packages/cashc/test/compiler/UndefinedReferenceError/undefined_variable_in_console_log.cash b/packages/cashc/test/compiler/UndefinedReferenceError/undefined_variable_in_console_log.cash
new file mode 100644
index 00000000..4f516124
--- /dev/null
+++ b/packages/cashc/test/compiler/UndefinedReferenceError/undefined_variable_in_console_log.cash
@@ -0,0 +1,5 @@
+contract Test() {
+    function hello() {
+        console.log(a, 'hello');
+    }
+}

From 97eb9a3b9c83f5a696f740d18560b73849cb6c02 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 23 Jan 2024 09:13:31 +0100
Subject: [PATCH 016/267] Update debug_messages.cash test to be a bit more
 complex

---
 .../src/generation/GenerateTargetTraversal.ts |  1 +
 packages/cashc/test/ast/fixtures.ts           | 22 ++++++++++++++++---
 packages/cashc/test/generation/fixtures.ts    | 10 ++++-----
 .../valid-contract-files/debug_messages.cash  |  4 +++-
 4 files changed, 28 insertions(+), 9 deletions(-)

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 3754ac2f..ea7701ac 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -549,6 +549,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // TODO: refactor to use a map instead of array (also in the artifact and other places where console logs and
     // require statements are used)
     // check if log entry exists for the instruction pointer, create if not
+    // TODO: Do we really want to merge different console logs at the same instruction pointer?
     let index = this.consoleLogs.findIndex((entry: LogEntry) => entry.ip === ip);
     if (index === -1) {
       index = this.consoleLogs.push({ ip, line, data: [] }) - 1;
diff --git a/packages/cashc/test/ast/fixtures.ts b/packages/cashc/test/ast/fixtures.ts
index 189a304a..20ed93b2 100644
--- a/packages/cashc/test/ast/fixtures.ts
+++ b/packages/cashc/test/ast/fixtures.ts
@@ -899,17 +899,33 @@ export const fixtures: Fixture[] = [
             'spend',
             [new ParameterNode(PrimitiveType.INT, 'value')],
             new BlockNode([
+              new RequireNode(
+                new BinaryOpNode(
+                  new IdentifierNode('value'),
+                  BinaryOperator.EQ,
+                  new IntLiteralNode(1n),
+                ),
+                'Wrong value passed',
+              ),
               new ConsoleStatementNode([
                 new IdentifierNode('value'),
                 new StringLiteralNode('test', '"'),
               ]),
+              new ConsoleStatementNode([
+                new IdentifierNode('value'),
+                new StringLiteralNode('test2', '"'),
+              ]),
               new RequireNode(
                 new BinaryOpNode(
-                  new IdentifierNode('value'),
+                  new BinaryOpNode(
+                    new IdentifierNode('value'),
+                    BinaryOperator.PLUS,
+                    new IntLiteralNode(1n),
+                  ),
                   BinaryOperator.EQ,
-                  new IntLiteralNode(1n),
+                  new IntLiteralNode(2n),
                 ),
-                'Wrong value passed',
+                'Sum doesn\'t work',
               ),
             ]),
           ),
diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index e6d4749b..b8b2a8f7 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -649,12 +649,12 @@ export const fixtures: Fixture[] = [
       abi: [
         { name: 'spend', inputs: [{ name: 'value', type: 'int' }] },
       ],
-      bytecode: 'OP_1 OP_NUMEQUAL',
+      bytecode: 'OP_DUP OP_1 OP_NUMEQUALVERIFY OP_1ADD OP_2 OP_NUMEQUAL',
       debug: {
-        bytecode: '007a519c',
-        logs: [{ data: [{ stackIndex: 0, type: 'int' }, 'test'], ip: 0, line: 3 }],
-        requireMessages: [{ ip: 4, line: 4, message: 'Wrong value passed' }],
-        sourceMap: '4:12:4:17;;:21::22;:12:::1',
+        bytecode: '0079519c69007a5193529c',
+        logs: [{ data: [{ stackIndex: 0, type: 'int' }, 'test', { stackIndex: 0, type: 'int' }, 'test2'], ip: 5, line: 4 }],
+        requireMessages: [{ ip: 4, line: 3, message: 'Wrong value passed' }, { ip: 11, line: 6, message: 'Sum doesn\'t work' }],
+        sourceMap: '3:12:3:17;;:21::22;:12:::1;:4::46;6:12:6:17:0;;:20::21;:12:::1;:25::26:0;:12:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/debug_messages.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
diff --git a/packages/cashc/test/valid-contract-files/debug_messages.cash b/packages/cashc/test/valid-contract-files/debug_messages.cash
index fcb88c7b..92203434 100644
--- a/packages/cashc/test/valid-contract-files/debug_messages.cash
+++ b/packages/cashc/test/valid-contract-files/debug_messages.cash
@@ -1,6 +1,8 @@
 contract DebugMessages() {
   function spend(int value) {
-    console.log(value, "test");
     require(value == 1, "Wrong value passed");
+    console.log(value, "test");
+    console.log(value, "test2");
+    require(value + 1 == 2, "Sum doesn't work");
   }
 }

From 5e7263aa127774f725b4f49feb8fe9151a5c2c21 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 23 Jan 2024 09:19:59 +0100
Subject: [PATCH 017/267] Extract DebugInformation type for Artifact + small
 changes to artifact debug generation

---
 packages/cashc/src/artifact/Artifact.ts | 23 +++--------------------
 packages/cashc/src/compiler.ts          | 12 ++++++++----
 packages/utils/src/artifact.ts          | 14 ++++++++------
 3 files changed, 19 insertions(+), 30 deletions(-)

diff --git a/packages/cashc/src/artifact/Artifact.ts b/packages/cashc/src/artifact/Artifact.ts
index a5161b6f..b5e584f6 100644
--- a/packages/cashc/src/artifact/Artifact.ts
+++ b/packages/cashc/src/artifact/Artifact.ts
@@ -1,21 +1,10 @@
 import {
-  Artifact, LogEntry, RequireMessage, Script, scriptToAsm, scriptToBytecode,
+  Artifact, DebugInformation, Script, scriptToAsm,
 } from '@cashscript/utils';
 import { version } from '../index.js';
 import { Ast } from '../ast/AST.js';
-import { binToHex } from '@bitauth/libauth';
 
-export function generateArtifact(
-  ast: Ast,
-  script: Script,
-  source: string,
-  debug: {
-    script: Script,
-    sourceMap: string,
-    logs: LogEntry[],
-    requireMessages: RequireMessage[],
-  },
-): Artifact {
+export function generateArtifact(ast: Ast, script: Script, source: string, debug: DebugInformation): Artifact {
   const { contract } = ast;
 
   const constructorInputs = contract.parameters
@@ -30,7 +19,6 @@ export function generateArtifact(
   }));
 
   const bytecode = scriptToAsm(script);
-  const debugBytecode = binToHex(scriptToBytecode(debug.script));
 
   return {
     contractName: contract.name,
@@ -38,12 +26,7 @@ export function generateArtifact(
     abi,
     bytecode,
     source,
-    debug: {
-      bytecode: debugBytecode,
-      sourceMap: debug.sourceMap,
-      logs: debug.logs,
-      requireMessages: debug.requireMessages,
-    },
+    debug,
     compiler: {
       name: 'cashc',
       version,
diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index 8d8f2192..4fad313d 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -1,5 +1,6 @@
 import { CharStream, CommonTokenStream } from 'antlr4';
-import { Artifact, optimiseBytecode } from '@cashscript/utils';
+import { binToHex } from '@bitauth/libauth';
+import { Artifact, optimiseBytecode, scriptToBytecode } from '@cashscript/utils';
 import fs, { PathLike } from 'fs';
 import { generateArtifact } from './artifact/Artifact.js';
 import { Ast } from './ast/AST.js';
@@ -28,12 +29,15 @@ export function compileString(code: string): Artifact {
   // Bytecode optimisation
   const optimisedBytecode = optimiseBytecode(traversal.output);
 
-  return generateArtifact(ast, optimisedBytecode, code, {
-    script: traversal.output,
+  // Attach debug information
+  const debug = {
+    bytecode: binToHex(scriptToBytecode(traversal.output)),
     sourceMap: traversal.souceMap,
     logs: traversal.consoleLogs,
     requireMessages: traversal.requireMessages,
-  });
+  };
+
+  return generateArtifact(ast, optimisedBytecode, code, debug);
 }
 
 export function compileFile(codeFile: PathLike): Artifact {
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index 97ef690d..54952783 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -11,6 +11,13 @@ export interface AbiFunction {
   inputs: AbiInput[];
 }
 
+export interface DebugInformation {
+  bytecode: string; // unlike `bytecode` property above, this is a hex-encoded binary string
+  sourceMap: string; // see documentation for `generateSourceMap`
+  logs: LogEntry[]; // log entries generated from `console.log` statements
+  requireMessages: RequireMessage[]; // messages for failing `require` statements
+}
+
 export interface LogEntry {
   ip: number; // instruction pointer
   line: number; // line in the source code
@@ -29,12 +36,7 @@ export interface Artifact {
   abi: AbiFunction[];
   bytecode: string;
   source: string;
-  debug?: {
-    bytecode: string; // unlike `bytecode` property above, this is a hex-encoded binary string
-    sourceMap: string; // see documentation for `generateSourceMap`
-    logs: LogEntry[]; // log entries generated from `console.log` statements
-    requireMessages: RequireMessage[]; // messages for failing `require` statements
-  };
+  debug?: DebugInformation;
   compiler: {
     name: string;
     version: string;

From 51611b70209d5dca506f18cbdbe40454dd4db7ce Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 23 Jan 2024 09:26:58 +0100
Subject: [PATCH 018/267] Rename souceMap => sourceMap

---
 packages/cashc/src/compiler.ts                       |  2 +-
 .../cashc/src/generation/GenerateTargetTraversal.ts  |  4 ++--
 packages/utils/src/bitauth-script.ts                 | 12 ++++++------
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index 4fad313d..adfde685 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -32,7 +32,7 @@ export function compileString(code: string): Artifact {
   // Attach debug information
   const debug = {
     bytecode: binToHex(scriptToBytecode(traversal.output)),
-    sourceMap: traversal.souceMap,
+    sourceMap: traversal.sourceMap,
     logs: traversal.consoleLogs,
     requireMessages: traversal.requireMessages,
   };
diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index ea7701ac..639d9b70 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -60,7 +60,7 @@ import { Location } from '../ast/Location.js';
 
 export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   private locationData: LocationData = []; // detailed location data needed for sourcemap creation
-  souceMap: string;
+  sourceMap: string;
   output: Script = [];
   stack: string[] = [];
   consoleLogs: LogEntry[] = [];
@@ -114,7 +114,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // Minimally encode output by going Script -> ASM -> Script
     this.output = asmToScript(scriptToAsm(this.output));
 
-    this.souceMap = generateSourceMap(this.locationData);
+    this.sourceMap = generateSourceMap(this.locationData);
 
     return node;
   }
diff --git a/packages/utils/src/bitauth-script.ts b/packages/utils/src/bitauth-script.ts
index a9d47b9c..f0466d4d 100644
--- a/packages/utils/src/bitauth-script.ts
+++ b/packages/utils/src/bitauth-script.ts
@@ -4,8 +4,8 @@ import { sourceMapToLocationData } from './source-map.js';
 export type LineToOpcodesMap = Record<string, Script>;
 export type LineToAsmMap = Record<string, string>;
 
-export function buildLineToOpcodesMap(bytecode: Script, souceMap: string): LineToOpcodesMap {
-  const locationData = sourceMapToLocationData(souceMap);
+export function buildLineToOpcodesMap(bytecode: Script, sourceMap: string): LineToOpcodesMap {
+  const locationData = sourceMapToLocationData(sourceMap);
 
   return locationData.reduce<LineToOpcodesMap>((lineToOpcodeMap, [location, positionHint], index) => {
     const opcode = bytecode[index];
@@ -18,16 +18,16 @@ export function buildLineToOpcodesMap(bytecode: Script, souceMap: string): LineT
   }, {});
 }
 
-export function buildLineToAsmMap(bytecode: Script, souceMap: string): LineToAsmMap {
-  const lineToOpcodesMap = buildLineToOpcodesMap(bytecode, souceMap);
+export function buildLineToAsmMap(bytecode: Script, sourceMap: string): LineToAsmMap {
+  const lineToOpcodesMap = buildLineToOpcodesMap(bytecode, sourceMap);
 
   return Object.fromEntries(
     Object.entries(lineToOpcodesMap).map(([lineNumber, opcodeList]) => [lineNumber, scriptToBitAuthAsm(opcodeList)]),
   );
 }
 
-export function formatBitAuthScript(bytecode: Script, souceMap: string, sourceCode: string): string {
-  const lineToAsmMap = buildLineToAsmMap(bytecode, souceMap);
+export function formatBitAuthScript(bytecode: Script, sourceMap: string, sourceCode: string): string {
+  const lineToAsmMap = buildLineToAsmMap(bytecode, sourceMap);
 
   const sourceCodeLines = sourceCode.split('\n');
 

From e9b0f9703bce3d7dfe3643c71663050106b2658e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 23 Jan 2024 10:20:34 +0100
Subject: [PATCH 019/267] Update LocationData / PositionHint types

- Add enum for PositionHint
- Convert LocationData type to an object (instead of tuple)
- Update AST's Node class to always have a defined location
- Update LocationData's usage to reflect these new types
- Refactor some code in source-map.ts
- Update tests and fixtures to reflect these changes
---
 packages/cashc/src/ast/AST.ts                 |   2 +-
 packages/cashc/src/ast/Location.ts            |   4 +-
 .../src/generation/GenerateTargetTraversal.ts | 193 +++++++------
 packages/cashc/test/ast/Location.test.ts      |  10 +-
 packages/utils/src/bitauth-script.ts          |   5 +-
 packages/utils/src/source-map.ts              |  79 +++---
 packages/utils/src/types.ts                   |  24 ++
 .../utils/test/fixtures/source-map.fixture.ts | 266 +++++++++---------
 8 files changed, 318 insertions(+), 265 deletions(-)

diff --git a/packages/cashc/src/ast/AST.ts b/packages/cashc/src/ast/AST.ts
index d6acd68a..f8c7b762 100644
--- a/packages/cashc/src/ast/AST.ts
+++ b/packages/cashc/src/ast/AST.ts
@@ -9,7 +9,7 @@ import { binToHex } from '@bitauth/libauth';
 export type Ast = SourceFileNode;
 
 export abstract class Node {
-  location?: Location;
+  location: Location;
   abstract accept<T>(visitor: AstVisitor<T>): T;
 }
 
diff --git a/packages/cashc/src/ast/Location.ts b/packages/cashc/src/ast/Location.ts
index ebaaf151..a3054606 100644
--- a/packages/cashc/src/ast/Location.ts
+++ b/packages/cashc/src/ast/Location.ts
@@ -4,7 +4,7 @@ import { LocationI } from '@cashscript/utils';
 export class Location implements LocationI {
   constructor(public start: Point, public end: Point) {}
 
-  static fromCtx(ctx: ParserRuleContext): Location | undefined {
+  static fromCtx(ctx: ParserRuleContext): Location {
     const stop = ctx.stop?.text ? ctx.stop : ctx.start;
     const textLength = (stop.text ?? '').length;
 
@@ -14,7 +14,7 @@ export class Location implements LocationI {
     return new Location(start, end);
   }
 
-  static fromToken(token: Token): Location | undefined {
+  static fromToken(token: Token): Location {
     const textLength = (token.text ?? '').length;
 
     const start = new Point(token.line, token.column);
diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 639d9b70..6e1f5fbc 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -11,10 +11,11 @@ import {
   Script,
   scriptToAsm,
   generateSourceMap,
-  LocationI,
-  LocationData,
+  FullLocationData,
   LogEntry,
   RequireMessage,
+  PositionHint,
+  SingleLocationData,
 } from '@cashscript/utils';
 import {
   ContractNode,
@@ -56,10 +57,9 @@ import {
   compileTimeOp,
   compileUnaryOp,
 } from './utils.js';
-import { Location } from '../ast/Location.js';
 
 export default class GenerateTargetTraversalWithLocation extends AstTraversal {
-  private locationData: LocationData = []; // detailed location data needed for sourcemap creation
+  private locationData: FullLocationData = []; // detailed location data needed for sourcemap creation
   sourceMap: string;
   output: Script = [];
   stack: string[] = [];
@@ -70,13 +70,13 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   private currentFunction: FunctionDefinitionNode;
   private constructorParameterCount: number;
 
-  private emit(op: OpOrData | OpOrData[], location: LocationI, positionHint?: number): void {
+  private emit(op: OpOrData | OpOrData[], locationData: SingleLocationData): void {
     if (Array.isArray(op)) {
       op.forEach((element) => this.output.push(element as Op));
-      op.forEach(() => this.locationData.push([location, positionHint]));
+      op.forEach(() => this.locationData.push(locationData));
     } else {
       this.output.push(op);
-      this.locationData.push([location, positionHint]);
+      this.locationData.push(locationData);
     }
   }
 
@@ -127,37 +127,40 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     } else {
       this.pushToStack('$$', true);
       node.functions = node.functions.map((f, i) => {
+        const locationData = { location: f.location };
+
         const stackCopy = [...this.stack];
         const selectorIndex = this.getStackIndex('$$');
-        this.emit(encodeInt(BigInt(selectorIndex)), f.location!);
+
+        this.emit(encodeInt(BigInt(selectorIndex)), locationData);
         if (i === node.functions.length - 1) {
-          this.emit(Op.OP_ROLL, f.location!);
+          this.emit(Op.OP_ROLL, locationData);
           this.removeFromStack(selectorIndex);
         } else {
-          this.emit(Op.OP_PICK, f.location!);
+          this.emit(Op.OP_PICK, locationData);
         }
 
         // All functions are if-else statements, except the final one which is
         // enforced with NUMEQUALVERIFY
-        this.emit(encodeInt(BigInt(i)), f.location!);
-        this.emit(Op.OP_NUMEQUAL, f.location!);
+        this.emit(encodeInt(BigInt(i)), locationData);
+        this.emit(Op.OP_NUMEQUAL, locationData);
         if (i < node.functions.length - 1) {
-          this.emit(Op.OP_IF, f.location!);
+          this.emit(Op.OP_IF, locationData);
         } else {
-          this.emit(Op.OP_VERIFY, f.location!);
+          this.emit(Op.OP_VERIFY, locationData);
         }
 
         f = this.visit(f) as FunctionDefinitionNode;
 
         if (i < node.functions.length - 1) {
-          this.emit(Op.OP_ELSE, f.location!, 1);
+          this.emit(Op.OP_ELSE, { ...locationData, positionHint: PositionHint.END });
         }
 
         this.stack = [...stackCopy];
         return f;
       });
       for (let i = 0; i < node.functions.length - 1; i += 1) {
-        this.emit(Op.OP_ENDIF, node.location!, 1);
+        this.emit(Op.OP_ENDIF, { location: node.location, positionHint: PositionHint.END });
       }
     }
 
@@ -181,7 +184,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // "OP_VERIFY", "OP_CHECK{LOCKTIME|SEQUENCE}VERIFY OP_DROP" or "OP_ENDIF"
 
     const finalOp = this.output.pop() as Op;
-    const [location] = this.locationData.pop() as [Location, number?];
+    const { location } = this.locationData.pop()!;
 
     // If the final op is OP_VERIFY and the stack size is less than 4 we remove it from the script
     // - We have the stack size check because it is more efficient to use 2DROP rather than NIP
@@ -191,13 +194,13 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
       // we add it back to the stack
       this.pushToStack('(value)');
     } else {
-      this.emit(finalOp, location!, 1);
+      this.emit(finalOp, { location, positionHint: PositionHint.END });
 
       // At this point there is no verification value left on the stack:
       //  - scoped stack is cleared inside branch ended by OP_ENDIF
       //  - OP_CHECK{LOCKTIME|SEQUENCE}VERIFY OP_DROP does not leave a verification value
       // so we add OP_1 to the script (indicating success)
-      this.emit(Op.OP_1, node.location!, 1);
+      this.emit(Op.OP_1, { location: node.location, positionHint: PositionHint.END });
       this.pushToStack('(value)');
     }
   }
@@ -206,7 +209,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // Keep final verification value, OP_NIP the other stack values
     const stackSize = this.stack.length;
     for (let i = 0; i < stackSize - 1; i += 1) {
-      this.emit(Op.OP_NIP, node.location!, 1);
+      this.emit(Op.OP_NIP, { location: node.location, positionHint: PositionHint.END });
       this.nipFromStack();
     }
   }
@@ -246,30 +249,32 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   // This algorithm can be optimised for hardcoded depths
   // See thesis for explanation
   emitReplace(index: number, node: Node): void {
-    this.emit(encodeInt(BigInt(index)), node.location!);
-    this.emit(Op.OP_ROLL, node.location!);
-    this.emit(Op.OP_DROP, node.location!);
+    const locationData = { location: node.location };
+
+    this.emit(encodeInt(BigInt(index)), locationData);
+    this.emit(Op.OP_ROLL, locationData);
+    this.emit(Op.OP_DROP, locationData);
     for (let i = 0; i < index - 1; i += 1) {
-      this.emit(Op.OP_SWAP, node.location!);
+      this.emit(Op.OP_SWAP, locationData);
       if (i < index - 2) {
-        this.emit(Op.OP_TOALTSTACK, node.location!);
+        this.emit(Op.OP_TOALTSTACK, locationData);
       }
     }
     for (let i = 0; i < index - 2; i += 1) {
-      this.emit(Op.OP_FROMALTSTACK, node.location!);
+      this.emit(Op.OP_FROMALTSTACK, locationData);
     }
   }
 
   visitTimeOp(node: TimeOpNode): Node {
     // const countBefore = this.output.length;
     node.expression = this.visit(node.expression);
-    this.emit(compileTimeOp(node.timeOp), node.location!, 1);
+    this.emit(compileTimeOp(node.timeOp), { location: node.location, positionHint: PositionHint.END });
 
     // add debug require message
     if (node.message) {
       this.requireMessages.push({
         ip: this.output.length + this.constructorParameterCount - 1,
-        line: node.location!.start.line,
+        line: node.location.start.line,
         message: node.message,
       });
     }
@@ -281,13 +286,13 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   visitRequire(node: RequireNode): Node {
     node.expression = this.visit(node.expression);
 
-    this.emit(Op.OP_VERIFY, node.location!, 1);
+    this.emit(Op.OP_VERIFY, { location: node.location, positionHint: PositionHint.END });
 
     // add debug require message
     if (node.message) {
       this.requireMessages.push({
         ip: this.output.length + this.constructorParameterCount - 1,
-        line: node.location!.start.line,
+        line: node.location.start.line,
         message: node.message,
       });
     }
@@ -301,20 +306,27 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     this.popFromStack();
 
     this.scopeDepth += 1;
-    this.emit(Op.OP_IF, node.ifBlock.location!);
+    this.emit(Op.OP_IF, { location: node.ifBlock.location });
 
     let stackDepth = this.stack.length;
     node.ifBlock = this.visit(node.ifBlock);
     this.removeScopedVariables(stackDepth, node);
 
     if (node.elseBlock) {
-      this.emit(Op.OP_ELSE, node.elseBlock.location!, 1);
+      // TODO: Why would the *start* of the else block be PositionHint.END? Is it because it is also the end of
+      // the if block?
+      this.emit(Op.OP_ELSE, { location: node.elseBlock.location, positionHint: PositionHint.END });
       stackDepth = this.stack.length;
       node.elseBlock = this.visit(node.elseBlock);
       this.removeScopedVariables(stackDepth, node);
     }
 
-    this.emit(Op.OP_ENDIF, node.elseBlock ? node.elseBlock.location! : node.ifBlock.location!, 1);
+    const endLocationData = {
+      location: node.elseBlock ? node.elseBlock.location : node.ifBlock.location,
+      positionHint: PositionHint.END,
+    };
+
+    this.emit(Op.OP_ENDIF, endLocationData);
     this.scopeDepth -= 1;
 
     return node;
@@ -323,7 +335,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   removeScopedVariables(depthBeforeScope: number, node: Node): void {
     const dropCount = this.stack.length - depthBeforeScope;
     for (let i = 0; i < dropCount; i += 1) {
-      this.emit(Op.OP_DROP, node.location!);
+      this.emit(Op.OP_DROP, { location: node.location });
       this.popFromStack();
     }
   }
@@ -334,11 +346,14 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // Special case for sized bytes cast, since it has another node to traverse
     if (node.size) {
       node.size = this.visit(node.size);
-      this.emit(Op.OP_NUM2BIN, node.location!);
+      this.emit(Op.OP_NUM2BIN, { location: node.location });
       this.popFromStack();
     }
 
-    this.emit(compileCast(node.expression.type as PrimitiveType, node.type), node.location!, 1);
+    this.emit(
+      compileCast(node.expression.type as PrimitiveType, node.type),
+      { location: node.location, positionHint: PositionHint.END },
+    );
     this.popFromStack();
     this.pushToStack('(value)');
     return node;
@@ -351,7 +366,10 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
     node.parameters = this.visitList(node.parameters);
 
-    this.emit(compileGlobalFunction(node.identifier.name as GlobalFunction), node.location!, 1);
+    this.emit(
+      compileGlobalFunction(node.identifier.name as GlobalFunction),
+      { location: node.location, positionHint: PositionHint.END },
+    );
     this.popFromStack(node.parameters.length);
     this.pushToStack('(value)');
 
@@ -359,10 +377,10 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   }
 
   visitMultiSig(node: FunctionCallNode): Node {
-    this.emit(encodeBool(false), node.location!);
+    this.emit(encodeBool(false), { location: node.location });
     this.pushToStack('(value)');
     node.parameters = this.visitList(node.parameters);
-    this.emit(Op.OP_CHECKMULTISIG, node.location!, 1);
+    this.emit(Op.OP_CHECKMULTISIG, { location: node.location, positionHint: PositionHint.END });
     const sigs = node.parameters[0] as ArrayNode;
     const pks = node.parameters[1] as ArrayNode;
     this.popFromStack(sigs.elements.length + pks.elements.length + 3);
@@ -372,72 +390,75 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   }
 
   visitInstantiation(node: InstantiationNode): Node {
+    const nodeLocationData = { location: node.location };
+
     if (node.identifier.name === Class.LOCKING_BYTECODE_P2PKH) {
       // OP_DUP OP_HASH160 OP_PUSH<20>
-      this.emit(hexToBin('76a914'), node.location!);
+      this.emit(hexToBin('76a914'), nodeLocationData);
       this.pushToStack('(value)');
       // <pkh>
       this.visit(node.parameters[0]);
-      this.emit(Op.OP_CAT, node.location!);
+      this.emit(Op.OP_CAT, nodeLocationData);
       // OP_EQUAL OP_CHECKSIG
-      this.emit(hexToBin('88ac'), node.location!);
-      this.emit(Op.OP_CAT, node.location!);
+      this.emit(hexToBin('88ac'), nodeLocationData);
+      this.emit(Op.OP_CAT, nodeLocationData);
       this.popFromStack(2);
     } else if (node.identifier.name === Class.LOCKING_BYTECODE_P2SH20) {
       // OP_HASH160 OP_PUSH<20>
-      this.emit(hexToBin('a914'), node.location!);
+      this.emit(hexToBin('a914'), nodeLocationData);
       this.pushToStack('(value)');
       // <script hash>
       this.visit(node.parameters[0]);
-      this.emit(Op.OP_CAT, node.location!);
+      this.emit(Op.OP_CAT, nodeLocationData);
       // OP_EQUAL
-      this.emit(hexToBin('87'), node.location!);
-      this.emit(Op.OP_CAT, node.location!);
+      this.emit(hexToBin('87'), nodeLocationData);
+      this.emit(Op.OP_CAT, nodeLocationData);
       this.popFromStack(2);
     } else if (node.identifier.name === Class.LOCKING_BYTECODE_P2SH32) {
       // OP_HASH256 OP_PUSH<32>
-      this.emit(hexToBin('aa20'), node.location!);
+      this.emit(hexToBin('aa20'), nodeLocationData);
       this.pushToStack('(value)');
       // <script hash>
       this.visit(node.parameters[0]);
-      this.emit(Op.OP_CAT, node.location!);
+      this.emit(Op.OP_CAT, nodeLocationData);
       // OP_EQUAL
-      this.emit(hexToBin('87'), node.location!);
-      this.emit(Op.OP_CAT, node.location!);
+      this.emit(hexToBin('87'), nodeLocationData);
+      this.emit(Op.OP_CAT, nodeLocationData);
       this.popFromStack(2);
     } else if (node.identifier.name === Class.LOCKING_BYTECODE_NULLDATA) {
       // Total script = OP_RETURN (<VarInt> <chunk>)+
       // OP_RETURN
-      this.emit(hexToBin('6a'), node.location!);
+      this.emit(hexToBin('6a'), nodeLocationData);
       this.pushToStack('(value)');
       const { elements } = node.parameters[0] as ArrayNode;
       // <VarInt data chunk size (dynamic)>
-      elements.forEach((el) => {
-        this.visit(el);
+      elements.forEach((element) => {
+        const elementLocationData = { location: element.location };
+        this.visit(element);
         // Push the element's size (and calculate VarInt)
-        this.emit(Op.OP_SIZE, el.location!);
-        if (el instanceof HexLiteralNode) {
+        this.emit(Op.OP_SIZE, elementLocationData);
+        if (element instanceof HexLiteralNode) {
           // If the argument is a literal, we know its size
-          if (el.value.byteLength > 75) {
-            this.emit(hexToBin('4c'), el.location!);
-            this.emit(Op.OP_SWAP, el.location!);
-            this.emit(Op.OP_CAT, el.location!);
+          if (element.value.byteLength > 75) {
+            this.emit(hexToBin('4c'), elementLocationData);
+            this.emit(Op.OP_SWAP, elementLocationData);
+            this.emit(Op.OP_CAT, elementLocationData);
           }
         } else {
           // If the argument is not a literal, the script needs to check size
-          this.emit(Op.OP_DUP, el.location!);
-          this.emit(encodeInt(75n), el.location!);
-          this.emit(Op.OP_GREATERTHAN, el.location!);
-          this.emit(Op.OP_IF, el.location!);
-          this.emit(hexToBin('4c'), el.location!);
-          this.emit(Op.OP_SWAP, el.location!);
-          this.emit(Op.OP_CAT, el.location!);
-          this.emit(Op.OP_ENDIF, el.location!);
+          this.emit(Op.OP_DUP, elementLocationData);
+          this.emit(encodeInt(75n), elementLocationData);
+          this.emit(Op.OP_GREATERTHAN, elementLocationData);
+          this.emit(Op.OP_IF, elementLocationData);
+          this.emit(hexToBin('4c'), elementLocationData);
+          this.emit(Op.OP_SWAP, elementLocationData);
+          this.emit(Op.OP_CAT, elementLocationData);
+          this.emit(Op.OP_ENDIF, elementLocationData);
         }
         // Concat size and arguments
-        this.emit(Op.OP_SWAP, el.location!);
-        this.emit(Op.OP_CAT, el.location!);
-        this.emit(Op.OP_CAT, el.location!);
+        this.emit(Op.OP_SWAP, elementLocationData);
+        this.emit(Op.OP_CAT, elementLocationData);
+        this.emit(Op.OP_CAT, elementLocationData);
         this.popFromStack();
       });
       this.popFromStack();
@@ -453,11 +474,13 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   visitTupleIndexOp(node: TupleIndexOpNode): Node {
     node.tuple = this.visit(node.tuple);
 
+    const locationData = { location: node.location, positionHint: PositionHint.END };
+
     if (node.index === 0) {
-      this.emit(Op.OP_DROP, node.location!, 1);
+      this.emit(Op.OP_DROP, locationData);
       this.popFromStack();
     } else if (node.index === 1) {
-      this.emit(Op.OP_NIP, node.location!, 1);
+      this.emit(Op.OP_NIP, locationData);
       this.nipFromStack();
     }
 
@@ -468,7 +491,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     node.left = this.visit(node.left);
     node.right = this.visit(node.right);
     const isNumeric = resultingType(node.left.type, node.right.type) === PrimitiveType.INT;
-    this.emit(compileBinaryOp(node.operator, isNumeric), node.location!, 1);
+    this.emit(compileBinaryOp(node.operator, isNumeric), { location: node.location, positionHint: PositionHint.END });
     this.popFromStack(2);
     this.pushToStack('(value)');
     if (node.operator === BinaryOperator.SPLIT) this.pushToStack('(value)');
@@ -477,36 +500,36 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
   visitUnaryOp(node: UnaryOpNode): Node {
     node.expression = this.visit(node.expression);
-    this.emit(compileUnaryOp(node.operator), node.location!);
+    this.emit(compileUnaryOp(node.operator), { location: node.location });
     this.popFromStack();
     this.pushToStack('(value)');
     return node;
   }
 
   visitNullaryOp(node: NullaryOpNode): Node {
-    this.emit(compileNullaryOp(node.operator), node.location!);
+    this.emit(compileNullaryOp(node.operator), { location: node.location });
     this.pushToStack('(value)');
     return node;
   }
 
   visitArray(node: ArrayNode): Node {
     node.elements = this.visitList(node.elements);
-    this.emit(encodeInt(BigInt(node.elements.length)), node.location!, 1);
+    this.emit(encodeInt(BigInt(node.elements.length)), { location: node.location, positionHint: PositionHint.END });
     this.pushToStack('(value)');
     return node;
   }
 
   visitIdentifier(node: IdentifierNode): Node {
     const stackIndex = this.getStackIndex(node.name);
-    this.emit(encodeInt(BigInt(stackIndex)), node.location!);
+    this.emit(encodeInt(BigInt(stackIndex)), { location: node.location });
 
     // If the final use is inside an if-statement, we still OP_PICK it
     // We do this so that there's no difference in stack depths between execution paths
     if (this.isOpRoll(node)) {
-      this.emit(Op.OP_ROLL, node.location!);
+      this.emit(Op.OP_ROLL, { location: node.location });
       this.removeFromStack(stackIndex);
     } else {
-      this.emit(Op.OP_PICK, node.location!);
+      this.emit(Op.OP_PICK, { location: node.location });
     }
 
     this.pushToStack('(value)');
@@ -518,25 +541,25 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   }
 
   visitBoolLiteral(node: BoolLiteralNode): Node {
-    this.emit(encodeBool(node.value), node.location!);
+    this.emit(encodeBool(node.value), { location: node.location });
     this.pushToStack('(value)');
     return node;
   }
 
   visitIntLiteral(node: IntLiteralNode): Node {
-    this.emit(encodeInt(node.value), node.location!);
+    this.emit(encodeInt(node.value), { location: node.location });
     this.pushToStack('(value)');
     return node;
   }
 
   visitStringLiteral(node: StringLiteralNode): Node {
-    this.emit(encodeString(node.value), node.location!);
+    this.emit(encodeString(node.value), { location: node.location });
     this.pushToStack('(value)');
     return node;
   }
 
   visitHexLiteral(node: HexLiteralNode): Node {
-    this.emit(node.value, node.location!);
+    this.emit(node.value, { location: node.location });
     this.pushToStack('(value)');
     return node;
   }
@@ -544,7 +567,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   visitConsoleStatement(node: ConsoleStatementNode): Node {
     // instruction pointer is the count of emitted opcodes + number of constructor data pushes
     const ip = this.output.length + this.constructorParameterCount;
-    const { line } = node.location!.start;
+    const { line } = node.location.start;
 
     // TODO: refactor to use a map instead of array (also in the artifact and other places where console logs and
     // require statements are used)
diff --git a/packages/cashc/test/ast/Location.test.ts b/packages/cashc/test/ast/Location.test.ts
index aebc0a3e..d6a70891 100644
--- a/packages/cashc/test/ast/Location.test.ts
+++ b/packages/cashc/test/ast/Location.test.ts
@@ -12,7 +12,7 @@ describe('Location', () => {
     const f = ast.contract.functions[0];
 
     expect(f.location).toBeDefined();
-    expect((f.location!).text(code)).toEqual('function hello(sig s, pubkey pk) {\n        require(checkSig(s, pk));\n    }');
+    expect((f.location).text(code)).toEqual('function hello(sig s, pubkey pk) {\n        require(checkSig(s, pk));\n    }');
   });
 
   const wrap = (code: string): string => {
@@ -87,13 +87,13 @@ contract test() {
     const secondFunction = ast.contract.functions[1];
 
     expect(secondFunction.location).toBeDefined();
-    expect(secondFunction.location!.start).toEqual({ line: 6, column: 4 });
-    expect(secondFunction.location!.end).toEqual({ line: 8, column: 5 });
+    expect(secondFunction.location.start).toEqual({ line: 6, column: 4 });
+    expect(secondFunction.location.end).toEqual({ line: 8, column: 5 });
 
     const firstStatement = secondFunction.body.statements![0];
 
     expect(firstStatement.location).toBeDefined();
-    expect(firstStatement.location!.start).toEqual({ line: 7, column: 8 });
-    expect(firstStatement.location!.end).toEqual({ line: 7, column: 29 });
+    expect(firstStatement.location.start).toEqual({ line: 7, column: 8 });
+    expect(firstStatement.location.end).toEqual({ line: 7, column: 29 });
   });
 });
diff --git a/packages/utils/src/bitauth-script.ts b/packages/utils/src/bitauth-script.ts
index f0466d4d..21a7f4c5 100644
--- a/packages/utils/src/bitauth-script.ts
+++ b/packages/utils/src/bitauth-script.ts
@@ -1,5 +1,6 @@
 import { Script, scriptToBitAuthAsm } from './script.js';
 import { sourceMapToLocationData } from './source-map.js';
+import { PositionHint } from './types.js';
 
 export type LineToOpcodesMap = Record<string, Script>;
 export type LineToAsmMap = Record<string, string>;
@@ -7,9 +8,9 @@ export type LineToAsmMap = Record<string, string>;
 export function buildLineToOpcodesMap(bytecode: Script, sourceMap: string): LineToOpcodesMap {
   const locationData = sourceMapToLocationData(sourceMap);
 
-  return locationData.reduce<LineToOpcodesMap>((lineToOpcodeMap, [location, positionHint], index) => {
+  return locationData.reduce<LineToOpcodesMap>((lineToOpcodeMap, { location, positionHint }, index) => {
     const opcode = bytecode[index];
-    const line = positionHint ? location?.end.line : location?.start.line;
+    const line = positionHint === PositionHint.END ? location?.end.line : location?.start.line;
 
     return {
       ...lineToOpcodeMap,
diff --git a/packages/utils/src/source-map.ts b/packages/utils/src/source-map.ts
index 6a640c1e..e1d7dda5 100644
--- a/packages/utils/src/source-map.ts
+++ b/packages/utils/src/source-map.ts
@@ -1,15 +1,4 @@
-export interface LocationI {
-  start: {
-    line: number,
-    column: number
-  };
-  end: {
-    line: number,
-    column: number
-  };
-}
-
-export type LocationData = Array<[location: LocationI, positionHint?: number]>;
+import { FullLocationData, PositionHint, SingleLocationData } from './types.js';
 
 /*
  * The source mappings for the bytecode use the following notation (similar to Solidity):
@@ -36,27 +25,27 @@ export type LocationData = Array<[location: LocationI, positionHint?: number]>;
  * 14:20:14:29;;:12::30;:34::43;
  *
  */
-export function generateSourceMap(locationData: LocationData): string {
+export function generateSourceMap(locationData: FullLocationData): string {
   let prevStartLine = 0;
   let prevStartColumn = 0;
   let prevEndLine = 0;
   let prevEndColumn = 0;
-  let prevHint = 0;
+  let prevHint = PositionHint.START;
 
-  return locationData.map((row: any) => {
-    const prevStartLineString = prevStartLine === row[0].start.line ? '' : String(row[0].start.line);
-    prevStartLine = row[0].start.line;
+  return locationData.map(({ location, positionHint }: SingleLocationData) => {
+    const prevStartLineString = prevStartLine === location.start.line ? '' : String(location.start.line);
+    prevStartLine = location.start.line;
 
-    const prevStartColumnString = prevStartColumn === row[0].start.column ? '' : String(row[0].start.column);
-    prevStartColumn = row[0].start.column;
+    const prevStartColumnString = prevStartColumn === location.start.column ? '' : String(location.start.column);
+    prevStartColumn = location.start.column;
 
-    const prevEndLineString = prevEndLine === row[0].end.line ? '' : String(row[0].end.line);
-    prevEndLine = row[0].end.line;
+    const prevEndLineString = prevEndLine === location.end.line ? '' : String(location.end.line);
+    prevEndLine = location.end.line;
 
-    const prevEndColumnString = prevEndColumn === row[0].end.column ? '' : String(row[0].end.column);
-    prevEndColumn = row[0].end.column;
+    const prevEndColumnString = prevEndColumn === location.end.column ? '' : String(location.end.column);
+    prevEndColumn = location.end.column;
 
-    const hint = row[1] ?? 0;
+    const hint = positionHint ?? PositionHint.START;
     const prevHintString = prevHint === hint ? '' : String(hint);
     prevHint = hint;
 
@@ -90,27 +79,43 @@ export function generateSourceMap(locationData: LocationData): string {
   }).join(';');
 }
 
-export const sourceMapToLocationData = (sourceMap: string): LocationData => {
+export const sourceMapToLocationData = (sourceMap: string): FullLocationData => {
   let prevStartLine = 0;
   let prevStartColumn = 0;
   let prevEndLine = 0;
   let prevEndColumn = 0;
-  let prevHint: any;
+  let prevHint: PositionHint | undefined;
 
   return sourceMap.split(';').map((entry: string) => {
-    const val = entry.split(':');
-    const startLine = val[0] ? Number(val[0]) : prevStartLine; prevStartLine = startLine;
-    const startColumn = val[1] ? Number(val[1]) : prevStartColumn; prevStartColumn = startColumn;
-    const endLine = val[2] ? Number(val[2]) : prevEndLine; prevEndLine = endLine;
-    const endColumn = val[3] ? Number(val[3]) : prevEndColumn; prevEndColumn = endColumn;
-    const hint: number | undefined = val[4] ? Number(val[4]) : prevHint; prevHint = hint;
-
-    return [
-      {
+    const [startLineStr, startColumnStr, endLineStr, endColumnStr, positionHintStr] = entry.split(':');
+
+    const startLine = startLineStr ? Number(startLineStr) : prevStartLine;
+    prevStartLine = startLine;
+
+    const startColumn = startColumnStr ? Number(startColumnStr) : prevStartColumn;
+    prevStartColumn = startColumn;
+
+    const endLine = endLineStr ? Number(endLineStr) : prevEndLine;
+    prevEndLine = endLine;
+
+    const endColumn = endColumnStr ? Number(endColumnStr) : prevEndColumn;
+    prevEndColumn = endColumn;
+
+    const hint: PositionHint | undefined = parsePositionHint(positionHintStr) ?? prevHint;
+    prevHint = hint;
+
+    return {
+      location: {
         start: { line: startLine, column: startColumn },
         end: { line: endLine, column: endColumn },
       },
-      ...(hint ? [hint] : []),
-    ] as any;
+      ...(hint ? { positionHint: hint } : {}),
+    };
   });
 };
+
+const parsePositionHint = (hint: string): PositionHint | undefined => {
+  if (hint === '1') return PositionHint.END;
+  if (hint === '0') return PositionHint.START;
+  return undefined;
+};
diff --git a/packages/utils/src/types.ts b/packages/utils/src/types.ts
index d5a9e426..f5e598aa 100644
--- a/packages/utils/src/types.ts
+++ b/packages/utils/src/types.ts
@@ -185,3 +185,27 @@ export function parseType(str: string): Type {
 export function isPrimitive(type: Type): type is PrimitiveType {
   return !!PrimitiveType[type.toString().toUpperCase() as keyof typeof PrimitiveType];
 }
+
+export interface LocationI {
+  start: {
+    line: number,
+    column: number
+  };
+  end: {
+    line: number,
+    column: number
+  };
+}
+
+export type SingleLocationData = {
+  location: LocationI;
+  positionHint?: PositionHint;
+};
+
+export type FullLocationData = Array<SingleLocationData>;
+
+// Denotes whether an opcode belongs to the "start" or "end" of the statement it's in (defaults to "start")
+export enum PositionHint {
+  START = 0,
+  END = 1,
+}
diff --git a/packages/utils/test/fixtures/source-map.fixture.ts b/packages/utils/test/fixtures/source-map.fixture.ts
index 4be047fc..a4a05690 100644
--- a/packages/utils/test/fixtures/source-map.fixture.ts
+++ b/packages/utils/test/fixtures/source-map.fixture.ts
@@ -1,8 +1,8 @@
-import { LocationData } from '../../src/source-map.js';
+import { FullLocationData, PositionHint } from '../../src/types.js';
 
 export interface Fixture {
   name: string;
-  locationData: LocationData;
+  locationData: FullLocationData;
   sourceMap: string;
 }
 
@@ -10,143 +10,143 @@ export const fixtures: Fixture[] = [
   {
     name: 'Basic Test',
     locationData: [
-      [{ start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }],
-      [{ start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }],
-      [{ start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }],
-      [{ start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }],
-      [{ start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }],
-      [{ start: { line: 11, column: 26 }, end: { line: 11, column: 32 } }],
-      [{ start: { line: 13, column: 20 }, end: { line: 13, column: 24 } }],
-      [{ start: { line: 13, column: 20 }, end: { line: 13, column: 24 } }],
-      [{ start: { line: 13, column: 28 }, end: { line: 13, column: 34 } }],
-      [{ start: { line: 13, column: 20 }, end: { line: 13, column: 34 } }, 1],
-      [{ start: { line: 13, column: 20 }, end: { line: 13, column: 34 } }, 1],
-      [{ start: { line: 13, column: 12 }, end: { line: 13, column: 36 } }, 1],
-      [{ start: { line: 14, column: 29 }, end: { line: 14, column: 41 } }],
-      [{ start: { line: 14, column: 29 }, end: { line: 14, column: 41 } }],
-      [{ start: { line: 14, column: 43 }, end: { line: 14, column: 52 } }],
-      [{ start: { line: 14, column: 43 }, end: { line: 14, column: 52 } }],
-      [{ start: { line: 14, column: 20 }, end: { line: 14, column: 53 } }, 1],
-      [{ start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, 1],
-      [{ start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, 1],
-      [{ start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, 1],
-      [{ start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, 1],
-      [{ start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }],
-      [{ start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }],
-      [{ start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }],
-      [{ start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }],
-      [{ start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }],
-      [{ start: { line: 19, column: 29 }, end: { line: 19, column: 38 } }],
-      [{ start: { line: 19, column: 29 }, end: { line: 19, column: 38 } }],
-      [{ start: { line: 19, column: 40 }, end: { line: 19, column: 46 } }],
-      [{ start: { line: 19, column: 40 }, end: { line: 19, column: 46 } }],
-      [{ start: { line: 19, column: 20 }, end: { line: 19, column: 47 } }, 1],
-      [{ start: { line: 19, column: 12 }, end: { line: 19, column: 49 } }, 1],
-      [{ start: { line: 20, column: 31 }, end: { line: 20, column: 38 } }],
-      [{ start: { line: 20, column: 31 }, end: { line: 20, column: 38 } }],
-      [{ start: { line: 20, column: 12 }, end: { line: 20, column: 40 } }, 1],
-      [{ start: { line: 20, column: 12 }, end: { line: 20, column: 40 } }, 1],
-      [{ start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, 1],
-      [{ start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, 1],
-      [{ start: { line: 4, column: 4 }, end: { line: 22, column: 5 } }, 1],
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
+      { location: { start: { line: 11, column: 26 }, end: { line: 11, column: 32 } } },
+      { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 24 } } },
+      { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 24 } } },
+      { location: { start: { line: 13, column: 28 }, end: { line: 13, column: 34 } } },
+      { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 34 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 34 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 13, column: 12 }, end: { line: 13, column: 36 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 14, column: 29 }, end: { line: 14, column: 41 } } },
+      { location: { start: { line: 14, column: 29 }, end: { line: 14, column: 41 } } },
+      { location: { start: { line: 14, column: 43 }, end: { line: 14, column: 52 } } },
+      { location: { start: { line: 14, column: 43 }, end: { line: 14, column: 52 } } },
+      { location: { start: { line: 14, column: 20 }, end: { line: 14, column: 53 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
+      { location: { start: { line: 19, column: 29 }, end: { line: 19, column: 38 } } },
+      { location: { start: { line: 19, column: 29 }, end: { line: 19, column: 38 } } },
+      { location: { start: { line: 19, column: 40 }, end: { line: 19, column: 46 } } },
+      { location: { start: { line: 19, column: 40 }, end: { line: 19, column: 46 } } },
+      { location: { start: { line: 19, column: 20 }, end: { line: 19, column: 47 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 19, column: 12 }, end: { line: 19, column: 49 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 20, column: 31 }, end: { line: 20, column: 38 } } },
+      { location: { start: { line: 20, column: 31 }, end: { line: 20, column: 38 } } },
+      { location: { start: { line: 20, column: 12 }, end: { line: 20, column: 40 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 20, column: 12 }, end: { line: 20, column: 40 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 4, column: 4 }, end: { line: 22, column: 5 } }, positionHint: PositionHint.END },
     ],
     sourceMap: '10:8:15:9;;;;;11:26:11:32;13:20:13:24;;:28::34;:20:::1;;:12::36;14:29:14:41:0;;:43::52;;:20::53:1;10:8:15:9;;;;18::21::0;;;;;19:29:19:38;;:40::46;;:20::47:1;:12::49;20:31:20:38:0;;:12::40:1;;18:8:21:9;;4:4:22:5',
   },
   {
     name: 'Mecenas',
     locationData: [
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }],
-      [{ start: { line: 13, column: 27 }, end: { line: 13, column: 28 } }],
-      [{ start: { line: 13, column: 16 }, end: { line: 13, column: 45 } }],
-      [{ start: { line: 13, column: 49 }, end: { line: 13, column: 84 } }],
-      [{ start: { line: 13, column: 74 }, end: { line: 13, column: 83 } }],
-      [{ start: { line: 13, column: 74 }, end: { line: 13, column: 83 } }],
-      [{ start: { line: 13, column: 49 }, end: { line: 13, column: 84 } }],
-      [{ start: { line: 13, column: 49 }, end: { line: 13, column: 84 } }],
-      [{ start: { line: 13, column: 49 }, end: { line: 13, column: 84 } }],
-      [{ start: { line: 13, column: 16 }, end: { line: 13, column: 84 } }, 1],
-      [{ start: { line: 13, column: 8 }, end: { line: 13, column: 86 } }, 1],
-      [{ start: { line: 15, column: 23 }, end: { line: 15, column: 27 } }],
-      [{ start: { line: 16, column: 37 }, end: { line: 16, column: 58 } }],
-      [{ start: { line: 16, column: 27 }, end: { line: 16, column: 65 } }],
-      [{ start: { line: 17, column: 26 }, end: { line: 17, column: 38 } }],
-      [{ start: { line: 17, column: 26 }, end: { line: 17, column: 38 } }],
-      [{ start: { line: 17, column: 41 }, end: { line: 17, column: 47 } }],
-      [{ start: { line: 17, column: 41 }, end: { line: 17, column: 47 } }],
-      [{ start: { line: 17, column: 26 }, end: { line: 17, column: 47 } }, 1],
-      [{ start: { line: 17, column: 50 }, end: { line: 17, column: 58 } }],
-      [{ start: { line: 17, column: 50 }, end: { line: 17, column: 58 } }],
-      [{ start: { line: 17, column: 26 }, end: { line: 17, column: 58 } }, 1],
-      [{ start: { line: 21, column: 12 }, end: { line: 21, column: 23 } }],
-      [{ start: { line: 21, column: 12 }, end: { line: 21, column: 23 } }],
-      [{ start: { line: 21, column: 27 }, end: { line: 21, column: 33 } }],
-      [{ start: { line: 21, column: 27 }, end: { line: 21, column: 33 } }],
-      [{ start: { line: 21, column: 36 }, end: { line: 21, column: 44 } }],
-      [{ start: { line: 21, column: 36 }, end: { line: 21, column: 44 } }],
-      [{ start: { line: 21, column: 27 }, end: { line: 21, column: 44 } }, 1],
-      [{ start: { line: 21, column: 12 }, end: { line: 21, column: 44 } }, 1],
-      [{ start: { line: 21, column: 46 }, end: { line: 23, column: 9 } }],
-      [{ start: { line: 22, column: 31 }, end: { line: 22, column: 32 } }],
-      [{ start: { line: 22, column: 20 }, end: { line: 22, column: 39 } }],
-      [{ start: { line: 22, column: 43 }, end: { line: 22, column: 55 } }],
-      [{ start: { line: 22, column: 43 }, end: { line: 22, column: 55 } }],
-      [{ start: { line: 22, column: 58 }, end: { line: 22, column: 66 } }],
-      [{ start: { line: 22, column: 58 }, end: { line: 22, column: 66 } }],
-      [{ start: { line: 22, column: 43 }, end: { line: 22, column: 66 } }, 1],
-      [{ start: { line: 22, column: 20 }, end: { line: 22, column: 66 } }, 1],
-      [{ start: { line: 22, column: 12 }, end: { line: 22, column: 68 } }, 1],
-      [{ start: { line: 23, column: 15 }, end: { line: 27, column: 9 } }, 1],
-      [{ start: { line: 24, column: 31 }, end: { line: 24, column: 32 } }],
-      [{ start: { line: 24, column: 20 }, end: { line: 24, column: 39 } }],
-      [{ start: { line: 24, column: 43 }, end: { line: 24, column: 49 } }],
-      [{ start: { line: 24, column: 43 }, end: { line: 24, column: 49 } }],
-      [{ start: { line: 24, column: 20 }, end: { line: 24, column: 49 } }, 1],
-      [{ start: { line: 24, column: 12 }, end: { line: 24, column: 51 } }, 1],
-      [{ start: { line: 25, column: 31 }, end: { line: 25, column: 32 } }],
-      [{ start: { line: 25, column: 20 }, end: { line: 25, column: 49 } }],
-      [{ start: { line: 25, column: 63 }, end: { line: 25, column: 84 } }],
-      [{ start: { line: 25, column: 53 }, end: { line: 25, column: 101 } }],
-      [{ start: { line: 25, column: 20 }, end: { line: 25, column: 101 } }, 1],
-      [{ start: { line: 25, column: 12 }, end: { line: 25, column: 103 } }, 1],
-      [{ start: { line: 26, column: 31 }, end: { line: 26, column: 32 } }],
-      [{ start: { line: 26, column: 20 }, end: { line: 26, column: 39 } }],
-      [{ start: { line: 26, column: 43 }, end: { line: 26, column: 54 } }],
-      [{ start: { line: 26, column: 43 }, end: { line: 26, column: 54 } }],
-      [{ start: { line: 26, column: 20 }, end: { line: 26, column: 54 } }, 1],
-      [{ start: { line: 26, column: 12 }, end: { line: 26, column: 56 } }, 1],
-      [{ start: { line: 23, column: 15 }, end: { line: 27, column: 9 } }, 1],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, 1],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, 1],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, 1],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, 1],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, 1],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, 1],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, 1],
-      [{ start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, 1],
-      [{ start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }],
-      [{ start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }],
-      [{ start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }],
-      [{ start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }],
-      [{ start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }],
-      [{ start: { line: 31, column: 24 }, end: { line: 31, column: 26 } }],
-      [{ start: { line: 31, column: 24 }, end: { line: 31, column: 26 } }],
-      [{ start: { line: 31, column: 16 }, end: { line: 31, column: 27 } }, 1],
-      [{ start: { line: 31, column: 31 }, end: { line: 31, column: 37 } }],
-      [{ start: { line: 31, column: 31 }, end: { line: 31, column: 37 } }],
-      [{ start: { line: 31, column: 16 }, end: { line: 31, column: 37 } }, 1],
-      [{ start: { line: 31, column: 8 }, end: { line: 31, column: 39 } }, 1],
-      [{ start: { line: 32, column: 25 }, end: { line: 32, column: 26 } }],
-      [{ start: { line: 32, column: 25 }, end: { line: 32, column: 26 } }],
-      [{ start: { line: 32, column: 28 }, end: { line: 32, column: 30 } }],
-      [{ start: { line: 32, column: 28 }, end: { line: 32, column: 30 } }],
-      [{ start: { line: 32, column: 16 }, end: { line: 32, column: 31 } }, 1],
-      [{ start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, 1],
-      [{ start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, 1],
-      [{ start: { line: 8, column: 0 }, end: { line: 34, column: 1 } }, 1],
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
+      { location: { start: { line: 13, column: 27 }, end: { line: 13, column: 28 } } },
+      { location: { start: { line: 13, column: 16 }, end: { line: 13, column: 45 } } },
+      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } } },
+      { location: { start: { line: 13, column: 74 }, end: { line: 13, column: 83 } } },
+      { location: { start: { line: 13, column: 74 }, end: { line: 13, column: 83 } } },
+      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } } },
+      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } } },
+      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } } },
+      { location: { start: { line: 13, column: 16 }, end: { line: 13, column: 84 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 13, column: 8 }, end: { line: 13, column: 86 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 15, column: 23 }, end: { line: 15, column: 27 } } },
+      { location: { start: { line: 16, column: 37 }, end: { line: 16, column: 58 } } },
+      { location: { start: { line: 16, column: 27 }, end: { line: 16, column: 65 } } },
+      { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 38 } } },
+      { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 38 } } },
+      { location: { start: { line: 17, column: 41 }, end: { line: 17, column: 47 } } },
+      { location: { start: { line: 17, column: 41 }, end: { line: 17, column: 47 } } },
+      { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 47 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 17, column: 50 }, end: { line: 17, column: 58 } } },
+      { location: { start: { line: 17, column: 50 }, end: { line: 17, column: 58 } } },
+      { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 58 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 21, column: 12 }, end: { line: 21, column: 23 } } },
+      { location: { start: { line: 21, column: 12 }, end: { line: 21, column: 23 } } },
+      { location: { start: { line: 21, column: 27 }, end: { line: 21, column: 33 } } },
+      { location: { start: { line: 21, column: 27 }, end: { line: 21, column: 33 } } },
+      { location: { start: { line: 21, column: 36 }, end: { line: 21, column: 44 } } },
+      { location: { start: { line: 21, column: 36 }, end: { line: 21, column: 44 } } },
+      { location: { start: { line: 21, column: 27 }, end: { line: 21, column: 44 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 21, column: 12 }, end: { line: 21, column: 44 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 21, column: 46 }, end: { line: 23, column: 9 } } },
+      { location: { start: { line: 22, column: 31 }, end: { line: 22, column: 32 } } },
+      { location: { start: { line: 22, column: 20 }, end: { line: 22, column: 39 } } },
+      { location: { start: { line: 22, column: 43 }, end: { line: 22, column: 55 } } },
+      { location: { start: { line: 22, column: 43 }, end: { line: 22, column: 55 } } },
+      { location: { start: { line: 22, column: 58 }, end: { line: 22, column: 66 } } },
+      { location: { start: { line: 22, column: 58 }, end: { line: 22, column: 66 } } },
+      { location: { start: { line: 22, column: 43 }, end: { line: 22, column: 66 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 22, column: 20 }, end: { line: 22, column: 66 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 22, column: 12 }, end: { line: 22, column: 68 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 23, column: 15 }, end: { line: 27, column: 9 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 24, column: 31 }, end: { line: 24, column: 32 } } },
+      { location: { start: { line: 24, column: 20 }, end: { line: 24, column: 39 } } },
+      { location: { start: { line: 24, column: 43 }, end: { line: 24, column: 49 } } },
+      { location: { start: { line: 24, column: 43 }, end: { line: 24, column: 49 } } },
+      { location: { start: { line: 24, column: 20 }, end: { line: 24, column: 49 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 24, column: 12 }, end: { line: 24, column: 51 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 25, column: 31 }, end: { line: 25, column: 32 } } },
+      { location: { start: { line: 25, column: 20 }, end: { line: 25, column: 49 } } },
+      { location: { start: { line: 25, column: 63 }, end: { line: 25, column: 84 } } },
+      { location: { start: { line: 25, column: 53 }, end: { line: 25, column: 101 } } },
+      { location: { start: { line: 25, column: 20 }, end: { line: 25, column: 101 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 25, column: 12 }, end: { line: 25, column: 103 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 26, column: 31 }, end: { line: 26, column: 32 } } },
+      { location: { start: { line: 26, column: 20 }, end: { line: 26, column: 39 } } },
+      { location: { start: { line: 26, column: 43 }, end: { line: 26, column: 54 } } },
+      { location: { start: { line: 26, column: 43 }, end: { line: 26, column: 54 } } },
+      { location: { start: { line: 26, column: 20 }, end: { line: 26, column: 54 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 26, column: 12 }, end: { line: 26, column: 56 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 23, column: 15 }, end: { line: 27, column: 9 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
+      { location: { start: { line: 31, column: 24 }, end: { line: 31, column: 26 } } },
+      { location: { start: { line: 31, column: 24 }, end: { line: 31, column: 26 } } },
+      { location: { start: { line: 31, column: 16 }, end: { line: 31, column: 27 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 31, column: 31 }, end: { line: 31, column: 37 } } },
+      { location: { start: { line: 31, column: 31 }, end: { line: 31, column: 37 } } },
+      { location: { start: { line: 31, column: 16 }, end: { line: 31, column: 37 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 31, column: 8 }, end: { line: 31, column: 39 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 32, column: 25 }, end: { line: 32, column: 26 } } },
+      { location: { start: { line: 32, column: 25 }, end: { line: 32, column: 26 } } },
+      { location: { start: { line: 32, column: 28 }, end: { line: 32, column: 30 } } },
+      { location: { start: { line: 32, column: 28 }, end: { line: 32, column: 30 } } },
+      { location: { start: { line: 32, column: 16 }, end: { line: 32, column: 31 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 8, column: 0 }, end: { line: 34, column: 1 } }, positionHint: PositionHint.END },
     ],
     sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9;24:31:24:32:0;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
   },

From 79b35b755c191245afdaf5195c4a6c2921483c85 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 23 Jan 2024 10:35:42 +0100
Subject: [PATCH 020/267] Small changes

---
 .../src/generation/GenerateTargetTraversal.ts | 72 ++++++++++---------
 .../ParseError/expression_in_console_log.cash |  5 ++
 2 files changed, 43 insertions(+), 34 deletions(-)
 create mode 100644 packages/cashc/test/compiler/ParseError/expression_in_console_log.cash

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 6e1f5fbc..aca43ba5 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -108,6 +108,11 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     return index;
   }
 
+  private getCurrentInstructionPointer(): number {
+    // instruction pointer is the count of emitted opcodes + number of constructor data pushes
+    return this.output.length + this.constructorParameterCount;
+  }
+
   visitSourceFile(node: SourceFileNode): Node {
     node.contract = this.visit(node.contract) as ContractNode;
 
@@ -179,7 +184,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     return node;
   }
 
-  removeFinalVerify(node: Node): void {
+  removeFinalVerify(functionBodyNode: Node): void {
     // After EnsureFinalRequireTraversal, we know that the final opcodes are either
     // "OP_VERIFY", "OP_CHECK{LOCKTIME|SEQUENCE}VERIFY OP_DROP" or "OP_ENDIF"
 
@@ -200,16 +205,16 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
       //  - scoped stack is cleared inside branch ended by OP_ENDIF
       //  - OP_CHECK{LOCKTIME|SEQUENCE}VERIFY OP_DROP does not leave a verification value
       // so we add OP_1 to the script (indicating success)
-      this.emit(Op.OP_1, { location: node.location, positionHint: PositionHint.END });
+      this.emit(Op.OP_1, { location: functionBodyNode.location, positionHint: PositionHint.END });
       this.pushToStack('(value)');
     }
   }
 
-  cleanStack(node: Node): void {
+  cleanStack(functionBodyNode: Node): void {
     // Keep final verification value, OP_NIP the other stack values
     const stackSize = this.stack.length;
     for (let i = 0; i < stackSize - 1; i += 1) {
-      this.emit(Op.OP_NIP, { location: node.location, positionHint: PositionHint.END });
+      this.emit(Op.OP_NIP, { location: functionBodyNode.location, positionHint: PositionHint.END });
       this.nipFromStack();
     }
   }
@@ -273,7 +278,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // add debug require message
     if (node.message) {
       this.requireMessages.push({
-        ip: this.output.length + this.constructorParameterCount - 1,
+        ip: this.getCurrentInstructionPointer() - 1, // TODO: Why is there a minus 1 here?
         line: node.location.start.line,
         message: node.message,
       });
@@ -291,7 +296,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // add debug require message
     if (node.message) {
       this.requireMessages.push({
-        ip: this.output.length + this.constructorParameterCount - 1,
+        ip: this.getCurrentInstructionPointer() - 1, // TODO: Why is there a minus 1 here?
         line: node.location.start.line,
         message: node.message,
       });
@@ -301,6 +306,33 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     return node;
   }
 
+  visitConsoleStatement(node: ConsoleStatementNode): Node {
+    const ip = this.getCurrentInstructionPointer();
+    const { line } = node.location.start;
+
+    // TODO: refactor to use a map instead of array (also in the artifact and other places where console logs and
+    // require statements are used)
+    // check if log entry exists for the instruction pointer, create if not
+    // TODO: Do we really want to merge different console logs at the same instruction pointer?
+    let index = this.consoleLogs.findIndex((entry: LogEntry) => entry.ip === ip);
+    if (index === -1) {
+      index = this.consoleLogs.push({ ip, line, data: [] }) - 1;
+    }
+
+    node.parameters.forEach((parameter: ConsoleParameterNode) => {
+      if (parameter instanceof IdentifierNode) {
+        const symbol = parameter.definition!;
+        const stackIndex = this.getStackIndex(parameter.name);
+        const type = typeof symbol.type === 'string' ? symbol.type : symbol.toString();
+        this.consoleLogs[index].data.push({ stackIndex, type });
+      } else {
+        this.consoleLogs[index].data.push(parameter.toString());
+      }
+    });
+
+    return node;
+  }
+
   visitBranch(node: BranchNode): Node {
     node.condition = this.visit(node.condition);
     this.popFromStack();
@@ -563,32 +595,4 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     this.pushToStack('(value)');
     return node;
   }
-
-  visitConsoleStatement(node: ConsoleStatementNode): Node {
-    // instruction pointer is the count of emitted opcodes + number of constructor data pushes
-    const ip = this.output.length + this.constructorParameterCount;
-    const { line } = node.location.start;
-
-    // TODO: refactor to use a map instead of array (also in the artifact and other places where console logs and
-    // require statements are used)
-    // check if log entry exists for the instruction pointer, create if not
-    // TODO: Do we really want to merge different console logs at the same instruction pointer?
-    let index = this.consoleLogs.findIndex((entry: LogEntry) => entry.ip === ip);
-    if (index === -1) {
-      index = this.consoleLogs.push({ ip, line, data: [] }) - 1;
-    }
-
-    node.parameters.forEach((parameter: ConsoleParameterNode) => {
-      if (parameter instanceof IdentifierNode) {
-        const symbol = parameter.definition!;
-        const stackIndex = this.getStackIndex(parameter.name);
-        const type = typeof symbol.type === 'string' ? symbol.type : symbol.toString();
-        this.consoleLogs[index].data.push({ stackIndex, type });
-      } else {
-        this.consoleLogs[index].data.push(parameter.toString());
-      }
-    });
-
-    return node;
-  }
 }
diff --git a/packages/cashc/test/compiler/ParseError/expression_in_console_log.cash b/packages/cashc/test/compiler/ParseError/expression_in_console_log.cash
new file mode 100644
index 00000000..162afd14
--- /dev/null
+++ b/packages/cashc/test/compiler/ParseError/expression_in_console_log.cash
@@ -0,0 +1,5 @@
+contract DebugMessages() {
+  function spend(int value) {
+    console.log(value + 2);
+  }
+}

From 5fdb8f427225a32c0c7ecfcdfbd23159cb951a3e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 1 Feb 2024 11:15:53 +0100
Subject: [PATCH 021/267] Update cashscript sdk fixtures to include debug data

---
 packages/cashscript/test/fixture/announcement.json | 14 ++++++++++----
 packages/cashscript/test/fixture/bigint.json       | 10 ++++++++--
 .../cashscript/test/fixture/bounded_bytes.json     | 10 ++++++++--
 packages/cashscript/test/fixture/hodl_vault.json   | 10 ++++++++--
 packages/cashscript/test/fixture/mecenas.json      | 14 ++++++++++----
 packages/cashscript/test/fixture/p2palindrome.json | 10 ++++++++--
 packages/cashscript/test/fixture/p2pkh.json        | 10 ++++++++--
 .../cashscript/test/fixture/simple_covenant.json   | 10 ++++++++--
 .../test/fixture/transfer_with_timeout.json        | 10 ++++++++--
 9 files changed, 76 insertions(+), 22 deletions(-)

diff --git a/packages/cashscript/test/fixture/announcement.json b/packages/cashscript/test/fixture/announcement.json
index 22d09e39..5b69e1e1 100644
--- a/packages/cashscript/test/fixture/announcement.json
+++ b/packages/cashscript/test/fixture/announcement.json
@@ -8,10 +8,16 @@
     }
   ],
   "bytecode": "6a 6d02 OP_SIZE OP_SWAP OP_CAT OP_CAT 4120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e OP_SIZE OP_DUP 4b OP_GREATERTHAN OP_IF 4c OP_SWAP OP_CAT OP_ENDIF OP_SWAP OP_CAT OP_CAT OP_0 OP_OUTPUTVALUE OP_0 OP_NUMEQUALVERIFY OP_0 OP_OUTPUTBYTECODE OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_OVER OP_SUB OP_DUP OP_ROT OP_GREATERTHANOREQUAL OP_IF OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_DROP OP_1",
-  "source": "pragma cashscript ^0.9.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an \"announcement\" on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes('A contract may not injure a human being or, through inaction, allow a human being to come to harm.')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there's enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n",
+  "source": "pragma cashscript >=0.8.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an \"announcement\" on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes('A contract may not injure a human being or, through inaction, allow a human being to come to harm.')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there's enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n",
+  "debug": {
+    "bytecode": "016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009c6900cd517a876902e803c0c65179940079527aa26351cdc0c7876951cc51799c69685177",
+    "sourceMap": "10:29:13:10;11:12:11:18;;;;;12:18:12:118;:12::119;;;;;;;;;;;;16:27:16:28;:16::35;:39::40;:16:::1;:8::42;17:27:17:28:0;:16::45;:49::61;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65;:68::76;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49;:63::84;:53::101;:20:::1;:12::103;25:31:25:32:0;:20::39;:43::55;;:20:::1;:12::57;23:38:26:9;8:4:27:5;",
+    "logs": [],
+    "requireMessages": []
+  },
   "compiler": {
     "name": "cashc",
-    "version": "0.8.0-next.0"
+    "version": "0.10.0-next.0"
   },
-  "updatedAt": "2023-02-10T15:22:49.703Z"
-}
+  "updatedAt": "2024-02-01T10:15:35.499Z"
+}
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index 95219ed0..c0a5b59f 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -18,9 +18,15 @@
   ],
   "bytecode": "0000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL",
   "source": "contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt32PlusOne = 2147483648;\n        require(x >= maxInt32PlusOne);\n        require(x * y >= maxInt32PlusOne);\n    }\n}\n",
+  "debug": {
+    "bytecode": "05000000800051795179a269517a527a95517aa2",
+    "sourceMap": "3:30:3:40;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1",
+    "logs": [],
+    "requireMessages": []
+  },
   "compiler": {
     "name": "cashc",
-    "version": "0.8.0-next.0"
+    "version": "0.10.0-next.0"
   },
-  "updatedAt": "2023-02-10T15:22:49.393Z"
+  "updatedAt": "2024-02-01T10:15:35.191Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index 009dd698..39aac5b5 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -18,9 +18,15 @@
   ],
   "bytecode": "OP_SWAP OP_4 OP_NUM2BIN OP_EQUAL",
   "source": "contract BoundedBytes() {\n    function spend(bytes4 b, int i) {\n        require(b == bytes4(i));\n    }\n}\n",
+  "debug": {
+    "bytecode": "007a517a548087",
+    "sourceMap": "3:16:3:17;;:28::29;;:21::30:1;;:16",
+    "logs": [],
+    "requireMessages": []
+  },
   "compiler": {
     "name": "cashc",
-    "version": "0.8.0-next.0"
+    "version": "0.10.0-next.0"
   },
-  "updatedAt": "2023-02-10T15:22:50.561Z"
+  "updatedAt": "2024-02-01T10:15:36.327Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index ba29302d..76302e82 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -39,9 +39,15 @@
   ],
   "bytecode": "OP_6 OP_PICK OP_4 OP_SPLIT OP_SWAP OP_BIN2NUM OP_SWAP OP_BIN2NUM OP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY OP_CHECKSIG",
   "source": "// This contract forces HODLing until a certain price target has been reached\n// A minimum block is provided to ensure that oracle price entries from before this block are disregarded\n// i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used.\n// Instead, a message with a block number and price from after the minBlock needs to be passed.\n// This contract serves as a simple example for checkDataSig-based contracts.\ncontract HodlVault(\n    pubkey ownerPk,\n    pubkey oraclePk,\n    int minBlock,\n    int priceTarget\n) {\n    function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {\n        // message: { blockHeight, price }\n        bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);\n        int blockHeight = int(blockHeightBin);\n        int price = int(priceBin);\n\n        // Check that blockHeight is after minBlock and not in the future\n        require(blockHeight >= minBlock);\n        require(tx.time >= blockHeight);\n\n        // Check that current price is at least priceTarget\n        require(price >= priceTarget);\n\n        // Handle necessary signature checks\n        require(checkDataSig(oracleSig, oracleMessage, oraclePk));\n        require(checkSig(ownerSig, ownerPk));\n    }\n}\n",
+  "debug": {
+    "bytecode": "5679547f517a81517a815179557aa269517ab175007a537aa269537a547a537aba69517a517aac",
+    "sourceMap": "14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;;:26::45:1;16:24:16:32:0;;:20::33:1;19:16:19:27:0;;:31::39;;:16:::1;:8::41;20:27:20:38:0;;:8::40:1;;23:16:23:21:0;;:25::36;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:16::64:1;:8::66;27:25:27:33:0;;:35::42;;:16::43:1",
+    "logs": [],
+    "requireMessages": []
+  },
   "compiler": {
     "name": "cashc",
-    "version": "0.8.0-next.0"
+    "version": "0.10.0-next.0"
   },
-  "updatedAt": "2023-02-10T15:22:49.985Z"
+  "updatedAt": "2024-02-01T10:15:35.784Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index 0edb39b6..d619a3e9 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -34,10 +34,16 @@
     }
   ],
   "bytecode": "OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF",
-  "source": "pragma cashscript ^0.9.0;\n\n/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(tx.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
+  "source": "pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(tx.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
+  "debug": {
+    "bytecode": "5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768",
+    "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9;24:31:24:32:0;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1",
+    "logs": [],
+    "requireMessages": []
+  },
   "compiler": {
     "name": "cashc",
-    "version": "0.8.0-next.0"
+    "version": "0.10.0-next.0"
   },
-  "updatedAt": "2023-02-10T15:22:51.736Z"
-}
+  "updatedAt": "2024-02-01T10:15:37.487Z"
+}
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index 88039c95..fffdbd33 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -14,9 +14,15 @@
   ],
   "bytecode": "OP_DUP OP_REVERSEBYTES OP_EQUAL",
   "source": "contract P2Palindrome() {\n    function spend(string palindrome) {\n        require(palindrome.reverse() == palindrome);\n    }\n}\n",
+  "debug": {
+    "bytecode": "0079bc517a87",
+    "sourceMap": "3:16:3:26;;:::36;:40::50;;:16:::1",
+    "logs": [],
+    "requireMessages": []
+  },
   "compiler": {
     "name": "cashc",
-    "version": "0.8.0-next.0"
+    "version": "0.10.0-next.0"
   },
-  "updatedAt": "2023-02-10T15:22:50.274Z"
+  "updatedAt": "2024-02-01T10:15:36.058Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index c32ab8bc..da74a75d 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -23,9 +23,15 @@
   ],
   "bytecode": "OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG",
   "source": "contract P2PKH(bytes20 pkh) {\n    // Require pk to match stored pkh and signature to match\n    function spend(pubkey pk, sig s) {\n        require(hash160(pk) == pkh);\n        require(checkSig(s, pk));\n    }\n}\n",
+  "debug": {
+    "bytecode": "5179a9517a8769517a517aac",
+    "sourceMap": "4:24:4:26;;:16::27:1;:31::34:0;;:16:::1;:8::36;5:25:5:26:0;;:28::30;;:16::31:1",
+    "logs": [],
+    "requireMessages": []
+  },
   "compiler": {
     "name": "cashc",
-    "version": "0.8.0-next.0"
+    "version": "0.10.0-next.0"
   },
-  "updatedAt": "2023-02-10T15:22:51.429Z"
+  "updatedAt": "2024-02-01T10:15:37.188Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/simple_covenant.json b/packages/cashscript/test/fixture/simple_covenant.json
index f903d3c3..f8ee9361 100644
--- a/packages/cashscript/test/fixture/simple_covenant.json
+++ b/packages/cashscript/test/fixture/simple_covenant.json
@@ -9,9 +9,15 @@
   ],
   "bytecode": "OP_TXVERSION OP_2 OP_GREATERTHANOREQUAL OP_VERIFY OP_TXINPUTCOUNT OP_1 OP_GREATERTHANOREQUAL OP_VERIFY OP_TXOUTPUTCOUNT OP_1 OP_GREATERTHANOREQUAL OP_VERIFY OP_ACTIVEBYTECODE OP_SIZE OP_NIP 0802 OP_LESSTHAN OP_VERIFY OP_0 OP_UTXOVALUE 2202 OP_GREATERTHANOREQUAL OP_VERIFY OP_0 OP_OUTPUTVALUE 2202 OP_GREATERTHANOREQUAL",
   "source": "contract Covenant() {\n    function spend() {\n        require(tx.version >= 2);\n        require(tx.inputs.length >= 1);\n        require(tx.outputs.length >= 1);\n        require(this.activeBytecode.length < 520);\n        require(tx.inputs[0].value >= 546);\n        require(tx.outputs[0].value >= 546);\n    }\n}\n",
+  "debug": {
+    "bytecode": "c252a269c351a269c451a269c182770208029f6900c6022202a26900cc022202a2",
+    "sourceMap": "3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:32:0;:36::37;:16:::1;:8::39;5:16:5:33:0;:37::38;:16:::1;:8::40;6:16:6:35:0;:::42;;:45::48;:16:::1;:8::50;7:26:7:27:0;:16::34;:38::41;:16:::1;:8::43;8:27:8:28:0;:16::35;:39::42;:16:::1",
+    "logs": [],
+    "requireMessages": []
+  },
   "compiler": {
     "name": "cashc",
-    "version": "0.8.0-next.0"
+    "version": "0.10.0-next.0"
   },
-  "updatedAt": "2023-02-10T15:22:50.857Z"
+  "updatedAt": "2024-02-01T10:15:36.616Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index 5ffb7dc9..88f7dbd3 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -36,9 +36,15 @@
   ],
   "bytecode": "OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_ROLL OP_ROT OP_CHECKSIG OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_2DROP OP_1 OP_ENDIF",
   "source": "contract TransferWithTimeout(\n    pubkey sender,\n    pubkey recipient,\n    int timeout\n) {\n    // Require recipient's signature to match\n    function transfer(sig recipientSig) {\n        require(checkSig(recipientSig, recipient));\n    }\n\n    // Require timeout time to be reached and sender's signature to match\n    function timeout(sig senderSig) {\n        require(checkSig(senderSig, sender));\n        require(tx.time >= timeout);\n    }\n}\n",
+  "debug": {
+    "bytecode": "5379009c63547a527aac77777767537a519c69537a517aac69517ab175517768",
+    "sourceMap": "7:4:9:5;;;;;8:25:8:37;;:39::48;;:16::49:1;7:4:9:5;;;;12::15::0;;;;;13:25:13:34;;:36::42;;:16::43:1;:8::45;14:27:14:34:0;;:8::36:1;;12:4:15:5;;1:0:16:1",
+    "logs": [],
+    "requireMessages": []
+  },
   "compiler": {
     "name": "cashc",
-    "version": "0.8.0-next.0"
+    "version": "0.10.0-next.0"
   },
-  "updatedAt": "2023-02-10T15:22:51.144Z"
+  "updatedAt": "2024-02-01T10:15:36.909Z"
 }
\ No newline at end of file

From ad4755b14db576df13f1a9fb50423db591a5c3dd Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 1 Feb 2024 11:57:41 +0100
Subject: [PATCH 022/267] Update sourcemap generation fixtures

---
 packages/utils/test/bitauth-script.test.ts    |   7 +
 .../test/fixtures/bitauth-script.fixture.ts   | 128 +++++++++---------
 2 files changed, 72 insertions(+), 63 deletions(-)

diff --git a/packages/utils/test/bitauth-script.test.ts b/packages/utils/test/bitauth-script.test.ts
index 4e74961d..b883a916 100644
--- a/packages/utils/test/bitauth-script.test.ts
+++ b/packages/utils/test/bitauth-script.test.ts
@@ -1,12 +1,19 @@
 import { asmToScript } from '../src/script.js';
 import { buildLineToOpcodesMap, buildLineToAsmMap, formatBitAuthScript } from '../src/bitauth-script.js';
 import { fixtures } from './fixtures/bitauth-script.fixture.js';
+import { compileString } from 'cashc';
 
 describe('Libauth Script formatting', () => {
   fixtures.forEach((fixture) => {
     describe(fixture.name, () => {
       const scriptBytecode = asmToScript(fixture.asmBytecode);
 
+      // Note: this also tests the compiler (but the compiler is tested much more thoroughly in its own test suite)
+      it('should generate a correct source map from freshly compiled source code', () => {
+        const artifact = compileString(fixture.sourceCode);
+        expect(artifact.debug?.sourceMap).toEqual(fixture.sourceMap);
+      });
+
       it('should build a line-to-opcodes map', () => {
         expect(buildLineToOpcodesMap(scriptBytecode, fixture.sourceMap)).toEqual(fixture.expectedLineToOpcodeMap);
       });
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index 8bf67016..c8117f04 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -34,7 +34,7 @@ contract TransferWithTimeout(bytes20 senderPkh, bytes20 recipientPkh, int timeou
   }
 }`,
     asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_5 OP_ROLL OP_5 OP_PICK OP_CHECKSIG OP_VERIFY OP_4 OP_ROLL OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY OP_0 OP_PICK deadbeef OP_EQUAL OP_VERIFY OP_2 OP_PICK OP_3 OP_PICK OP_NUMEQUAL OP_VERIFY OP_4 OP_PICK OP_5 OP_PICK OP_EQUAL OP_VERIFY OP_3 OP_PICK OP_4 OP_PICK OP_EQUAL OP_VERIFY OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIG OP_VERIFY OP_3 OP_ROLL OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP OP_1 OP_NIP OP_ENDIF',
-    sourceMap: '3:2:6:3;;;;;4:21:4:22;;:24::33;;:12::34;:4::36;5:20:5:29;;:12::30;:34::46;;:12;3:2:6:3:1;;;;8::16::0;;;;;9:12:9:21;;:25::35;:12;:4::37;10:12:10:19;;:23::30;;:12;:4::32;11:12:11:13;;:17::18;;:12;:4::20;12:12:12:21;;:25::34;;:12;:4::36;13:21:13:22;;:24::33;;:12::34;:4::36;14:20:14:29;;:12::30;:34::43;;:12;:4::45;15:23:15:30;;:4::32;;8:2:16:3:1;;',
+    sourceMap: '3:2:6:3;;;;;4:21:4:22;;:24::33;;:12::34:1;:4::36;5:20:5:29:0;;:12::30:1;:34::46:0;;:12:::1;3:2:6:3;;;;8::16::0;;;;;9:12:9:21;;:25::35;:12:::1;:4::37;10:12:10:19:0;;:23::30;;:12:::1;:4::32;11:12:11:13:0;;:17::18;;:12:::1;:4::20;12:12:12:21:0;;:25::34;;:12:::1;:4::36;13:21:13:22:0;;:24::33;;:12::34:1;:4::36;14:20:14:29:0;;:12::30:1;:34::43:0;;:12:::1;:4::45;15:23:15:30:0;;:4::32:1;;8:2:16:3;;2:0:17:1',
     expectedLineToOpcodeMap: {
       3: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
       4: [Op.OP_5, Op.OP_ROLL, Op.OP_5, Op.OP_PICK, Op.OP_CHECKSIG, Op.OP_VERIFY],
@@ -48,7 +48,8 @@ contract TransferWithTimeout(bytes20 senderPkh, bytes20 recipientPkh, int timeou
       13: [Op.OP_4, Op.OP_ROLL, Op.OP_4, Op.OP_PICK, Op.OP_CHECKSIG, Op.OP_VERIFY],
       14: [Op.OP_3, Op.OP_ROLL, Op.OP_HASH160, Op.OP_1, Op.OP_ROLL, Op.OP_EQUAL, Op.OP_VERIFY],
       15: [Op.OP_1, Op.OP_ROLL, Op.OP_CHECKLOCKTIMEVERIFY, Op.OP_DROP],
-      16: [Op.OP_1, Op.OP_NIP, Op.OP_ENDIF],
+      16: [Op.OP_1, Op.OP_NIP],
+      17: [Op.OP_ENDIF],
     },
     expectedLineToAsmMap: {
       3: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF',
@@ -63,7 +64,8 @@ contract TransferWithTimeout(bytes20 senderPkh, bytes20 recipientPkh, int timeou
       13: 'OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIG OP_VERIFY',
       14: 'OP_3 OP_ROLL OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY',
       15: 'OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP',
-      16: 'OP_1 OP_NIP OP_ENDIF',
+      16: 'OP_1 OP_NIP',
+      17: 'OP_ENDIF',
     },
     expectedBitAuthScript: `
                                                         /*                                                                                      */
@@ -81,8 +83,8 @@ OP_3 OP_PICK OP_4 OP_PICK OP_EQUAL OP_VERIFY            /*     require(signingPk
 OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIG OP_VERIFY         /*     require(checkSig(s, signingPk));                                                 */
 OP_3 OP_ROLL OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*     require(hash160(signingPk) == senderPkh);                                        */
 OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP             /*     require(tx.time >= timeout);                                                     */
-OP_1 OP_NIP OP_ENDIF                                    /*   }                                                                                  */
-                                                        /* }                                                                                    */
+OP_1 OP_NIP                                             /*   }                                                                                  */
+OP_ENDIF                                                /* }                                                                                    */
 `.replace(/^\n+/, '').replace(/\n+$/, ''),
   },
   {
@@ -124,44 +126,44 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
     }
 }`,
     asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_2 OP_ROLL OP_CAT 88ac OP_CAT OP_EQUAL OP_VERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY OP_ENDIF OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
-    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9;24:31:24:32:0;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
+    sourceMap: '10:4:29:5;;;;;14:27:14:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;16:23:16:27:0;17:37:17:58;:27::65;18:26:18:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;22:12:22:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:24:9:0;23:31:23:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;24:15:28:9;25:31:25:32:0;:20::39;:43::49;;:20:::1;:12::51;26:31:26:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;27:31:27:32:0;:20::39;:43::54;;:20:::1;:12::56;24:15:28:9;10:4:29:5;;;;;;;;31::34::0;;;;;32:24:32:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;33:25:33:26:0;;:28::30;;:16::31:1;31:4:34:5;;9:0:35:1',
     expectedLineToOpcodeMap: {
-      9: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
-      13: [new Uint8Array([]), Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_2, Op.OP_ROLL, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUAL, Op.OP_VERIFY],
-      15: [hexToBin('e803')],
-      16: [Op.OP_INPUTINDEX, Op.OP_UTXOVALUE],
-      17: [new Uint8Array([]), Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_2, Op.OP_PICK, Op.OP_SUB],
-      21: [new Uint8Array([]), Op.OP_PICK, Op.OP_5, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_ADD, Op.OP_LESSTHANOREQUAL, Op.OP_IF],
-      22: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_2, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      24: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_5, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      25: [Op.OP_1, Op.OP_OUTPUTBYTECODE, Op.OP_INPUTINDEX, Op.OP_UTXOBYTECODE, Op.OP_EQUAL, Op.OP_VERIFY],
-      26: [Op.OP_1, Op.OP_OUTPUTVALUE, Op.OP_1, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      27: [Op.OP_ELSE, Op.OP_ENDIF],
-      28: [Op.OP_1, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_ELSE],
-      30: [Op.OP_3, Op.OP_ROLL, Op.OP_1, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      31: [Op.OP_3, Op.OP_PICK, Op.OP_HASH160, Op.OP_2, Op.OP_ROLL, Op.OP_EQUAL, Op.OP_VERIFY],
-      32: [Op.OP_3, Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_CHECKSIG],
-      33: [Op.OP_NIP, Op.OP_NIP],
-      34: [Op.OP_ENDIF],
+      10: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
+      14: [new Uint8Array([]), Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_2, Op.OP_ROLL, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUAL, Op.OP_VERIFY],
+      16: [hexToBin('e803')],
+      17: [Op.OP_INPUTINDEX, Op.OP_UTXOVALUE],
+      18: [new Uint8Array([]), Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_2, Op.OP_PICK, Op.OP_SUB],
+      22: [new Uint8Array([]), Op.OP_PICK, Op.OP_5, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_ADD, Op.OP_LESSTHANOREQUAL, Op.OP_IF],
+      23: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_2, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      25: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_5, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      26: [Op.OP_1, Op.OP_OUTPUTBYTECODE, Op.OP_INPUTINDEX, Op.OP_UTXOBYTECODE, Op.OP_EQUAL, Op.OP_VERIFY],
+      27: [Op.OP_1, Op.OP_OUTPUTVALUE, Op.OP_1, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      28: [Op.OP_ELSE, Op.OP_ENDIF],
+      29: [Op.OP_1, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_ELSE],
+      31: [Op.OP_3, Op.OP_ROLL, Op.OP_1, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      32: [Op.OP_3, Op.OP_PICK, Op.OP_HASH160, Op.OP_2, Op.OP_ROLL, Op.OP_EQUAL, Op.OP_VERIFY],
+      33: [Op.OP_3, Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_CHECKSIG],
+      34: [Op.OP_NIP, Op.OP_NIP],
+      35: [Op.OP_ENDIF],
     },
     expectedLineToAsmMap: {
-      9: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF',
-      13: 'OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY',
-      15: '<0xe803>',
-      16: 'OP_INPUTINDEX OP_UTXOVALUE',
-      17: 'OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB',
-      21: 'OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF',
-      22: 'OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY',
-      24: 'OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY',
-      25: 'OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY',
-      26: 'OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY',
-      27: 'OP_ELSE OP_ENDIF',
-      28: 'OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE',
-      30: 'OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY',
-      31: 'OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY',
-      32: 'OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG',
-      33: 'OP_NIP OP_NIP',
-      34: 'OP_ENDIF',
+      10: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF',
+      14: 'OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY',
+      16: '<0xe803>',
+      17: 'OP_INPUTINDEX OP_UTXOVALUE',
+      18: 'OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB',
+      22: 'OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF',
+      23: 'OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY',
+      25: 'OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY',
+      26: 'OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY',
+      27: 'OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY',
+      28: 'OP_ELSE OP_ENDIF',
+      29: 'OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE',
+      31: 'OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY',
+      32: 'OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY',
+      33: 'OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG',
+      34: 'OP_NIP OP_NIP',
+      35: 'OP_ENDIF',
     },
     expectedBitAuthScript: `
                                                                                          /*                                                                                                                    */
@@ -172,33 +174,33 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
                                                                                          /*  * of covenants in CashScript.                                                                                     */
                                                                                          /*  * The time checking has been removed so it can be tested without time requirements.                               */
                                                                                          /*  */                                                                                                                */
-OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {                                 */
-                                                                                         /*     function receive() {                                                                                           */
+                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {                                 */
+OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */
                                                                                          /*         // require(tx.age >= period);                                                                              */
                                                                                          /*                                                                                                                    */
-OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         // Check that the first output sends to the recipient                                                      */
-                                                                                         /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */
-<0xe803>                                                                                 /*                                                                                                                    */
-OP_INPUTINDEX OP_UTXOVALUE                                                               /*         int minerFee = 1000;                                                                                       */
-OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */
-                                                                                         /*         int changeValue = currentValue - pledge - minerFee;                                                        */
+                                                                                         /*         // Check that the first output sends to the recipient                                                      */
+OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */
+                                                                                         /*                                                                                                                    */
+<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */
+OP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */
+OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */
                                                                                          /*                                                                                                                    */
                                                                                          /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */
-OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */
-OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*         if (changeValue <= pledge + minerFee) {                                                                    */
-                                                                                         /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */
-OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*         } else {                                                                                                   */
-OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[0].value == pledge);                                                                */
-OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */
-OP_ELSE OP_ENDIF                                                                         /*             require(tx.outputs[1].value == changeValue);                                                           */
-OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*         }                                                                                                          */
-                                                                                         /*     }                                                                                                              */
-OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*                                                                                                                    */
-OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */
-OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(hash160(pk) == funder);                                                                            */
-OP_NIP OP_NIP                                                                            /*         require(checkSig(s, pk));                                                                                  */
-OP_ENDIF                                                                                 /*     }                                                                                                              */
-                                                                                         /* }                                                                                                                  */
+                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */
+OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */
+OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */
+                                                                                         /*         } else {                                                                                                   */
+OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */
+OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */
+OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */
+OP_ELSE OP_ENDIF                                                                         /*         }                                                                                                          */
+OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */
+                                                                                         /*                                                                                                                    */
+OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */
+OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */
+OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */
+OP_NIP OP_NIP                                                                            /*     }                                                                                                              */
+OP_ENDIF                                                                                 /* }                                                                                                                  */
 `.replace(/^\n+/, '').replace(/\n+$/, ''),
   },
 ];

From 57b4e11521b334fa103edf5e180f99fedf373c7d Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 23 Feb 2024 07:39:21 -1000
Subject: [PATCH 023/267] Update LibauthTemplate console.log tests

---
 .../cashscript/src/test/JestExtensions.ts     |   2 +
 .../cashscript/test/LibauthTemplate.test.ts   | 160 +++++++++++++-----
 2 files changed, 117 insertions(+), 45 deletions(-)

diff --git a/packages/cashscript/src/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
index 7d4de86a..dfe50050 100644
--- a/packages/cashscript/src/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -45,6 +45,8 @@ Received: ${printReceived(received)}`;
       message = error as any;
     }
 
+    // TODO: If no console.log was called, then spyOnLoggerError.mock.calls[0] is undefined.
+    // We should handle that case properly.
     const received = spyOnLoggerError.mock.calls[0][0];
     spyOnLoggerError.mockClear();
 
diff --git a/packages/cashscript/test/LibauthTemplate.test.ts b/packages/cashscript/test/LibauthTemplate.test.ts
index 20d57139..581a33dc 100644
--- a/packages/cashscript/test/LibauthTemplate.test.ts
+++ b/packages/cashscript/test/LibauthTemplate.test.ts
@@ -5,71 +5,141 @@ import {
 } from './fixture/vars.js';
 import '../src/test/JestExtensions.js';
 import { randomUtxo } from '../src/utils.js';
+import { binToHex } from '@bitauth/libauth';
 
 describe('Libauth template generation tests', () => {
-  it('should log console statements', async () => {
-    const code = `
-    pragma cashscript ^0.10.0;
+  describe('console.log statements', () => {
+    const BASE_CONTRACT_CODE = `
+      contract Test(pubkey owner) {
+        function transfer(sig ownerSig, int num) {
+          require(checkSig(ownerSig, owner));
 
-    contract TransferWithTimeout(
-        pubkey sender,
-        pubkey recipient,
-        int timeout
-    ) {
-        // Require recipient's signature to match
-        function transfer(sig recipientSig) {
-            bytes2 beef = 0xbeef;
-            console.log(recipientSig, timeout, recipient, sender, beef, 1, "test", true);
-            require(beef != 0xfeed);
-            require(checkSig(recipientSig, recipient));
-        }
+          bytes2 beef = 0xbeef;
+          require(beef != 0xfeed);
 
-        // Require timeout time to be reached and sender's signature to match
-        function timeout(sig senderSig) {
-            require(checkSig(senderSig, sender));
-            require(tx.time >= timeout);
+          console.log(ownerSig, owner, num, beef, 1, "test", true);
+
+          require(num == 1000);
         }
-    }
+      }
     `;
-    const artifact = compileString(code);
 
+    const artifact = compileString(BASE_CONTRACT_CODE);
     const provider = new MockNetworkProvider();
 
-    {
-      const contract = new Contract(artifact, [alicePub, bobPub, 100000n], { provider });
+    it('should log correct values', async () => {
+      const contract = new Contract(artifact, [alicePub], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.transfer(new SignatureTemplate(bobPriv)).to(contract.address, 10000n);
+      const transaction = contract.functions
+        .transfer(new SignatureTemplate(alicePriv), 1000n)
+        .to(contract.address, 10000n);
 
-      await (expect(transaction)).toLog(/0x[0-9a-f]{130} 100000 0x[0-9a-f]{66} 0x[0-9a-f]{66} 0xbeef 1 test true/);
-      await (expect(transaction)).toLog('beef');
-    }
+      // console.log(ownerSig, owner, num, beef, 1, "test", true);
+      const expectedLog = new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
+      await expect(transaction).toLog(expectedLog);
+    });
 
-    const ip = artifact.debug!.logs[0].ip;
-    {
-      artifact.debug!.logs[0].ip = 100;
-      const contract = new Contract(artifact, [alicePub, bobPub, 100000n], { provider });
+    it('should log when logging happens before a failing require statement', async () => {
+      const contract = new Contract(artifact, [alicePub], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.transfer(new SignatureTemplate(bobPriv)).to(contract.address, 10000n);
+      const incorrectNum = 100n;
+      const transaction = contract.functions
+        .transfer(new SignatureTemplate(alicePriv), incorrectNum)
+        .to(contract.address, 10000n);
 
-      await (expect(transaction.debug())).rejects.toThrow(
-        /Instruction pointer 100 points to a non-existing state of the program/,
-      );
-    }
+      // console.log(ownerSig, owner, num, beef, 1, "test", true);
+      const expectedLog = new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100 0xbeef 1 test true$`);
+      await expect(transaction).toLog(expectedLog);
+    });
 
-    artifact.debug!.logs[0].ip = ip;
-    {
-      (artifact.debug!.logs[0].data[0] as any).stackIndex = 100;
-      const contract = new Contract(artifact, [alicePub, bobPub, 100000n], { provider });
+    it('should not log when logging happens after a failing require statement', async () => {
+      const contract = new Contract(artifact, [alicePub], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.transfer(new SignatureTemplate(bobPriv)).to(contract.address, 10000n);
+      const incorrectPriv = bobPriv;
+      const transaction = contract.functions
+        .transfer(new SignatureTemplate(incorrectPriv), 1000n)
+        .to(contract.address, 10000n);
+
+      // TODO: This is a super ugly test, we should fix this by improving the JestExtensions
+      try {
+        const expectedLog = new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
+        await expect(transaction).toLog(expectedLog);
+        throw new Error('Expected to fail');
+      } catch (e) {
+        if ((e as any)?.message === 'Expected to fail') throw e;
+      }
+    });
+
+    it('should log multiple consecutive console.log statements on a single line', async () => {
+      const contractCode = `
+        contract Test(pubkey owner) {
+          function transfer(sig ownerSig, int num) {
+            require(checkSig(ownerSig, owner));
 
-      await (expect(transaction.debug())).rejects.toThrow(
-        /Stack item at index 100 not found at instruction pointer 9/,
-      );
-    }
+            bytes2 beef = 0xbeef;
+            require(beef != 0xfeed);
+
+            console.log(ownerSig, owner, num);
+            console.log(beef, 1, "test", true);
+
+            require(num == 1000);
+          }
+        }
+      `;
+
+      const artifact2 = compileString(contractCode);
+
+      const contract = new Contract(artifact2, [alicePub], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const incorrectNum = 100n;
+      const transaction = contract.functions
+        .transfer(new SignatureTemplate(alicePriv), incorrectNum)
+        .to(contract.address, 10000n);
+
+      // console.log(ownerSig, owner, num, beef, 1, "test", true);
+      const expectedLog = new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100 0xbeef 1 test true$`);
+      await expect(transaction).toLog(expectedLog);
+    });
+
+    it('should log multiple console.log statements with other statements in between', async () => {
+      const contractCode = `
+        contract Test(pubkey owner) {
+          function transfer(sig ownerSig, int num) {
+            require(checkSig(ownerSig, owner));
+
+            console.log(ownerSig, owner, num);
+
+            bytes2 beef = 0xbeef;
+            require(beef != 0xfeed);
+
+            console.log(beef, 1, "test", true);
+
+            require(num == 1000);
+          }
+        }
+      `;
+
+      const artifact2 = compileString(contractCode);
+
+      const contract = new Contract(artifact2, [alicePub], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const incorrectNum = 100n;
+      const transaction = contract.functions
+        .transfer(new SignatureTemplate(alicePriv), incorrectNum)
+        .to(contract.address, 10000n);
+
+      // console.log(ownerSig, owner, num);
+      const expectedFirstLog = new RegExp(`^Test.cash:6 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100$`);
+      await expect(transaction).toLog(expectedFirstLog);
+
+      const expectedSecondLog = new RegExp('^Test.cash:11 0xbeef 1 test true$');
+      await expect(transaction).toLog(expectedSecondLog);
+    });
   });
 
   it('should check for failed requires', async () => {

From fc3f74da943e5fb9b578a384ff0c1d7e82463545 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 23 Feb 2024 07:40:39 -1000
Subject: [PATCH 024/267] Add Transaction#getLibauthTemplate function to export
 libauth template

---
 packages/cashscript/src/Transaction.ts | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 8f4658d3..16b8cd69 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -216,19 +216,19 @@ export class Transaction {
 
   // method to debug the transaction with libauth VM, throws upon evaluation error
   async debug(): Promise<DebugResult> {
-    const template = await buildTemplate({
-      transaction: this,
-    });
+    const template = await this.getLibauthTemplate();
     return debugTemplate(template, this.contract.artifact);
   }
 
   async bitauthUri(): Promise<string> {
-    const template = await buildTemplate({
-      transaction: this,
-    });
+    const template = await this.getLibauthTemplate();
     return getBitauthUri(template);
   }
 
+  async getLibauthTemplate(): Promise<WalletTemplate> {
+    return buildTemplate({ transaction: this });
+  }
+
   private async getTxDetails(txid: string): Promise<TransactionDetails>;
   private async getTxDetails(txid: string, raw: true): Promise<string>;
 

From e471ceb2d786c4772d7409597652c95392f4c45e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 23 Feb 2024 07:50:01 -1000
Subject: [PATCH 025/267] Escape multiline-style comments in debug bitauth
 (sourcemapped) script

---
 packages/utils/src/bitauth-script.ts                   | 3 ++-
 packages/utils/test/fixtures/bitauth-script.fixture.ts | 6 +++---
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/packages/utils/src/bitauth-script.ts b/packages/utils/src/bitauth-script.ts
index 21a7f4c5..bb8b7e39 100644
--- a/packages/utils/src/bitauth-script.ts
+++ b/packages/utils/src/bitauth-script.ts
@@ -30,7 +30,8 @@ export function buildLineToAsmMap(bytecode: Script, sourceMap: string): LineToAs
 export function formatBitAuthScript(bytecode: Script, sourceMap: string, sourceCode: string): string {
   const lineToAsmMap = buildLineToAsmMap(bytecode, sourceMap);
 
-  const sourceCodeLines = sourceCode.split('\n');
+  const escapedSourceCode = sourceCode.replaceAll('/*', '\\/*').replaceAll('*/', '*\\/');
+  const sourceCodeLines = escapedSourceCode.split('\n');
 
   const sourceCodeLineLengths = sourceCodeLines.map((line) => line.length);
   const bytecodeLineLengths = Object.values(lineToAsmMap).map((line) => line.length);
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index c8117f04..07c60582 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -169,12 +169,12 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
                                                                                          /*                                                                                                                    */
                                                                                          /* pragma cashscript >=0.8.0;                                                                                         */
                                                                                          /*                                                                                                                    */
-                                                                                         /* /* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                        */
+                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */
                                                                                          /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */
                                                                                          /*  * of covenants in CashScript.                                                                                     */
                                                                                          /*  * The time checking has been removed so it can be tested without time requirements.                               */
-                                                                                         /*  */                                                                                                                */
-                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {                                 */
+                                                                                         /*  *\\/                                                                                                               */
+                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */
 OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */
                                                                                          /*         // require(tx.age >= period);                                                                              */
                                                                                          /*                                                                                                                    */

From a71004dd7495051b56b1687779a75d4f3eb6e595 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 1 Mar 2024 06:42:27 -1000
Subject: [PATCH 026/267] Restructure require statement tests

---
 ...authTemplate.test.ts => debugging.test.ts} | 41 ++++++++-----------
 1 file changed, 16 insertions(+), 25 deletions(-)
 rename packages/cashscript/test/{LibauthTemplate.test.ts => debugging.test.ts} (91%)

diff --git a/packages/cashscript/test/LibauthTemplate.test.ts b/packages/cashscript/test/debugging.test.ts
similarity index 91%
rename from packages/cashscript/test/LibauthTemplate.test.ts
rename to packages/cashscript/test/debugging.test.ts
index 581a33dc..81b258b4 100644
--- a/packages/cashscript/test/LibauthTemplate.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -7,7 +7,7 @@ import '../src/test/JestExtensions.js';
 import { randomUtxo } from '../src/utils.js';
 import { binToHex } from '@bitauth/libauth';
 
-describe('Libauth template generation tests', () => {
+describe('Debugging tests', () => {
   describe('console.log statements', () => {
     const BASE_CONTRACT_CODE = `
       contract Test(pubkey owner) {
@@ -142,10 +142,8 @@ describe('Libauth template generation tests', () => {
     });
   });
 
-  it('should check for failed requires', async () => {
+  describe('require statements', () => {
     const code = `
-    pragma cashscript ^0.10.0;
-
     contract TransferWithTimeout(
         pubkey sender,
         pubkey recipient,
@@ -159,12 +157,7 @@ describe('Libauth template generation tests', () => {
         // Require timeout time to be reached and sender's signature to match
         function timeout(sig senderSig) {
             require(checkSig(senderSig, sender), "sigcheck custom fail");
-            require(tx.time >= timeout);
-        }
-
-        function timeout2(sig senderSig) {
             require(tx.time >= timeout, "timecheck custom fail");
-            require(checkSig(senderSig, sender));
         }
 
         function test(int a) {
@@ -174,40 +167,38 @@ describe('Libauth template generation tests', () => {
     `;
 
     const artifact = compileString(code);
-
     const provider = new MockNetworkProvider();
-    {
+
+    it('should fail with correct error message when there are multiple require statements', async () => {
       const contract = new Contract(artifact, [alicePub, bobPub, 2000000n], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.timeout(new SignatureTemplate(bobPriv)).to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith(/sigcheck custom fail/);
-    }
+    });
 
-    {
+    it('should fail with correct error message for timecheck require statemen when there are multiple require statements', async () => {
       const contract = new Contract(artifact, [alicePub, bobPub, 1000000n], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.timeout2(new SignatureTemplate(alicePriv)).to(contract.address, 1000n);
+      const transaction = contract.functions.timeout(new SignatureTemplate(alicePriv)).to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith(/timecheck custom fail/);
-    }
+    });
 
-    {
+    it('should fail with correct error message for the final require statement', async () => {
       const contract = new Contract(artifact, [alicePub, bobPub, 2000000n], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.transfer(new SignatureTemplate(bobPriv)).to(contract.address, 1000n);
-      await expect(transaction).not.toFailRequireWith(/timecheck custom fail/);
-    }
+      const transaction = contract.functions.test(0n).to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith(/dropped last verify fail/);
+    });
 
-    {
+    it('should not fail if no require statements fail', async () => {
       const contract = new Contract(artifact, [alicePub, bobPub, 2000000n], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.test(0n).to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/dropped last verify fail/);
-
-      await expect(transaction.send()).rejects.toThrow(/Stack contents after evaluation: 0x/);
-    }
+      const transaction = contract.functions.transfer(new SignatureTemplate(bobPriv)).to(contract.address, 1000n);
+      await expect(transaction).not.toFailRequireWith(/.*/);
+    });
   });
 });

From 6163af41320b8f18ccade5d6d84a37506fc44661 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 1 Mar 2024 07:51:32 -1000
Subject: [PATCH 027/267] Add Libauth Template generation tests and fix some
 issues with the generation

---
 packages/cashscript/src/LibauthTemplate.ts    |   9 +-
 .../src/network/MockNetworkProvider.ts        |   2 +-
 .../test/fixture/libauth-template/fixtures.ts | 692 ++++++++++++++++++
 .../libauth-template/LibauthTemplate.test.ts  |  10 +
 4 files changed, 711 insertions(+), 2 deletions(-)
 create mode 100644 packages/cashscript/test/fixture/libauth-template/fixtures.ts
 create mode 100644 packages/cashscript/test/libauth-template/LibauthTemplate.test.ts

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 57bf0d3f..7beb0860 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -164,7 +164,14 @@ const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransac
           lockingBytecode instanceof Uint8Array
             ? binToHex(lockingBytecode)
             : lockingBytecode,
-        token: output.token,
+        token: output.token ? {
+          amount: output.token.amount.toString(),
+          category: binToHex(output.token.category),
+          nft: output.token.nft ? {
+            capability: output.token.nft.capability,
+            commitment: binToHex(output.token.nft.commitment),
+          } : undefined,
+        } : undefined,
         valueSatoshis: Number(output.valueSatoshis),
       } as WalletTemplateScenarioTransactionOutput;
     },
diff --git a/packages/cashscript/src/network/MockNetworkProvider.ts b/packages/cashscript/src/network/MockNetworkProvider.ts
index ed260b2d..83c6eec8 100644
--- a/packages/cashscript/src/network/MockNetworkProvider.ts
+++ b/packages/cashscript/src/network/MockNetworkProvider.ts
@@ -23,7 +23,7 @@ export default class MockNetworkProvider implements NetworkProvider {
   }
 
   async getUtxos(address: string): Promise<Utxo[]> {
-    return this.utxoMap[address];
+    return this.utxoMap[address] ?? [];
   }
 
   async getBlockHeight(): Promise<number> {
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
new file mode 100644
index 00000000..a8c1aa8c
--- /dev/null
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -0,0 +1,692 @@
+import { Contract, MockNetworkProvider, SignatureTemplate, Transaction, randomNFT, randomToken, randomUtxo } from '../../../src/index.js';
+import TransferWithTimeout from '../transfer_with_timeout.json' assert { type: 'json' };
+import Mecenas from '../mecenas.json' assert { type: 'json' };
+import P2PKH from '../p2pkh.json' assert { type: 'json' };
+import { aliceAddress, alicePkh, alicePriv, alicePub, bobPkh, bobPriv, bobPub } from '../vars.js';
+import { WalletTemplate } from '@bitauth/libauth';
+
+const provider = new MockNetworkProvider();
+
+export interface Fixture {
+  name: string;
+  transaction: Transaction;
+  template: WalletTemplate;
+}
+
+export const fixtures: Fixture[] = [
+  {
+    name: 'TransferWithTimeout (transfer function)',
+    transaction: (() => {
+      const contract = new Contract(TransferWithTimeout, [alicePub, bobPub, 100000n], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const tx = contract.functions
+        .transfer(new SignatureTemplate(bobPriv))
+        .to(contract.address, 10000n)
+        .withoutChange();
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'TransferWithTimeout',
+      'supported': [
+        'BCH_SPEC',
+      ],
+      'version': 0,
+      'entities': {
+        'parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'parameters',
+          'scripts': [
+            'lock',
+            'unlock_lock',
+          ],
+          'variables': {
+            'recipient_sig': {
+              'description': '"recipientSig" parameter of function "transfer"',
+              'name': 'recipientSig',
+              'type': 'Key',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'timeout',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'recipient',
+              'type': 'WalletData',
+            },
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'sender',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scenarios': {
+        'evaluate_function': {
+          'name': 'Evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'function_index': '0',
+              'timeout': '0xa08601',
+              'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'recipient_sig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': expect.any(Number),
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 10000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+      'scripts': {
+        'unlock_lock': {
+          'passes': [
+            'evaluate_function',
+          ],
+          'name': 'unlock',
+          'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'lock',
+        },
+        'lock': {
+          'lockingType': 'p2sh20',
+          'name': 'lock',
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+        },
+      },
+    },
+  },
+  {
+    name: 'TransferWithTimeout (timeout function)',
+    transaction: (() => {
+      const contract = new Contract(TransferWithTimeout, [alicePub, bobPub, 100000n], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const tx = contract.functions
+        .timeout(new SignatureTemplate(alicePriv))
+        .to(contract.address, 10000n)
+        .withoutChange();
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'TransferWithTimeout',
+      'supported': [
+        'BCH_SPEC',
+      ],
+      'version': 0,
+      'entities': {
+        'parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'parameters',
+          'scripts': [
+            'lock',
+            'unlock_lock',
+          ],
+          'variables': {
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'timeout',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'recipient',
+              'type': 'WalletData',
+            },
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'sender',
+              'type': 'WalletData',
+            },
+            'sender_sig': {
+              'description': '"senderSig" parameter of function "timeout\"',
+              'name': 'senderSig',
+              'type': 'Key',
+            },
+          },
+        },
+      },
+      'scenarios': {
+        'evaluate_function': {
+          'name': 'Evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'function_index': '1',
+              'timeout': '0xa08601',
+              'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'sender_sig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': expect.any(Number),
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 10000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+      'scripts': {
+        'unlock_lock': {
+          'passes': [
+            'evaluate_function',
+          ],
+          'name': 'unlock',
+          'script': '// "timeout\" function parameters\n<sender_sig.schnorr_signature.all_outputs> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'lock',
+        },
+        'lock': {
+          'lockingType': 'p2sh20',
+          'name': 'lock',
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+        },
+      },
+    },
+  },
+  {
+    name: 'Mecenas',
+    transaction: (() => {
+      const contract = new Contract(Mecenas, [alicePkh, bobPkh, 10_000n], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const tx = contract.functions
+        .receive()
+        .to(aliceAddress, 10_000n)
+        .withHardcodedFee(1000n);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'Mecenas',
+      'supported': [
+        'BCH_SPEC',
+      ],
+      'version': 0,
+      'entities': {
+        'parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'parameters',
+          'scripts': [
+            'lock',
+            'unlock_lock',
+          ],
+          'variables': {
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+            'pledge': {
+              'description': '"pledge" parameter of this contract',
+              'name': 'pledge',
+              'type': 'WalletData',
+            },
+            'funder': {
+              'description': '"funder" parameter of this contract',
+              'name': 'funder',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'recipient',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scenarios': {
+        'evaluate_function': {
+          'name': 'Evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'function_index': '0',
+              'pledge': '0x1027',
+              'funder': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
+              'recipient': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {},
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'valueSatoshis': 10000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+      'scripts': {
+        'unlock_lock': {
+          'passes': [
+            'evaluate_function',
+          ],
+          'name': 'unlock',
+          'script': '// "receive" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'lock',
+        },
+        'lock': {
+          'lockingType': 'p2sh20',
+          'name': 'lock',
+          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* /* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                        */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  */                                                                                                                */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {                                 */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(tx.age >= period);                                                                              */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\n                                                                                         /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ELSE OP_ENDIF                                                                         /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
+        },
+      },
+    },
+  },
+  {
+    name: 'P2PKH (sending fungible tokens)',
+    transaction: (() => {
+      const contract = new Contract(P2PKH, [alicePkh], { provider });
+
+      const regularUtxo = randomUtxo();
+      const tokenUtxo = randomUtxo({ satoshis: 1000n, token: randomToken() });
+      provider.addUtxo(contract.address, regularUtxo);
+      provider.addUtxo(contract.address, tokenUtxo);
+
+      const to = contract.tokenAddress;
+      const amount = 1000n;
+
+      const tx = contract.functions
+        .spend(alicePub, new SignatureTemplate(alicePriv))
+        .from(regularUtxo)
+        .from(tokenUtxo)
+        .to(to, amount, tokenUtxo.token);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'P2PKH',
+      'supported': [
+        'BCH_SPEC',
+      ],
+      'version': 0,
+      'entities': {
+        'parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'parameters',
+          'scripts': [
+            'lock',
+            'unlock_lock',
+          ],
+          'variables': {
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scenarios': {
+        'evaluate_function': {
+          'name': 'Evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'function_index': '0',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'token': {
+                  'amount': expect.stringMatching(/^[0-9]+$/),
+                  'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+                },
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {},
+              'valueSatoshis': 1000,
+              'token': {
+                'amount': expect.stringMatching(/^[0-9]+$/),
+                'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+              },
+            },
+          ],
+        },
+      },
+      'scripts': {
+        'unlock_lock': {
+          'passes': [
+            'evaluate_function',
+          ],
+          'name': 'unlock',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'lock',
+        },
+        'lock': {
+          'lockingType': 'p2sh20',
+          'name': 'lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+      },
+    },
+  },
+  {
+    name: 'P2PKH (sending NFTs)',
+    transaction: (() => {
+      const contract = new Contract(P2PKH, [alicePkh], { provider });
+
+      const regularUtxo = randomUtxo();
+      const nftUtxo = randomUtxo({ satoshis: 1000n, token: randomNFT() });
+      provider.addUtxo(contract.address, regularUtxo);
+      provider.addUtxo(contract.address, nftUtxo);
+
+      const to = contract.tokenAddress;
+      const amount = 1000n;
+
+      const tx = contract.functions
+        .spend(alicePub, new SignatureTemplate(alicePriv))
+        .from(regularUtxo)
+        .from(nftUtxo)
+        .to(to, amount, nftUtxo.token);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'P2PKH',
+      'supported': [
+        'BCH_SPEC',
+      ],
+      'version': 0,
+      'entities': {
+        'parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'parameters',
+          'scripts': [
+            'lock',
+            'unlock_lock',
+          ],
+          'variables': {
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scenarios': {
+        'evaluate_function': {
+          'name': 'Evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'function_index': '0',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'token': {
+                  'amount': '0',
+                  'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+                  'nft': {
+                    'capability': 'none',
+                    'commitment': expect.stringMatching(/^[0-9a-f]{8}$/),
+                  },
+                },
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {},
+              'valueSatoshis': 1000,
+              'token': {
+                'amount': '0',
+                'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'nft': {
+                  'capability': 'none',
+                  'commitment': expect.stringMatching(/^[0-9a-f]{8}$/),
+                },
+              },
+            },
+          ],
+        },
+      },
+      'scripts': {
+        'unlock_lock': {
+          'passes': [
+            'evaluate_function',
+          ],
+          'name': 'unlock',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'lock',
+        },
+        'lock': {
+          'lockingType': 'p2sh20',
+          'name': 'lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+      },
+    },
+  },
+  // TODO: Add fixture with datasig arguments
+  // TODO: Add fixture with different signing types (other than all_outputs)
+];
diff --git a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
new file mode 100644
index 00000000..228c8198
--- /dev/null
+++ b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
@@ -0,0 +1,10 @@
+import { fixtures } from '../fixture/libauth-template/fixtures.js';
+
+describe('Libauth Template generation tests', () => {
+  fixtures.forEach((fixture) => {
+    it(`should generate a valid libauth template for ${fixture.name}`, async () => {
+      const generatedTemplate = await fixture.transaction.getLibauthTemplate();
+      expect(generatedTemplate).toEqual(fixture.template);
+    });
+  });
+});

From 84e52b6627f291705d8183140aca244158d891ee Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 8 Mar 2024 17:33:58 +1100
Subject: [PATCH 028/267] Add some more edge case fixtures for Libauth Template
 generation

---
 .../test/fixture/libauth-template/fixtures.ts | 355 +++++++++++++++++-
 .../libauth-template/LibauthTemplate.test.ts  |   2 +
 2 files changed, 354 insertions(+), 3 deletions(-)

diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index a8c1aa8c..dfaf6ddb 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -2,7 +2,8 @@ import { Contract, MockNetworkProvider, SignatureTemplate, Transaction, randomNF
 import TransferWithTimeout from '../transfer_with_timeout.json' assert { type: 'json' };
 import Mecenas from '../mecenas.json' assert { type: 'json' };
 import P2PKH from '../p2pkh.json' assert { type: 'json' };
-import { aliceAddress, alicePkh, alicePriv, alicePub, bobPkh, bobPriv, bobPub } from '../vars.js';
+import HoldVault from '../hodl_vault.json' assert { type: 'json' };
+import { aliceAddress, alicePkh, alicePriv, alicePub, bobPkh, bobPriv, bobPub, oracle, oraclePub } from '../vars.js';
 import { WalletTemplate } from '@bitauth/libauth';
 
 const provider = new MockNetworkProvider();
@@ -687,6 +688,354 @@ export const fixtures: Fixture[] = [
       },
     },
   },
-  // TODO: Add fixture with datasig arguments
-  // TODO: Add fixture with different signing types (other than all_outputs)
+  {
+    name: 'HodlVault (datasig)',
+    transaction: (() => {
+      const contract = new Contract(HoldVault, [alicePub, oraclePub, 99000n, 30000n], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      // given
+      const message = oracle.createMessage(100000n, 30000n);
+      const oracleSig = oracle.signMessage(message);
+      const to = contract.address;
+      const amount = 10000n;
+
+      // when
+      const tx = contract.functions
+        .spend(new SignatureTemplate(alicePriv), oracleSig, message)
+        .to(to, amount);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'HodlVault',
+      'supported': [
+        'BCH_SPEC',
+      ],
+      'version': 0,
+      'entities': {
+        'parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'parameters',
+          'scripts': [
+            'lock',
+            'unlock_lock',
+          ],
+          'variables': {
+            'oracle_message': {
+              'description': '"oracleMessage" parameter of function "spend"',
+              'name': 'oracleMessage',
+              'type': 'WalletData',
+            },
+            'oracle_sig': {
+              'description': '"oracleSig" parameter of function "spend"',
+              'name': 'oracleSig',
+              'type': 'WalletData',
+            },
+            'owner_sig': {
+              'description': '"ownerSig" parameter of function "spend"',
+              'name': 'ownerSig',
+              'type': 'Key',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+            'price_target': {
+              'description': '"priceTarget" parameter of this contract',
+              'name': 'priceTarget',
+              'type': 'WalletData',
+            },
+            'min_block': {
+              'description': '"minBlock" parameter of this contract',
+              'name': 'minBlock',
+              'type': 'WalletData',
+            },
+            'oracle_pk': {
+              'description': '"oraclePk" parameter of this contract',
+              'name': 'oraclePk',
+              'type': 'WalletData',
+            },
+            'owner_pk': {
+              'description': '"ownerPk" parameter of this contract',
+              'name': 'ownerPk',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scenarios': {
+        'evaluate_function': {
+          'name': 'Evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'oracle_message': '0xa086010030750000',
+              'oracle_sig': '0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b',
+              'function_index': '0',
+              'price_target': '0x3075',
+              'min_block': '0xb88201',
+              'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'owner_sig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 10000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+      'scripts': {
+        'unlock_lock': {
+          'passes': [
+            'evaluate_function',
+          ],
+          'name': 'unlock',
+          'script': '// "spend" function parameters\n<oracle_message> // bytes8 = <0xa086010030750000>\n<oracle_sig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<owner_sig.schnorr_signature.all_outputs> // sig\n',
+          'unlocks': 'lock',
+        },
+        'lock': {
+          'lockingType': 'p2sh20',
+          'name': 'lock',
+          'script': '// "HodlVault" contract constructor parameters\n<price_target> // int = <0x3075>\n<min_block> // int = <0xb88201>\n<oracle_pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<owner_pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
+        },
+      },
+    },
+  },
+  // TODO: Make it work with different hashtypes and signature algorithms
+  // {
+  //   name: 'P2PKH (sending NFTs)',
+  //   transaction: (() => {
+  //     const contract = new Contract(P2PKH, [alicePkh], { provider });
+  //     provider.addUtxo(contract.address, randomUtxo());
+
+  //     const to = contract.address;
+  //     const amount = 1000n;
+
+  //     const hashtype = HashType.SIGHASH_SINGLE | HashType.SIGHASH_ANYONECANPAY;
+  //     const signatureAlgorithm = SignatureAlgorithm.ECDSA;
+
+  //     const tx = contract.functions
+  //       .spend(alicePub, new SignatureTemplate(alicePriv, hashtype, signatureAlgorithm))
+  //       .to(to, amount);
+
+  //     return tx;
+  //   })(),
+  //   template: {} as any,
+  // },
+  {
+    name: 'P2PKH (with P2PKH inputs)',
+    transaction: (() => {
+      const contract = new Contract(P2PKH, [alicePkh], { provider });
+
+      const regularUtxo = randomUtxo();
+      provider.addUtxo(contract.address, regularUtxo);
+
+      const p2pkhUtxo = randomUtxo();
+      provider.addUtxo(aliceAddress, p2pkhUtxo);
+
+      const to = contract.tokenAddress;
+      const amount = 1000n;
+
+      const tx = contract.functions
+        .spend(alicePub, new SignatureTemplate(alicePriv))
+        .fromP2PKH(p2pkhUtxo, new SignatureTemplate(alicePriv))
+        .from(regularUtxo)
+        .to(to, amount);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'P2PKH',
+      'supported': [
+        'BCH_SPEC',
+      ],
+      'version': 0,
+      'entities': {
+        'parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'parameters',
+          'scripts': [
+            'lock',
+            'unlock_lock',
+            'p2pkh_placeholder_lock',
+            'p2pkh_placeholder_unlock',
+          ],
+          'variables': {
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+            'placeholder_key': {
+              'description': 'placeholder_key',
+              'name': 'placeholder_key',
+              'type': 'Key',
+            },
+          },
+        },
+      },
+      'scenarios': {
+        'evaluate_function': {
+          'name': 'Evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'function_index': '0',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                'placeholder_key': '<Uint8Array: 0x0000000000000000000000000000000000000000000000000000000000000000>',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+      'scripts': {
+        'unlock_lock': {
+          'passes': [
+            'evaluate_function',
+          ],
+          'name': 'unlock',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'lock',
+        },
+        'lock': {
+          'lockingType': 'p2sh20',
+          'name': 'lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+        'p2pkh_placeholder_unlock': {
+          'name': 'p2pkh_placeholder_unlock',
+          'script': '<placeholder_key.schnorr_signature.all_outputs>\n<placeholder_key.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock',
+        },
+        'p2pkh_placeholder_lock': {
+          'lockingType': 'standard',
+          'name': 'p2pkh_placeholder_lock',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+        },
+      },
+    },
+  },
 ];
diff --git a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
index 228c8198..1c18fafc 100644
--- a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
+++ b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
@@ -4,6 +4,8 @@ describe('Libauth Template generation tests', () => {
   fixtures.forEach((fixture) => {
     it(`should generate a valid libauth template for ${fixture.name}`, async () => {
       const generatedTemplate = await fixture.transaction.getLibauthTemplate();
+      console.log(JSON.stringify(generatedTemplate, null, 2));
+      console.log(await fixture.transaction.bitauthUri());
       expect(generatedTemplate).toEqual(fixture.template);
     });
   });

From 62f92c01e4fe33659d29a7d740afdd035fd6d271 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 8 Mar 2024 18:32:56 +1100
Subject: [PATCH 029/267] Fix bug with handling of ELSE statements + update
 tests accordingly

---
 .../src/generation/GenerateTargetTraversal.ts |  4 +-
 .../cashscript/test/fixture/announcement.json |  4 +-
 packages/cashscript/test/fixture/bigint.json  |  4 +-
 .../test/fixture/bounded_bytes.json           |  4 +-
 .../cashscript/test/fixture/hodl_vault.json   |  4 +-
 .../test/fixture/libauth-template/fixtures.ts |  2 +-
 packages/cashscript/test/fixture/mecenas.json |  6 +-
 .../cashscript/test/fixture/p2palindrome.json |  4 +-
 packages/cashscript/test/fixture/p2pkh.json   |  4 +-
 .../test/fixture/simple_covenant.json         |  4 +-
 .../test/fixture/transfer_with_timeout.json   |  4 +-
 .../test/fixtures/bitauth-script.fixture.ts   | 79 ++++++++++---------
 12 files changed, 61 insertions(+), 62 deletions(-)

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index aca43ba5..048751d1 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -345,9 +345,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     this.removeScopedVariables(stackDepth, node);
 
     if (node.elseBlock) {
-      // TODO: Why would the *start* of the else block be PositionHint.END? Is it because it is also the end of
-      // the if block?
-      this.emit(Op.OP_ELSE, { location: node.elseBlock.location, positionHint: PositionHint.END });
+      this.emit(Op.OP_ELSE, { location: node.elseBlock.location });
       stackDepth = this.stack.length;
       node.elseBlock = this.visit(node.elseBlock);
       this.removeScopedVariables(stackDepth, node);
diff --git a/packages/cashscript/test/fixture/announcement.json b/packages/cashscript/test/fixture/announcement.json
index 5b69e1e1..7971f48a 100644
--- a/packages/cashscript/test/fixture/announcement.json
+++ b/packages/cashscript/test/fixture/announcement.json
@@ -17,7 +17,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.2"
   },
-  "updatedAt": "2024-02-01T10:15:35.499Z"
+  "updatedAt": "2024-03-08T07:28:42.672Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index c0a5b59f..c116835c 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -26,7 +26,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.2"
   },
-  "updatedAt": "2024-02-01T10:15:35.191Z"
+  "updatedAt": "2024-03-08T07:28:42.372Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index 39aac5b5..61260f9c 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -26,7 +26,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.2"
   },
-  "updatedAt": "2024-02-01T10:15:36.327Z"
+  "updatedAt": "2024-03-08T07:28:43.531Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index 76302e82..a97d918b 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -47,7 +47,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.2"
   },
-  "updatedAt": "2024-02-01T10:15:35.784Z"
+  "updatedAt": "2024-03-08T07:28:42.957Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index dfaf6ddb..3054175a 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -379,7 +379,7 @@ export const fixtures: Fixture[] = [
         'lock': {
           'lockingType': 'p2sh20',
           'name': 'lock',
-          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* /* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                        */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  */                                                                                                                */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {                                 */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(tx.age >= period);                                                                              */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\n                                                                                         /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ELSE OP_ENDIF                                                                         /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
+          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(tx.age >= period);                                                                              */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
         },
       },
     },
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index d619a3e9..37e70e38 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -37,13 +37,13 @@
   "source": "pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(tx.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
     "bytecode": "5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768",
-    "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9;24:31:24:32:0;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1",
+    "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1",
     "logs": [],
     "requireMessages": []
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.2"
   },
-  "updatedAt": "2024-02-01T10:15:37.487Z"
+  "updatedAt": "2024-03-08T07:28:44.590Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index fffdbd33..1a91fdbc 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -22,7 +22,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.2"
   },
-  "updatedAt": "2024-02-01T10:15:36.058Z"
+  "updatedAt": "2024-03-08T07:28:43.277Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index da74a75d..9d5d4d11 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -31,7 +31,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.2"
   },
-  "updatedAt": "2024-02-01T10:15:37.188Z"
+  "updatedAt": "2024-03-08T07:28:44.330Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/simple_covenant.json b/packages/cashscript/test/fixture/simple_covenant.json
index f8ee9361..e1e8f0d2 100644
--- a/packages/cashscript/test/fixture/simple_covenant.json
+++ b/packages/cashscript/test/fixture/simple_covenant.json
@@ -17,7 +17,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.2"
   },
-  "updatedAt": "2024-02-01T10:15:36.616Z"
+  "updatedAt": "2024-03-08T07:28:43.800Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index 88f7dbd3..bd14c019 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -44,7 +44,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.2"
   },
-  "updatedAt": "2024-02-01T10:15:36.909Z"
+  "updatedAt": "2024-03-08T07:28:44.062Z"
 }
\ No newline at end of file
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index 07c60582..29b65ec9 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -124,49 +124,50 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
         require(hash160(pk) == funder);
         require(checkSig(s, pk));
     }
-}`,
+}`.replace(/^\n+/, '').replace(/\n+$/, ''),
     asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_2 OP_ROLL OP_CAT 88ac OP_CAT OP_EQUAL OP_VERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY OP_ENDIF OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
-    sourceMap: '10:4:29:5;;;;;14:27:14:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;16:23:16:27:0;17:37:17:58;:27::65;18:26:18:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;22:12:22:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:24:9:0;23:31:23:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;24:15:28:9;25:31:25:32:0;:20::39;:43::49;;:20:::1;:12::51;26:31:26:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;27:31:27:32:0;:20::39;:43::54;;:20:::1;:12::56;24:15:28:9;10:4:29:5;;;;;;;;31::34::0;;;;;32:24:32:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;33:25:33:26:0;;:28::30;;:16::31:1;31:4:34:5;;9:0:35:1',
+    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
     expectedLineToOpcodeMap: {
-      10: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
-      14: [new Uint8Array([]), Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_2, Op.OP_ROLL, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUAL, Op.OP_VERIFY],
-      16: [hexToBin('e803')],
-      17: [Op.OP_INPUTINDEX, Op.OP_UTXOVALUE],
-      18: [new Uint8Array([]), Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_2, Op.OP_PICK, Op.OP_SUB],
-      22: [new Uint8Array([]), Op.OP_PICK, Op.OP_5, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_ADD, Op.OP_LESSTHANOREQUAL, Op.OP_IF],
-      23: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_2, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      25: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_5, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      26: [Op.OP_1, Op.OP_OUTPUTBYTECODE, Op.OP_INPUTINDEX, Op.OP_UTXOBYTECODE, Op.OP_EQUAL, Op.OP_VERIFY],
-      27: [Op.OP_1, Op.OP_OUTPUTVALUE, Op.OP_1, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      28: [Op.OP_ELSE, Op.OP_ENDIF],
-      29: [Op.OP_1, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_ELSE],
-      31: [Op.OP_3, Op.OP_ROLL, Op.OP_1, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      32: [Op.OP_3, Op.OP_PICK, Op.OP_HASH160, Op.OP_2, Op.OP_ROLL, Op.OP_EQUAL, Op.OP_VERIFY],
-      33: [Op.OP_3, Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_CHECKSIG],
-      34: [Op.OP_NIP, Op.OP_NIP],
-      35: [Op.OP_ENDIF],
+      9: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
+      13: [new Uint8Array([]), Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_2, Op.OP_ROLL, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUAL, Op.OP_VERIFY],
+      15: [hexToBin('e803')],
+      16: [Op.OP_INPUTINDEX, Op.OP_UTXOVALUE],
+      17: [new Uint8Array([]), Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_2, Op.OP_PICK, Op.OP_SUB],
+      21: [new Uint8Array([]), Op.OP_PICK, Op.OP_5, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_ADD, Op.OP_LESSTHANOREQUAL, Op.OP_IF],
+      22: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_2, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      23: [Op.OP_ELSE],
+      24: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_5, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      25: [Op.OP_1, Op.OP_OUTPUTBYTECODE, Op.OP_INPUTINDEX, Op.OP_UTXOBYTECODE, Op.OP_EQUAL, Op.OP_VERIFY],
+      26: [Op.OP_1, Op.OP_OUTPUTVALUE, Op.OP_1, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      27: [Op.OP_ENDIF],
+      28: [Op.OP_1, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_ELSE],
+      30: [Op.OP_3, Op.OP_ROLL, Op.OP_1, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      31: [Op.OP_3, Op.OP_PICK, Op.OP_HASH160, Op.OP_2, Op.OP_ROLL, Op.OP_EQUAL, Op.OP_VERIFY],
+      32: [Op.OP_3, Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_CHECKSIG],
+      33: [Op.OP_NIP, Op.OP_NIP],
+      34: [Op.OP_ENDIF],
     },
     expectedLineToAsmMap: {
-      10: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF',
-      14: 'OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY',
-      16: '<0xe803>',
-      17: 'OP_INPUTINDEX OP_UTXOVALUE',
-      18: 'OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB',
-      22: 'OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF',
-      23: 'OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY',
-      25: 'OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY',
-      26: 'OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY',
-      27: 'OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY',
-      28: 'OP_ELSE OP_ENDIF',
-      29: 'OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE',
-      31: 'OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY',
-      32: 'OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY',
-      33: 'OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG',
-      34: 'OP_NIP OP_NIP',
-      35: 'OP_ENDIF',
+      9: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF',
+      13: 'OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY',
+      15: '<0xe803>',
+      16: 'OP_INPUTINDEX OP_UTXOVALUE',
+      17: 'OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB',
+      21: 'OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF',
+      22: 'OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY',
+      23: 'OP_ELSE',
+      24: 'OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY',
+      25: 'OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY',
+      26: 'OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY',
+      27: 'OP_ENDIF',
+      28: 'OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE',
+      30: 'OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY',
+      31: 'OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY',
+      32: 'OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG',
+      33: 'OP_NIP OP_NIP',
+      34: 'OP_ENDIF',
     },
     expectedBitAuthScript: `
-                                                                                         /*                                                                                                                    */
                                                                                          /* pragma cashscript >=0.8.0;                                                                                         */
                                                                                          /*                                                                                                                    */
                                                                                          /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */
@@ -189,11 +190,11 @@ OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB
                                                                                          /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */
 OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */
 OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */
-                                                                                         /*         } else {                                                                                                   */
+OP_ELSE                                                                                  /*         } else {                                                                                                   */
 OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */
 OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */
 OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */
-OP_ELSE OP_ENDIF                                                                         /*         }                                                                                                          */
+OP_ENDIF                                                                                 /*         }                                                                                                          */
 OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */
                                                                                          /*                                                                                                                    */
 OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */

From f96706ff79779cae10f91dfdf131884531742c14 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 19 Mar 2024 17:11:25 +1100
Subject: [PATCH 030/267] Bump version to 0.10.0-next.3

---
 examples/package.json            | 6 +++---
 packages/cashc/package.json      | 4 ++--
 packages/cashc/src/index.ts      | 2 +-
 packages/cashscript/package.json | 4 ++--
 packages/utils/package.json      | 2 +-
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index a6faa511..d508aefa 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.0-next.2",
+  "version": "0.10.0-next.3",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -14,8 +14,8 @@
     "@bitauth/libauth": "^2.0.0-alpha.8",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
-    "cashc": "^0.10.0-next.2",
-    "cashscript": "^0.10.0-next.2",
+    "cashc": "^0.10.0-next.3",
+    "cashscript": "^0.10.0-next.3",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index c7b449c3..3999f4c7 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.0-next.2",
+  "version": "0.10.0-next.3",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0",
-    "@cashscript/utils": "^0.10.0-next.2",
+    "@cashscript/utils": "^0.10.0-next.3",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 4273a82c..37cf20d1 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.0-next.2';
+export const version = '0.10.0-next.3';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 94587610..82de41d2 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.0-next.2",
+  "version": "0.10.0-next.3",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0",
-    "@cashscript/utils": "^0.10.0-next.2",
+    "@cashscript/utils": "^0.10.0-next.3",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index d2ff60f5..615bdd23 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.0-next.2",
+  "version": "0.10.0-next.3",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From 1b66bdb92f972d311d968667290e96085d7fcdc7 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 19 Mar 2024 17:26:17 +1100
Subject: [PATCH 031/267] Fix failing tests

---
 packages/cashc/test/generation/fixtures.ts         | 6 +++---
 packages/utils/test/fixtures/source-map.fixture.ts | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index b8b2a8f7..f3f4efeb 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -102,7 +102,7 @@ export const fixtures: Fixture[] = [
         bytecode: '527954799300795479940079537a52949c6300795579935479517993527a757c00795279a0697567007954799c69680079547a93007a537a9c777777',
         logs: [],
         requireMessages: [],
-        sourceMap: '3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:8:11:9:0;9:15:::1;10:20:10:21:0;;:25::26;;:20:::1;:12::28;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;2:4:14:5;;',
+        sourceMap: '3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:8:11:9:0;9:15;10:20:10:21;;:25::26;;:20:::1;:12::28;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;2:4:14:5;;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/if_statement.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -205,7 +205,7 @@ export const fixtures: Fixture[] = [
         bytecode: '5279009c63537955799300795579940079537a9c6300795679935579517993527a757c00795279a06975675479517a75680079557a93007a537a9c69517777777767527a519c695279007952930079537a9c6300795479930079527993527a757c00795279a0697568537a007a537a9c777768',
         logs: [],
         requireMessages: [],
-        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:12:::1;:20:9:9:0;6::6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:8:11:9:0;9:15:::1;10:16:10:17:0;;:12::18;;;9:15:11:9:1;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;:8::24;2:4:14:5;;;;;;16::26::0;;;;;17:16:17:17;;18:12:18:13;;:16::17;:12:::1;19::19:13:0;;:17::18;;:12:::1;:20:23:9:0;20::20:21;;:24::25;;:20:::1;21:16:21:17:0;;:20::21;;:16:::1;:12::22:0;;;;22:20:22:21;;:24::25;;:20:::1;:12::27;19:8:23:9:0;:20:::1;24:12:24:13:0;;25:16:25:17;;:21::22;;:16:::1;16:4:26:5;;1:0:27:1',
+        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:12:::1;:20:9:9:0;6::6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:8:11:9:0;9:15;10:16:10:17;;:12::18;;;9:15:11:9:1;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;:8::24;2:4:14:5;;;;;;16::26::0;;;;;17:16:17:17;;18:12:18:13;;:16::17;:12:::1;19::19:13:0;;:17::18;;:12:::1;:20:23:9:0;20::20:21;;:24::25;;:20:::1;21:16:21:17:0;;:20::21;;:16:::1;:12::22:0;;;;22:20:22:21;;:24::25;;:20:::1;:12::27;19:8:23:9:0;:20:::1;24:12:24:13:0;;25:16:25:17;;:21::22;;:16:::1;16:4:26:5;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/multifunction_if_statements.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -540,7 +540,7 @@ export const fixtures: Fixture[] = [
         bytecode: '5479009c63537ab27500cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767547a519c695479a9527a8769547a547aac77777768',
         logs: [],
         requireMessages: [],
-        sourceMap: '2:4:21:5;;;;;3:26:3:32;;:8::34:1;;6:27:6:28:0;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;8:23:8:27:0;9:37:9:58;:27::65;10:26:10:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;16:15:20:9;17:31:17:32:0;:20::39;:43::49;;:20:::1;:12::51;18:31:18:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;19:31:19:32:0;:20::39;:43::54;;:20:::1;:12::56;16:15:20:9;2:4:21:5;;;;;;;;23::26::0;;;;;24:24:24:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
+        sourceMap: '2:4:21:5;;;;;3:26:3:32;;:8::34:1;;6:27:6:28:0;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;8:23:8:27:0;9:37:9:58;:27::65;10:26:10:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;16:15:20:9:0;17:31:17:32;:20::39;:43::49;;:20:::1;:12::51;18:31:18:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;19:31:19:32:0;:20::39;:43::54;;:20:::1;:12::56;16:15:20:9;2:4:21:5;;;;;;;;23::26::0;;;;;24:24:24:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/mecenas.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
diff --git a/packages/utils/test/fixtures/source-map.fixture.ts b/packages/utils/test/fixtures/source-map.fixture.ts
index a4a05690..58b0cfce 100644
--- a/packages/utils/test/fixtures/source-map.fixture.ts
+++ b/packages/utils/test/fixtures/source-map.fixture.ts
@@ -99,7 +99,7 @@ export const fixtures: Fixture[] = [
       { location: { start: { line: 22, column: 43 }, end: { line: 22, column: 66 } }, positionHint: PositionHint.END },
       { location: { start: { line: 22, column: 20 }, end: { line: 22, column: 66 } }, positionHint: PositionHint.END },
       { location: { start: { line: 22, column: 12 }, end: { line: 22, column: 68 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 23, column: 15 }, end: { line: 27, column: 9 } }, positionHint: PositionHint.END },
+      { location: { start: { line: 23, column: 15 }, end: { line: 27, column: 9 } } },
       { location: { start: { line: 24, column: 31 }, end: { line: 24, column: 32 } } },
       { location: { start: { line: 24, column: 20 }, end: { line: 24, column: 39 } } },
       { location: { start: { line: 24, column: 43 }, end: { line: 24, column: 49 } } },
@@ -148,6 +148,6 @@ export const fixtures: Fixture[] = [
       { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.END },
       { location: { start: { line: 8, column: 0 }, end: { line: 34, column: 1 } }, positionHint: PositionHint.END },
     ],
-    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9;24:31:24:32:0;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
+    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
   },
 ];

From cc3f578a0d65c39c219dc388c592bb11f2ef740a Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 19 Mar 2024 18:06:14 +1100
Subject: [PATCH 032/267] Add tests for token category equality check + update
 fixtures

---
 .../token_category_comparison.cash            |  5 ++
 .../test/e2e/TokenCategoryCheck.test.ts       | 82 +++++++++++++++++++
 .../cashscript/test/fixture/announcement.json |  4 +-
 packages/cashscript/test/fixture/bigint.json  |  4 +-
 .../test/fixture/bounded_bytes.json           |  4 +-
 .../cashscript/test/fixture/hodl_vault.json   |  4 +-
 packages/cashscript/test/fixture/mecenas.json |  4 +-
 .../cashscript/test/fixture/p2palindrome.json |  4 +-
 packages/cashscript/test/fixture/p2pkh.json   |  4 +-
 .../test/fixture/simple_covenant.json         |  4 +-
 .../fixture/token_category_comparison.cash    |  5 ++
 .../fixture/token_category_comparison.json    | 23 ++++++
 .../test/fixture/transfer_with_timeout.json   |  4 +-
 13 files changed, 133 insertions(+), 18 deletions(-)
 create mode 100644 packages/cashc/test/valid-contract-files/token_category_comparison.cash
 create mode 100644 packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
 create mode 100644 packages/cashscript/test/fixture/token_category_comparison.cash
 create mode 100644 packages/cashscript/test/fixture/token_category_comparison.json

diff --git a/packages/cashc/test/valid-contract-files/token_category_comparison.cash b/packages/cashc/test/valid-contract-files/token_category_comparison.cash
new file mode 100644
index 00000000..a4dacfa7
--- /dev/null
+++ b/packages/cashc/test/valid-contract-files/token_category_comparison.cash
@@ -0,0 +1,5 @@
+contract Test() {
+    function send() {
+        require(tx.inputs[1].tokenCategory == 0x);
+    }
+}
diff --git a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
new file mode 100644
index 00000000..ec777a84
--- /dev/null
+++ b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
@@ -0,0 +1,82 @@
+import { randomUtxo, randomToken } from '../../src/utils.js';
+import {
+  Contract, ElectrumNetworkProvider, MockNetworkProvider,
+} from '../../src/index.js';
+import { Network, Utxo } from '../../src/interfaces.js';
+import artifact from '../fixture/token_category_comparison.json' assert { type: 'json' };
+
+describe('TokenCategoryCheck', () => {
+  let tokenCategoryCheckInstance: Contract;
+
+  beforeAll(() => {
+    const provider = process.env.TESTS_USE_MOCKNET
+      ? new MockNetworkProvider()
+      : new ElectrumNetworkProvider(Network.CHIPNET);
+    tokenCategoryCheckInstance = new Contract(artifact, [], { provider });
+    console.log(tokenCategoryCheckInstance.tokenAddress);
+
+    (provider as any).addUtxo?.(tokenCategoryCheckInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(tokenCategoryCheckInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(tokenCategoryCheckInstance.address, randomUtxo({
+      satoshis: 1000n,
+      token: randomToken(),
+    }));
+  });
+
+  describe('send', () => {
+    it('cannot send if the input at index 1 contains tokens', async () => {
+      const contractUtxos = await tokenCategoryCheckInstance.getUtxos();
+      const tokenUtxo = contractUtxos.find(isFungibleTokenUtxo);
+      const nonTokenUtxo = contractUtxos.find(isNonTokenUtxo);
+
+      if (!tokenUtxo) {
+        throw new Error('No token UTXO found with fungible tokens');
+      }
+
+      if (!nonTokenUtxo) {
+        throw new Error('No non-token UTXOs found');
+      }
+
+      const to = tokenCategoryCheckInstance.tokenAddress;
+      const amount = 1000n;
+      const { token } = tokenUtxo;
+
+      const txPromise = tokenCategoryCheckInstance.functions
+        .send()
+        .from(nonTokenUtxo)
+        .from(tokenUtxo)
+        .to(to, amount, token)
+        .send();
+
+      await expect(txPromise).rejects.toThrow(/completed with a non-truthy value on top of the stack/);
+    });
+
+    it('can send if the input at index 1 does not contain tokens', async () => {
+      const contractUtxos = await tokenCategoryCheckInstance.getUtxos();
+      const nonTokenUtxos = contractUtxos.filter(isNonTokenUtxo);
+
+      if (nonTokenUtxos.length < 2) {
+        throw new Error('Less than two non-token UTXOs found');
+      }
+
+      const to = tokenCategoryCheckInstance.tokenAddress;
+      const amount = 1000n;
+
+      const txPromise = tokenCategoryCheckInstance.functions
+        .send()
+        .from(nonTokenUtxos[0])
+        .from(nonTokenUtxos[1])
+        .to(to, amount)
+        .send();
+
+      await expect(txPromise).resolves.toBeTruthy();
+    });
+  });
+});
+
+// We don't include UTXOs that contain BOTH fungible and non-fungible tokens
+const isFungibleTokenUtxo = (utxo: Utxo): boolean => (
+  utxo.token !== undefined && utxo.token.amount > 0n && utxo.token.nft === undefined
+);
+
+const isNonTokenUtxo = (utxo: Utxo): boolean => utxo.token === undefined;
diff --git a/packages/cashscript/test/fixture/announcement.json b/packages/cashscript/test/fixture/announcement.json
index 7971f48a..5818dacc 100644
--- a/packages/cashscript/test/fixture/announcement.json
+++ b/packages/cashscript/test/fixture/announcement.json
@@ -17,7 +17,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.2"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2024-03-08T07:28:42.672Z"
+  "updatedAt": "2024-03-19T06:40:54.938Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index c116835c..6823b72a 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -26,7 +26,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.2"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2024-03-08T07:28:42.372Z"
+  "updatedAt": "2024-03-19T06:40:54.678Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index 61260f9c..e9537cd6 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -26,7 +26,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.2"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2024-03-08T07:28:43.531Z"
+  "updatedAt": "2024-03-19T06:40:55.720Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index a97d918b..b82200dc 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -47,7 +47,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.2"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2024-03-08T07:28:42.957Z"
+  "updatedAt": "2024-03-19T06:40:55.179Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index 37e70e38..94a8c042 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -43,7 +43,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.2"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2024-03-08T07:28:44.590Z"
+  "updatedAt": "2024-03-19T06:40:56.951Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index 1a91fdbc..2aa03066 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -22,7 +22,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.2"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2024-03-08T07:28:43.277Z"
+  "updatedAt": "2024-03-19T06:40:55.474Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index 9d5d4d11..cab6b31e 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -31,7 +31,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.2"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2024-03-08T07:28:44.330Z"
+  "updatedAt": "2024-03-19T06:40:56.694Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/simple_covenant.json b/packages/cashscript/test/fixture/simple_covenant.json
index e1e8f0d2..50f98d7f 100644
--- a/packages/cashscript/test/fixture/simple_covenant.json
+++ b/packages/cashscript/test/fixture/simple_covenant.json
@@ -17,7 +17,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.2"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2024-03-08T07:28:43.800Z"
+  "updatedAt": "2024-03-19T06:40:55.963Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/token_category_comparison.cash b/packages/cashscript/test/fixture/token_category_comparison.cash
new file mode 100644
index 00000000..a4dacfa7
--- /dev/null
+++ b/packages/cashscript/test/fixture/token_category_comparison.cash
@@ -0,0 +1,5 @@
+contract Test() {
+    function send() {
+        require(tx.inputs[1].tokenCategory == 0x);
+    }
+}
diff --git a/packages/cashscript/test/fixture/token_category_comparison.json b/packages/cashscript/test/fixture/token_category_comparison.json
new file mode 100644
index 00000000..2cd5d9ef
--- /dev/null
+++ b/packages/cashscript/test/fixture/token_category_comparison.json
@@ -0,0 +1,23 @@
+{
+  "contractName": "Test",
+  "constructorInputs": [],
+  "abi": [
+    {
+      "name": "send",
+      "inputs": []
+    }
+  ],
+  "bytecode": "OP_1 OP_UTXOTOKENCATEGORY OP_0 OP_EQUAL",
+  "source": "contract Test() {\n    function send() {\n        require(tx.inputs[1].tokenCategory == 0x);\n    }\n}\n",
+  "debug": {
+    "bytecode": "51ce0087",
+    "sourceMap": "3:26:3:27;:16::42;:46::48;:16:::1",
+    "logs": [],
+    "requireMessages": []
+  },
+  "compiler": {
+    "name": "cashc",
+    "version": "0.10.0-next.3"
+  },
+  "updatedAt": "2024-03-19T06:40:56.440Z"
+}
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index bd14c019..2ce57cd9 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -44,7 +44,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.2"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2024-03-08T07:28:44.062Z"
+  "updatedAt": "2024-03-19T06:40:56.204Z"
 }
\ No newline at end of file

From e8604dc6636f0af916e90e0689a6caa2ee23e86a Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 26 Mar 2024 18:05:04 +0800
Subject: [PATCH 033/267] JestExtensions + debugging test updates

- Handle case where no console.logs are called for expect().toLog()
- Display *all* console.logs in the 'Received' message for expect().toLog()
- Add tests for NOT logging console.log statements in earlier functions / branches
- Improve require message tests to check that it does not show incorrect messages
- Add JestExtensions tests that test the correct behaviour of the test framework

Note: JestExtensions tests are still failing, as are some of the new
console.log tests. We need to fix this in the debugTemplate() function.
---
 .../cashscript/src/test/JestExtensions.ts     |  35 ++--
 packages/cashscript/test/debugging.test.ts    | 176 ++++++++++++++++--
 2 files changed, 183 insertions(+), 28 deletions(-)

diff --git a/packages/cashscript/src/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
index dfe50050..d451e3d4 100644
--- a/packages/cashscript/src/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -28,31 +28,24 @@ expect.extend({
     try {
       await transaction.debug();
     } catch {}
-    let message: string = '';
-
-    const failMessage = (received: string, expected: RegExp | string) => () => `${matcherHint(
-      '.toLog',
-      'received',
-      'expected',
-    )}
-
-Expected: ${printExpected(expected)}
-Received: ${printReceived(received)}`;
+    let error: string = '';
 
     try {
       expect(spyOnLoggerError).toBeCalledWith(expect.stringMatching(match));
-    } catch (error) {
-      message = error as any;
+    } catch (e) {
+      error = e as any;
     }
 
-    // TODO: If no console.log was called, then spyOnLoggerError.mock.calls[0] is undefined.
-    // We should handle that case properly.
-    const received = spyOnLoggerError.mock.calls[0][0];
+    // We concatenate all the logs into a single string - if no logs are present, we set received to undefined
+    const receivedBase = spyOnLoggerError.mock.calls.reduce((acc, [log]) => `${acc}\n${log}`, '').trim();
+    const received = receivedBase === '' ? undefined : receivedBase;
+
     spyOnLoggerError.mockClear();
 
     return {
       message: failMessage(received, match),
-      pass: !message,
+      // message: () =>'Hello',
+      pass: !error,
     };
   },
 });
@@ -108,3 +101,13 @@ Contract function did not fail a require statement`;
     };
   },
 });
+
+// TODO: Update to have the same failMessage function for .toLog and .toFailRequireWith
+const failMessage = (received?: string, expected?: RegExp | string) => () => `${matcherHint(
+  '.toLog',
+  'received',
+  'expected',
+)}
+
+Expected: ${printExpected(expected)}
+Received: ${printReceived(received)}`;
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 81b258b4..922378fb 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -9,9 +9,11 @@ import { binToHex } from '@bitauth/libauth';
 
 describe('Debugging tests', () => {
   describe('console.log statements', () => {
+
     const BASE_CONTRACT_CODE = `
       contract Test(pubkey owner) {
         function transfer(sig ownerSig, int num) {
+          console.log('Hello First Function');
           require(checkSig(ownerSig, owner));
 
           bytes2 beef = 0xbeef;
@@ -21,6 +23,25 @@ describe('Debugging tests', () => {
 
           require(num == 1000);
         }
+
+        function secondFunction() {
+          console.log("Hello Second Function");
+          require(1 == 1);
+        }
+
+        function functionWithIfStatement(int a) {
+          if (a == 1) {
+            console.log("a is 1");
+          } else {
+            console.log("a is not 1");
+          }
+
+          require(1 == 1);
+        }
+
+        function noLogs() {
+          require(1 == 1);
+        }
       }
     `;
 
@@ -36,7 +57,7 @@ describe('Debugging tests', () => {
         .to(contract.address, 10000n);
 
       // console.log(ownerSig, owner, num, beef, 1, "test", true);
-      const expectedLog = new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
+      const expectedLog = new RegExp(`^Test.cash:10 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
       await expect(transaction).toLog(expectedLog);
     });
 
@@ -50,7 +71,7 @@ describe('Debugging tests', () => {
         .to(contract.address, 10000n);
 
       // console.log(ownerSig, owner, num, beef, 1, "test", true);
-      const expectedLog = new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100 0xbeef 1 test true$`);
+      const expectedLog = new RegExp(`^Test.cash:10 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100 0xbeef 1 test true$`);
       await expect(transaction).toLog(expectedLog);
     });
 
@@ -63,14 +84,39 @@ describe('Debugging tests', () => {
         .transfer(new SignatureTemplate(incorrectPriv), 1000n)
         .to(contract.address, 10000n);
 
-      // TODO: This is a super ugly test, we should fix this by improving the JestExtensions
-      try {
-        const expectedLog = new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
-        await expect(transaction).toLog(expectedLog);
-        throw new Error('Expected to fail');
-      } catch (e) {
-        if ((e as any)?.message === 'Expected to fail') throw e;
-      }
+      const expectedLog = new RegExp(`^Test.cash:10 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
+      await expect(transaction).not.toLog(expectedLog);
+    });
+
+    it('should only log console.log statements from the called function', async () => {
+      const contract = new Contract(artifact, [alicePub], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions
+        .secondFunction()
+        .to(contract.address, 10000n);
+
+      await expect(transaction).toLog(new RegExp('^Test.cash:14 Hello Second Function$'));
+      await expect(transaction).not.toLog(/Hello First Function/);
+    });
+
+    it('should only log console.log statements from the chosen branch in if-statement', async () => {
+      const contract = new Contract(artifact, [alicePub], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction1 = contract.functions
+        .functionWithIfStatement(1n)
+        .to(contract.address, 10000n);
+
+      await expect(transaction1).toLog(new RegExp('^Test.cash:21 a is 1$'));
+      await expect(transaction1).not.toLog(/a is not 1/);
+
+      const transaction2 = contract.functions
+        .functionWithIfStatement(2n)
+        .to(contract.address, 10000n);
+
+      await expect(transaction2).toLog(new RegExp('^Test.cash:23 a is not 1$'));
+      await expect(transaction2).not.toLog(/a is 1/);
     });
 
     it('should log multiple consecutive console.log statements on a single line', async () => {
@@ -169,20 +215,22 @@ describe('Debugging tests', () => {
     const artifact = compileString(code);
     const provider = new MockNetworkProvider();
 
-    it('should fail with correct error message when there are multiple require statements', async () => {
+    it('should only fail with correct error message when there are multiple require statements', async () => {
       const contract = new Contract(artifact, [alicePub, bobPub, 2000000n], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.timeout(new SignatureTemplate(bobPriv)).to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith(/sigcheck custom fail/);
+      await expect(transaction).not.toFailRequireWith(/timecheck custom fail/);
     });
 
-    it('should fail with correct error message for timecheck require statemen when there are multiple require statements', async () => {
+    it('should only fail with correct error message for timecheck require statement when there are multiple require statements', async () => {
       const contract = new Contract(artifact, [alicePub, bobPub, 1000000n], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.timeout(new SignatureTemplate(alicePriv)).to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith(/timecheck custom fail/);
+      await expect(transaction).not.toFailRequireWith(/sigcheck custom fail/);
     });
 
     it('should fail with correct error message for the final require statement', async () => {
@@ -201,4 +249,108 @@ describe('Debugging tests', () => {
       await expect(transaction).not.toFailRequireWith(/.*/);
     });
   });
+
+  describe('JestExtensions', () => {
+    const CONTRACT_CODE = `
+      contract Test() {
+        function test_logs() {
+          console.log("Hello World");
+          require(1 == 2);
+        }
+
+        function test_no_logs() {
+          require(1 == 2);
+        }
+
+        function test_require() {
+          require(1 == 2, "1 should equal 2");
+        }
+
+        function test_require_no_failure() {
+          require(1 == 1, "1 should equal 1");
+        }
+      }
+    `;
+
+    const artifact = compileString(CONTRACT_CODE);
+    const provider = new MockNetworkProvider();
+
+    it('should fail the JestExtensions test if an incorrect log is expected', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions
+        .test_logs()
+        .to(contract.address, 10000n);
+
+      const incorrectExpectedLog = new RegExp('^This is definitely not the log$');
+
+      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
+      await expect(
+        expect(transaction).toLog(incorrectExpectedLog),
+      ).rejects.toThrow(/Expected: .*This is definitely not the log.*\nReceived: .*Test.cash:4 Hello World/);
+    });
+
+    // TODO: Investigate why it still logs, even though we call test_no_logs()
+    it('should fail the JestExtensions test if a log is expected where no log is logged', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions
+        .test_no_logs()
+        .to(contract.address, 10000n);
+
+      const incorrectExpectedLog = new RegExp('Hello World');
+
+      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
+      await expect(
+        expect(transaction).toLog(incorrectExpectedLog),
+      ).rejects.toThrow(/Expected: .*Hello World.*\nReceived: undefined/);
+    });
+
+    it('[WIP] should fail the JestExtensions test if a log is expected where no log is logged', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = await contract.functions
+        .test_no_logs()
+        .to(contract.address, 10000n)
+        .debug();
+
+      console.log(transaction);
+    });
+
+    it('should fail the JestExtensions test if an incorrect require error message is expected', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions
+        .test_require()
+        .to(contract.address, 10000n);
+
+      const incorrectExpectedRequire = new RegExp('1 should equal 3');
+
+      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
+      await expect(
+        expect(transaction).toFailRequireWith(incorrectExpectedRequire),
+      ).rejects.toThrow(/Expected: .*1 should equal 3.*\nReceived: .*1 should equal 2.*/);
+    });
+
+
+    it('should fail the JestExtensions test if a require error message is expected where no error is thrown', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions
+        .test_require_no_failure()
+        .to(contract.address, 10000n);
+
+      const incorrectExpectedRequire = new RegExp('1 should equal 3');
+
+      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
+      await expect(
+        expect(transaction).toFailRequireWith(incorrectExpectedRequire),
+      ).rejects.toThrow(/Expected: .*1 should equal 3.*\nReceived: undefined/);
+    });
+  });
 });

From 0504e922f1202567a6611872357c22d3fed40e80 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 12 Apr 2024 16:46:56 +0800
Subject: [PATCH 034/267] Fix bug in console.log statement handling

---
 packages/cashscript/src/LibauthTemplate.ts | 93 ++++++++++++----------
 packages/cashscript/src/utils.ts           |  9 +++
 packages/cashscript/test/debugging.test.ts |  8 +-
 packages/utils/src/artifact.ts             |  9 ++-
 4 files changed, 74 insertions(+), 45 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 7beb0860..fec2eb29 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -1,5 +1,16 @@
 import {
-  AbiFunction, Artifact, Op, PrimitiveType, bytecodeToScript, decodeBool, decodeInt, decodeString, formatBitAuthScript,
+  AbiFunction,
+  Artifact,
+  LogData,
+  LogEntry,
+  Op,
+  PrimitiveType,
+  StackItem,
+  bytecodeToScript,
+  decodeBool,
+  decodeInt,
+  decodeString,
+  formatBitAuthScript,
 } from '@cashscript/utils';
 import {
   hash160,
@@ -34,7 +45,7 @@ import {
 import { Argument, encodeArgument as csEncodeArgument } from './Argument.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
-import { toRegExp } from './utils.js';
+import { findLastIndex, toRegExp } from './utils.js';
 
 // all bitauth variables must be in snake case
 const snakeCase = (str: string): string => (
@@ -532,47 +543,21 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
 
   const debugResult = vm.debug(program);
 
-  for (const log of artifact.debug?.logs ?? []) {
-    // there might be 2 elements with same instruction pointer, first from unllocking script, second from locking
-    const state = debugResult
-      .filter((debugState: AuthenticationProgramStateBCHCHIPs) => debugState.ip === log.ip)!
-      .slice().reverse()[0];
+  // P2SH executions have 3 phases, we only want the last one (locking script execution)
+  // https://libauth.org/types/AuthenticationVirtualMachine.html#__type.debug
+  const lockingScriptDebugResult = debugResult.slice(findLastIndex(debugResult, (state) => state.ip === 0));
 
-    if (!state) {
-      throw Error(`Instruction pointer ${log.ip} points to a non-existing state of the program`);
-    }
-
-    let line = `${artifact.contractName}.cash:${log.line}`;
-    log.data.forEach((element) => {
-      let value: any;
-      if (typeof element === 'string') {
-        value = element;
-      } else {
-        const stackItem = state.stack.slice().reverse()[element.stackIndex];
-        if (!stackItem) {
-          throw Error(`Stack item at index ${element.stackIndex} not found at instruction pointer ${log.ip}`);
-        }
-        switch (element.type) {
-          case PrimitiveType.BOOL:
-            value = decodeBool(stackItem);
-            break;
-          case PrimitiveType.INT:
-            value = decodeInt(stackItem);
-            break;
-          case PrimitiveType.STRING:
-            value = decodeString(stackItem);
-            break;
-          default:
-            value = `0x${binToHex(stackItem)}`;
-            break;
-        }
-      }
+  // The controlStack determines whether the current debug step is in the executed branch
+  // https://libauth.org/types/AuthenticationProgramStateControlStack.html
+  const executedDebugSteps = lockingScriptDebugResult
+    .filter((debugStep) => debugStep.controlStack.every(item => item === true));
 
-      line += ` ${value}`;
-    });
+  const executedLogs = (artifact.debug?.logs ?? [])
+    .filter((debugStep) => executedDebugSteps.some((log) => log.ip === debugStep.ip));
 
-    // actual log, do not delete :)
-    console.log(line);
+  for (const log of executedLogs) {
+    const correspondingDebugStep = executedDebugSteps.find((debugStep) => debugStep.ip === log.ip)!;
+    logConsoleLogStatement(log, correspondingDebugStep, artifact);
   }
 
   const lastState = debugResult[debugResult.length - 1];
@@ -602,6 +587,7 @@ ${lastState.error}`;
 
       const lastMessage = artifact.debug?.requireMessages.sort((a, b) => b.ip - a.ip)[0];
       if (!lastMessage) {
+        // TODO: Throw an ERROR instead of string
         // eslint-disable-next-line
         throw evaluationResult + stackContentsMessage;
       }
@@ -622,3 +608,30 @@ ${evaluationResult.replace(/Error in evaluating input index \d: /, '')}` + stack
 
   return debugResult;
 };
+
+const logConsoleLogStatement = (
+  log: LogEntry,
+  debugStep: AuthenticationProgramStateBCHCHIPs,
+  artifact: Artifact,
+): void => {
+  let line = `${artifact.contractName}.cash:${log.line}`;
+  const decodedData = log.data.map((element) => decodeLogData(element, debugStep.stack, log.ip));
+  console.log(`${line} ${decodedData.join(' ')}`);
+};
+
+const decodeLogData = (element: LogData, stack: Uint8Array[], ip: number): any => {
+  if (typeof element === 'string') return element;
+
+  // Reversed since stack is in reverse order
+  const stackItem = [...stack].reverse()[element.stackIndex];
+
+  if (!stackItem) {
+    throw Error(`Stack item at index ${(element as StackItem).stackIndex} not found at instruction pointer ${ip}`);
+  }
+
+  if (element.type === PrimitiveType.BOOL) return decodeBool(stackItem);
+  if (element.type === PrimitiveType.INT) return decodeInt(stackItem);
+  if (element.type === PrimitiveType.STRING) return decodeString(stackItem);
+
+  return `0x${binToHex(stackItem)}`;
+};
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index cff75067..0569d6aa 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -367,3 +367,12 @@ export const randomNFT = (defaults?: Partial<TokenDetails>): TokenDetails => ({
   },
   ...defaults,
 });
+
+// https://stackoverflow.com/questions/40929260/find-last-index-of-element-inside-array-by-certain-condition
+export function findLastIndex<T>(array: Array<T>, predicate: (value: T, index: number, obj: T[]) => boolean): number {
+  let l = array.length;
+  while (l--) {
+    if (predicate(array[l], l, array)) return l;
+  }
+  return -1;
+}
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 922378fb..380ac525 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -9,7 +9,7 @@ import { binToHex } from '@bitauth/libauth';
 
 describe('Debugging tests', () => {
   describe('console.log statements', () => {
-
+    // TODO: Double check if multiple console.log statements are two separate entries in the artifact OR one single one
     const BASE_CONTRACT_CODE = `
       contract Test(pubkey owner) {
         function transfer(sig ownerSig, int num) {
@@ -96,7 +96,7 @@ describe('Debugging tests', () => {
         .secondFunction()
         .to(contract.address, 10000n);
 
-      await expect(transaction).toLog(new RegExp('^Test.cash:14 Hello Second Function$'));
+      await expect(transaction).toLog(new RegExp('^Test.cash:16 Hello Second Function$'));
       await expect(transaction).not.toLog(/Hello First Function/);
     });
 
@@ -108,14 +108,14 @@ describe('Debugging tests', () => {
         .functionWithIfStatement(1n)
         .to(contract.address, 10000n);
 
-      await expect(transaction1).toLog(new RegExp('^Test.cash:21 a is 1$'));
+      await expect(transaction1).toLog(new RegExp('^Test.cash:22 a is 1$'));
       await expect(transaction1).not.toLog(/a is not 1/);
 
       const transaction2 = contract.functions
         .functionWithIfStatement(2n)
         .to(contract.address, 10000n);
 
-      await expect(transaction2).toLog(new RegExp('^Test.cash:23 a is not 1$'));
+      await expect(transaction2).toLog(new RegExp('^Test.cash:24 a is not 1$'));
       await expect(transaction2).not.toLog(/a is 1/);
     });
 
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index 54952783..d3735c46 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -21,9 +21,16 @@ export interface DebugInformation {
 export interface LogEntry {
   ip: number; // instruction pointer
   line: number; // line in the source code
-  data: Array<{ stackIndex: number, type: string } | string>; // data to be logged
+  data: Array<LogData>; // data to be logged
 }
 
+export interface StackItem {
+  type: string;
+  stackIndex: number;
+}
+
+export type LogData = StackItem | string;
+
 export interface RequireMessage {
   ip: number; // instruction pointer
   line: number; // line in the source code

From 01ecfaee2ced80bf4334cf3da75e2314849a2e1f Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 12 Apr 2024 17:00:43 +0800
Subject: [PATCH 035/267] Do NOT merge separate console.log statements into a
 single line

---
 .../src/generation/GenerateTargetTraversal.ts | 19 ++++++-------------
 packages/cashscript/test/debugging.test.ts    | 10 +++++-----
 2 files changed, 11 insertions(+), 18 deletions(-)

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 048751d1..8d172674 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -310,26 +310,19 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     const ip = this.getCurrentInstructionPointer();
     const { line } = node.location.start;
 
-    // TODO: refactor to use a map instead of array (also in the artifact and other places where console logs and
-    // require statements are used)
-    // check if log entry exists for the instruction pointer, create if not
-    // TODO: Do we really want to merge different console logs at the same instruction pointer?
-    let index = this.consoleLogs.findIndex((entry: LogEntry) => entry.ip === ip);
-    if (index === -1) {
-      index = this.consoleLogs.push({ ip, line, data: [] }) - 1;
-    }
-
-    node.parameters.forEach((parameter: ConsoleParameterNode) => {
+    const data = node.parameters.map((parameter: ConsoleParameterNode) => {
       if (parameter instanceof IdentifierNode) {
         const symbol = parameter.definition!;
         const stackIndex = this.getStackIndex(parameter.name);
         const type = typeof symbol.type === 'string' ? symbol.type : symbol.toString();
-        this.consoleLogs[index].data.push({ stackIndex, type });
-      } else {
-        this.consoleLogs[index].data.push(parameter.toString());
+        return { stackIndex, type };
       }
+
+      return parameter.toString();
     });
 
+    this.consoleLogs.push({ ip, line, data });
+
     return node;
   }
 
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 380ac525..c6f0107c 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -9,7 +9,6 @@ import { binToHex } from '@bitauth/libauth';
 
 describe('Debugging tests', () => {
   describe('console.log statements', () => {
-    // TODO: Double check if multiple console.log statements are two separate entries in the artifact OR one single one
     const BASE_CONTRACT_CODE = `
       contract Test(pubkey owner) {
         function transfer(sig ownerSig, int num) {
@@ -119,7 +118,7 @@ describe('Debugging tests', () => {
       await expect(transaction2).not.toLog(/a is 1/);
     });
 
-    it('should log multiple consecutive console.log statements on a single line', async () => {
+    it('should log multiple consecutive console.log statements on separate lines', async () => {
       const contractCode = `
         contract Test(pubkey owner) {
           function transfer(sig ownerSig, int num) {
@@ -146,9 +145,10 @@ describe('Debugging tests', () => {
         .transfer(new SignatureTemplate(alicePriv), incorrectNum)
         .to(contract.address, 10000n);
 
-      // console.log(ownerSig, owner, num, beef, 1, "test", true);
-      const expectedLog = new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100 0xbeef 1 test true$`);
-      await expect(transaction).toLog(expectedLog);
+      // console.log(ownerSig, owner, num, beef);
+      await expect(transaction).toLog(new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100$`));
+      // console.log(1, "test", true)
+      await expect(transaction).toLog(new RegExp('^Test.cash:10 0xbeef 1 test true$'));
     });
 
     it('should log multiple console.log statements with other statements in between', async () => {

From d0594d0f5e7972739988bcf48837c3b74dda4701 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Sun, 14 Apr 2024 16:52:43 +0800
Subject: [PATCH 036/267] Fix bugs in require statement message handling and
 add a bunch of tests

---
 .../src/generation/GenerateTargetTraversal.ts |  18 +-
 packages/cashscript/src/LibauthTemplate.ts    | 163 -------------
 packages/cashscript/src/Transaction.ts        |   6 +-
 packages/cashscript/src/debugging.ts          | 167 +++++++++++++
 .../cashscript/src/test/JestExtensions.ts     |   2 +-
 packages/cashscript/test/debugging.test.ts    | 222 ++++++++++++------
 6 files changed, 326 insertions(+), 252 deletions(-)
 create mode 100644 packages/cashscript/src/debugging.ts

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 8d172674..7513b291 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -275,10 +275,12 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     node.expression = this.visit(node.expression);
     this.emit(compileTimeOp(node.timeOp), { location: node.location, positionHint: PositionHint.END });
 
-    // add debug require message
+    // TODO: Same comment as in require
     if (node.message) {
       this.requireMessages.push({
-        ip: this.getCurrentInstructionPointer() - 1, // TODO: Why is there a minus 1 here?
+        // We're removing 1 from the IP because the error message needs to match the OP_XXX_VERIFY, not the OP_DROP that
+        // is emitted directly after
+        ip: this.getCurrentInstructionPointer() - 1,
         line: node.location.start.line,
         message: node.message,
       });
@@ -293,10 +295,12 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
     this.emit(Op.OP_VERIFY, { location: node.location, positionHint: PositionHint.END });
 
-    // add debug require message
+    // TODO: Add *all* require messages to the artifact, so we can report on line number for the failed require(),
+    // even if there is no message in the require() call
+    // TODO: We don't even have to display the Libauth message if we just say "this and this require failed"
     if (node.message) {
       this.requireMessages.push({
-        ip: this.getCurrentInstructionPointer() - 1, // TODO: Why is there a minus 1 here?
+        ip: this.getCurrentInstructionPointer(),
         line: node.location.start.line,
         message: node.message,
       });
@@ -335,13 +339,13 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
     let stackDepth = this.stack.length;
     node.ifBlock = this.visit(node.ifBlock);
-    this.removeScopedVariables(stackDepth, node);
+    this.removeScopedVariables(stackDepth, node.ifBlock);
 
     if (node.elseBlock) {
       this.emit(Op.OP_ELSE, { location: node.elseBlock.location });
       stackDepth = this.stack.length;
       node.elseBlock = this.visit(node.elseBlock);
-      this.removeScopedVariables(stackDepth, node);
+      this.removeScopedVariables(stackDepth, node.elseBlock);
     }
 
     const endLocationData = {
@@ -358,7 +362,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   removeScopedVariables(depthBeforeScope: number, node: Node): void {
     const dropCount = this.stack.length - depthBeforeScope;
     for (let i = 0; i < dropCount; i += 1) {
-      this.emit(Op.OP_DROP, { location: node.location });
+      this.emit(Op.OP_DROP, { location: node.location, positionHint: PositionHint.END });
       this.popFromStack();
     }
   }
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index fec2eb29..225e714d 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -1,15 +1,7 @@
 import {
   AbiFunction,
-  Artifact,
-  LogData,
-  LogEntry,
-  Op,
   PrimitiveType,
-  StackItem,
   bytecodeToScript,
-  decodeBool,
-  decodeInt,
-  decodeString,
   formatBitAuthScript,
 } from '@cashscript/utils';
 import {
@@ -22,17 +14,9 @@ import {
   WalletTemplate,
   WalletTemplateScenarioInput,
   TransactionBCH,
-  walletTemplateToCompilerConfiguration,
-  createCompiler,
-  createVirtualMachineBCHCHIPs,
   binToBase64,
   utf8ToBin,
   isHex,
-  AuthenticationProgramStateBCHCHIPs,
-  AuthenticationProgramCommon,
-  AuthenticationVirtualMachine,
-  ResolvedTransactionCommon,
-  AuthenticationErrorCommon,
   WalletTemplateScenarioOutput,
 } from '@bitauth/libauth';
 import { deflate } from 'pako';
@@ -45,7 +29,6 @@ import {
 import { Argument, encodeArgument as csEncodeArgument } from './Argument.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
-import { findLastIndex, toRegExp } from './utils.js';
 
 // all bitauth variables must be in snake case
 const snakeCase = (str: string): string => (
@@ -489,149 +472,3 @@ export const getBitauthUri = (template: WalletTemplate): string => {
   );
   return `https://ide.bitauth.com/import-template/${payload}`;
 };
-
-type VM = AuthenticationVirtualMachine<
-ResolvedTransactionCommon,
-AuthenticationProgramCommon,
-AuthenticationProgramStateBCHCHIPs
->;
-type Program = AuthenticationProgramCommon;
-type CreateProgramResult = { vm: VM, program: Program };
-
-// internal util. instantiates the virtual machine and compiles the template into a program
-const createProgram = (template: WalletTemplate): CreateProgramResult => {
-  const configuration = walletTemplateToCompilerConfiguration(template);
-  const vm = createVirtualMachineBCHCHIPs();
-  const compiler = createCompiler(configuration);
-
-  const scenarioGeneration = compiler.generateScenario({
-    debug: true,
-    lockingScriptId: undefined,
-    unlockingScriptId: 'unlock_lock',
-    scenarioId: 'evaluate_function',
-  });
-
-  if (
-    typeof scenarioGeneration === 'string'
-    || typeof scenarioGeneration.scenario === 'string'
-  ) {
-    // eslint-disable-next-line
-    throw scenarioGeneration;
-  }
-
-  return { vm, program: scenarioGeneration.scenario.program };
-};
-
-// evaluates the fully defined template, throws upon error
-export const evaluateTemplate = (template: WalletTemplate): boolean => {
-  const { vm, program } = createProgram(template);
-
-  const verifyResult = vm.verify(program);
-  if (typeof verifyResult === 'string') {
-    // eslint-disable-next-line
-    throw verifyResult;
-  }
-
-  return verifyResult;
-};
-
-export type DebugResult = AuthenticationProgramStateBCHCHIPs[];
-
-// debugs the template, optionally logging the execution data
-export const debugTemplate = (template: WalletTemplate, artifact: Artifact): DebugResult => {
-  const { vm, program } = createProgram(template);
-
-  const debugResult = vm.debug(program);
-
-  // P2SH executions have 3 phases, we only want the last one (locking script execution)
-  // https://libauth.org/types/AuthenticationVirtualMachine.html#__type.debug
-  const lockingScriptDebugResult = debugResult.slice(findLastIndex(debugResult, (state) => state.ip === 0));
-
-  // The controlStack determines whether the current debug step is in the executed branch
-  // https://libauth.org/types/AuthenticationProgramStateControlStack.html
-  const executedDebugSteps = lockingScriptDebugResult
-    .filter((debugStep) => debugStep.controlStack.every(item => item === true));
-
-  const executedLogs = (artifact.debug?.logs ?? [])
-    .filter((debugStep) => executedDebugSteps.some((log) => log.ip === debugStep.ip));
-
-  for (const log of executedLogs) {
-    const correspondingDebugStep = executedDebugSteps.find((debugStep) => debugStep.ip === log.ip)!;
-    logConsoleLogStatement(log, correspondingDebugStep, artifact);
-  }
-
-  const lastState = debugResult[debugResult.length - 1];
-  if (lastState.error) {
-    const requireMessage = (artifact.debug?.requireMessages ?? []).filter((message) => message.ip === lastState.ip)[0];
-    if (requireMessage) {
-      // eslint-disable-next-line
-      throw `${artifact.contractName}.cash:${requireMessage.line} Error in evaluating input index ${lastState.program.inputIndex} with the following message: ${requireMessage.message}.
-${lastState.error}`;
-    } else {
-      // eslint-disable-next-line
-      throw `Error in evaluating input index ${lastState.program.inputIndex}.
-${lastState.error}`;
-    }
-  } else {
-    // one last pass of verifications not covered by the above debugging
-    // checks for removed final verify
-    const evaluationResult = vm.verify(program);
-
-    if (typeof evaluationResult === 'string' && toRegExp([
-      AuthenticationErrorCommon.requiresCleanStack,
-      AuthenticationErrorCommon.nonEmptyControlStack,
-      AuthenticationErrorCommon.unsuccessfulEvaluation,
-    ]).test(evaluationResult)) {
-      const stackContents = lastState.stack.map(item => `0x${binToHex(item)}`).join(', ');
-      const stackContentsMessage = `\nStack contents after evaluation: ${lastState.stack.length ? stackContents : 'empty'}`;
-
-      const lastMessage = artifact.debug?.requireMessages.sort((a, b) => b.ip - a.ip)[0];
-      if (!lastMessage) {
-        // TODO: Throw an ERROR instead of string
-        // eslint-disable-next-line
-        throw evaluationResult + stackContentsMessage;
-      }
-
-      const instructionsLeft = lastState.instructions.slice(lastMessage.ip);
-      if (instructionsLeft.length === 0
-          || instructionsLeft.every(instruction => [Op.OP_NIP, Op.OP_ENDIF].includes(instruction.opcode))
-      ) {
-        // eslint-disable-next-line
-        throw `${artifact.contractName}.cash:${lastMessage.line} Error in evaluating input index ${lastState.program.inputIndex} with the following message: ${lastMessage.message}.
-${evaluationResult.replace(/Error in evaluating input index \d: /, '')}` + stackContentsMessage;
-      }
-
-      // eslint-disable-next-line
-      throw evaluationResult + stackContentsMessage;
-    }
-  }
-
-  return debugResult;
-};
-
-const logConsoleLogStatement = (
-  log: LogEntry,
-  debugStep: AuthenticationProgramStateBCHCHIPs,
-  artifact: Artifact,
-): void => {
-  let line = `${artifact.contractName}.cash:${log.line}`;
-  const decodedData = log.data.map((element) => decodeLogData(element, debugStep.stack, log.ip));
-  console.log(`${line} ${decodedData.join(' ')}`);
-};
-
-const decodeLogData = (element: LogData, stack: Uint8Array[], ip: number): any => {
-  if (typeof element === 'string') return element;
-
-  // Reversed since stack is in reverse order
-  const stackItem = [...stack].reverse()[element.stackIndex];
-
-  if (!stackItem) {
-    throw Error(`Stack item at index ${(element as StackItem).stackIndex} not found at instruction pointer ${ip}`);
-  }
-
-  if (element.type === PrimitiveType.BOOL) return decodeBool(stackItem);
-  if (element.type === PrimitiveType.INT) return decodeInt(stackItem);
-  if (element.type === PrimitiveType.STRING) return decodeString(stackItem);
-
-  return `0x${binToHex(stackItem)}`;
-};
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 16b8cd69..085bca66 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -40,10 +40,8 @@ import { P2PKH_INPUT_SIZE } from './constants.js';
 import { TransactionBuilder } from './TransactionBuilder.js';
 import { Contract } from './Contract.js';
 import MockNetworkProvider from './network/MockNetworkProvider.js';
-import {
-  DebugResult,
-  buildTemplate, debugTemplate, evaluateTemplate, getBitauthUri,
-} from './LibauthTemplate.js';
+import { buildTemplate, getBitauthUri } from './LibauthTemplate.js';
+import { debugTemplate, evaluateTemplate, DebugResult } from './debugging.js';
 
 export class Transaction {
   public inputs: Utxo[] = [];
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
new file mode 100644
index 00000000..16518ef6
--- /dev/null
+++ b/packages/cashscript/src/debugging.ts
@@ -0,0 +1,167 @@
+import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateBCHCHIPs, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBCHCHIPs, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
+import { Artifact, LogData, LogEntry, Op, PrimitiveType, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
+import { findLastIndex, toRegExp } from './utils.js';
+
+// evaluates the fully defined template, throws upon error
+export const evaluateTemplate = (template: WalletTemplate): boolean => {
+  const { vm, program } = createProgram(template);
+
+  const verifyResult = vm.verify(program);
+  if (typeof verifyResult === 'string') {
+    throw new Error(verifyResult);
+  }
+
+  return verifyResult;
+};
+
+export type DebugResult = AuthenticationProgramStateBCHCHIPs[];
+
+// debugs the template, optionally logging the execution data
+export const debugTemplate = (template: WalletTemplate, artifact: Artifact): DebugResult => {
+  const { vm, program } = createProgram(template);
+
+  const fullDebugSteps = vm.debug(program);
+
+  // P2SH executions have 3 phases, we only want the last one (locking script execution)
+  // https://libauth.org/types/AuthenticationVirtualMachine.html#__type.debug
+  const lockingScriptDebugResult = fullDebugSteps.slice(findLastIndex(fullDebugSteps, (state) => state.ip === 0));
+
+  // The controlStack determines whether the current debug step is in the executed branch
+  // https://libauth.org/types/AuthenticationProgramStateControlStack.html
+  const executedDebugSteps = lockingScriptDebugResult
+    .filter((debugStep) => debugStep.controlStack.every(item => item === true));
+
+  const executedLogs = (artifact.debug?.logs ?? [])
+    .filter((debugStep) => executedDebugSteps.some((log) => log.ip === debugStep.ip));
+
+  for (const log of executedLogs) {
+    const correspondingDebugStep = executedDebugSteps.find((debugStep) => debugStep.ip === log.ip)!;
+    logConsoleLogStatement(log, correspondingDebugStep, artifact);
+  }
+
+  const lastExecutedDebugStep = executedDebugSteps[executedDebugSteps.length - 1];
+
+  // If an error is present in the last step, that means a require statement in the middle of the function failed
+  if (lastExecutedDebugStep.error) {
+    const requireStatement = (artifact.debug?.requireMessages ?? [])
+      .find((message) => message.ip === lastExecutedDebugStep.ip);
+
+    if (requireStatement) {
+      throw new Error(`${artifact.contractName}.cash:${requireStatement.line} Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex} with the following message: ${requireStatement.message}.\n${lastExecutedDebugStep.error}`);
+    }
+
+    throw new Error(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${lastExecutedDebugStep.error}`);
+  }
+
+  const evaluationResult = vm.verify(program);
+
+  if (failedFinalVerify(evaluationResult)) {
+    const stackContents = lastExecutedDebugStep.stack.map(item => `0x${binToHex(item)}`).join(', ');
+    const stackContentsMessage = `\nStack contents after evaluation: ${lastExecutedDebugStep.stack.length ? stackContents : 'empty'}`;
+
+    const executedInstructions = lastExecutedDebugStep.instructions
+      .filter((_, i) => executedDebugSteps.map((step) => step.ip).includes(i));
+
+    const cleanupSize = calculateCleanupSize(executedInstructions);
+    const finalExecutedVerify = executedDebugSteps[executedDebugSteps.length - cleanupSize - 1];
+
+    const finalVerifyMessage = artifact.debug?.requireMessages.find((message) => message.ip === finalExecutedVerify.ip);
+
+    if (finalVerifyMessage) {
+      throw new Error(`${artifact.contractName}.cash:${finalVerifyMessage.line} Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex} with the following message: ${finalVerifyMessage.message}.\n${evaluationResult.replace(/Error in evaluating input index \d: /, '')}` + stackContentsMessage);
+    }
+
+    throw new Error(evaluationResult + stackContentsMessage);
+  }
+
+  return fullDebugSteps;
+};
+
+type VM = AuthenticationVirtualMachine<
+ResolvedTransactionCommon,
+AuthenticationProgramCommon,
+AuthenticationProgramStateBCHCHIPs
+>;
+type Program = AuthenticationProgramCommon;
+type CreateProgramResult = { vm: VM, program: Program };
+
+// internal util. instantiates the virtual machine and compiles the template into a program
+const createProgram = (template: WalletTemplate): CreateProgramResult => {
+  const configuration = walletTemplateToCompilerConfiguration(template);
+  const vm = createVirtualMachineBCHCHIPs();
+  const compiler = createCompiler(configuration);
+
+  const scenarioGeneration = compiler.generateScenario({
+    debug: true,
+    lockingScriptId: undefined,
+    unlockingScriptId: 'unlock_lock',
+    scenarioId: 'evaluate_function',
+  });
+
+  if (typeof scenarioGeneration === 'string') {
+    throw new Error(scenarioGeneration);
+  }
+
+  if (typeof scenarioGeneration.scenario === 'string') {
+    throw new Error(scenarioGeneration.scenario);
+  }
+
+  return { vm, program: scenarioGeneration.scenario.program };
+};
+
+const logConsoleLogStatement = (
+  log: LogEntry,
+  debugStep: AuthenticationProgramStateBCHCHIPs,
+  artifact: Artifact,
+): void => {
+  let line = `${artifact.contractName}.cash:${log.line}`;
+  const decodedData = log.data.map((element) => decodeLogData(element, debugStep.stack, log.ip));
+  console.log(`${line} ${decodedData.join(' ')}`);
+};
+
+const decodeLogData = (element: LogData, stack: Uint8Array[], ip: number): any => {
+  if (typeof element === 'string') return element;
+
+  // Reversed since stack is in reverse order
+  const stackItem = [...stack].reverse()[element.stackIndex];
+
+  if (!stackItem) {
+    throw Error(`Stack item at index ${element.stackIndex} not found at instruction pointer ${ip}`);
+  }
+
+  if (element.type === PrimitiveType.BOOL) return decodeBool(stackItem);
+  if (element.type === PrimitiveType.INT) return decodeInt(stackItem);
+  if (element.type === PrimitiveType.STRING) return decodeString(stackItem);
+
+  return `0x${binToHex(stackItem)}`;
+};
+
+const failedFinalVerify = (evaluationResult: string | true): evaluationResult is string => {
+  // true indicates a successful evaluation (so no failed final verify)
+  if (evaluationResult === true) return false;
+
+  // If any of the following errors occurred, then the final verify failed - any other messages
+  // indicate other kinds of failures
+  return toRegExp([
+    AuthenticationErrorCommon.requiresCleanStack,
+    AuthenticationErrorCommon.nonEmptyControlStack,
+    AuthenticationErrorCommon.unsuccessfulEvaluation,
+  ]).test(evaluationResult);
+};
+
+const calculateCleanupSize = (instructions: AuthenticationInstruction[]): number => {
+  // OP_NIP is used for cleanup at the end of a function, OP_ENDIF and OP_ELSE are the end of branches
+  // We need to remove all of these to get to the actual last executed instruction of a function
+  const cleanupOpcodes = [Op.OP_ENDIF, Op.OP_NIP, Op.OP_ELSE];
+
+  let cleanupSize = 0;
+  for (const instruction of [...instructions].reverse()) {
+    if (cleanupOpcodes.includes(instruction.opcode)) {
+      cleanupSize++;
+    } else {
+      break;
+    }
+  }
+
+  return cleanupSize;
+};
diff --git a/packages/cashscript/src/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
index d451e3d4..2c383895 100644
--- a/packages/cashscript/src/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -69,7 +69,7 @@ expect.extend({
 
 Contract function did not fail a require statement`;
     } catch (error) {
-      message = error as any;
+      message = (error as any)?.message;
     }
 
     // should not have failed
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index c6f0107c..3b00b348 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -1,12 +1,82 @@
 import { compileString } from 'cashc';
 import { Contract, MockNetworkProvider, SignatureTemplate } from '../src/index.js';
 import {
-  alicePriv, alicePub, bobPriv, bobPub,
+  alicePriv, alicePub, bobPriv,
 } from './fixture/vars.js';
 import '../src/test/JestExtensions.js';
 import { randomUtxo } from '../src/utils.js';
 import { binToHex } from '@bitauth/libauth';
 
+const CONTRACT_CODE = `
+contract Test() {
+  function test_logs() {
+    console.log("Hello World");
+    require(1 == 2);
+  }
+
+  function test_no_logs() {
+    require(1 == 2);
+  }
+
+  function test_require() {
+    require(1 == 2, "1 should equal 2");
+  }
+
+  function test_require_no_failure() {
+    require(1 == 1, "1 should equal 1");
+  }
+
+  // TODO: Add test for this
+  function test_multiple_require_statements() {
+    require(1 == 2, "1 should equal 2");
+    require(1 == 1, "1 should equal 1");
+  }
+
+  // TODO: Add test for this
+  function test_multiple_require_statements_final_fails() {
+    require(1 == 1, "1 should equal 1");
+    require(1 == 2, "1 should equal 2");
+  }
+
+  // TODO: Add test for this
+  function test_multiple_require_statements_no_message_final() {
+    require(1 == 1, "1 should equal 1");
+    require(1 == 2);
+  }
+
+  function test_timeops_as_final_require() {
+    require(1 == 1, "1 should equal 1");
+    require(tx.time >= 100000000, "time should be HUGE");
+  }
+
+  function test_final_require_in_if_statement(int switch) {
+    if (switch == 1) {
+      int a = 2;
+      require(1 == a, "1 should equal 2");
+    // TODO: Check if it's better test with or without this else
+    } else if (switch == 2) {
+      int b = 3;
+      require(1 == b, "1 should equal 3");
+    } else {
+      int c = 4;
+      require(switch == c, "switch should equal 4");
+    }
+  }
+
+  function test_final_require_in_if_statement_with_deep_reassignment() {
+    int a = 0;
+    int b = 1;
+    int c = 2;
+    int d = 3;
+    int e = 4;
+    if (a == 0) {
+      a = 10;
+      require(a + b + c + d + e == 10, "sum should equal 10");
+    }
+  }
+}
+`;
+
 describe('Debugging tests', () => {
   describe('console.log statements', () => {
     const BASE_CONTRACT_CODE = `
@@ -189,89 +259,99 @@ describe('Debugging tests', () => {
   });
 
   describe('require statements', () => {
-    const code = `
-    contract TransferWithTimeout(
-        pubkey sender,
-        pubkey recipient,
-        int timeout
-    ) {
-        // Require recipient's signature to match
-        function transfer(sig recipientSig) {
-            require(checkSig(recipientSig, recipient));
-        }
-
-        // Require timeout time to be reached and sender's signature to match
-        function timeout(sig senderSig) {
-            require(checkSig(senderSig, sender), "sigcheck custom fail");
-            require(tx.time >= timeout, "timecheck custom fail");
-        }
-
-        function test(int a) {
-          require(a == 1, "dropped last verify fail");
-        }
-    }
-    `;
-
-    const artifact = compileString(code);
+    const artifact = compileString(CONTRACT_CODE);
     const provider = new MockNetworkProvider();
 
-    it('should only fail with correct error message when there are multiple require statements', async () => {
-      const contract = new Contract(artifact, [alicePub, bobPub, 2000000n], { provider });
+    it('should fail with error message when require statement fails', async () => {
+      const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.timeout(new SignatureTemplate(bobPriv)).to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/sigcheck custom fail/);
-      await expect(transaction).not.toFailRequireWith(/timecheck custom fail/);
+      const transaction = contract.functions.test_require().to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith(/1 should equal 2/);
     });
 
-    it('should only fail with correct error message for timecheck require statement when there are multiple require statements', async () => {
-      const contract = new Contract(artifact, [alicePub, bobPub, 1000000n], { provider });
+    // // test_multiple_require_statements
+    it('it should only fail with correct error message when there are multiple require statements', async () => {
+      const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.timeout(new SignatureTemplate(alicePriv)).to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/timecheck custom fail/);
-      await expect(transaction).not.toFailRequireWith(/sigcheck custom fail/);
+      const transaction = contract.functions.test_multiple_require_statements().to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith(/1 should equal 2/);
+      await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
-    it('should fail with correct error message for the final require statement', async () => {
-      const contract = new Contract(artifact, [alicePub, bobPub, 2000000n], { provider });
+    // // test_multiple_require_statements_final_fails
+    it('it should only fail with correct error message when there are multiple require statements where the final statement fails', async () => {
+      const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.test(0n).to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/dropped last verify fail/);
+      const transaction = contract.functions.test_multiple_require_statements_final_fails().to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith(/1 should equal 2/);
+      await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
     it('should not fail if no require statements fail', async () => {
-      const contract = new Contract(artifact, [alicePub, bobPub, 2000000n], { provider });
+      const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions.transfer(new SignatureTemplate(bobPriv)).to(contract.address, 1000n);
+      const transaction = contract.functions.test_require_no_failure().to(contract.address, 1000n);
+      // TODO: add `toFailRequire` without any arguments to JestExtensions
       await expect(transaction).not.toFailRequireWith(/.*/);
     });
-  });
 
-  describe('JestExtensions', () => {
-    const CONTRACT_CODE = `
-      contract Test() {
-        function test_logs() {
-          console.log("Hello World");
-          require(1 == 2);
-        }
+    // test_multiple_require_statements_no_message_final
+    it('should fail without custom message if the final require statement does not have a message', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
 
-        function test_no_logs() {
-          require(1 == 2);
-        }
+      const transaction = contract.functions
+        .test_multiple_require_statements_no_message_final().to(contract.address, 1000n);
 
-        function test_require() {
-          require(1 == 2, "1 should equal 2");
-        }
+      await expect(transaction).toFailRequireWith(/Error in evaluating input index 0/);
+      await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
+    });
 
-        function test_require_no_failure() {
-          require(1 == 1, "1 should equal 1");
-        }
-      }
-    `;
+    // test_timeops_as_final_require
+    it('should fail with correct error message for the final TimeOp require statement', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_timeops_as_final_require().to(contract.address, 1000n);
+
+      await expect(transaction).toFailRequireWith(/time should be HUGE/);
+      await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
+    });
+
+    // test_final_require_in_if_statement
+    it('should fail with correct error message for the final require statement in an if statement', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transactionIfBranch = contract.functions
+        .test_final_require_in_if_statement(1n).to(contract.address, 1000n);
+      await expect(transactionIfBranch).toFailRequireWith(/1 should equal 2/);
+
+      const transactionElseIfBranch = contract.functions
+        .test_final_require_in_if_statement(2n).to(contract.address, 1000n);
+      await expect(transactionElseIfBranch).toFailRequireWith(/1 should equal 3/);
+
+      const transactionElseBranch = contract.functions
+        .test_final_require_in_if_statement(3n).to(contract.address, 1000n);
+      await expect(transactionElseBranch).toFailRequireWith(/switch should equal 4/);
+    });
+
+    // test_final_require_in_if_statement_with_deep_reassignment
+    it('should fail with correct error message for the final require statement in an if statement with a deep reassignment', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
 
+      const transaction = contract.functions
+        .test_final_require_in_if_statement_with_deep_reassignment().to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith(/sum should equal 10/);
+    });
+  });
+
+  describe('JestExtensions', () => {
     const artifact = compileString(CONTRACT_CODE);
     const provider = new MockNetworkProvider();
 
@@ -291,7 +371,6 @@ describe('Debugging tests', () => {
       ).rejects.toThrow(/Expected: .*This is definitely not the log.*\nReceived: .*Test.cash:4 Hello World/);
     });
 
-    // TODO: Investigate why it still logs, even though we call test_no_logs()
     it('should fail the JestExtensions test if a log is expected where no log is logged', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
@@ -305,19 +384,7 @@ describe('Debugging tests', () => {
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
         expect(transaction).toLog(incorrectExpectedLog),
-      ).rejects.toThrow(/Expected: .*Hello World.*\nReceived: undefined/);
-    });
-
-    it('[WIP] should fail the JestExtensions test if a log is expected where no log is logged', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = await contract.functions
-        .test_no_logs()
-        .to(contract.address, 10000n)
-        .debug();
-
-      console.log(transaction);
+      ).rejects.toThrow(/Expected: .*Hello World.*\nReceived: .*undefined/);
     });
 
     it('should fail the JestExtensions test if an incorrect require error message is expected', async () => {
@@ -331,12 +398,13 @@ describe('Debugging tests', () => {
       const incorrectExpectedRequire = new RegExp('1 should equal 3');
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
+      // TODO: Figure out why this error message says "Received string:" instead of "Received:"
       await expect(
         expect(transaction).toFailRequireWith(incorrectExpectedRequire),
-      ).rejects.toThrow(/Expected: .*1 should equal 3.*\nReceived: .*1 should equal 2.*/);
+      ).rejects.toThrow(/Expected pattern: .*1 should equal 3.*\nReceived string: .*1 should equal 2.*/);
     });
 
-
+    // TODO: Fix this
     it('should fail the JestExtensions test if a require error message is expected where no error is thrown', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
@@ -349,7 +417,7 @@ describe('Debugging tests', () => {
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
-        expect(transaction).toFailRequireWith(incorrectExpectedRequire),
+        await expect(transaction).toFailRequireWith(incorrectExpectedRequire),
       ).rejects.toThrow(/Expected: .*1 should equal 3.*\nReceived: undefined/);
     });
   });

From 8122671873a19a74b4b0627220ff6e9868a54bbb Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 15 Apr 2024 11:40:06 +0800
Subject: [PATCH 037/267] Fix bugs in JestExtensions, refactor and update tests

---
 .../cashscript/src/test/JestExtensions.ts     | 97 ++++++-------------
 packages/cashscript/test/debugging.test.ts    | 67 ++++++++-----
 2 files changed, 72 insertions(+), 92 deletions(-)

diff --git a/packages/cashscript/src/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
index 2c383895..e96cf81d 100644
--- a/packages/cashscript/src/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -1,6 +1,5 @@
 import { MatcherContext } from '@jest/expect';
 import { SyncExpectationResult } from 'expect';
-import { printExpected, printReceived, matcherHint } from 'jest-matcher-utils';
 import { Transaction } from '../index.js';
 
 export {};
@@ -9,7 +8,7 @@ declare global {
   namespace jest {
     // eslint-disable-next-line
     interface Matchers<R> {
-      toLog(value: RegExp | string): Promise<void>;
+      toLog(value?: RegExp | string): Promise<void>;
       toFailRequireWith(value: RegExp | string): Promise<void>;
     }
   }
@@ -19,34 +18,32 @@ expect.extend({
   async toLog(
     this: MatcherContext,
     transaction: Transaction,
-    match: RegExp | string,
+    match?: RegExp | string,
   ): Promise<SyncExpectationResult> {
-    const spyOnLoggerError = jest.spyOn(console, 'log');
+    const loggerSpy = jest.spyOn(console, 'log');
 
     // silence actual stdout output
-    spyOnLoggerError.mockImplementation(() => {});
-    try {
-      await transaction.debug();
-    } catch {}
-    let error: string = '';
+    loggerSpy.mockImplementation(() => {});
+    try { await transaction.debug(); } catch {}
+
+    // We concatenate all the logs into a single string - if no logs are present, we set received to undefined
+    const receivedBase = loggerSpy.mock.calls.reduce((acc, [log]) => `${acc}\n${log}`, '').trim();
+    const received = receivedBase === '' ? undefined : receivedBase;
+
+    const matcherHint = this.utils.matcherHint('toLog', 'received', 'expected', { isNot: this.isNot });
+    const expectedText = `Expected: ${this.isNot ? 'not ' : ''}${this.utils.printExpected(match)}`;
+    const receivedText = `Received: ${this.utils.printReceived(received)}`;
+    const message = (): string => `${matcherHint}\n\n${expectedText}\n${receivedText}`;
 
     try {
-      expect(spyOnLoggerError).toBeCalledWith(expect.stringMatching(match));
+      expect(loggerSpy).toBeCalledWith(match ? expect.stringMatching(match) : expect.anything());
     } catch (e) {
-      error = e as any;
+      return { message, pass: false };
     }
 
-    // We concatenate all the logs into a single string - if no logs are present, we set received to undefined
-    const receivedBase = spyOnLoggerError.mock.calls.reduce((acc, [log]) => `${acc}\n${log}`, '').trim();
-    const received = receivedBase === '' ? undefined : receivedBase;
+    loggerSpy.mockClear();
 
-    spyOnLoggerError.mockClear();
-
-    return {
-      message: failMessage(received, match),
-      // message: () =>'Hello',
-      pass: !error,
-    };
+    return { message, pass: true };
   },
 });
 
@@ -56,58 +53,24 @@ expect.extend({
     transaction: Transaction,
     match: RegExp | string,
   ): Promise<SyncExpectationResult> {
-    let message: string = '';
-    let failMessage: any = () => {};
-
     try {
       await transaction.debug();
-      failMessage = () => () => `${matcherHint(
-        '.toFailRequireWith',
-        undefined,
-        '',
-      )}
-
-Contract function did not fail a require statement`;
-    } catch (error) {
-      message = (error as any)?.message;
-    }
 
-    // should not have failed
-    if (this.isNot) {
-      return {
-        message: () => `${matcherHint(
-          '.toFailRequireWith',
-          'received',
-          '',
-          { isNot: true },
-        )}`,
-        pass: false,
-      };
-    }
+      const matcherHint = this.utils.matcherHint('.toFailRequireWith', undefined, match.toString(), { isNot: this.isNot });
+      const message = (): string => `${matcherHint}\n\nContract function did not fail a require statement`;
+      return { message, pass: false };
+    } catch (transactionError: any) {
+      const matcherHint = this.utils.matcherHint('toFailRequireWith', 'received', 'expected', { isNot: this.isNot });
+      const expectedText = `Expected pattern: ${this.isNot ? 'not ' : ''}${this.utils.printExpected(match)}`;
+      const receivedText = `Received string: ${this.utils.printReceived(transactionError?.message ?? '')}`;
+      const message = (): string => `${matcherHint}\n\n${expectedText}\n${receivedText}`;
 
-    if (message) {
       try {
-        expect(message).toMatch(match);
-        message = '';
-      } catch (error: any) {
-        message = error.message;
-        failMessage = () => () => message.replace('.toMatch', '.toFailRequireWith');
+        expect(transactionError?.message ?? '').toMatch(match);
+        return { message, pass: true };
+      } catch {
+        return { message, pass: false };
       }
     }
-
-    return {
-      message: failMessage(message, match),
-      pass: !message,
-    };
   },
 });
-
-// TODO: Update to have the same failMessage function for .toLog and .toFailRequireWith
-const failMessage = (received?: string, expected?: RegExp | string) => () => `${matcherHint(
-  '.toLog',
-  'received',
-  'expected',
-)}
-
-Expected: ${printExpected(expected)}
-Received: ${printReceived(received)}`;
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 3b00b348..7dd51db8 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -355,35 +355,45 @@ describe('Debugging tests', () => {
     const artifact = compileString(CONTRACT_CODE);
     const provider = new MockNetworkProvider();
 
+    // Note: happy cases are implicitly tested by the "regular" debugging tests, since the use JestExtensions
+
     it('should fail the JestExtensions test if an incorrect log is expected', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions
-        .test_logs()
-        .to(contract.address, 10000n);
-
-      const incorrectExpectedLog = new RegExp('^This is definitely not the log$');
+      const transaction = contract.functions.test_logs().to(contract.address, 10000n);
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
-        expect(transaction).toLog(incorrectExpectedLog),
+        expect(transaction).toLog('^This is definitely not the log$'),
       ).rejects.toThrow(/Expected: .*This is definitely not the log.*\nReceived: .*Test.cash:4 Hello World/);
     });
 
-    it('should fail the JestExtensions test if a log is expected where no log is logged', async () => {
+    it('should fail the JestExtensions test if a log is logged that is NOT expected', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions
-        .test_no_logs()
-        .to(contract.address, 10000n);
+      const transaction = contract.functions.test_logs().to(contract.address, 10000n);
+
+      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
+      await expect(
+        expect(transaction).not.toLog('^Test.cash:4 Hello World$'),
+      ).rejects.toThrow(/Expected: not .*Test.cash:4 Hello World.*\nReceived: .*Test.cash:4 Hello World/);
+
+      await expect(
+        expect(transaction).not.toLog(),
+      ).rejects.toThrow(/Expected: not .*undefined.*\nReceived: .*Test.cash:4 Hello World/);
+    });
 
-      const incorrectExpectedLog = new RegExp('Hello World');
+    it('should fail the JestExtensions test if a log is expected where no log is logged', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_no_logs().to(contract.address, 10000n);
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
-        expect(transaction).toLog(incorrectExpectedLog),
+        expect(transaction).toLog('Hello World'),
       ).rejects.toThrow(/Expected: .*Hello World.*\nReceived: .*undefined/);
     });
 
@@ -391,16 +401,11 @@ describe('Debugging tests', () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions
-        .test_require()
-        .to(contract.address, 10000n);
-
-      const incorrectExpectedRequire = new RegExp('1 should equal 3');
+      const transaction = contract.functions.test_require().to(contract.address, 10000n);
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
-      // TODO: Figure out why this error message says "Received string:" instead of "Received:"
       await expect(
-        expect(transaction).toFailRequireWith(incorrectExpectedRequire),
+        expect(transaction).toFailRequireWith('1 should equal 3'),
       ).rejects.toThrow(/Expected pattern: .*1 should equal 3.*\nReceived string: .*1 should equal 2.*/);
     });
 
@@ -409,16 +414,28 @@ describe('Debugging tests', () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
-      const transaction = contract.functions
-        .test_require_no_failure()
-        .to(contract.address, 10000n);
+      const transaction = contract.functions.test_require_no_failure().to(contract.address, 10000n);
 
-      const incorrectExpectedRequire = new RegExp('1 should equal 3');
+      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
+      await expect(
+        expect(transaction).toFailRequireWith('1 should equal 3'),
+      ).rejects.toThrow(/Contract function did not fail a require statement/);
+    });
+
+    it('should fail the JestExtensions test if an error is thrown where it is NOT expected', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_require().to(contract.address, 10000n);
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
-        await expect(transaction).toFailRequireWith(incorrectExpectedRequire),
-      ).rejects.toThrow(/Expected: .*1 should equal 3.*\nReceived: undefined/);
+        expect(transaction).not.toFailRequireWith('1 should equal 2'),
+      ).rejects.toThrow(/Expected pattern: not .*1 should equal 2.*\nReceived string: .*1 should equal 2.*/);
+
+      await expect(
+        expect(transaction).not.toFailRequireWith(/.*/),
+      ).rejects.toThrow(/Expected pattern: not .*\nReceived string: .*1 should equal 2.*/);
     });
   });
 });

From 3c6b899b3ff511343941d65a6ab405622eb0d263 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 15 Apr 2024 11:50:31 +0800
Subject: [PATCH 038/267] Fix cashc tests after debug message fixes

---
 packages/cashc/test/generation/fixtures.ts | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index f3f4efeb..438b341c 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -102,7 +102,7 @@ export const fixtures: Fixture[] = [
         bytecode: '527954799300795479940079537a52949c6300795579935479517993527a757c00795279a0697567007954799c69680079547a93007a537a9c777777',
         logs: [],
         requireMessages: [],
-        sourceMap: '3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:8:11:9:0;9:15;10:20:10:21;;:25::26;;:20:::1;:12::28;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;2:4:14:5;;',
+        sourceMap: '3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:24:9:9;9:15:11::0;10:20:10:21;;:25::26;;:20:::1;:12::28;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;2:4:14:5;;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/if_statement.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -205,7 +205,7 @@ export const fixtures: Fixture[] = [
         bytecode: '5279009c63537955799300795579940079537a9c6300795679935579517993527a757c00795279a06975675479517a75680079557a93007a537a9c69517777777767527a519c695279007952930079537a9c6300795479930079527993527a757c00795279a0697568537a007a537a9c777768',
         logs: [],
         requireMessages: [],
-        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:12:::1;:20:9:9:0;6::6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:8:11:9:0;9:15;10:16:10:17;;:12::18;;;9:15:11:9:1;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;:8::24;2:4:14:5;;;;;;16::26::0;;;;;17:16:17:17;;18:12:18:13;;:16::17;:12:::1;19::19:13:0;;:17::18;;:12:::1;:20:23:9:0;20::20:21;;:24::25;;:20:::1;21:16:21:17:0;;:20::21;;:16:::1;:12::22:0;;;;22:20:22:21;;:24::25;;:20:::1;:12::27;19:8:23:9:0;:20:::1;24:12:24:13:0;;25:16:25:17;;:21::22;;:16:::1;16:4:26:5;;1:0:27:1',
+        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:12:::1;:20:9:9:0;6::6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:20:9:9;9:15:11::0;10:16:10:17;;:12::18;;;9:15:11:9:1;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;:8::24;2:4:14:5;;;;;;16::26::0;;;;;17:16:17:17;;18:12:18:13;;:16::17;:12:::1;19::19:13:0;;:17::18;;:12:::1;:20:23:9:0;20::20:21;;:24::25;;:20:::1;21:16:21:17:0;;:20::21;;:16:::1;:12::22:0;;;;22:20:22:21;;:24::25;;:20:::1;:12::27;19:20:23:9;;24:12:24:13:0;;25:16:25:17;;:21::22;;:16:::1;16:4:26:5;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/multifunction_if_statements.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -652,8 +652,11 @@ export const fixtures: Fixture[] = [
       bytecode: 'OP_DUP OP_1 OP_NUMEQUALVERIFY OP_1ADD OP_2 OP_NUMEQUAL',
       debug: {
         bytecode: '0079519c69007a5193529c',
-        logs: [{ data: [{ stackIndex: 0, type: 'int' }, 'test', { stackIndex: 0, type: 'int' }, 'test2'], ip: 5, line: 4 }],
-        requireMessages: [{ ip: 4, line: 3, message: 'Wrong value passed' }, { ip: 11, line: 6, message: 'Sum doesn\'t work' }],
+        logs: [
+          { data: [{ stackIndex: 0, type: 'int' }, 'test'], ip: 5, line: 4 },
+          { data: [{ stackIndex: 0, type: 'int' }, 'test2'], ip: 5, line: 5 },
+        ],
+        requireMessages: [{ ip: 5, line: 3, message: 'Wrong value passed' }, { ip: 12, line: 6, message: 'Sum doesn\'t work' }],
         sourceMap: '3:12:3:17;;:21::22;:12:::1;:4::46;6:12:6:17:0;;:20::21;:12:::1;:25::26:0;:12:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/debug_messages.cash', import.meta.url), { encoding: 'utf-8' }),

From fa64c5d6e1e827bb3382a04fcc845d360a6c0022 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 15 Apr 2024 11:56:13 +0800
Subject: [PATCH 039/267] Move ts-node to tsx

---
 README.md                                     |   6 +-
 examples/README.md                            |   6 +-
 examples/testing-suite/artifacts/example.json |   4 +-
 examples/testing-suite/package.json           |   6 +-
 examples/testing-suite/yarn.lock              | 314 +++++++++++-------
 package.json                                  |   6 +-
 yarn.lock                                     | 171 ++++++++++
 7 files changed, 378 insertions(+), 135 deletions(-)

diff --git a/README.md b/README.md
index fb3519bb..9c203d23 100644
--- a/README.md
+++ b/README.md
@@ -99,11 +99,11 @@ cd cashscript/examples
 npm install
 ```
 
-All `.ts` files in the [`examples/`](/examples) directory can then be executed with `ts-node-esm`.
+All `.ts` files in the [`examples/`](/examples) directory can then be executed with `tsx`.
 
 ```bash
-npm install -g ts-node
-ts-node-esm p2pkh.ts
+npm install -g tsx
+tsx p2pkh.ts
 ```
 
 All `.js` files can be executed with `node`.
diff --git a/examples/README.md b/examples/README.md
index 242c6a79..803a8015 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -12,11 +12,11 @@ cd cashscript/examples
 yarn
 ```
 
-All `.ts` files can then be executed with `ts-node-esm`.
+All `.ts` files can then be executed with `tsx`.
 
 ```bash
-npm install -g ts-node
-ts-node-esm p2pkh.ts
+npm install -g tsx
+tsx p2pkh.ts
 ```
 
 All `.js` files can be executed with `node`.
diff --git a/examples/testing-suite/artifacts/example.json b/examples/testing-suite/artifacts/example.json
index 50b4db3d..bac84de7 100644
--- a/examples/testing-suite/artifacts/example.json
+++ b/examples/testing-suite/artifacts/example.json
@@ -40,7 +40,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.0"
+    "version": "0.10.0-next.3"
   },
-  "updatedAt": "2023-12-13T15:04:57.625Z"
+  "updatedAt": "2024-04-15T03:55:07.781Z"
 }
\ No newline at end of file
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index bff4660e..e63b70ec 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -16,8 +16,8 @@
     "build:test": "yarn clean:test && yarn compile:test",
     "clean": "rm -rf ./dist",
     "clean:test": "rm -rf ./dist-test",
-    "compile": "tsc -p tsconfig.json && ts-node-esm tasks/index.ts compile",
-    "compile:test": "tsc -p tsconfig.test.json && ts-node-esm tasks/index.ts compile",
+    "compile": "tsc -p tsconfig.json && tsx tasks/index.ts compile",
+    "compile:test": "tsc -p tsconfig.test.json && tsx tasks/index.ts compile",
     "lint": "eslint . --ext .ts --ignore-path ../../.eslintignore",
     "prepare": "yarn build",
     "prepublishOnly": "yarn test && yarn lint",
@@ -32,7 +32,7 @@
     "@jest/globals": "^29.4.1",
     "@types/jest": "^29.4.1",
     "jest": "^29.4.1",
-    "ts-node": "^10.9.1",
+    "tsx": "^4.7.2",
     "typescript": "^4.9.5"
   }
 }
diff --git a/examples/testing-suite/yarn.lock b/examples/testing-suite/yarn.lock
index d43fdd4a..c731accf 100644
--- a/examples/testing-suite/yarn.lock
+++ b/examples/testing-suite/yarn.lock
@@ -297,25 +297,133 @@
   resolved "https://registry.yarnpkg.com/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz#75a2e8b51cb758a7553d6804a5932d7aace75c39"
   integrity sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==
 
-"@bitauth/libauth@^2.0.0-alpha.8":
-  version "2.0.0-alpha.8"
-  resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-2.0.0-alpha.8.tgz#352ade2075517f1548e05553e7bb1c5e1023d1fe"
-  integrity sha512-KINAJbzg5pKs+WM8wCjWw6Ct/CeZG1JMrRXsIyPFztjNtwA5eeQL8eFkyquePsf8aZ5peRYK2eFPUDo/1rkg+w==
+"@bitauth/libauth@^2.0.0":
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-2.1.0.tgz#e618706092fe9ea5e4103a2cf427cd5ae5287e1e"
+  integrity sha512-O0cIN7/UPUHg6gaWHuePXIYRkvNPrc3zHfi80guZkkO4Ke9nSaN5mSITqhC5lKFBwAakr6OSToClXHN/IxiOfA==
 
-"@cashscript/utils@^0.10.0-next.0":
-  version "0.10.0-next.0"
-  resolved "https://registry.yarnpkg.com/@cashscript/utils/-/utils-0.10.0-next.0.tgz#d8a47c2e9b18840678e62c58c3190afb86794f9a"
-  integrity sha512-cqTniDARlZqqThMTd33LtwSFhRdVe15tTq1K4Zs0gYFgBcT1l40B3P57szN+2gXsffGmN77I33IXv+wPoObcDg==
+"@cashscript/utils@^0.10.0-next.3":
+  version "0.10.0-next.3"
+  resolved "https://registry.yarnpkg.com/@cashscript/utils/-/utils-0.10.0-next.3.tgz#53bcdfae252734696c8158d4f479c8c60e2a0f7f"
+  integrity sha512-eS16y0OyZ0m2OitsvsKwPX+fwI8Lc4imJioM+hRjedSZ0ioqO+6qZUJoeLAkdpCvEzkRo2I68vuRCbelH0wQMQ==
   dependencies:
-    "@bitauth/libauth" "^2.0.0-alpha.8"
+    "@bitauth/libauth" "^2.0.0"
     hash.js "^1.1.7"
 
-"@cspotcode/source-map-support@^0.8.0":
-  version "0.8.1"
-  resolved "https://registry.yarnpkg.com/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz#00629c35a688e05a88b1cda684fb9d5e73f000a1"
-  integrity sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==
-  dependencies:
-    "@jridgewell/trace-mapping" "0.3.9"
+"@esbuild/aix-ppc64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/aix-ppc64/-/aix-ppc64-0.19.12.tgz#d1bc06aedb6936b3b6d313bf809a5a40387d2b7f"
+  integrity sha512-bmoCYyWdEL3wDQIVbcyzRyeKLgk2WtWLTWz1ZIAZF/EGbNOwSA6ew3PftJ1PqMiOOGu0OyFMzG53L0zqIpPeNA==
+
+"@esbuild/android-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-arm64/-/android-arm64-0.19.12.tgz#7ad65a36cfdb7e0d429c353e00f680d737c2aed4"
+  integrity sha512-P0UVNGIienjZv3f5zq0DP3Nt2IE/3plFzuaS96vihvD0Hd6H/q4WXUGpCxD/E8YrSXfNyRPbpTq+T8ZQioSuPA==
+
+"@esbuild/android-arm@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-arm/-/android-arm-0.19.12.tgz#b0c26536f37776162ca8bde25e42040c203f2824"
+  integrity sha512-qg/Lj1mu3CdQlDEEiWrlC4eaPZ1KztwGJ9B6J+/6G+/4ewxJg7gqj8eVYWvao1bXrqGiW2rsBZFSX3q2lcW05w==
+
+"@esbuild/android-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-x64/-/android-x64-0.19.12.tgz#cb13e2211282012194d89bf3bfe7721273473b3d"
+  integrity sha512-3k7ZoUW6Q6YqhdhIaq/WZ7HwBpnFBlW905Fa4s4qWJyiNOgT1dOqDiVAQFwBH7gBRZr17gLrlFCRzF6jFh7Kew==
+
+"@esbuild/darwin-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/darwin-arm64/-/darwin-arm64-0.19.12.tgz#cbee41e988020d4b516e9d9e44dd29200996275e"
+  integrity sha512-B6IeSgZgtEzGC42jsI+YYu9Z3HKRxp8ZT3cqhvliEHovq8HSX2YX8lNocDn79gCKJXOSaEot9MVYky7AKjCs8g==
+
+"@esbuild/darwin-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/darwin-x64/-/darwin-x64-0.19.12.tgz#e37d9633246d52aecf491ee916ece709f9d5f4cd"
+  integrity sha512-hKoVkKzFiToTgn+41qGhsUJXFlIjxI/jSYeZf3ugemDYZldIXIxhvwN6erJGlX4t5h417iFuheZ7l+YVn05N3A==
+
+"@esbuild/freebsd-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.19.12.tgz#1ee4d8b682ed363b08af74d1ea2b2b4dbba76487"
+  integrity sha512-4aRvFIXmwAcDBw9AueDQ2YnGmz5L6obe5kmPT8Vd+/+x/JMVKCgdcRwH6APrbpNXsPz+K653Qg8HB/oXvXVukA==
+
+"@esbuild/freebsd-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-x64/-/freebsd-x64-0.19.12.tgz#37a693553d42ff77cd7126764b535fb6cc28a11c"
+  integrity sha512-EYoXZ4d8xtBoVN7CEwWY2IN4ho76xjYXqSXMNccFSx2lgqOG/1TBPW0yPx1bJZk94qu3tX0fycJeeQsKovA8gg==
+
+"@esbuild/linux-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm64/-/linux-arm64-0.19.12.tgz#be9b145985ec6c57470e0e051d887b09dddb2d4b"
+  integrity sha512-EoTjyYyLuVPfdPLsGVVVC8a0p1BFFvtpQDB/YLEhaXyf/5bczaGeN15QkR+O4S5LeJ92Tqotve7i1jn35qwvdA==
+
+"@esbuild/linux-arm@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm/-/linux-arm-0.19.12.tgz#207ecd982a8db95f7b5279207d0ff2331acf5eef"
+  integrity sha512-J5jPms//KhSNv+LO1S1TX1UWp1ucM6N6XuL6ITdKWElCu8wXP72l9MM0zDTzzeikVyqFE6U8YAV9/tFyj0ti+w==
+
+"@esbuild/linux-ia32@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-ia32/-/linux-ia32-0.19.12.tgz#d0d86b5ca1562523dc284a6723293a52d5860601"
+  integrity sha512-Thsa42rrP1+UIGaWz47uydHSBOgTUnwBwNq59khgIwktK6x60Hivfbux9iNR0eHCHzOLjLMLfUMLCypBkZXMHA==
+
+"@esbuild/linux-loong64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-loong64/-/linux-loong64-0.19.12.tgz#9a37f87fec4b8408e682b528391fa22afd952299"
+  integrity sha512-LiXdXA0s3IqRRjm6rV6XaWATScKAXjI4R4LoDlvO7+yQqFdlr1Bax62sRwkVvRIrwXxvtYEHHI4dm50jAXkuAA==
+
+"@esbuild/linux-mips64el@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-mips64el/-/linux-mips64el-0.19.12.tgz#4ddebd4e6eeba20b509d8e74c8e30d8ace0b89ec"
+  integrity sha512-fEnAuj5VGTanfJ07ff0gOA6IPsvrVHLVb6Lyd1g2/ed67oU1eFzL0r9WL7ZzscD+/N6i3dWumGE1Un4f7Amf+w==
+
+"@esbuild/linux-ppc64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-ppc64/-/linux-ppc64-0.19.12.tgz#adb67dadb73656849f63cd522f5ecb351dd8dee8"
+  integrity sha512-nYJA2/QPimDQOh1rKWedNOe3Gfc8PabU7HT3iXWtNUbRzXS9+vgB0Fjaqr//XNbd82mCxHzik2qotuI89cfixg==
+
+"@esbuild/linux-riscv64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-riscv64/-/linux-riscv64-0.19.12.tgz#11bc0698bf0a2abf8727f1c7ace2112612c15adf"
+  integrity sha512-2MueBrlPQCw5dVJJpQdUYgeqIzDQgw3QtiAHUC4RBz9FXPrskyyU3VI1hw7C0BSKB9OduwSJ79FTCqtGMWqJHg==
+
+"@esbuild/linux-s390x@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-s390x/-/linux-s390x-0.19.12.tgz#e86fb8ffba7c5c92ba91fc3b27ed5a70196c3cc8"
+  integrity sha512-+Pil1Nv3Umes4m3AZKqA2anfhJiVmNCYkPchwFJNEJN5QxmTs1uzyy4TvmDrCRNT2ApwSari7ZIgrPeUx4UZDg==
+
+"@esbuild/linux-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-x64/-/linux-x64-0.19.12.tgz#5f37cfdc705aea687dfe5dfbec086a05acfe9c78"
+  integrity sha512-B71g1QpxfwBvNrfyJdVDexenDIt1CiDN1TIXLbhOw0KhJzE78KIFGX6OJ9MrtC0oOqMWf+0xop4qEU8JrJTwCg==
+
+"@esbuild/netbsd-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/netbsd-x64/-/netbsd-x64-0.19.12.tgz#29da566a75324e0d0dd7e47519ba2f7ef168657b"
+  integrity sha512-3ltjQ7n1owJgFbuC61Oj++XhtzmymoCihNFgT84UAmJnxJfm4sYCiSLTXZtE00VWYpPMYc+ZQmB6xbSdVh0JWA==
+
+"@esbuild/openbsd-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/openbsd-x64/-/openbsd-x64-0.19.12.tgz#306c0acbdb5a99c95be98bdd1d47c916e7dc3ff0"
+  integrity sha512-RbrfTB9SWsr0kWmb9srfF+L933uMDdu9BIzdA7os2t0TXhCRjrQyCeOt6wVxr79CKD4c+p+YhCj31HBkYcXebw==
+
+"@esbuild/sunos-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/sunos-x64/-/sunos-x64-0.19.12.tgz#0933eaab9af8b9b2c930236f62aae3fc593faf30"
+  integrity sha512-HKjJwRrW8uWtCQnQOz9qcU3mUZhTUQvi56Q8DPTLLB+DawoiQdjsYq+j+D3s9I8VFtDr+F9CjgXKKC4ss89IeA==
+
+"@esbuild/win32-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-arm64/-/win32-arm64-0.19.12.tgz#773bdbaa1971b36db2f6560088639ccd1e6773ae"
+  integrity sha512-URgtR1dJnmGvX864pn1B2YUYNzjmXkuJOIqG2HdU62MVS4EHpU2946OZoTMnRUHklGtJdJZ33QfzdjGACXhn1A==
+
+"@esbuild/win32-ia32@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-ia32/-/win32-ia32-0.19.12.tgz#000516cad06354cc84a73f0943a4aa690ef6fd67"
+  integrity sha512-+ZOE6pUkMOJfmxmBZElNOx72NKpIa/HFOMGzu8fqzQJ5kgf6aTGrcJaFsNiVMH4JKpMipyK+7k0n2UXN7a8YKQ==
+
+"@esbuild/win32-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-x64/-/win32-x64-0.19.12.tgz#c57c8afbb4054a3ab8317591a0b7320360b444ae"
+  integrity sha512-T1QyPSDCyMXaO3pzBkF96E8xMkiRYbUEZADd29SyPGabqxMViNoii+NcK7eWJAEoU6RZyEm5lVSIjTmcdoB9HA==
 
 "@istanbuljs/load-nyc-config@^1.0.0":
   version "1.1.0"
@@ -534,7 +642,7 @@
     "@jridgewell/sourcemap-codec" "^1.4.10"
     "@jridgewell/trace-mapping" "^0.3.9"
 
-"@jridgewell/resolve-uri@^3.0.3", "@jridgewell/resolve-uri@^3.1.0":
+"@jridgewell/resolve-uri@^3.1.0":
   version "3.1.1"
   resolved "https://registry.yarnpkg.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.1.tgz#c08679063f279615a3326583ba3a90d1d82cc721"
   integrity sha512-dSYZh7HhCDtCKm4QakX0xFpsRDqjjtZf/kjI/v3T3Nwt5r8/qz/M19F9ySyOqU94SXBmeG9ttTul+YnR4LOxFA==
@@ -549,14 +657,6 @@
   resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.15.tgz#d7c6e6755c78567a951e04ab52ef0fd26de59f32"
   integrity sha512-eF2rxCRulEKXHTRiDrDy6erMYWqNw4LPdQ8UQA4huuxaQsVeRPFl2oM8oDGxMFhJUWZf9McpLtJasDDZb/Bpeg==
 
-"@jridgewell/trace-mapping@0.3.9":
-  version "0.3.9"
-  resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz#6534fd5933a53ba7cbf3a17615e273a0d1273ff9"
-  integrity sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==
-  dependencies:
-    "@jridgewell/resolve-uri" "^3.0.3"
-    "@jridgewell/sourcemap-codec" "^1.4.10"
-
 "@jridgewell/trace-mapping@^0.3.12", "@jridgewell/trace-mapping@^0.3.17", "@jridgewell/trace-mapping@^0.3.18", "@jridgewell/trace-mapping@^0.3.9":
   version "0.3.20"
   resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.20.tgz#72e45707cf240fa6b081d0366f8265b0cd10197f"
@@ -584,26 +684,6 @@
   dependencies:
     "@sinonjs/commons" "^3.0.0"
 
-"@tsconfig/node10@^1.0.7":
-  version "1.0.9"
-  resolved "https://registry.yarnpkg.com/@tsconfig/node10/-/node10-1.0.9.tgz#df4907fc07a886922637b15e02d4cebc4c0021b2"
-  integrity sha512-jNsYVVxU8v5g43Erja32laIDHXeoNvFEpX33OK4d6hljo3jDhCBDhx5dhCCTMWUojscpAagGiRkBKxpdl9fxqA==
-
-"@tsconfig/node12@^1.0.7":
-  version "1.0.11"
-  resolved "https://registry.yarnpkg.com/@tsconfig/node12/-/node12-1.0.11.tgz#ee3def1f27d9ed66dac6e46a295cffb0152e058d"
-  integrity sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==
-
-"@tsconfig/node14@^1.0.0":
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/@tsconfig/node14/-/node14-1.0.3.tgz#e4386316284f00b98435bf40f72f75a09dabf6c1"
-  integrity sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==
-
-"@tsconfig/node16@^1.0.2":
-  version "1.0.4"
-  resolved "https://registry.yarnpkg.com/@tsconfig/node16/-/node16-1.0.4.tgz#0b92dcc0cc1c81f6f306a381f28e31b1a56536e9"
-  integrity sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==
-
 "@types/babel__core@^7.1.14":
   version "7.20.5"
   resolved "https://registry.yarnpkg.com/@types/babel__core/-/babel__core-7.20.5.tgz#3df15f27ba85319caa07ba08d0721889bb39c017"
@@ -702,16 +782,6 @@
   dependencies:
     "@types/yargs-parser" "*"
 
-acorn-walk@^8.1.1:
-  version "8.3.0"
-  resolved "https://registry.yarnpkg.com/acorn-walk/-/acorn-walk-8.3.0.tgz#2097665af50fd0cf7a2dfccd2b9368964e66540f"
-  integrity sha512-FS7hV565M5l1R08MXqo8odwMTB02C2UqzB17RVgu9EyuYFBqJZ3/ZY97sQD5FewVu1UyDFc1yztUDrAwT0EypA==
-
-acorn@^8.4.1:
-  version "8.11.2"
-  resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.11.2.tgz#ca0d78b51895be5390a5903c5b3bdcdaf78ae40b"
-  integrity sha512-nc0Axzp/0FILLEVsm4fNwLCwMttvhEI263QtVPQcbpfZZ3ts0hLsZGOpE6czNlid7CJ9MlyH8reXkpsf3YUY4w==
-
 ansi-escapes@^4.2.1:
   version "4.3.2"
   resolved "https://registry.yarnpkg.com/ansi-escapes/-/ansi-escapes-4.3.2.tgz#6b2291d1db7d98b6521d5f1efa42d0f3a9feb65e"
@@ -743,10 +813,10 @@ ansi-styles@^5.0.0:
   resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-5.2.0.tgz#07449690ad45777d1924ac2abb2fc8895dba836b"
   integrity sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==
 
-antlr4ts@^0.5.0-alpha.4:
-  version "0.5.0-alpha.4"
-  resolved "https://registry.yarnpkg.com/antlr4ts/-/antlr4ts-0.5.0-alpha.4.tgz#71702865a87478ed0b40c0709f422cf14d51652a"
-  integrity sha512-WPQDt1B74OfPv/IMS2ekXAKkTZIHl88uMetg6q3OTqgFxZ/dxDXI0EWLyZid/1Pe6hTftyg5N7gel5wNAGxXyQ==
+antlr4@^4.13.1-patch-1:
+  version "4.13.1-patch-1"
+  resolved "https://registry.yarnpkg.com/antlr4/-/antlr4-4.13.1-patch-1.tgz#946176f863f890964a050c4f18c47fd6f7e57602"
+  integrity sha512-OjFLWWLzDMV9rdFhpvroCWR4ooktNg9/nvVYSA5z28wuVpU36QUNuioR1XLnQtcjVlf8npjyz593PxnU/f/Cow==
 
 anymatch@^3.0.3:
   version "3.1.3"
@@ -756,11 +826,6 @@ anymatch@^3.0.3:
     normalize-path "^3.0.0"
     picomatch "^2.0.4"
 
-arg@^4.1.0:
-  version "4.1.3"
-  resolved "https://registry.yarnpkg.com/arg/-/arg-4.1.3.tgz#269fc7ad5b8e42cb63c896d5666017261c144089"
-  integrity sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==
-
 argparse@^1.0.7:
   version "1.0.10"
   resolved "https://registry.yarnpkg.com/argparse/-/argparse-1.0.10.tgz#bcd6791ea5ae09725e17e5ad988134cd40b3d911"
@@ -915,23 +980,23 @@ caniuse-lite@^1.0.30001541:
   integrity sha512-xrE//a3O7TP0vaJ8ikzkD2c2NgcVUvsEe2IvFTntV4Yd1Z9FVzh+gW+enX96L0psrbaFMcVcH2l90xNuGDWc8w==
 
 cashc@^0.10.0:
-  version "0.10.0-next.0"
-  resolved "https://registry.yarnpkg.com/cashc/-/cashc-0.10.0-next.0.tgz#ba8f803abca77ad1ac629cfa3e794fa691906c81"
-  integrity sha512-PeOiU/5u+MyugcICuzb1aD5TitVRKbXD/4cBz9WNR7PCjdMX+3NpYDZi0Ql61YrcHP1s4z8a3Xw+w4FKcCL5LQ==
+  version "0.10.0-next.3"
+  resolved "https://registry.yarnpkg.com/cashc/-/cashc-0.10.0-next.3.tgz#25e82b55c7a11848ba25c45a05c24b263a322fba"
+  integrity sha512-TfZvCSi840txb2XTuf7H1OgFWB+nraHVeibwsFLfQZu1n1VfW9Ff6tNkEqzxa6EpXuyJfgZAgM9zS9B7J0P2Yg==
   dependencies:
-    "@bitauth/libauth" "^2.0.0-alpha.8"
-    "@cashscript/utils" "^0.10.0-next.0"
-    antlr4ts "^0.5.0-alpha.4"
+    "@bitauth/libauth" "^2.0.0"
+    "@cashscript/utils" "^0.10.0-next.3"
+    antlr4 "^4.13.1-patch-1"
     commander "^7.1.0"
-    semver "^7.3.4"
+    semver "^7.5.4"
 
 cashscript@^0.10.0:
-  version "0.10.0-next.0"
-  resolved "https://registry.yarnpkg.com/cashscript/-/cashscript-0.10.0-next.0.tgz#6959a5d0872660094e10a77fb59a8aec52ead3bf"
-  integrity sha512-ph6gmsLA7q7birLyFIE6gAAS4QRnA5Msa+T4Dx5sxLoQERIUHn8nJ8w/QjE1+UdcwimK43YV6fwaEVRXYm0UZQ==
+  version "0.10.0-next.3"
+  resolved "https://registry.yarnpkg.com/cashscript/-/cashscript-0.10.0-next.3.tgz#2d186a7fa1f8ca496016dba1fb077a1956662407"
+  integrity sha512-eXGZu1jpsJDWpoJq+iaN9XXBuLefJP8GGgv4mR7mBxaRfW/+IKeIvvu9lcD98wWggwQcJqom2/e43cB7K5Wonw==
   dependencies:
-    "@bitauth/libauth" "^2.0.0-alpha.8"
-    "@cashscript/utils" "^0.10.0-next.0"
+    "@bitauth/libauth" "^2.0.0"
+    "@cashscript/utils" "^0.10.0-next.3"
     bip68 "^1.0.4"
     bitcoin-rpc-promise-retry "^1.3.0"
     delay "^5.0.0"
@@ -1042,11 +1107,6 @@ create-jest@^29.7.0:
     jest-util "^29.7.0"
     prompts "^2.0.1"
 
-create-require@^1.1.0:
-  version "1.1.1"
-  resolved "https://registry.yarnpkg.com/create-require/-/create-require-1.1.1.tgz#c1d7e8f1e5f6cfc9ff65f9cd352d37348756c333"
-  integrity sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==
-
 cross-spawn@^7.0.3:
   version "7.0.3"
   resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.3.tgz#f73a85b9d5d41d045551c177e2882d4ac85728a6"
@@ -1088,11 +1148,6 @@ diff-sequences@^29.6.3:
   resolved "https://registry.yarnpkg.com/diff-sequences/-/diff-sequences-29.6.3.tgz#4deaf894d11407c51efc8418012f9e70b84ea921"
   integrity sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==
 
-diff@^4.0.1:
-  version "4.0.2"
-  resolved "https://registry.yarnpkg.com/diff/-/diff-4.0.2.tgz#60f3aecb89d5fae520c11aa19efc2bb982aade7d"
-  integrity sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==
-
 electron-to-chromium@^1.4.535:
   version "1.4.594"
   resolved "https://registry.yarnpkg.com/electron-to-chromium/-/electron-to-chromium-1.4.594.tgz#f69f207fba80735a44a988df42f3f439115d0515"
@@ -1126,6 +1181,35 @@ error-ex@^1.3.1:
   dependencies:
     is-arrayish "^0.2.1"
 
+esbuild@~0.19.10:
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/esbuild/-/esbuild-0.19.12.tgz#dc82ee5dc79e82f5a5c3b4323a2a641827db3e04"
+  integrity sha512-aARqgq8roFBj054KvQr5f1sFu0D65G+miZRCuJyJ0G13Zwx7vRar5Zhn2tkQNzIXcBrNVsv/8stehpj+GAjgbg==
+  optionalDependencies:
+    "@esbuild/aix-ppc64" "0.19.12"
+    "@esbuild/android-arm" "0.19.12"
+    "@esbuild/android-arm64" "0.19.12"
+    "@esbuild/android-x64" "0.19.12"
+    "@esbuild/darwin-arm64" "0.19.12"
+    "@esbuild/darwin-x64" "0.19.12"
+    "@esbuild/freebsd-arm64" "0.19.12"
+    "@esbuild/freebsd-x64" "0.19.12"
+    "@esbuild/linux-arm" "0.19.12"
+    "@esbuild/linux-arm64" "0.19.12"
+    "@esbuild/linux-ia32" "0.19.12"
+    "@esbuild/linux-loong64" "0.19.12"
+    "@esbuild/linux-mips64el" "0.19.12"
+    "@esbuild/linux-ppc64" "0.19.12"
+    "@esbuild/linux-riscv64" "0.19.12"
+    "@esbuild/linux-s390x" "0.19.12"
+    "@esbuild/linux-x64" "0.19.12"
+    "@esbuild/netbsd-x64" "0.19.12"
+    "@esbuild/openbsd-x64" "0.19.12"
+    "@esbuild/sunos-x64" "0.19.12"
+    "@esbuild/win32-arm64" "0.19.12"
+    "@esbuild/win32-ia32" "0.19.12"
+    "@esbuild/win32-x64" "0.19.12"
+
 escalade@^3.1.1:
   version "3.1.1"
   resolved "https://registry.yarnpkg.com/escalade/-/escalade-3.1.1.tgz#d8cfdc7000965c5a0174b4a82eaa5c0552742e40"
@@ -1214,7 +1298,7 @@ fs.realpath@^1.0.0:
   resolved "https://registry.yarnpkg.com/fs.realpath/-/fs.realpath-1.0.0.tgz#1504ad2523158caa40db4a2787cb01411994ea4f"
   integrity sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==
 
-fsevents@^2.3.2:
+fsevents@^2.3.2, fsevents@~2.3.3:
   version "2.3.3"
   resolved "https://registry.yarnpkg.com/fsevents/-/fsevents-2.3.3.tgz#cac6407785d03675a2a5e1a5305c697b347d90d6"
   integrity sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==
@@ -1244,6 +1328,13 @@ get-stream@^6.0.0:
   resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-6.0.1.tgz#a262d8eef67aced57c2852ad6167526a43cbf7b7"
   integrity sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==
 
+get-tsconfig@^4.7.2:
+  version "4.7.3"
+  resolved "https://registry.yarnpkg.com/get-tsconfig/-/get-tsconfig-4.7.3.tgz#0498163d98f7b58484dd4906999c0c9d5f103f83"
+  integrity sha512-ZvkrzoUA0PQZM6fy6+/Hce561s+faD1rsNwhnO5FelNjyy7EMGJ3Rz1AQ8GYDWjhRs/7dBLOEJvhK8MiEJOAFg==
+  dependencies:
+    resolve-pkg-maps "^1.0.0"
+
 glob@^7.1.3, glob@^7.1.4:
   version "7.2.3"
   resolved "https://registry.yarnpkg.com/glob/-/glob-7.2.3.tgz#b8df0fb802bbfa8e89bd1d938b4e16578ed44f2b"
@@ -1851,11 +1942,6 @@ make-dir@^4.0.0:
   dependencies:
     semver "^7.5.3"
 
-make-error@^1.1.1:
-  version "1.3.6"
-  resolved "https://registry.yarnpkg.com/make-error/-/make-error-1.3.6.tgz#2eb2e37ea9b67c4891f684a1394799af484cf7a2"
-  integrity sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==
-
 makeerror@1.0.12:
   version "1.0.12"
   resolved "https://registry.yarnpkg.com/makeerror/-/makeerror-1.0.12.tgz#3e5dd2079a82e812e983cc6610c4a2cb0eaa801a"
@@ -2066,6 +2152,11 @@ resolve-from@^5.0.0:
   resolved "https://registry.yarnpkg.com/resolve-from/-/resolve-from-5.0.0.tgz#c35225843df8f776df21c57557bc087e9dfdfc69"
   integrity sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==
 
+resolve-pkg-maps@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz#616b3dc2c57056b5588c31cdf4b3d64db133720f"
+  integrity sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==
+
 resolve.exports@^2.0.0:
   version "2.0.2"
   resolved "https://registry.yarnpkg.com/resolve.exports/-/resolve.exports-2.0.2.tgz#f8c934b8e6a13f539e38b7098e2e36134f01e800"
@@ -2085,7 +2176,7 @@ semver@^6.3.0, semver@^6.3.1:
   resolved "https://registry.yarnpkg.com/semver/-/semver-6.3.1.tgz#556d2ef8689146e46dcea4bfdd095f3434dffcb4"
   integrity sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==
 
-semver@^7.3.4, semver@^7.5.3, semver@^7.5.4:
+semver@^7.5.3, semver@^7.5.4:
   version "7.5.4"
   resolved "https://registry.yarnpkg.com/semver/-/semver-7.5.4.tgz#483986ec4ed38e1c6c48c34894a9182dbff68a6e"
   integrity sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==
@@ -2235,30 +2326,21 @@ to-regex-range@^5.0.1:
   dependencies:
     is-number "^7.0.0"
 
-ts-node@^10.9.1:
-  version "10.9.1"
-  resolved "https://registry.yarnpkg.com/ts-node/-/ts-node-10.9.1.tgz#e73de9102958af9e1f0b168a6ff320e25adcff4b"
-  integrity sha512-NtVysVPkxxrwFGUUxGYhfux8k78pQB3JqYBXlLRZgdGUqTO5wU/UyHop5p70iEbGhB7q5KmiZiU0Y3KlJrScEw==
-  dependencies:
-    "@cspotcode/source-map-support" "^0.8.0"
-    "@tsconfig/node10" "^1.0.7"
-    "@tsconfig/node12" "^1.0.7"
-    "@tsconfig/node14" "^1.0.0"
-    "@tsconfig/node16" "^1.0.2"
-    acorn "^8.4.1"
-    acorn-walk "^8.1.1"
-    arg "^4.1.0"
-    create-require "^1.1.0"
-    diff "^4.0.1"
-    make-error "^1.1.1"
-    v8-compile-cache-lib "^3.0.1"
-    yn "3.1.1"
-
 tslib@^2.3.1:
   version "2.6.2"
   resolved "https://registry.yarnpkg.com/tslib/-/tslib-2.6.2.tgz#703ac29425e7b37cd6fd456e92404d46d1f3e4ae"
   integrity sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q==
 
+tsx@^4.7.2:
+  version "4.7.2"
+  resolved "https://registry.yarnpkg.com/tsx/-/tsx-4.7.2.tgz#a108b1a6e16876cd4c9a4b4ba263f2a07f9cf562"
+  integrity sha512-BCNd4kz6fz12fyrgCTEdZHGJ9fWTGeUzXmQysh0RVocDY3h4frk05ZNCXSy4kIenF7y/QnrdiVpTsyNRn6vlAw==
+  dependencies:
+    esbuild "~0.19.10"
+    get-tsconfig "^4.7.2"
+  optionalDependencies:
+    fsevents "~2.3.3"
+
 type-detect@4.0.8:
   version "4.0.8"
   resolved "https://registry.yarnpkg.com/type-detect/-/type-detect-4.0.8.tgz#7646fb5f18871cfbb7749e69bd39a6388eb7450c"
@@ -2287,11 +2369,6 @@ update-browserslist-db@^1.0.13:
     escalade "^3.1.1"
     picocolors "^1.0.0"
 
-v8-compile-cache-lib@^3.0.1:
-  version "3.0.1"
-  resolved "https://registry.yarnpkg.com/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz#6336e8d71965cb3d35a1bbb7868445a7c05264bf"
-  integrity sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==
-
 v8-to-istanbul@^9.0.1:
   version "9.2.0"
   resolved "https://registry.yarnpkg.com/v8-to-istanbul/-/v8-to-istanbul-9.2.0.tgz#2ed7644a245cddd83d4e087b9b33b3e62dfd10ad"
@@ -2375,11 +2452,6 @@ yargs@^17.3.1:
     y18n "^5.0.5"
     yargs-parser "^21.1.1"
 
-yn@3.1.1:
-  version "3.1.1"
-  resolved "https://registry.yarnpkg.com/yn/-/yn-3.1.1.tgz#1e87401a09d767c1d5eab26a6e4c185182d2eb50"
-  integrity sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==
-
 yocto-queue@^0.1.0:
   version "0.1.0"
   resolved "https://registry.yarnpkg.com/yocto-queue/-/yocto-queue-0.1.0.tgz#0294eb3dee05028d31ee1a5fa2c556a6aaf10a1b"
diff --git a/package.json b/package.json
index d9ba8647..9cc1c22b 100644
--- a/package.json
+++ b/package.json
@@ -20,7 +20,7 @@
     "eslint-config-airbnb-typescript": "^17.1.0",
     "eslint-plugin-import": "^2.29.0",
     "lerna": "^3.22.1",
-    "ts-node": "^10.9.1",
+    "tsx": "^4.7.2",
     "typescript": "^4.9.5"
   },
   "scripts": {
@@ -32,11 +32,11 @@
     "proof:0.2.0": "yarn cashproof packages/cashc/test/cashproof/0.1.2=0.2.0.equiv",
     "proof": "yarn proof:opt && yarn proof:0.2.0",
     "cashproof": "python3 node_modules/cashproof/run.py",
-    "examples": "ts-node-esm examples/p2pkh.ts && ts-node-esm examples/transfer_with_timeout.ts && ts-node-esm examples/hodl_vault.ts",
+    "examples": "tsx examples/p2pkh.ts && tsx examples/transfer_with_timeout.ts && tsx examples/hodl_vault.ts",
     "coverage": "codecov",
     "postinstall": "lerna bootstrap && lerna run build --ignore cashscript-examples",
     "spellcheck": "cspell lint '**' --no-progress --must-find-files",
-    "update-version": "ts-node-esm update-version.ts",
+    "update-version": "tsx update-version.ts",
     "publish-all": "lerna publish from-package",
     "build": "lerna run build"
   }
diff --git a/yarn.lock b/yarn.lock
index 8904bbf3..830152ee 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -721,6 +721,121 @@
   dependencies:
     "@jridgewell/trace-mapping" "0.3.9"
 
+"@esbuild/aix-ppc64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/aix-ppc64/-/aix-ppc64-0.19.12.tgz#d1bc06aedb6936b3b6d313bf809a5a40387d2b7f"
+  integrity sha512-bmoCYyWdEL3wDQIVbcyzRyeKLgk2WtWLTWz1ZIAZF/EGbNOwSA6ew3PftJ1PqMiOOGu0OyFMzG53L0zqIpPeNA==
+
+"@esbuild/android-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-arm64/-/android-arm64-0.19.12.tgz#7ad65a36cfdb7e0d429c353e00f680d737c2aed4"
+  integrity sha512-P0UVNGIienjZv3f5zq0DP3Nt2IE/3plFzuaS96vihvD0Hd6H/q4WXUGpCxD/E8YrSXfNyRPbpTq+T8ZQioSuPA==
+
+"@esbuild/android-arm@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-arm/-/android-arm-0.19.12.tgz#b0c26536f37776162ca8bde25e42040c203f2824"
+  integrity sha512-qg/Lj1mu3CdQlDEEiWrlC4eaPZ1KztwGJ9B6J+/6G+/4ewxJg7gqj8eVYWvao1bXrqGiW2rsBZFSX3q2lcW05w==
+
+"@esbuild/android-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-x64/-/android-x64-0.19.12.tgz#cb13e2211282012194d89bf3bfe7721273473b3d"
+  integrity sha512-3k7ZoUW6Q6YqhdhIaq/WZ7HwBpnFBlW905Fa4s4qWJyiNOgT1dOqDiVAQFwBH7gBRZr17gLrlFCRzF6jFh7Kew==
+
+"@esbuild/darwin-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/darwin-arm64/-/darwin-arm64-0.19.12.tgz#cbee41e988020d4b516e9d9e44dd29200996275e"
+  integrity sha512-B6IeSgZgtEzGC42jsI+YYu9Z3HKRxp8ZT3cqhvliEHovq8HSX2YX8lNocDn79gCKJXOSaEot9MVYky7AKjCs8g==
+
+"@esbuild/darwin-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/darwin-x64/-/darwin-x64-0.19.12.tgz#e37d9633246d52aecf491ee916ece709f9d5f4cd"
+  integrity sha512-hKoVkKzFiToTgn+41qGhsUJXFlIjxI/jSYeZf3ugemDYZldIXIxhvwN6erJGlX4t5h417iFuheZ7l+YVn05N3A==
+
+"@esbuild/freebsd-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.19.12.tgz#1ee4d8b682ed363b08af74d1ea2b2b4dbba76487"
+  integrity sha512-4aRvFIXmwAcDBw9AueDQ2YnGmz5L6obe5kmPT8Vd+/+x/JMVKCgdcRwH6APrbpNXsPz+K653Qg8HB/oXvXVukA==
+
+"@esbuild/freebsd-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-x64/-/freebsd-x64-0.19.12.tgz#37a693553d42ff77cd7126764b535fb6cc28a11c"
+  integrity sha512-EYoXZ4d8xtBoVN7CEwWY2IN4ho76xjYXqSXMNccFSx2lgqOG/1TBPW0yPx1bJZk94qu3tX0fycJeeQsKovA8gg==
+
+"@esbuild/linux-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm64/-/linux-arm64-0.19.12.tgz#be9b145985ec6c57470e0e051d887b09dddb2d4b"
+  integrity sha512-EoTjyYyLuVPfdPLsGVVVC8a0p1BFFvtpQDB/YLEhaXyf/5bczaGeN15QkR+O4S5LeJ92Tqotve7i1jn35qwvdA==
+
+"@esbuild/linux-arm@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm/-/linux-arm-0.19.12.tgz#207ecd982a8db95f7b5279207d0ff2331acf5eef"
+  integrity sha512-J5jPms//KhSNv+LO1S1TX1UWp1ucM6N6XuL6ITdKWElCu8wXP72l9MM0zDTzzeikVyqFE6U8YAV9/tFyj0ti+w==
+
+"@esbuild/linux-ia32@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-ia32/-/linux-ia32-0.19.12.tgz#d0d86b5ca1562523dc284a6723293a52d5860601"
+  integrity sha512-Thsa42rrP1+UIGaWz47uydHSBOgTUnwBwNq59khgIwktK6x60Hivfbux9iNR0eHCHzOLjLMLfUMLCypBkZXMHA==
+
+"@esbuild/linux-loong64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-loong64/-/linux-loong64-0.19.12.tgz#9a37f87fec4b8408e682b528391fa22afd952299"
+  integrity sha512-LiXdXA0s3IqRRjm6rV6XaWATScKAXjI4R4LoDlvO7+yQqFdlr1Bax62sRwkVvRIrwXxvtYEHHI4dm50jAXkuAA==
+
+"@esbuild/linux-mips64el@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-mips64el/-/linux-mips64el-0.19.12.tgz#4ddebd4e6eeba20b509d8e74c8e30d8ace0b89ec"
+  integrity sha512-fEnAuj5VGTanfJ07ff0gOA6IPsvrVHLVb6Lyd1g2/ed67oU1eFzL0r9WL7ZzscD+/N6i3dWumGE1Un4f7Amf+w==
+
+"@esbuild/linux-ppc64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-ppc64/-/linux-ppc64-0.19.12.tgz#adb67dadb73656849f63cd522f5ecb351dd8dee8"
+  integrity sha512-nYJA2/QPimDQOh1rKWedNOe3Gfc8PabU7HT3iXWtNUbRzXS9+vgB0Fjaqr//XNbd82mCxHzik2qotuI89cfixg==
+
+"@esbuild/linux-riscv64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-riscv64/-/linux-riscv64-0.19.12.tgz#11bc0698bf0a2abf8727f1c7ace2112612c15adf"
+  integrity sha512-2MueBrlPQCw5dVJJpQdUYgeqIzDQgw3QtiAHUC4RBz9FXPrskyyU3VI1hw7C0BSKB9OduwSJ79FTCqtGMWqJHg==
+
+"@esbuild/linux-s390x@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-s390x/-/linux-s390x-0.19.12.tgz#e86fb8ffba7c5c92ba91fc3b27ed5a70196c3cc8"
+  integrity sha512-+Pil1Nv3Umes4m3AZKqA2anfhJiVmNCYkPchwFJNEJN5QxmTs1uzyy4TvmDrCRNT2ApwSari7ZIgrPeUx4UZDg==
+
+"@esbuild/linux-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-x64/-/linux-x64-0.19.12.tgz#5f37cfdc705aea687dfe5dfbec086a05acfe9c78"
+  integrity sha512-B71g1QpxfwBvNrfyJdVDexenDIt1CiDN1TIXLbhOw0KhJzE78KIFGX6OJ9MrtC0oOqMWf+0xop4qEU8JrJTwCg==
+
+"@esbuild/netbsd-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/netbsd-x64/-/netbsd-x64-0.19.12.tgz#29da566a75324e0d0dd7e47519ba2f7ef168657b"
+  integrity sha512-3ltjQ7n1owJgFbuC61Oj++XhtzmymoCihNFgT84UAmJnxJfm4sYCiSLTXZtE00VWYpPMYc+ZQmB6xbSdVh0JWA==
+
+"@esbuild/openbsd-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/openbsd-x64/-/openbsd-x64-0.19.12.tgz#306c0acbdb5a99c95be98bdd1d47c916e7dc3ff0"
+  integrity sha512-RbrfTB9SWsr0kWmb9srfF+L933uMDdu9BIzdA7os2t0TXhCRjrQyCeOt6wVxr79CKD4c+p+YhCj31HBkYcXebw==
+
+"@esbuild/sunos-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/sunos-x64/-/sunos-x64-0.19.12.tgz#0933eaab9af8b9b2c930236f62aae3fc593faf30"
+  integrity sha512-HKjJwRrW8uWtCQnQOz9qcU3mUZhTUQvi56Q8DPTLLB+DawoiQdjsYq+j+D3s9I8VFtDr+F9CjgXKKC4ss89IeA==
+
+"@esbuild/win32-arm64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-arm64/-/win32-arm64-0.19.12.tgz#773bdbaa1971b36db2f6560088639ccd1e6773ae"
+  integrity sha512-URgtR1dJnmGvX864pn1B2YUYNzjmXkuJOIqG2HdU62MVS4EHpU2946OZoTMnRUHklGtJdJZ33QfzdjGACXhn1A==
+
+"@esbuild/win32-ia32@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-ia32/-/win32-ia32-0.19.12.tgz#000516cad06354cc84a73f0943a4aa690ef6fd67"
+  integrity sha512-+ZOE6pUkMOJfmxmBZElNOx72NKpIa/HFOMGzu8fqzQJ5kgf6aTGrcJaFsNiVMH4JKpMipyK+7k0n2UXN7a8YKQ==
+
+"@esbuild/win32-x64@0.19.12":
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-x64/-/win32-x64-0.19.12.tgz#c57c8afbb4054a3ab8317591a0b7320360b444ae"
+  integrity sha512-T1QyPSDCyMXaO3pzBkF96E8xMkiRYbUEZADd29SyPGabqxMViNoii+NcK7eWJAEoU6RZyEm5lVSIjTmcdoB9HA==
+
 "@eslint-community/eslint-utils@^4.2.0", "@eslint-community/eslint-utils@^4.4.0":
   version "4.4.0"
   resolved "https://registry.yarnpkg.com/@eslint-community/eslint-utils/-/eslint-utils-4.4.0.tgz#a23514e8fb9af1269d5f7788aa556798d61c6b59"
@@ -5070,6 +5185,35 @@ es6-promisify@^5.0.0:
   dependencies:
     es6-promise "^4.0.3"
 
+esbuild@~0.19.10:
+  version "0.19.12"
+  resolved "https://registry.yarnpkg.com/esbuild/-/esbuild-0.19.12.tgz#dc82ee5dc79e82f5a5c3b4323a2a641827db3e04"
+  integrity sha512-aARqgq8roFBj054KvQr5f1sFu0D65G+miZRCuJyJ0G13Zwx7vRar5Zhn2tkQNzIXcBrNVsv/8stehpj+GAjgbg==
+  optionalDependencies:
+    "@esbuild/aix-ppc64" "0.19.12"
+    "@esbuild/android-arm" "0.19.12"
+    "@esbuild/android-arm64" "0.19.12"
+    "@esbuild/android-x64" "0.19.12"
+    "@esbuild/darwin-arm64" "0.19.12"
+    "@esbuild/darwin-x64" "0.19.12"
+    "@esbuild/freebsd-arm64" "0.19.12"
+    "@esbuild/freebsd-x64" "0.19.12"
+    "@esbuild/linux-arm" "0.19.12"
+    "@esbuild/linux-arm64" "0.19.12"
+    "@esbuild/linux-ia32" "0.19.12"
+    "@esbuild/linux-loong64" "0.19.12"
+    "@esbuild/linux-mips64el" "0.19.12"
+    "@esbuild/linux-ppc64" "0.19.12"
+    "@esbuild/linux-riscv64" "0.19.12"
+    "@esbuild/linux-s390x" "0.19.12"
+    "@esbuild/linux-x64" "0.19.12"
+    "@esbuild/netbsd-x64" "0.19.12"
+    "@esbuild/openbsd-x64" "0.19.12"
+    "@esbuild/sunos-x64" "0.19.12"
+    "@esbuild/win32-arm64" "0.19.12"
+    "@esbuild/win32-ia32" "0.19.12"
+    "@esbuild/win32-x64" "0.19.12"
+
 escalade@^3.1.1:
   version "3.1.1"
   resolved "https://registry.yarnpkg.com/escalade/-/escalade-3.1.1.tgz#d8cfdc7000965c5a0174b4a82eaa5c0552742e40"
@@ -5908,6 +6052,11 @@ fsevents@^2.1.2, fsevents@^2.3.2:
   resolved "https://registry.yarnpkg.com/fsevents/-/fsevents-2.3.2.tgz#8a526f78b8fdf4623b709e0b975c52c24c02fd1a"
   integrity sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==
 
+fsevents@~2.3.3:
+  version "2.3.3"
+  resolved "https://registry.yarnpkg.com/fsevents/-/fsevents-2.3.3.tgz#cac6407785d03675a2a5e1a5305c697b347d90d6"
+  integrity sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==
+
 function-bind@^1.1.1:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.1.tgz#a56899d3ea3c9bab874bb9773b7c5ede92f4895d"
@@ -6052,6 +6201,13 @@ get-symbol-description@^1.0.0:
     call-bind "^1.0.2"
     get-intrinsic "^1.1.1"
 
+get-tsconfig@^4.7.2:
+  version "4.7.3"
+  resolved "https://registry.yarnpkg.com/get-tsconfig/-/get-tsconfig-4.7.3.tgz#0498163d98f7b58484dd4906999c0c9d5f103f83"
+  integrity sha512-ZvkrzoUA0PQZM6fy6+/Hce561s+faD1rsNwhnO5FelNjyy7EMGJ3Rz1AQ8GYDWjhRs/7dBLOEJvhK8MiEJOAFg==
+  dependencies:
+    resolve-pkg-maps "^1.0.0"
+
 get-value@^2.0.3, get-value@^2.0.6:
   version "2.0.6"
   resolved "https://registry.yarnpkg.com/get-value/-/get-value-2.0.6.tgz#dc15ca1c672387ca76bd37ac0a395ba2042a2c28"
@@ -10177,6 +10333,11 @@ resolve-global@^1.0.0:
   dependencies:
     global-dirs "^0.1.1"
 
+resolve-pkg-maps@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz#616b3dc2c57056b5588c31cdf4b3d64db133720f"
+  integrity sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==
+
 resolve-url@^0.2.1:
   version "0.2.1"
   resolved "https://registry.yarnpkg.com/resolve-url/-/resolve-url-0.2.1.tgz#2c637fe77c893afd2a663fe21aa9080068e2052a"
@@ -11450,6 +11611,16 @@ tslib@^2.3.1:
   resolved "https://registry.yarnpkg.com/tslib/-/tslib-2.6.2.tgz#703ac29425e7b37cd6fd456e92404d46d1f3e4ae"
   integrity sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q==
 
+tsx@^4.7.2:
+  version "4.7.2"
+  resolved "https://registry.yarnpkg.com/tsx/-/tsx-4.7.2.tgz#a108b1a6e16876cd4c9a4b4ba263f2a07f9cf562"
+  integrity sha512-BCNd4kz6fz12fyrgCTEdZHGJ9fWTGeUzXmQysh0RVocDY3h4frk05ZNCXSy4kIenF7y/QnrdiVpTsyNRn6vlAw==
+  dependencies:
+    esbuild "~0.19.10"
+    get-tsconfig "^4.7.2"
+  optionalDependencies:
+    fsevents "~2.3.3"
+
 tunnel-agent@^0.6.0:
   version "0.6.0"
   resolved "https://registry.yarnpkg.com/tunnel-agent/-/tunnel-agent-0.6.0.tgz#27a5dea06b36b04a0a9966774b290868f0fc40fd"

From 9105dbcd300aa6a96f8f5297147572a9a79af6c4 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 15 Apr 2024 12:01:23 +0800
Subject: [PATCH 040/267] Bump version to 0.10.0-next.4

---
 examples/package.json               | 6 +++---
 examples/testing-suite/package.json | 6 +++---
 package.json                        | 9 +++++----
 packages/cashc/package.json         | 4 ++--
 packages/cashc/src/index.ts         | 2 +-
 packages/cashscript/package.json    | 4 ++--
 packages/utils/package.json         | 2 +-
 7 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index d508aefa..163e23b4 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.0-next.3",
+  "version": "0.10.0-next.4",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -14,8 +14,8 @@
     "@bitauth/libauth": "^2.0.0-alpha.8",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
-    "cashc": "^0.10.0-next.3",
-    "cashscript": "^0.10.0-next.3",
+    "cashc": "^0.10.0-next.4",
+    "cashscript": "^0.10.0-next.4",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index e63b70ec..a46037f2 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.0",
+  "version": "0.10.0-next.4",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -25,8 +25,8 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "cashc": "^0.10.0",
-    "cashscript": "^0.10.0"
+    "cashc": "^0.10.0-next.4",
+    "cashscript": "^0.10.0-next.4"
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
diff --git a/package.json b/package.json
index 9cc1c22b..d142a139 100644
--- a/package.json
+++ b/package.json
@@ -4,7 +4,8 @@
   "type": "module",
   "workspaces": [
     "packages/*",
-    "examples"
+    "examples",
+    "examples/testing-suite"
   ],
   "devDependencies": {
     "@jest/reporters": "^26.6.2",
@@ -24,8 +25,8 @@
     "typescript": "^4.9.5"
   },
   "scripts": {
-    "test": "lerna run test --ignore cashscript-examples",
-    "lint": "lerna run lint --ignore cashscript-examples",
+    "test": "lerna run test --ignore cashscript-examples --ignore testing-suite",
+    "lint": "lerna run lint --ignore cashscript-examples --ignore testing-suite",
     "preproof:opt": "cp packages/utils/src/cashproof-optimisations.ts opt.equiv && sed -i '' '/`/d' opt.equiv",
     "proof:opt": "yarn cashproof opt.equiv",
     "postproof:opt": "rm opt.equiv",
@@ -34,7 +35,7 @@
     "cashproof": "python3 node_modules/cashproof/run.py",
     "examples": "tsx examples/p2pkh.ts && tsx examples/transfer_with_timeout.ts && tsx examples/hodl_vault.ts",
     "coverage": "codecov",
-    "postinstall": "lerna bootstrap && lerna run build --ignore cashscript-examples",
+    "postinstall": "lerna bootstrap && lerna run build --ignore cashscript-examples --ignore testing-suite",
     "spellcheck": "cspell lint '**' --no-progress --must-find-files",
     "update-version": "tsx update-version.ts",
     "publish-all": "lerna publish from-package",
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 3999f4c7..54496950 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.0-next.3",
+  "version": "0.10.0-next.4",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0",
-    "@cashscript/utils": "^0.10.0-next.3",
+    "@cashscript/utils": "^0.10.0-next.4",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 37cf20d1..83027743 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.0-next.3';
+export const version = '0.10.0-next.4';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 82de41d2..ea2e8e9f 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.0-next.3",
+  "version": "0.10.0-next.4",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0",
-    "@cashscript/utils": "^0.10.0-next.3",
+    "@cashscript/utils": "^0.10.0-next.4",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 615bdd23..ecb58255 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.0-next.3",
+  "version": "0.10.0-next.4",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From 1b68e4836bfe7f8e573c6c4597536506a2d16a66 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 25 Apr 2024 15:19:52 +0800
Subject: [PATCH 041/267] Fix issue with address/tokenAddress in
 MockNetworkProvider

---
 .../cashscript/src/network/MockNetworkProvider.ts    | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/packages/cashscript/src/network/MockNetworkProvider.ts b/packages/cashscript/src/network/MockNetworkProvider.ts
index 83c6eec8..501ba9b8 100644
--- a/packages/cashscript/src/network/MockNetworkProvider.ts
+++ b/packages/cashscript/src/network/MockNetworkProvider.ts
@@ -2,7 +2,7 @@ import { binToHex, hexToBin } from '@bitauth/libauth';
 import { sha256 } from '@cashscript/utils';
 import { Utxo, Network } from '../interfaces.js';
 import NetworkProvider from './NetworkProvider.js';
-import { randomUtxo } from '../utils.js';
+import { addressToLockScript, randomUtxo } from '../utils.js';
 
 // redeclare the addresses from vars.ts instead of importing them
 const aliceAddress = 'bchtest:qpgjmwev3spwlwkgmyjrr2s2cvlkkzlewq62mzgjnp';
@@ -23,7 +23,8 @@ export default class MockNetworkProvider implements NetworkProvider {
   }
 
   async getUtxos(address: string): Promise<Utxo[]> {
-    return this.utxoMap[address] ?? [];
+    const lockingBytecode = binToHex(addressToLockScript(address));
+    return this.utxoMap[lockingBytecode] ?? [];
   }
 
   async getBlockHeight(): Promise<number> {
@@ -43,11 +44,12 @@ export default class MockNetworkProvider implements NetworkProvider {
   }
 
   addUtxo(address: string, utxo: Utxo): void {
-    if (!this.utxoMap[address]) {
-      this.utxoMap[address] = [];
+    const lockingBytecode = binToHex(addressToLockScript(address));
+    if (!this.utxoMap[lockingBytecode]) {
+      this.utxoMap[lockingBytecode] = [];
     }
 
-    this.utxoMap[address].push(utxo);
+    this.utxoMap[lockingBytecode].push(utxo);
   }
 
   reset(): void {

From 85153a9bc4ae196ee5a00150d7980221c9d17de5 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 25 Apr 2024 16:19:17 +0800
Subject: [PATCH 042/267] Fix bug in require message mapping for NULLFAIL
 signature checks

---
 packages/cashscript/src/Argument.ts          |  2 +-
 packages/cashscript/src/SignatureTemplate.ts |  1 +
 packages/cashscript/src/debugging.ts         |  5 +-
 packages/cashscript/test/debugging.test.ts   | 65 +++++++++++++++++++-
 4 files changed, 69 insertions(+), 4 deletions(-)

diff --git a/packages/cashscript/src/Argument.ts b/packages/cashscript/src/Argument.ts
index e542d5ba..2c1409d5 100644
--- a/packages/cashscript/src/Argument.ts
+++ b/packages/cashscript/src/Argument.ts
@@ -60,7 +60,7 @@ export function encodeArgument(
     type = new BytesType(65);
   }
 
-  // Redefine SIG as a bytes64 so it is included in the size checks below
+  // Redefine DATASIG as a bytes64 so it is included in the size checks below
   // Note that ONLY Schnorr signatures are accepted
   if (type === PrimitiveType.DATASIG && argument.byteLength !== 0) {
     type = new BytesType(64);
diff --git a/packages/cashscript/src/SignatureTemplate.ts b/packages/cashscript/src/SignatureTemplate.ts
index 9879bde8..0e9de359 100644
--- a/packages/cashscript/src/SignatureTemplate.ts
+++ b/packages/cashscript/src/SignatureTemplate.ts
@@ -26,6 +26,7 @@ export default class SignatureTemplate {
     }
   }
 
+  // TODO: Allow signing of non-transaction messages (i.e. don't add the hashtype)
   generateSignature(payload: Uint8Array, bchForkId?: boolean): Uint8Array {
     const signature = this.signatureAlgorithm === SignatureAlgorithm.SCHNORR
       ? secp256k1.signMessageHashSchnorr(this.privateKey, payload) as Uint8Array
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 16518ef6..1f06947d 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -43,8 +43,11 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
 
   // If an error is present in the last step, that means a require statement in the middle of the function failed
   if (lastExecutedDebugStep.error) {
+    const isNullFail = lastExecutedDebugStep.error === AuthenticationErrorCommon.nonNullSignatureFailure;
+    const messageIp = lastExecutedDebugStep.ip + (isNullFail ? 1 : 0);
+
     const requireStatement = (artifact.debug?.requireMessages ?? [])
-      .find((message) => message.ip === lastExecutedDebugStep.ip);
+      .find((message) => message.ip === messageIp);
 
     if (requireStatement) {
       throw new Error(`${artifact.contractName}.cash:${requireStatement.line} Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex} with the following message: ${requireStatement.message}.\n${lastExecutedDebugStep.error}`);
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 7dd51db8..9477bc84 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -1,11 +1,12 @@
 import { compileString } from 'cashc';
-import { Contract, MockNetworkProvider, SignatureTemplate } from '../src/index.js';
+import { Contract, MockNetworkProvider, SignatureAlgorithm, SignatureTemplate } from '../src/index.js';
 import {
   alicePriv, alicePub, bobPriv,
+  bobPub,
 } from './fixture/vars.js';
 import '../src/test/JestExtensions.js';
 import { randomUtxo } from '../src/utils.js';
-import { binToHex } from '@bitauth/libauth';
+import { binToHex, hexToBin } from '@bitauth/libauth';
 
 const CONTRACT_CODE = `
 contract Test() {
@@ -74,6 +75,18 @@ contract Test() {
       require(a + b + c + d + e == 10, "sum should equal 10");
     }
   }
+
+  function test_fail_checksig(sig s, pubkey pk) {
+    require(checkSig(s, pk), "Signatures do not match");
+  }
+
+  function test_fail_checkdatasig(datasig s, bytes message, pubkey pk) {
+    require(checkDataSig(s, message, pk), "Data Signatures do not match");
+  }
+
+  function test_fail_checkmultisig(sig s1, pubkey pk1, sig s2, pubkey pk2) {
+    require(checkMultiSig([s1, s2], [pk1, pk2]), "Multi Signatures do not match");
+  }
 }
 `;
 
@@ -349,6 +362,54 @@ describe('Debugging tests', () => {
         .test_final_require_in_if_statement_with_deep_reassignment().to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith(/sum should equal 10/);
     });
+
+    // test_fail_checksig
+    it('should fail with correct error message when checkSig fails', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const checkSigTransaction = contract.functions
+        .test_fail_checksig(new SignatureTemplate(alicePriv), bobPub).to(contract.address, 1000n);
+      await expect(checkSigTransaction).toFailRequireWith(/Signatures do not match/);
+
+      // TODO: Add test for checksig with a NULL Signature (after we refactor Libauth Template generation)
+      // const checkSigTransactionNullSignature = contract.functions
+      //   .test_fail_checksig('', bobPub).to(contract.address, 1000n);
+      // await expect(checkSigTransactionNullSignature).toFailRequireWith(/Signatures do not match/);
+    });
+
+    // test_fail_checkdatasig
+    it('should fail with correct error message when checkDataSig fails', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const checkDataSigTransaction = contract.functions
+        .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xbeef')).slice(0, -1), '0xbeef', bobPub)
+        .to(contract.address, 1000n);
+      await expect(checkDataSigTransaction).toFailRequireWith(/Data Signatures do not match/);
+
+      const checkDataSigTransactionWrongMessage = contract.functions
+        .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xc0ffee')).slice(0, -1), '0xbeef', alicePub)
+        .to(contract.address, 1000n);
+      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith(/Data Signatures do not match/);
+    });
+
+    // test_fail_checkmultisig
+    // TODO: Add test for checkmultisig (requires ECDSA signatures) after refactoring Libauth Template generation
+    it.skip('should fail with correct error message when checkMultiSig fails', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const checkmultiSigTransaction = contract.functions
+        .test_fail_checkmultisig(
+          new SignatureTemplate(alicePriv, undefined, SignatureAlgorithm.ECDSA),
+          bobPub,
+          new SignatureTemplate(bobPriv, undefined, SignatureAlgorithm.ECDSA),
+          alicePub,
+        )
+        .to(contract.address, 1000n);
+      await expect(checkmultiSigTransaction).toFailRequireWith(/Multi Signatures do not match/);
+    });
   });
 
   describe('JestExtensions', () => {

From d803dc202d04513a362584956b7a105f0817a4e9 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 1 May 2024 10:32:05 +0300
Subject: [PATCH 043/267] Extract formatBitAuthScriptForDebugging in
 LibauthTemplate.ts

---
 packages/cashscript/src/Argument.ts        |  37 ++++-
 packages/cashscript/src/Contract.ts        |  11 +-
 packages/cashscript/src/LibauthTemplate.ts | 157 +++++++++------------
 packages/cashscript/src/utils.ts           |  25 ++++
 packages/utils/src/script.ts               |   2 +-
 5 files changed, 131 insertions(+), 101 deletions(-)

diff --git a/packages/cashscript/src/Argument.ts b/packages/cashscript/src/Argument.ts
index 2c1409d5..1a6f7cb2 100644
--- a/packages/cashscript/src/Argument.ts
+++ b/packages/cashscript/src/Argument.ts
@@ -1,5 +1,6 @@
 import { hexToBin } from '@bitauth/libauth';
 import {
+  Artifact,
   BytesType,
   encodeBool,
   encodeInt,
@@ -10,12 +11,13 @@ import {
 import { TypeError } from './Errors.js';
 import SignatureTemplate from './SignatureTemplate.js';
 
+// TODO: Separate ConstructorArgument (no SignatureTemplate) and FunctionArgument (with SignatureTemplate)
 export type Argument = bigint | boolean | string | Uint8Array | SignatureTemplate;
+export type EncodedArgument = Uint8Array | SignatureTemplate;
 
-export function encodeArgument(
-  argument: Argument,
-  typeStr: string,
-): Uint8Array | SignatureTemplate {
+export type EncodeFunction = (arg: Argument, typeStr: string) => EncodedArgument;
+
+export function encodeArgument(argument: Argument, typeStr: string): EncodedArgument {
   let type = parseType(typeStr);
 
   if (type === PrimitiveType.BOOL) {
@@ -73,3 +75,30 @@ export function encodeArgument(
 
   return argument;
 }
+
+export const encodeConstructorArguments = (
+  artifact: Artifact,
+  constructorArgs: Argument[],
+  encodeFunction: EncodeFunction = encodeArgument,
+): Uint8Array[] => {
+  // Check there's no signature templates in the constructor
+  if (constructorArgs.some((arg) => arg instanceof SignatureTemplate)) {
+    throw new Error('Cannot use signatures in constructor');
+  }
+
+  const encodedArgs = constructorArgs
+    .map((arg, i) => encodeFunction(arg, artifact.constructorInputs[i].type))
+    .reverse();
+
+  return encodedArgs as Uint8Array[];
+};
+
+// Note: BitAuth IDE requires 0 to be encoded as a single byte (rather than the default empty byte array)
+// TODO: Double check this with Pat
+export function encodeArgumentForLibauthTemplate(
+  argument: Argument,
+  typeStr: string,
+): Uint8Array | SignatureTemplate {
+  if (typeStr === PrimitiveType.INT && argument === 0n) return Uint8Array.from([0]);
+  return encodeArgument(argument, typeStr);
+}
diff --git a/packages/cashscript/src/Contract.ts b/packages/cashscript/src/Contract.ts
index 3e2e3355..1b8e9645 100644
--- a/packages/cashscript/src/Contract.ts
+++ b/packages/cashscript/src/Contract.ts
@@ -11,7 +11,7 @@ import {
   scriptToBytecode,
 } from '@cashscript/utils';
 import { Transaction } from './Transaction.js';
-import { Argument, encodeArgument } from './Argument.js';
+import { Argument, encodeArgument, encodeConstructorArguments } from './Argument.js';
 import {
   Unlocker, ContractOptions, GenerateUnlockingBytecodeOptions, Utxo,
 } from './interfaces.js';
@@ -55,14 +55,7 @@ export class Contract {
     }
 
     // Encode arguments (this also performs type checking)
-    const encodedArgs = constructorArgs
-      .map((arg, i) => encodeArgument(arg, artifact.constructorInputs[i].type))
-      .reverse();
-
-    // Check there's no signature templates in the constructor
-    if (encodedArgs.some((arg) => arg instanceof SignatureTemplate)) {
-      throw new Error('Cannot use signatures in constructor');
-    }
+    const encodedArgs = encodeConstructorArguments(artifact, constructorArgs);
 
     this.redeemScript = generateRedeemScript(
       asmToScript(this.artifact.bytecode),
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 225e714d..e049ab13 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -1,5 +1,6 @@
 import {
   AbiFunction,
+  Artifact,
   PrimitiveType,
   bytecodeToScript,
   formatBitAuthScript,
@@ -26,20 +27,12 @@ import {
   Utxo,
   isUtxoP2PKH,
 } from './interfaces.js';
-import { Argument, encodeArgument as csEncodeArgument } from './Argument.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
+import { Argument, encodeArgumentForLibauthTemplate } from './Argument.js';
+import { extendedStringify, snakeCase } from './utils.js';
 
-// all bitauth variables must be in snake case
-const snakeCase = (str: string): string => (
-  str
-    && str
-      .match(
-        /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g,
-      )!
-      .map((s) => s.toLowerCase())
-      .join('_')
-);
+// wtf is this
 const merge = (array: any): any => array.reduce(
   (prev: any, cur: any) => ({
     ...prev,
@@ -48,32 +41,8 @@ const merge = (array: any): any => array.reduce(
   {},
 );
 
-const encodeArgument = (
-  argument: Argument,
-  typeStr: string,
-): Uint8Array | SignatureTemplate => {
-  if (typeStr === PrimitiveType.INT && argument === 0n) {
-    return Uint8Array.from([0]);
-  }
-  return csEncodeArgument(argument, typeStr);
-};
-
-// stringify version which can serialize otherwise unsupported types
-export const stringify = (any: any, spaces?: number): string => JSON.stringify(
-  any,
-  (_, v) => {
-    if (typeof v === 'bigint') {
-      return `${v.toString()}`;
-    }
-    if (v instanceof Uint8Array) {
-      return `${binToHex(v)}`;
-    }
-    return v;
-  },
-  spaces,
-);
+const zip = <T, U>(a: T[], b: U[]): [T, U][] => Array.from(Array(Math.max(b.length, a.length)), (_, i) => [a[i], b[i]]);
 
-const zip = (a: any[], b: any[]): any[] => Array.from(Array(Math.max(b.length, a.length)), (_, i) => [a[i], b[i]]);
 
 const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransaction: Transaction): WalletTemplateScenario['transaction'] => {
   const contract = csTransaction.contract;
@@ -227,24 +196,23 @@ const createScenarioSourceOutputs = (csTransaction: Transaction): Array<WalletTe
   );
 };
 
+interface BuildTemplateOptions {
+  transaction: Transaction;
+  transactionHex?: string;
+}
+
+// TODO: Can we change this so we don't need to pass in both the transaction and the transactionHex?
 export const buildTemplate = async ({
   transaction,
   transactionHex = undefined, // set this argument to prevent unnecessary call `transaction.build()`
-}: {
-  transaction: Transaction;
-  transactionHex?: string;
-}): Promise<WalletTemplate> => {
+}: BuildTemplateOptions): Promise<WalletTemplate> => {
   const contract = transaction.contract;
   const txHex = transactionHex ?? await transaction.build();
 
   const libauthTransaction = decodeTransaction(hexToBin(txHex));
-  if (typeof libauthTransaction === 'string') {
-    throw Error(libauthTransaction);
-  }
+  if (typeof libauthTransaction === 'string') throw Error(libauthTransaction);
 
-  const constructorInputs = contract.artifact.constructorInputs
-    .slice()
-    .reverse();
+  const constructorInputs = contract.artifact.constructorInputs.slice().reverse();
   const contractParameters = contract.constructorArgs.slice().reverse();
 
   const abiFunction = transaction.abiFunction;
@@ -260,19 +228,6 @@ export const buildTemplate = async ({
     (input) => isUtxoP2PKH(input),
   ).length;
 
-  const formattedBytecode = contract.artifact.debug
-    ? formatBitAuthScript(
-      bytecodeToScript(hexToBin(contract.artifact.debug.bytecode)),
-      contract.artifact.debug.sourceMap,
-      contract.artifact.source,
-    ).split('\n')
-    : contract.artifact.bytecode.split(' ').map((asmElement) => {
-      if (isHex(asmElement)) {
-        return `<0x${asmElement}>`;
-      }
-      return asmElement;
-    });
-
   const template = {
     $schema: 'https://ide.bitauth.com/authentication-template-v0.schema.json',
     description: 'Imported from cashscript',
@@ -349,7 +304,7 @@ export const buildTemplate = async ({
           { function_index: functionIndex.toString() },
           ...constructorInputs.map((input, index) => {
             const hex = binToHex(
-              encodeArgument(
+              encodeArgumentForLibauthTemplate(
                 contractParameters[index],
                 constructorInputs[index].type,
               ) as Uint8Array,
@@ -367,9 +322,9 @@ export const buildTemplate = async ({
             ...zip(functionInputs, args)
               .filter(([input]) => input.type === PrimitiveType.SIG)
               .map(([input, arg]) => ({
-                [snakeCase(input.name)]: binToHex(
-                  (arg as SignatureTemplate).privateKey,
-                ),
+                [snakeCase(input.name)]: arg instanceof SignatureTemplate
+                  ? binToHex(arg.privateKey)
+                  : binToHex((arg)), // TODO: Double check if this makes sense
               })),
             ...(hasSignatureTemplates
               ? [
@@ -405,7 +360,7 @@ export const buildTemplate = async ({
               input.name,
             )}.schnorr_signature.all_outputs> // ${input.type}`
             : `<${snakeCase(input.name)}> // ${input.type} = <${
-              `0x${binToHex(arg)}`
+              `0x${binToHex(arg as any)}` // TODO: remove any cast
             }>`))
           : ['// none']),
         '',
@@ -422,26 +377,7 @@ export const buildTemplate = async ({
     lock: {
       lockingType: 'p2sh20', //transaction.contract.addressType,
       name: 'lock',
-      // locking script contains the CashScript contract parameters followed by the contract opcodes
-      // we output these values as pushdata, comment will contain the type and the value of the variable
-      // example: '<timeout> // int = <0xa08601>'
-      script: [
-        `// "${contract.artifact.contractName}" contract constructor parameters`,
-        ...(constructorInputs.length
-          ? constructorInputs.map((input, index) => {
-            const encoded = encodeArgument(
-              contractParameters[index],
-              constructorInputs[index].type,
-            ) as Uint8Array;
-            return `<${snakeCase(input.name)}> // ${
-              input.type === 'bytes' ? `bytes${encoded.length}` : input.type
-            } = <${`0x${binToHex(encoded)}`}>`;
-          })
-          : ['// none']),
-        '',
-        '// bytecode',
-        ...formattedBytecode,
-      ].join('\n'),
+      script: formatBitAuthScriptForDebugging(contract.artifact, contract.constructorArgs),
     },
   };
 
@@ -467,8 +403,55 @@ export const buildTemplate = async ({
 
 export const getBitauthUri = (template: WalletTemplate): string => {
   const base64toBase64Url = (base64: string): string => base64.replace(/\+/g, '-').replace(/\//g, '_');
-  const payload = base64toBase64Url(
-    binToBase64(deflate(utf8ToBin(stringify(template)))),
-  );
+  const payload = base64toBase64Url(binToBase64(deflate(utf8ToBin(extendedStringify(template)))));
   return `https://ide.bitauth.com/import-template/${payload}`;
 };
+
+const formatBitAuthScriptForDebugging = (artifact: Artifact, constructorArguments: Argument[]): string => {
+  // locking script contains the CashScript contract parameters followed by the contract opcodes
+  // we output these values as pushdata, comment will contain the type and the value of the variable
+  return [
+    `// "${artifact.contractName}" contract constructor parameters`,
+    formatConstructorParametersForDebugging(artifact, constructorArguments),
+    '',
+    '// bytecode',
+    formatBytecodeForDebugging(artifact),
+  ].join('\n');
+};
+
+const formatConstructorParametersForDebugging = (artifact: Artifact, constructorArguments: Argument[]): string => {
+  const constructorTypesReversed = [...artifact.constructorInputs].reverse();
+  const constructorArgumentsReversed = [...constructorArguments].reverse();
+
+  if (constructorArgumentsReversed.length === 0) {
+    return '// none';
+  }
+
+  return constructorTypesReversed.map((input, index) => {
+    const encodedArgument = encodeArgumentForLibauthTemplate(
+      constructorArgumentsReversed[index],
+      constructorTypesReversed[index].type,
+    ) as Uint8Array;
+
+    const typeStr = input.type === 'bytes' ? `bytes${encodedArgument.length}` : input.type;
+
+    // e.g. <timeout> // int = <0xa08601>
+    return `<${snakeCase(input.name)}> // ${typeStr} = <${`0x${binToHex(encodedArgument)}`}>`;
+  }).join('\n');
+};
+
+const formatBytecodeForDebugging = (artifact: Artifact): string => {
+  if (!artifact.debug) {
+    // TODO: See if we can merge this with code from @cashscript/utils -> script.ts
+    return artifact.bytecode
+      .split(' ')
+      .map((asmElement) => (isHex(asmElement) ? `<0x${asmElement}>` : asmElement))
+      .join('\n');
+  }
+
+  return formatBitAuthScript(
+    bytecodeToScript(hexToBin(artifact.debug.bytecode)),
+    artifact.debug.sourceMap,
+    artifact.source,
+  );
+};
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index 0569d6aa..6e18fba2 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -376,3 +376,28 @@ export function findLastIndex<T>(array: Array<T>, predicate: (value: T, index: n
   }
   return -1;
 }
+
+export const snakeCase = (str: string): string => (
+  str
+    && str
+      .match(
+        /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g,
+      )!
+      .map((s) => s.toLowerCase())
+      .join('_')
+);
+
+// JSON.stringify version that can serialize otherwise unsupported types (bigint and Uint8Array)
+export const extendedStringify = (obj: any, spaces?: number): string => JSON.stringify(
+  obj,
+  (_, v) => {
+    if (typeof v === 'bigint') {
+      return `${v.toString()}`;
+    }
+    if (v instanceof Uint8Array) {
+      return `${binToHex(v)}`;
+    }
+    return v;
+  },
+  spaces,
+);
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index 638c7e77..b20251fd 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -100,7 +100,7 @@ export function bytecodeToBitAuthAsm(bytecode: Uint8Array): string {
   // Convert the bytecode to libauth's ASM format
   let asm = disassembleBytecodeBCH(bytecode);
 
-  // COnvert libauth's ASM format to BITBOX's
+  // COnvert libauth's ASM format to BitAuth Script ASM
   asm = asm.replace(/OP_PUSHBYTES_[^\s]+/g, '');
   asm = asm.replace(/OP_PUSHDATA[^\s]+ [^\s]+/g, '');
   asm = asm.replace(/(^|\s)(0x\w*)/g, ' \<$2\>');

From 1a442d08a1df3654fcab90762e49c7aa5030207e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 1 May 2024 11:11:27 +0300
Subject: [PATCH 044/267] Extract generateTemplateEntities in
 LibauthTemplate.ts

---
 packages/cashscript/src/LibauthTemplate.ts    | 102 ++++++++++--------
 packages/cashscript/src/utils.ts              |   4 +
 .../test/fixture/libauth-template/fixtures.ts |  20 ----
 3 files changed, 59 insertions(+), 67 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index e049ab13..166dba4b 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -19,6 +19,7 @@ import {
   utf8ToBin,
   isHex,
   WalletTemplateScenarioOutput,
+  WalletTemplateVariable,
 } from '@bitauth/libauth';
 import { deflate } from 'pako';
 import {
@@ -30,16 +31,7 @@ import {
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
 import { Argument, encodeArgumentForLibauthTemplate } from './Argument.js';
-import { extendedStringify, snakeCase } from './utils.js';
-
-// wtf is this
-const merge = (array: any): any => array.reduce(
-  (prev: any, cur: any) => ({
-    ...prev,
-    ...{ [Object.keys(cur)[0]]: cur[Object.keys(cur)[0]] },
-  }),
-  {},
-);
+import { extendedStringify, mergeObjects, snakeCase } from './utils.js';
 
 const zip = <T, U>(a: T[], b: U[]): [T, U][] => Array.from(Array(Math.max(b.length, a.length)), (_, i) => [a[i], b[i]]);
 
@@ -234,43 +226,9 @@ export const buildTemplate = async ({
     name: contract.artifact.contractName,
     supported: ['BCH_SPEC'],
     version: 0,
+    entities: generateTemplateEntities(contract.artifact, abiFunction),
   } as WalletTemplate;
 
-  // declaration of template variables and their types
-  template.entities = {
-    parameters: {
-      description: 'Contract creation and function parameters',
-      name: 'parameters',
-      scripts: [
-        'lock',
-        'unlock_lock',
-      ],
-      variables: merge([
-        ...functionInputs.map((input) => ({
-          [snakeCase(input.name)]: {
-            description: `"${input.name}" parameter of function "${func.name}"`,
-            name: input.name,
-            type: input.type === PrimitiveType.SIG ? 'Key' : 'WalletData',
-          },
-        })),
-        {
-          function_index: {
-            description: 'Script function index to execute',
-            name: 'function_index',
-            type: 'WalletData',
-          },
-        },
-        ...constructorInputs.map((input) => ({
-          [snakeCase(input.name)]: {
-            description: `"${input.name}" parameter of this contract`,
-            name: input.name,
-            type: 'WalletData',
-          },
-        })),
-      ]),
-    },
-  };
-
   // add extra variables for the p2pkh utxos spent together with our contract
   if (hasSignatureTemplates) {
     template.entities.parameters.scripts!.push('p2pkh_placeholder_lock', 'p2pkh_placeholder_unlock');
@@ -291,7 +249,7 @@ export const buildTemplate = async ({
       description: 'An example evaluation where this script execution passes.',
       data: {
         // encode values for the variables defined above in `entities` property
-        bytecode: merge([
+        bytecode: mergeObjects([
           ...zip(functionInputs, args)
             .filter(([input]) => input.type !== PrimitiveType.SIG)
             .map(([input, arg]) => {
@@ -318,7 +276,7 @@ export const buildTemplate = async ({
         currentBlockHeight: 2,
         currentBlockTime: Math.round(+new Date() / 1000),
         keys: {
-          privateKeys: merge([
+          privateKeys: mergeObjects([
             ...zip(functionInputs, args)
               .filter(([input]) => input.type === PrimitiveType.SIG)
               .map(([input, arg]) => ({
@@ -455,3 +413,53 @@ const formatBytecodeForDebugging = (artifact: Artifact): string => {
     artifact.source,
   );
 };
+
+const generateTemplateEntities = (artifact: Artifact, abiFunction: AbiFunction): WalletTemplate['entities'] => {
+  const functionParameters = Object.fromEntries<WalletTemplateVariable>(
+    abiFunction.inputs.map((input) => ([
+      snakeCase(input.name),
+      {
+        description: `"${input.name}" parameter of function "${abiFunction.name}"`,
+        name: input.name,
+        type: input.type === PrimitiveType.SIG ? 'Key' : 'WalletData',
+      },
+    ])),
+  );
+
+  const constructorParameters = Object.fromEntries<WalletTemplateVariable>(
+    artifact.constructorInputs.map((input) => ([
+      snakeCase(input.name),
+      {
+        description: `"${input.name}" parameter of this contract`,
+        name: input.name,
+        type: 'WalletData',
+      },
+    ])),
+  );
+
+  const entities = {
+    parameters: {
+      description: 'Contract creation and function parameters',
+      name: 'parameters',
+      scripts: [
+        'lock',
+        'unlock_lock',
+      ],
+      variables: {
+        ...functionParameters,
+        ...constructorParameters,
+      },
+    },
+  };
+
+  // function_index is a special variable that indicates the function to execute
+  if (artifact.abi.length > 1) {
+    entities.parameters.variables.function_index = {
+      description: 'Script function index to execute',
+      name: 'function_index',
+      type: 'WalletData',
+    };
+  }
+
+  return entities;
+};
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index 6e18fba2..e23e2c81 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -401,3 +401,7 @@ export const extendedStringify = (obj: any, spaces?: number): string => JSON.str
   },
   spaces,
 );
+
+export const mergeObjects = (array: Array<Record<string, any>>): Record<string, any> => {
+  return Object.fromEntries(array.flatMap(Object.entries));
+};
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 3054175a..c66d2a06 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -432,11 +432,6 @@ export const fixtures: Fixture[] = [
               'name': 'pk',
               'type': 'WalletData',
             },
-            'function_index': {
-              'description': 'Script function index to execute',
-              'name': 'function_index',
-              'type': 'WalletData',
-            },
             'pkh': {
               'description': '"pkh" parameter of this contract',
               'name': 'pkh',
@@ -580,11 +575,6 @@ export const fixtures: Fixture[] = [
               'name': 'pk',
               'type': 'WalletData',
             },
-            'function_index': {
-              'description': 'Script function index to execute',
-              'name': 'function_index',
-              'type': 'WalletData',
-            },
             'pkh': {
               'description': '"pkh" parameter of this contract',
               'name': 'pkh',
@@ -739,11 +729,6 @@ export const fixtures: Fixture[] = [
               'name': 'ownerSig',
               'type': 'Key',
             },
-            'function_index': {
-              'description': 'Script function index to execute',
-              'name': 'function_index',
-              'type': 'WalletData',
-            },
             'price_target': {
               'description': '"priceTarget" parameter of this contract',
               'name': 'priceTarget',
@@ -912,11 +897,6 @@ export const fixtures: Fixture[] = [
               'name': 'pk',
               'type': 'WalletData',
             },
-            'function_index': {
-              'description': 'Script function index to execute',
-              'name': 'function_index',
-              'type': 'WalletData',
-            },
             'pkh': {
               'description': '"pkh" parameter of this contract',
               'name': 'pkh',

From ccaf740c2d9503f48c1f27021c42d0c1a817a33d Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 1 May 2024 11:52:04 +0300
Subject: [PATCH 045/267] Extract generateTemplateScripts in LibauthTemplate.ts

---
 packages/cashscript/src/LibauthTemplate.ts | 224 +++++++++++----------
 packages/cashscript/src/utils.ts           |   4 +
 2 files changed, 118 insertions(+), 110 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 166dba4b..0ae4bdf2 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -1,5 +1,6 @@
 import {
   AbiFunction,
+  AbiInput,
   Artifact,
   PrimitiveType,
   bytecodeToScript,
@@ -20,6 +21,8 @@ import {
   isHex,
   WalletTemplateScenarioOutput,
   WalletTemplateVariable,
+  WalletTemplateScriptLocking,
+  WalletTemplateScriptUnlocking,
 } from '@bitauth/libauth';
 import { deflate } from 'pako';
 import {
@@ -31,10 +34,7 @@ import {
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
 import { Argument, encodeArgumentForLibauthTemplate } from './Argument.js';
-import { extendedStringify, mergeObjects, snakeCase } from './utils.js';
-
-const zip = <T, U>(a: T[], b: U[]): [T, U][] => Array.from(Array(Math.max(b.length, a.length)), (_, i) => [a[i], b[i]]);
-
+import { extendedStringify, mergeObjects, snakeCase, zip } from './utils.js';
 
 const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransaction: Transaction): WalletTemplateScenario['transaction'] => {
   const contract = csTransaction.contract;
@@ -216,9 +216,7 @@ export const buildTemplate = async ({
   const functionInputs = func.inputs.slice().reverse();
   const args = transaction.args.slice().reverse();
 
-  const hasSignatureTemplates = transaction.inputs.filter(
-    (input) => isUtxoP2PKH(input),
-  ).length;
+  const hasSignatureTemplates = transaction.inputs.filter((input) => isUtxoP2PKH(input)).length > 0;
 
   const template = {
     $schema: 'https://ide.bitauth.com/authentication-template-v0.schema.json',
@@ -227,6 +225,7 @@ export const buildTemplate = async ({
     supported: ['BCH_SPEC'],
     version: 0,
     entities: generateTemplateEntities(contract.artifact, abiFunction),
+    scripts: generateTemplateScripts(contract.artifact, abiFunction, transaction.args, contract.constructorArgs),
   } as WalletTemplate;
 
   // add extra variables for the p2pkh utxos spent together with our contract
@@ -240,6 +239,21 @@ export const buildTemplate = async ({
         type: 'Key',
       },
     };
+
+    // add extra unlocking and locking script for P2PKH inputs spent alongside our contract
+    // this is needed for correct cross-referrences in the template
+    template.scripts.p2pkh_placeholder_unlock = {
+      name: 'p2pkh_placeholder_unlock',
+      script:
+          '<placeholder_key.schnorr_signature.all_outputs>\n<placeholder_key.public_key>',
+      unlocks: 'p2pkh_placeholder_lock',
+    };
+    template.scripts.p2pkh_placeholder_lock = {
+      lockingType: 'standard',
+      name: 'p2pkh_placeholder_lock',
+      script:
+          'OP_DUP\nOP_HASH160 <$(<placeholder_key.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+    };
   }
 
   template.scenarios = {
@@ -301,61 +315,6 @@ export const buildTemplate = async ({
     },
   };
 
-  // definition of locking scripts and unlocking scripts with their respective bytecode
-  template.scripts = {
-    unlock_lock: {
-      // this unlocking script must pass our only scenario
-      passes: ['evaluate_function'],
-      name: 'unlock',
-      // unlocking script contains the CashScript function parameters and function selector
-      // we output these values as pushdata, comment will contain the type and the value of the variable
-      // example: '<timeout> // int = <0xa08601>'
-      script: [
-        `// "${func.name}" function parameters`,
-        ...(functionInputs.length
-          ? zip(functionInputs, args).map(([input, arg]) => (input.type === PrimitiveType.SIG
-            ? `<${snakeCase(
-              input.name,
-            )}.schnorr_signature.all_outputs> // ${input.type}`
-            : `<${snakeCase(input.name)}> // ${input.type} = <${
-              `0x${binToHex(arg as any)}` // TODO: remove any cast
-            }>`))
-          : ['// none']),
-        '',
-        ...(contract.artifact.abi.length > 1
-          ? [
-            '// function index in contract',
-            `<function_index> // int = <${functionIndex.toString()}>`,
-            '',
-          ]
-          : []),
-      ].join('\n'),
-      unlocks: 'lock',
-    },
-    lock: {
-      lockingType: 'p2sh20', //transaction.contract.addressType,
-      name: 'lock',
-      script: formatBitAuthScriptForDebugging(contract.artifact, contract.constructorArgs),
-    },
-  };
-
-  // add extra unlocking and locking script for P2PKH inputs spent alongside our contract
-  // this is needed for correct cross-referrences in the template
-  if (hasSignatureTemplates) {
-    template.scripts.p2pkh_placeholder_unlock = {
-      name: 'p2pkh_placeholder_unlock',
-      script:
-          '<placeholder_key.schnorr_signature.all_outputs>\n<placeholder_key.public_key>',
-      unlocks: 'p2pkh_placeholder_lock',
-    };
-    template.scripts.p2pkh_placeholder_lock = {
-      lockingType: 'standard',
-      name: 'p2pkh_placeholder_lock',
-      script:
-          'OP_DUP\nOP_HASH160 <$(<placeholder_key.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
-    };
-  }
-
   return template;
 };
 
@@ -365,54 +324,6 @@ export const getBitauthUri = (template: WalletTemplate): string => {
   return `https://ide.bitauth.com/import-template/${payload}`;
 };
 
-const formatBitAuthScriptForDebugging = (artifact: Artifact, constructorArguments: Argument[]): string => {
-  // locking script contains the CashScript contract parameters followed by the contract opcodes
-  // we output these values as pushdata, comment will contain the type and the value of the variable
-  return [
-    `// "${artifact.contractName}" contract constructor parameters`,
-    formatConstructorParametersForDebugging(artifact, constructorArguments),
-    '',
-    '// bytecode',
-    formatBytecodeForDebugging(artifact),
-  ].join('\n');
-};
-
-const formatConstructorParametersForDebugging = (artifact: Artifact, constructorArguments: Argument[]): string => {
-  const constructorTypesReversed = [...artifact.constructorInputs].reverse();
-  const constructorArgumentsReversed = [...constructorArguments].reverse();
-
-  if (constructorArgumentsReversed.length === 0) {
-    return '// none';
-  }
-
-  return constructorTypesReversed.map((input, index) => {
-    const encodedArgument = encodeArgumentForLibauthTemplate(
-      constructorArgumentsReversed[index],
-      constructorTypesReversed[index].type,
-    ) as Uint8Array;
-
-    const typeStr = input.type === 'bytes' ? `bytes${encodedArgument.length}` : input.type;
-
-    // e.g. <timeout> // int = <0xa08601>
-    return `<${snakeCase(input.name)}> // ${typeStr} = <${`0x${binToHex(encodedArgument)}`}>`;
-  }).join('\n');
-};
-
-const formatBytecodeForDebugging = (artifact: Artifact): string => {
-  if (!artifact.debug) {
-    // TODO: See if we can merge this with code from @cashscript/utils -> script.ts
-    return artifact.bytecode
-      .split(' ')
-      .map((asmElement) => (isHex(asmElement) ? `<0x${asmElement}>` : asmElement))
-      .join('\n');
-  }
-
-  return formatBitAuthScript(
-    bytecodeToScript(hexToBin(artifact.debug.bytecode)),
-    artifact.debug.sourceMap,
-    artifact.source,
-  );
-};
 
 const generateTemplateEntities = (artifact: Artifact, abiFunction: AbiFunction): WalletTemplate['entities'] => {
   const functionParameters = Object.fromEntries<WalletTemplateVariable>(
@@ -463,3 +374,96 @@ const generateTemplateEntities = (artifact: Artifact, abiFunction: AbiFunction):
 
   return entities;
 };
+
+const generateTemplateScripts = (
+  artifact: Artifact,
+  abiFunction: AbiFunction,
+  functionArguments: Argument[],
+  constructorArguments: Argument[],
+): WalletTemplate['scripts'] => {
+  // definition of locking scripts and unlocking scripts with their respective bytecode
+  return {
+    unlock_lock: generateTemplateUnlockScript(artifact, abiFunction, functionArguments),
+    lock: generateTemplateLockScript(artifact, constructorArguments),
+  };
+};
+
+const generateTemplateLockScript = (
+  artifact: Artifact,
+  constructorArguments: Argument[],
+): WalletTemplateScriptLocking => {
+  return {
+    lockingType: 'p2sh20', // TODO: use 'transaction.contract.addressType',
+    name: 'lock',
+    script: [
+      `// "${artifact.contractName}" contract constructor parameters`,
+      formatParametersForDebugging(artifact.constructorInputs, constructorArguments),
+      '',
+      '// bytecode',
+      formatBytecodeForDebugging(artifact),
+    ].join('\n'),
+  };
+};
+
+const generateTemplateUnlockScript = (
+  artifact: Artifact,
+  abiFunction: AbiFunction,
+  functionArguments: Argument[],
+): WalletTemplateScriptUnlocking => {
+  const functionIndex = artifact.abi.findIndex((func) => func.name === abiFunction.name);
+
+  const functionIndexString = artifact.abi.length > 1
+    ? ['// function index in contract', `<function_index> // int = <${functionIndex}>`, '']
+    : [];
+
+  return {
+    // this unlocking script must pass our only scenario
+    passes: ['evaluate_function'],
+    name: 'unlock',
+    script: [
+      `// "${abiFunction.name}" function parameters`,
+      formatParametersForDebugging(abiFunction.inputs, functionArguments),
+      '',
+      ...functionIndexString,
+    ].join('\n'),
+    unlocks: 'lock',
+  };
+};
+
+const formatParametersForDebugging = (types: AbiInput[], args: Argument[]): string => {
+  if (types.length === 0) return '// none';
+
+  const typesAndArguments = zip(types, args).reverse();
+
+  return typesAndArguments.map(([input, arg]) => {
+    const encodedArgument = encodeArgumentForLibauthTemplate(arg, input.type);
+    const typeStr = input.type === 'bytes' && encodedArgument instanceof Uint8Array
+      ? `bytes${encodedArgument.length}`
+      : input.type;
+
+    if (encodedArgument instanceof SignatureTemplate) {
+      // TODO: Different signing algorithms / hashtypes
+      return `<${snakeCase(input.name)}.schnorr_signature.all_outputs> // ${input.type}`;
+    }
+
+    // we output these values as pushdata, comment will contain the type and the value of the variable
+    // e.g. <timeout> // int = <0xa08601>
+    return `<${snakeCase(input.name)}> // ${typeStr} = <${`0x${binToHex(encodedArgument)}`}>`;
+  }).join('\n');
+};
+
+const formatBytecodeForDebugging = (artifact: Artifact): string => {
+  if (!artifact.debug) {
+    // TODO: See if we can merge this with code from @cashscript/utils -> script.ts
+    return artifact.bytecode
+      .split(' ')
+      .map((asmElement) => (isHex(asmElement) ? `<0x${asmElement}>` : asmElement))
+      .join('\n');
+  }
+
+  return formatBitAuthScript(
+    bytecodeToScript(hexToBin(artifact.debug.bytecode)),
+    artifact.debug.sourceMap,
+    artifact.source,
+  );
+};
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index e23e2c81..c81d0200 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -405,3 +405,7 @@ export const extendedStringify = (obj: any, spaces?: number): string => JSON.str
 export const mergeObjects = (array: Array<Record<string, any>>): Record<string, any> => {
   return Object.fromEntries(array.flatMap(Object.entries));
 };
+
+export const zip = <T, U>(a: T[], b: U[]): [T, U][] => (
+  Array.from(Array(Math.max(b.length, a.length)), (_, i) => [a[i], b[i]])
+);

From 79fc5d08bc7deb97751966a138fff90ffe9e359c Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 2 May 2024 13:44:05 +0300
Subject: [PATCH 046/267] Extract generateTemplateScenarioParameterValues and
 generateTemplateScenarioKeys in LibauthTemplate.ts

---
 packages/cashscript/src/LibauthTemplate.ts    |  90 ++++++------
 packages/cashscript/src/utils.ts              |   4 -
 .../test/fixture/libauth-template/fixtures.ts | 129 +++++++++++++++++-
 3 files changed, 167 insertions(+), 56 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 0ae4bdf2..ed254295 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -34,7 +34,7 @@ import {
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
 import { Argument, encodeArgumentForLibauthTemplate } from './Argument.js';
-import { extendedStringify, mergeObjects, snakeCase, zip } from './utils.js';
+import { extendedStringify, snakeCase, zip } from './utils.js';
 
 const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransaction: Transaction): WalletTemplateScenario['transaction'] => {
   const contract = csTransaction.contract;
@@ -204,9 +204,6 @@ export const buildTemplate = async ({
   const libauthTransaction = decodeTransaction(hexToBin(txHex));
   if (typeof libauthTransaction === 'string') throw Error(libauthTransaction);
 
-  const constructorInputs = contract.artifact.constructorInputs.slice().reverse();
-  const contractParameters = contract.constructorArgs.slice().reverse();
-
   const abiFunction = transaction.abiFunction;
   const funcName = abiFunction.name;
   const functionIndex = contract.artifact.abi.findIndex(
@@ -263,51 +260,14 @@ export const buildTemplate = async ({
       description: 'An example evaluation where this script execution passes.',
       data: {
         // encode values for the variables defined above in `entities` property
-        bytecode: mergeObjects([
-          ...zip(functionInputs, args)
-            .filter(([input]) => input.type !== PrimitiveType.SIG)
-            .map(([input, arg]) => {
-              const hex = binToHex(arg as Uint8Array);
-              const result = hex.length ? `0x${hex}` : hex;
-              return {
-                [snakeCase(input.name)]: result,
-              };
-            }),
-          { function_index: functionIndex.toString() },
-          ...constructorInputs.map((input, index) => {
-            const hex = binToHex(
-              encodeArgumentForLibauthTemplate(
-                contractParameters[index],
-                constructorInputs[index].type,
-              ) as Uint8Array,
-            );
-            const result = hex.length ? `0x${hex}` : hex;
-            return {
-              [snakeCase(input.name)]: result,
-            };
-          }),
-        ]),
+        bytecode: {
+          ...generateTemplateScenarioParametersValues(abiFunction.inputs, transaction.args),
+          ...generateTemplateScenarioParametersValues(contract.artifact.constructorInputs, contract.constructorArgs),
+        },
         currentBlockHeight: 2,
         currentBlockTime: Math.round(+new Date() / 1000),
         keys: {
-          privateKeys: mergeObjects([
-            ...zip(functionInputs, args)
-              .filter(([input]) => input.type === PrimitiveType.SIG)
-              .map(([input, arg]) => ({
-                [snakeCase(input.name)]: arg instanceof SignatureTemplate
-                  ? binToHex(arg.privateKey)
-                  : binToHex((arg)), // TODO: Double check if this makes sense
-              })),
-            ...(hasSignatureTemplates
-              ? [
-                {
-                  // placeholder will be replaced by a key for each respective P2PKH input spent
-                  placeholder_key:
-                      '<Uint8Array: 0x0000000000000000000000000000000000000000000000000000000000000000>',
-                },
-              ]
-              : []),
-          ]),
+          privateKeys: generateTemplateScenarioKeys(functionInputs, args, hasSignatureTemplates),
         },
       },
       transaction: createScenarioTransaction(libauthTransaction, transaction),
@@ -315,6 +275,10 @@ export const buildTemplate = async ({
     },
   };
 
+  if (contract.artifact.abi.length > 1) {
+    template.scenarios!.evaluate_function!.data!.bytecode!.function_index = functionIndex.toString();
+  }
+
   return template;
 };
 
@@ -430,6 +394,40 @@ const generateTemplateUnlockScript = (
   };
 };
 
+const generateTemplateScenarioParametersValues = (types: AbiInput[], args: Argument[]): Record<string, string> => {
+  const typesAndArguments = zip(types, args);
+
+  const entries = typesAndArguments
+    // SignatureTemplates are handled by the 'keys' object in the scenario
+    .filter(([, arg]) => !(arg instanceof SignatureTemplate))
+    .map(([input, arg]) => {
+      const encodedArgument = binToHex(encodeArgumentForLibauthTemplate(arg, input.type) as Uint8Array);
+      // TODO: Is this really necessary?
+      const prefixedEncodedArgument = encodedArgument.length ? `0x${encodedArgument}` : encodedArgument;
+      return [snakeCase(input.name), prefixedEncodedArgument] as const;
+    });
+
+  return Object.fromEntries(entries);
+};
+
+const generateTemplateScenarioKeys = (
+  types: AbiInput[],
+  args: Argument[],
+  hasSignatureTemplates: boolean,
+): Record<string, string> => {
+  const typesAndArguments = zip(types, args);
+
+  const entries = typesAndArguments
+    .filter(([, arg]) => arg instanceof SignatureTemplate)
+    .map(([input, arg]) => ([snakeCase(input.name), binToHex((arg as SignatureTemplate).privateKey)] as const));
+
+  const placeholderKey = hasSignatureTemplates
+    ? [['placeholder_key', '0x0000000000000000000000000000000000000000000000000000000000000000']]
+    : [];
+
+  return Object.fromEntries([...entries, ...placeholderKey]);
+};
+
 const formatParametersForDebugging = (types: AbiInput[], args: Argument[]): string => {
   if (types.length === 0) return '// none';
 
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index c81d0200..a6098b69 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -402,10 +402,6 @@ export const extendedStringify = (obj: any, spaces?: number): string => JSON.str
   spaces,
 );
 
-export const mergeObjects = (array: Array<Record<string, any>>): Record<string, any> => {
-  return Object.fromEntries(array.flatMap(Object.entries));
-};
-
 export const zip = <T, U>(a: T[], b: U[]): [T, U][] => (
   Array.from(Array(Math.max(b.length, a.length)), (_, i) => [a[i], b[i]])
 );
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index c66d2a06..c950f999 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -4,7 +4,7 @@ import Mecenas from '../mecenas.json' assert { type: 'json' };
 import P2PKH from '../p2pkh.json' assert { type: 'json' };
 import HoldVault from '../hodl_vault.json' assert { type: 'json' };
 import { aliceAddress, alicePkh, alicePriv, alicePub, bobPkh, bobPriv, bobPub, oracle, oraclePub } from '../vars.js';
-import { WalletTemplate } from '@bitauth/libauth';
+import { WalletTemplate, hexToBin } from '@bitauth/libauth';
 
 const provider = new MockNetworkProvider();
 
@@ -447,7 +447,6 @@ export const fixtures: Fixture[] = [
           'data': {
             'bytecode': {
               'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
-              'function_index': '0',
               'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
             },
             'currentBlockHeight': 2,
@@ -527,6 +526,127 @@ export const fixtures: Fixture[] = [
       },
     },
   },
+  {
+    name: 'P2PKH (hardcoded signature)',
+    transaction: (() => {
+      const contract = new Contract(P2PKH, [alicePkh], { provider });
+
+      const regularUtxo = randomUtxo();
+      provider.addUtxo(contract.address, regularUtxo);
+
+      const to = contract.tokenAddress;
+      const amount = 1000n;
+
+      const hardcodedSignature = new SignatureTemplate(alicePriv).generateSignature(hexToBin('c0ffee'));
+      const tx = contract.functions
+        .spend(alicePub, hardcodedSignature)
+        .from(regularUtxo)
+        .to(to, amount);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'P2PKH',
+      'supported': [
+        'BCH_SPEC',
+      ],
+      'version': 0,
+      'entities': {
+        'parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'parameters',
+          'scripts': [
+            'lock',
+            'unlock_lock',
+          ],
+          'variables': {
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scenarios': {
+        'evaluate_function': {
+          'name': 'Evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              's': '0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {},
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+      'scripts': {
+        'unlock_lock': {
+          'passes': [
+            'evaluate_function',
+          ],
+          'name': 'unlock',
+          'script': '// "spend" function parameters\n<s> // sig = <0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61>\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'lock',
+        },
+        'lock': {
+          'lockingType': 'p2sh20',
+          'name': 'lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+      },
+    },
+  },
   {
     name: 'P2PKH (sending NFTs)',
     transaction: (() => {
@@ -590,7 +710,6 @@ export const fixtures: Fixture[] = [
           'data': {
             'bytecode': {
               'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
-              'function_index': '0',
               'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
             },
             'currentBlockHeight': 2,
@@ -760,7 +879,6 @@ export const fixtures: Fixture[] = [
             'bytecode': {
               'oracle_message': '0xa086010030750000',
               'oracle_sig': '0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b',
-              'function_index': '0',
               'price_target': '0x3075',
               'min_block': '0xb88201',
               'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -917,7 +1035,6 @@ export const fixtures: Fixture[] = [
           'data': {
             'bytecode': {
               'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
-              'function_index': '0',
               'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
             },
             'currentBlockHeight': 2,
@@ -925,7 +1042,7 @@ export const fixtures: Fixture[] = [
             'keys': {
               'privateKeys': {
                 's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
-                'placeholder_key': '<Uint8Array: 0x0000000000000000000000000000000000000000000000000000000000000000>',
+                'placeholder_key': '0x0000000000000000000000000000000000000000000000000000000000000000',
               },
             },
           },

From 4b3ff47a71271fad64f3621148694015b68cf66a Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 2 May 2024 15:33:35 +0300
Subject: [PATCH 047/267] Fix bug with double-encoding function arguments in
 LibauthTemplate.ts

---
 packages/cashscript/src/Argument.ts           |  14 ++-
 packages/cashscript/src/Contract.ts           |  15 ++-
 packages/cashscript/src/LibauthTemplate.ts    |  68 ++++++------
 packages/cashscript/src/Transaction.ts        |   5 +-
 packages/cashscript/src/utils.ts              |   2 +-
 .../cashscript/test/e2e/Announcement.test.ts  |   4 +-
 packages/utils/src/script.ts                  |   4 +-
 yarn.lock                                     | 102 ++----------------
 8 files changed, 69 insertions(+), 145 deletions(-)

diff --git a/packages/cashscript/src/Argument.ts b/packages/cashscript/src/Argument.ts
index 1a6f7cb2..43bb57d2 100644
--- a/packages/cashscript/src/Argument.ts
+++ b/packages/cashscript/src/Argument.ts
@@ -1,5 +1,6 @@
 import { hexToBin } from '@bitauth/libauth';
 import {
+  AbiFunction,
   Artifact,
   BytesType,
   encodeBool,
@@ -87,12 +88,21 @@ export const encodeConstructorArguments = (
   }
 
   const encodedArgs = constructorArgs
-    .map((arg, i) => encodeFunction(arg, artifact.constructorInputs[i].type))
-    .reverse();
+    .map((arg, i) => encodeFunction(arg, artifact.constructorInputs[i].type));
 
   return encodedArgs as Uint8Array[];
 };
 
+export const encodeFunctionArguments = (
+  abiFunction: AbiFunction,
+  functionArgs: Argument[],
+  encodeFunction: EncodeFunction = encodeArgument,
+): EncodedArgument[] => {
+  const encodedArgs = functionArgs.map((arg, i) => encodeFunction(arg, abiFunction.inputs[i].type));
+
+  return encodedArgs;
+};
+
 // Note: BitAuth IDE requires 0 to be encoded as a single byte (rather than the default empty byte array)
 // TODO: Double check this with Pat
 export function encodeArgumentForLibauthTemplate(
diff --git a/packages/cashscript/src/Contract.ts b/packages/cashscript/src/Contract.ts
index 1b8e9645..2bffa792 100644
--- a/packages/cashscript/src/Contract.ts
+++ b/packages/cashscript/src/Contract.ts
@@ -11,7 +11,7 @@ import {
   scriptToBytecode,
 } from '@cashscript/utils';
 import { Transaction } from './Transaction.js';
-import { Argument, encodeArgument, encodeConstructorArguments } from './Argument.js';
+import { Argument, encodeArgument, encodeConstructorArguments, encodeFunctionArguments } from './Argument.js';
 import {
   Unlocker, ContractOptions, GenerateUnlockingBytecodeOptions, Utxo,
 } from './interfaces.js';
@@ -36,10 +36,11 @@ export class Contract {
   redeemScript: Script;
   public provider: NetworkProvider;
   public addressType: 'p2sh20' | 'p2sh32';
+  public encodedConstructorArgs: Uint8Array[];
 
   constructor(
     public artifact: Artifact,
-    public constructorArgs: Argument[],
+    constructorArgs: Argument[],
     private options?: ContractOptions,
   ) {
     this.provider = this.options?.provider ?? new ElectrumNetworkProvider();
@@ -55,12 +56,9 @@ export class Contract {
     }
 
     // Encode arguments (this also performs type checking)
-    const encodedArgs = encodeConstructorArguments(artifact, constructorArgs);
+    this.encodedConstructorArgs = encodeConstructorArguments(artifact, constructorArgs);
 
-    this.redeemScript = generateRedeemScript(
-      asmToScript(this.artifact.bytecode),
-      encodedArgs as Uint8Array[],
-    );
+    this.redeemScript = generateRedeemScript(asmToScript(this.artifact.bytecode), this.encodedConstructorArgs);
 
     // Populate the functions object with the contract's functions
     // (with a special case for single function, which has no "function selector")
@@ -110,8 +108,7 @@ export class Contract {
       }
 
       // Encode passed args (this also performs type checking)
-      const encodedArgs = args
-        .map((arg, i) => encodeArgument(arg, abiFunction.inputs[i].type));
+      const encodedArgs = encodeFunctionArguments(abiFunction, args);
 
       const unlocker = this.createUnlocker(abiFunction, selector)(...args);
 
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index ed254295..7093ba8c 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -33,7 +33,7 @@ import {
 } from './interfaces.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
-import { Argument, encodeArgumentForLibauthTemplate } from './Argument.js';
+import { EncodedArgument } from './Argument.js';
 import { extendedStringify, snakeCase, zip } from './utils.js';
 
 const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransaction: Transaction): WalletTemplateScenario['transaction'] => {
@@ -204,14 +204,9 @@ export const buildTemplate = async ({
   const libauthTransaction = decodeTransaction(hexToBin(txHex));
   if (typeof libauthTransaction === 'string') throw Error(libauthTransaction);
 
-  const abiFunction = transaction.abiFunction;
-  const funcName = abiFunction.name;
   const functionIndex = contract.artifact.abi.findIndex(
-    (func) => func.name === funcName,
+    (func) => func.name === transaction.abiFunction.name,
   )!;
-  const func: AbiFunction = contract.artifact.abi[functionIndex];
-  const functionInputs = func.inputs.slice().reverse();
-  const args = transaction.args.slice().reverse();
 
   const hasSignatureTemplates = transaction.inputs.filter((input) => isUtxoP2PKH(input)).length > 0;
 
@@ -221,8 +216,10 @@ export const buildTemplate = async ({
     name: contract.artifact.contractName,
     supported: ['BCH_SPEC'],
     version: 0,
-    entities: generateTemplateEntities(contract.artifact, abiFunction),
-    scripts: generateTemplateScripts(contract.artifact, abiFunction, transaction.args, contract.constructorArgs),
+    entities: generateTemplateEntities(contract.artifact, transaction.abiFunction),
+    scripts: generateTemplateScripts(
+      contract.artifact, transaction.abiFunction, transaction.encodedFunctionArgs, contract.encodedConstructorArgs,
+    ),
   } as WalletTemplate;
 
   // add extra variables for the p2pkh utxos spent together with our contract
@@ -261,13 +258,17 @@ export const buildTemplate = async ({
       data: {
         // encode values for the variables defined above in `entities` property
         bytecode: {
-          ...generateTemplateScenarioParametersValues(abiFunction.inputs, transaction.args),
-          ...generateTemplateScenarioParametersValues(contract.artifact.constructorInputs, contract.constructorArgs),
+          ...generateTemplateScenarioParametersValues(transaction.abiFunction.inputs, transaction.encodedFunctionArgs),
+          ...generateTemplateScenarioParametersValues(
+            contract.artifact.constructorInputs, contract.encodedConstructorArgs,
+          ),
         },
         currentBlockHeight: 2,
         currentBlockTime: Math.round(+new Date() / 1000),
         keys: {
-          privateKeys: generateTemplateScenarioKeys(functionInputs, args, hasSignatureTemplates),
+          privateKeys: generateTemplateScenarioKeys(
+            transaction.abiFunction.inputs, transaction.encodedFunctionArgs, hasSignatureTemplates,
+          ),
         },
       },
       transaction: createScenarioTransaction(libauthTransaction, transaction),
@@ -342,19 +343,19 @@ const generateTemplateEntities = (artifact: Artifact, abiFunction: AbiFunction):
 const generateTemplateScripts = (
   artifact: Artifact,
   abiFunction: AbiFunction,
-  functionArguments: Argument[],
-  constructorArguments: Argument[],
+  encodedFunctionArgs: EncodedArgument[],
+  encodedConstructorArgs: EncodedArgument[],
 ): WalletTemplate['scripts'] => {
   // definition of locking scripts and unlocking scripts with their respective bytecode
   return {
-    unlock_lock: generateTemplateUnlockScript(artifact, abiFunction, functionArguments),
-    lock: generateTemplateLockScript(artifact, constructorArguments),
+    unlock_lock: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs),
+    lock: generateTemplateLockScript(artifact, encodedConstructorArgs),
   };
 };
 
 const generateTemplateLockScript = (
   artifact: Artifact,
-  constructorArguments: Argument[],
+  constructorArguments: EncodedArgument[],
 ): WalletTemplateScriptLocking => {
   return {
     lockingType: 'p2sh20', // TODO: use 'transaction.contract.addressType',
@@ -372,7 +373,7 @@ const generateTemplateLockScript = (
 const generateTemplateUnlockScript = (
   artifact: Artifact,
   abiFunction: AbiFunction,
-  functionArguments: Argument[],
+  encodedFunctionArgs: EncodedArgument[],
 ): WalletTemplateScriptUnlocking => {
   const functionIndex = artifact.abi.findIndex((func) => func.name === abiFunction.name);
 
@@ -386,7 +387,7 @@ const generateTemplateUnlockScript = (
     name: 'unlock',
     script: [
       `// "${abiFunction.name}" function parameters`,
-      formatParametersForDebugging(abiFunction.inputs, functionArguments),
+      formatParametersForDebugging(abiFunction.inputs, encodedFunctionArgs),
       '',
       ...functionIndexString,
     ].join('\n'),
@@ -394,16 +395,19 @@ const generateTemplateUnlockScript = (
   };
 };
 
-const generateTemplateScenarioParametersValues = (types: AbiInput[], args: Argument[]): Record<string, string> => {
-  const typesAndArguments = zip(types, args);
+const generateTemplateScenarioParametersValues = (
+  types: AbiInput[],
+  encodedArgs: EncodedArgument[],
+): Record<string, string> => {
+  const typesAndArguments = zip(types, encodedArgs);
 
   const entries = typesAndArguments
     // SignatureTemplates are handled by the 'keys' object in the scenario
     .filter(([, arg]) => !(arg instanceof SignatureTemplate))
     .map(([input, arg]) => {
-      const encodedArgument = binToHex(encodeArgumentForLibauthTemplate(arg, input.type) as Uint8Array);
+      const encodedArgumentHex = binToHex(arg as Uint8Array);
       // TODO: Is this really necessary?
-      const prefixedEncodedArgument = encodedArgument.length ? `0x${encodedArgument}` : encodedArgument;
+      const prefixedEncodedArgument = encodedArgumentHex.length ? `0x${encodedArgumentHex}` : encodedArgumentHex;
       return [snakeCase(input.name), prefixedEncodedArgument] as const;
     });
 
@@ -412,10 +416,10 @@ const generateTemplateScenarioParametersValues = (types: AbiInput[], args: Argum
 
 const generateTemplateScenarioKeys = (
   types: AbiInput[],
-  args: Argument[],
+  encodedArgs: EncodedArgument[],
   hasSignatureTemplates: boolean,
 ): Record<string, string> => {
-  const typesAndArguments = zip(types, args);
+  const typesAndArguments = zip(types, encodedArgs);
 
   const entries = typesAndArguments
     .filter(([, arg]) => arg instanceof SignatureTemplate)
@@ -428,25 +432,23 @@ const generateTemplateScenarioKeys = (
   return Object.fromEntries([...entries, ...placeholderKey]);
 };
 
-const formatParametersForDebugging = (types: AbiInput[], args: Argument[]): string => {
+const formatParametersForDebugging = (types: AbiInput[], args: EncodedArgument[]): string => {
   if (types.length === 0) return '// none';
 
+  // We reverse the arguments because the order of the arguments in the bytecode is reversed
   const typesAndArguments = zip(types, args).reverse();
 
   return typesAndArguments.map(([input, arg]) => {
-    const encodedArgument = encodeArgumentForLibauthTemplate(arg, input.type);
-    const typeStr = input.type === 'bytes' && encodedArgument instanceof Uint8Array
-      ? `bytes${encodedArgument.length}`
-      : input.type;
-
-    if (encodedArgument instanceof SignatureTemplate) {
+    if (arg instanceof SignatureTemplate) {
       // TODO: Different signing algorithms / hashtypes
       return `<${snakeCase(input.name)}.schnorr_signature.all_outputs> // ${input.type}`;
     }
 
+    const typeStr = input.type === 'bytes' ? `bytes${arg.length}` : input.type;
+
     // we output these values as pushdata, comment will contain the type and the value of the variable
     // e.g. <timeout> // int = <0xa08601>
-    return `<${snakeCase(input.name)}> // ${typeStr} = <${`0x${binToHex(encodedArgument)}`}>`;
+    return `<${snakeCase(input.name)}> // ${typeStr} = <${`0x${binToHex(arg)}`}>`;
   }).join('\n');
 };
 
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 085bca66..7f6cdf4d 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -42,6 +42,7 @@ import { Contract } from './Contract.js';
 import MockNetworkProvider from './network/MockNetworkProvider.js';
 import { buildTemplate, getBitauthUri } from './LibauthTemplate.js';
 import { debugTemplate, evaluateTemplate, DebugResult } from './debugging.js';
+import { EncodedArgument } from './Argument.js';
 
 export class Transaction {
   public inputs: Utxo[] = [];
@@ -58,7 +59,7 @@ export class Transaction {
     public contract: Contract,
     private unlocker: Unlocker,
     public abiFunction: AbiFunction,
-    public args: (Uint8Array | SignatureTemplate)[],
+    public encodedFunctionArgs: EncodedArgument[],
     private selector?: number,
   ) {}
 
@@ -357,7 +358,7 @@ export class Transaction {
     }
 
     // Replace all SignatureTemplate with 65-length placeholder Uint8Arrays
-    const placeholderArgs = this.args.map((arg) => (
+    const placeholderArgs = this.encodedFunctionArgs.map((arg) => (
       arg instanceof SignatureTemplate ? placeholder(65) : arg
     ));
 
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index a6098b69..e2b52c74 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -168,7 +168,7 @@ export function createInputScript(
   preimage?: Uint8Array,
 ): Uint8Array {
   // Create unlock script / redeemScriptSig (add potential preimage and selector)
-  const unlockScript = encodedArgs.reverse();
+  const unlockScript = [...encodedArgs].reverse();
   if (preimage !== undefined) unlockScript.push(preimage);
   if (selector !== undefined) unlockScript.push(encodeInt(BigInt(selector)));
 
diff --git a/packages/cashscript/test/e2e/Announcement.test.ts b/packages/cashscript/test/e2e/Announcement.test.ts
index 0545df21..57065130 100644
--- a/packages/cashscript/test/e2e/Announcement.test.ts
+++ b/packages/cashscript/test/e2e/Announcement.test.ts
@@ -104,11 +104,11 @@ describe('Announcement', () => {
     it('should fail when sending the correct change amount to an incorrect address', async () => {
       // given
       const str = 'A contract may not injure a human being or, through inaction, allow a human being to come to harm.';
-      const largestUtxo = (await announcement.getUtxos())
+      const [largestUtxo] = (await announcement.getUtxos())
         .sort(utxoComparator)
         .reverse()
         .slice(0, 1);
-      const changeAmount = largestUtxo[0]?.satoshis - minerFee;
+      const changeAmount = largestUtxo?.satoshis - minerFee;
 
       // when
       const txPromise = announcement.functions
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index b20251fd..63095d4d 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -186,8 +186,8 @@ export function replaceBytecodeNop(script: Script): Script {
   return asmToScript(scriptToAsm(script));
 }
 
-export function generateRedeemScript(baseScript: Script, encodedArgs: Script): Script {
-  return replaceBytecodeNop([...encodedArgs, ...baseScript]);
+export function generateRedeemScript(baseScript: Script, encodedConstructorArgs: Script): Script {
+  return replaceBytecodeNop([...encodedConstructorArgs.slice().reverse(), ...baseScript]);
 }
 
 export function optimiseBytecode(script: Script, runs: number = 1000): Script {
diff --git a/yarn.lock b/yarn.lock
index 830152ee..0fb4e534 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -714,13 +714,6 @@
   resolved "https://registry.yarnpkg.com/@cspell/dict-typescript/-/dict-typescript-1.0.16.tgz#18d20a91c4caf52540c795921a50b0e4ce3bc50c"
   integrity sha512-DEKi6vD605ebDhCC4Hrtz29k59TcijPVsmVKheTpMrL1MD/S96Ftb19gW0pEIVK9vwYZIljmGwgz4qYyuM5Liw==
 
-"@cspotcode/source-map-support@^0.8.0":
-  version "0.8.1"
-  resolved "https://registry.yarnpkg.com/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz#00629c35a688e05a88b1cda684fb9d5e73f000a1"
-  integrity sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==
-  dependencies:
-    "@jridgewell/trace-mapping" "0.3.9"
-
 "@esbuild/aix-ppc64@0.19.12":
   version "0.19.12"
   resolved "https://registry.yarnpkg.com/@esbuild/aix-ppc64/-/aix-ppc64-0.19.12.tgz#d1bc06aedb6936b3b6d313bf809a5a40387d2b7f"
@@ -1348,14 +1341,6 @@
   resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.13.tgz#b6461fb0c2964356c469e115f504c95ad97ab88c"
   integrity sha512-GryiOJmNcWbovBxTfZSF71V/mXbgcV3MewDe3kIMCLyIh5e7SKAeUZs+rMnJ8jkMolZ/4/VsdBmMrw3l+VdZ3w==
 
-"@jridgewell/trace-mapping@0.3.9":
-  version "0.3.9"
-  resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz#6534fd5933a53ba7cbf3a17615e273a0d1273ff9"
-  integrity sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==
-  dependencies:
-    "@jridgewell/resolve-uri" "^3.0.3"
-    "@jridgewell/sourcemap-codec" "^1.4.10"
-
 "@jridgewell/trace-mapping@^0.3.12", "@jridgewell/trace-mapping@^0.3.15":
   version "0.3.17"
   resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.17.tgz#793041277af9073b0951a7fe0f0d8c4c98c36985"
@@ -2356,26 +2341,6 @@
   resolved "https://registry.yarnpkg.com/@transloadit/prettier-bytes/-/prettier-bytes-0.0.7.tgz#cdb5399f445fdd606ed833872fa0cabdbc51686b"
   integrity sha512-VeJbUb0wEKbcwaSlj5n+LscBl9IPgLPkHVGBkh00cztv6X4L/TJXK58LzFuBKX7/GAfiGhIwH67YTLTlzvIzBA==
 
-"@tsconfig/node10@^1.0.7":
-  version "1.0.9"
-  resolved "https://registry.yarnpkg.com/@tsconfig/node10/-/node10-1.0.9.tgz#df4907fc07a886922637b15e02d4cebc4c0021b2"
-  integrity sha512-jNsYVVxU8v5g43Erja32laIDHXeoNvFEpX33OK4d6hljo3jDhCBDhx5dhCCTMWUojscpAagGiRkBKxpdl9fxqA==
-
-"@tsconfig/node12@^1.0.7":
-  version "1.0.11"
-  resolved "https://registry.yarnpkg.com/@tsconfig/node12/-/node12-1.0.11.tgz#ee3def1f27d9ed66dac6e46a295cffb0152e058d"
-  integrity sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==
-
-"@tsconfig/node14@^1.0.0":
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/@tsconfig/node14/-/node14-1.0.3.tgz#e4386316284f00b98435bf40f72f75a09dabf6c1"
-  integrity sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==
-
-"@tsconfig/node16@^1.0.2":
-  version "1.0.4"
-  resolved "https://registry.yarnpkg.com/@tsconfig/node16/-/node16-1.0.4.tgz#0b92dcc0cc1c81f6f306a381f28e31b1a56536e9"
-  integrity sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==
-
 "@types/babel__core@^7.1.14":
   version "7.20.0"
   resolved "https://registry.yarnpkg.com/@types/babel__core/-/babel__core-7.20.0.tgz#61bc5a4cae505ce98e1e36c5445e4bee060d8891"
@@ -2456,6 +2421,14 @@
     expect "^29.0.0"
     pretty-format "^29.0.0"
 
+"@types/jest@^29.4.1":
+  version "29.5.12"
+  resolved "https://registry.yarnpkg.com/@types/jest/-/jest-29.5.12.tgz#7f7dc6eb4cf246d2474ed78744b05d06ce025544"
+  integrity sha512-eDC8bTvT/QhYdxJAulQikueigY5AsdBRH2yDKW3yveW7svY3+DzN84/2NUgkw10RTiJbWqZrTtoGVdYlvFJdLw==
+  dependencies:
+    expect "^29.0.0"
+    pretty-format "^29.0.0"
+
 "@types/json-schema@^7.0.12":
   version "7.0.15"
   resolved "https://registry.yarnpkg.com/@types/json-schema/-/json-schema-7.0.15.tgz#596a1747233694d50f6ad8a7869fcb6f56cf5841"
@@ -2748,11 +2721,6 @@ acorn-jsx@^5.3.2:
   resolved "https://registry.yarnpkg.com/acorn-jsx/-/acorn-jsx-5.3.2.tgz#7ed5bb55908b3b2f1bc55c6af1653bada7f07937"
   integrity sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==
 
-acorn-walk@^8.1.1:
-  version "8.2.0"
-  resolved "https://registry.yarnpkg.com/acorn-walk/-/acorn-walk-8.2.0.tgz#741210f2e2426454508853a2f44d0ab83b7f69c1"
-  integrity sha512-k+iyHEuPgSw6SbuDpGQM+06HQUa04DZ3o+F6CSzXMvvI5KMvnaEqXe+YVe555R9nn6GPt404fos4wcgpw12SDA==
-
 acorn@^3.0.4:
   version "3.3.0"
   resolved "https://registry.yarnpkg.com/acorn/-/acorn-3.3.0.tgz#45e37fb39e8da3f25baee3ff5369e2bb5f22017a"
@@ -2763,11 +2731,6 @@ acorn@^5.5.0:
   resolved "https://registry.yarnpkg.com/acorn/-/acorn-5.7.4.tgz#3e8d8a9947d0599a1796d10225d7432f4a4acf5e"
   integrity sha512-1D++VG7BhrtvQpNbBzovKNc1FLGGEE/oGe7b9xJm/RFHMBeUaUGpluV9RLjZa47YFdPcDAenEYuq9pQPcMdLJg==
 
-acorn@^8.4.1:
-  version "8.8.2"
-  resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.8.2.tgz#1b2f25db02af965399b9776b0c2c391276d37c4a"
-  integrity sha512-xjIYgE8HBrkpd/sJqOGNspf8uHG+NOHGOw6a/Urj8taM2EXfdNAH2oFcPeIFfsv3+kz/mJrS5VuMqbNLjCa2vw==
-
 acorn@^8.9.0:
   version "8.11.2"
   resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.11.2.tgz#ca0d78b51895be5390a5903c5b3bdcdaf78ae40b"
@@ -2980,11 +2943,6 @@ are-we-there-yet@~1.1.2:
     delegates "^1.0.0"
     readable-stream "^2.0.6"
 
-arg@^4.1.0:
-  version "4.1.3"
-  resolved "https://registry.yarnpkg.com/arg/-/arg-4.1.3.tgz#269fc7ad5b8e42cb63c896d5666017261c144089"
-  integrity sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==
-
 argparse@^1.0.7:
   version "1.0.10"
   resolved "https://registry.yarnpkg.com/argparse/-/argparse-1.0.10.tgz#bcd6791ea5ae09725e17e5ad988134cd40b3d911"
@@ -4437,11 +4395,6 @@ create-hmac@^1.1.3, create-hmac@^1.1.4:
     safe-buffer "^5.0.1"
     sha.js "^2.4.8"
 
-create-require@^1.1.0:
-  version "1.1.1"
-  resolved "https://registry.yarnpkg.com/create-require/-/create-require-1.1.1.tgz#c1d7e8f1e5f6cfc9ff65f9cd352d37348756c333"
-  integrity sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==
-
 cross-spawn@^5.1.0:
   version "5.1.0"
   resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-5.1.0.tgz#e8bd0efee58fcff6f8f94510a0a554bbfa235449"
@@ -4811,11 +4764,6 @@ diff-sequences@^29.4.2:
   resolved "https://registry.yarnpkg.com/diff-sequences/-/diff-sequences-29.4.2.tgz#711fe6bd8a5869fe2539cee4a5152425ff671fda"
   integrity sha512-R6P0Y6PrsH3n4hUXxL3nns0rbRk6Q33js3ygJBeEpbzLzgcNuJ61+u0RXasFpTKISw99TxUzFnumSnRLsjhLaw==
 
-diff@^4.0.1:
-  version "4.0.2"
-  resolved "https://registry.yarnpkg.com/diff/-/diff-4.0.2.tgz#60f3aecb89d5fae520c11aa19efc2bb982aade7d"
-  integrity sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==
-
 dijkstrajs@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/dijkstrajs/-/dijkstrajs-1.0.1.tgz#d3cd81221e3ea40742cfcde556d4e99e98ddc71b"
@@ -8423,11 +8371,6 @@ make-dir@^3.0.0, make-dir@^3.0.2:
   dependencies:
     semver "^6.0.0"
 
-make-error@^1.1.1:
-  version "1.3.6"
-  resolved "https://registry.yarnpkg.com/make-error/-/make-error-1.3.6.tgz#2eb2e37ea9b67c4891f684a1394799af484cf7a2"
-  integrity sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==
-
 make-fetch-happen@^5.0.0:
   version "5.0.2"
   resolved "https://registry.yarnpkg.com/make-fetch-happen/-/make-fetch-happen-5.0.2.tgz#aa8387104f2687edca01c8687ee45013d02d19bd"
@@ -11572,25 +11515,6 @@ ts-api-utils@^1.0.1:
   resolved "https://registry.yarnpkg.com/ts-api-utils/-/ts-api-utils-1.0.3.tgz#f12c1c781d04427313dbac808f453f050e54a331"
   integrity sha512-wNMeqtMz5NtwpT/UZGY5alT+VoKdSsOOP/kqHFcUW1P/VRhH2wJ48+DN2WwUliNbQ976ETwDL0Ifd2VVvgonvg==
 
-ts-node@^10.9.1:
-  version "10.9.1"
-  resolved "https://registry.yarnpkg.com/ts-node/-/ts-node-10.9.1.tgz#e73de9102958af9e1f0b168a6ff320e25adcff4b"
-  integrity sha512-NtVysVPkxxrwFGUUxGYhfux8k78pQB3JqYBXlLRZgdGUqTO5wU/UyHop5p70iEbGhB7q5KmiZiU0Y3KlJrScEw==
-  dependencies:
-    "@cspotcode/source-map-support" "^0.8.0"
-    "@tsconfig/node10" "^1.0.7"
-    "@tsconfig/node12" "^1.0.7"
-    "@tsconfig/node14" "^1.0.0"
-    "@tsconfig/node16" "^1.0.2"
-    acorn "^8.4.1"
-    acorn-walk "^8.1.1"
-    arg "^4.1.0"
-    create-require "^1.1.0"
-    diff "^4.0.1"
-    make-error "^1.1.1"
-    v8-compile-cache-lib "^3.0.1"
-    yn "3.1.1"
-
 tsconfig-paths@^3.14.2:
   version "3.14.2"
   resolved "https://registry.yarnpkg.com/tsconfig-paths/-/tsconfig-paths-3.14.2.tgz#6e32f1f79412decd261f92d633a9dc1cfa99f088"
@@ -11938,11 +11862,6 @@ uuid@^8.3.0:
   resolved "https://registry.yarnpkg.com/uuid/-/uuid-8.3.2.tgz#80d5b5ced271bb9af6c445f21a1a04c606cefbe2"
   integrity sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==
 
-v8-compile-cache-lib@^3.0.1:
-  version "3.0.1"
-  resolved "https://registry.yarnpkg.com/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz#6336e8d71965cb3d35a1bbb7868445a7c05264bf"
-  integrity sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==
-
 v8-to-istanbul@^7.0.0:
   version "7.1.2"
   resolved "https://registry.yarnpkg.com/v8-to-istanbul/-/v8-to-istanbul-7.1.2.tgz#30898d1a7fa0c84d225a2c1434fb958f290883c1"
@@ -12397,11 +12316,6 @@ yeast@0.1.2:
   resolved "https://registry.yarnpkg.com/yeast/-/yeast-0.1.2.tgz#008e06d8094320c372dbc2f8ed76a0ca6c8ac419"
   integrity sha1-AI4G2AlDIMNy28L47XagymyKxBk=
 
-yn@3.1.1:
-  version "3.1.1"
-  resolved "https://registry.yarnpkg.com/yn/-/yn-3.1.1.tgz#1e87401a09d767c1d5eab26a6e4c185182d2eb50"
-  integrity sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==
-
 yocto-queue@^0.1.0:
   version "0.1.0"
   resolved "https://registry.yarnpkg.com/yocto-queue/-/yocto-queue-0.1.0.tgz#0294eb3dee05028d31ee1a5fa2c556a6aaf10a1b"

From 0b69ed9966995e07454f3dc258757e7be0bb6fd0 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 23 May 2024 11:30:42 +0200
Subject: [PATCH 048/267] Add instructions for running tests to DEVELOPMENT.md

---
 DEVELOPMENT.md | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index 6589007a..cb7aed62 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -32,4 +32,22 @@ When updating the grammar file in `src/grammar/CashScript.g4`, we also need to m
 
 ```bash
 yarn antlr
-``````
+```
+
+## cashscript
+
+### Running tests
+
+By default, running tests in the `cashscript` package uses chipnet contracts, which requires the test accounts to have some chipnet BCH. To run the tests against a local "mock network", you can use the `TESTS_USE_MOCKNET` environment variable.
+
+```bash
+# Run all tests using the mock network
+TESTS_USE_MOCKNET=true yarn test
+```
+
+To run specific tests, you can use the `-t` flag to match the name mentioned in the `it` or `describe` block:
+
+```bash
+# Run all tests in the 'Transaction Builder' describe block (test/e2e/transaction-builder/TransactionBuilder.test.ts)
+yarn test -t 'Transaction Builder'
+```

From 9467ec0ee0478b6ecd366260f707d2c093b72978 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 23 May 2024 11:31:07 +0200
Subject: [PATCH 049/267] Extract generateTemplateScenarios in
 LibauthTemplate.ts

---
 packages/cashscript/src/LibauthTemplate.ts | 92 +++++++++++++---------
 1 file changed, 55 insertions(+), 37 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 7093ba8c..e0267d77 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -201,13 +201,6 @@ export const buildTemplate = async ({
   const contract = transaction.contract;
   const txHex = transactionHex ?? await transaction.build();
 
-  const libauthTransaction = decodeTransaction(hexToBin(txHex));
-  if (typeof libauthTransaction === 'string') throw Error(libauthTransaction);
-
-  const functionIndex = contract.artifact.abi.findIndex(
-    (func) => func.name === transaction.abiFunction.name,
-  )!;
-
   const hasSignatureTemplates = transaction.inputs.filter((input) => isUtxoP2PKH(input)).length > 0;
 
   const template = {
@@ -220,6 +213,15 @@ export const buildTemplate = async ({
     scripts: generateTemplateScripts(
       contract.artifact, transaction.abiFunction, transaction.encodedFunctionArgs, contract.encodedConstructorArgs,
     ),
+    scenarios: generateTemplateScenarios(
+      transaction,
+      txHex,
+      contract.artifact,
+      transaction.abiFunction,
+      transaction.encodedFunctionArgs,
+      contract.encodedConstructorArgs,
+      hasSignatureTemplates,
+    ),
   } as WalletTemplate;
 
   // add extra variables for the p2pkh utxos spent together with our contract
@@ -250,36 +252,6 @@ export const buildTemplate = async ({
     };
   }
 
-  template.scenarios = {
-    // single scenario to spend out transaction under test given the CashScript parameters provided
-    evaluate_function: {
-      name: 'Evaluate',
-      description: 'An example evaluation where this script execution passes.',
-      data: {
-        // encode values for the variables defined above in `entities` property
-        bytecode: {
-          ...generateTemplateScenarioParametersValues(transaction.abiFunction.inputs, transaction.encodedFunctionArgs),
-          ...generateTemplateScenarioParametersValues(
-            contract.artifact.constructorInputs, contract.encodedConstructorArgs,
-          ),
-        },
-        currentBlockHeight: 2,
-        currentBlockTime: Math.round(+new Date() / 1000),
-        keys: {
-          privateKeys: generateTemplateScenarioKeys(
-            transaction.abiFunction.inputs, transaction.encodedFunctionArgs, hasSignatureTemplates,
-          ),
-        },
-      },
-      transaction: createScenarioTransaction(libauthTransaction, transaction),
-      sourceOutputs: createScenarioSourceOutputs(transaction),
-    },
-  };
-
-  if (contract.artifact.abi.length > 1) {
-    template.scenarios!.evaluate_function!.data!.bytecode!.function_index = functionIndex.toString();
-  }
-
   return template;
 };
 
@@ -395,6 +367,52 @@ const generateTemplateUnlockScript = (
   };
 };
 
+const generateTemplateScenarios = (
+  transaction: Transaction,
+  transactionHex: string,
+  artifact: Artifact,
+  abiFunction: AbiFunction,
+  encodedFunctionArgs: EncodedArgument[],
+  encodedConstructorArgs: EncodedArgument[],
+  hasSignatureTemplates: boolean,
+): WalletTemplate['scenarios'] => {
+  const libauthTransaction = decodeTransaction(hexToBin(transactionHex));
+  if (typeof libauthTransaction === 'string') throw Error(libauthTransaction);
+
+  const scenarios = {
+    // single scenario to spend out transaction under test given the CashScript parameters provided
+    evaluate_function: {
+      name: 'Evaluate',
+      description: 'An example evaluation where this script execution passes.',
+      data: {
+        // encode values for the variables defined above in `entities` property
+        bytecode: {
+          ...generateTemplateScenarioParametersValues(abiFunction.inputs, encodedFunctionArgs),
+          ...generateTemplateScenarioParametersValues(artifact.constructorInputs, encodedConstructorArgs),
+        },
+        // TODO: Don't hardcode these values
+        currentBlockHeight: 2,
+        currentBlockTime: Math.round(+new Date() / 1000),
+        keys: {
+          privateKeys: generateTemplateScenarioKeys(
+            abiFunction.inputs, encodedFunctionArgs, hasSignatureTemplates,
+          ),
+        },
+      },
+      transaction: createScenarioTransaction(libauthTransaction, transaction),
+      sourceOutputs: createScenarioSourceOutputs(transaction),
+    },
+  };
+
+
+  if (artifact.abi.length > 1) {
+    const functionIndex = artifact.abi.findIndex((func) => func.name === transaction.abiFunction.name);
+    scenarios!.evaluate_function!.data!.bytecode!.function_index = functionIndex.toString();
+  }
+
+  return scenarios;
+};
+
 const generateTemplateScenarioParametersValues = (
   types: AbiInput[],
   encodedArgs: EncodedArgument[],

From b05cd4d86f6ed1459112476bc0c4db4c4f73c612 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 23 May 2024 12:07:48 +0200
Subject: [PATCH 050/267] Refactor createScenarioSourceOutputs

---
 packages/cashscript/src/LibauthTemplate.ts | 293 ++++++++++-----------
 1 file changed, 140 insertions(+), 153 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index e0267d77..127faf9c 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -36,158 +36,6 @@ import { Transaction } from './Transaction.js';
 import { EncodedArgument } from './Argument.js';
 import { extendedStringify, snakeCase, zip } from './utils.js';
 
-const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransaction: Transaction): WalletTemplateScenario['transaction'] => {
-  const contract = csTransaction.contract;
-  const result = ({} as WalletTemplateScenario['transaction'])!;
-
-  // only one 'slot' is allowed, otherwise {} must be used
-  let inputSlotInserted = false;
-  result.inputs = libauthTransaction.inputs.map((input, index) => {
-    const csInput = csTransaction.inputs[index] as Utxo;
-    const signable = isUtxoP2PKH(csInput);
-    let unlockingBytecode = {};
-    if (signable) {
-      unlockingBytecode = {
-        script: 'p2pkh_placeholder_unlock',
-        overrides: {
-          keys: {
-            privateKeys: {
-              placeholder_key: binToHex((csInput as UtxoP2PKH).template.privateKey),
-            },
-          },
-        },
-      };
-    } else {
-      // assume it is our contract's input
-      // eslint-disable-next-line
-      if (!inputSlotInserted) {
-        unlockingBytecode = ['slot'];
-        inputSlotInserted = true;
-      }
-    }
-    return {
-      outpointIndex: input.outpointIndex,
-      outpointTransactionHash:
-        input.outpointTransactionHash instanceof Uint8Array
-          ? binToHex(input.outpointTransactionHash)
-          : input.outpointTransactionHash,
-      sequenceNumber: input.sequenceNumber,
-      unlockingBytecode,
-    } as WalletTemplateScenarioInput;
-  });
-  result.locktime = libauthTransaction.locktime;
-
-  result.outputs = libauthTransaction.outputs.map(
-    (output: LibauthOutput, index) => {
-      const csOutput = csTransaction.outputs[index];
-      let { lockingBytecode }: any = output;
-      if (typeof csOutput.to === 'string') {
-        if (
-          [
-            contract.address,
-            contract.tokenAddress,
-          ].includes(csOutput.to)
-        ) {
-          lockingBytecode = {};
-        } else {
-          for (const csInput of csTransaction.inputs) {
-            if (isUtxoP2PKH(csInput)) {
-              const inputPkh = hash160(csInput.template.getPublicKey());
-              if (
-                binToHex(output.lockingBytecode).slice(6, 46)
-                === binToHex(inputPkh)
-              ) {
-                lockingBytecode = {
-                  script: 'p2pkh_placeholder_lock',
-                  overrides: {
-                    keys: {
-                      privateKeys: {
-                        placeholder_key: binToHex(
-                          csInput.template.privateKey,
-                        ),
-                      },
-                    },
-                  },
-                };
-              }
-            }
-          }
-        }
-      }
-      return {
-        lockingBytecode:
-          lockingBytecode instanceof Uint8Array
-            ? binToHex(lockingBytecode)
-            : lockingBytecode,
-        token: output.token ? {
-          amount: output.token.amount.toString(),
-          category: binToHex(output.token.category),
-          nft: output.token.nft ? {
-            capability: output.token.nft.capability,
-            commitment: binToHex(output.token.nft.commitment),
-          } : undefined,
-        } : undefined,
-        valueSatoshis: Number(output.valueSatoshis),
-      } as WalletTemplateScenarioTransactionOutput;
-    },
-  );
-  result.version = libauthTransaction.version;
-  return result;
-};
-
-const createScenarioSourceOutputs = (csTransaction: Transaction): Array<WalletTemplateScenarioOutput<true>> => {
-  // only one 'slot' is allowed, otherwise {} must be used
-  let inputSlotInserted = false;
-  return csTransaction.inputs.map(
-    (csInput) => {
-      const signable = isUtxoP2PKH(csInput);
-      let lockingBytecode = {} as WalletTemplateScenarioOutput<true>['lockingBytecode'];
-      if (signable) {
-        lockingBytecode = {
-          script: 'p2pkh_placeholder_lock',
-          overrides: {
-            keys: {
-              privateKeys: {
-                placeholder_key: binToHex(
-                  csInput.template.privateKey,
-                ),
-              },
-            },
-          },
-        };
-      } else {
-        // assume it is our contract's input
-        // eslint-disable-next-line
-        if (!inputSlotInserted) {
-          lockingBytecode = ['slot'];
-          inputSlotInserted = true;
-        }
-      }
-
-      const result = {
-        lockingBytecode: lockingBytecode,
-        valueSatoshis: Number(csInput.satoshis),
-      } as WalletTemplateScenarioOutput<true>;
-
-      if (csInput.token) {
-        result.token = {
-          amount: csInput.token.amount.toString(),
-          category: csInput.token.category,
-        };
-
-        if (csInput.token.nft) {
-          result.token.nft = {
-            capability: csInput.token.nft.capability,
-            commitment: csInput.token.nft.commitment,
-          };
-        }
-      }
-
-      return result;
-    },
-  );
-};
-
 interface BuildTemplateOptions {
   transaction: Transaction;
   transactionHex?: string;
@@ -400,7 +248,7 @@ const generateTemplateScenarios = (
         },
       },
       transaction: createScenarioTransaction(libauthTransaction, transaction),
-      sourceOutputs: createScenarioSourceOutputs(transaction),
+      sourceOutputs: generateScenarioSourceOutputs(transaction),
     },
   };
 
@@ -413,6 +261,145 @@ const generateTemplateScenarios = (
   return scenarios;
 };
 
+const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransaction: Transaction): WalletTemplateScenario['transaction'] => {
+  const contract = csTransaction.contract;
+  const result = ({} as WalletTemplateScenario['transaction'])!;
+
+  // only one 'slot' is allowed, otherwise {} must be used
+  let inputSlotInserted = false;
+  result.inputs = libauthTransaction.inputs.map((input, index) => {
+    const csInput = csTransaction.inputs[index] as Utxo;
+    const signable = isUtxoP2PKH(csInput);
+    let unlockingBytecode = {};
+    if (signable) {
+      unlockingBytecode = {
+        script: 'p2pkh_placeholder_unlock',
+        overrides: {
+          keys: {
+            privateKeys: {
+              placeholder_key: binToHex((csInput as UtxoP2PKH).template.privateKey),
+            },
+          },
+        },
+      };
+    } else {
+      // assume it is our contract's input
+      // eslint-disable-next-line
+      if (!inputSlotInserted) {
+        unlockingBytecode = ['slot'];
+        inputSlotInserted = true;
+      }
+    }
+    return {
+      outpointIndex: input.outpointIndex,
+      outpointTransactionHash:
+        input.outpointTransactionHash instanceof Uint8Array
+          ? binToHex(input.outpointTransactionHash)
+          : input.outpointTransactionHash,
+      sequenceNumber: input.sequenceNumber,
+      unlockingBytecode,
+    } as WalletTemplateScenarioInput;
+  });
+  result.locktime = libauthTransaction.locktime;
+
+  result.outputs = libauthTransaction.outputs.map(
+    (output: LibauthOutput, index) => {
+      const csOutput = csTransaction.outputs[index];
+      let { lockingBytecode }: any = output;
+      if (typeof csOutput.to === 'string') {
+        if (
+          [
+            contract.address,
+            contract.tokenAddress,
+          ].includes(csOutput.to)
+        ) {
+          lockingBytecode = {};
+        } else {
+          for (const csInput of csTransaction.inputs) {
+            if (isUtxoP2PKH(csInput)) {
+              const inputPkh = hash160(csInput.template.getPublicKey());
+              if (
+                binToHex(output.lockingBytecode).slice(6, 46)
+                === binToHex(inputPkh)
+              ) {
+                lockingBytecode = {
+                  script: 'p2pkh_placeholder_lock',
+                  overrides: {
+                    keys: {
+                      privateKeys: {
+                        placeholder_key: binToHex(
+                          csInput.template.privateKey,
+                        ),
+                      },
+                    },
+                  },
+                };
+              }
+            }
+          }
+        }
+      }
+      return {
+        lockingBytecode:
+          lockingBytecode instanceof Uint8Array
+            ? binToHex(lockingBytecode)
+            : lockingBytecode,
+        token: output.token ? {
+          amount: output.token.amount.toString(),
+          category: binToHex(output.token.category),
+          nft: output.token.nft ? {
+            capability: output.token.nft.capability,
+            commitment: binToHex(output.token.nft.commitment),
+          } : undefined,
+        } : undefined,
+        valueSatoshis: Number(output.valueSatoshis),
+      } as WalletTemplateScenarioTransactionOutput;
+    },
+  );
+  result.version = libauthTransaction.version;
+  return result;
+};
+
+const generateScenarioSourceOutputs = (csTransaction: Transaction): Array<WalletTemplateScenarioOutput<true>> => {
+  const slotIndex = csTransaction.inputs.findIndex((input) => !isUtxoP2PKH(input));
+
+  return csTransaction.inputs.map((input, index) => {
+    const lockingBytecode = generateTemplateScenarioSourceOutputLockingBytecode(input, index === slotIndex);
+    const valueSatoshis = Number(input.satoshis);
+
+    if (input.token) {
+      const token = {
+        amount: input.token.amount.toString(),
+        category: input.token.category,
+        nft: input.token.nft,
+      };
+
+      return { lockingBytecode, valueSatoshis, token };
+    }
+
+    return { lockingBytecode, valueSatoshis };
+  });
+};
+
+const generateTemplateScenarioSourceOutputLockingBytecode = (
+  input: Utxo, insertSlot?: boolean,
+): WalletTemplateScenarioOutput<true>['lockingBytecode'] => {
+  if (isUtxoP2PKH(input)) {
+    return {
+      script: 'p2pkh_placeholder_lock',
+      overrides: {
+        keys: {
+          privateKeys: {
+            placeholder_key: binToHex(input.template.privateKey),
+          },
+        },
+      },
+    };
+  }
+
+  return insertSlot ? ['slot'] : {};
+};
+
 const generateTemplateScenarioParametersValues = (
   types: AbiInput[],
   encodedArgs: EncodedArgument[],

From 287e57300faa809581dc15bc0d310271973753e9 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 28 May 2024 10:50:25 +0200
Subject: [PATCH 051/267] Refactor createScenarioTransaction

We simplified the transaction outputs by just encoding the output's
address as a lock script, rather than using `{}` or the P2PKH script.
This caused some issues due to Libauth's incorrect handling (or not
handling) P2SH32 lock scripts. This should be addressed before release.
---
 packages/cashscript/src/LibauthTemplate.ts    | 190 +++++++-----------
 packages/cashscript/src/debugging.ts          |   4 +-
 .../test/fixture/libauth-template/fixtures.ts |  26 +--
 3 files changed, 93 insertions(+), 127 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 127faf9c..fa4dd447 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -7,7 +7,6 @@ import {
   formatBitAuthScript,
 } from '@cashscript/utils';
 import {
-  hash160,
   hexToBin,
   WalletTemplateScenarioTransactionOutput,
   WalletTemplateScenario,
@@ -23,18 +22,20 @@ import {
   WalletTemplateVariable,
   WalletTemplateScriptLocking,
   WalletTemplateScriptUnlocking,
+  WalletTemplateScenarioBytecode,
 } from '@bitauth/libauth';
 import { deflate } from 'pako';
 import {
-  UtxoP2PKH,
-  LibauthOutput,
   Utxo,
   isUtxoP2PKH,
+  TokenDetails,
+  LibauthTokenDetails,
+  Output,
 } from './interfaces.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
 import { EncodedArgument } from './Argument.js';
-import { extendedStringify, snakeCase, zip } from './utils.js';
+import { addressToLockScript, extendedStringify, snakeCase, zip } from './utils.js';
 
 interface BuildTemplateOptions {
   transaction: Transaction;
@@ -247,8 +248,8 @@ const generateTemplateScenarios = (
           ),
         },
       },
-      transaction: createScenarioTransaction(libauthTransaction, transaction),
-      sourceOutputs: generateScenarioSourceOutputs(transaction),
+      transaction: generateTemplateScenarioTransaction(libauthTransaction, transaction),
+      sourceOutputs: generateTemplateScenarioSourceOutputs(transaction),
     },
   };
 
@@ -261,132 +262,72 @@ const generateTemplateScenarios = (
   return scenarios;
 };
 
-const createScenarioTransaction = (libauthTransaction: TransactionBCH, csTransaction: Transaction): WalletTemplateScenario['transaction'] => {
-  const contract = csTransaction.contract;
-  const result = ({} as WalletTemplateScenario['transaction'])!;
-
-  // only one 'slot' is allowed, otherwise {} must be used
-  let inputSlotInserted = false;
-  result.inputs = libauthTransaction.inputs.map((input, index) => {
-    const csInput = csTransaction.inputs[index] as Utxo;
-    const signable = isUtxoP2PKH(csInput);
-    let unlockingBytecode = {};
-    if (signable) {
-      unlockingBytecode = {
-        script: 'p2pkh_placeholder_unlock',
-        overrides: {
-          keys: {
-            privateKeys: {
-              placeholder_key: binToHex((csInput as UtxoP2PKH).template.privateKey),
-            },
-          },
-        },
-      };
-    } else {
-      // assume it is our contract's input
-      // eslint-disable-next-line
-      if (!inputSlotInserted) {
-        unlockingBytecode = ['slot'];
-        inputSlotInserted = true;
-      }
-    }
+const generateTemplateScenarioTransaction = (
+  libauthTransaction: TransactionBCH,
+  csTransaction: Transaction,
+): WalletTemplateScenario['transaction'] => {
+  const slotIndex = csTransaction.inputs.findIndex((input) => !isUtxoP2PKH(input));
+
+  const inputs = libauthTransaction.inputs.map((input, index) => {
+    const csInput = csTransaction.inputs[index] as Utxo; // TODO: Change
+
     return {
       outpointIndex: input.outpointIndex,
       outpointTransactionHash:
+      // TODO: This should always be Uint8Array according to the libauth transaction types
         input.outpointTransactionHash instanceof Uint8Array
           ? binToHex(input.outpointTransactionHash)
           : input.outpointTransactionHash,
       sequenceNumber: input.sequenceNumber,
-      unlockingBytecode,
+      unlockingBytecode: generateTemplateScenarioBytecode(csInput, 'p2pkh_placeholder_unlock', index === slotIndex),
     } as WalletTemplateScenarioInput;
   });
-  result.locktime = libauthTransaction.locktime;
-
-  result.outputs = libauthTransaction.outputs.map(
-    (output: LibauthOutput, index) => {
-      const csOutput = csTransaction.outputs[index];
-      let { lockingBytecode }: any = output;
-      if (typeof csOutput.to === 'string') {
-        if (
-          [
-            contract.address,
-            contract.tokenAddress,
-          ].includes(csOutput.to)
-        ) {
-          lockingBytecode = {};
-        } else {
-          for (const csInput of csTransaction.inputs) {
-            if (isUtxoP2PKH(csInput)) {
-              const inputPkh = hash160(csInput.template.getPublicKey());
-              if (
-                binToHex(output.lockingBytecode).slice(6, 46)
-                === binToHex(inputPkh)
-              ) {
-                lockingBytecode = {
-                  script: 'p2pkh_placeholder_lock',
-                  overrides: {
-                    keys: {
-                      privateKeys: {
-                        placeholder_key: binToHex(
-                          csInput.template.privateKey,
-                        ),
-                      },
-                    },
-                  },
-                };
-              }
-            }
-          }
-        }
-      }
-      return {
-        lockingBytecode:
-          lockingBytecode instanceof Uint8Array
-            ? binToHex(lockingBytecode)
-            : lockingBytecode,
-        token: output.token ? {
-          amount: output.token.amount.toString(),
-          category: binToHex(output.token.category),
-          nft: output.token.nft ? {
-            capability: output.token.nft.capability,
-            commitment: binToHex(output.token.nft.commitment),
-          } : undefined,
-        } : undefined,
-        valueSatoshis: Number(output.valueSatoshis),
-      } as WalletTemplateScenarioTransactionOutput;
-    },
-  );
-  result.version = libauthTransaction.version;
-  return result;
-};
 
-const generateScenarioSourceOutputs = (csTransaction: Transaction): Array<WalletTemplateScenarioOutput<true>> => {
-  const slotIndex = csTransaction.inputs.findIndex((input) => !isUtxoP2PKH(input));
+  const locktime = libauthTransaction.locktime;
 
-  return csTransaction.inputs.map((input, index) => {
-    const lockingBytecode = generateTemplateScenarioSourceOutputLockingBytecode(input, index === slotIndex);
-    const valueSatoshis = Number(input.satoshis);
+  const outputs = libauthTransaction.outputs.map((output, index) => {
+    const csOutput = csTransaction.outputs[index]; // TODO: Change
+
+    return {
+      lockingBytecode: generateTemplateScenarioTransactionOutputLockingBytecode(csOutput),
+      token: serialiseTokenDetails(output.token),
+      valueSatoshis: Number(output.valueSatoshis),
+    } as WalletTemplateScenarioTransactionOutput;
+  });
 
-    if (input.token) {
-      const token = {
-        amount: input.token.amount.toString(),
-        category: input.token.category,
-        nft: input.token.nft,
-      };
+  const version = libauthTransaction.version;
 
-      return { lockingBytecode, valueSatoshis, token };
-    }
+  return { inputs, locktime, outputs, version };
+};
 
-    return { lockingBytecode, valueSatoshis };
+const generateTemplateScenarioTransactionOutputLockingBytecode = (
+  csOutput: Output,
+): string => {
+  if (csOutput.to instanceof Uint8Array) return binToHex(csOutput.to);
+  return binToHex(addressToLockScript(csOutput.to));
+};
+
+const generateTemplateScenarioSourceOutputs = (
+  csTransaction: Transaction,
+): Array<WalletTemplateScenarioOutput<true>> => {
+  const slotIndex = csTransaction.inputs.findIndex((input) => !isUtxoP2PKH(input));
+
+  return csTransaction.inputs.map((input, index) => {
+    return {
+      lockingBytecode: generateTemplateScenarioBytecode(input, 'p2pkh_placeholder_lock', index === slotIndex),
+      valueSatoshis: Number(input.satoshis),
+      token: serialiseTokenDetails(input.token),
+    };
   });
 };
 
-const generateTemplateScenarioSourceOutputLockingBytecode = (
-  input: Utxo, insertSlot?: boolean,
-): WalletTemplateScenarioOutput<true>['lockingBytecode'] => {
+// Used for generating the locking / unlocking bytecode for source outputs and inputs
+const generateTemplateScenarioBytecode = (
+  input: Utxo, p2pkhScriptName: string, insertSlot?: boolean,
+): WalletTemplateScenarioBytecode | ['slot'] => {
   if (isUtxoP2PKH(input)) {
     return {
-      script: 'p2pkh_placeholder_lock',
+      script: p2pkhScriptName,
       overrides: {
         keys: {
           privateKeys: {
@@ -472,3 +413,26 @@ const formatBytecodeForDebugging = (artifact: Artifact): string => {
     artifact.source,
   );
 };
+
+// TODO: Maybe move / refactor
+const serialiseTokenDetails = (token?: TokenDetails | LibauthTokenDetails): LibauthTemplateTokenDetails | undefined => {
+  if (!token) return undefined;
+
+  return {
+    amount: token.amount.toString(),
+    category: token.category instanceof Uint8Array ? binToHex(token.category) : token.category,
+    nft: token.nft ? {
+      capability: token.nft.capability,
+      commitment: token.nft.commitment instanceof Uint8Array ? binToHex(token.nft.commitment) : token.nft.commitment,
+    } : undefined,
+  };
+};
+
+export interface LibauthTemplateTokenDetails {
+  amount: string;
+  category: string;
+  nft?: {
+    capability: 'none' | 'mutable' | 'minting';
+    commitment: string;
+  };
+}
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 1f06947d..0c4ea3f3 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -91,7 +91,9 @@ type CreateProgramResult = { vm: VM, program: Program };
 // internal util. instantiates the virtual machine and compiles the template into a program
 const createProgram = (template: WalletTemplate): CreateProgramResult => {
   const configuration = walletTemplateToCompilerConfiguration(template);
-  const vm = createVirtualMachineBCHCHIPs();
+  // TODO: We disabled standardness checks due to an issue with Libauth (https://github.com/bitauth/libauth/issues/133).
+  // We should re-enable this once the issue is resolved.
+  const vm = createVirtualMachineBCHCHIPs(false);
   const compiler = createCompiler(configuration);
 
   const scenarioGeneration = compiler.generateScenario({
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index c950f999..73c2b8f5 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -106,7 +106,7 @@ export const fixtures: Fixture[] = [
             'locktime': expect.any(Number),
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa203f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b187',
                 'valueSatoshis': 10000,
               },
             ],
@@ -230,7 +230,7 @@ export const fixtures: Fixture[] = [
             'locktime': expect.any(Number),
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa203f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b187',
                 'valueSatoshis': 10000,
               },
             ],
@@ -351,7 +351,7 @@ export const fixtures: Fixture[] = [
                 'valueSatoshis': 10000,
               },
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa209c6c87b192226fa02ed3834607a94a6ea040acc59df983c49a648406c695816b87',
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -477,7 +477,7 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
                 'token': {
                   'amount': expect.stringMatching(/^[0-9]+$/),
                   'category': expect.stringMatching(/^[0-9a-f]{64}$/),
@@ -485,7 +485,7 @@ export const fixtures: Fixture[] = [
                 'valueSatoshis': 1000,
               },
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -610,11 +610,11 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
                 'valueSatoshis': 1000,
               },
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -740,7 +740,7 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
                 'token': {
                   'amount': '0',
                   'category': expect.stringMatching(/^[0-9a-f]{64}$/),
@@ -752,7 +752,7 @@ export const fixtures: Fixture[] = [
                 'valueSatoshis': 1000,
               },
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -906,11 +906,11 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa202b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e087',
                 'valueSatoshis': 10000,
               },
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa202b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e087',
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -1075,11 +1075,11 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
                 'valueSatoshis': 1000,
               },
               {
-                'lockingBytecode': {},
+                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
                 'valueSatoshis': expect.any(Number),
               },
             ],

From 5e30b90adc57b38b88b6dd86af8094b5f0d89517 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 28 May 2024 11:38:26 +0200
Subject: [PATCH 052/267] Move to BCH_2023_05 VM (which supports P2SH32) +
 rollback one of the refactors that caused issues with change outputs

---
 packages/cashscript/src/Contract.ts           |  3 +-
 packages/cashscript/src/LibauthTemplate.ts    | 27 ++++++---
 packages/cashscript/src/debugging.ts          | 12 ++--
 packages/cashscript/src/interfaces.ts         |  4 +-
 packages/cashscript/src/utils.ts              |  7 ++-
 .../test/fixture/libauth-template/fixtures.ts | 58 +++++++++----------
 6 files changed, 64 insertions(+), 47 deletions(-)

diff --git a/packages/cashscript/src/Contract.ts b/packages/cashscript/src/Contract.ts
index 2bffa792..1efefc13 100644
--- a/packages/cashscript/src/Contract.ts
+++ b/packages/cashscript/src/Contract.ts
@@ -14,6 +14,7 @@ import { Transaction } from './Transaction.js';
 import { Argument, encodeArgument, encodeConstructorArguments, encodeFunctionArguments } from './Argument.js';
 import {
   Unlocker, ContractOptions, GenerateUnlockingBytecodeOptions, Utxo,
+  AddressType,
 } from './interfaces.js';
 import NetworkProvider from './network/NetworkProvider.js';
 import {
@@ -35,7 +36,7 @@ export class Contract {
 
   redeemScript: Script;
   public provider: NetworkProvider;
-  public addressType: 'p2sh20' | 'p2sh32';
+  public addressType: AddressType;
   public encodedConstructorArgs: Uint8Array[];
 
   constructor(
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index fa4dd447..38d3650c 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -31,11 +31,13 @@ import {
   TokenDetails,
   LibauthTokenDetails,
   Output,
+  AddressType,
 } from './interfaces.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
 import { EncodedArgument } from './Argument.js';
 import { addressToLockScript, extendedStringify, snakeCase, zip } from './utils.js';
+import { Contract } from './Contract.js';
 
 interface BuildTemplateOptions {
   transaction: Transaction;
@@ -56,13 +58,18 @@ export const buildTemplate = async ({
     $schema: 'https://ide.bitauth.com/authentication-template-v0.schema.json',
     description: 'Imported from cashscript',
     name: contract.artifact.contractName,
-    supported: ['BCH_SPEC'],
+    supported: ['BCH_2023_05'],
     version: 0,
     entities: generateTemplateEntities(contract.artifact, transaction.abiFunction),
     scripts: generateTemplateScripts(
-      contract.artifact, transaction.abiFunction, transaction.encodedFunctionArgs, contract.encodedConstructorArgs,
+      contract.artifact,
+      contract.addressType,
+      transaction.abiFunction,
+      transaction.encodedFunctionArgs,
+      contract.encodedConstructorArgs,
     ),
     scenarios: generateTemplateScenarios(
+      contract,
       transaction,
       txHex,
       contract.artifact,
@@ -163,6 +170,7 @@ const generateTemplateEntities = (artifact: Artifact, abiFunction: AbiFunction):
 
 const generateTemplateScripts = (
   artifact: Artifact,
+  addressType: AddressType,
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedArgument[],
   encodedConstructorArgs: EncodedArgument[],
@@ -170,16 +178,17 @@ const generateTemplateScripts = (
   // definition of locking scripts and unlocking scripts with their respective bytecode
   return {
     unlock_lock: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs),
-    lock: generateTemplateLockScript(artifact, encodedConstructorArgs),
+    lock: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
   };
 };
 
 const generateTemplateLockScript = (
   artifact: Artifact,
+  addressType: AddressType,
   constructorArguments: EncodedArgument[],
 ): WalletTemplateScriptLocking => {
   return {
-    lockingType: 'p2sh20', // TODO: use 'transaction.contract.addressType',
+    lockingType: addressType,
     name: 'lock',
     script: [
       `// "${artifact.contractName}" contract constructor parameters`,
@@ -217,6 +226,7 @@ const generateTemplateUnlockScript = (
 };
 
 const generateTemplateScenarios = (
+  contract: Contract,
   transaction: Transaction,
   transactionHex: string,
   artifact: Artifact,
@@ -248,7 +258,7 @@ const generateTemplateScenarios = (
           ),
         },
       },
-      transaction: generateTemplateScenarioTransaction(libauthTransaction, transaction),
+      transaction: generateTemplateScenarioTransaction(contract, libauthTransaction, transaction),
       sourceOutputs: generateTemplateScenarioSourceOutputs(transaction),
     },
   };
@@ -263,6 +273,7 @@ const generateTemplateScenarios = (
 };
 
 const generateTemplateScenarioTransaction = (
+  contract: Contract,
   libauthTransaction: TransactionBCH,
   csTransaction: Transaction,
 ): WalletTemplateScenario['transaction'] => {
@@ -289,7 +300,7 @@ const generateTemplateScenarioTransaction = (
     const csOutput = csTransaction.outputs[index]; // TODO: Change
 
     return {
-      lockingBytecode: generateTemplateScenarioTransactionOutputLockingBytecode(csOutput),
+      lockingBytecode: generateTemplateScenarioTransactionOutputLockingBytecode(csOutput, contract),
       token: serialiseTokenDetails(output.token),
       valueSatoshis: Number(output.valueSatoshis),
     } as WalletTemplateScenarioTransactionOutput;
@@ -302,8 +313,10 @@ const generateTemplateScenarioTransaction = (
 
 const generateTemplateScenarioTransactionOutputLockingBytecode = (
   csOutput: Output,
-): string => {
+  contract: Contract,
+): string | {} => {
   if (csOutput.to instanceof Uint8Array) return binToHex(csOutput.to);
+  if ([contract.address, contract.tokenAddress].includes(csOutput.to)) return {};
   return binToHex(addressToLockScript(csOutput.to));
 };
 
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 0c4ea3f3..62ce9c86 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -1,4 +1,4 @@
-import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateBCHCHIPs, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBCHCHIPs, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
+import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateBCH, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBCH2023, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
 import { Artifact, LogData, LogEntry, Op, PrimitiveType, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
 import { findLastIndex, toRegExp } from './utils.js';
 
@@ -14,7 +14,7 @@ export const evaluateTemplate = (template: WalletTemplate): boolean => {
   return verifyResult;
 };
 
-export type DebugResult = AuthenticationProgramStateBCHCHIPs[];
+export type DebugResult = AuthenticationProgramStateCommon[];
 
 // debugs the template, optionally logging the execution data
 export const debugTemplate = (template: WalletTemplate, artifact: Artifact): DebugResult => {
@@ -83,7 +83,7 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
 type VM = AuthenticationVirtualMachine<
 ResolvedTransactionCommon,
 AuthenticationProgramCommon,
-AuthenticationProgramStateBCHCHIPs
+AuthenticationProgramStateBCH
 >;
 type Program = AuthenticationProgramCommon;
 type CreateProgramResult = { vm: VM, program: Program };
@@ -91,9 +91,7 @@ type CreateProgramResult = { vm: VM, program: Program };
 // internal util. instantiates the virtual machine and compiles the template into a program
 const createProgram = (template: WalletTemplate): CreateProgramResult => {
   const configuration = walletTemplateToCompilerConfiguration(template);
-  // TODO: We disabled standardness checks due to an issue with Libauth (https://github.com/bitauth/libauth/issues/133).
-  // We should re-enable this once the issue is resolved.
-  const vm = createVirtualMachineBCHCHIPs(false);
+  const vm = createVirtualMachineBCH2023();
   const compiler = createCompiler(configuration);
 
   const scenarioGeneration = compiler.generateScenario({
@@ -116,7 +114,7 @@ const createProgram = (template: WalletTemplate): CreateProgramResult => {
 
 const logConsoleLogStatement = (
   log: LogEntry,
-  debugStep: AuthenticationProgramStateBCHCHIPs,
+  debugStep: AuthenticationProgramStateCommon,
   artifact: Artifact,
 ): void => {
   let line = `${artifact.contractName}.cash:${log.line}`;
diff --git a/packages/cashscript/src/interfaces.ts b/packages/cashscript/src/interfaces.ts
index 757b9d00..5ebd13c6 100644
--- a/packages/cashscript/src/interfaces.ts
+++ b/packages/cashscript/src/interfaces.ts
@@ -116,5 +116,7 @@ export interface TransactionDetails extends Transaction {
 
 export interface ContractOptions {
   provider?: NetworkProvider,
-  addressType?: 'p2sh20' | 'p2sh32',
+  addressType?: AddressType,
 }
+
+export type AddressType = 'p2sh20' | 'p2sh32';
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index e2b52c74..a904d9b6 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -32,6 +32,7 @@ import {
   Network,
   LibauthOutput,
   TokenDetails,
+  AddressType,
 } from './interfaces.js';
 import { VERSION_SIZE, LOCKTIME_SIZE } from './constants.js';
 import {
@@ -247,14 +248,16 @@ export function toRegExp(reasons: string[]): RegExp {
   return new RegExp(reasons.join('|').replace(/\(/g, '\\(').replace(/\)/g, '\\)'));
 }
 
-export function scriptToAddress(script: Script, network: string, addressType: 'p2sh20' | 'p2sh32', tokenSupport: boolean): string {
+export function scriptToAddress(
+  script: Script, network: string, addressType: AddressType, tokenSupport: boolean,
+): string {
   const lockingBytecode = scriptToLockingBytecode(script, addressType);
   const prefix = getNetworkPrefix(network);
   const address = lockingBytecodeToCashAddress(lockingBytecode, prefix, { tokenSupport }) as string;
   return address;
 }
 
-export function scriptToLockingBytecode(script: Script, addressType: 'p2sh20' | 'p2sh32'): Uint8Array {
+export function scriptToLockingBytecode(script: Script, addressType: AddressType): Uint8Array {
   const scriptBytecode = scriptToBytecode(script);
   const scriptHash = (addressType === 'p2sh20') ? hash160(scriptBytecode) : hash256(scriptBytecode);
   const addressContents = { payload: scriptHash, type: LockingBytecodeType[addressType] };
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 73c2b8f5..bb2eb8ba 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -33,7 +33,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'TransferWithTimeout',
       'supported': [
-        'BCH_SPEC',
+        'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
@@ -106,7 +106,7 @@ export const fixtures: Fixture[] = [
             'locktime': expect.any(Number),
             'outputs': [
               {
-                'lockingBytecode': 'aa203f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b187',
+                'lockingBytecode': {},
                 'valueSatoshis': 10000,
               },
             ],
@@ -132,7 +132,7 @@ export const fixtures: Fixture[] = [
           'unlocks': 'lock',
         },
         'lock': {
-          'lockingType': 'p2sh20',
+          'lockingType': 'p2sh32',
           'name': 'lock',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
         },
@@ -157,7 +157,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'TransferWithTimeout',
       'supported': [
-        'BCH_SPEC',
+        'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
@@ -230,7 +230,7 @@ export const fixtures: Fixture[] = [
             'locktime': expect.any(Number),
             'outputs': [
               {
-                'lockingBytecode': 'aa203f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b187',
+                'lockingBytecode': {},
                 'valueSatoshis': 10000,
               },
             ],
@@ -256,7 +256,7 @@ export const fixtures: Fixture[] = [
           'unlocks': 'lock',
         },
         'lock': {
-          'lockingType': 'p2sh20',
+          'lockingType': 'p2sh32',
           'name': 'lock',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
         },
@@ -281,7 +281,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'Mecenas',
       'supported': [
-        'BCH_SPEC',
+        'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
@@ -351,7 +351,7 @@ export const fixtures: Fixture[] = [
                 'valueSatoshis': 10000,
               },
               {
-                'lockingBytecode': 'aa209c6c87b192226fa02ed3834607a94a6ea040acc59df983c49a648406c695816b87',
+                'lockingBytecode': {},
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -377,7 +377,7 @@ export const fixtures: Fixture[] = [
           'unlocks': 'lock',
         },
         'lock': {
-          'lockingType': 'p2sh20',
+          'lockingType': 'p2sh32',
           'name': 'lock',
           'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(tx.age >= period);                                                                              */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
         },
@@ -410,7 +410,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'P2PKH',
       'supported': [
-        'BCH_SPEC',
+        'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
@@ -477,7 +477,7 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
+                'lockingBytecode': {},
                 'token': {
                   'amount': expect.stringMatching(/^[0-9]+$/),
                   'category': expect.stringMatching(/^[0-9a-f]{64}$/),
@@ -485,7 +485,7 @@ export const fixtures: Fixture[] = [
                 'valueSatoshis': 1000,
               },
               {
-                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
+                'lockingBytecode': {},
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -519,7 +519,7 @@ export const fixtures: Fixture[] = [
           'unlocks': 'lock',
         },
         'lock': {
-          'lockingType': 'p2sh20',
+          'lockingType': 'p2sh32',
           'name': 'lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
@@ -550,7 +550,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'P2PKH',
       'supported': [
-        'BCH_SPEC',
+        'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
@@ -610,11 +610,11 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
+                'lockingBytecode': {},
                 'valueSatoshis': 1000,
               },
               {
-                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
+                'lockingBytecode': {},
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -640,7 +640,7 @@ export const fixtures: Fixture[] = [
           'unlocks': 'lock',
         },
         'lock': {
-          'lockingType': 'p2sh20',
+          'lockingType': 'p2sh32',
           'name': 'lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
@@ -673,7 +673,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'P2PKH',
       'supported': [
-        'BCH_SPEC',
+        'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
@@ -740,7 +740,7 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
+                'lockingBytecode': {},
                 'token': {
                   'amount': '0',
                   'category': expect.stringMatching(/^[0-9a-f]{64}$/),
@@ -752,7 +752,7 @@ export const fixtures: Fixture[] = [
                 'valueSatoshis': 1000,
               },
               {
-                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
+                'lockingBytecode': {},
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -790,7 +790,7 @@ export const fixtures: Fixture[] = [
           'unlocks': 'lock',
         },
         'lock': {
-          'lockingType': 'p2sh20',
+          'lockingType': 'p2sh32',
           'name': 'lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
@@ -821,7 +821,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'HodlVault',
       'supported': [
-        'BCH_SPEC',
+        'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
@@ -906,11 +906,11 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': 'aa202b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e087',
+                'lockingBytecode': {},
                 'valueSatoshis': 10000,
               },
               {
-                'lockingBytecode': 'aa202b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e087',
+                'lockingBytecode': {},
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -936,7 +936,7 @@ export const fixtures: Fixture[] = [
           'unlocks': 'lock',
         },
         'lock': {
-          'lockingType': 'p2sh20',
+          'lockingType': 'p2sh32',
           'name': 'lock',
           'script': '// "HodlVault" contract constructor parameters\n<price_target> // int = <0x3075>\n<min_block> // int = <0xb88201>\n<oracle_pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<owner_pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
         },
@@ -991,7 +991,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'P2PKH',
       'supported': [
-        'BCH_SPEC',
+        'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
@@ -1075,11 +1075,11 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
+                'lockingBytecode': {},
                 'valueSatoshis': 1000,
               },
               {
-                'lockingBytecode': 'aa2034d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a587',
+                'lockingBytecode': {},
                 'valueSatoshis': expect.any(Number),
               },
             ],
@@ -1118,7 +1118,7 @@ export const fixtures: Fixture[] = [
           'unlocks': 'lock',
         },
         'lock': {
-          'lockingType': 'p2sh20',
+          'lockingType': 'p2sh32',
           'name': 'lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },

From 3d6611410e8c7ed9d760071a8c639e91c2cbb477 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 28 May 2024 11:39:34 +0200
Subject: [PATCH 053/267] Bump version to 0.10.0-next.5

---
 examples/package.json               | 6 +++---
 examples/testing-suite/package.json | 6 +++---
 packages/cashc/package.json         | 4 ++--
 packages/cashc/src/index.ts         | 2 +-
 packages/cashscript/package.json    | 4 ++--
 packages/utils/package.json         | 2 +-
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index 163e23b4..ceaf832f 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.0-next.4",
+  "version": "0.10.0-next.5",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -14,8 +14,8 @@
     "@bitauth/libauth": "^2.0.0-alpha.8",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
-    "cashc": "^0.10.0-next.4",
-    "cashscript": "^0.10.0-next.4",
+    "cashc": "^0.10.0-next.5",
+    "cashscript": "^0.10.0-next.5",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index a46037f2..7cb4d91b 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.0-next.4",
+  "version": "0.10.0-next.5",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -25,8 +25,8 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "cashc": "^0.10.0-next.4",
-    "cashscript": "^0.10.0-next.4"
+    "cashc": "^0.10.0-next.5",
+    "cashscript": "^0.10.0-next.5"
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 54496950..5b48f4aa 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.0-next.4",
+  "version": "0.10.0-next.5",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0",
-    "@cashscript/utils": "^0.10.0-next.4",
+    "@cashscript/utils": "^0.10.0-next.5",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 83027743..01e18dc6 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.0-next.4';
+export const version = '0.10.0-next.5';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index ea2e8e9f..0a591dca 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.0-next.4",
+  "version": "0.10.0-next.5",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0",
-    "@cashscript/utils": "^0.10.0-next.4",
+    "@cashscript/utils": "^0.10.0-next.5",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index ecb58255..f4465fc9 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.0-next.4",
+  "version": "0.10.0-next.5",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From 3a3badc411ad9c003f90ec66402de593ef592c3c Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 29 May 2024 11:50:58 +0200
Subject: [PATCH 054/267] added failing test

---
 packages/cashscript/test/debugging.test.ts | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 9477bc84..2c7a3e0e 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -90,6 +90,13 @@ contract Test() {
 }
 `;
 
+const CONTRACT_CODE2 = `
+contract Test() {
+  function test_require_single_function() {
+    require(tx.outputs.length == 1, "should have 1 output");
+  }
+}`;
+
 describe('Debugging tests', () => {
   describe('console.log statements', () => {
     const BASE_CONTRACT_CODE = `
@@ -273,8 +280,10 @@ describe('Debugging tests', () => {
 
   describe('require statements', () => {
     const artifact = compileString(CONTRACT_CODE);
+    const artifact2 = compileString(CONTRACT_CODE2);
     const provider = new MockNetworkProvider();
 
+    // test_require
     it('should fail with error message when require statement fails', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
@@ -283,6 +292,17 @@ describe('Debugging tests', () => {
       await expect(transaction).toFailRequireWith(/1 should equal 2/);
     });
 
+    // test_require_single_function
+    it('should fail with error message when require statement fails in single function', async () => {
+      const contract = new Contract(artifact2, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_require_single_function()
+        .to(contract.address, 1000n)
+        .to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith(/should have 1 output/);
+    });
+
     // // test_multiple_require_statements
     it('it should only fail with correct error message when there are multiple require statements', async () => {
       const contract = new Contract(artifact, [], { provider });

From 4d6e8cbca19f9071221be4a3db2498ff74826dfc Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 09:49:31 +0200
Subject: [PATCH 055/267] improve text landing page

---
 website/src/pages/index.js | 33 ++++++++++++++++-----------------
 1 file changed, 16 insertions(+), 17 deletions(-)

diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index 626e92ef..56ca1d04 100755
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -11,43 +11,42 @@ const features = [
     title: 'Efficient and Reliable Verification',
     description: (
       <>
-        Smart contracts on Bitcoin Cash are stateless and UTXO-based. This
+        Smart contracts on Bitcoin Cash are UTXO-based with local state. This
         model allows transactions to be verified independently and efficiently.
-        Because there is no state that can impact the execution of these smart
+        Because there is no global state that can impact the execution of these smart
         contracts, the results are deterministic and predictable.
       </>
     ),
   },
   {
-    title: 'Private and Isolated Contracts',
+    title: 'Strong Abstraction',
     description: (
       <>
-        Because of Bitcoin Cash' UTXO-based model, each contract is fully
-        independent and isolated from each other. This limits systemic risk
-        and makes contract upgrades much simpler. Furthermore, Bitcoin Cash
-        contracts use P2SH, preserving the privacy of participants.
+        Bitcoin Cash transactions run on a virtual machine called 'BCH Script'.
+        Writing bytecode for this virtual machine is difficult and error-prone.
+        CashScript offers a strong abstraction for writing Bitcoin Cash smart
+        contracts, improving developer experience and reliability of contracts.
       </>
     ),
   },
   {
-    title: 'Strong Abstraction',
+    title: 'DeFi on Bitcoin Cash',
     description: (
       <>
-        Bitcoin Cash transactions run on a virtual machine called Bitcoin Script.
-        Writing bytecode for this virtual machine is difficult and error-prone.
-        CashScript offers a strong abstraction for writing Bitcoin Cash smart
-        contracts, improving developer experience and reliability of contracts.
+        Bitcoin Cash has had many script upgrades on such as CashTokens and transaction introspection.
+        Because of this DeFi is very much possible on Bitcoin Cash.
+        However, compared to EVM smart contracts work very differently due to BCH's UTXO
+        architecture.
       </>
     ),
   },
   {
-    title: 'DeFi on Bitcoin Cash',
+    title: 'Integrated Tooling',
     description: (
       <>
-        Most DeFi applications are currently built on top of the EVM. Bitcoin
-        Cash contracts use a different paradigm than EVM chains due to its UTXO
-        architecture. But with CashTokens, transaction introspection and local
-        state, DeFi is very much possible on Bitcoin Cash.
+        CashScript offers integrated tooling through the Javascript SDK.
+        The SDK has utilities for easy transaction building and other network functionality.
+        CashScript has built-in debug tooling comaptible with the Bitauth-IDE to offer the best developer experience.  
       </>
     ),
   },

From 92b686ac5a34cde936127b0c8564f97e76c3ae5d Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 11:18:08 +0200
Subject: [PATCH 056/267] full makeover to the getting-started page

---
 website/docs/basics/getting-started.md | 126 +++++++++++++++++--------
 website/docs/sdk/instantiation.md      |   4 +
 2 files changed, 93 insertions(+), 37 deletions(-)

diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index b51d42a3..9e6fe09c 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -2,26 +2,47 @@
 title: Getting Started
 ---
 
-## Installing the CashScript compiler
+## Try CashScript Online
+
+To get started with writing CashScript smart contracts quickly, it is recommended to try out the [CashScript Playground](https://playground.cashscript.org/), a web application which lets you easily write and create contracts easily!
+
+Here you will learn what CashScript contract looks like through the `TransferWithTimeout` example contract. Then you can compile the contract and provide the contract arguments to create a smart contract address. To actually create the smart contract itself you fund the address so it has a UTXO on the contract address. After setting up the smart contract, you can try spending from the smart contract by invoking a contract funcion!
+
+:::tip
+The [CashScript Playground](https://playground.cashscript.org/) is a great way to get started without doing any Javascript coding to setup up wallets, fetch balances and invoke contract functions. This way you can focus on learning one thing at a time!
+:::
+
+## Creating a CashScript Smart Contract
+
+With the CashScript playground there's a nice integrated editor to get started, as well as an integrated compiler to change your CashScript contract into a Contract `Artifact` behind the screens. Now, to get started we will have to get set up with a CashScript editor outside of the Playground and learn how to work with the `cashc` compiler to create CashScript contract artifacts.
+
+### Prerequisites
+
+To write CashScript smart contracts contracts locally you use a code-editor. For the best developer experience is recommended to use VS Code with the CashScript extension. This way it will automatically recognize `.cash` files and offer highlighting and auto-completion.
+
+:::note prerequisties
+- Basic familiarity with the command line
+- Node.js installed
+- A code editor (VS code recommended)
+:::
+
+:::tip
+See the [Syntax Highlighting](/docs/guides/syntax-highlighting) guide for how to get set-up for the best CashScript developer environment.
+:::
+
+### Installing the CashScript compiler
 The command line CashScript compiler `cashc` can be installed from NPM.
 
 ```bash
 npm install -g cashc
 ```
 
-## Installing the JavaScript SDK
-The JavaScript SDK can be installed into your project with NPM. Note that CashScript is a [Pure ESM package](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
-
-```bash
-npm install cashscript
-```
+### Writing your first smart contract
 
-:::caution
-CashScript only offers a JavaScript SDK, but CashScript contracts can be integrated into other languages as well. Because there are no ready-to-use SDKs available for them, this is considered advanced usage, and it is recommended to use the JavaScript SDK.
-:::
+Open your code-editor to start writing your first CashScript smart contract.
+We can start from a basic `TransferWithTimeout` smart contract, create a new file `TransferWithTimeout.cash` for the file.
 
-## Writing your first smart contract
-There are some examples available on the [Examples page](/docs/language/examples), that can be used to take inspiration from. Further examples of the JavaScript integration can be found on [GitHub](https://github.com/Bitcoin-com/cashscript/tree/master/examples). A simple example is included below.
+The `TransferWithTimeout` contract takes in 3 contract arguments and has 2 contract functions: `transfer` and `timeout`.
 
 ```solidity
 pragma cashscript ^0.9.0;
@@ -41,29 +62,74 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 ```
 
 :::tip
-Read more about the CashScript language syntax in the [Language Description](/docs/language/contracts).
+There are some other examples available on the [Examples page](/docs/language/examples), that can be used to take inspiration from. Further examples of the JavaScript integration can be found on [GitHub](https://github.com/Bitcoin-com/cashscript/tree/master/examples).
 :::
 
-## Integrating into JavaScript
-While more detailed examples are available on GitHub, we show an integration of the `TransferWithTimeout` contract in a JavaScript project.
+### Compiling your smart contract
+
+The next step after writing your smart contract is using the command line compiler to create a contract artifact so it can be imported into the CashScript SDK.
+
+```bash
+cashc ./TransferWithTimeout.cash --output ./TransferWithTimeout.json
+```
+
+This will create an artifact file `TransferWithTimeout.json` from your CashScript file. It can be helpful to take a look at the generated artifact file to understand what the `cashc` compiler is generating.
+
+## Creating a CashScript Transaction
 
-After compiling the contract file to an artifact JSON with cashc, it can be imported into the CashScript SDK.
+After creating a contract artifact we can now use the JavaScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs.We'll continue with the `TransferWithTimeout` artifact generated in the previous steps.
+
+### Installing the JavaScript SDK
+The JavaScript SDK can be installed into your project with NPM. Note that CashScript is a [Pure ESM package](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
 
 ```bash
-cashc ./transfer_with_timeout.cash --output ./transfer_with_timeout.json
+npm install cashscript
 ```
 
+### Initialising a Contract
+
+Now to initialise a contract we will import the ElectrumNetworkProvider and contract classes from the CashScript SDK. We of course also need the contract arifact, and lastly we need public keys from a generated key-pair to use as arguments to initialise the contract.
+
+```javascript
+import { ElectrumNetworkProvider, Contract } from 'cashscript';
+import { alicePub, bobPub } from './keys.js';
+import artifact from './TransferWithTimeout.json';
+
+// Initialise a network provider for network operations
+const provider = new ElectrumNetworkProvider('chipnet');
+
+// Instantiate a new TransferWithTimeout contract
+const contractArguments = [alicePub, bobPub, 100000n]
+const ptions = { provider }
+const contract = new Contract(artifact, contractArguments, options);
+
+// Get the contract address and info about its balance
+console.log("Contract address:" + contract.address)
+console.log("Contract balance:" + await contract.getBalance())
+console.log("Contract Utxos:")
+console.log(await contract.getUtxos())
+```
+
+:::tip
+For a code example of how to generate key-pairs with Libauth see the [CashScript Examples](https://github.com/CashScript/cashscript/blob/master/examples/common.ts) `common-ts` file where Alice and Bob's key-pairs are created!
+:::
+
+### Creating a Transction
+
+Lastly to spend from the smart contract we've initialised you need to make sure there is an actual contract balance on the smart contract address. Or in other words, you need to make sure there's at least one UTXO with the smart contract locking bytecode so we can spend from it!
+
 ```javascript
 import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
-import { alicePriv, alicePub, bobPriv, bobPub } from './keys.js';
-import artifact from './transfer_with_timeout.json';
+import { alicePub, bobPriv, bobPub } from './keys.js';
+import artifact from './TransferWithTimeout.json';
 
 // Initialise a network provider for network operations
-const provider = new ElectrumNetworkProvider('mainnet');
-const addressType = 'p2sh20';
+const provider = new ElectrumNetworkProvider('chipnet');
 
 // Instantiate a new TransferWithTimeout contract
-const contract = new Contract(artifact, [alicePub, bobPub, 100000n], options:{ provider, addressType});
+const contractArguments = [alicePub, bobPub, 100000n]
+const options = { provider }
+const contract = new Contract(artifact, contractArguments, options);
 
 // Call the transfer function with Bob's signature
 // i.e. Bob claims the money that Alice has sent him
@@ -72,20 +138,6 @@ const transferDetails = await contract.functions
   .to('bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx', 10000n)
   .send();
 console.log(transferDetails);
-
-// Call the timeout function with Alice's signature
-// i.e. Alice recovers the money that Bob has not claimed
-const timeoutDetails = await contract.functions
-  .timeout(new SignatureTemplate(alicePriv))
-  .to('bitcoincash:qqeht8vnwag20yv8dvtcrd4ujx09fwxwsqqqw93w88', 10000n)
-  .send();
-console.log(timeoutDetails);
 ```
 
-:::tip
-Read more about the JavaScript SDK in the [SDK documentation](/docs/sdk/instantiation).
-:::
-
-:::tip
-Read more about CashScript contract development and testing suite in the [Debug tools](/docs/sdk/debugging).
-:::
\ No newline at end of file
+Congrats 🎉! You've succesfully created a transaction spending from a Bitcoin Cash smart contract! 
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 0f7dfe0c..8a64a0ab 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -4,6 +4,10 @@ title: Contract Instantiation
 
 Before interacting with smart contracts on the BCH network, the CashScript SDK needs to instantiate a `Contract` object. This is done by providing the contract's information and constructor arguments. After this instantiation, the CashScript SDK can interact with BCH contracts.
 
+:::note
+CashScript only offers a JavaScript SDK, but CashScript contracts can be integrated into other languages as well. Because there are no ready-to-use SDKs available for them, this is considered advanced usage.
+:::
+
 ## Contract class
 The `Contract` class is used to represent a CashScript contract in a JavaScript object. These objects can be used to retrieve information such as the contract's address and balance. They can be used to interact with the contract by calling the contract's functions.
 

From 656396ed8c0bf44086a4a1aa44167318b8edf5a6 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 11:34:09 +0200
Subject: [PATCH 057/267] update what is CashScript

---
 website/docs/basics/about.md           | 12 ++++++++++--
 website/docs/basics/getting-started.md |  2 +-
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/website/docs/basics/about.md b/website/docs/basics/about.md
index 9a359206..26247d1c 100644
--- a/website/docs/basics/about.md
+++ b/website/docs/basics/about.md
@@ -3,6 +3,14 @@ title: What is CashScript?
 sidebar_label: About CashScript
 ---
 
-CashScript is a high-level programming language for smart contracts on Bitcoin Cash. It offers a strong abstraction layer over Bitcoin Cash' native virtual machine, Bitcoin Script. Its syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum. For a detailed comparison of them, refer to the blog post [*Smart Contracts on Ethereum, Bitcoin and Bitcoin Cash*](https://kalis.me/smart-contracts-eth-btc-bch/).
+CashScript is a high-level programming language for smart contracts on Bitcoin Cash. It offers a strong abstraction layer over Bitcoin Cash' native virtual machine, BCH Script. The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum.
 
-If you're interested to see what kind of things can be built with CashScript, you can look at the [Showcase](/docs/showcase) or [Examples](/docs/language/examples). If you just want to dive into CashScript, refer to the [Getting Started page](/docs/basics/getting-started) and other pages in the documentation.
+CashScript was created in 2019 and has seen major upgrades over the years, including support for the new script functionality enabled with the different Bitcoin Cash network upgrades, including native introspection and CashTokens. Unrelated to the network upgrades, CashScript has also been upgraded with an advanced transaction builder and integrated debug tooling.
+
+CashScript aims to make programming Bitcoin Cash accessible to a wide range of developers and enable the next-generation of UTXO smart contract applications.
+
+:::tip
+To see what kind of things can be built with CashScript, you can look at the [Showcase](/docs/showcase) or [Examples](/docs/language/examples). 
+
+To just dive into CashScript, refer to the [Getting Started page](/docs/basics/getting-started).
+:::
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 9e6fe09c..8e372a2c 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -77,7 +77,7 @@ This will create an artifact file `TransferWithTimeout.json` from your CashScrip
 
 ## Creating a CashScript Transaction
 
-After creating a contract artifact we can now use the JavaScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs.We'll continue with the `TransferWithTimeout` artifact generated in the previous steps.
+After creating a contract artifact we can now use the JavaScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs. We'll continue with the `TransferWithTimeout` artifact generated in the previous steps.
 
 ### Installing the JavaScript SDK
 The JavaScript SDK can be installed into your project with NPM. Note that CashScript is a [Pure ESM package](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).

From 6b3f04a9b9c3df716e5c718b614f032b3eca783c Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 12:00:53 +0200
Subject: [PATCH 058/267] single place with all compiler info

---
 website/docs/basics/cli.md        | 47 ++++++++++++++++++++++++++++---
 website/docs/sdk/instantiation.md | 34 ----------------------
 2 files changed, 43 insertions(+), 38 deletions(-)

diff --git a/website/docs/basics/cli.md b/website/docs/basics/cli.md
index 9a529770..39085d65 100644
--- a/website/docs/basics/cli.md
+++ b/website/docs/basics/cli.md
@@ -1,17 +1,22 @@
 ---
-title: Command Line Interface
+title: Compiler
 ---
 
-The `cashc` command line interface is used to compile CashScript `.cash` files into `.json` artifact files. These artifacts can be imported and used by the JavaScript SDK or other libraries / applications that use CashScript. For more information on this artifact format refer to [Artifacts](/docs/language/artifacts).
+The CashScript compiler is called `cashc` and is used to compile CashScript `.cash` contract files into `.json` artifact files.
+These artifact files can be used to instantiate a CashScript contract with the help of the CashScript SDK. For more information on this artifact format refer to [Artifacts](/docs/language/artifacts).
 
-## Installation
+## Command Line Interface
+
+The `cashc` command line interface is used to compile CashScript `.cash` files into `.json` artifact files.
+
+### Installation
 You can use `npm` to install the `cashc` command line tool globally.
 
 ```bash
 npm install -g cashc
 ```
 
-## Usage
+### CLI Usage
 The `cashc` CLI tool can be used to compile `.cash` files to JSON artifact files.
 
 ```bash
@@ -26,3 +31,37 @@ Options:
   -s, --size           Display the size in bytes of the compiled bytecode.
   -?, --help           Display help
 ```
+
+## Javascript Compilation
+Generally CashScript contracts are compiled to an Artifact JSON file using the CLI compiler. As an alternative to this, CashScript contracts can be compiled from within JavaScript apps using the `cashc` package. This package exports two compilation functions.
+
+```bash
+npm install cashc
+```
+
+### compileFile()
+```ts
+compileFile(sourceFile: PathLike): Artifact
+```
+
+Compiles a CashScript contract from a source file. This is the recommended compile method if you're using Node.js and you have a source file available.
+
+#### Example
+```ts
+const P2PKH = compileFile(new URL('p2pkh.cash', import.meta.url));
+```
+
+### compileString()
+```ts
+compileString(sourceCode: string): Artifact
+```
+
+Compiles a CashScript contract from a source code string. This is the recommended compile method if you're building a webapp, because `compileFile()` only works from a Node.js context. This is also the recommended method if no source file is locally available (e.g. the source code is retrieved with a REST API).
+
+```ts
+const baseUrl = 'https://raw.githubusercontent.com/Bitcoin-com/cashscript'
+const result = await fetch(`${baseUrl}/master/examples/p2pkh.cash`);
+const source = await result.text();
+
+const P2PKH = compileString(source);
+```
\ No newline at end of file
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 8a64a0ab..15bb0f9f 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -306,40 +306,6 @@ interface Utxo {
 }
 ```
 
-## CashScript Compiler
-Generally CashScript contracts are compiled to an Artifact JSON file using the CLI compiler. As an alternative to this, CashScript contracts can be compiled from within JavaScript apps using the `cashc` package. This package needs to be installed separately and exports two compilation functions.
-
-```bash
-npm install cashc
-```
-
-### compileFile()
-```ts
-compileFile(sourceFile: PathLike): Artifact
-```
-
-Compiles a CashScript contract from a source file. This is the recommended compile method if you're using Node.js and you have a source file available.
-
-#### Example
-```ts
-const P2PKH = compileFile(new URL('p2pkh.cash', import.meta.url));
-```
-
-### compileString()
-```ts
-compileString(sourceCode: string): Artifact
-```
-
-Compiles a CashScript contract from a source code string. This is the recommended compile method if you're building a webapp, because `compileFile()` only works from a Node.js context. This is also the recommended method if no source file is locally available (e.g. the source code is retrieved with a REST API).
-
-```ts
-const baseUrl = 'https://raw.githubusercontent.com/Bitcoin-com/cashscript'
-const result = await fetch(`${baseUrl}/master/examples/p2pkh.cash`);
-const source = await result.text();
-
-const P2PKH = compileString(source);
-```
-
 [fetch-api]: https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
 [bip68]: https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki
 [wif]: https://en.bitcoin.it/wiki/Wallet_import_format

From 9a0a6c5aab848cb9b07db8a6e977bcd5324817e8 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 13:10:09 +0200
Subject: [PATCH 059/267] separate page for network-provider

---
 website/docs/sdk/instantiation.md    | 148 +++++----------------------
 website/docs/sdk/network-provider.md | 123 ++++++++++++++++++++++
 website/sidebars.js                  |   2 +-
 3 files changed, 151 insertions(+), 122 deletions(-)
 create mode 100644 website/docs/sdk/network-provider.md

diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 15bb0f9f..a10c543e 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -27,7 +27,7 @@ A CashScript contract can be instantiated by providing an `Artifact` object, a l
 
 An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/language/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/basics/cli) or programmatically with the `cashc` NPM package (see [CashScript Compiler](#cashscript-compiler)).
 
-The `NetworkProvider` option is used to manage network operations for the CashScript contract. By default, a mainnet `ElectrumNetworkProvider` is used, but alternative network providers can be used. See the section on [NetworkProvider](#networkprovider) below.
+The `NetworkProvider` option is used to manage network operations for the CashScript contract. By default, a mainnet `ElectrumNetworkProvider` is used, but the network providers can be configured. See the docs on [NetworkProvider](/docs/sdk/network-provider).
 
 The `addressType` option is used to choose between a `p2sh32` and `p2sh20` address for the CashScript contract. By default `p2sh32` is used because it has increased cryptographic security but it is not yet supported by all wallets.
 
@@ -46,9 +46,11 @@ import P2PKH from './p2pkh.json';
 // Or compile a contract file
 const P2PKH = compileFile(new URL('p2pkh.cash', import.meta.url));
 
-const provider = new ElectrumNetworkProvider('testnet4');
+const provider = new ElectrumNetworkProvider('chipnet');
 const addressType = 'p2sh20';
-const contract = new Contract(P2PKH, [alicePkh], , options:{ provider, addressType});
+const contractArguments = [alicePkh]
+const options = { provider, addressType}
+const contract = new Contract(P2PKH, contractArguments, options);
 ```
 
 ### address
@@ -153,9 +155,10 @@ const utxos = await contract.getUtxos()
 contract.functions.<functionName>(...args: Argument[]): Transaction
 ```
 
-The main way to use smart contracts once they have been instantiated is through the functions defined in the CashScript source code. These functions can be found by their name under `functions` member field of a contract object. To call these functions, the parameters need to match ones defined in the CashScript code.
+Once a smart contract has been instantiated, you can invoke a contract function to spend from the contract with the '[Simple transaction-builder](/docs/sdk/transactions)' by calling the function name under the `functions` member field of a contract object.
+To call these functions succesfully, the parameters provided to the function need to match ones defined in the CashScript code.
 
-These contract functions return an incomplete `Transaction` object, which needs to be completed by providing outputs of the transaction. More information about sending transactions is found on the [*Sending Transactions*](/docs/sdk/transactions) page.
+These contract functions return an incomplete `Transaction` object, which needs to be completed by providing outputs of the transaction. For more information see the [Simple transaction-builder](/docs/sdk/transactions) page.
 
 #### Example
 ```ts
@@ -167,6 +170,25 @@ const tx = await contract.functions
   .send()
 ```
 
+### Contract unlockers
+
+```ts
+contract.unlock.<functionName>(...args: Argument[]): Unlocker
+```
+
+Once a smart contract has been instantiated, you can invoke a contract function on a smart contract UTXO to use the '[Advanced transaction-builder](/docs/sdk/transactions-advanced)' by calling the function name under the `unlock` member field of a contract object.
+To call these functions succesfully, the parameters provided to the function need to match ones defined in the CashScript code.
+
+These contract functions return an incomplete `transactionBuilder` object, which needs to be completed by providing outputs of the transaction. For more information see the [Advanced transaction-builder](/docs/sdk/transactions-advanced) page.
+
+```ts
+import { contract, transactionBuilder } from './somewhere.js';
+
+const contractUtxos = await contract.getUtxos();
+
+transactionBuilder.addInput(contractUtxos[0], contract.unlock.spend());
+```
+
 ## SignatureTemplate
 ```ts
 new SignatureTemplate(signer: Keypair | Uint8Array | string, hashtype?: HashType)
@@ -196,122 +218,6 @@ const wif = 'L4vmKsStbQaCvaKPnCzdRArZgdAxTqVx8vjMGLW5nHtWdRguiRi1';
 const sig = new SignatureTemplate(wif, HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS );
 ```
 
-## NetworkProvider
-The CashScript SDK needs to connect to the BCH network to perform certain operations, like retrieving the contract's balance, or sending transactions. All network functionality that the CashScript SDK needs is encapsulated in a network provider. This allows different network providers to be used and makes it easy to swap out dependencies.
-
-### ElectrumNetworkProvider
-```ts
-new ElectrumNetworkProvider(network?: Network, electrum?: ElectrumCluster)
-```
-
-The ElectrumNetworkProvider uses [electrum-cash][electrum-cash] to connect to the BCH network. This is the recommended provider for most use cases and is used as the default when no other provider is provided. Both `network` and `electrum` parameters are optional, and they default to mainnet and a 2-of-3 ElectrumCluster with a number of reliable electrum servers.
-
-#### Example
-```ts
-const provider = new ElectrumProvider('testnet');
-```
-
-### FullStackNetworkProvider
-```ts
-new FullStackNetworkProvider(network: Network, bchjs: BCHJS)
-```
-
-The FullStackNetworkProvider uses [FullStack.cash][fullstack]' infrastructure to connect to the BCH network. FullStack.cash' offers dedicated infrastructure and support plans for larger projects. Both `network` and `bchjs` parameters are mandatory, where `bchjs` is an instance of FullStack.cash' [BCHJS][bchjs].
-
-:::note
-The FullStackNetworkProvider does not currently support CashTokens. If you want to use CashTokens, please use the ElectrumNetworkProvider instead.
-:::
-
-#### Example
-```js
-import BCHJS from '@psf/bch-js';
-
-const restURL = 'https://api.fullstack.cash/v3/';
-const apiToken = 'eyJhbGciO...'; // Your JWT token here.
-const bchjs = new BCHJS({ restURL, apiToken });
-
-const provider = new FullStackNetworkProvider('mainnet', bchjs);
-```
-
-### BitcoinRpcNetworkProvider
-```ts
-new BitcoinRpcNetworkProvider(network: Network, url: string, options?: any)
-```
-
-The BitcoinRpcNetworkProvider uses a direct connection to a BCH node. Note that a regular node does not have indexing, so any address of interest (e.g. the contract address) need to be registered by the node *before* sending any funds to those addresses. Because of this it is recommended to use a different network provider unless you have a specific reason to use the RPC provider.
-
-:::note
-The BitcoinRpcNetworkProvider does not currently support CashTokens. If you want to use CashTokens, please use the ElectrumNetworkProvider instead.
-:::
-
-#### Example
-```js
-const provider = new BitcoinRpcNetworkProvider('mainnet', 'http://localhost:8332');
-```
-
-### MockNetworkProvider
-```ts
-new MockNetworkProvider()
-```
-
-The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. You can read more about the `MockNetworkProvider` and debugging in the [debugging guide](/docs/sdk/debugging).
-
-### Custom NetworkProviders
-A big strength of the NetworkProvider setup is that it allows you to implement custom providers. So if new BCH libraries are created in the future, it is simple to use them with CashScript. This also potentially enables the CashScript SDK to be used with other (partially) compatible networks, such as BTC or BSV.
-
-#### NetworkProvider interface
-```ts
-interface NetworkProvider {
-  /**
-   * Variable indicating the network that this provider connects to.
-   */
-  network: Network;
-
-  /**
-   * Retrieve all UTXOs (confirmed and unconfirmed) for a given address.
-   * @param address The CashAddress for which we wish to retrieve UTXOs.
-   * @returns List of UTXOs spendable by the provided address.
-   */
-  getUtxos(address: string): Promise<Utxo[]>;
-
-  /**
-   * @returns The current block height.
-   */
-  getBlockHeight(): Promise<number>;
-
-  /**
-   * Retrieve the Hex transaction details for a given transaction ID.
-   * @param txid Hex transaction ID.
-   * @throws {Error} If the transaction does not exist
-   * @returns The full hex transaction for the provided transaction ID.
-   */
-  getRawTransaction(txid: string): Promise<string>;
-
-  /**
-   * Broadcast a raw hex transaction to the network.
-   * @param txHex The raw transaction hex to be broadcast.
-   * @throws {Error} If the transaction was not accepted by the network.
-   * @returns The transaction ID corresponding to the broadcast transaction.
-   */
-  sendRawTransaction(txHex: string): Promise<string>;
-}
-
-type Network = 'mainnet' | 'testnet3' | 'testnet4' | 'chipnet' | 'regtest';
-
-interface Utxo {
-  txid: string;
-  vout: number;
-  satoshis: bigint;
-  token?: TokenDetails;
-}
-```
-
-[fetch-api]: https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
-[bip68]: https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki
 [wif]: https://en.bitcoin.it/wiki/Wallet_import_format
 [ecpair]: https://bchjs.fullstack.cash/#api-ECPair
 [privatekey]: https://github.com/bitpay/bitcore/blob/master/packages/bitcore-lib-cash/docs/privatekey.md
-[electrum-cash]: https://www.npmjs.com/package/electrum-cash
-[fullstack]: https://fullstack.cash/
-[bchjs]: https://bchjs.fullstack.cash/
-[bitbox]: https://developer.bitcoin.com/bitbox/
diff --git a/website/docs/sdk/network-provider.md b/website/docs/sdk/network-provider.md
new file mode 100644
index 00000000..ddb0fd80
--- /dev/null
+++ b/website/docs/sdk/network-provider.md
@@ -0,0 +1,123 @@
+---
+title: Network Provider
+---
+
+The CashScript SDK needs to connect to the BCH network to perform certain operations, like retrieving the contract's balance, or sending transactions. By default the network provider is an `ElectrumNetworkProvider`.
+
+## ElectrumNetworkProvider
+
+The ElectrumNetworkProvider uses [electrum-cash][electrum-cash] to connect to the BCH network. Both `network` and `electrum` parameters are optional, and they default to mainnet and a 2-of-3 ElectrumCluster with a number of reliable electrum servers.
+```ts
+new ElectrumNetworkProvider(network?: Network, electrum?: ElectrumCluster)
+```
+
+#### Example
+```ts
+const provider = new ElectrumProvider('chipnet');
+```
+
+:::note
+In some cases it might be desirable to overwrite the 2-of-3 ElectrumCluster default to use only a 1-of-1 cluster because of network latency.
+:::
+
+## Interface NetworkProvider
+
+### Network
+```ts
+type Network = 'mainnet' | 'testnet3' | 'testnet4' | 'chipnet' | 'regtest';
+```
+
+The network parameter can be one of 5 different options.
+
+#### Example
+```ts
+const provider = new ElectrumProvider('chipnet');
+```
+
+### getUtxos
+```ts
+async provider.getUtxos(address: string): Promise<Utxo[]>;
+```
+Returns all UTXOs on specific address. Both confirmed and unconfirmed UTXOs are included.
+
+```ts
+interface Utxo {
+  txid: string;
+  vout: number;
+  satoshis: bigint;
+  token?: TokenDetails;
+}
+```
+
+#### Example
+```ts
+const userUtxos = await provider.getUtxos(userAddress)
+```
+
+### getBlockHeight
+```ts
+async provider.getBlockHeight(): Promise<number>;
+```
+Get the current blockHeight.
+
+#### Example
+```ts
+const currentBlockHeight = await provider.getBlockHeight()
+```
+
+### getRawTransaction
+```ts
+async provider.getRawTransaction(txid: string): Promise<string>;
+```
+
+Retrieve the Hex transaction details for a given transaction ID.
+
+#### Example
+```ts
+const rawTransaction = await provider.getRawTransaction(txid)
+```
+
+### sendRawTransaction
+```ts
+async provider.sendRawTransaction(txHex: string): Promise<string>;
+```
+Broadcast a raw hex transaction to the network.
+
+#### Example
+```ts
+const txId = await provider.sendRawTransaction(txHex)
+```
+
+## Advanced Options
+
+All network functionality that the CashScript SDK needs is encapsulated in a network provider. This allows different network providers to be used and makes it easy to swap out dependencies.
+
+### MockNetworkProvider
+```ts
+new MockNetworkProvider()
+```
+
+The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. You can read more about the `MockNetworkProvider` and debugging in the [debugging guide](/docs/sdk/debugging).
+
+#### Example
+```ts
+const provider = new MockNetworkProvider();
+const newUtxo = randomUtxo({satoshis: 10_000n})
+provider.addUtxo(contractAddress, newUtxo);
+```
+
+### Other NetworkProviders
+
+There are two alternative network providers implemented. There is the `FullStackNetworkProvider` which uses [FullStack.cash][fullstack]' infrastructure to connect to the BCH network. There's also the `BitcoinRpcNetworkProvider` uses a direct connection to a Bitcoin Cash node. Currently neither supports CashTokens, so it is recommended to use the ElectrumNetworkProvider.
+
+### Custom NetworkProviders
+A big strength of the NetworkProvider setup is that it allows you to implement custom providers. So if new BCH libraries are created in the future, it is simple to use them with CashScript. Custom NetworkProviders also potentially enables the CashScript SDK to be used with other (partially) compatible networks, such as BTC or BSV.
+
+:::info
+To implement a Custom NetworkProvider refer to the [NetworkProvider interface](https://github.com/CashScript/cashscript/blob/master/packages/cashscript/src/network/NetworkProvider.ts).
+:::
+
+
+[electrum-cash]: https://www.npmjs.com/package/electrum-cash
+[fullstack]: https://fullstack.cash/
+[bchjs]: https://bchjs.fullstack.cash/
\ No newline at end of file
diff --git a/website/sidebars.js b/website/sidebars.js
index 8df02acb..0476bb18 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -28,10 +28,10 @@ module.exports = {
       label: 'JavaScript SDK',
       items: [
         'sdk/instantiation',
+        'sdk/network-provider',
         'sdk/transactions',
         'sdk/transactions-advanced',
         'sdk/debugging',
-        'sdk/examples',
       ],
     },
     {

From df69d9b3751ac23035d49770cee926231f888196 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 13:56:46 +0200
Subject: [PATCH 060/267] add more info types

---
 website/docs/language/types.md | 45 +++++++++++++++++++++++++---------
 1 file changed, 34 insertions(+), 11 deletions(-)

diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index 09f3d300..be16cb6c 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -27,10 +27,22 @@ Operators:
 - Comparisons: `<=`, `<`, `==`, `!=`, `>=`, `>` (all evaluate to `bool`)
 - Arithmetic operators: `+`, `-`, unary `-`, `*`, `/`, `%` (modulo).
 
-Note the clear lack of the `**` (exponentiation) operator as well as any bitwise operators.
+Note the lack of the `**` (exponentiation) operator as well as any bitwise operators.
+
+### Over- & Underflows
+
+The maximum range for 64-bit integers is `-9223372036854775807` to `9223372036854775807`, operations exceeding these limits will fail the transaction. So operations like summation, subtraction and multiplation should take in to account these boundry cases with over- or underflows.
+
+:::caution
+Contract authors should always consider whether `+`, `-` and `*` operations can cause under- or overflows and how this would impact contract security.
+:::
+
+### Division by Zero
+
+The script will fail when the right hand side of division or modulo operations is zero.
 
 :::caution
-The script will fail when the right hand side of Division and modulo operations is zero.
+Contract authors should always consider whether `/` and `%` operations have division-by-zero edge cases and how this would impact contract security.
 :::
 
 ### Date Parsing
@@ -64,7 +76,7 @@ The script will fail if `split()` is called with an index that is out of bounds.
 :::
 
 ## Bytes
-`bytes`: Byte sequence. Can optionally be bound to a byte length by specifying e.g. `bytes4`, `bytes32`, `bytes64`. It is also possible to use `byte` as an alias for `bytes1`.
+`bytes`: Byte sequence. Prefixed with `0x` to indicate hexadecimal sequence. Can optionally be bound to a byte length by specifying e.g. `bytes4`, `bytes32`, `bytes64`. It is also possible to use `byte` as an alias for `bytes1`.
 
 Operators:
 
@@ -85,6 +97,12 @@ Members:
 The script will fail if `split()` is called with an index that is out of bounds.
 :::
 
+#### Example
+```solidity
+bytes mintingCapability = 0x02;
+bytes noCapability = 0x;
+```
+
 ## Bytes types with semantic meaning
 Some byte sequences hold specific meanings inside Bitcoin Cash contracts. These have been granted their own types separate from the regular `bytes` type.
 
@@ -137,14 +155,6 @@ require(bitcoin == cash);
 ## Type Casting
 Type casting can be done both explicitly and implicitly as illustrated below. `pubkey`, `sig` and `datasig` can be implicitly cast to `bytes`, meaning they can be used anywhere where you would normally use a `bytes` type. Explicit type casting can be done with a broader range of types, but is still limited. The syntax of this explicit type casting is illustrated below. Note that you can also cast to bounded `bytes` types.
 
-:::note
-When casting integer types to bytes of a certain size, the integer value is padded with zeros. e.g. `bytes4(0) == 0x00000000`. It is also possible to pad with a variable number of zeros, by passing in a `size` parameter, which indicates the size of the output. e.g. `bytes(0, 4 - 2) == 0x0000`. Lastly, note that `bytes(0) == 0x`.
-:::
-
-:::caution
-When casting bytes types to integer, you should be sure that the bytes value fits inside a 64-bit signed integer, or the script will fail.
-:::
-
 See the following table for information on which types can be cast to other which other types.
 
 | Type    | Implicitly castable to | Explicitly castable to             |
@@ -163,3 +173,16 @@ pubkey pk = pubkey(0x0000);
 bytes editedPk = bytes(pk) + 0x1234;
 bytes4 integer = bytes4(25);
 ```
+
+### Int to Byte Casting
+
+When casting integer types to bytes of a certain size, the integer value is padded with zeros. e.g. `bytes4(0) == 0x00000000`. It is also possible to pad with a variable number of zeros, by passing in a `size` parameter, which indicates the size of the output. e.g. `bytes(0, 4 - 2) == 0x0000`. The size casting can be a very important feature when keeping local state in an nftCommitment or in the simulated state.
+
+:::note
+VM numbers follow Script Number format (A.K.A. CSCriptNum), to convert VM number to bytes or the revserse, it's recommended to use helperfunctions for these conversions from libraries like Libauth.
+:::
+
+
+:::caution
+When casting bytes types to integer, you should be sure that the bytes value fits inside a 64-bit signed integer, or the script will fail.
+:::

From d726562a6099d1ab0c2411545894ed53315aee97 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 15:01:03 +0200
Subject: [PATCH 061/267] separate debugging & testing

---
 website/docs/guides/debugging.md              | 49 +++++++++++++++++++
 .../sdk/{debugging.md => testing-setup.md}    | 31 ++++--------
 website/sidebars.js                           |  3 +-
 3 files changed, 60 insertions(+), 23 deletions(-)
 create mode 100644 website/docs/guides/debugging.md
 rename website/docs/sdk/{debugging.md => testing-setup.md} (70%)

diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
new file mode 100644
index 00000000..07d96008
--- /dev/null
+++ b/website/docs/guides/debugging.md
@@ -0,0 +1,49 @@
+---
+title: Debugging
+---
+
+Debugging is no walk in the park, this is especially true for debugging complex smart contracts. Luckily there is a handful of startegies that can make it easier for developers to discover bugs with their contracts.
+
+Generally there are 2 broad categories of smart contract bugs
+
+- A bug in the smart contract which doesn't allow for valid spending
+- A bug in your invokation making the transaction invalid.
+
+## Simple Transaction Builder
+
+The [Simple Transaction Builder](/docs/sdk/transactions) has deep integration with libauth to enable local transaction evaluation without actual interaction with the Bitcoin Cash network. This allows for advanced debugging functionality.
+
+:::note
+Currently the CashScript debugging tools only work with the [Simple Transaction Builder](/docs/sdk/transactions). We plan to extend the debugging tools to work with the [Advanced Transaction Builder](/docs/sdk/transactions-advanced) in the future.
+:::
+
+
+### Error messages
+
+If a CashScript transaction is sent using any network provider and is rejected by the network (or the `MockNetworkProvider`), the transaction will be evaluated locally using libauth to provide failure reasons and debug information in addition to the failure reason communicated by the network.
+
+### Console Logging
+
+### Bitauth IDE
+
+It is possible to export the transaction for step-by-step debugging in the BitAuth IDE. This will allow you to inspect the transaction in detail, and see exactly why the transaction failed. To do so, you can call the `bitauthUri()` function on the transaction. This will return a URI that can be opened in the BitAuth IDE. This URI is also displayed in the console whenever a transaction fails.
+
+```ts
+const transaction = contract.functions.exampleFunction(0n).to(contract.address, 10000n);
+const uri = await transaction.bitauthUri();
+```
+
+:::caution
+It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
+:::
+
+## Advanced Transaction Builder
+
+Because the advanced transaction builder does not yet support the advanced debugging tooling, you are left with just a few strategies.
+
+### Failing Opcode
+
+### Removing Contract Checks
+
+### Single Check Contract
+
diff --git a/website/docs/sdk/debugging.md b/website/docs/sdk/testing-setup.md
similarity index 70%
rename from website/docs/sdk/debugging.md
rename to website/docs/sdk/testing-setup.md
index 547553d7..5fe11b4c 100644
--- a/website/docs/sdk/debugging.md
+++ b/website/docs/sdk/testing-setup.md
@@ -1,8 +1,10 @@
 ---
-title: Debugging & Testing
+title: Testing Setup
 ---
 
-To speed up contract development and ensure contract quality and security, CashScript takes advantage of deep integration with libauth. This allows for local transaction evaluation without actual interaction with the Bitcoin Cash network. For a quick start, you can check out [our testing-suite example](https://github.com/CashScript/cashscript/tree/next/examples/testing-suite) that demonstrates a full development and testing environment for CashScript contracts, similar to Hardhat on Ethereum.
+Because of deep integration with libauth, CashScript allows for local transaction evaluation without actual interaction with any Bitcoin Cash test network. With a MockNetwork environment you can create virtual UTXOs without doing additional preparations. This has the advantages of not needing any testnet balances, not having to set up smart contract UTXOs and not having network latency. This setup allows for using a testing framework to run repeated automated tests for increased smart contract security.
+
+For a quick start with a CashScript testing setup, you can check out [our testing-suite example](https://github.com/CashScript/cashscript/tree/next/examples/testing-suite) that demonstrates a full development and testing environment for CashScript contracts, similar to Hardhat on Ethereum.
 
 :::caution
 The CashScript debugging tools only work with the [Simple Transaction Builder](/docs/sdk/transactions). We plan to extend the debugging tools to work with the [Advanced Transaction Builder](/docs/sdk/transactions-advanced) in the future.
@@ -28,19 +30,12 @@ provider.addUtxo(aliceAddress, randomUtxo({
 The `MockNetworkProvider` only evaluates the transactions locally, so any UTXOs added to a transaction still count as "unspent", even after mocking a `sendTransaction` using the provider.
 :::
 
-## Transaction evaluation
-
-If a CashScript transaction is sent using any network provider and is rejected by the network (or the `MockNetworkProvider`), the transaction will be evaluated locally using libauth to provide failure reasons and debug information in addition to the failure reason communicated by the network.
+## Jest extension
 
-It is possible to export the transaction for step-by-step debugging in the BitAuth IDE. This will allow you to inspect the transaction in detail, and see exactly why the transaction failed. To do so, you can call the `bitauthUri()` function on the transaction. This will return a URI that can be opened in the BitAuth IDE. This URI is also displayed in the console whenever a transaction fails.
-
-```ts
-const transaction = contract.functions.exampleFunction(0n).to(contract.address, 10000n);
-const uri = await transaction.bitauthUri();
-```
+To make writing automated tests for CashScript contracts easier, we provide a Jest extension that enables easy testing of `console.log` values and `require` error messages. To use the extension, you can import it from `cashscript/dist/test/JestExtensions`.
 
-:::caution
-It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
+:::tip
+If you're using a different testing framework, you can test for `console.log` values by spying on the console output, and test for `require` error messages by asserting that an error is thrown with a specific error message.
 :::
 
 ## Automated testing
@@ -63,15 +58,7 @@ The `require` statement accepts an optional error message as a second argument.
 Similar to `console.log`, the error message in a `require` statement is only available in debug evaluation of a transaction, so the error message has no impact on the compiled bytecode or regular (non-debug) execution.
 :::
 
-### Jest extension
-
-To make writing automated tests for CashScript contracts easier, we provide a Jest extension that enables easy testing of `console.log` values and `require` error messages. To use the extension, you can import it from `cashscript/dist/test/JestExtensions`.
-
-:::tip
-If you're using a different testing framework, you can test for `console.log` values by spying on the console output, and test for `require` error messages by asserting that an error is thrown with a specific error message.
-:::
-
-### Example
+## Example
 
 ```solidity title="Example contract"
 contract Example() {
diff --git a/website/sidebars.js b/website/sidebars.js
index 0476bb18..c0bfe798 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -31,7 +31,7 @@ module.exports = {
         'sdk/network-provider',
         'sdk/transactions',
         'sdk/transactions-advanced',
-        'sdk/debugging',
+        'sdk/testing-setup',
       ],
     },
     {
@@ -40,6 +40,7 @@ module.exports = {
       items: [
         'guides/syntax-highlighting',
         'guides/covenants',
+        'guides/debugging',
         'guides/optimization'
       ],
     },

From 5f8f6cc67dbff888fecce67cb212f528b9cefc76 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 15:32:30 +0200
Subject: [PATCH 062/267] fix links to debugging page

---
 website/docs/language/contracts.md   | 4 ++--
 website/docs/sdk/network-provider.md | 2 +-
 website/docs/sdk/transactions.md     | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index 3e31a86d..8a54a77e 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -61,7 +61,7 @@ CashScript functions are made up of a collection of statements that determine wh
 ### require()
 The most important statement of CashScript contracts is the `require` statement. This statement takes a boolean expression and checks that it evaluates to `true`. If it evaluates to `false` instead, the transaction fails. This statement is used to ensure that the requirements are met to spend money from the contract.
 
-The `require` statement can also take an optional error message as a second argument. This can be used to provide more information about why the transaction failed when running the transaction in debug mode. You can read more about debugging in the [debugging guide](/docs/sdk/debugging).
+The `require` statement can also take an optional error message as a second argument. This can be used to provide more information about why the transaction failed when running the transaction in debug mode. You can read more about debugging in the [debugging guide](/docs/guides/debugging).
 
 :::note
 The error message in a `require` statement is only available in debug evaluation of a transaction, so the error message has no impact on the compiled bytecode or regular (non-debug) execution.
@@ -130,7 +130,7 @@ contract OneOfTwo(bytes20 pkh1, bytes32 hash1, bytes20 pkh2, bytes32 hash2) {
 ```
 
 ### console.log()
-The `console.log` statement can be used to log values during debug evaluation of a transaction. Any variables or primitive values (such as ints, strings, bytes, etc) can be logged. You can read more about debugging in the [debugging guide](/docs/sdk/debugging).
+The `console.log` statement can be used to log values during debug evaluation of a transaction. Any variables or primitive values (such as ints, strings, bytes, etc) can be logged. You can read more about debugging in the [debugging guide](/docs/guides/debugging).
 
 :::note
 Logging is only available in debug evaluation of a transaction, but has no impact on the compiled bytecode or regular (non-debug) execution.
diff --git a/website/docs/sdk/network-provider.md b/website/docs/sdk/network-provider.md
index ddb0fd80..d4a8d08e 100644
--- a/website/docs/sdk/network-provider.md
+++ b/website/docs/sdk/network-provider.md
@@ -97,7 +97,7 @@ All network functionality that the CashScript SDK needs is encapsulated in a net
 new MockNetworkProvider()
 ```
 
-The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. You can read more about the `MockNetworkProvider` and debugging in the [debugging guide](/docs/sdk/debugging).
+The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. You can read more about the `MockNetworkProvider` and automated tests on the [testing-setup](/docs/sdk/testing-setup) page.
 
 #### Example
 ```ts
diff --git a/website/docs/sdk/transactions.md b/website/docs/sdk/transactions.md
index 43d36c52..bf78e786 100644
--- a/website/docs/sdk/transactions.md
+++ b/website/docs/sdk/transactions.md
@@ -248,7 +248,7 @@ If you want to debug a transaction locally instead of sending it to the network,
 
 If you prefer a lower-level debugging experience, you can call the `bitauthUri()` function on the transaction. This will return a URI that can be opened in the BitAuth IDE. This URI is also displayed in the console whenever a transaction fails.
 
-You can read more about debugging transactions [here](/docs/sdk/debugging).
+You can read more about debugging transactions [here](/docs/guides/debugging).
 
 :::caution
 It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.

From 8dd1efde399a14301cb9259cce376a47d231b650 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 17:10:49 +0200
Subject: [PATCH 063/267] add to debugging guide

---
 website/docs/guides/debugging.md | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 07d96008..45cb121d 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -17,16 +17,21 @@ The [Simple Transaction Builder](/docs/sdk/transactions) has deep integration wi
 Currently the CashScript debugging tools only work with the [Simple Transaction Builder](/docs/sdk/transactions). We plan to extend the debugging tools to work with the [Advanced Transaction Builder](/docs/sdk/transactions-advanced) in the future.
 :::
 
-
 ### Error messages
 
 If a CashScript transaction is sent using any network provider and is rejected by the network (or the `MockNetworkProvider`), the transaction will be evaluated locally using libauth to provide failure reasons and debug information in addition to the failure reason communicated by the network.
 
+Read the error message to see which line in the CashScript contract causes the transcation validation to fail. Investigate whether the contract function invocation is the issue (on the javascript SDK side) or whether the issue is in the CashScript contract itself (so you'd need to update your contract and recompile the artifact). If it is not clear **why** the CashScript contract is failing on that line, then you can use the following two strategies: console logging & Bitauth IDE stack trace.
+
 ### Console Logging
 
+To help with debugging you can add `console.log` statements to your CashScript contract file to log variables. This way you investigate whether the variable have the expected values when they get to the failing `require` statement in the CashScript file. After adding the `console.log` statements, recompile your contract so they are added to your contract's Arifact. 
+
 ### Bitauth IDE
 
-It is possible to export the transaction for step-by-step debugging in the BitAuth IDE. This will allow you to inspect the transaction in detail, and see exactly why the transaction failed. To do so, you can call the `bitauthUri()` function on the transaction. This will return a URI that can be opened in the BitAuth IDE. This URI is also displayed in the console whenever a transaction fails.
+Whenever a transaction fails there will be a link in the console to open your smart contract trnasaction in the BitAuth IDE. This will allow you to inspect the transaction in detail, and see exactly why the transaction failed. In the BitAuth IDE you will see the raw BCH Script mapping to each line in your CashScript contract. Find the failing line and investigate the failing OpCode. You can break up the failing line, one opcode at a time to see how the stack evolves and ends with your `require` failure.
+
+It's also possible to export the transaction for step-by-step debugging in the BitAuth IDE without failure. To do so, you can call the `bitauthUri()` function on the transaction. This will return a URI that can be opened in the BitAuth IDE.
 
 ```ts
 const transaction = contract.functions.exampleFunction(0n).to(contract.address, 10000n);
@@ -43,7 +48,14 @@ Because the advanced transaction builder does not yet support the advanced debug
 
 ### Failing Opcode
 
+When a transaction gets rejected by a full node it will return a cryptic error message, read the message carefully to investigate whether the issue is a failing script (failing OpCode) or whether a standarness rule like minimum-relay-fee is violated. If the cause is a failing OpCode, you can check the contract's Artifact to see how many appearances this OpCode has. Sometimes the OpCode only appears once or twice, indicating where the failing `require` statement is. Other times you might see 15 appearances of the OpCode leaving you to try the next strategies.
+
 ### Removing Contract Checks
 
+If your contract fails, you can remove (or comment out) the lines that are the likely cause of the error. After recompiling to a new Artifact you can test whether the remaining subcontract works or fails with a different error. If this is the case then you learned that there is an issue in the removed CashScript code block. In the worst case when you have no indication from the failing opcode (previous strategy) then you will have to try remove different parts of your contract and trying different sub-contracts repeatedly. 
+
+To use this strategy effectively, the contract setup with funding should be automated as to avoid having to send testnet coins manually to each different subcontract. However inefficient, this strategy should always be able to get you to find the failing line in your CashScript contract. Then you can investigate whether the issue is the contract invocation or the `require` statement in the CashScript file.
+
 ### Single Check Contract
 
+If it is unclear whether the issue is the contract invocation or the `require` statement in the CashScript file, it might prove handy to create a 'single-check Contract' which has only the previously failing require statement. The goal then is to discover if your transaction is the issue and you are violating a correct contract requirement or whether the contract is enforcing an incorrect/impossible condition to hold in the spending transaction.

From 9fd45d886de5550d8cd850cb4f1e0288ce004c77 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 17:37:55 +0200
Subject: [PATCH 064/267] improve coventants guide

---
 website/docs/guides/covenants.md | 40 ++++++++++++++++++++++++++------
 1 file changed, 33 insertions(+), 7 deletions(-)

diff --git a/website/docs/guides/covenants.md b/website/docs/guides/covenants.md
index 499b3109..052b7ac7 100644
--- a/website/docs/guides/covenants.md
+++ b/website/docs/guides/covenants.md
@@ -135,11 +135,17 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
 
 This contract applies similar techniques as the previous two examples to verify the signature, although in this case it does not matter who the *signer* of the transaction is. Since the outputs are restricted with covenants, there is **no way** someone could call this function to send money **anywhere but to the correct outputs**.
 
-### Keeping local State in NFTs
+## Local State
+
+Smart contracts which persist for multiple transactions might want to keep data for later use, this is called local state. With the CashTokens upgrade local state can be kept in the commitment field of the NFT of the smart contract UTXO. Because the state is not kept in the script of the smart contract itself, the address can remain the same. 
 
-Smart contracts which persist for multiple transactions might want to keep data for later use, this is called local state. With the CashTokens upgrade local state can be kept in the commitment field of the NFT of the smart contract UTXO. Because the state is not kept in the script of the smart contract itself, the address can remain the same unlike with the "simulated state" strategy where the P2SH locking bytecode of the new iteration of the contract was restricted to contain the updated state, which caused the address to change each time.
+:::info
+Covenants can also use 'simulated state', where state is kept in the contract script and the contract enforces a new P2SH locking bytecode of the contract with a different state update. This method causes the contract address to change with each state update.
+:::
+
+### Keeping local State in NFTs
 
-To demonstrate this we consider the Mecenas contract again, and focus on a drawback of this contract: you have to claim the funds at exactly the right moment or you're leaving money on the table. Every time you claim money from the contract, the `tx.age` counter is reset, so the next claim is possible 30 days after the previous claim. So if we wait a few days to claim, **these days are basically wasted**.
+To demonstrate the concept of 'local state' we consider the Mecenas contract again, and focus on a drawback of this contract: you have to claim the funds at exactly the right moment or you're leaving money on the table. Every time you claim money from the contract, the `tx.age` counter is reset, so the next claim is possible 30 days after the previous claim. So if we wait a few days to claim, **these days are basically wasted**.
 
 Besides these wasted days it can also be inconvenient to claim at set intervals, rather than the "streaming" model that the Ethereum project [Sablier](https://www.sablier.finance/) employs. Instead of set intervals, you should be able to claim funds at any time during the "money stream". Using local state, we can approach a similar system with BCH.
 
@@ -199,9 +205,22 @@ contract StreamingMecenas(
 
 Instead of having a pledge per 30 day period, we define a pledge per block. At any point in time we can calculate how much money the recipient has earned. Then the covenant **enforces that this amount is withdrawn from the contract**. The remainder is sent to a new stream that **starts at the end of of the previous one**. The locktime used for the last withdrawal from the covenant is kept in the local state to calculate the amount of money the recipient has earned over the passed time. This process of changing the local state in the NFT associated with the smart contractUTXO can be applied to the new stream until the money in the stream runs out.
 
+:::tip
+We use `tx.locktime` to introspect the value of the timelock, and to write the value to the contract local state: the NFT commitment field.
+:::
+
 ### Issuing NFTs as receipts
 
-A covenant that manages funds (BCH + fungible tokens of a certain category) which are pooled together from different people often wants to enable its participants to also exit the covenants with their funds. Instead of keeping track of which address contributed how much in the local state, a better strategy is to issue a receipt for each time funds are added to the pool. Technically this happens by minting a new NFT with in the commitment field the amount of satoshis or fungible tokens that were contributed to the pool and sending this to the address of the contributor. All outputs need to be carefully controlled in the covenant contract code so no additional NFTs can be minted in other outputs. The minted NFTs only differ from the covenant's minting NFT in that there is no minting capability added to the token's categoryID when calling `.tokenCategory`. At withdrawal this NFT commitment data needs to be read and the receipt NFT needs to be burned.
+A covenant that manages funds (BCH + fungible tokens of a certain category) which are pooled together from different people often wants to enable its participants to also exit the covenants with their funds. It would be incredibly hard continuously updating a data structure to keep track of which address contributed how much in the local state of the contract. A much better solution is to issue receipts each time funds are added to the pool! This way the contract does not have a 'global view' of who owns what at any time, but it can validate the receipts when invocing a withdrawal. 
+
+Technically this happens by minting a new NFT with in the commitment field the amount of satoshis or fungible tokens that were contributed to the pool and sending this to the address of the contributor.
+
+:::tip
+Minting NFT receipts allows the contract to offload state to an NFT helf by a user. By default these receipts are easily transferable and tradable because they are generic NFTs.
+:::
+
+Let's take a look at an example contract called `PooledFunds` which has two contract functions: `addFunds` and `withdrawFunds`
+
 
 ```solidity
 contract PooledFunds(
@@ -250,7 +269,7 @@ contract PooledFunds(
             require(tx.outputs[2].tokenCategory == bytes(0));
         }
     }
-    function withdraw(
+    function withdrawFunds(
     ) {
         // Require the covenant contract always lives at index zero with a minting NFT
         require(this.activeInputIndex == 0);
@@ -288,10 +307,17 @@ contract PooledFunds(
 }
 ```
 
-Keeping local state in NFTs and issuing NFTs as receipts are two strategies which can be used to create much more sophisticated decentralized applications such as the AMM-style DEX named [Jedex](https://blog.bitjson.com/jedex-decentralized-exchanges-on-bitcoin-cash/).
+All outputs of the `PooledFunds` contract need to be carefully controlled in the contract code so no additional NFTs can be minted in other outputs as this would allow 'fake' receipts to be created. The user receipt NFTs only differ from the covenant's minting NFT in that there is no minting capability added to the token's categoryID when calling `.tokenCategory`. At withdrawal the receipt needs to be validated and then the NFT commitment data is read to understand the contents of the receipt. In the current contract the receipt NFT also needs to be burned (simply not re-created in the outputs) ensuring the same receipt cannot be used to withdraw twice.
+
+:::caution
+With contracts holding minting NFTs, all outputs need to be carefully controlled in the covenant contract code so no additional (minting) NFTs can un-intentionally be created in other outputs.
+:::
+
 
 ## Conclusion
-We have discussed the main uses for covenants as they exist on Bitcoin Cash today. We've seen how we can achieve different use case by combining transaction output restrictions to `P2SH` and `P2PKH` outputs. We also touched on more advanced subjects such as keeping local state in NFTs. Covenants and CashTokens are the **main differentiating factor** for BCH smart contracts when compared to BTC, while keeping the same **efficient stateless verification**. If you're interested in learning more about the differences in smart contracts among BCH, BTC and ETH, read the article [*Smart contracts on Ethereum, Bitcoin and Bitcoin Cash*](https://kalis.me/smart-contracts-eth-btc-bch/).
+We have discussed the main uses for covenants as they exist on Bitcoin Cash today. We've seen how we can achieve different use case by combining transaction output restrictions to `P2SH` and `P2PKH` outputs. We also touched on more advanced subjects such as keeping local state in NFTs. Covenants and CashTokens are the **main differentiating factor** for BCH smart contracts when compared to BTC, while keeping the same **efficient, atomic verification**.
+
+Keeping local state in NFTs and issuing NFTs as receipts are two strategies which can be used to create much more sophisticated decentralized applications such as the AMM-style DEX named [Jedex](https://blog.bitjson.com/jedex-decentralized-exchanges-on-bitcoin-cash/).
 
 [bitcoin-covenants]: https://fc16.ifca.ai/bitcoin/papers/MES16.pdf
 [bip68]: https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki

From 92d6db3f202d165b8117efd3266cc0ca938e3c3a Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 30 May 2024 18:18:15 +0200
Subject: [PATCH 065/267] Misc. fixes docs website

---
 website/docs/basics/{cli.md => compiler.md} | 0
 website/docs/basics/getting-started.md      | 2 +-
 website/docs/guides/covenants.md            | 4 ++--
 website/docs/guides/debugging.md            | 6 ++++--
 website/docs/sdk/instantiation.md           | 2 +-
 website/sidebars.js                         | 2 +-
 6 files changed, 9 insertions(+), 7 deletions(-)
 rename website/docs/basics/{cli.md => compiler.md} (100%)

diff --git a/website/docs/basics/cli.md b/website/docs/basics/compiler.md
similarity index 100%
rename from website/docs/basics/cli.md
rename to website/docs/basics/compiler.md
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 8e372a2c..02ab6c70 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -114,7 +114,7 @@ console.log(await contract.getUtxos())
 For a code example of how to generate key-pairs with Libauth see the [CashScript Examples](https://github.com/CashScript/cashscript/blob/master/examples/common.ts) `common-ts` file where Alice and Bob's key-pairs are created!
 :::
 
-### Creating a Transction
+### Creating a Transaction
 
 Lastly to spend from the smart contract we've initialised you need to make sure there is an actual contract balance on the smart contract address. Or in other words, you need to make sure there's at least one UTXO with the smart contract locking bytecode so we can spend from it!
 
diff --git a/website/docs/guides/covenants.md b/website/docs/guides/covenants.md
index 052b7ac7..2897a985 100644
--- a/website/docs/guides/covenants.md
+++ b/website/docs/guides/covenants.md
@@ -266,7 +266,7 @@ contract PooledFunds(
         // A 3rd output for change is allowed
         if (tx.outputs.length == 3) {
             // Require that the change output does not mint any NFTs
-            require(tx.outputs[2].tokenCategory == bytes(0));
+            require(tx.outputs[2].tokenCategory == 0x);
         }
     }
     function withdrawFunds(
@@ -302,7 +302,7 @@ contract PooledFunds(
         require(tx.outputs[1].value == amountToWithdraw - 1000);
 
         // require that the receipt NFT is burned
-        require(tx.outputs[1].tokenCategory == bytes(0));
+        require(tx.outputs[1].tokenCategory == 0x);
     }
 }
 ```
diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 45cb121d..ebe2b167 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -6,8 +6,10 @@ Debugging is no walk in the park, this is especially true for debugging complex
 
 Generally there are 2 broad categories of smart contract bugs
 
-- A bug in the smart contract which doesn't allow for valid spending
-- A bug in your invokation making the transaction invalid.
+- A bug in your invocation making the transaction invalid
+- A bug in the smart contract which prohibits valid spending
+
+Whatever category your bug falls into, the first step is discovering what line in your CashScript contract is making your transaction get rejected. Afterwards, investigation needs to start whether it's a contract bug, or a invocation bug.
 
 ## Simple Transaction Builder
 
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index a10c543e..4d08108a 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -25,7 +25,7 @@ new Contract(
 
 A CashScript contract can be instantiated by providing an `Artifact` object, a list of constructor arguments, and optionally an options object configuring `NetworkProvider` and `addressType`.
 
-An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/language/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/basics/cli) or programmatically with the `cashc` NPM package (see [CashScript Compiler](#cashscript-compiler)).
+An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/language/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/basics/compiler) or programmatically with the `cashc` NPM package (see [CashScript Compiler](#cashscript-compiler)).
 
 The `NetworkProvider` option is used to manage network operations for the CashScript contract. By default, a mainnet `ElectrumNetworkProvider` is used, but the network providers can be configured. See the docs on [NetworkProvider](/docs/sdk/network-provider).
 
diff --git a/website/sidebars.js b/website/sidebars.js
index c0bfe798..888c1069 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -7,7 +7,7 @@ module.exports = {
         'basics/about',
         // 'basics/about-bch',
         'basics/getting-started',
-        'basics/cli',
+        'basics/compiler',
       ],
     },
     {

From 6e3ca7a61bf89c95dd6e1a7be4a37550f8a4d31a Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 31 May 2024 10:42:48 +0200
Subject: [PATCH 066/267] added badgers.cash to showcase

---
 website/docs/showcase.md       |   8 ++++++++
 website/static/img/badgers.png | Bin 0 -> 71393 bytes
 2 files changed, 8 insertions(+)
 create mode 100644 website/static/img/badgers.png

diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index d375afe5..a404c1fd 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -52,6 +52,14 @@ BCH Guru is a non-custodial price-prediction platform and a collectible NFT proj
 
 The CashTokens Studio is an application for creating CashTokens and for their managing metadata updates and reserved supply. The CashTokens Studio uses CashScript to lock the AuthUTXO in an AuthGuard contract to prevent accidentally spending the authority to be able to update the token's metadata or release reserved supply.
 
+## Badgers.cash
+
+<div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
+    <a href="https://badgers.cash/" target="_blank"><img style={{borderRadius: '100%'}} src="/img/badgers.png" /></a>
+</div>
+
+BadgerCoin is a fungible CashToken using a novel distibution mechanism. BadgerCoins are earned through staking Bitcoin Cash in the Badgers Smart Contract. The staking duration is predetermined, and depending on the stake amount and period you earn tokens. The website allows for anyone to invoce contract unlocks.
+
 ## BCHouse
 
 <div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
diff --git a/website/static/img/badgers.png b/website/static/img/badgers.png
new file mode 100644
index 0000000000000000000000000000000000000000..a0c9613ccfcba40ad52582a02b9dd9c8f4e23127
GIT binary patch
literal 71393
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

literal 0
HcmV?d00001


From aa32ecb9d31fd60c719810748605919c91682bf1 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 31 May 2024 17:29:23 +0200
Subject: [PATCH 067/267] rewrite optimization guide

---
 website/docs/guides/optimization.md | 132 ++++++++++++++++++----------
 website/docs/language/contracts.md  |   2 +-
 2 files changed, 85 insertions(+), 49 deletions(-)

diff --git a/website/docs/guides/optimization.md b/website/docs/guides/optimization.md
index 64ed1813..7b6393eb 100644
--- a/website/docs/guides/optimization.md
+++ b/website/docs/guides/optimization.md
@@ -3,87 +3,123 @@ title: Optimizing Contracts
 sidebar_label: Optimization
 ---
 
-CashScript contracts are transpiled from a solidity syntax to [Bitcoin Script](https://reference.cash/protocol/blockchain/script) by the `cashc` compiler. Bitcoin Script is a lower level language (a list of stack-based operations) where each available operation is mapped to a single byte.
+CashScript contracts are transpiled from a solidity syntax to [BCH Script](https://reference.cash/protocol/blockchain/script) by the `cashc` compiler. BCH Script is a lower level language (a list of stack-based operations) where each available operation is mapped to a single byte.
 
 Depending on the complexity of the contract or system design, it may sometimes be useful to optimize the Bitcoin Script by tweaking the contract in CashScript before it is compiled. Below are some ideas to get started.
 
-## Tricks and tips.
+## Optimization Tips & Tricks
 
-The `cashc` compiler does some optimisations automatically, but by ordering statements in a specific way, the compiler is better able to optimise it. Trial & error is a big part of it, but here's some tricks that may help:
+The `cashc` compiler does some optimisations automatically, but by writing your CashScript code in a specific way, the compiler is better able to optimise it. Trial & error is a definately part of it, but here are some tricks that may help:
 
-1. It's best to "consume" values as soon as possible ("consume" meaning their final use in the contract). This frees up space on the stack.
-2. Use/consume values as close to their declaration as possible, both for variables and for parameters. This avoids having to do deep stack operations. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L61-72) from anyhedge illustrates consuming values immediately.
-3. Avoid if-statements if possible, instead try to "inline" them. This is because the compiler cannot know which branches will be taken, and therefore cannot optimise those branches as well. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L128-130) from anyhedge illustrates inlining flow control.
+### 1. Consume stack items
 
-## Example Workflow
+It's best to "consume" values as soon as possible ("consume" meaning their final use in the contract). This frees up space on the stack.
+Use/consume values as close to their declaration as possible, both for variables and for parameters. This avoids having to do deep stack operations. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L61-72) from anyhedge illustrates consuming values immediately.
+
+### 2. Declare variables
+
+Declare variables when re-using certain common introspection items to avoid duplicate expressions
+
+```solidity title="Example CashScript code"
+    // do this
+    bytes tokenIdContract = tx.inputs[0].tokenCategory.split(32)[0];
+    require(tx.inputs[1].tokenCategory == tokenIdContract);
+    require(tx.outputs[1].tokenCategory == tokenIdContract);
+
+    // not this
+    require(tx.inputs[1].tokenCategory == tx.inputs[0].tokenCategory.split(32)[0]);
+    ...
+    require(tx.inputs[1].tokenCategory == tx.inputs[0].tokenCategory.split(32)[0]);
+```
+
+### 3. Parse efficiently
+When using `.split()` to use both sides of a `bytes` element, declare both parts immediately to save on opcodes aprsing the byte array.
 
-For simplicity and security, the compiler separates the data and logic of the redeem script. All the data used by the redeem script gets pushed to the stack, and the redeem script is then the same regardless of the parameters being used in a particular instance of a contract.
+```solidity title="Example CashScript code"
+    // do this
+    bytes firstPart, bytes secondPart = tx.inputs[0].nftCommitment.split(10);
 
-As an example, below is a simple [hodl](https://github.com/mainnet-pat/hodl_ec_plugin) contract by mainnet-pat:
+    // not this
+    bytes firstPart = tx.inputs[0].nftCommitment.split(10)[0];
+    ...
+    bytes secondPart = tx.inputs[0].nftCommitment.split(10)[1];
+```
+### 4. Avoid if-else
 
+Avoid if-statements if possible, instead try to "inline" them. This is because the compiler cannot know which branches will be taken, and therefore cannot optimise those branches as well. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L128-130) from anyhedge illustrates inlining flow control:
 
-```solidity
-// hodl.cash
-pragma cashscript ^0.9.0;
+```solidity title="AnyHedge CashScript code"
+    // do this
+    bool onOrAfterMaturity = settlementTimestamp >= maturityTimestamp;
+    bool priceOutOfBounds = !within(clampedPrice, lowLiquidationPrice + 1, highLiquidationPrice);
+    require(onOrAfterMaturity || priceOutOfBounds);
 
-contract hodl(
-    int locktime,
-    bytes20 pubkeyHash
-) {
-    function spend(pubkey ownerPubkey, sig ownerSig) {
-        require(tx.time >= locktime);
-        require(hash160(ownerPubkey) == pubkeyHash);
-        require(checkSig(ownerSig, ownerPubkey));
+    // not this
+    if(!(settlementTimestamp >= maturityTimestamp)){
+        bool priceOutOfBounds = !within(clampedPrice, lowLiquidationPrice + 1, highLiquidationPrice);
+        require(priceOutOfBounds);
     }
-}
 ```
 
-For the above script, this  `spend` path transpiles to a redeem script of:
+## Modular Contract Design
 
- `<pubkeyHash> <locktime> b1 75 78 a9 88 ac`
+An alternative to optimizing your contract to shrink it in size is to redesign your contract to use a composable architecture so the contract logic is separated out in to multiple componenets which only some of which can be used in a transaction and hence shrink your contract size.
 
-Here the data are pushed first, and the operations corresponding to the bytes in Bitcoin Script have short names as follows:
+### NFT contract functions
 
-| hex     | Operation Code         |
-|---------| ---------------------- |
-| 0xb1    | OP_CHECKLOCKTIMEVERIFY |
-| 0x17    | OP_DROP                |
-| 0x57    | OP_OVER                |
-| 0xa9    | OP_HASH160             |
-| 0x88    | OP_EQUALVERIFY         |
-| 0xac    | OP_CHECKSIG            |
+The concept of having NFT functions was firt introduced by the [Jedex demo](https://github.com/bitjson/jedex#demonstrated-concepts) and was first implemented in a CashScript contract by the [FexCash DEX](https://github.com/fex-cash/fex/blob/main/whitepaper/fex_whitepaper.md). The concept is that by authenticating NFTs you can make each function a separate contract with the same tokenId. This way you can offload logic from the main contract and one function NFT contract attached to the main contract on spending so the other contract functions exist as unused UTXOs separate from the transaction.
 
-In the artifact generated by `cashc`, the redeem script is listed as follows:
+:::tip
+By using function NFTs you can use a modular contract design where the contract functions are offloaded to different UTXOs, each identifiable by the main contract by using the same tokenId.
+:::
+
+## Example Workflow
 
+When trying to optimizing your contract, you will need to compare the contract size to see if the changes have a positive impact.
+You can easily check the opcode count and bytesize with the compiler CLI directly from the contract (without creating a new artifact).
+It's important to know the minimum fees on the Bitcoin Cash network are based on the bytesize of a transaction (including your contract).
 
 ```bash
-cashc hodl.cash | grep bytecode;
+cashc ./contract.cash --opcount --size
 ```
 
-```json
-"bytecode": "OP_CHECKLOCKTIMEVERIFY OP_DROP OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG"
-```
+:::caution
+The size output of the `cashc` compiler will always be an underestimate, as the contract hasn't been initialized with contract arguments.
+:::
 
-As you can see, in this case, the logic to spend time-locked funds and verify the spender takes up six (6) bytes of information.
+The `cashc` compiler only knows the opcount and bytesize of a contract before it is initialised with function arguments. Because of this, to get an accurate view of a contracts size initialise the contract instance first, then get the size from there. This means you will have to re-compile the artifact before checking with contract size through the Javascript SDK.
 
-The simplest workflow to optimize the redeem script of `hodl.cash`, or any contract, would be to compile it directly from the command line with `cashc` then look at the `bytecode` field on the generated artifact to see if there are any unnecessary or duplicative operations.
+```javascript
+import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
+import { alicePub, bobPriv, bobPub } from './keys.js';
+import { compileFile } from 'cashc';
 
-In this toy example, the redeem script is so small there isn't a lot of need or use in making it smaller. The [anyhedge contracts](https://gitlab.com/GeneralProtocols/anyhedge/contracts/) are again a great example of a more complex progressive optimization over time.
+// compile contract code on the fly
+const artifact = compileFile(new URL('contract.cash', import.meta.url));
 
-## Lastly
+// Initialise a network provider for network operations
+const provider = new ElectrumNetworkProvider('chipnet');
 
+// Instantiate a new TransferWithTimeout contract
+const contractArguments = [alicePub, bobPub, 100000n]
+const options = { provider }
+const contract = new Contract(artifact, contractArguments, options);
 
-There are two important alternative approaches to optimization to consider.
+console.log(contract.opcount);
+console.log(contract.bytesize);
+```
 
-### OP_NOP
+With this workflow you can make changes to the contract and the run the Javascript program to
 
->We should forget about small efficiencies, say about 97% of the time: premature optimization is the root of all evil. Yet we should not pass up our opportunities in that critical 3%.
+ get an accurate measure of how the bytesize of your contract changes with different optimizations.
 
-It's worth considering whether optimizing the redeem script is necessary at all. If the contract is accepted by the network, and there is no glaring inefficiency in the bytecode, perhaps the best optimization is to not to obsess prematurely about things like blocksize.
+## To optimize or not to optimize?
 
-### Hyper Introspect-imization
+There is a last important alternative approache to optimization contract bytecode to consider:
 
-Finally, there have been a number of novel approaches taken since 2009 to approximate higher level functionality with bitcoin's deliberately restricted instruction set. These techniques include using a cumbersome [old covenant style](https://fc16.ifca.ai/bitcoin/papers/MES16.pdf) of storing data, [`OP_CODESEPARATOR`](https://web.archive.org/web/20210507164307/https://mistcoin.org/#appendix-b) to split contracts around an old 520-byte limitation, and hiding redeem paths in "sidecars".
+### OP_NOP
+
+>We should forget about small efficiencies, say about 97% of the time: premature optimization is the root of all evil. Yet we should not pass up our opportunities in that critical 3%.
 
-It's **very** important to be up-to-date on documentation covering introspection, as it greatly simplifies using state and writing more complex contracts. If a contract has been developed from an old example or a pre-introspection design pattern, the fastest way to achieve significant optimization is to utilize the [the latest introspection design patterns](./covenants).
+It's worth considering whether optimizing the redeem script is necessary at all. If the contract is accepted by the network, and there is no glaring inefficiency in the bytecode, perhaps the best optimization is to not to obsess prematurely about things like blocksize.
 
diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index 8a54a77e..3bf7f56c 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -14,7 +14,7 @@ The pragma directive follows regular [semantic versioning rules](https://semver.
 #### Example
 ```solidity
 pragma cashscript ^0.9.0;
-pragma cashscript >= 0.4.0 < 0.5.4;
+pragma cashscript >= 0.7.0 < 0.9.3;
 ```
 
 ## Constructor

From 59de8bc05811054c9b5f0d273a8dc2582ccc9225 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 31 May 2024 20:00:21 +0200
Subject: [PATCH 068/267] remove edit button

---
 website/docusaurus.config.js | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
index 40a02b63..008386f3 100755
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@@ -101,11 +101,6 @@ module.exports = {
     [
       '@docusaurus/preset-classic',
       {
-        docs: {
-          sidebarPath: require.resolve('./sidebars.js'),
-          editUrl:
-            'https://github.com/Bitcoin-com/cashscript/edit/master/website/',
-        },
         theme: {
           customCss: require.resolve('./src/css/custom.css'),
         },

From 0602d05a0ceb6fe5c328f643c77a2d9952b0fb52 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 31 May 2024 20:01:57 +0200
Subject: [PATCH 069/267] change github links docs

---
 packages/cashc/README.md               | 2 +-
 packages/cashscript/README.md          | 2 +-
 website/docs/basics/getting-started.md | 2 +-
 website/docs/language/examples.md      | 2 +-
 website/docs/releases/release-notes.md | 2 +-
 website/docs/sdk/examples.md           | 2 +-
 website/docusaurus.config.js           | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/cashc/README.md b/packages/cashc/README.md
index 6f6165c7..bd336afc 100644
--- a/packages/cashc/README.md
+++ b/packages/cashc/README.md
@@ -8,7 +8,7 @@
 
 CashScript is a high-level programming language for smart contracts on Bitcoin Cash. It offers a strong abstraction layer over Bitcoin Cash' native virtual machine, Bitcoin Script. Its syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum. For a detailed comparison of them, refer to the blog post [*Smart Contracts on Ethereum, Bitcoin and Bitcoin Cash*](https://kalis.me/smart-contracts-eth-btc-bch/).
 
-See the [GitHub repository](https://github.com/Bitcoin-com/cashscript) and the [CashScript website](https://cashscript.org) for full documentation and usage examples.
+See the [GitHub repository](https://github.com/CashScript/cashscript) and the [CashScript website](https://cashscript.org) for full documentation and usage examples.
 
 ## The CashScript Language
 CashScript is a high-level language that allows you to write Bitcoin Cash smart contracts in a straightforward and familiar way. Its syntax is inspired by Ethereum's Solidity language, but its functionality is different since the underlying systems have very different fundamentals. See the [language documentation](https://cashscript.org/docs/language/) for a full reference of the language.
diff --git a/packages/cashscript/README.md b/packages/cashscript/README.md
index 7226c6fa..ba38a3a6 100644
--- a/packages/cashscript/README.md
+++ b/packages/cashscript/README.md
@@ -8,7 +8,7 @@
 
 CashScript is a high-level programming language for smart contracts on Bitcoin Cash. It offers a strong abstraction layer over Bitcoin Cash' native virtual machine, Bitcoin Script. Its syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum. For a detailed comparison of them, refer to the blog post [*Smart Contracts on Ethereum, Bitcoin and Bitcoin Cash*](https://kalis.me/smart-contracts-eth-btc-bch/).
 
-See the [GitHub repository](https://github.com/Bitcoin-com/cashscript) and the [CashScript website](https://cashscript.org) for full documentation and usage examples.
+See the [GitHub repository](https://github.com/CashScript/cashscript) and the [CashScript website](https://cashscript.org) for full documentation and usage examples.
 
 ## The CashScript Language
 CashScript is a high-level language that allows you to write Bitcoin Cash smart contracts in a straightforward and familiar way. Its syntax is inspired by Ethereum's Solidity language, but its functionality is different since the underlying systems have very different fundamentals. See the [language documentation](https://cashscript.org/docs/language/) for a full reference of the language.
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 02ab6c70..d51116f4 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -62,7 +62,7 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 ```
 
 :::tip
-There are some other examples available on the [Examples page](/docs/language/examples), that can be used to take inspiration from. Further examples of the JavaScript integration can be found on [GitHub](https://github.com/Bitcoin-com/cashscript/tree/master/examples).
+There are some other examples available on the [Examples page](/docs/language/examples), that can be used to take inspiration from. Further examples of the JavaScript integration can be found on [GitHub](https://github.com/CashScript/cashscript/tree/master/examples).
 :::
 
 ### Compiling your smart contract
diff --git a/website/docs/language/examples.md b/website/docs/language/examples.md
index 32821f39..5e4f51c7 100644
--- a/website/docs/language/examples.md
+++ b/website/docs/language/examples.md
@@ -2,7 +2,7 @@
 title: Examples
 ---
 
-An extensive collection of examples is available in the [GitHub repository](https://github.com/Bitcoin-com/cashscript/tree/master/examples). Below we discuss a few of these examples in more details and go through the functionality.
+An extensive collection of examples is available in the [GitHub repository](https://github.com/CashScript/cashscript/tree/master/examples). Below we discuss a few of these examples in more details and go through the functionality.
 
 ## Transfer With Timeout
 One interesting use case of Bitcoin Cash is using it for *paper tips*. With paper tips, you send a small amount of money to an address, and print the corresponding private key on a piece of paper. Then you can hand out these pieces of paper as a tip or gift to people in person. In practice, however, people might not know what to do with these gifts or they might lose or forget about it.
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 8a7960aa..d7d59175 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -167,7 +167,7 @@ https://twitter.com/RoscoKalis/status/1529072055756414976
 * :bug: The final statement in a contract now MUST be a require statement (in all branches)
 * :bug: Empty contracts and functions are now considered invalid
 * :bug: Fix bug where certain covenants could become unspendable due to incorrect bytesize calculation
-  * :boom: **BREAKING**: Covenants using `tx.bytecode` now include a placeholder `OP_NOP` that gets replaced when constructor arguments are provided in the CashScript SDK. If you're not using the CashScript SDK, refer to the [`replaceBytecodeNop()` function](https://github.com/Bitcoin-com/cashscript/blob/master/packages/utils/src/script.ts#L130) to see the steps required to do so manually.
+  * :boom: **BREAKING**: Covenants using `tx.bytecode` now include a placeholder `OP_NOP` that gets replaced when constructor arguments are provided in the CashScript SDK. If you're not using the CashScript SDK, refer to the [`replaceBytecodeNop()` function](https://github.com/CashScript/cashscript/blob/master/packages/utils/src/script.ts#L130) to see the steps required to do so manually.
 * :boom: **BREAKING**: Remove `--args` parameter from the CLI, since this is too error prone with the recent changes in mind
 * :boom: **BREAKING**: Restructure exports
 
diff --git a/website/docs/sdk/examples.md b/website/docs/sdk/examples.md
index e856c200..a9534d72 100644
--- a/website/docs/sdk/examples.md
+++ b/website/docs/sdk/examples.md
@@ -131,4 +131,4 @@ console.log(txDetails);
 [bchjs]: https://bchjs.fullstack.cash/
 [bitcore]: https://github.com/bitpay/bitcore/tree/master/packages/bitcore-lib-cash
 [libauth]: https://libauth.org/
-[github-examples]: https://github.com/Bitcoin-com/cashscript/tree/master/examples
+[github-examples]: https://github.com/CashScript/cashscript/tree/master/examples
diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
index 008386f3..ffe5c2f8 100755
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@@ -26,7 +26,7 @@ module.exports = {
           position: 'right',
         },
         {
-          href: 'https://github.com/Bitcoin-com/cashscript',
+          href: 'https://github.com/CashScript/cashscript',
           label: 'GitHub',
           position: 'right',
         },

From bd0f8a2be71519be6efba4559e8dc3a66181be7a Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 11 Jun 2024 11:09:59 +0200
Subject: [PATCH 070/267] Fix require message handling edge case bug

- Add +1/-1 in several places to fix off-by-one errors
- Document / comment all said +1/-1s so it's clear WHY we have them
- Extract getFinalExecutedVerifyIp in separate function
- Add 2 additional test cases
---
 .../src/generation/GenerateTargetTraversal.ts | 22 +++++---
 packages/cashscript/src/debugging.ts          | 56 +++++++++++++++----
 packages/cashscript/test/debugging.test.ts    | 55 ++++++++++++++++--
 3 files changed, 110 insertions(+), 23 deletions(-)

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 7513b291..94d33078 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -108,9 +108,9 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     return index;
   }
 
-  private getCurrentInstructionPointer(): number {
-    // instruction pointer is the count of emitted opcodes + number of constructor data pushes
-    return this.output.length + this.constructorParameterCount;
+  private getMostRecentInstructionPointer(): number {
+    // instruction pointer is the count of emitted opcodes + number of constructor data pushes (minus 1 for 0-indexing)
+    return this.output.length + this.constructorParameterCount - 1;
   }
 
   visitSourceFile(node: SourceFileNode): Node {
@@ -126,7 +126,10 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
   visitContract(node: ContractNode): Node {
     node.parameters = this.visitList(node.parameters) as ParameterNode[];
+
+    // Keep track of constructor parameter count for instructor pointer calculation
     this.constructorParameterCount = node.parameters.length;
+
     if (node.functions.length === 1) {
       node.functions = this.visitList(node.functions) as FunctionDefinitionNode[];
     } else {
@@ -178,13 +181,13 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     node.parameters = this.visitList(node.parameters) as ParameterNode[];
     node.body = this.visit(node.body) as BlockNode;
 
-    this.removeFinalVerify(node.body);
+    this.removeFinalVerifyFromFunction(node.body);
     this.cleanStack(node.body);
 
     return node;
   }
 
-  removeFinalVerify(functionBodyNode: Node): void {
+  removeFinalVerifyFromFunction(functionBodyNode: Node): void {
     // After EnsureFinalRequireTraversal, we know that the final opcodes are either
     // "OP_VERIFY", "OP_CHECK{LOCKTIME|SEQUENCE}VERIFY OP_DROP" or "OP_ENDIF"
 
@@ -204,6 +207,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
       // At this point there is no verification value left on the stack:
       //  - scoped stack is cleared inside branch ended by OP_ENDIF
       //  - OP_CHECK{LOCKTIME|SEQUENCE}VERIFY OP_DROP does not leave a verification value
+      //  - OP_VERIFY does not leave a verification value
       // so we add OP_1 to the script (indicating success)
       this.emit(Op.OP_1, { location: functionBodyNode.location, positionHint: PositionHint.END });
       this.pushToStack('(value)');
@@ -280,7 +284,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
       this.requireMessages.push({
         // We're removing 1 from the IP because the error message needs to match the OP_XXX_VERIFY, not the OP_DROP that
         // is emitted directly after
-        ip: this.getCurrentInstructionPointer() - 1,
+        ip: this.getMostRecentInstructionPointer() - 1,
         line: node.location.start.line,
         message: node.message,
       });
@@ -300,7 +304,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // TODO: We don't even have to display the Libauth message if we just say "this and this require failed"
     if (node.message) {
       this.requireMessages.push({
-        ip: this.getCurrentInstructionPointer(),
+        ip: this.getMostRecentInstructionPointer(),
         line: node.location.start.line,
         message: node.message,
       });
@@ -311,7 +315,9 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   }
 
   visitConsoleStatement(node: ConsoleStatementNode): Node {
-    const ip = this.getCurrentInstructionPointer();
+    // We add a plus 1 to the most recent instruction pointer, because we want to log the state
+    // of the stack *after* the most recent instruction has been executed
+    const ip = this.getMostRecentInstructionPointer() + 1;
     const { line } = node.location.start;
 
     const data = node.parameters.map((parameter: ConsoleParameterNode) => {
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 62ce9c86..b900afd7 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -1,5 +1,5 @@
-import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateBCH, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBCH2023, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
-import { Artifact, LogData, LogEntry, Op, PrimitiveType, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
+import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateBCH, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBCH2023, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
+import { Artifact, LogData, LogEntry, Op, PrimitiveType, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
 import { findLastIndex, toRegExp } from './utils.js';
 
 // evaluates the fully defined template, throws upon error
@@ -43,8 +43,16 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
 
   // If an error is present in the last step, that means a require statement in the middle of the function failed
   if (lastExecutedDebugStep.error) {
+    // In Libauth any thrown error gets registered in the instruction that happens right *after* the instruction that
+    // caused the error (in other words the OP_VERIFY). We need to decrement the instruction pointer to get the correct
+    // failing instruction.
+    const failingIp = lastExecutedDebugStep.ip - 1;
+
+    // Generally speaking, an error is thrown by the OP_VERIFY opcode, but for NULLFAIL, the error is thrown in the
+    // preceding OP_CHECKSIG opcode. The error message is registered in the next instruction, so we need to increment
+    // the instruction pointer to get the correct error message.
     const isNullFail = lastExecutedDebugStep.error === AuthenticationErrorCommon.nonNullSignatureFailure;
-    const messageIp = lastExecutedDebugStep.ip + (isNullFail ? 1 : 0);
+    const messageIp = failingIp + (isNullFail ? 1 : 0);
 
     const requireStatement = (artifact.debug?.requireMessages ?? [])
       .find((message) => message.ip === messageIp);
@@ -62,13 +70,13 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
     const stackContents = lastExecutedDebugStep.stack.map(item => `0x${binToHex(item)}`).join(', ');
     const stackContentsMessage = `\nStack contents after evaluation: ${lastExecutedDebugStep.stack.length ? stackContents : 'empty'}`;
 
-    const executedInstructions = lastExecutedDebugStep.instructions
-      .filter((_, i) => executedDebugSteps.map((step) => step.ip).includes(i));
+    const finalExecutedVerifyIp = getFinalExecutedVerifyIp(executedDebugSteps);
 
-    const cleanupSize = calculateCleanupSize(executedInstructions);
-    const finalExecutedVerify = executedDebugSteps[executedDebugSteps.length - cleanupSize - 1];
+    // logDebugSteps(executedDebugSteps, lastExecutedDebugStep.instructions);
+    // console.warn('message', finalExecutedVerifyIp);
+    // console.warn(artifact.debug?.requireMessages);
 
-    const finalVerifyMessage = artifact.debug?.requireMessages.find((message) => message.ip === finalExecutedVerify.ip);
+    const finalVerifyMessage = artifact.debug?.requireMessages.find((message) => message.ip === finalExecutedVerifyIp);
 
     if (finalVerifyMessage) {
       throw new Error(`${artifact.contractName}.cash:${finalVerifyMessage.line} Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex} with the following message: ${finalVerifyMessage.message}.\n${evaluationResult.replace(/Error in evaluating input index \d: /, '')}` + stackContentsMessage);
@@ -152,14 +160,16 @@ const failedFinalVerify = (evaluationResult: string | true): evaluationResult is
   ]).test(evaluationResult);
 };
 
-const calculateCleanupSize = (instructions: AuthenticationInstruction[]): number => {
+const calculateCleanupSize = (instructions: Array<AuthenticationInstruction | undefined>): number => {
   // OP_NIP is used for cleanup at the end of a function, OP_ENDIF and OP_ELSE are the end of branches
   // We need to remove all of these to get to the actual last executed instruction of a function
   const cleanupOpcodes = [Op.OP_ENDIF, Op.OP_NIP, Op.OP_ELSE];
 
   let cleanupSize = 0;
   for (const instruction of [...instructions].reverse()) {
-    if (cleanupOpcodes.includes(instruction.opcode)) {
+    // The instructions array may contain undefined elements for the final executed debug steps that are not
+    // technically instructions (e.g. the final *implicit* verify). We still want to get rid of these in the cleanup
+    if (!instruction || cleanupOpcodes.includes(instruction.opcode)) {
       cleanupSize++;
     } else {
       break;
@@ -168,3 +178,29 @@ const calculateCleanupSize = (instructions: AuthenticationInstruction[]): number
 
   return cleanupSize;
 };
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const logDebugSteps = (
+  debugSteps: AuthenticationProgramStateCommon[],
+  instructions: AuthenticationInstruction[],
+): void => {
+  debugSteps.map((step) => {
+    const opcode = instructions[step.ip] ? bytecodeToAsm(encodeAuthenticationInstruction(instructions[step.ip])) : 'null';
+    console.warn(step.ip, opcode, step.stack, step.error);
+  });
+};
+
+const getFinalExecutedVerifyIp = (executedDebugSteps: AuthenticationProgramStateCommon[]): number => {
+  // Map every executed debug step to its corresponding instruction
+  // (note that the last executed step(s) may not have a corresponding instruction and will be `undefined`)
+  const executedInstructions = executedDebugSteps.map((step) => step.instructions[step.ip]);
+
+  const finalExecutedDebugStepIndex = executedDebugSteps.length - 1;
+  const cleanupSize = calculateCleanupSize(executedInstructions);
+  const finalExecutedNonCleanupStep = executedDebugSteps[finalExecutedDebugStepIndex - cleanupSize];
+
+  // The final verify in a function is dropped, so after cleanup, we get the final OP that was executed *before* the
+  // final verify, so we need to add one to get the actual final verify instruction
+  const finalExecutedVerifyIp = finalExecutedNonCleanupStep.ip + 1;
+  return finalExecutedVerifyIp;
+};
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 2c7a3e0e..180a3b7b 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -27,19 +27,16 @@ contract Test() {
     require(1 == 1, "1 should equal 1");
   }
 
-  // TODO: Add test for this
   function test_multiple_require_statements() {
     require(1 == 2, "1 should equal 2");
     require(1 == 1, "1 should equal 1");
   }
 
-  // TODO: Add test for this
   function test_multiple_require_statements_final_fails() {
     require(1 == 1, "1 should equal 1");
     require(1 == 2, "1 should equal 2");
   }
 
-  // TODO: Add test for this
   function test_multiple_require_statements_no_message_final() {
     require(1 == 1, "1 should equal 1");
     require(1 == 2);
@@ -78,6 +75,11 @@ contract Test() {
 
   function test_fail_checksig(sig s, pubkey pk) {
     require(checkSig(s, pk), "Signatures do not match");
+    require(1 == 2, "1 should equal 2");
+  }
+
+  function test_fail_checksig_final_verify(sig s, pubkey pk) {
+    require(checkSig(s, pk), "Signatures do not match");
   }
 
   function test_fail_checkdatasig(datasig s, bytes message, pubkey pk) {
@@ -97,6 +99,29 @@ contract Test() {
   }
 }`;
 
+const CONTRACT_CODE3 = `
+contract Test() {
+  // We test this because the cleanup looks different and the final OP_VERIFY isn't removed for these kinds of functions
+  function test_fail_large_cleanup() {
+    int a = 1;
+    int b = 2;
+    int c = 3;
+    int d = 4;
+    int e = 5;
+    int f = 6;
+    int g = 7;
+    int h = 8;
+
+    // Use all variables inside this if-statement so they do not get OP_ROLL'ed
+    if (1 == 2) {
+      require(a + b + c + d + e + f + g + h == 1, "sum should equal 36");
+    }
+
+    require(1 == 2, "1 should equal 2");
+  }
+}
+`;
+
 describe('Debugging tests', () => {
   describe('console.log statements', () => {
     const BASE_CONTRACT_CODE = `
@@ -281,6 +306,7 @@ describe('Debugging tests', () => {
   describe('require statements', () => {
     const artifact = compileString(CONTRACT_CODE);
     const artifact2 = compileString(CONTRACT_CODE2);
+    const artifact3 = compileString(CONTRACT_CODE3);
     const provider = new MockNetworkProvider();
 
     // test_require
@@ -303,7 +329,7 @@ describe('Debugging tests', () => {
       await expect(transaction).toFailRequireWith(/should have 1 output/);
     });
 
-    // // test_multiple_require_statements
+    // test_multiple_require_statements
     it('it should only fail with correct error message when there are multiple require statements', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
@@ -313,7 +339,7 @@ describe('Debugging tests', () => {
       await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
-    // // test_multiple_require_statements_final_fails
+    // test_multiple_require_statements_final_fails
     it('it should only fail with correct error message when there are multiple require statements where the final statement fails', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
@@ -398,6 +424,16 @@ describe('Debugging tests', () => {
       // await expect(checkSigTransactionNullSignature).toFailRequireWith(/Signatures do not match/);
     });
 
+    // test_fail_checksig_final_verify
+    it('should fail with correct error message when checkSig fails as the final verify', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const checkSigTransaction = contract.functions
+        .test_fail_checksig_final_verify(new SignatureTemplate(alicePriv), bobPub).to(contract.address, 1000n);
+      await expect(checkSigTransaction).toFailRequireWith(/Signatures do not match/);
+    });
+
     // test_fail_checkdatasig
     it('should fail with correct error message when checkDataSig fails', async () => {
       const contract = new Contract(artifact, [], { provider });
@@ -430,6 +466,15 @@ describe('Debugging tests', () => {
         .to(contract.address, 1000n);
       await expect(checkmultiSigTransaction).toFailRequireWith(/Multi Signatures do not match/);
     });
+
+    // test_fail_large_cleanup
+    it('should fail with correct error message when a require statement fails in a function with a large cleanup', async () => {
+      const contract = new Contract(artifact3, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_fail_large_cleanup().to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith(/1 should equal 2/);
+    });
   });
 
   describe('JestExtensions', () => {

From 619eaf847843c7c9526155d5d4b875366a1db184 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 11 Jun 2024 11:12:56 +0200
Subject: [PATCH 071/267] Document 'quick rebuild' command

---
 DEVELOPMENT.md | 6 +++++-
 package.json   | 4 ++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index cb7aed62..cf94c0aa 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -1,6 +1,10 @@
 We use yarn workspaces + lerna for monorepo management. So to get started, clone this repository and run `yarn` in the root directory to install all dependencies for all packages.
 
-When updating code in one package, you can run `yarn build` in the root directory to build all packages so the changes get propagated to the other packages as well.
+When updating code in one package, you can run `yarn build` in the root directory to build all packages so the changes get propagated to the other packages as well. If you're already in a package directory, you can run the following command to do so:
+
+```bash
+pushd ../.. && yarn build && popd
+```
 
 ### Publishing a release
 
diff --git a/package.json b/package.json
index d142a139..21549009 100644
--- a/package.json
+++ b/package.json
@@ -35,10 +35,10 @@
     "cashproof": "python3 node_modules/cashproof/run.py",
     "examples": "tsx examples/p2pkh.ts && tsx examples/transfer_with_timeout.ts && tsx examples/hodl_vault.ts",
     "coverage": "codecov",
-    "postinstall": "lerna bootstrap && lerna run build --ignore cashscript-examples --ignore testing-suite",
+    "postinstall": "lerna bootstrap && yarn build",
     "spellcheck": "cspell lint '**' --no-progress --must-find-files",
     "update-version": "tsx update-version.ts",
     "publish-all": "lerna publish from-package",
-    "build": "lerna run build"
+    "build": "lerna run build --ignore cashscript-examples --ignore testing-suite"
   }
 }

From a5edbf7a0bf5c5e59d8de248b597c4b51286a54e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 11 Jun 2024 11:55:51 +0200
Subject: [PATCH 072/267] Add failing test for console.log bytecode
 preservation

---
 .../cashc/test/debugging/debugging.test.ts     | 18 ++++++++++++++++++
 packages/cashc/test/debugging/fixtures.ts      | 11 +++++++++++
 .../test/valid-contract-files/p2pkh-logs.cash  |  7 +++++++
 3 files changed, 36 insertions(+)
 create mode 100644 packages/cashc/test/debugging/debugging.test.ts
 create mode 100644 packages/cashc/test/debugging/fixtures.ts
 create mode 100644 packages/cashc/test/valid-contract-files/p2pkh-logs.cash

diff --git a/packages/cashc/test/debugging/debugging.test.ts b/packages/cashc/test/debugging/debugging.test.ts
new file mode 100644
index 00000000..dc392022
--- /dev/null
+++ b/packages/cashc/test/debugging/debugging.test.ts
@@ -0,0 +1,18 @@
+/*   debugging.test.ts
+ *
+ * - This file is used to test the debugging functionality (console.log and require messages)
+ */
+
+import { URL } from 'url';
+import { compileFile } from '../../src/index.js';
+import { fixtures } from './fixtures.js';
+
+describe('Debugging', () => {
+  fixtures.forEach((fixture) => {
+    it(`should compile ${fixture.fn} to the same bytecode as ${fixture.fnWithLogs}`, () => {
+      const artifact = compileFile(new URL(`../valid-contract-files/${fixture.fn}`, import.meta.url));
+      const artifactWithLogs = compileFile(new URL(`../valid-contract-files/${fixture.fnWithLogs}`, import.meta.url));
+      expect(artifactWithLogs.bytecode).toEqual(artifact.bytecode);
+    });
+  });
+});
diff --git a/packages/cashc/test/debugging/fixtures.ts b/packages/cashc/test/debugging/fixtures.ts
new file mode 100644
index 00000000..e2f371fe
--- /dev/null
+++ b/packages/cashc/test/debugging/fixtures.ts
@@ -0,0 +1,11 @@
+interface Fixture {
+  fn: string,
+  fnWithLogs: string,
+}
+
+export const fixtures: Fixture[] = [
+  {
+    fn: 'p2pkh.cash',
+    fnWithLogs: 'p2pkh-logs.cash',
+  },
+];
diff --git a/packages/cashc/test/valid-contract-files/p2pkh-logs.cash b/packages/cashc/test/valid-contract-files/p2pkh-logs.cash
new file mode 100644
index 00000000..fa6f2765
--- /dev/null
+++ b/packages/cashc/test/valid-contract-files/p2pkh-logs.cash
@@ -0,0 +1,7 @@
+contract P2PKH(bytes20 pkh) {
+    function spend(pubkey pk, sig s) {
+        require(hash160(pk) == pkh);
+        console.log(pk, pkh, s);
+        require(checkSig(s, pk));
+    }
+}

From aa4012f93aac831c84dbe1088e754a92d0600485 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 13 Jun 2024 21:00:29 +0200
Subject: [PATCH 073/267] add error message incorrect number function arguments
 to createUnlocker, improve same error message in createFunction and error
 message number constructor args

---
 packages/cashscript/src/Contract.ts | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/packages/cashscript/src/Contract.ts b/packages/cashscript/src/Contract.ts
index 1efefc13..c6123abc 100644
--- a/packages/cashscript/src/Contract.ts
+++ b/packages/cashscript/src/Contract.ts
@@ -53,7 +53,7 @@ export class Contract {
     }
 
     if (artifact.constructorInputs.length !== constructorArgs.length) {
-      throw new Error(`Incorrect number of arguments passed to ${artifact.contractName} constructor`);
+      throw new Error(`Incorrect number of arguments passed to ${artifact.contractName} constructor. Expected ${artifact.constructorInputs.length} arguments (${artifact.constructorInputs.map(input => input.type)}) but got ${constructorArgs.length}`);
     }
 
     // Encode arguments (this also performs type checking)
@@ -105,7 +105,7 @@ export class Contract {
   private createFunction(abiFunction: AbiFunction, selector?: number): ContractFunction {
     return (...args: Argument[]) => {
       if (abiFunction.inputs.length !== args.length) {
-        throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}`);
+        throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}. Expected ${abiFunction.inputs.length} arguments (${abiFunction.inputs.map(input => input.type)}) but got ${args.length}`);
       }
 
       // Encode passed args (this also performs type checking)
@@ -125,6 +125,10 @@ export class Contract {
 
   private createUnlocker(abiFunction: AbiFunction, selector?: number): ContractUnlocker {
     return (...args: Argument[]) => {
+      if (abiFunction.inputs.length !== args.length) {
+        throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}. Expected ${abiFunction.inputs.length} arguments (${abiFunction.inputs.map(input => input.type)}) but got ${args.length}`);
+      }
+
       const bytecode = scriptToBytecode(this.redeemScript);
 
       const encodedArgs = args

From a510aafe699afe01e7483bcd953b46e969df411d Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 18 Jun 2024 11:23:01 +0200
Subject: [PATCH 074/267] Fix console.log bugs

- console.log statements no longer count as statements for "final
  verify" check
- console.log statements no longer change the production bytecode
- add additional fixtures and update tests for these two changes
---
 .../src/generation/GenerateTargetTraversal.ts | 31 ++++++++++++++---
 .../semantic/EnsureFinalRequireTraversal.ts   |  4 ++-
 .../src/semantic/SymbolTableTraversal.ts      | 18 ++++++++--
 packages/cashc/test/debugging/fixtures.ts     |  8 +++++
 packages/cashc/test/generation/fixtures.ts    |  6 ++--
 .../deeply_nested-logs.cash                   | 33 +++++++++++++++++++
 .../if_statement_number_units-logs.cash       | 13 ++++++++
 packages/cashscript/src/debugging.ts          | 20 ++++++-----
 packages/cashscript/test/debugging.test.ts    | 15 +++++++--
 packages/utils/src/artifact.ts                |  1 +
 10 files changed, 128 insertions(+), 21 deletions(-)
 create mode 100644 packages/cashc/test/valid-contract-files/deeply_nested-logs.cash
 create mode 100644 packages/cashc/test/valid-contract-files/if_statement_number_units-logs.cash

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 94d33078..b6566a4d 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -16,6 +16,7 @@ import {
   RequireMessage,
   PositionHint,
   SingleLocationData,
+  StackItem,
 } from '@cashscript/utils';
 import {
   ContractNode,
@@ -65,6 +66,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   stack: string[] = [];
   consoleLogs: LogEntry[] = [];
   requireMessages: RequireMessage[] = [];
+  finalStackUsage: Record<string, StackItem> = {};
 
   private scopeDepth = 0;
   private currentFunction: FunctionDefinitionNode;
@@ -102,9 +104,13 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     this.stack.splice(1, 1);
   }
 
-  private getStackIndex(value: string): number {
+  private getStackIndex(value: string, canBeUndefined?: boolean): number {
     const index = this.stack.indexOf(value);
-    if (index === -1) throw new Error(); // Should not happen
+
+    if (index === -1 && !canBeUndefined) {
+      throw new Error(`Expected variable '${value}' does not exist on the stack`);
+    }
+
     return index;
   }
 
@@ -323,9 +329,19 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     const data = node.parameters.map((parameter: ConsoleParameterNode) => {
       if (parameter instanceof IdentifierNode) {
         const symbol = parameter.definition!;
-        const stackIndex = this.getStackIndex(parameter.name);
+        const stackIndex = this.getStackIndex(parameter.name, true);
+
+        // If the variable is not on the stack, then we add the final stack usage to the console log
+        if (stackIndex === -1) {
+          if (!this.finalStackUsage[parameter.name]) {
+            throw new Error(`Expected variable '${parameter.name}' does not exist on the stack or in final stack usage`);
+          }
+          return this.finalStackUsage[parameter.name];
+        }
+
+        // If the variable is on the stack, we add the stack index and type to the console log
         const type = typeof symbol.type === 'string' ? symbol.type : symbol.toString();
-        return { stackIndex, type };
+        return { stackIndex, type, ip };
       }
 
       return parameter.toString();
@@ -559,6 +575,13 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // If the final use is inside an if-statement, we still OP_PICK it
     // We do this so that there's no difference in stack depths between execution paths
     if (this.isOpRoll(node)) {
+      const symbol = node.definition!;
+      this.finalStackUsage[node.name] = {
+        type:  typeof symbol.type === 'string' ? symbol.type : symbol.toString(),
+        stackIndex,
+        ip: this.getMostRecentInstructionPointer(),
+      };
+
       this.emit(Op.OP_ROLL, { location: node.location });
       this.removeFromStack(stackIndex);
     } else {
diff --git a/packages/cashc/src/semantic/EnsureFinalRequireTraversal.ts b/packages/cashc/src/semantic/EnsureFinalRequireTraversal.ts
index b484d795..52f29685 100644
--- a/packages/cashc/src/semantic/EnsureFinalRequireTraversal.ts
+++ b/packages/cashc/src/semantic/EnsureFinalRequireTraversal.ts
@@ -6,6 +6,7 @@ import {
   StatementNode,
   TimeOpNode,
   BranchNode,
+  ConsoleStatementNode,
 } from '../ast/AST.js';
 import AstTraversal from '../ast/AstTraversal.js';
 import { EmptyContractError, EmptyFunctionError, FinalRequireStatementError } from '../Errors.js';
@@ -37,7 +38,8 @@ export default class EnsureFinalRequireTraversal extends AstTraversal {
 }
 
 function ensureFinalStatementIsRequire(statements: StatementNode[] = []): void {
-  const finalStatement = statements[statements.length - 1];
+  const statementsWithoutLogs = statements.filter((statement) => !(statement instanceof ConsoleStatementNode));
+  const finalStatement = statementsWithoutLogs[statements.length - 1];
 
   if (!finalStatement) return;
 
diff --git a/packages/cashc/src/semantic/SymbolTableTraversal.ts b/packages/cashc/src/semantic/SymbolTableTraversal.ts
index 3e7f2e92..0fd0601e 100644
--- a/packages/cashc/src/semantic/SymbolTableTraversal.ts
+++ b/packages/cashc/src/semantic/SymbolTableTraversal.ts
@@ -12,6 +12,8 @@ import {
   InstantiationNode,
   AssignNode,
   TupleAssignmentNode,
+  ConsoleStatementNode,
+  ConsoleParameterNode,
 } from '../ast/AST.js';
 import AstTraversal from '../ast/AstTraversal.js';
 import { SymbolTable, Symbol, SymbolType } from '../ast/SymbolTable.js';
@@ -29,6 +31,7 @@ export default class SymbolTableTraversal extends AstTraversal {
   private functionNames: Map<string, boolean> = new Map<string, boolean>();
   private currentFunction: FunctionDefinitionNode;
   private expectedSymbolType: SymbolType = SymbolType.VARIABLE;
+  private insideConsoleStatement: boolean = false;
 
   visitContract(node: ContractNode): Node {
     node.symbolTable = new SymbolTable(this.symbolTables[0]);
@@ -150,6 +153,15 @@ export default class SymbolTableTraversal extends AstTraversal {
     return node;
   }
 
+  // When we enter a console statement,
+  visitConsoleStatement(node: ConsoleStatementNode): Node {
+    this.insideConsoleStatement = true;
+    node.parameters = this.visitList(node.parameters) as ConsoleParameterNode[];
+    this.insideConsoleStatement = false;
+
+    return node;
+  }
+
   visitIdentifier(node: IdentifierNode): Node {
     const definition = this.symbolTables[0].get(node.name);
     if (!definition) {
@@ -163,8 +175,10 @@ export default class SymbolTableTraversal extends AstTraversal {
     node.definition = definition;
     node.definition.references.push(node);
 
-    // Keep track of final use of variables for code generation
-    this.currentFunction.opRolls.set(node.name, node);
+    // Keep track of final use of variables for code generation (excluding console statements)
+    if (!this.insideConsoleStatement) {
+      this.currentFunction.opRolls.set(node.name, node);
+    }
 
     return node;
   }
diff --git a/packages/cashc/test/debugging/fixtures.ts b/packages/cashc/test/debugging/fixtures.ts
index e2f371fe..cfff07f5 100644
--- a/packages/cashc/test/debugging/fixtures.ts
+++ b/packages/cashc/test/debugging/fixtures.ts
@@ -8,4 +8,12 @@ export const fixtures: Fixture[] = [
     fn: 'p2pkh.cash',
     fnWithLogs: 'p2pkh-logs.cash',
   },
+  {
+    fn: 'if_statement_number_units.cash',
+    fnWithLogs: 'if_statement_number_units-logs.cash',
+  },
+  {
+    fn: 'deeply_nested.cash',
+    fnWithLogs: 'deeply_nested-logs.cash',
+  },
 ];
diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index 438b341c..3e6a1788 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -653,10 +653,10 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '0079519c69007a5193529c',
         logs: [
-          { data: [{ stackIndex: 0, type: 'int' }, 'test'], ip: 5, line: 4 },
-          { data: [{ stackIndex: 0, type: 'int' }, 'test2'], ip: 5, line: 5 },
+          { data: [{ stackIndex: 0, type: 'int', ip: 5 }, 'test'], ip: 5, line: 4 },
+          { data: [{ stackIndex: 0, type: 'int', ip: 5 }, 'test2'], ip: 5, line: 5 },
         ],
-        requireMessages: [{ ip: 5, line: 3, message: 'Wrong value passed' }, { ip: 12, line: 6, message: 'Sum doesn\'t work' }],
+        requireMessages: [{ ip: 4, line: 3, message: 'Wrong value passed' }, { ip: 11, line: 6, message: 'Sum doesn\'t work' }],
         sourceMap: '3:12:3:17;;:21::22;:12:::1;:4::46;6:12:6:17:0;;:20::21;:12:::1;:25::26:0;:12:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/debug_messages.cash', import.meta.url), { encoding: 'utf-8' }),
diff --git a/packages/cashc/test/valid-contract-files/deeply_nested-logs.cash b/packages/cashc/test/valid-contract-files/deeply_nested-logs.cash
new file mode 100644
index 00000000..d6664825
--- /dev/null
+++ b/packages/cashc/test/valid-contract-files/deeply_nested-logs.cash
@@ -0,0 +1,33 @@
+pragma cashscript >=0.8.0;
+
+contract TransferWithTimeout(
+    pubkey sender,
+    pubkey recipient,
+    int timeout
+) {
+    // Require recipient's signature to match
+    function transfer(sig recipientSig) {
+        require(checkSig(recipientSig, recipient));
+        console.log('recipientSig is', recipientSig);
+    }
+
+    // Require timeout time to be reached and sender's signature to match
+    function timeout(sig senderSig) {
+        require(checkSig(senderSig, sender));
+        if (timeout > 0) {
+            if (timeout < 10) {
+                require(timeout == 5);
+                console.log('timeout is', timeout);
+                console.log('senderSig is', senderSig);
+            } else {
+                console.log('timeout is', timeout);
+                require(timeout == 15);
+            }
+        } else {
+            require(timeout == 0);
+            console.log('timeout is', timeout);
+        }
+
+        console.log('timeout is', timeout, 'and senderSig is', senderSig);
+    }
+}
diff --git a/packages/cashc/test/valid-contract-files/if_statement_number_units-logs.cash b/packages/cashc/test/valid-contract-files/if_statement_number_units-logs.cash
new file mode 100644
index 00000000..e3994579
--- /dev/null
+++ b/packages/cashc/test/valid-contract-files/if_statement_number_units-logs.cash
@@ -0,0 +1,13 @@
+contract Test() {
+    function hello(int a, int b) {
+        if (a == b - 2 minutes) {
+            require(false);
+        } else if (b == 2 weeks)
+            require(a == 20 seconds);
+        else {
+            require(true == !!!false);
+        }
+
+        console.log(a, b);
+    }
+}
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index b900afd7..1bc2a9fc 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -1,5 +1,5 @@
 import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateBCH, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBCH2023, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
-import { Artifact, LogData, LogEntry, Op, PrimitiveType, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
+import { Artifact, LogEntry, Op, PrimitiveType, StackItem, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
 import { findLastIndex, toRegExp } from './utils.js';
 
 // evaluates the fully defined template, throws upon error
@@ -35,8 +35,7 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
     .filter((debugStep) => executedDebugSteps.some((log) => log.ip === debugStep.ip));
 
   for (const log of executedLogs) {
-    const correspondingDebugStep = executedDebugSteps.find((debugStep) => debugStep.ip === log.ip)!;
-    logConsoleLogStatement(log, correspondingDebugStep, artifact);
+    logConsoleLogStatement(log, executedDebugSteps, artifact);
   }
 
   const lastExecutedDebugStep = executedDebugSteps[executedDebugSteps.length - 1];
@@ -122,22 +121,25 @@ const createProgram = (template: WalletTemplate): CreateProgramResult => {
 
 const logConsoleLogStatement = (
   log: LogEntry,
-  debugStep: AuthenticationProgramStateCommon,
+  debugSteps: AuthenticationProgramStateCommon[],
   artifact: Artifact,
 ): void => {
   let line = `${artifact.contractName}.cash:${log.line}`;
-  const decodedData = log.data.map((element) => decodeLogData(element, debugStep.stack, log.ip));
+  const decodedData = log.data.map((element) => {
+    if (typeof element === 'string') return element;
+
+    const debugStep = debugSteps.find((step) => step.ip === element.ip)!;
+    return decodeStackItem(element, debugStep.stack);
+  });
   console.log(`${line} ${decodedData.join(' ')}`);
 };
 
-const decodeLogData = (element: LogData, stack: Uint8Array[], ip: number): any => {
-  if (typeof element === 'string') return element;
-
+const decodeStackItem = (element: StackItem, stack: Uint8Array[]): any => {
   // Reversed since stack is in reverse order
   const stackItem = [...stack].reverse()[element.stackIndex];
 
   if (!stackItem) {
-    throw Error(`Stack item at index ${element.stackIndex} not found at instruction pointer ${ip}`);
+    throw Error(`Stack item at index ${element.stackIndex} not found at instruction pointer ${element.ip}`);
   }
 
   if (element.type === PrimitiveType.BOOL) return decodeBool(stackItem);
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 180a3b7b..f04d347a 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -144,12 +144,19 @@ describe('Debugging tests', () => {
         }
 
         function functionWithIfStatement(int a) {
+          int b = 0;
+
           if (a == 1) {
             console.log("a is 1");
+            b = a;
           } else {
             console.log("a is not 1");
+            b = 2;
           }
 
+          console.log('a equals', a);
+          console.log('b equals', b);
+
           require(1 == 1);
         }
 
@@ -222,14 +229,18 @@ describe('Debugging tests', () => {
         .functionWithIfStatement(1n)
         .to(contract.address, 10000n);
 
-      await expect(transaction1).toLog(new RegExp('^Test.cash:22 a is 1$'));
+      await expect(transaction1).toLog(new RegExp('^Test.cash:24 a is 1$'));
+      await expect(transaction1).toLog(new RegExp('^Test.cash:31 a equals 1$'));
+      await expect(transaction1).toLog(new RegExp('^Test.cash:32 b equals 1$'));
       await expect(transaction1).not.toLog(/a is not 1/);
 
       const transaction2 = contract.functions
         .functionWithIfStatement(2n)
         .to(contract.address, 10000n);
 
-      await expect(transaction2).toLog(new RegExp('^Test.cash:24 a is not 1$'));
+      await expect(transaction2).toLog(new RegExp('^Test.cash:27 a is not 1$'));
+      await expect(transaction2).toLog(new RegExp('^Test.cash:31 a equals 2$'));
+      await expect(transaction2).toLog(new RegExp('^Test.cash:32 b equals 2$'));
       await expect(transaction2).not.toLog(/a is 1/);
     });
 
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index d3735c46..3279ba69 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -27,6 +27,7 @@ export interface LogEntry {
 export interface StackItem {
   type: string;
   stackIndex: number;
+  ip: number;
 }
 
 export type LogData = StackItem | string;

From 4d8ee07a8572d230327a81fd01ac7c91271b5482 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 18 Jun 2024 11:37:19 +0200
Subject: [PATCH 075/267] Remove cashproof git dependency

---
 DEVELOPMENT.md | 18 ++++++++++++++++++
 package.json   |  7 -------
 2 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index cf94c0aa..e3a966ff 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -38,6 +38,24 @@ When updating the grammar file in `src/grammar/CashScript.g4`, we also need to m
 yarn antlr
 ```
 
+### Running `cashproof`
+
+Most of the bytecode optimisations that the `cashc` compiler uses can be verified for correctness using the [`cashproof` tool](https://github.com/EyeOfPython/cashproof). This tool needs to be installed separately by installing its dependencies using `pip` and cloning its repository from GitHub.
+
+From there, you can run `python <cashproof_path> [filenames]` to verify that the optimisations contained in these files are provably correct.
+
+Example:
+```bash
+python <cashproof_path> packages/cashc/test/cashproof/0.1.2=0.2.0.equiv
+```
+
+Note that if you want to run `cashproof` on the "main" CashScript optimisations file, you need to first extract the optimisations from the `cashc` compiler and save them in a separate file. This can be done using the following commands:
+
+```bash
+cp packages/utils/src/cashproof-optimisations.ts opt.equiv && sed -i '' '/`/d' opt.equiv
+python <cashproof_path> opt.equiv
+```
+
 ## cashscript
 
 ### Running tests
diff --git a/package.json b/package.json
index 21549009..ebe88dd6 100644
--- a/package.json
+++ b/package.json
@@ -13,7 +13,6 @@
     "@types/node": "^14.14.28",
     "@typescript-eslint/eslint-plugin": "^6.12.0",
     "@typescript-eslint/parser": "^6.12.0",
-    "cashproof": "https://github.com/eyeofpython/cashproof",
     "chalk": "^4.1.0",
     "codecov": "^3.8.1",
     "cspell": "^5.2.4",
@@ -27,12 +26,6 @@
   "scripts": {
     "test": "lerna run test --ignore cashscript-examples --ignore testing-suite",
     "lint": "lerna run lint --ignore cashscript-examples --ignore testing-suite",
-    "preproof:opt": "cp packages/utils/src/cashproof-optimisations.ts opt.equiv && sed -i '' '/`/d' opt.equiv",
-    "proof:opt": "yarn cashproof opt.equiv",
-    "postproof:opt": "rm opt.equiv",
-    "proof:0.2.0": "yarn cashproof packages/cashc/test/cashproof/0.1.2=0.2.0.equiv",
-    "proof": "yarn proof:opt && yarn proof:0.2.0",
-    "cashproof": "python3 node_modules/cashproof/run.py",
     "examples": "tsx examples/p2pkh.ts && tsx examples/transfer_with_timeout.ts && tsx examples/hodl_vault.ts",
     "coverage": "codecov",
     "postinstall": "lerna bootstrap && yarn build",

From f91bfa2df42dd70ad9b797b7c7a2d3989b7505f2 Mon Sep 17 00:00:00 2001
From: Frederic Aerts <info@fredericaerts.com>
Date: Tue, 18 Jun 2024 12:10:31 +0200
Subject: [PATCH 076/267] docs: typos and grammar (#194)

---
 website/docs/basics/about.md              |  2 +-
 website/docs/basics/compiler.md           |  2 +-
 website/docs/basics/getting-started.md    | 52 +++++++++++------------
 website/docs/guides/covenants.md          | 30 ++++++-------
 website/docs/guides/debugging.md          | 20 ++++-----
 website/docs/guides/optimization.md       | 29 ++++++-------
 website/docs/language/contracts.md        |  6 +--
 website/docs/language/examples.md         | 12 +++---
 website/docs/language/functions.md        |  2 +-
 website/docs/language/globals.md          |  4 +-
 website/docs/language/types.md            |  8 ++--
 website/docs/sdk/examples.md              | 17 +++++---
 website/docs/sdk/instantiation.md         | 18 ++++----
 website/docs/sdk/network-provider.md      | 10 +++--
 website/docs/sdk/testing-setup.md         |  6 +--
 website/docs/sdk/transactions-advanced.md | 13 ++++--
 website/docs/sdk/transactions.md          | 25 ++++++-----
 website/docs/showcase.md                  |  6 +--
 website/src/pages/index.js                | 10 ++---
 19 files changed, 145 insertions(+), 127 deletions(-)

diff --git a/website/docs/basics/about.md b/website/docs/basics/about.md
index 26247d1c..1f7aadf9 100644
--- a/website/docs/basics/about.md
+++ b/website/docs/basics/about.md
@@ -5,7 +5,7 @@ sidebar_label: About CashScript
 
 CashScript is a high-level programming language for smart contracts on Bitcoin Cash. It offers a strong abstraction layer over Bitcoin Cash' native virtual machine, BCH Script. The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum.
 
-CashScript was created in 2019 and has seen major upgrades over the years, including support for the new script functionality enabled with the different Bitcoin Cash network upgrades, including native introspection and CashTokens. Unrelated to the network upgrades, CashScript has also been upgraded with an advanced transaction builder and integrated debug tooling.
+CashScript was created in 2019 and has seen major upgrades over the years, thereby supporting new script functionalities enabled with the different Bitcoin Cash network upgrades — including native introspection and CashTokens. Unrelated to the network upgrades, CashScript has also been upgraded with an advanced transaction builder and integrated debug tooling.
 
 CashScript aims to make programming Bitcoin Cash accessible to a wide range of developers and enable the next-generation of UTXO smart contract applications.
 
diff --git a/website/docs/basics/compiler.md b/website/docs/basics/compiler.md
index 39085d65..5d6786c0 100644
--- a/website/docs/basics/compiler.md
+++ b/website/docs/basics/compiler.md
@@ -32,7 +32,7 @@ Options:
   -?, --help           Display help
 ```
 
-## Javascript Compilation
+## JavaScript Compilation
 Generally CashScript contracts are compiled to an Artifact JSON file using the CLI compiler. As an alternative to this, CashScript contracts can be compiled from within JavaScript apps using the `cashc` package. This package exports two compilation functions.
 
 ```bash
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index d51116f4..d7f5df8c 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -4,30 +4,30 @@ title: Getting Started
 
 ## Try CashScript Online
 
-To get started with writing CashScript smart contracts quickly, it is recommended to try out the [CashScript Playground](https://playground.cashscript.org/), a web application which lets you easily write and create contracts easily!
+To get started with writing CashScript smart contracts quickly, it is recommended to try out the [CashScript Playground](https://playground.cashscript.org/), a web application which lets you easily write and create contracts!
 
-Here you will learn what CashScript contract looks like through the `TransferWithTimeout` example contract. Then you can compile the contract and provide the contract arguments to create a smart contract address. To actually create the smart contract itself you fund the address so it has a UTXO on the contract address. After setting up the smart contract, you can try spending from the smart contract by invoking a contract funcion!
+Here you will learn what a CashScript contract looks like through the `TransferWithTimeout` example contract. Then you can compile the contract and provide the contract arguments to create a smart contract address. To actually create the smart contract itself, you fund the address so that it has a UTXO on the contract address. After setting up the smart contract, you can try spending from the smart contract by invoking a contract function!
 
 :::tip
-The [CashScript Playground](https://playground.cashscript.org/) is a great way to get started without doing any Javascript coding to setup up wallets, fetch balances and invoke contract functions. This way you can focus on learning one thing at a time!
+The [CashScript Playground](https://playground.cashscript.org/) is a great way to get started without doing any JavaScript coding to set up wallets, fetch balances and invoke contract functions. This way you can focus on learning one thing at a time!
 :::
 
 ## Creating a CashScript Smart Contract
 
-With the CashScript playground there's a nice integrated editor to get started, as well as an integrated compiler to change your CashScript contract into a Contract `Artifact` behind the screens. Now, to get started we will have to get set up with a CashScript editor outside of the Playground and learn how to work with the `cashc` compiler to create CashScript contract artifacts.
+With the CashScript playground there's a nice integrated editor to get started, as well as an integrated compiler to change your CashScript contract into a Contract `Artifact` behind the scenes. Now, to get started we will have to set up a CashScript editor — outside of the Playground — and learn how to work with the `cashc` compiler to create CashScript contract artifacts.
 
 ### Prerequisites
 
-To write CashScript smart contracts contracts locally you use a code-editor. For the best developer experience is recommended to use VS Code with the CashScript extension. This way it will automatically recognize `.cash` files and offer highlighting and auto-completion.
+To write CashScript smart contracts locally you use a code editor. For the best developer experience, we recommend to use VS Code with the CashScript extension. This way it will automatically recognize `.cash` files and offer highlighting and autocompletion.
 
 :::note prerequisties
 - Basic familiarity with the command line
 - Node.js installed
-- A code editor (VS code recommended)
+- A code editor (VS Code recommended)
 :::
 
 :::tip
-See the [Syntax Highlighting](/docs/guides/syntax-highlighting) guide for how to get set-up for the best CashScript developer environment.
+To set up your CashScript developer environment, see the [Syntax Highlighting](/docs/guides/syntax-highlighting) guide.
 :::
 
 ### Installing the CashScript compiler
@@ -39,8 +39,8 @@ npm install -g cashc
 
 ### Writing your first smart contract
 
-Open your code-editor to start writing your first CashScript smart contract.
-We can start from a basic `TransferWithTimeout` smart contract, create a new file `TransferWithTimeout.cash` for the file.
+Open your code editor to start writing your first CashScript smart contract.
+We can start from a basic `TransferWithTimeout` smart contract. Create a new file `TransferWithTimeout.cash`.
 
 The `TransferWithTimeout` contract takes in 3 contract arguments and has 2 contract functions: `transfer` and `timeout`.
 
@@ -62,12 +62,12 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 ```
 
 :::tip
-There are some other examples available on the [Examples page](/docs/language/examples), that can be used to take inspiration from. Further examples of the JavaScript integration can be found on [GitHub](https://github.com/CashScript/cashscript/tree/master/examples).
+There are some other examples available on the [Examples page](/docs/language/examples) that can be used to take inspiration from. Further examples of the JavaScript integration can be found on [GitHub](https://github.com/CashScript/cashscript/tree/master/examples).
 :::
 
 ### Compiling your smart contract
 
-The next step after writing your smart contract is using the command line compiler to create a contract artifact so it can be imported into the CashScript SDK.
+The next step after writing your smart contract is using the command line compiler to create a contract artifact, so that it can be imported into the CashScript SDK.
 
 ```bash
 cashc ./TransferWithTimeout.cash --output ./TransferWithTimeout.json
@@ -77,10 +77,10 @@ This will create an artifact file `TransferWithTimeout.json` from your CashScrip
 
 ## Creating a CashScript Transaction
 
-After creating a contract artifact we can now use the JavaScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs. We'll continue with the `TransferWithTimeout` artifact generated in the previous steps.
+After creating a contract artifact, we can now use the JavaScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs. We'll continue with the `TransferWithTimeout` artifact generated in the previous steps.
 
 ### Installing the JavaScript SDK
-The JavaScript SDK can be installed into your project with NPM. Note that CashScript is a [Pure ESM package](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
+The JavaScript SDK can be installed into your project with NPM. Note that CashScript is a [pure ESM package](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
 
 ```bash
 npm install cashscript
@@ -88,35 +88,34 @@ npm install cashscript
 
 ### Initialising a Contract
 
-Now to initialise a contract we will import the ElectrumNetworkProvider and contract classes from the CashScript SDK. We of course also need the contract arifact, and lastly we need public keys from a generated key-pair to use as arguments to initialise the contract.
+Now to initialise a contract we will import the `ElectrumNetworkProvider` and `Contract` classes from the CashScript SDK. We also need to import the contract artifact. Lastly, we need public keys from a generated key-pair to use as arguments for contract initialisation.
 
 ```javascript
 import { ElectrumNetworkProvider, Contract } from 'cashscript';
-import { alicePub, bobPub } from './keys.js';
 import artifact from './TransferWithTimeout.json';
+import { alicePub, bobPub } from './keys.js';
 
 // Initialise a network provider for network operations
 const provider = new ElectrumNetworkProvider('chipnet');
 
 // Instantiate a new TransferWithTimeout contract
-const contractArguments = [alicePub, bobPub, 100000n]
-const ptions = { provider }
+const contractArguments = [alicePub, bobPub, 100000n];
+const options = { provider };
 const contract = new Contract(artifact, contractArguments, options);
 
 // Get the contract address and info about its balance
-console.log("Contract address:" + contract.address)
-console.log("Contract balance:" + await contract.getBalance())
-console.log("Contract Utxos:")
-console.log(await contract.getUtxos())
+console.log("Contract address: " + contract.address);
+console.log("Contract balance: " + await contract.getBalance());
+console.log("Contract UTXOs: " + await contract.getUtxos());
 ```
 
 :::tip
-For a code example of how to generate key-pairs with Libauth see the [CashScript Examples](https://github.com/CashScript/cashscript/blob/master/examples/common.ts) `common-ts` file where Alice and Bob's key-pairs are created!
+For a code example of how to generate key-pairs with Libauth, see the [CashScript Examples' `common.ts`](https://github.com/CashScript/cashscript/blob/master/examples/common.ts) file where Alice and Bob's key-pairs are created.
 :::
 
 ### Creating a Transaction
 
-Lastly to spend from the smart contract we've initialised you need to make sure there is an actual contract balance on the smart contract address. Or in other words, you need to make sure there's at least one UTXO with the smart contract locking bytecode so we can spend from it!
+Lastly, to spend from the smart contract we've initialised, you need to make sure there is an actual contract balance on the smart contract address. In other words, we need to make sure there's at least one UTXO with the smart contract locking bytecode, so that we can spend from it!
 
 ```javascript
 import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
@@ -127,8 +126,8 @@ import artifact from './TransferWithTimeout.json';
 const provider = new ElectrumNetworkProvider('chipnet');
 
 // Instantiate a new TransferWithTimeout contract
-const contractArguments = [alicePub, bobPub, 100000n]
-const options = { provider }
+const contractArguments = [alicePub, bobPub, 100000n];
+const options = { provider };
 const contract = new Contract(artifact, contractArguments, options);
 
 // Call the transfer function with Bob's signature
@@ -137,7 +136,8 @@ const transferDetails = await contract.functions
   .transfer(new SignatureTemplate(bobPriv))
   .to('bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx', 10000n)
   .send();
+
 console.log(transferDetails);
 ```
 
-Congrats 🎉! You've succesfully created a transaction spending from a Bitcoin Cash smart contract! 
+Congrats 🎉! You've successfully created a transaction spending from a Bitcoin Cash smart contract! 
diff --git a/website/docs/guides/covenants.md b/website/docs/guides/covenants.md
index 2897a985..bd08db0e 100644
--- a/website/docs/guides/covenants.md
+++ b/website/docs/guides/covenants.md
@@ -3,7 +3,7 @@ title: Writing Covenants & Introspection
 sidebar_label: Covenants & Introspection
 ---
 
-Covenants are all the rage in Bitcoin Cash smart contracts. But what are they, and how do you use them? In one sentence: **a covenant is a constraint on how money can be spent**. A simple example is creating a smart contract that may **only** send money to one specific address and nowhere else. The term *Covenant* originates in property law, where it is used to constrain the use of any object - or in the case of BCH, the use of money.
+Covenants are all the rage in Bitcoin Cash smart contracts. But what are they, and how do you use them? In one sentence: **a covenant is a constraint on how money can be spent**. A simple example is creating a smart contract that may **only** send money to one specific address and nowhere else. The term *Covenant* originates in property law, where it is used to constrain the use of any object — or in the case of BCH, the use of money.
 
 Bitcoin covenants were first proposed in a paper titled [Bitcoin Covenants][bitcoin-covenants], but several other proposals have been created over the years. In May of 2022 Bitcoin Cash implemented so-called *Native Introspection* which enables efficient and accessible covenants. This was extended with token introspection opcodes with the *CashTokens* upgrade in May of 2023.
 
@@ -32,10 +32,10 @@ When using CashScript, you can access a lot of *introspection data* that can be
 - **`int tx.outputs[i].tokenAmount`** - Amount of fungible tokens of a specific output.
 
 ## Using introspection data
-While we know the individual data fields, it's not immediately clear how this can be used to create useful smart contracts on Bitcoin Cash. But there are several constraints that can be created using these fields, most important of which are constraints on the recipients of funds, so that is what we discuss.
+While we know the individual data fields, it's not immediately clear how this can be used to create useful smart contracts on Bitcoin Cash. However, there are several constraints that can be created using these fields — most important of which are constraints on the recipients of funds — so that is what we discuss.
 
 ### Restricting P2PKH recipients
-One interesting technique in Bitcoin Cash is called blind escrow, meaning that funds are placed in an escrow contract. This contract can only release the funds to one of the escrow participants, and has no other control over the funds. Non-custodial local exchange [LocalCryptos](https://localcryptos.com) uses `OP_CHECKDATASIG` to do this, but we can also achieve something similar by restricting recipients with a covenant.
+One interesting technique in Bitcoin Cash is called blind escrow, meaning that funds are placed in an escrow contract. This contract can only release the funds to one of the escrow participants, and has no other control over the funds. Non-custodial local exchange [LocalCryptos](https://localcryptos.com) used `OP_CHECKDATASIG` to do this. We can achieve something similar by restricting recipients with a covenant.
 
 ```solidity
 contract Escrow(bytes20 arbiter, bytes20 buyer, bytes20 seller) {
@@ -61,7 +61,7 @@ contract Escrow(bytes20 arbiter, bytes20 buyer, bytes20 seller) {
 The contract starts by doing some checks to make sure the transaction is signed by the arbiter. Next up it checks that the full contract balance (`tx.inputs[this.activeInputIndex].value`) is sent to the first output by accessing `tx.outputs[0].value`. Finally it checks that the receiver of that money is either the buyer or the seller using `LockingBytecodeP2PKH` and `tx.outputs[0].lockingBytecode`. Note that we use a hardcoded fee as it is difficult to calculate the exact transaction fee inside the smart contract.
 
 ### Restricting P2SH recipients
-Besides sending money to `P2PKH` addresses, it is also possible to send money to a smart contract (`P2SH`) address. This can be used in the same way as a `P2PKH` address if the script hash is known beforehand, but this can also be used to make sure that money has to be sent back to the current smart contract.
+Besides sending money to `P2PKH` addresses, it is also possible to send money to a smart contract (`P2SH`) address. A smart contract address can be used in the same way as a `P2PKH` address (if the script hash is known beforehand), and it can also be used to make sure that money has to be sent back to the current smart contract.
 
 This is especially effective when used together with time constraints. An example is the *Licho's Last Will* contract. This contract puts a dead man's switch on the contract's holdings, and requires the owner to send a heartbeat to the contract every six months. If the contract hasn't received this heartbeat, an inheritor can claim the funds instead.
 
@@ -88,7 +88,7 @@ contract LastWill(bytes20 inheritor, bytes20 cold, bytes20 hot) {
         require(tx.outputs[0].value == amount);
 
         // Check that the funds are sent back to the contract
-        bytes23 contractLock = tx.inputs[this.activeInputIndex].lockingBytecode;
+        bytes contractLock = tx.inputs[this.activeInputIndex].lockingBytecode;
         require(tx.outputs[0].lockingBytecode == contractLock);
     }
 }
@@ -97,7 +97,7 @@ contract LastWill(bytes20 inheritor, bytes20 cold, bytes20 hot) {
 This contract has three functions, but only the `refresh()` function uses a covenant. Again it performs necessary checks to verify that the transaction is signed by the owner, after which it checks that the entire contract balance is sent. It then uses `tx.inputs[this.activeInputIndex].lockingBytecode` to access its own locking bytecode, which can be used as the locking bytecode of this output. Sending the full value back to the same contract effectively resets the `tx.age` counter, so the owner of the contract needs to do this every 180 days.
 
 ### Restricting P2PKH and P2SH
-The earlier examples showed sending money to only a single output of either `P2PKH` or `P2SH`. But there nothing preventing us from writing a contract that can send to multiple outputs, including a combination of `P2PKH` and `P2SH` outputs. A good example is the *Licho's Mecenas* contract that allows you to set up recurring payments where the recipient is able to claim the same amount every month, while the remainder has to be sent back to the contract.
+The earlier examples showed sending money to only a single output of either `P2PKH` or `P2SH`. But there's nothing preventing us from writing a contract that can send to multiple outputs, including a combination of `P2PKH` and `P2SH` outputs. A good example is the *Licho's Mecenas* contract that allows you to set up recurring payments where the recipient is able to claim the same amount every month, while the remainder has to be sent back to the contract.
 
 ```solidity
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
@@ -116,7 +116,7 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
         // If there is not enough left for *another* pledge after this one,
         // we send the remainder to the recipient. Otherwise we send the
         // pledge to the recipient and the change back to the contract
-        if (changeValue <= pledge + minerFees) {
+        if (changeValue <= pledge + minerFee) {
             require(tx.outputs[0].value == currentValue - minerFee);
         } else {
             require(tx.outputs[0].value == pledge);
@@ -137,7 +137,7 @@ This contract applies similar techniques as the previous two examples to verify
 
 ## Local State
 
-Smart contracts which persist for multiple transactions might want to keep data for later use, this is called local state. With the CashTokens upgrade local state can be kept in the commitment field of the NFT of the smart contract UTXO. Because the state is not kept in the script of the smart contract itself, the address can remain the same. 
+Smart contracts which persist for multiple transactions might want to keep data for later use. This is called local state. With the CashTokens upgrade, local state can be kept in the commitment field of the NFT of the smart contract UTXO. Because the state is not kept in the script of the smart contract itself, the address can remain the same. 
 
 :::info
 Covenants can also use 'simulated state', where state is kept in the contract script and the contract enforces a new P2SH locking bytecode of the contract with a different state update. This method causes the contract address to change with each state update.
@@ -203,7 +203,7 @@ contract StreamingMecenas(
 }
 ```
 
-Instead of having a pledge per 30 day period, we define a pledge per block. At any point in time we can calculate how much money the recipient has earned. Then the covenant **enforces that this amount is withdrawn from the contract**. The remainder is sent to a new stream that **starts at the end of of the previous one**. The locktime used for the last withdrawal from the covenant is kept in the local state to calculate the amount of money the recipient has earned over the passed time. This process of changing the local state in the NFT associated with the smart contractUTXO can be applied to the new stream until the money in the stream runs out.
+Instead of having a pledge per 30 day period, we define a pledge per block. At any point in time we can calculate how much money the recipient has earned. Then the covenant **enforces that this amount is withdrawn from the contract**. The remainder is sent to a new stream that **starts at the end of the previous one**. The locktime used for the last withdrawal from the covenant is kept in the local state to calculate the amount of money the recipient has earned over the passed time. This process of changing the local state in the NFT associated with the smart contract UTXO can be applied to the new stream until the money in the stream runs out.
 
 :::tip
 We use `tx.locktime` to introspect the value of the timelock, and to write the value to the contract local state: the NFT commitment field.
@@ -211,12 +211,12 @@ We use `tx.locktime` to introspect the value of the timelock, and to write the v
 
 ### Issuing NFTs as receipts
 
-A covenant that manages funds (BCH + fungible tokens of a certain category) which are pooled together from different people often wants to enable its participants to also exit the covenants with their funds. It would be incredibly hard continuously updating a data structure to keep track of which address contributed how much in the local state of the contract. A much better solution is to issue receipts each time funds are added to the pool! This way the contract does not have a 'global view' of who owns what at any time, but it can validate the receipts when invocing a withdrawal. 
+A covenant that manages funds (BCH + fungible tokens of a certain category) which are pooled together from different people often wants to enable its participants to also exit the covenants with their funds. It would be incredibly hard continuously updating a data structure to keep track of which address contributed how much in the local state of the contract. A much better solution is to issue receipts each time funds are added to the pool! This way the contract does not have a 'global view' of who owns what at any time, but it can validate the receipts when invoking a withdrawal. 
 
-Technically this happens by minting a new NFT with in the commitment field the amount of satoshis or fungible tokens that were contributed to the pool and sending this to the address of the contributor.
+Technically this happens by minting a new NFT, with in the commitment field the amount of satoshis or fungible tokens that were contributed to the pool, and sending this to the address of the contributor.
 
 :::tip
-Minting NFT receipts allows the contract to offload state to an NFT helf by a user. By default these receipts are easily transferable and tradable because they are generic NFTs.
+Minting NFT receipts allows the contract to offload state to an NFT held by a user. By default, these receipts are easily transferable and tradable because they are generic NFTs.
 :::
 
 Let's take a look at an example contract called `PooledFunds` which has two contract functions: `addFunds` and `withdrawFunds`
@@ -307,15 +307,15 @@ contract PooledFunds(
 }
 ```
 
-All outputs of the `PooledFunds` contract need to be carefully controlled in the contract code so no additional NFTs can be minted in other outputs as this would allow 'fake' receipts to be created. The user receipt NFTs only differ from the covenant's minting NFT in that there is no minting capability added to the token's categoryID when calling `.tokenCategory`. At withdrawal the receipt needs to be validated and then the NFT commitment data is read to understand the contents of the receipt. In the current contract the receipt NFT also needs to be burned (simply not re-created in the outputs) ensuring the same receipt cannot be used to withdraw twice.
+All outputs of the `PooledFunds` contract need to be carefully controlled in the contract code so no additional NFTs can be minted in other outputs, as this would allow 'fake' receipts to be created. The user receipt NFTs only differ from the covenant's minting NFT in that there is no minting capability added to the token's categoryID when calling `.tokenCategory`. At withdrawal, the receipt needs to be validated, and then the NFT commitment data is read to understand the contents of the receipt. In the current contract the receipt NFT also needs to be burned (simply not re-created in the outputs) ensuring the same receipt cannot be used to withdraw twice.
 
 :::caution
-With contracts holding minting NFTs, all outputs need to be carefully controlled in the covenant contract code so no additional (minting) NFTs can un-intentionally be created in other outputs.
+With contracts holding minting NFTs, all outputs need to be carefully controlled in the covenant contract code, so no additional (minting) NFTs can un-intentionally be created in other outputs.
 :::
 
 
 ## Conclusion
-We have discussed the main uses for covenants as they exist on Bitcoin Cash today. We've seen how we can achieve different use case by combining transaction output restrictions to `P2SH` and `P2PKH` outputs. We also touched on more advanced subjects such as keeping local state in NFTs. Covenants and CashTokens are the **main differentiating factor** for BCH smart contracts when compared to BTC, while keeping the same **efficient, atomic verification**.
+We have discussed the main uses for covenants as they exist on Bitcoin Cash today. We've seen how we can achieve different use cases by combining transaction output restrictions to `P2SH` and `P2PKH` outputs. We also touched on more advanced subjects such as keeping local state in NFTs. Covenants and CashTokens are the **main differentiating factor** for BCH smart contracts when compared to BTC, while keeping the same **efficient, atomic verification**.
 
 Keeping local state in NFTs and issuing NFTs as receipts are two strategies which can be used to create much more sophisticated decentralized applications such as the AMM-style DEX named [Jedex](https://blog.bitjson.com/jedex-decentralized-exchanges-on-bitcoin-cash/).
 
diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index ebe2b167..9930cb33 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -2,18 +2,18 @@
 title: Debugging
 ---
 
-Debugging is no walk in the park, this is especially true for debugging complex smart contracts. Luckily there is a handful of startegies that can make it easier for developers to discover bugs with their contracts.
+Debugging is no walk in the park. This is especially true for debugging complex smart contracts. Luckily there is a handful of strategies that can make it easier for developers to discover bugs in their contracts.
 
-Generally there are 2 broad categories of smart contract bugs
+Generally there are 2 broad categories of smart contract bugs:
 
 - A bug in your invocation making the transaction invalid
 - A bug in the smart contract which prohibits valid spending
 
-Whatever category your bug falls into, the first step is discovering what line in your CashScript contract is making your transaction get rejected. Afterwards, investigation needs to start whether it's a contract bug, or a invocation bug.
+Whatever category your bug falls into, the first step is discovering what line in your CashScript contract is making your transaction get rejected. Afterwards, investigation needs to start whether it's a contract bug, or an invocation bug.
 
 ## Simple Transaction Builder
 
-The [Simple Transaction Builder](/docs/sdk/transactions) has deep integration with libauth to enable local transaction evaluation without actual interaction with the Bitcoin Cash network. This allows for advanced debugging functionality.
+The [Simple Transaction Builder](/docs/sdk/transactions) has deep integration with libauth to enable local transaction evaluation, without actual interaction with the Bitcoin Cash network. This allows for advanced debugging functionality.
 
 :::note
 Currently the CashScript debugging tools only work with the [Simple Transaction Builder](/docs/sdk/transactions). We plan to extend the debugging tools to work with the [Advanced Transaction Builder](/docs/sdk/transactions-advanced) in the future.
@@ -23,15 +23,15 @@ Currently the CashScript debugging tools only work with the [Simple Transaction
 
 If a CashScript transaction is sent using any network provider and is rejected by the network (or the `MockNetworkProvider`), the transaction will be evaluated locally using libauth to provide failure reasons and debug information in addition to the failure reason communicated by the network.
 
-Read the error message to see which line in the CashScript contract causes the transcation validation to fail. Investigate whether the contract function invocation is the issue (on the javascript SDK side) or whether the issue is in the CashScript contract itself (so you'd need to update your contract and recompile the artifact). If it is not clear **why** the CashScript contract is failing on that line, then you can use the following two strategies: console logging & Bitauth IDE stack trace.
+Read the error message to see which line in the CashScript contract causes the transaction validation to fail. Investigate whether the contract function invocation is the issue (on the JavaScript SDK side) or whether the issue is in the CashScript contract itself (so you'd need to update your contract and recompile the artifact). If it is not clear **why** the CashScript contract is failing on that line, then you can use the following two strategies: console logging & Bitauth IDE stack trace.
 
 ### Console Logging
 
-To help with debugging you can add `console.log` statements to your CashScript contract file to log variables. This way you investigate whether the variable have the expected values when they get to the failing `require` statement in the CashScript file. After adding the `console.log` statements, recompile your contract so they are added to your contract's Arifact. 
+To help with debugging you can add `console.log` statements to your CashScript contract file to log variables. This way you investigate whether the variables have the expected values when they get to the failing `require` statement in the CashScript file. After adding the `console.log` statements, recompile your contract so they are added to your contract's Artifact. 
 
 ### Bitauth IDE
 
-Whenever a transaction fails there will be a link in the console to open your smart contract trnasaction in the BitAuth IDE. This will allow you to inspect the transaction in detail, and see exactly why the transaction failed. In the BitAuth IDE you will see the raw BCH Script mapping to each line in your CashScript contract. Find the failing line and investigate the failing OpCode. You can break up the failing line, one opcode at a time to see how the stack evolves and ends with your `require` failure.
+Whenever a transaction fails, there will be a link in the console to open your smart contract transaction in the BitAuth IDE. This will allow you to inspect the transaction in detail, and see exactly why the transaction failed. In the BitAuth IDE you will see the raw BCH Script mapping to each line in your CashScript contract. Find the failing line and investigate the failing OpCode. You can break up the failing line, one opcode at a time, to see how the stack evolves and ends with your `require` failure.
 
 It's also possible to export the transaction for step-by-step debugging in the BitAuth IDE without failure. To do so, you can call the `bitauthUri()` function on the transaction. This will return a URI that can be opened in the BitAuth IDE.
 
@@ -50,14 +50,14 @@ Because the advanced transaction builder does not yet support the advanced debug
 
 ### Failing Opcode
 
-When a transaction gets rejected by a full node it will return a cryptic error message, read the message carefully to investigate whether the issue is a failing script (failing OpCode) or whether a standarness rule like minimum-relay-fee is violated. If the cause is a failing OpCode, you can check the contract's Artifact to see how many appearances this OpCode has. Sometimes the OpCode only appears once or twice, indicating where the failing `require` statement is. Other times you might see 15 appearances of the OpCode leaving you to try the next strategies.
+When a transaction gets rejected by a full node, it will return a cryptic error message. Read the message carefully to investigate whether the issue is a failing script (failing OpCode) or whether a standardness rule like minimum-relay-fee is violated. If the cause is a failing OpCode, you can check the contract's Artifact to see how many appearances this OpCode has. Sometimes the OpCode only appears once or twice, indicating where the failing `require` statement is. Other times you might see 15 appearances of the OpCode leaving you to try the next strategies.
 
 ### Removing Contract Checks
 
-If your contract fails, you can remove (or comment out) the lines that are the likely cause of the error. After recompiling to a new Artifact you can test whether the remaining subcontract works or fails with a different error. If this is the case then you learned that there is an issue in the removed CashScript code block. In the worst case when you have no indication from the failing opcode (previous strategy) then you will have to try remove different parts of your contract and trying different sub-contracts repeatedly. 
+If your contract fails, you can remove (or comment out) the lines that are the likely cause of the error. After recompiling to a new Artifact you can test whether the remaining subcontract works or fails with a different error. If this is the case, then you learned that there is an issue in the removed CashScript code block. In the worst case, when you have no indication from the failing opcode (previous strategy), then you will have to try to remove different parts of your contract and try different sub-contracts repeatedly. 
 
 To use this strategy effectively, the contract setup with funding should be automated as to avoid having to send testnet coins manually to each different subcontract. However inefficient, this strategy should always be able to get you to find the failing line in your CashScript contract. Then you can investigate whether the issue is the contract invocation or the `require` statement in the CashScript file.
 
 ### Single Check Contract
 
-If it is unclear whether the issue is the contract invocation or the `require` statement in the CashScript file, it might prove handy to create a 'single-check Contract' which has only the previously failing require statement. The goal then is to discover if your transaction is the issue and you are violating a correct contract requirement or whether the contract is enforcing an incorrect/impossible condition to hold in the spending transaction.
+If it is unclear whether the issue is the contract invocation or the `require` statement in the CashScript file, it might prove handy to create a 'single-check' contract, which has only the previously failing `require` statement. The goal then is to discover if your transaction is the issue, and you are violating a correct contract requirement, or whether the contract is enforcing an incorrect/impossible condition to hold in the spending transaction.
diff --git a/website/docs/guides/optimization.md b/website/docs/guides/optimization.md
index 7b6393eb..8ef2a0a4 100644
--- a/website/docs/guides/optimization.md
+++ b/website/docs/guides/optimization.md
@@ -9,16 +9,16 @@ Depending on the complexity of the contract or system design, it may sometimes b
 
 ## Optimization Tips & Tricks
 
-The `cashc` compiler does some optimisations automatically, but by writing your CashScript code in a specific way, the compiler is better able to optimise it. Trial & error is a definately part of it, but here are some tricks that may help:
+The `cashc` compiler does some optimisations automatically. By writing your CashScript code in a specific way, the compiler is better able to optimise it. Trial & error is definitely part of it, but here are some tricks that may help:
 
 ### 1. Consume stack items
 
-It's best to "consume" values as soon as possible ("consume" meaning their final use in the contract). This frees up space on the stack.
-Use/consume values as close to their declaration as possible, both for variables and for parameters. This avoids having to do deep stack operations. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L61-72) from anyhedge illustrates consuming values immediately.
+It's best to "consume" values (i.e. their final use in the contract) as soon as possible. This frees up space on the stack.
+Use/consume values as close to their declaration as possible, both for variables and for parameters. This avoids having to do deep stack operations. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L61-72) from AnyHedge illustrates consuming values immediately.
 
 ### 2. Declare variables
 
-Declare variables when re-using certain common introspection items to avoid duplicate expressions
+Declare variables when re-using certain common introspection items to avoid duplicate expressions.
 
 ```solidity title="Example CashScript code"
     // do this
@@ -33,7 +33,7 @@ Declare variables when re-using certain common introspection items to avoid dupl
 ```
 
 ### 3. Parse efficiently
-When using `.split()` to use both sides of a `bytes` element, declare both parts immediately to save on opcodes aprsing the byte array.
+When using `.split()` to use both sides of a `bytes` element, declare both parts immediately to save on opcodes parsing the byte array.
 
 ```solidity title="Example CashScript code"
     // do this
@@ -46,7 +46,7 @@ When using `.split()` to use both sides of a `bytes` element, declare both parts
 ```
 ### 4. Avoid if-else
 
-Avoid if-statements if possible, instead try to "inline" them. This is because the compiler cannot know which branches will be taken, and therefore cannot optimise those branches as well. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L128-130) from anyhedge illustrates inlining flow control:
+Avoid if-statements when possible. Instead, try to "inline" them. This is because the compiler cannot know which branches will be taken, and therefore cannot optimise those branches as well. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L128-130) from AnyHedge illustrates inlining flow control:
 
 ```solidity title="AnyHedge CashScript code"
     // do this
@@ -63,11 +63,11 @@ Avoid if-statements if possible, instead try to "inline" them. This is because t
 
 ## Modular Contract Design
 
-An alternative to optimizing your contract to shrink it in size is to redesign your contract to use a composable architecture so the contract logic is separated out in to multiple componenets which only some of which can be used in a transaction and hence shrink your contract size.
+An alternative to optimizing your contract to shrink in size is to redesign your contract to use a composable architecture. The contract logic is separated out in to multiple components of which only some can be used in a transaction, and hence shrink your contract size.
 
 ### NFT contract functions
 
-The concept of having NFT functions was firt introduced by the [Jedex demo](https://github.com/bitjson/jedex#demonstrated-concepts) and was first implemented in a CashScript contract by the [FexCash DEX](https://github.com/fex-cash/fex/blob/main/whitepaper/fex_whitepaper.md). The concept is that by authenticating NFTs you can make each function a separate contract with the same tokenId. This way you can offload logic from the main contract and one function NFT contract attached to the main contract on spending so the other contract functions exist as unused UTXOs separate from the transaction.
+The concept of having NFT functions was first introduced by the [Jedex demo](https://github.com/bitjson/jedex#demonstrated-concepts) and was first implemented in a CashScript contract by the [FexCash DEX](https://github.com/fex-cash/fex/blob/main/whitepaper/fex_whitepaper.md). The concept is that by authenticating NFTs, you can make each function a separate contract with the same tokenId. This way, you can offload logic from the main contract. One function NFT contract is attached to the main contract during spending, while the other contract functions exist as unused UTXOs, separate from the transaction.
 
 :::tip
 By using function NFTs you can use a modular contract design where the contract functions are offloaded to different UTXOs, each identifiable by the main contract by using the same tokenId.
@@ -75,8 +75,8 @@ By using function NFTs you can use a modular contract design where the contract
 
 ## Example Workflow
 
-When trying to optimizing your contract, you will need to compare the contract size to see if the changes have a positive impact.
-You can easily check the opcode count and bytesize with the compiler CLI directly from the contract (without creating a new artifact).
+When trying to optimize your contract, you will need to compare the contract size to see if the changes have a positive impact.
+With the compiler CLI, you can easily check the opcode count and bytesize directly from the contract (without creating a new artifact).
 It's important to know the minimum fees on the Bitcoin Cash network are based on the bytesize of a transaction (including your contract).
 
 ```bash
@@ -87,7 +87,7 @@ cashc ./contract.cash --opcount --size
 The size output of the `cashc` compiler will always be an underestimate, as the contract hasn't been initialized with contract arguments.
 :::
 
-The `cashc` compiler only knows the opcount and bytesize of a contract before it is initialised with function arguments. Because of this, to get an accurate view of a contracts size initialise the contract instance first, then get the size from there. This means you will have to re-compile the artifact before checking with contract size through the Javascript SDK.
+The `cashc` compiler only knows the opcount and bytesize of a contract before it is initialised with function arguments. Because of this, to get an accurate view of a contracts size, initialise the contract instance first, then get the size from there. This means you will have to re-compile the artifact before checking the contract size through the JavaScript SDK.
 
 ```javascript
 import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
@@ -109,13 +109,12 @@ console.log(contract.opcount);
 console.log(contract.bytesize);
 ```
 
-With this workflow you can make changes to the contract and the run the Javascript program to
-
- get an accurate measure of how the bytesize of your contract changes with different optimizations.
+With this workflow, you can make changes to the contract and the run the JavaScript program to 
+get an accurate measure of how the bytesize of your contract changes with different optimizations.
 
 ## To optimize or not to optimize?
 
-There is a last important alternative approache to optimization contract bytecode to consider:
+In the context of optimizing contract bytecode, there's an important remark to consider:
 
 ### OP_NOP
 
diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index 3bf7f56c..b89f468b 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -34,7 +34,7 @@ Upon initialization of the contract, constructor parameters are encoded and adde
 :::
 
 ## Functions
-The main construct in a CashScript contract is the function. A contract can contain one or multiple functions that can be executed to trigger transactions that spend money from the contract. In the basics the result of a function is just a yes or no answer to the question 'Can money be sent out of this contract?'. But by using a technique called covenants, it is possible to specify other conditions, like restricting *where* money can be sent. To read more about this technique, refer to the [CashScript Covenants Guide](/docs/guides/covenants).
+The main construct in a CashScript contract is the function. A contract can contain one or multiple functions that can be executed to trigger transactions that spend money from the contract. At its core, the result of a function is just a yes or no answer to the question 'Can money be sent out of this contract?'. However, by using a technique called covenants, it's possible to specify additional conditions — like restricting *where* money can be sent. To read more about this technique, refer to the [CashScript Covenants Guide](/docs/guides/covenants).
 
 #### Example
 ```solidity
@@ -80,7 +80,7 @@ contract P2PKH(bytes20 pkh) {
 ```
 
 ### Variable declaration
-Variables can be declared by specifying their type and name. All variables need to be initialised at the time of their declaration, but can be reassigned later on - unless specifying the `constant` keyword. Since CashScript is strongly typed and has no type inference, it is not possible to use keywords such as `var` or `let` to declare variables.
+Variables can be declared by specifying their type and name. All variables need to be initialised at the time of their declaration, but can be reassigned later on — unless specifying the `constant` keyword. Since CashScript is strongly typed and has no type inference, it is not possible to use keywords such as `var` or `let` to declare variables.
 
 :::caution
 CashScript disallows variable shadowing and unused variables.
@@ -103,7 +103,7 @@ myString = 'Cash';
 ```
 
 ### Control structures
-The only control structures in CashScript are `if` and `else` statements. This is due to limitations in the underlying Bitcoin Script which prevent loops, recursion, and `return` statements. If-else statements follow usual semantics known from languages like C or JavaScript.
+The only control structures in CashScript are `if...else` statements. This is due to limitations in the underlying Bitcoin Script which prevents loops, recursion, and `return` statements. If-else statements follow usual semantics known from languages like C or JavaScript.
 
 :::note
 There is no implicit type conversion from non-boolean to boolean types. So `if (1) { ... }` is not valid CashScript and should instead be written as `if (bool(1)) { ... }`
diff --git a/website/docs/language/examples.md b/website/docs/language/examples.md
index 5e4f51c7..325d3141 100644
--- a/website/docs/language/examples.md
+++ b/website/docs/language/examples.md
@@ -2,7 +2,7 @@
 title: Examples
 ---
 
-An extensive collection of examples is available in the [GitHub repository](https://github.com/CashScript/cashscript/tree/master/examples). Below we discuss a few of these examples in more details and go through the functionality.
+An extensive collection of examples is available in the [GitHub repository](https://github.com/CashScript/cashscript/tree/master/examples). Below we discuss a few of these examples in more details and go through their functionality. These examples focus mainly on the CashScript syntax, while the [Examples page](/docs/sdk/examples) in the sdk section focuses more on the use of the SDK.
 
 ## Transfer With Timeout
 One interesting use case of Bitcoin Cash is using it for *paper tips*. With paper tips, you send a small amount of money to an address, and print the corresponding private key on a piece of paper. Then you can hand out these pieces of paper as a tip or gift to people in person. In practice, however, people might not know what to do with these gifts or they might lose or forget about it.
@@ -26,10 +26,12 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 }
 ```
 
+For an example of how to put this contract to use in a JavaScript application, see the [SDK examples page](/docs/sdk/examples#transfer-with-timeout)
+
 ## HodlVault
 For better or worse, HODLing and waiting for price increases is one of the main things people want to do with their cryptocurrency. But it can be difficult to hold on to your cryptocurrency when the price is going down. So to prevent weak hands from getting the best of you, it's better to store your stash in a smart contract that enforces HODLing for you.
 
-This smart contract works by connecting with a price oracle. This price oracle is a trusted entity that publishes the BCH/USD price every block. This price is passed into the contract, and only if the price is higher than your target price you can spend the coins.
+This smart contract works by connecting with a price oracle. This price oracle is a trusted entity that publishes the BCH/USD price every block. This price is passed into the contract, and only if the price is higher than your target price, you can spend the coins.
 
 This involves some degree of trust in the price oracle, but since the oracle produces price data for everyone to use, their incentive to attack *your* smart contract is minimised. To improve this situation, you can also choose to connect with multiple oracle providers so you do not have to trust a single party.
 
@@ -65,11 +67,11 @@ contract HodlVault(pubkey ownerPk, pubkey oraclePk, int minBlock, int priceTarge
 ```
 
 ## Licho's Mecenas
-Donations are a great way to support the projects you love and periodic donations can incentivise continuous improvement to the product. But platforms like Patreon generally take fees of 10%+ and don't accept cryptocurrencies. Instead you can create a peer-to-peer smart contract that allows a recipient to withdraw a specific amount every month.
+Donations are a great way to support the projects you love, and periodic donations can incentivise continuous improvement to the product. But platforms like Patreon generally take fees of 10%+ and don't accept cryptocurrencies. Instead you can create a peer-to-peer smart contract that allows a recipient to withdraw a specific amount every month.
 
-The contract works by checking that a UTXO is at least 30 days old, after which it uses a covenant to enforce that the `pledge` amount is sent to the recipient, while the remainder is sent back to the contract itself. By sending it back the `tx.age` counter is effectively reset, meaning this process can only be repeated when another 30 days have past.
+The contract works by checking that a UTXO is at least 30 days old, after which it uses a covenant to enforce that the `pledge` amount is sent to the recipient, while the remainder is sent back to the contract itself. By sending it back, the `tx.age` counter is effectively reset, meaning this process can only be repeated when another 30 days have past.
 
-Due to the nature of covenants we have to be very specific about the outputs (amounts and destinations) of the transaction. This also means that we have to account for the special case where the remaining contract balance is lower than the `pledge` amount, meaning no remainder should be sent back. Finally we have to account for a small fee that has to be taken from the contract's balance to pay the miners.
+Due to the nature of covenants, we have to be very specific about the outputs (amounts and destinations) of the transaction. This also means that we have to account for the special case where the remaining contract balance is lower than the `pledge` amount, meaning no remainder should be sent back. Finally, we have to account for a small fee that has to be taken from the contract's balance to pay the miners.
 
 ```solidity
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
diff --git a/website/docs/language/functions.md b/website/docs/language/functions.md
index 9f9a6aa2..61b105b9 100644
--- a/website/docs/language/functions.md
+++ b/website/docs/language/functions.md
@@ -2,7 +2,7 @@
 title: Global Functions & Operators
 ---
 
-CashScript has several builtin functions for things like cryptographic and arithmetic applications, and it includes many common arithmetic and other operators that you would expect in a programming language.
+CashScript has several built-in functions for things like cryptographic and arithmetic applications, and it includes many common arithmetic and other operators that you would expect in a programming language.
 
 ## Arithmetic functions
 ### abs()
diff --git a/website/docs/language/globals.md b/website/docs/language/globals.md
index fef449fa..7ee90d52 100644
--- a/website/docs/language/globals.md
+++ b/website/docs/language/globals.md
@@ -155,7 +155,7 @@ bytes tx.inputs[i].tokenCategory
 Represents the `tokenCategory` of a specific input. Returns 0 when that specific input contains no tokens. When the input contains an NFT with a capability, the 32-byte `tokenCategory` is concatenated together with `0x01` for a mutable NFT and `0x02` for a minting NFT.
 
 :::note
-The `tokenCategory` is returned in the original un-reversed order. Explorers and wallets change the byte order by default but for Cashscript you need to be careful to use the un-reversed order.
+The `tokenCategory` is returned in the original unreversed order. Explorers and wallets change the byte order by default but for CashScript you need to be careful to use the unreversed order.
 :::
 
 #### tx.inputs[i].nftCommitment
@@ -204,7 +204,7 @@ bytes tx.output[i].tokenCategory
 Represents the `tokenCategory` of a specific output. Returns 0 when that specific output contains no tokens. When the output contains an NFT with a capability, the 32-byte `tokenCategory` is concatenated together with `0x01` for a mutable NFT and `0x02` for a minting NFT.
 
 :::note
-The `tokenCategory` is returned in the original un-reversed order. Explorers and wallets change the byte order by default but for Cashscript you need to be careful to use the un-reversed order.
+The `tokenCategory` is returned in the original unreversed order. Explorers and wallets change the byte order by default but for CashScript you need to be careful to use the unreversed order.
 :::
 
 #### tx.output[i].nftCommitment
diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index be16cb6c..63068a11 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -31,7 +31,7 @@ Note the lack of the `**` (exponentiation) operator as well as any bitwise opera
 
 ### Over- & Underflows
 
-The maximum range for 64-bit integers is `-9223372036854775807` to `9223372036854775807`, operations exceeding these limits will fail the transaction. So operations like summation, subtraction and multiplation should take in to account these boundry cases with over- or underflows.
+The maximum range for 64-bit integers is `-9223372036854775807` to `9223372036854775807`, operations exceeding these limits will fail the transaction. So operations like summation, subtraction and multiplication should take into account these boundary cases with over- or underflows.
 
 :::caution
 Contract authors should always consider whether `+`, `-` and `*` operations can cause under- or overflows and how this would impact contract security.
@@ -104,7 +104,7 @@ bytes noCapability = 0x;
 ```
 
 ## Bytes types with semantic meaning
-Some byte sequences hold specific meanings inside Bitcoin Cash contracts. These have been granted their own types separate from the regular `bytes` type.
+Some byte sequences hold specific meanings inside Bitcoin Cash contracts. These have been granted their own types, separate from the regular `bytes` type.
 
 ### Public Key
 `pubkey`: Byte sequence representing a public key. Generally 33 bytes long.
@@ -176,10 +176,10 @@ bytes4 integer = bytes4(25);
 
 ### Int to Byte Casting
 
-When casting integer types to bytes of a certain size, the integer value is padded with zeros. e.g. `bytes4(0) == 0x00000000`. It is also possible to pad with a variable number of zeros, by passing in a `size` parameter, which indicates the size of the output. e.g. `bytes(0, 4 - 2) == 0x0000`. The size casting can be a very important feature when keeping local state in an nftCommitment or in the simulated state.
+When casting integer types to bytes of a certain size, the integer value is padded with zeros, e.g. `bytes4(0) == 0x00000000`. It is also possible to pad with a variable number of zeros by passing in a `size` parameter, which indicates the size of the output, e.g. `bytes(0, 4 - 2) == 0x0000`. The size casting can be a very important feature when keeping local state in an nftCommitment or in the simulated state.
 
 :::note
-VM numbers follow Script Number format (A.K.A. CSCriptNum), to convert VM number to bytes or the revserse, it's recommended to use helperfunctions for these conversions from libraries like Libauth.
+VM numbers follow Script Number format (A.K.A. CSCriptNum), to convert VM number to bytes or the reverse, it's recommended to use helper functions for these conversions from libraries like Libauth.
 :::
 
 
diff --git a/website/docs/sdk/examples.md b/website/docs/sdk/examples.md
index a9534d72..79028e61 100644
--- a/website/docs/sdk/examples.md
+++ b/website/docs/sdk/examples.md
@@ -2,7 +2,7 @@
 title: Examples
 ---
 
-An extensive collection of examples is available in the [GitHub repository][github-examples]. Below we discuss a few of these examples in more details. These examples focus mainly on the use of the SDK, while the [Examples page](/docs/language/examples) in the language section focuses more on the CashScript syntax.
+An extensive collection of examples is available in the [GitHub repository][github-examples]. Below we discuss a few of these examples in more detail. These examples focus mainly on the use of the SDK, while the [Examples page](/docs/language/examples) in the language section focuses more on the CashScript syntax.
 
 ## Transfer With Timeout
 The idea of this smart contract is explained on the [Language Examples page](/docs/language/examples#transfer-with-timeout). The gist is that it allows you to send an amount of BCH to someone, but if they don't claim the sent amount, it can be recovered by the sender.
@@ -21,17 +21,18 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 }
 ```
 
-Now to put this smart contract in use in a JavaScript application we have to use the CashScript SDK in combination with a BCH library such as [BCHJS][bchjs], [bitcore-lib-cash][bitcore] or [Libauth][libauth]. These libraries are used to generate public/private keys for the contract participants. Then these keys can be used in the CashScript SDK. The key generation code is left out of this example, since this works differently for every library.
+Now to put this smart contract to use in a JavaScript application, we have to use the CashScript SDK in combination with a BCH library such as [BCHJS][bchjs], [bitcore-lib-cash][bitcore] or [Libauth][libauth]. These libraries are used to generate public/private keys for the contract participants. Then these keys can be used in the CashScript SDK. The key generation code is left out of this example, since this works differently for every library.
 
 ```ts title="TransferWithTimeout.js"
 import { Contract, SignatureTemplate } from 'cashscript';
-import { alicePriv, alicePub, bobPriv, bobPub } from './somewhere.js';
+import { alicePub, bobPriv, bobPub } from './somewhere.js';
 import artifact from './transfer_with_timeout.json';
 
 // Instantiate a new contract using the artifact and constructor arguments:
 // { sender: alicePub, recipient: bobPub, timeout: 1000000 }
 // No network provider is provided, so the default ElectrumNetworkProvider is used
-const contract = new Contract(artifact, [alicePub, bobPub, 1000000n], options:{addressType: 'p2sh20'});
+const options = { addressType: 'p2sh20' };
+const contract = new Contract(artifact, [alicePub, bobPub, 1000000n], options);
 
 // Display contract address and balance
 console.log('contract address:', contract.address);
@@ -43,13 +44,14 @@ const txDetails = await contract.functions
   .transfer(new SignatureTemplate(bobPriv))
   .to('bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx', 10000n)
   .send();
+
 console.log(txDetails);
 ```
 
 ## Memo.cash Announcement
 [Memo.cash](https://memo.cash) is a Twitter-like social network based on Bitcoin Cash. It uses `OP_RETURN` outputs to post messages on-chain. By using a covenant we can create an example contract whose only job is to post Isaac Asimov's first law of smart contracts to Memo.cash. Just to remind its fellow smart contracts.
 
-This contract expects a hardcoded transaction fee of 1000 satoshis. This is necessary due to the nature of covenants (See the [Licho's Mecenas example](/docs/language/examples#lichos-mecenas) for more information on this). The remaining balance after this transaction fee might end up being lower than 1000 satoshis, which means that the contract does not have enough leftover to make another announcement.
+This contract expects a hardcoded transaction fee of 1000 satoshis. This is necessary due to the nature of covenants (See the [Licho's Mecenas example](/docs/language/examples#lichos-mecenas) for more information on this). The remaining balance after this transaction fee might end up being lower than 1000 satoshis, which means that the contract does not have enough left over to make another announcement.
 
 To ensure that this leftover money does not get lost in the contract, the contract performs an extra check, and adds the remainder to the transaction fee if it's too low.
 
@@ -85,7 +87,7 @@ contract Announcement() {
 }
 ```
 
-The CashScript code above ensures that the smart contract **can only** be used in the way specified in the code. But the transaction needs to be created by the SDK, and to ensure that it complies with the rules of the smart contract, we need to use some of the more advanced options of the SDK.
+The CashScript code above ensures that the smart contract **can only** be used in the way specified in the code. But the transaction needs to be created by the SDK. To ensure that it complies with the rules of the smart contract, we need to use some of the more advanced options of the SDK.
 
 ```ts title="Announcement.js"
 import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
@@ -98,7 +100,8 @@ const addressType = 'p2sh20';
 
 // Instantiate a new contract using the compiled artifact and network provider
 // AND providing the constructor parameters (none)
-const contract = new Contract(artifact, [], , options:{ provider, addressType});
+const options = { provider, addressType};
+const contract = new Contract(artifact, [], options);
 
 // Display contract address, balance, opcount, and bytesize
 console.log('contract address:', contract.address);
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 4d08108a..71d8fd26 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -2,14 +2,14 @@
 title: Contract Instantiation
 ---
 
-Before interacting with smart contracts on the BCH network, the CashScript SDK needs to instantiate a `Contract` object. This is done by providing the contract's information and constructor arguments. After this instantiation, the CashScript SDK can interact with BCH contracts.
+Before interacting with a smart contract on the BCH network, the CashScript SDK needs to instantiate a `Contract` object. This is done by providing the contract's information and constructor arguments. After this instantiation, the CashScript SDK can interact with the BCH contract.
 
 :::note
 CashScript only offers a JavaScript SDK, but CashScript contracts can be integrated into other languages as well. Because there are no ready-to-use SDKs available for them, this is considered advanced usage.
 :::
 
 ## Contract class
-The `Contract` class is used to represent a CashScript contract in a JavaScript object. These objects can be used to retrieve information such as the contract's address and balance. They can be used to interact with the contract by calling the contract's functions.
+The `Contract` class is used to represent a CashScript contract in a JavaScript object. These objects can be used to retrieve information such as the contract's address and balance. They can also be used to interact with the contract by calling the contract's functions.
 
 ### Constructor
 ```ts
@@ -25,14 +25,14 @@ new Contract(
 
 A CashScript contract can be instantiated by providing an `Artifact` object, a list of constructor arguments, and optionally an options object configuring `NetworkProvider` and `addressType`.
 
-An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/language/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/basics/compiler) or programmatically with the `cashc` NPM package (see [CashScript Compiler](#cashscript-compiler)).
+An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/language/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/basics/compiler) or programmatically with the `cashc` NPM package (see [CashScript Compiler](/docs/basics/compiler#javascript-compilation)).
 
 The `NetworkProvider` option is used to manage network operations for the CashScript contract. By default, a mainnet `ElectrumNetworkProvider` is used, but the network providers can be configured. See the docs on [NetworkProvider](/docs/sdk/network-provider).
 
-The `addressType` option is used to choose between a `p2sh32` and `p2sh20` address for the CashScript contract. By default `p2sh32` is used because it has increased cryptographic security but it is not yet supported by all wallets.
+The `addressType` option is used to choose between a `p2sh20` and `p2sh32` address type for the CashScript contract. By default `p2sh32` is used because it has increased cryptographic security — but it is not yet supported by all wallets.
 
 :::caution
-P2sh32 was introduced because p2sh20 is cryptographically insecure for a large subset of smart contracts. For contracts holding large sums of BCH this provides an incentive to find a hash collision and hack the contract.
+p2sh32 was introduced because p2sh20 is cryptographically insecure for a large subset of smart contracts. For contracts holding large sums of BCH this provides an incentive to find a hash collision and hack the contract.
 :::
 
 #### Example
@@ -61,7 +61,7 @@ contract.address: string
 A contract's regular address (without token-support) can be retrieved through the `address` member field.
 
 :::note
-Wallets will not allow you to send CashTokens to this address, for that you must use the tokenAddress below. Wallets which have not upgraded might not recognize this new address type.
+Wallets will not allow you to send CashTokens to this address. For that you must use the [tokenAddress](#tokenaddress) below. Wallets which have not upgraded might not recognize this new address type.
 :::
 
 #### Example
@@ -156,7 +156,7 @@ contract.functions.<functionName>(...args: Argument[]): Transaction
 ```
 
 Once a smart contract has been instantiated, you can invoke a contract function to spend from the contract with the '[Simple transaction-builder](/docs/sdk/transactions)' by calling the function name under the `functions` member field of a contract object.
-To call these functions succesfully, the parameters provided to the function need to match ones defined in the CashScript code.
+To call these functions successfully, the provided parameters must match the function signature defined in the CashScript code.
 
 These contract functions return an incomplete `Transaction` object, which needs to be completed by providing outputs of the transaction. For more information see the [Simple transaction-builder](/docs/sdk/transactions) page.
 
@@ -177,7 +177,7 @@ contract.unlock.<functionName>(...args: Argument[]): Unlocker
 ```
 
 Once a smart contract has been instantiated, you can invoke a contract function on a smart contract UTXO to use the '[Advanced transaction-builder](/docs/sdk/transactions-advanced)' by calling the function name under the `unlock` member field of a contract object.
-To call these functions succesfully, the parameters provided to the function need to match ones defined in the CashScript code.
+To call these functions successfully, the provided parameters must match the function signature defined in the CashScript code.
 
 These contract functions return an incomplete `transactionBuilder` object, which needs to be completed by providing outputs of the transaction. For more information see the [Advanced transaction-builder](/docs/sdk/transactions-advanced) page.
 
@@ -194,7 +194,7 @@ transactionBuilder.addInput(contractUtxos[0], contract.unlock.spend());
 new SignatureTemplate(signer: Keypair | Uint8Array | string, hashtype?: HashType)
 ```
 
-You may notice the `SignatureTemplate` object in the example above. When a contract function has a `sig` parameter, it requires a cryptographic signature over the spending transaction. But to generate this signature, the transaction needs to be built first, which is not yet the case when a contract function is first called.
+You may notice the `SignatureTemplate` object in the [example](#example-8) above. When a contract function has a `sig` parameter, it requires a cryptographic signature over the spending transaction. But to generate this signature, the transaction needs to be built first, which is not yet the case when a contract function is first called.
 
 So in the place of a signature, a `SignatureTemplate` can be passed, which will automatically generate the correct signature using the `signer` parameter. This signer can be any representation of a private key, including [BCHJS' `ECPair`][ecpair], [bitcore-lib-cash' `PrivateKey`][privatekey], [WIF strings][wif], or raw private key buffers. This ensures that any BCH library can be used.
 
diff --git a/website/docs/sdk/network-provider.md b/website/docs/sdk/network-provider.md
index d4a8d08e..52edc1e3 100644
--- a/website/docs/sdk/network-provider.md
+++ b/website/docs/sdk/network-provider.md
@@ -97,7 +97,7 @@ All network functionality that the CashScript SDK needs is encapsulated in a net
 new MockNetworkProvider()
 ```
 
-The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. You can read more about the `MockNetworkProvider` and automated tests on the [testing-setup](/docs/sdk/testing-setup) page.
+The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. You can read more about the `MockNetworkProvider` and automated tests on the [testing setup](/docs/sdk/testing-setup) page.
 
 #### Example
 ```ts
@@ -108,13 +108,17 @@ provider.addUtxo(contractAddress, newUtxo);
 
 ### Other NetworkProviders
 
-There are two alternative network providers implemented. There is the `FullStackNetworkProvider` which uses [FullStack.cash][fullstack]' infrastructure to connect to the BCH network. There's also the `BitcoinRpcNetworkProvider` uses a direct connection to a Bitcoin Cash node. Currently neither supports CashTokens, so it is recommended to use the ElectrumNetworkProvider.
+There are two alternative network providers implemented:
+- `FullStackNetworkProvider`: uses [FullStack.cash][fullstack]' infrastructure to connect to the BCH network. 
+- `BitcoinRpcNetworkProvider`: uses a direct connection to a Bitcoin Cash node. 
+
+Currently neither supports CashTokens, so it is recommended to use the `ElectrumNetworkProvider`.
 
 ### Custom NetworkProviders
 A big strength of the NetworkProvider setup is that it allows you to implement custom providers. So if new BCH libraries are created in the future, it is simple to use them with CashScript. Custom NetworkProviders also potentially enables the CashScript SDK to be used with other (partially) compatible networks, such as BTC or BSV.
 
 :::info
-To implement a Custom NetworkProvider refer to the [NetworkProvider interface](https://github.com/CashScript/cashscript/blob/master/packages/cashscript/src/network/NetworkProvider.ts).
+To implement a Custom NetworkProvider, refer to the [NetworkProvider interface](https://github.com/CashScript/cashscript/blob/master/packages/cashscript/src/network/NetworkProvider.ts).
 :::
 
 
diff --git a/website/docs/sdk/testing-setup.md b/website/docs/sdk/testing-setup.md
index 5fe11b4c..6bd3d362 100644
--- a/website/docs/sdk/testing-setup.md
+++ b/website/docs/sdk/testing-setup.md
@@ -40,14 +40,14 @@ If you're using a different testing framework, you can test for `console.log` va
 
 ## Automated testing
 
-With local transaction evaluation and debugging, it is possible to write efficient automated tests for CashScript contracts and test specific contract behaviour and check `console.log` values and `require` error messages.
+With local transaction evaluation and debugging, it is possible to write efficient automated tests for CashScript contracts to test specific contract behaviour and check `console.log` values and `require` error messages.
 
 ### Logging values
 
-You can log values during debug evaluation using the `console.log` statement. Any variables or primitive values (such as ints, strings, bytes, etc) can be logged.
+You can log values during debug evaluation using the `console.log` statement. Any variables or primitive values (such as ints, strings, bytes, ...) can be logged.
 
 :::note
-Logging is only available in debug evaluation of a transaction, but has no impact on the compiled bytecode or regular (non-debug) execution.
+Logging is only available in debug evaluation of a transaction. It has no impact on the compiled bytecode or regular (non-debug) execution.
 :::
 
 ### Error messages
diff --git a/website/docs/sdk/transactions-advanced.md b/website/docs/sdk/transactions-advanced.md
index e3a4642e..1a29522d 100644
--- a/website/docs/sdk/transactions-advanced.md
+++ b/website/docs/sdk/transactions-advanced.md
@@ -2,7 +2,7 @@
 title: Advanced Transaction Builder
 ---
 
-With the introduction of newer smart contract features to BCH, such as native introspection and CashTokens, we've seen use cases for combining UTXOs of multiple different smart contracts within a single transaction - such as [Fex][fex]. The [simplified transaction builder][transactions-simple] only operates on a single smart contract, so to support more advanced use cases, you can use the Advanced Transaction Builder.
+With the introduction of newer smart contract features to BCH, such as native introspection and CashTokens, we've seen use cases for combining UTXOs of multiple different smart contracts within a single transaction — such as [Fex][fex]. The [simple transaction builder][transactions-simple] only operates on a single smart contract. To support more advanced use cases, you can use the Advanced Transaction Builder.
 
 The Advanced Transaction Builder supports adding UTXOs from any number of different smart contracts and P2PKH UTXOs. While the simplified transaction builder automatically selects UTXOs for you and adds change outputs, the advanced transaction builder requires you to provide the UTXOs yourself and manage change carefully.
 
@@ -35,7 +35,7 @@ const transactionBuilder = new TransactionBuilder({ provider });
 transactionBuilder.addInput(utxo: Utxo, unlocker: Unlocker, options?: InputOptions): this
 ```
 
-Adds a single input UTXOs to the transaction that can be unlocked using the provided unlocker. The unlocker can be derived from a `SignatureTemplate` or a `Contract` instance's spending functions. The `InputOptions` object can be used to specify the sequence number of the input.
+Adds a single input UTXO to the transaction that can be unlocked using the provided unlocker. The unlocker can be derived from a `SignatureTemplate` or a `Contract` instance's spending functions. The `InputOptions` object can be used to specify the sequence number of the input.
 
 :::note
 It is possible to create custom unlockers by implementing the `Unlocker` interface. Most use cases are covered by the `SignatureTemplate` and `Contract` classes.
@@ -125,7 +125,7 @@ transactionBuilder.addOutput({
 });
 
 transactionBuilder.addOutputs([
-  { to: aliceAddress, amount: 50_000n }
+  { to: aliceAddress, amount: 50_000n },
   { to: bobAddress, amount: 50_000n },
 ]);
 ```
@@ -135,7 +135,7 @@ transactionBuilder.addOutputs([
 transactionBuilder.addOpReturnOutput(chunks: string[]): this
 ```
 
-Adds an OP_RETURN output to the transaction with the provided data chunks in string format. If the string is `0x`-prefixed, it is treated as a hex string, otherwise it is treated as a UTF-8 string.
+Adds an OP_RETURN output to the transaction with the provided data chunks in string format. If the string is `0x`-prefixed, it is treated as a hex string. Otherwise it is treated as a UTF-8 string.
 
 #### Example
 ```ts
@@ -151,6 +151,11 @@ transactionBuilder.setLocktime(locktime: number): this
 
 Sets the locktime for the transaction to set a transaction-level absolute timelock (see [Timelock documentation][bitcoin-wiki-timelocks] for more information). The locktime can be set to a specific block height or a unix timestamp.
 
+#### Example
+```ts
+// Set locktime one day from now
+transactionBuilder.setLocktime(((Date.now() / 1000) + 24 * 60 * 60) * 1000);
+```
 
 ### setMaxFee()
 ```ts
diff --git a/website/docs/sdk/transactions.md b/website/docs/sdk/transactions.md
index bf78e786..7a2d8f1e 100644
--- a/website/docs/sdk/transactions.md
+++ b/website/docs/sdk/transactions.md
@@ -72,19 +72,19 @@ The built-in UTXO selection is generally sufficient. But there are specific use
 
 ### fromP2PKH()
 ```ts
-fromP2PKH(input: Utxo, template: SignatureTemplate): this;
-fromP2PKH(inputs: Utxo[], template: SignatureTemplate): this;
+transaction.fromP2PKH(input: Utxo, template: SignatureTemplate): this;
+transaction.fromP2PKH(inputs: Utxo[], template: SignatureTemplate): this;
 ```
 
 The `fromP2PKH()` function allows you to provide a list of P2PKH UTXOs to be used in the transaction. The passed `SignatureTemplate` is used to sign these UTXOs. This function can be called any number of times, and the provided UTXOs will be added to the list of earlier added UTXOs.
 
 :::note
-If you are using meep to debug a `fromP2PKH()` transaction, meep will always use the first input for the debugging. So if you want to debug the smart contract bytecode, make sure that the first input is not a P2PKH input.
+If you are using [meep](https://github.com/gcash/meep) to debug a `fromP2PKH()` transaction, meep will always use the first input for the debugging. So if you want to debug the smart contract bytecode, make sure that the first input is not a P2PKH input.
 :::
 
 #### Example
 ```ts
-import { bobAddress, bobPrivateKey } from 'somewhere';
+import { bobAddress, bobPrivateKey } from './somewhere';
 import { ElectrumNetworkProvider, SignatureTemplate } from 'cashscript';
 
 const provider = new ElectrumNetworkProvider();
@@ -165,12 +165,17 @@ The `withoutTokenChange()` function allows you to disable the change output for
 Be sure to check that the remaining amount (sum of inputs - sum of outputs) is not too high. The difference will be burned and cannot be reclaimed.
 :::
 
+#### Example
+```ts
+.withoutTokenChange()
+```
+
 ### withAge()
 ```ts
 transaction.withAge(age: number): this
 ```
 
-The `withAge()` function allows you to specify the minimum age of the transaction inputs. This is necessary if you want to to use the `tx.age` CashScript functionality, and the `age` parameter passed into this function will be the value of `tx.age` inside the smart contract. For more information, refer to [BIP68][bip68].
+The `withAge()` function allows you to specify the minimum age of the transaction inputs. This is necessary if you want to use the `tx.age` CashScript functionality. The `age` parameter passed into this function will be the value of `tx.age` inside the smart contract. For more information, refer to [BIP68][bip68].
 
 #### Example
 ```ts
@@ -248,7 +253,7 @@ If you want to debug a transaction locally instead of sending it to the network,
 
 If you prefer a lower-level debugging experience, you can call the `bitauthUri()` function on the transaction. This will return a URI that can be opened in the BitAuth IDE. This URI is also displayed in the console whenever a transaction fails.
 
-You can read more about debugging transactions [here](/docs/guides/debugging).
+You can read more about debugging transactions on the [debugging page](/docs/guides/debugging).
 
 :::caution
 It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
@@ -259,7 +264,7 @@ Transactions can fail for a number of reasons. Most of these are related to the
 
 This `Reason` enum only includes errors that are related to smart contract execution, so other reasons have to be caught separately. Besides the `Reason` enum, there are also several error classes that can be caught and acted on:
 
-* **`FailedRequireError`**, signifies a failed require statement. This includes the following reasons:
+* **`FailedRequireError`** signifies a failed require statement. This includes the following reasons:
   * `Reason.EVAL_FALSE`
   * `Reason.VERIFY`
   * `Reason.EQUALVERIFY`
@@ -267,10 +272,10 @@ This `Reason` enum only includes errors that are related to smart contract execu
   * `Reason.CHECKSIGVERIFY`
   * `Reason.CHECKDATASIGVERIFY`
   * `Reason.NUMEQUALVERIFY`
-* **`FailedTimeCheckError`**, signifies a failed time check using `tx.time` or `tx.age`. This includes the following reasons:
+* **`FailedTimeCheckError`** signifies a failed time check using `tx.time` or `tx.age`. This includes the following reasons:
   * `Reason.NEGATIVE_LOCKTIME`
   * `Reason.UNSATISFIED_LOCKTIME`
-* **`FailedSigCHeckError`**, signifies a failed signature check. This includes the following reasons:
+* **`FailedSigCHeckError`** signifies a failed signature check. This includes the following reasons:
   * `Reason.SIG_COUNT`
   * `Reason.PUBKEY_COUNT`
   * `Reason.SIG_HASHTYPE`
@@ -279,7 +284,7 @@ This `Reason` enum only includes errors that are related to smart contract execu
   * `Reason.SIG_NULLFAIL`
   * `Reason.SIG_BADLENGTH`
   * `Reason.SIG_NONSCHNORR`
-* **`FailedTransactionError`**, signifies a general fallback error. This includes all remaining reasons listed in the `Reason` enum as well as any other reasons unrelated to the smart contract execution.
+* **`FailedTransactionError`** signifies a general fallback error. This includes all remaining reasons listed in the `Reason` enum as well as any other reasons unrelated to the smart contract execution.
 
 ```ts
 enum Reason {
diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index a404c1fd..3557b3be 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -26,7 +26,7 @@ Tapswap is the first non-custodial marketplace to trade CashTokens, both fungibl
     <a href="https://bitcatsheroes.club/" target="_blank"><img src="/img/bitcats.png" /></a>
 </div>
 
-Bitcats Heroes is the first collectibele NFT series on Bitcoin Cash. The project uses CashScript for its non-custodial minting contract. This way the NFT minting guarantees fair access and a transparent NFT launch. The minting page uses a web3 wallet connect feature to allow minting directly from the user's smart contract wallet.
+Bitcats Heroes is the first collectible NFT series on Bitcoin Cash. The project uses CashScript for its non-custodial minting contract. This way the NFT minting guarantees fair access and a transparent NFT launch. The minting page uses a web3 wallet connect feature to allow minting directly from the user's smart contract wallet.
 
 ## Cash-Ninjas
 
@@ -34,7 +34,7 @@ Bitcats Heroes is the first collectibele NFT series on Bitcoin Cash. The project
     <a href="https://ninjas.cash/" target="_blank"><img style={{borderRadius: '100%'}} src="/img/cashninjas.jpg" /></a>
 </div>
 
-Cash-Ninjas is a collectibele NFT project on Bitcoin Cash which focuses on building open-source tooling! The Cash-Ninjas project uses CashScript for its non-custodial, multi-threaded minting contract. The contract is open source for others to inspect and use the contract code. The Cash-Ninjas minting page uses wallet connect to allow minting directly from the user's smart contract wallet.
+Cash-Ninjas is a collectible NFT project on Bitcoin Cash which focuses on building open-source tooling! The Cash-Ninjas project uses CashScript for its non-custodial, multi-threaded minting contract. The contract is open source for others to inspect and use the contract code. The Cash-Ninjas minting page uses wallet connect to allow minting directly from the user's smart contract wallet.
 
 ## BCH Guru
 
@@ -58,7 +58,7 @@ The CashTokens Studio is an application for creating CashTokens and for their ma
     <a href="https://badgers.cash/" target="_blank"><img style={{borderRadius: '100%'}} src="/img/badgers.png" /></a>
 </div>
 
-BadgerCoin is a fungible CashToken using a novel distibution mechanism. BadgerCoins are earned through staking Bitcoin Cash in the Badgers Smart Contract. The staking duration is predetermined, and depending on the stake amount and period you earn tokens. The website allows for anyone to invoce contract unlocks.
+BadgerCoin is a fungible CashToken using a novel distibution mechanism. BadgerCoins are earned through staking Bitcoin Cash in the Badgers Smart Contract. The staking duration is predetermined, and depending on the stake amount and period you earn tokens. The website allows for anyone to invoke contract unlocks.
 
 ## BCHouse
 
diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index 56ca1d04..fb588258 100755
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -33,9 +33,9 @@ const features = [
     title: 'DeFi on Bitcoin Cash',
     description: (
       <>
-        Bitcoin Cash has had many script upgrades on such as CashTokens and transaction introspection.
-        Because of this DeFi is very much possible on Bitcoin Cash.
-        However, compared to EVM smart contracts work very differently due to BCH's UTXO
+        Bitcoin Cash has had many script upgrades, such as CashTokens and transaction introspection.
+        Because of this, DeFi is very much possible on Bitcoin Cash.
+        However, compared to EVM, smart contracts work very differently due to BCH's UTXO
         architecture.
       </>
     ),
@@ -44,9 +44,9 @@ const features = [
     title: 'Integrated Tooling',
     description: (
       <>
-        CashScript offers integrated tooling through the Javascript SDK.
+        CashScript offers integrated tooling through the JavaScript SDK.
         The SDK has utilities for easy transaction building and other network functionality.
-        CashScript has built-in debug tooling comaptible with the Bitauth-IDE to offer the best developer experience.  
+        CashScript has built-in debug tooling compatible with the Bitauth-IDE to offer the best developer experience.  
       </>
     ),
   },

From e426857dda701188a7ea34c278bf18ad4d7ce82c Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 18 Jun 2024 15:58:04 +0200
Subject: [PATCH 077/267] improve timelock docs

---
 website/docs/language/globals.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/website/docs/language/globals.md b/website/docs/language/globals.md
index 7ee90d52..2459b1a9 100644
--- a/website/docs/language/globals.md
+++ b/website/docs/language/globals.md
@@ -32,33 +32,33 @@ It can be difficult to fully grasp the intricacies of time locks, so if you're s
 ### tx.time
 `tx.time` is used to create *absolute* time locks. The value of `tx.time` can either represent the block number of the spending transaction or its timestamp. When comparing it with values below `500,000,000`, it is treated as a blocknumber, while higher values are treated as a timestamp.
 
-Due to limitations in the underlying Bitcoin Script, `tx.time` can only be used in the following way:
+`tx.time` corresponds to the `nLocktime` field of the current transaction using the `OP_CHECKLOCKTIMEVERIFY` opcode. Because of this `tx.time` can only be used in the following way:
 
 ```solidity
 require(tx.time >= <expression>);
 ```
 
-Because of the way time locks work, **a corresponding time lock needs to be added to the transaction**. The CashScript SDK automatically sets this *transaction level* time lock to the most recent block number, as this is the most common use case. If you need to use a different block number or timestamp, this should be passed into the CashScript SDK using the [`withTime()`][withTime()] function. If the default matches your use case, **no additional actions are required**.
-
 :::note
-`tx.time` corresponds to the `nLocktime` field of the current transaction and the `OP_CHECKLOCKTIMEVERIFY` opcode.
+To access the value of the `nLocktime` field for assignment, use the `tx.locktime` introspection variable.
 :::
 
+Because of the way time locks work, **a corresponding time lock needs to be added to the transaction**. The CashScript SDK automatically sets this *transaction level* time lock to the most recent block number, as this is the most common use case. If you need to use a different block number or timestamp, this should be passed into the CashScript SDK using the [`withTime()`][withTime()] function. If the default matches your use case, **no additional actions are required**.
+
 ### tx.age
 `tx.age` is used to create *relative* time locks. The value of `tx.age` can either represent a number of blocks, or a number of *chunks*, which are 512 seconds. The corresponding *transaction level* time lock determines which of the two options is used.
 
-Due to limitations in the underlying Bitcoin Script, `tx.age` can only be used in the following way:
+`tx.age` corresponds to the `nSequence` field of the current *UTXO* using the `OP_CHECKSEQUENCEVERIFY` opcode. Because of this `tx.age` can only be used in the following way:
 
 ```solidity
 require(tx.age >= <expression>);
 ```
 
-Because of the way time locks work, **a corresponding time lock needs to be added to the transaction**. This can be done in the CashScript SDK using the [`withAge()`][withAge()] function. However, the value passed into this function will always be treated as a number of blocks, so **it is currently not supported to use `tx.age` as a number of second chunks**.
-
 :::note
-`tx.age` corresponds to the `nSequence` field of the current *UTXO* and the `OP_CHECKSEQUENCEVERIFY` opcode.
+To access the value of the `nSequence` field for assignment, use the `tx.inputs[i].sequenceNumber` introspection variable.
 :::
 
+Because of the way time locks work, **a corresponding time lock needs to be added to the transaction**. This can be done in the CashScript SDK using the [`withAge()`][withAge()] function. However, the value passed into this function will always be treated as a number of blocks, so **it is currently not supported to use `tx.age` as a number of second chunks**.
+
 ## Introspection variables
 Introspection functionality is used to create *covenant* contracts. Covenants are a technique used to put constraints on spending the money inside a smart contract. The main use case of this is limiting the addresses where money can be sent and the amount sent. To explore the possible uses of covenants inside smart contracts, read the [CashScript Covenants Guide][covenants-guide].
 
@@ -89,10 +89,10 @@ Represents the version of the current transaction. Different transaction version
 int tx.locktime
 ```
 
-Represents the `nLocktime` field of the transaction.
+Represents the `nLocktime` field of the transaction. This is similar to the [`tx.time`][tx.time] global variable but `tx.time` can only be used in `require` statements, not for variable declaration.
 
-:::note
-`tx.locktime` is similar to the [`tx.time`][tx.time] global variable. It is recommended to only use `tx.locktime` for adding `nLocktime` to simulated state and [`tx.time`][tx.time] in all other cases.
+:::tip
+ The usecase for `tx.locktime` is to read the `nLocktime` value and add to the local state. Example usage for this is demonstrated in the [Sablier example](/docs/guides/covenants#keeping-local-state-in-nfts).
 :::
 
 ### tx.inputs

From 136f1b97234dea2b4d67def95b0a76b15663b626 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 21 Jun 2024 19:19:07 +0200
Subject: [PATCH 078/267] add the compiled code for TransferWithTimeout

---
 website/docs/basics/getting-started.md |  6 +++++-
 website/docs/guides/debugging.md       | 28 ++++++++++++++++++++++++++
 2 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index d7f5df8c..49b393ab 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -73,7 +73,11 @@ The next step after writing your smart contract is using the command line compil
 cashc ./TransferWithTimeout.cash --output ./TransferWithTimeout.json
 ```
 
-This will create an artifact file `TransferWithTimeout.json` from your CashScript file. It can be helpful to take a look at the generated artifact file to understand what the `cashc` compiler is generating.
+This will create an artifact file `TransferWithTimeout.json` from your CashScript file. If you look at the `bytecode` property on the artifact you will see the raw BCH script generated by the `cashc` compiler:
+
+```
+OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_ROLL OP_ROT OP_CHECKSIG OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_2DROP OP_1 OP_ENDIF
+```
 
 ## Creating a CashScript Transaction
 
diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 9930cb33..2e041bc0 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -44,6 +44,32 @@ const uri = await transaction.bitauthUri();
 It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
 :::
 
+The Bithauth IDE will show you the two-way mapping between the CashScript contract code generated opcodes. Here is [a Bithauth IDE link][BitauthIDE] for the basic `TransferWithTimeout` contract as an example:
+
+```js
+// "TransferWithTimeout" contract constructor parameters
+<timeout> // int = <0x07>
+<recipient> // pubkey = <0x0262f5c18adf3d9800c18b5e63fa6505ec8eb1d49c65855d62aea698425a39966e>
+<sender> // pubkey = <0x0262f5c18adf3d9800c18b5e63fa6505ec8eb1d49c65855d62aea698425a39966e>
+
+// bytecode
+                                                /* pragma cashscript >= 0.10.0;                                                  */
+                                                /*                                                                              */
+                                                /* contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) { */
+                                                /*     // Require recipient's signature to match                                */
+OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                    */
+OP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                          */
+OP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                        */
+                                                /*                                                                              */
+                                                /*     // Require timeout time to be reached and sender's signature to match    */
+OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                        */
+OP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                                */
+OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                         */
+OP_1 OP_NIP                                     /*     }                                                                        */
+OP_ENDIF                                        /* }                                                                            */
+                                                /*      
+```
+
 ## Advanced Transaction Builder
 
 Because the advanced transaction builder does not yet support the advanced debugging tooling, you are left with just a few strategies.
@@ -61,3 +87,5 @@ To use this strategy effectively, the contract setup with funding should be auto
 ### Single Check Contract
 
 If it is unclear whether the issue is the contract invocation or the `require` statement in the CashScript file, it might prove handy to create a 'single-check' contract, which has only the previously failing `require` statement. The goal then is to discover if your transaction is the issue, and you are violating a correct contract requirement, or whether the contract is enforcing an incorrect/impossible condition to hold in the spending transaction.
+
+[BitauthIDE]: https://ide.bitauth.com/import-template/eJzVWG1v2zYQ_isCMWBJ4drUG21lbYAmcRsjaZIl6YqhDgyKomItNuVRVJbA8H_fUe9-qeF06Yfxg0WRvLvnjs9RR8_RLwkb8ylFB2is1Cw56HSigLf9SNFUjdssnnZ0hwsVMaqiWLxVfDqbUMXfPuJ2Ltv-K4kFaqGAJ0xGM70K1A2ms1gqHhihjKcGo8k4n4WFgk45rLiVVCQhl18jNb6NpjxO9WSSznJBdPANHR2fjixs2SPsorsWeuQyybTjFtKQVMQTdDBHMypBpYJZ_baM4zgWSlKmDCZ55oFBBYBKBcteGqIVsKWxXFei0Uxi9gAjqdCdUfamQVEZUX-SI5GcRbMIsI2S6H4dzLBecBPdD1Ft3ojDGtQQqSI2Q1TDaorCqHqe6dEz_owWAJOLgMtNFvOZVVtqHCUGK2JT2yjUVNq_0smEqxOqqDZSIdjq2Y6mamXfsaYKTmywVUztaElV5Npopwz7KALfn9bN3WT9eneyZYaKDf7EWap4bWhF00Z70Bqkmi-xKaNykvCMbfyRTlJItFGpVZOtMJQLVeyEkU5niTWbCD4U75boqdNXxFLqvqAqlbwNOEcQqVmqkkMDVMLMUAwF9Fa8j0QVZ1C77HcmGQllvDfe4cOhqFIG3MpzCCJQ-qufkbi_zQM1s5KxbdUB3ejlhnMDHGZVnsciUTJlKpbLzhc0WIL3hLuHzbhkk7PUf-DPxbxFrNBlZo8GoR14PYyh77uc2CElLnY563HfDByPEbfnugGxKKfE6zmWS23PI4Rr_Xla_Rzl2fb4z4qzOOBDYbywdd4YM0nvp7RxRhuH7w3c7rXxby_VZhhvOj-E4VXbD2KoKLSBYXvFvuU72Sq3sSJOK6NUQbF9Y_5f4gD7ec3_TiPJa_2_JkaVpvrsmVLFxrvE4fJqZBvwczU4PtNPrH8uvnzu__7lw7nuDz5uwlDle3mm7IF5o_kJ0k7u0AoMjjZ1fXmembSaL8en_eOzm8GndQy6yTwQe1BpsAewuteE0KoB7e9v4WqB4WJwZaw9-uc3_U0yBYbFLj7u0v7HeZE9ak4WJM-emoq-pimFDQqy0irPkO_ytcnJkgLmKif_6F8PPv65iqHmZJGTmpK5ud35uBXDGidrLNs4WWFoFXC2snEJw7rZ88vjs9vB535hF4ZPri-vmnFoYlBP7Wwf4MQuD5_dD-0mBp0Ou7SfkRc6DS9OVg6i7RhezX6J4aUyr5-bKK8MuYALRZzVhuslIAwWpVG_mFu7eH0QUJhSuKRxo5DXKfPPmOtE1AVy8Y3Pq9e8RNQ1Z1tr0iUq2CjLCd0vbxboNeoVtHSJeC2V1U1BK-yi9ZIeYV1zslRKsHukq8pTHt2PQcJaHtZfe3Rgds1e1_QcDLPwlc_vmDJ6hHCfFa8rFz3EnYAwSrnjmbbj-TYLzSBgVkg8jK0uDT3sU9-1AuZzjwQMRm2XEmb1HOLTrk1Qdi_IPra02upI6EocLgNzpKvyGEqMQe6Q2apGbmuZU6jgAItHHdMnNMDEcmyn1w2xF1oEguoHDrFcn1gcez4Ofdt1Qs58gu3ANonjEerYZtDTFTccL1wwfpFOfb35juXBdBd-y2IeivajiiXfUDKJFbpb3OWVvcrCaGGX2FaOtPRjTXS-0FfoScpvqIoT4Cc4hzFetHZb27U9Z9H8a8DSSRSnkvHLbWZLxGsKe8TrLu5gN_4FON-z9w==

From 53669cff6f5b39f7fe6241c8294152878aed43e6 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 25 Jun 2024 09:25:15 +0200
Subject: [PATCH 079/267] use sidebars.js instead of auto-generated sidebar

---
 website/docusaurus.config.js | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
index ffe5c2f8..ffef06c8 100755
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@@ -104,6 +104,9 @@ module.exports = {
         theme: {
           customCss: require.resolve('./src/css/custom.css'),
         },
+        docs: {
+          sidebarPath: './sidebars.js',
+        },
       },
     ],
   ],

From bca4580823640b82e829a3e73f922fcbea67f11c Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 25 Jun 2024 11:55:19 +0200
Subject: [PATCH 080/267] Add *all* require statements to artifact, not only
 the ones with messages

---
 examples/testing-suite/artifacts/example.json |   4 +-
 packages/cashc/src/compiler.ts                |   2 +-
 .../src/generation/GenerateTargetTraversal.ts |  36 +++---
 packages/cashc/test/generation/fixtures.ts    | 106 +++++++++++++++---
 .../cashscript/test/fixture/announcement.json |  23 +++-
 packages/cashscript/test/fixture/bigint.json  |  15 ++-
 .../test/fixture/bounded_bytes.json           |  11 +-
 .../cashscript/test/fixture/hodl_vault.json   |  27 ++++-
 packages/cashscript/test/fixture/mecenas.json |  35 +++++-
 .../cashscript/test/fixture/p2palindrome.json |  11 +-
 packages/cashscript/test/fixture/p2pkh.json   |  15 ++-
 .../test/fixture/simple_covenant.json         |  31 ++++-
 .../fixture/token_category_comparison.json    |  11 +-
 .../test/fixture/transfer_with_timeout.json   |  19 +++-
 packages/utils/src/artifact.ts                |   6 +-
 website/docs/language/artifacts.md            |   2 +-
 16 files changed, 277 insertions(+), 77 deletions(-)

diff --git a/examples/testing-suite/artifacts/example.json b/examples/testing-suite/artifacts/example.json
index bac84de7..36e61dcd 100644
--- a/examples/testing-suite/artifacts/example.json
+++ b/examples/testing-suite/artifacts/example.json
@@ -30,7 +30,7 @@
         ]
       }
     ],
-    "requireMessages": [
+    "requires": [
       {
         "ip": 4,
         "line": 4,
@@ -43,4 +43,4 @@
     "version": "0.10.0-next.3"
   },
   "updatedAt": "2024-04-15T03:55:07.781Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index adfde685..d1b3d7ef 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -34,7 +34,7 @@ export function compileString(code: string): Artifact {
     bytecode: binToHex(scriptToBytecode(traversal.output)),
     sourceMap: traversal.sourceMap,
     logs: traversal.consoleLogs,
-    requireMessages: traversal.requireMessages,
+    requires: traversal.requires,
   };
 
   return generateArtifact(ast, optimisedBytecode, code, debug);
diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index b6566a4d..55eff7e8 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -13,7 +13,7 @@ import {
   generateSourceMap,
   FullLocationData,
   LogEntry,
-  RequireMessage,
+  RequireStatement,
   PositionHint,
   SingleLocationData,
   StackItem,
@@ -65,7 +65,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   output: Script = [];
   stack: string[] = [];
   consoleLogs: LogEntry[] = [];
-  requireMessages: RequireMessage[] = [];
+  requires: RequireStatement[] = [];
   finalStackUsage: Record<string, StackItem> = {};
 
   private scopeDepth = 0;
@@ -285,16 +285,13 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     node.expression = this.visit(node.expression);
     this.emit(compileTimeOp(node.timeOp), { location: node.location, positionHint: PositionHint.END });
 
-    // TODO: Same comment as in require
-    if (node.message) {
-      this.requireMessages.push({
-        // We're removing 1 from the IP because the error message needs to match the OP_XXX_VERIFY, not the OP_DROP that
-        // is emitted directly after
-        ip: this.getMostRecentInstructionPointer() - 1,
-        line: node.location.start.line,
-        message: node.message,
-      });
-    }
+    this.requires.push({
+      // We're removing 1 from the IP because the error message needs to match the OP_XXX_VERIFY, not the OP_DROP that
+      // is emitted directly after
+      ip: this.getMostRecentInstructionPointer() - 1,
+      line: node.location.start.line,
+      message: node.message,
+    });
 
     this.popFromStack();
     return node;
@@ -305,16 +302,11 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
     this.emit(Op.OP_VERIFY, { location: node.location, positionHint: PositionHint.END });
 
-    // TODO: Add *all* require messages to the artifact, so we can report on line number for the failed require(),
-    // even if there is no message in the require() call
-    // TODO: We don't even have to display the Libauth message if we just say "this and this require failed"
-    if (node.message) {
-      this.requireMessages.push({
-        ip: this.getMostRecentInstructionPointer(),
-        line: node.location.start.line,
-        message: node.message,
-      });
-    }
+    this.requires.push({
+      ip: this.getMostRecentInstructionPointer(),
+      line: node.location.start.line,
+      message: node.message,
+    });
 
     this.popFromStack();
     return node;
diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index 3e6a1788..565a6be7 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -23,7 +23,10 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '5179a9517a8769517a517aac',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 7, line: 3 },
+          { ip: 13, line: 4 },
+        ],
         sourceMap: '3:24:3:26;;:16::27:1;:31::34:0;;:16:::1;:8::36;4:25:4:26:0;;:28::30;;:16::31:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/p2pkh.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -59,7 +62,11 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '5a54940114517a529793007a517aa0690b48656c6c6f20576f726c640079527a7e5279a6517aa68769527a527aac77',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 16, line: 5 },
+          { ip: 30, line: 10 },
+          { ip: 36, line: 11 },
+        ],
         sourceMap: '3:25:3:27;:30::31;:25:::1;4:30:4:32:0;:35::45;;:48::49;:35:::1;:30;5:16:5:31:0;;:34::35;;:16:::1;:8::37;7:20:7:33:0;8:13:8:15;;:18::19;;:13:::1;10:26:10:28:0;;:16::29:1;:43::45:0;;:33::46:1;:16;:8::48;11:25:11:26:0;;:28::30;;:16::31:1;2:4:12:5',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/reassignment.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -101,7 +108,11 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '527954799300795479940079537a52949c6300795579935479517993527a757c00795279a0697567007954799c69680079547a93007a537a9c777777',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 39, line: 8 },
+          { ip: 47, line: 10 },
+          { ip: 59, line: 13 },
+        ],
         sourceMap: '3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:24:9:9;9:15:11::0;10:20:10:21;;:25::26;;:20:::1;:12::28;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;2:4:14:5;;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/if_statement.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -137,7 +148,11 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '5379009c63547a527aac77777767537a519c69537a517aac69517ab175517768',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 13, line: 7 },
+          { ip: 27, line: 11 },
+          { ip: 30, line: 12 },
+        ],
         sourceMap: '6:4:8:5;;;;;7:25:7:37;;:39::48;;:16::49:1;6:4:8:5;;;;10::13::0;;;;;11:25:11:34;;:36::42;;:16::43:1;:8::45;12:27:12:34:0;;:8::36:1;;10:4:13:5;;1:0:14:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/multifunction.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -204,7 +219,12 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '5279009c63537955799300795579940079537a9c6300795679935579517993527a757c00795279a06975675479517a75680079557a93007a537a9c69517777777767527a519c695279007952930079537a9c6300795479930079527993527a757c00795279a0697568537a007a537a9c777768',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 42, line: 8 },
+          { ip: 61, line: 13 },
+          { ip: 104, line: 22 },
+          { ip: 114, line: 25 },
+        ],
         sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:12:::1;:20:9:9:0;6::6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:20:9:9;9:15:11::0;10:16:10:17;;:12::18;;;9:15:11:9:1;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;:8::24;2:4:14:5;;;;;;16::26::0;;;;;17:16:17:17;;18:12:18:13;;:16::17;:12:::1;19::19:13:0;;:17::18;;:12:::1;:20:23:9:0;20::20:21;;:24::25;;:20:::1;21:16:21:17:0;;:20::21;;:16:::1;:12::22:0;;;;22:20:22:21;;:24::25;;:20:::1;:12::27;19:20:23:9;;24:12:24:13:0;;25:16:25:17;;:21::22;;:16:::1;16:4:26:5;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/multifunction_if_statements.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -227,7 +247,7 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '00547a557a52547a557a567a53ae',
         logs: [],
-        requireMessages: [],
+        requires: [{ ip: 17, line: 3 }],
         sourceMap: '3:12:3:52;:27::29;;:31::33;;:26::34:1;:37::40:0;;:42::45;;:47::50;;:36::51:1;:12::52',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/2_of_3_multisig.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -254,7 +274,10 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '00795179827752967f7700795279879169517a547f75517a8791',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 17, line: 4 },
+          { ip: 27, line: 5 },
+        ],
         sourceMap: '3:18:3:19;;:26::27;;:::34;;:37::38;:26:::1;:18::39;:::42;4:16:4:17:0;;:21::22;;:16:::1;;:8::24;5:16:5:17:0;;:24::25;:16::26:1;:::29;:33::34:0;;:16:::1;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/split_size.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -279,7 +302,10 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '0079a600a98751918769517a517aac',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 9, line: 3 },
+          { ip: 15, line: 4 },
+        ],
         sourceMap: '3:33:3:35;;:17::37:1;:49::51:0;:41::52:1;:17;:57::61:0;:56;:17:::1;:8::64;4:25:4:26:0;;:28::30;;:16::31:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/cast_hash_checksig.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -330,7 +356,13 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '5679547f517a81517a815179557aa269517ab175007a537aa269537a547a537aba69517a517aac',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 19, line: 19 },
+          { ip: 22, line: 20 },
+          { ip: 29, line: 23 },
+          { ip: 37, line: 26 },
+          { ip: 43, line: 31 },
+        ],
         sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;;:26::45:1;16:24:16:32:0;;:20::33:1;19:16:19:27:0;;:31::39;;:16:::1;:8::41;20:27:20:38:0;;:8::40:1;;23:16:23:21:0;;:25::36;;:16:::1;:8::38;27:12:27:21:0;;28::28:25;;29::29:20;;26:16:30:9:1;:8::11;31:25:31:33:0;;:35::42;;:16::43:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/hodl_vault.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -362,7 +394,7 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '5152535455565579539f6353567a757c6b7c6b7c6b7c6b7c6c6c6c6c68557a557a557a93547a93537a93527a93a0',
         logs: [],
-        requireMessages: [],
+        requires: [{ ip: 46, line: 14 }],
         sourceMap: '3:16:3:17;4::4;5::5;6::6;7::7;8::8;10:12:10:13;;:16::17;:12:::1;:19:12:9:0;11:16:11:17;:12::18;;;;;;;;;;;;;;;;10:19:12:9:1;14:16:14:17:0;;:20::21;;:24::25;;:20:::1;:28::29:0;;:20:::1;:32::33:0;;:20:::1;:36::37:0;;:20:::1;:16',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/deep_replace.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -383,7 +415,7 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '007a517a548087',
         logs: [],
-        requireMessages: [],
+        requires: [{ ip: 7, line: 3 }],
         sourceMap: '3:16:3:17;;:28::29;;:21::30:1;;:16',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/bounded_bytes.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -413,7 +445,10 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: 'c2517a9c69c1010087',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 5, line: 3 },
+          { ip: 9, line: 4 },
+        ],
         sourceMap: '3:16:3:26;:30::45;;:16:::1;:8::47;4:16:4:35:0;:39::43;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/covenant.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -474,7 +509,28 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: 'c2529c69c5009c69c3519c69c4519c69c0009c69c18277022c019c6900c60210279c6900c782770210279c6900c8200000000000000000000000000000000000000000000000000000000000000000876900c9009c6900ca827701649c6900cb009c6900cc0210279c6900cd827701649c6900ce200000000000000000000000000000000000000000000000000000000000000000876900cf0100876900d001649c6900d1200000000000000000000000000000000000000000000000000000000000000000876900d20100876900d301649c',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 3, line: 3 },
+          { ip: 7, line: 4 },
+          { ip: 11, line: 5 },
+          { ip: 15, line: 6 },
+          { ip: 19, line: 7 },
+          { ip: 25, line: 8 },
+          { ip: 30, line: 9 },
+          { ip: 37, line: 10 },
+          { ip: 42, line: 11 },
+          { ip: 47, line: 12 },
+          { ip: 54, line: 13 },
+          { ip: 59, line: 14 },
+          { ip: 64, line: 15 },
+          { ip: 71, line: 16 },
+          { ip: 76, line: 17 },
+          { ip: 81, line: 18 },
+          { ip: 86, line: 19 },
+          { ip: 91, line: 20 },
+          { ip: 96, line: 21 },
+          { ip: 101, line: 22 },
+        ],
         sourceMap: '3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:27:0;:31::32;:16:::1;:8::34;5:16:5:32:0;:36::37;:16:::1;:8::39;6:16:6:33:0;:37::38;:16:::1;:8::40;7:16:7:37:0;:41::42;:16:::1;:8::44;8:16:8:35:0;:::42;;:46::49;:16:::1;:8::51;9:26:9:27:0;:16::34;:38::43;:16:::1;:8::45;10:26:10:27:0;:16::44;:::51;;:55::60;:16:::1;:8::62;11:26:11:27:0;:16::52;:56::121;:16:::1;:8::123;12:26:12:27:0;:16::42;:46::47;:16:::1;:8::49;13:26:13:27:0;:16::46;:::53;;:57::60;:16:::1;:8::62;14:26:14:27:0;:16::43;:47::48;:16:::1;:8::50;15:27:15:28:0;:16::35;:39::44;:16:::1;:8::46;16:27:16:28:0;:16::45;:::52;;:56::59;:16:::1;:8::61;17:26:17:27:0;:16::42;:46::111;:16:::1;:8::113;18:26:18:27:0;:16::42;:46::50;:16:::1;:8::52;19:26:19:27:0;:16::40;:44::47;:16:::1;:8::49;20:27:20:28:0;:16::43;:47::112;:16:::1;:8::114;21:27:21:28:0;:16::43;:47::51;:16:::1;:8::53;22:27:22:28:0;:16::41;:45::48;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/covenant_all_fields.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -539,7 +595,16 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '5479009c63537ab27500cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767547a519c695479a9527a8769547a547aac77777768',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 11, line: 3 },
+          { ip: 22, line: 6 },
+          { ip: 51, line: 15 },
+          { ip: 58, line: 17 },
+          { ip: 64, line: 18 },
+          { ip: 70, line: 19 },
+          { ip: 91, line: 24 },
+          { ip: 97, line: 25 },
+        ],
         sourceMap: '2:4:21:5;;;;;3:26:3:32;;:8::34:1;;6:27:6:28:0;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;8:23:8:27:0;9:37:9:58;:27::65;10:26:10:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;16:15:20:9:0;17:31:17:32;:20::39;:43::49;;:20:::1;:12::51;18:31:18:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;19:31:19:32:0;:20::39;:43::54;;:20:::1;:12::56;16:15:20:9;2:4:21:5;;;;;;;;23::26::0;;;;;24:24:24:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/mecenas.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -584,7 +649,12 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009c6900cd517a876902e803c0c65179940079527aa26351cdc0c7876951cc51799c69685177',
         logs: [],
-        requireMessages: [],
+        requires: [
+          { ip: 23, line: 16 },
+          { ip: 29, line: 17 },
+          { ip: 47, line: 24 },
+          { ip: 53, line: 25 },
+        ],
         sourceMap: '10:29:13:10;11:12:11:18;;;;;12:18:12:118;:12::119;;;;;;;;;;;;16:27:16:28;:16::35;:39::40;:16:::1;:8::42;17:27:17:28:0;:16::45;:49::61;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65;:68::76;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49;:63::84;:53::101;:20:::1;:12::103;25:31:25:32:0;:20::39;:43::55;;:20:::1;:12::57;23:38:26:9;8:4:27:5;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/announcement.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -607,7 +677,7 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '0079bc517a87',
         logs: [],
-        requireMessages: [],
+        requires: [{ ip: 6, line: 3 }],
         sourceMap: '3:16:3:26;;:::36;:40::50;;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/p2palindrome.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -630,7 +700,7 @@ export const fixtures: Fixture[] = [
       debug: {
         bytecode: '5a517a80007a815a9c',
         logs: [],
-        requireMessages: [],
+        requires: [{ ip: 9, line: 4 }],
         sourceMap: '3:28:3:30;:32::36;;:22::37;4:20:4:25;;:16::26:1;:30::32:0;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/num2bin_variable.cash', import.meta.url), { encoding: 'utf-8' }),
@@ -656,7 +726,7 @@ export const fixtures: Fixture[] = [
           { data: [{ stackIndex: 0, type: 'int', ip: 5 }, 'test'], ip: 5, line: 4 },
           { data: [{ stackIndex: 0, type: 'int', ip: 5 }, 'test2'], ip: 5, line: 5 },
         ],
-        requireMessages: [{ ip: 4, line: 3, message: 'Wrong value passed' }, { ip: 11, line: 6, message: 'Sum doesn\'t work' }],
+        requires: [{ ip: 4, line: 3, message: 'Wrong value passed' }, { ip: 11, line: 6, message: 'Sum doesn\'t work' }],
         sourceMap: '3:12:3:17;;:21::22;:12:::1;:4::46;6:12:6:17:0;;:20::21;:12:::1;:25::26:0;:12:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/debug_messages.cash', import.meta.url), { encoding: 'utf-8' }),
diff --git a/packages/cashscript/test/fixture/announcement.json b/packages/cashscript/test/fixture/announcement.json
index 5818dacc..55611351 100644
--- a/packages/cashscript/test/fixture/announcement.json
+++ b/packages/cashscript/test/fixture/announcement.json
@@ -13,11 +13,28 @@
     "bytecode": "016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009c6900cd517a876902e803c0c65179940079527aa26351cdc0c7876951cc51799c69685177",
     "sourceMap": "10:29:13:10;11:12:11:18;;;;;12:18:12:118;:12::119;;;;;;;;;;;;16:27:16:28;:16::35;:39::40;:16:::1;:8::42;17:27:17:28:0;:16::45;:49::61;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65;:68::76;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49;:63::84;:53::101;:20:::1;:12::103;25:31:25:32:0;:20::39;:43::55;;:20:::1;:12::57;23:38:26:9;8:4:27:5;",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 23,
+        "line": 16
+      },
+      {
+        "ip": 29,
+        "line": 17
+      },
+      {
+        "ip": 47,
+        "line": 24
+      },
+      {
+        "ip": 53,
+        "line": 25
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:54.938Z"
+  "updatedAt": "2024-06-25T09:01:16.154Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index 6823b72a..d55eaebf 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -22,11 +22,20 @@
     "bytecode": "05000000800051795179a269517a527a95517aa2",
     "sourceMap": "3:30:3:40;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 6,
+        "line": 4
+      },
+      {
+        "ip": 15,
+        "line": 5
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:54.678Z"
+  "updatedAt": "2024-06-25T09:01:15.899Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index e9537cd6..a182d87a 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -22,11 +22,16 @@
     "bytecode": "007a517a548087",
     "sourceMap": "3:16:3:17;;:28::29;;:21::30:1;;:16",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 7,
+        "line": 3
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:55.720Z"
+  "updatedAt": "2024-06-25T09:01:10.912Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index b82200dc..a3ab0568 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -43,11 +43,32 @@
     "bytecode": "5679547f517a81517a815179557aa269517ab175007a537aa269537a547a537aba69517a517aac",
     "sourceMap": "14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;;:26::45:1;16:24:16:32:0;;:20::33:1;19:16:19:27:0;;:31::39;;:16:::1;:8::41;20:27:20:38:0;;:8::40:1;;23:16:23:21:0;;:25::36;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:16::64:1;:8::66;27:25:27:33:0;;:35::42;;:16::43:1",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 19,
+        "line": 19
+      },
+      {
+        "ip": 22,
+        "line": 20
+      },
+      {
+        "ip": 29,
+        "line": 23
+      },
+      {
+        "ip": 37,
+        "line": 26
+      },
+      {
+        "ip": 43,
+        "line": 27
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:55.179Z"
+  "updatedAt": "2024-06-25T09:01:16.379Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index 94a8c042..8f162076 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -39,11 +39,40 @@
     "bytecode": "5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768",
     "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 17,
+        "line": 13
+      },
+      {
+        "ip": 46,
+        "line": 22
+      },
+      {
+        "ip": 53,
+        "line": 24
+      },
+      {
+        "ip": 59,
+        "line": 25
+      },
+      {
+        "ip": 65,
+        "line": 26
+      },
+      {
+        "ip": 86,
+        "line": 31
+      },
+      {
+        "ip": 92,
+        "line": 32
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:56.951Z"
+  "updatedAt": "2024-06-25T09:01:12.107Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index 2aa03066..017131c3 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -18,11 +18,16 @@
     "bytecode": "0079bc517a87",
     "sourceMap": "3:16:3:26;;:::36;:40::50;;:16:::1",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 6,
+        "line": 3
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:55.474Z"
+  "updatedAt": "2024-06-25T09:01:16.592Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index cab6b31e..9ee43904 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -27,11 +27,20 @@
     "bytecode": "5179a9517a8769517a517aac",
     "sourceMap": "4:24:4:26;;:16::27:1;:31::34:0;;:16:::1;:8::36;5:25:5:26:0;;:28::30;;:16::31:1",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 7,
+        "line": 4
+      },
+      {
+        "ip": 13,
+        "line": 5
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:56.694Z"
+  "updatedAt": "2024-06-25T09:01:11.867Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/simple_covenant.json b/packages/cashscript/test/fixture/simple_covenant.json
index 50f98d7f..3c4d8bf8 100644
--- a/packages/cashscript/test/fixture/simple_covenant.json
+++ b/packages/cashscript/test/fixture/simple_covenant.json
@@ -13,11 +13,36 @@
     "bytecode": "c252a269c351a269c451a269c182770208029f6900c6022202a26900cc022202a2",
     "sourceMap": "3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:32:0;:36::37;:16:::1;:8::39;5:16:5:33:0;:37::38;:16:::1;:8::40;6:16:6:35:0;:::42;;:45::48;:16:::1;:8::50;7:26:7:27:0;:16::34;:38::41;:16:::1;:8::43;8:27:8:28:0;:16::35;:39::42;:16:::1",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 3,
+        "line": 3
+      },
+      {
+        "ip": 7,
+        "line": 4
+      },
+      {
+        "ip": 11,
+        "line": 5
+      },
+      {
+        "ip": 17,
+        "line": 6
+      },
+      {
+        "ip": 22,
+        "line": 7
+      },
+      {
+        "ip": 27,
+        "line": 8
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:55.963Z"
+  "updatedAt": "2024-06-25T09:01:11.138Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/token_category_comparison.json b/packages/cashscript/test/fixture/token_category_comparison.json
index 2cd5d9ef..2c4460e7 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.json
+++ b/packages/cashscript/test/fixture/token_category_comparison.json
@@ -13,11 +13,16 @@
     "bytecode": "51ce0087",
     "sourceMap": "3:26:3:27;:16::42;:46::48;:16:::1",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 4,
+        "line": 3
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:56.440Z"
+  "updatedAt": "2024-06-25T09:01:11.613Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index 2ce57cd9..4de9b0a9 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -40,11 +40,24 @@
     "bytecode": "5379009c63547a527aac77777767537a519c69537a517aac69517ab175517768",
     "sourceMap": "7:4:9:5;;;;;8:25:8:37;;:39::48;;:16::49:1;7:4:9:5;;;;12::15::0;;;;;13:25:13:34;;:36::42;;:16::43:1;:8::45;14:27:14:34:0;;:8::36:1;;12:4:15:5;;1:0:16:1",
     "logs": [],
-    "requireMessages": []
+    "requires": [
+      {
+        "ip": 13,
+        "line": 8
+      },
+      {
+        "ip": 27,
+        "line": 13
+      },
+      {
+        "ip": 30,
+        "line": 14
+      }
+    ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.5"
   },
-  "updatedAt": "2024-03-19T06:40:56.204Z"
+  "updatedAt": "2024-06-25T09:01:11.370Z"
 }
\ No newline at end of file
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index 3279ba69..0c5814ac 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -15,7 +15,7 @@ export interface DebugInformation {
   bytecode: string; // unlike `bytecode` property above, this is a hex-encoded binary string
   sourceMap: string; // see documentation for `generateSourceMap`
   logs: LogEntry[]; // log entries generated from `console.log` statements
-  requireMessages: RequireMessage[]; // messages for failing `require` statements
+  requires: RequireStatement[]; // messages for failing `require` statements
 }
 
 export interface LogEntry {
@@ -32,10 +32,10 @@ export interface StackItem {
 
 export type LogData = StackItem | string;
 
-export interface RequireMessage {
+export interface RequireStatement {
   ip: number; // instruction pointer
   line: number; // line in the source code
-  message: string; // custom message for failing `require` statement
+  message?: string; // custom message for failing `require` statement
 }
 
 export interface Artifact {
diff --git a/website/docs/language/artifacts.md b/website/docs/language/artifacts.md
index 4117696a..fcc144f0 100644
--- a/website/docs/language/artifacts.md
+++ b/website/docs/language/artifacts.md
@@ -24,7 +24,7 @@ interface Artifact {
     bytecode: string // unlike `bytecode` property above, this is a hex-encoded binary string
     sourceMap: string // see documentation for `generateSourceMap`
     logs: LogEntry[] // log entries generated from `console.log` statements
-    requireMessages: RequireMessage[] // messages for failing `require` statements
+    requires: RequireStatement[] // messages for failing `require` statements
   }
   updatedAt: string // Last datetime this artifact was updated (in ISO format)
 }

From c760fc0a5ff7ece8a9eec7b694149a70d0c304e8 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 25 Jun 2024 12:05:35 +0200
Subject: [PATCH 081/267] Simplify failed require errors

- Always show the line of a failed require statemement and not the full
  libauth error message
- Update FailedRequireError and similar error types to account for this
- Remove old error types that were dependent on Node error messages and
  related buildError function
- Change order of operations for transaction sending so that it is
  always debug-executed before sending
- Update e2e tests with new error messages
- Update docs for new error handling and types
---
 packages/cashscript/src/Errors.ts             | 29 ++++++++----
 packages/cashscript/src/Transaction.ts        | 46 ++++++++-----------
 packages/cashscript/src/TransactionBuilder.ts |  4 +-
 packages/cashscript/src/debugging.ts          | 34 +++++++-------
 packages/cashscript/src/utils.ts              | 40 ----------------
 packages/cashscript/test/debugging.test.ts    |  2 +-
 .../cashscript/test/e2e/Announcement.test.ts  | 25 +++-------
 packages/cashscript/test/e2e/BigInt.test.ts   | 18 ++------
 .../cashscript/test/e2e/FullStack.test.ts     |  6 +--
 .../cashscript/test/e2e/HodlVault.test.ts     | 15 ++----
 packages/cashscript/test/e2e/Mecenas.test.ts  | 25 +++-------
 packages/cashscript/test/e2e/P2PKH.test.ts    | 32 +++++++++----
 .../test/e2e/TokenCategoryCheck.test.ts       |  5 +-
 .../test/e2e/TransferWithTimeout.test.ts      | 30 ++++--------
 .../cashscript/test/e2e/old/Mecenas.test.ts   | 14 +++---
 website/docs/sdk/transactions-advanced.md     |  2 +-
 website/docs/sdk/transactions.md              | 44 ++++++++----------
 17 files changed, 147 insertions(+), 224 deletions(-)

diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index 229885a4..d7034768 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -1,4 +1,4 @@
-import { Type } from '@cashscript/utils';
+import { RequireStatement, Type } from '@cashscript/utils';
 
 export class TypeError extends Error {
   constructor(actual: string, expected: Type) {
@@ -7,7 +7,7 @@ export class TypeError extends Error {
 }
 
 export class OutputSatoshisTooSmallError extends Error {
-  constructor(satoshis: bigint, minimumAmount:bigint) {
+  constructor(satoshis: bigint, minimumAmount: bigint) {
     super(`Tried to add an output with ${satoshis} satoshis, which is less than the required minimum for this output-type (${minimumAmount})`);
   }
 }
@@ -19,17 +19,30 @@ export class TokensToNonTokenAddressError extends Error {
 }
 
 export class FailedTransactionError extends Error {
-  constructor(public reason: string, public debugStr?: string) {
-    super(`Transaction failed with reason: ${reason}${debugStr ? `\n\n${debugStr}` : ''}`);
+  constructor(public reason: string, public bitauthUri?: string) {
+    super(`${reason}\n\nBitauth URI: ${bitauthUri}`);
   }
 }
 
-export class FailedRequireError extends FailedTransactionError {}
-export class FailedTimeCheckError extends FailedTransactionError {}
-export class FailedSigCheckError extends FailedTransactionError {}
+// TODO: Add tests for some non-require evaluation errors (e.g. invalid op_split range)
+
+export class FailedRequireError extends Error {
+  public bitauthUri?: string;
+
+  constructor(
+    public contractName: string,
+    public requireStatement: RequireStatement,
+    public inputIndex: number,
+    public libauthErrorMessage?: string,
+  ) {
+    const baseMessage = `${contractName}.cash:${requireStatement.line} Require statement failed at line ${requireStatement.line}`;
+    const fullMessage = `${baseMessage} with the following message: ${requireStatement.message}`;
+    super(requireStatement.message ? fullMessage : baseMessage);
+  }
+}
 
 // TODO: Expand these reasons with non-script failures (like tx-mempool-conflict)
-export enum Reason {
+export enum NodeErrorReason {
   EVAL_FALSE = 'Script evaluated without error but finished with a false/empty top stack element',
   VERIFY = 'Script failed an OP_VERIFY operation',
   EQUALVERIFY = 'Script failed an OP_EQUALVERIFY operation',
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 7f6cdf4d..2573e0cd 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -28,7 +28,6 @@ import {
   createOpReturnOutput,
   getTxSizeWithoutInputs,
   getPreimageSize,
-  buildError,
   validateOutput,
   utxoComparator,
   calculateDust,
@@ -43,6 +42,7 @@ import MockNetworkProvider from './network/MockNetworkProvider.js';
 import { buildTemplate, getBitauthUri } from './LibauthTemplate.js';
 import { debugTemplate, evaluateTemplate, DebugResult } from './debugging.js';
 import { EncodedArgument } from './Argument.js';
+import { FailedRequireError, FailedTransactionError } from './Errors.js';
 
 export class Transaction {
   public inputs: Utxo[] = [];
@@ -174,7 +174,23 @@ export class Transaction {
   async send(raw?: true): Promise<TransactionDetails | string> {
     const tx = await this.build();
     let template: WalletTemplate | undefined;
+
+    // Debug the transaction locally before sending so any errors are caught early
     try {
+      // Libauth debugging does not work with old-style covenents (or outdated artifacts)
+      if (!this.abiFunction.covenant && this.contract.artifact.debug) {
+        await this.debug();
+      }
+    } catch (error) {
+      if (error instanceof FailedRequireError) {
+        error.bitauthUri = await this.bitauthUri();
+        error.message += `\n\nBitauth URI: ${error.bitauthUri}`;
+      }
+      throw error;
+    }
+
+    try {
+      // TODO: Can we move this to MockNetworkProvider?
       if (this.contract.provider instanceof MockNetworkProvider) {
         template = await buildTemplate({
           transaction: this,
@@ -185,31 +201,9 @@ export class Transaction {
 
       const txid = await this.contract.provider.sendRawTransaction(tx);
       return raw ? await this.getTxDetails(txid, raw) : await this.getTxDetails(txid);
-    } catch (maybeNodeError: any) {
-      if (!template) {
-        template = await buildTemplate({
-          transaction: this,
-          transactionHex: tx,
-        });
-      }
-
-      const reason = maybeNodeError.error ?? maybeNodeError.message ?? maybeNodeError;
-
-      const bitauthUri = getBitauthUri(template);
-
-      try {
-        debugTemplate(template, this.contract.artifact);
-      } catch (libauthError: any) {
-        if (this.contract.provider instanceof MockNetworkProvider) {
-          throw buildError(libauthError, bitauthUri);
-        } else {
-          const message = `${libauthError}\n\nUnderlying node error: ${reason}`;
-          throw buildError(message, bitauthUri);
-        }
-      }
-
-      // this must be unreachable
-      throw buildError(reason, bitauthUri);
+    } catch (error: any) {
+      const reason = error.error ?? error.message ?? error;
+      throw new FailedTransactionError(reason, await this.bitauthUri());
     }
   }
 
diff --git a/packages/cashscript/src/TransactionBuilder.ts b/packages/cashscript/src/TransactionBuilder.ts
index e242814c..562c16a5 100644
--- a/packages/cashscript/src/TransactionBuilder.ts
+++ b/packages/cashscript/src/TransactionBuilder.ts
@@ -13,11 +13,11 @@ import {
 } from './interfaces.js';
 import { NetworkProvider } from './network/index.js';
 import {
-  buildError,
   cashScriptOutputToLibauthOutput,
   createOpReturnOutput,
   validateOutput,
 } from './utils.js';
+import { FailedTransactionError } from './Errors.js';
 
 export interface TransactionBuilderOptions {
   provider: NetworkProvider;
@@ -153,7 +153,7 @@ export class TransactionBuilder {
       return raw ? await this.getTxDetails(txid, raw) : await this.getTxDetails(txid);
     } catch (e: any) {
       const reason = e.error ?? e.message;
-      throw buildError(reason);
+      throw new FailedTransactionError(reason);
     }
   }
 
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 1bc2a9fc..60b46958 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -1,6 +1,7 @@
 import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateBCH, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBCH2023, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
 import { Artifact, LogEntry, Op, PrimitiveType, StackItem, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
 import { findLastIndex, toRegExp } from './utils.js';
+import { FailedRequireError, FailedTransactionError } from './Errors.js';
 
 // evaluates the fully defined template, throws upon error
 export const evaluateTemplate = (template: WalletTemplate): boolean => {
@@ -8,7 +9,7 @@ export const evaluateTemplate = (template: WalletTemplate): boolean => {
 
   const verifyResult = vm.verify(program);
   if (typeof verifyResult === 'string') {
-    throw new Error(verifyResult);
+    throw new FailedTransactionError(verifyResult);
   }
 
   return verifyResult;
@@ -51,37 +52,38 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
     // preceding OP_CHECKSIG opcode. The error message is registered in the next instruction, so we need to increment
     // the instruction pointer to get the correct error message.
     const isNullFail = lastExecutedDebugStep.error === AuthenticationErrorCommon.nonNullSignatureFailure;
-    const messageIp = failingIp + (isNullFail ? 1 : 0);
+    const requireStatementIp = failingIp + (isNullFail ? 1 : 0);
 
-    const requireStatement = (artifact.debug?.requireMessages ?? [])
-      .find((message) => message.ip === messageIp);
+    const requireStatement = (artifact.debug?.requires ?? [])
+      .find((statement) => statement.ip === requireStatementIp);
 
+    // TODO: Also log the require statement that failed (e.g. "require(1 == 2, '1 is not equal to 2')")
     if (requireStatement) {
-      throw new Error(`${artifact.contractName}.cash:${requireStatement.line} Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex} with the following message: ${requireStatement.message}.\n${lastExecutedDebugStep.error}`);
+      const { program: { inputIndex }, error } = lastExecutedDebugStep;
+      throw new FailedRequireError(artifact.contractName, requireStatement, inputIndex, error);
     }
 
-    throw new Error(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${lastExecutedDebugStep.error}`);
+    throw new FailedTransactionError(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${lastExecutedDebugStep.error}`);
   }
 
   const evaluationResult = vm.verify(program);
 
   if (failedFinalVerify(evaluationResult)) {
-    const stackContents = lastExecutedDebugStep.stack.map(item => `0x${binToHex(item)}`).join(', ');
-    const stackContentsMessage = `\nStack contents after evaluation: ${lastExecutedDebugStep.stack.length ? stackContents : 'empty'}`;
-
     const finalExecutedVerifyIp = getFinalExecutedVerifyIp(executedDebugSteps);
 
     // logDebugSteps(executedDebugSteps, lastExecutedDebugStep.instructions);
     // console.warn('message', finalExecutedVerifyIp);
-    // console.warn(artifact.debug?.requireMessages);
+    // console.warn(artifact.debug?.requires);
 
-    const finalVerifyMessage = artifact.debug?.requireMessages.find((message) => message.ip === finalExecutedVerifyIp);
+    const requireStatement = (artifact.debug?.requires ?? [])
+      .find((message) => message.ip === finalExecutedVerifyIp);
 
-    if (finalVerifyMessage) {
-      throw new Error(`${artifact.contractName}.cash:${finalVerifyMessage.line} Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex} with the following message: ${finalVerifyMessage.message}.\n${evaluationResult.replace(/Error in evaluating input index \d: /, '')}` + stackContentsMessage);
+    if (requireStatement) {
+      const { program: { inputIndex }, error } = lastExecutedDebugStep;
+      throw new FailedRequireError(artifact.contractName, requireStatement, inputIndex, error);
     }
 
-    throw new Error(evaluationResult + stackContentsMessage);
+    throw new FailedTransactionError(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${evaluationResult}`);
   }
 
   return fullDebugSteps;
@@ -109,11 +111,11 @@ const createProgram = (template: WalletTemplate): CreateProgramResult => {
   });
 
   if (typeof scenarioGeneration === 'string') {
-    throw new Error(scenarioGeneration);
+    throw new FailedTransactionError(scenarioGeneration);
   }
 
   if (typeof scenarioGeneration.scenario === 'string') {
-    throw new Error(scenarioGeneration.scenario);
+    throw new FailedTransactionError(scenarioGeneration.scenario);
   }
 
   return { vm, program: scenarioGeneration.scenario.program };
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index a904d9b6..fe037033 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -13,7 +13,6 @@ import {
   encodeTransactionOutput,
   isHex,
   bigIntToCompactUint,
-  AuthenticationErrorCommon,
   NonFungibleTokenCapability,
   bigIntToVmNumber,
 } from '@bitauth/libauth';
@@ -38,11 +37,6 @@ import { VERSION_SIZE, LOCKTIME_SIZE } from './constants.js';
 import {
   OutputSatoshisTooSmallError,
   TokensToNonTokenAddressError,
-  Reason,
-  FailedTransactionError,
-  FailedRequireError,
-  FailedTimeCheckError,
-  FailedSigCheckError,
 } from './Errors.js';
 
 // ////////// PARAMETER VALIDATION ////////////////////////////////////////////
@@ -210,40 +204,6 @@ export function createSighashPreimage(
   return sighashPreimage;
 }
 
-export function buildError(reason: string, debugStr?: string): FailedTransactionError {
-  const require = [
-    Reason.EVAL_FALSE, Reason.VERIFY, Reason.EQUALVERIFY, Reason.CHECKMULTISIGVERIFY,
-    Reason.CHECKSIGVERIFY, Reason.CHECKDATASIGVERIFY, Reason.NUMEQUALVERIFY,
-
-    AuthenticationErrorCommon.failedVerify,
-  ];
-  const timeCheck = [
-    Reason.NEGATIVE_LOCKTIME, Reason.UNSATISFIED_LOCKTIME,
-
-    AuthenticationErrorCommon.negativeLocktime, AuthenticationErrorCommon.unsatisfiedLocktime,
-  ];
-  const sigCheck = [
-    Reason.SIG_COUNT, Reason.PUBKEY_COUNT, Reason.SIG_HASHTYPE, Reason.SIG_DER,
-    Reason.SIG_HIGH_S, Reason.SIG_NULLFAIL, Reason.SIG_BADLENGTH, Reason.SIG_NONSCHNORR,
-
-    AuthenticationErrorCommon.nonNullSignatureFailure,
-  ];
-
-  if (toRegExp(require).test(reason)) {
-    return new FailedRequireError(reason, debugStr);
-  }
-
-  if (toRegExp(timeCheck).test(reason)) {
-    return new FailedTimeCheckError(reason, debugStr);
-  }
-
-  if (toRegExp(sigCheck).test(reason)) {
-    return new FailedSigCheckError(reason, debugStr);
-  }
-
-  return new FailedTransactionError(reason, debugStr);
-}
-
 export function toRegExp(reasons: string[]): RegExp {
   return new RegExp(reasons.join('|').replace(/\(/g, '\\(').replace(/\)/g, '\\)'));
 }
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index f04d347a..10c1ba49 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -377,7 +377,7 @@ describe('Debugging tests', () => {
       const transaction = contract.functions
         .test_multiple_require_statements_no_message_final().to(contract.address, 1000n);
 
-      await expect(transaction).toFailRequireWith(/Error in evaluating input index 0/);
+      await expect(transaction).toFailRequireWith(new RegExp('^Test\.cash:32 Require statement failed at line 32$'));
       await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
diff --git a/packages/cashscript/test/e2e/Announcement.test.ts b/packages/cashscript/test/e2e/Announcement.test.ts
index 57065130..4a40c711 100644
--- a/packages/cashscript/test/e2e/Announcement.test.ts
+++ b/packages/cashscript/test/e2e/Announcement.test.ts
@@ -1,11 +1,10 @@
-import { AuthenticationErrorCommon } from '@bitauth/libauth';
 import {
   Contract, ElectrumNetworkProvider, MockNetworkProvider, Network,
 } from '../../src/index.js';
 import { getTxOutputs } from '../test-util.js';
-import { FailedRequireError, Reason } from '../../src/Errors.js';
+import { FailedRequireError } from '../../src/Errors.js';
 import {
-  createOpReturnOutput, randomUtxo, toRegExp, utxoComparator,
+  createOpReturnOutput, randomUtxo, utxoComparator,
 } from '../../src/utils.js';
 import { aliceAddress } from '../fixture/vars.js';
 import artifact from '../fixture/announcement.json' assert { type: 'json' };
@@ -45,10 +44,7 @@ describe('Announcement', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.NUMEQUALVERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow();
     });
 
     it('should fail when trying to announce incorrect announcement', async () => {
@@ -70,10 +66,7 @@ describe('Announcement', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.EQUALVERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('Announcement.cash:17 Require statement failed at line 17');
     });
 
     it('should fail when sending incorrect amount of change', async () => {
@@ -95,10 +88,7 @@ describe('Announcement', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.NUMEQUALVERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('Announcement.cash:25 Require statement failed at line 25');
     });
 
     it('should fail when sending the correct change amount to an incorrect address', async () => {
@@ -122,10 +112,7 @@ describe('Announcement', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.EQUALVERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('Announcement.cash:24 Require statement failed at line 24');
     });
 
     it('should succeed when announcing correct announcement', async () => {
diff --git a/packages/cashscript/test/e2e/BigInt.test.ts b/packages/cashscript/test/e2e/BigInt.test.ts
index f5378f67..f1e9e0d6 100644
--- a/packages/cashscript/test/e2e/BigInt.test.ts
+++ b/packages/cashscript/test/e2e/BigInt.test.ts
@@ -4,13 +4,12 @@ import {
   MockNetworkProvider,
   FailedRequireError,
   FailedTransactionError,
-  Reason,
   ElectrumNetworkProvider,
   Network,
 } from '../../src/index.js';
 import { getTxOutputs } from '../test-util.js';
 import artifact from '../fixture/bigint.json' assert { type: 'json' };
-import { randomUtxo, toRegExp } from '../../src/utils.js';
+import { randomUtxo } from '../../src/utils.js';
 
 describe('BigInt', () => {
   let bigintContract: Contract;
@@ -40,10 +39,7 @@ describe('BigInt', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.VERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('BigInt.cash:4 Require statement failed at line 4');
     });
 
     it('should fail when providing numbers that overflow 64 bits when multiplied', async () => {
@@ -59,10 +55,7 @@ describe('BigInt', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedTransactionError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.INVALID_NUMBER_RANGE,
-        AuthenticationErrorCommon.overflowsVmNumberRange,
-      ]));
+      await expect(txPromise).rejects.toThrow(AuthenticationErrorCommon.overflowsVmNumberRange);
     });
 
     it('should fail when providing a number that does not fit within 64 bits', async () => {
@@ -78,10 +71,7 @@ describe('BigInt', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedTransactionError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.INVALID_NUMBER_RANGE,
-        AuthenticationErrorCommon.invalidVmNumber,
-      ]));
+      await expect(txPromise).rejects.toThrow(AuthenticationErrorCommon.invalidVmNumber);
     });
 
     it('should succeed when providing a number within 32b < x < 64b', async () => {
diff --git a/packages/cashscript/test/e2e/FullStack.test.ts b/packages/cashscript/test/e2e/FullStack.test.ts
index 0b703bbb..7ad62ba8 100644
--- a/packages/cashscript/test/e2e/FullStack.test.ts
+++ b/packages/cashscript/test/e2e/FullStack.test.ts
@@ -7,7 +7,7 @@ import {
   bobPub,
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
-import { FailedSigCheckError, Reason } from '../../src/Errors.js';
+import { FailedRequireError, NodeErrorReason } from '../../src/Errors.js';
 import artifact from '../fixture/p2pkh.json' assert { type: 'json' };
 
 describe.skip('P2PKH (using FullStackNetworkProvider)', () => {
@@ -33,8 +33,8 @@ describe.skip('P2PKH (using FullStackNetworkProvider)', () => {
         .send();
 
       // then
-      await expect(txPromise).rejects.toThrow(FailedSigCheckError);
-      await expect(txPromise).rejects.toThrow(Reason.SIG_NULLFAIL);
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow(NodeErrorReason.SIG_NULLFAIL);
     });
 
     it('should succeed when using correct function arguments', async () => {
diff --git a/packages/cashscript/test/e2e/HodlVault.test.ts b/packages/cashscript/test/e2e/HodlVault.test.ts
index 604e3e6e..c8efca47 100644
--- a/packages/cashscript/test/e2e/HodlVault.test.ts
+++ b/packages/cashscript/test/e2e/HodlVault.test.ts
@@ -1,4 +1,3 @@
-import { AuthenticationErrorCommon } from '@bitauth/libauth';
 import {
   Contract,
   SignatureTemplate,
@@ -13,9 +12,9 @@ import {
   oraclePub,
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
-import { FailedRequireError, Reason } from '../../src/Errors.js';
+import { FailedRequireError } from '../../src/Errors.js';
 import artifact from '../fixture/hodl_vault.json' assert { type: 'json' };
-import { randomUtxo, toRegExp } from '../../src/utils.js';
+import { randomUtxo } from '../../src/utils.js';
 
 describe('HodlVault', () => {
   let hodlVault: Contract;
@@ -46,10 +45,7 @@ describe('HodlVault', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.VERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('HodlVault.cash:26 Require statement failed at line 26');
     });
 
     it('should fail when price is too low', async () => {
@@ -67,10 +63,7 @@ describe('HodlVault', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.VERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('HodlVault.cash:23 Require statement failed at line 23');
     });
 
     it('should succeed when price is high enough', async () => {
diff --git a/packages/cashscript/test/e2e/Mecenas.test.ts b/packages/cashscript/test/e2e/Mecenas.test.ts
index 67efbfcc..6b4cf5a6 100644
--- a/packages/cashscript/test/e2e/Mecenas.test.ts
+++ b/packages/cashscript/test/e2e/Mecenas.test.ts
@@ -1,4 +1,3 @@
-import { AuthenticationErrorCommon } from '@bitauth/libauth';
 import {
   Contract, ElectrumNetworkProvider, MockNetworkProvider, Network,
 } from '../../src/index.js';
@@ -9,9 +8,9 @@ import {
   bobAddress,
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
-import { FailedRequireError, Reason } from '../../src/Errors.js';
+import { FailedRequireError } from '../../src/Errors.js';
 import artifact from '../fixture/mecenas.json' assert { type: 'json' };
-import { randomUtxo, toRegExp } from '../../src/utils.js';
+import { randomUtxo } from '../../src/utils.js';
 
 // Mecenas has tx.age check omitted for testing
 describe('Mecenas', () => {
@@ -43,10 +42,7 @@ describe('Mecenas', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.NUMEQUALVERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('Mecenas.cash:24 Require statement failed at line 24');
     });
 
     it('should fail when trying to send to wrong person', async () => {
@@ -63,10 +59,7 @@ describe('Mecenas', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.VERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('Mecenas.cash:13 Require statement failed at line 13');
     });
 
     it('should fail when trying to send to multiple people', async () => {
@@ -84,10 +77,7 @@ describe('Mecenas', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.VERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('Mecenas.cash:25 Require statement failed at line 25');
     });
 
     it('should fail when sending incorrect amount of change', async () => {
@@ -104,10 +94,7 @@ describe('Mecenas', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.NUMEQUALVERIFY,
-        AuthenticationErrorCommon.failedVerify,
-      ]));
+      await expect(txPromise).rejects.toThrow('Mecenas.cash:26 Require statement failed at line 26');
     });
 
     it('should succeed when sending pledge to receiver', async () => {
diff --git a/packages/cashscript/test/e2e/P2PKH.test.ts b/packages/cashscript/test/e2e/P2PKH.test.ts
index d6411b86..de4614a8 100644
--- a/packages/cashscript/test/e2e/P2PKH.test.ts
+++ b/packages/cashscript/test/e2e/P2PKH.test.ts
@@ -1,6 +1,7 @@
-import { AuthenticationErrorCommon, binToHex } from '@bitauth/libauth';
+import { binToHex } from '@bitauth/libauth';
 import {
   Contract, SignatureTemplate, MockNetworkProvider, ElectrumNetworkProvider,
+  FailedRequireError,
 } from '../../src/index.js';
 import {
   bobAddress,
@@ -8,13 +9,13 @@ import {
   bobPriv,
   bobPkh,
   alicePriv,
+  alicePub,
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
 import { Network, Utxo } from '../../src/interfaces.js';
 import {
-  createOpReturnOutput, randomUtxo, toRegExp, utxoComparator,
+  createOpReturnOutput, randomUtxo, utxoComparator,
 } from '../../src/utils.js';
-import { FailedSigCheckError, Reason } from '../../src/Errors.js';
 import artifact from '../fixture/p2pkh.json' assert { type: 'json' };
 
 describe('P2PKH-no-tokens', () => {
@@ -33,7 +34,23 @@ describe('P2PKH-no-tokens', () => {
   });
 
   describe('send', () => {
-    it('should fail when using incorrect function arguments', async () => {
+    it('should fail when using incorrect public key', async () => {
+      // given
+      const to = p2pkhInstance.address;
+      const amount = 10000n;
+
+      // when
+      const txPromise = p2pkhInstance.functions
+        .spend(alicePub, new SignatureTemplate(bobPriv))
+        .to(to, amount)
+        .send();
+
+      // then
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('P2PKH.cash:4 Require statement failed at line 4');
+    });
+
+    it('should fail when using incorrect signature', async () => {
       // given
       const to = p2pkhInstance.address;
       const amount = 10000n;
@@ -45,11 +62,8 @@ describe('P2PKH-no-tokens', () => {
         .send();
 
       // then
-      await expect(txPromise).rejects.toThrow(FailedSigCheckError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.SIG_NULLFAIL,
-        AuthenticationErrorCommon.nonNullSignatureFailure,
-      ]));
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('P2PKH.cash:5 Require statement failed at line 5');
     });
 
     it('should succeed when using correct function arguments', async () => {
diff --git a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
index ec777a84..1289637f 100644
--- a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
+++ b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
@@ -1,6 +1,6 @@
 import { randomUtxo, randomToken } from '../../src/utils.js';
 import {
-  Contract, ElectrumNetworkProvider, MockNetworkProvider,
+  Contract, ElectrumNetworkProvider, FailedRequireError, MockNetworkProvider,
 } from '../../src/index.js';
 import { Network, Utxo } from '../../src/interfaces.js';
 import artifact from '../fixture/token_category_comparison.json' assert { type: 'json' };
@@ -48,7 +48,8 @@ describe('TokenCategoryCheck', () => {
         .to(to, amount, token)
         .send();
 
-      await expect(txPromise).rejects.toThrow(/completed with a non-truthy value on top of the stack/);
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('Test.cash:3 Require statement failed at line 3');
     });
 
     it('can send if the input at index 1 does not contain tokens', async () => {
diff --git a/packages/cashscript/test/e2e/TransferWithTimeout.test.ts b/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
index f7ddcf7f..1315ccae 100644
--- a/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
+++ b/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
@@ -1,18 +1,17 @@
-import { AuthenticationErrorCommon } from '@bitauth/libauth';
 import {
   Contract,
   SignatureTemplate,
   ElectrumNetworkProvider,
   Network,
   MockNetworkProvider,
+  FailedRequireError,
 } from '../../src/index.js';
 import {
   alicePriv, alicePub, bobPriv, bobPub,
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
-import { FailedSigCheckError, Reason, FailedTimeCheckError } from '../../src/Errors.js';
 import artifact from '../fixture/transfer_with_timeout.json' assert { type: 'json' };
-import { randomUtxo, toRegExp } from '../../src/utils.js';
+import { randomUtxo } from '../../src/utils.js';
 
 describe('TransferWithTimeout', () => {
   let twtInstancePast: Contract;
@@ -32,7 +31,7 @@ describe('TransferWithTimeout', () => {
   });
 
   describe('send', () => {
-    it('should fail when using incorrect function arguments to transfer', async () => {
+    it('should fail when signing transfer with incorrect private key', async () => {
       // given
       const to = twtInstancePast.address;
       const amount = 10000n;
@@ -44,14 +43,11 @@ describe('TransferWithTimeout', () => {
         .send();
 
       // then
-      await expect(txPromise).rejects.toThrow(FailedSigCheckError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.SIG_NULLFAIL,
-        AuthenticationErrorCommon.nonNullSignatureFailure,
-      ]));
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:8 Require statement failed at line 8');
     });
 
-    it('should fail when using incorrect function arguments to timeout', async () => {
+    it('should fail when signing timeout with incorrect private key', async () => {
       // given
       const to = twtInstancePast.address;
       const amount = 10000n;
@@ -63,11 +59,8 @@ describe('TransferWithTimeout', () => {
         .send();
 
       // then
-      await expect(txPromise).rejects.toThrow(FailedSigCheckError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.SIG_NULLFAIL,
-        AuthenticationErrorCommon.nonNullSignatureFailure,
-      ]));
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:13 Require statement failed at line 13');
     });
 
     it('should fail when timeout is called before timeout block', async () => {
@@ -82,11 +75,8 @@ describe('TransferWithTimeout', () => {
         .send();
 
       // then
-      await expect(txPromise).rejects.toThrow(FailedTimeCheckError);
-      await expect(txPromise).rejects.toThrow(toRegExp([
-        Reason.UNSATISFIED_LOCKTIME,
-        AuthenticationErrorCommon.unsatisfiedLocktime,
-      ]));
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:14 Require statement failed at line 14');
     });
 
     it('should succeed when transfer is called after timeout block', async () => {
diff --git a/packages/cashscript/test/e2e/old/Mecenas.test.ts b/packages/cashscript/test/e2e/old/Mecenas.test.ts
index 46f30850..24c159d4 100644
--- a/packages/cashscript/test/e2e/old/Mecenas.test.ts
+++ b/packages/cashscript/test/e2e/old/Mecenas.test.ts
@@ -14,7 +14,7 @@ import {
   alicePriv,
 } from '../../fixture/vars.js';
 import { getTxOutputs } from '../../test-util.js';
-import { FailedRequireError, Reason } from '../../../src/Errors.js';
+import { FailedTransactionError, NodeErrorReason } from '../../../src/Errors.js';
 import artifact from '../../fixture/old/mecenas.json' assert { type: 'json' };
 
 if (!process.env.TESTS_USE_MOCKNET) {
@@ -45,8 +45,8 @@ if (!process.env.TESTS_USE_MOCKNET) {
           .send();
 
         // then
-        await expect(txPromise).rejects.toThrow(FailedRequireError);
-        await expect(txPromise).rejects.toThrow(Reason.EQUALVERIFY);
+        await expect(txPromise).rejects.toThrow(FailedTransactionError);
+        await expect(txPromise).rejects.toThrow(NodeErrorReason.EQUALVERIFY);
       });
 
       it('should fail when trying to send to wrong person', async () => {
@@ -62,8 +62,8 @@ if (!process.env.TESTS_USE_MOCKNET) {
           .send();
 
         // then
-        await expect(txPromise).rejects.toThrow(FailedRequireError);
-        await expect(txPromise).rejects.toThrow(Reason.EQUALVERIFY);
+        await expect(txPromise).rejects.toThrow(FailedTransactionError);
+        await expect(txPromise).rejects.toThrow(NodeErrorReason.EQUALVERIFY);
       });
 
       it('should fail when trying to send to multiple people', async () => {
@@ -80,8 +80,8 @@ if (!process.env.TESTS_USE_MOCKNET) {
           .send();
 
         // then
-        await expect(txPromise).rejects.toThrow(FailedRequireError);
-        await expect(txPromise).rejects.toThrow(Reason.EQUALVERIFY);
+        await expect(txPromise).rejects.toThrow(FailedTransactionError);
+        await expect(txPromise).rejects.toThrow(NodeErrorReason.EQUALVERIFY);
       });
 
       it('should succeed when sending pledge to receiver', async () => {
diff --git a/website/docs/sdk/transactions-advanced.md b/website/docs/sdk/transactions-advanced.md
index 1a29522d..4eb0c9aa 100644
--- a/website/docs/sdk/transactions-advanced.md
+++ b/website/docs/sdk/transactions-advanced.md
@@ -229,7 +229,7 @@ const txHex = new TransactionBuilder({ provider })
 
 ## Transaction errors
 
-Transactions can fail for a number of reasons. Refer to the [Transaction Errors][transactions-simple-errors] section of the simplified transaction builder documentation for more information.
+Transactions can fail for a number of reasons. Refer to the [Transaction Errors][transactions-simple-errors] section of the simplified transaction builder documentation for more information. Note that the advanced transaction builder does not yet support the `FailedRequireError` mentioned in the simplified transaction builder documentation so any error will be of type `FailedTransactionError` and include any of the mentioned error reasons in its message.
 
 [fex]: https://github.com/fex-cash/fex
 [bitcoin-wiki-timelocks]: https://en.bitcoin.it/wiki/Timelock
diff --git a/website/docs/sdk/transactions.md b/website/docs/sdk/transactions.md
index 7a2d8f1e..4db1a075 100644
--- a/website/docs/sdk/transactions.md
+++ b/website/docs/sdk/transactions.md
@@ -259,35 +259,27 @@ You can read more about debugging transactions on the [debugging page](/docs/gui
 It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
 :::
 
+TODO: Update this section with the new debugging experience
+
 ## Transaction errors
-Transactions can fail for a number of reasons. Most of these are related to the execution of the smart contract (e.g. wrong parameters or a bug in the contract code). But errors can also occur because of other reasons (e.g. a fee that's too low or the same transaction already exists in the mempool). To facilitate error handling in your applications, the CashScript SDK provides an enum of different *reasons* for a failure.
-
-This `Reason` enum only includes errors that are related to smart contract execution, so other reasons have to be caught separately. Besides the `Reason` enum, there are also several error classes that can be caught and acted on:
-
-* **`FailedRequireError`** signifies a failed require statement. This includes the following reasons:
-  * `Reason.EVAL_FALSE`
-  * `Reason.VERIFY`
-  * `Reason.EQUALVERIFY`
-  * `Reason.CHECKMULTISIGVERIFY`
-  * `Reason.CHECKSIGVERIFY`
-  * `Reason.CHECKDATASIGVERIFY`
-  * `Reason.NUMEQUALVERIFY`
-* **`FailedTimeCheckError`** signifies a failed time check using `tx.time` or `tx.age`. This includes the following reasons:
-  * `Reason.NEGATIVE_LOCKTIME`
-  * `Reason.UNSATISFIED_LOCKTIME`
-* **`FailedSigCHeckError`** signifies a failed signature check. This includes the following reasons:
-  * `Reason.SIG_COUNT`
-  * `Reason.PUBKEY_COUNT`
-  * `Reason.SIG_HASHTYPE`
-  * `Reason.SIG_DER`
-  * `Reason.SIG_HIGH_S`
-  * `Reason.SIG_NULLFAIL`
-  * `Reason.SIG_BADLENGTH`
-  * `Reason.SIG_NONSCHNORR`
-* **`FailedTransactionError`** signifies a general fallback error. This includes all remaining reasons listed in the `Reason` enum as well as any other reasons unrelated to the smart contract execution.
+
+When sending a transaction, the CashScript SDK will throw an error if the transaction fails. If you are using an artifact compiled with `cashc@0.10.0` or later, the error will be of the type `FailedRequireError` or `FailedTransactionError`. In case of a `FailedRequireError`, the error will refer to the corresponding `require` statement in the contract code so you know where your contract failed. If you want more information about the underlying error, you can check the `libauthErrorMessage` property of the error.
+
+```ts
+interface FailedRequireError {
+  message: string;
+  contractName: string;
+  requireStatement: { ip: number, line: number, message: string };
+  inputIndex: number,
+  libauthErrorMessage?: string,
+  bitauthUri?: string;
+}
+```
+
+If you are using an artifact compiled with an older version of `cashc`, the error will always be of the type `FailedTransactionError`. In this case, you can use the `reason` property of the error to determine the reason for the failure. A list of possible reasons can be found in the `NodeErrorReason` enum below.
 
 ```ts
-enum Reason {
+enum NodeErrorReason {
   EVAL_FALSE = 'Script evaluated without error but finished with a false/empty top stack element',
   VERIFY = 'Script failed an OP_VERIFY operation',
   EQUALVERIFY = 'Script failed an OP_EQUALVERIFY operation',

From 746063dd4eec912528bccae2b72c41d6986c51b7 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 25 Jun 2024 12:14:40 +0200
Subject: [PATCH 082/267] Bump version to 0.10.0-next.6

---
 examples/package.json               | 6 +++---
 examples/testing-suite/package.json | 6 +++---
 packages/cashc/package.json         | 4 ++--
 packages/cashc/src/index.ts         | 2 +-
 packages/cashscript/package.json    | 4 ++--
 packages/utils/package.json         | 2 +-
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index ceaf832f..a1ac1a94 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.0-next.5",
+  "version": "0.10.0-next.6",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -14,8 +14,8 @@
     "@bitauth/libauth": "^2.0.0-alpha.8",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
-    "cashc": "^0.10.0-next.5",
-    "cashscript": "^0.10.0-next.5",
+    "cashc": "^0.10.0-next.6",
+    "cashscript": "^0.10.0-next.6",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 7cb4d91b..36b5f308 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.0-next.5",
+  "version": "0.10.0-next.6",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -25,8 +25,8 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "cashc": "^0.10.0-next.5",
-    "cashscript": "^0.10.0-next.5"
+    "cashc": "^0.10.0-next.6",
+    "cashscript": "^0.10.0-next.6"
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 5b48f4aa..1193d65d 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.0-next.5",
+  "version": "0.10.0-next.6",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0",
-    "@cashscript/utils": "^0.10.0-next.5",
+    "@cashscript/utils": "^0.10.0-next.6",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 01e18dc6..e05ef6ec 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.0-next.5';
+export const version = '0.10.0-next.6';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 0a591dca..0f2f8f65 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.0-next.5",
+  "version": "0.10.0-next.6",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^2.0.0",
-    "@cashscript/utils": "^0.10.0-next.5",
+    "@cashscript/utils": "^0.10.0-next.6",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index f4465fc9..a73dc4c2 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.0-next.5",
+  "version": "0.10.0-next.6",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From b26f1f20b89df6d857a5860eebd3bcc7668faa4e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 25 Jun 2024 12:16:51 +0200
Subject: [PATCH 083/267] Update development docs and skip failing test for
 publication

---
 DEVELOPMENT.md                                 | 2 +-
 packages/cashscript/test/e2e/HodlVault.test.ts | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index e3a966ff..54e633eb 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -8,7 +8,7 @@ pushd ../.. && yarn build && popd
 
 ### Publishing a release
 
-To publish a new release, we use `yarn update-version 'x.x.x'` in the root directory to bump the version before release, and then `yarn publish-all` in the root directory to publish the release. In case of a tagged release (such as `next`), we use `yarn publish-all --dist-tag <tag name>` to publish the release with the specified tag.
+To publish a new release, we use `yarn update-version 'x.x.x'` in the root directory to bump the version before release, and then `yarn publish-all` in the root directory to publish the release. In case of a tagged release (such as `next`), we use `TESTS_USE_MOCKNET=true yarn publish-all --dist-tag <tag name>` to publish the release with the specified tag.
 
 ## cashc
 
diff --git a/packages/cashscript/test/e2e/HodlVault.test.ts b/packages/cashscript/test/e2e/HodlVault.test.ts
index c8efca47..b76a40cb 100644
--- a/packages/cashscript/test/e2e/HodlVault.test.ts
+++ b/packages/cashscript/test/e2e/HodlVault.test.ts
@@ -29,7 +29,7 @@ describe('HodlVault', () => {
   });
 
   describe('send', () => {
-    it('should fail when oracle sig is incorrect', async () => {
+    it.skip('should fail when oracle sig is incorrect', async () => {
       // given
       const message = oracle.createMessage(100000n, 1000n);
       const wrongMessage = oracle.createMessage(100000n, 1001n);

From 18b08f6a5c3bc7b7085b0903eb3188c5e3391e3b Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 6 Aug 2024 10:48:16 +0200
Subject: [PATCH 084/267] Add extra test case for P2SH20, fix bug with
 placeholder data & fix failing test for HodlVault

---
 packages/cashscript/src/LibauthTemplate.ts       | 16 +++-------------
 packages/cashscript/test/e2e/HodlVault.test.ts   |  6 +++---
 .../test/fixture/libauth-template/fixtures.ts    |  7 +++----
 3 files changed, 9 insertions(+), 20 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 38d3650c..9f27a997 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -52,8 +52,6 @@ export const buildTemplate = async ({
   const contract = transaction.contract;
   const txHex = transactionHex ?? await transaction.build();
 
-  const hasSignatureTemplates = transaction.inputs.filter((input) => isUtxoP2PKH(input)).length > 0;
-
   const template = {
     $schema: 'https://ide.bitauth.com/authentication-template-v0.schema.json',
     description: 'Imported from cashscript',
@@ -76,11 +74,11 @@ export const buildTemplate = async ({
       transaction.abiFunction,
       transaction.encodedFunctionArgs,
       contract.encodedConstructorArgs,
-      hasSignatureTemplates,
     ),
   } as WalletTemplate;
 
   // add extra variables for the p2pkh utxos spent together with our contract
+  const hasSignatureTemplates = transaction.inputs.filter((input) => isUtxoP2PKH(input)).length > 0;
   if (hasSignatureTemplates) {
     template.entities.parameters.scripts!.push('p2pkh_placeholder_lock', 'p2pkh_placeholder_unlock');
     template.entities.parameters.variables = {
@@ -233,7 +231,6 @@ const generateTemplateScenarios = (
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedArgument[],
   encodedConstructorArgs: EncodedArgument[],
-  hasSignatureTemplates: boolean,
 ): WalletTemplate['scenarios'] => {
   const libauthTransaction = decodeTransaction(hexToBin(transactionHex));
   if (typeof libauthTransaction === 'string') throw Error(libauthTransaction);
@@ -253,9 +250,7 @@ const generateTemplateScenarios = (
         currentBlockHeight: 2,
         currentBlockTime: Math.round(+new Date() / 1000),
         keys: {
-          privateKeys: generateTemplateScenarioKeys(
-            abiFunction.inputs, encodedFunctionArgs, hasSignatureTemplates,
-          ),
+          privateKeys: generateTemplateScenarioKeys(abiFunction.inputs, encodedFunctionArgs),
         },
       },
       transaction: generateTemplateScenarioTransaction(contract, libauthTransaction, transaction),
@@ -376,7 +371,6 @@ const generateTemplateScenarioParametersValues = (
 const generateTemplateScenarioKeys = (
   types: AbiInput[],
   encodedArgs: EncodedArgument[],
-  hasSignatureTemplates: boolean,
 ): Record<string, string> => {
   const typesAndArguments = zip(types, encodedArgs);
 
@@ -384,11 +378,7 @@ const generateTemplateScenarioKeys = (
     .filter(([, arg]) => arg instanceof SignatureTemplate)
     .map(([input, arg]) => ([snakeCase(input.name), binToHex((arg as SignatureTemplate).privateKey)] as const));
 
-  const placeholderKey = hasSignatureTemplates
-    ? [['placeholder_key', '0x0000000000000000000000000000000000000000000000000000000000000000']]
-    : [];
-
-  return Object.fromEntries([...entries, ...placeholderKey]);
+  return Object.fromEntries(entries);
 };
 
 const formatParametersForDebugging = (types: AbiInput[], args: EncodedArgument[]): string => {
diff --git a/packages/cashscript/test/e2e/HodlVault.test.ts b/packages/cashscript/test/e2e/HodlVault.test.ts
index b76a40cb..31e47a71 100644
--- a/packages/cashscript/test/e2e/HodlVault.test.ts
+++ b/packages/cashscript/test/e2e/HodlVault.test.ts
@@ -29,10 +29,10 @@ describe('HodlVault', () => {
   });
 
   describe('send', () => {
-    it.skip('should fail when oracle sig is incorrect', async () => {
+    it('should fail when oracle sig is incorrect', async () => {
       // given
-      const message = oracle.createMessage(100000n, 1000n);
-      const wrongMessage = oracle.createMessage(100000n, 1001n);
+      const message = oracle.createMessage(100000n, 30000n);
+      const wrongMessage = oracle.createMessage(100000n, 30001n);
       const wrongSig = oracle.signMessage(wrongMessage);
       const to = hodlVault.address;
       const amount = 10000n;
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index bb2eb8ba..d1ce7bac 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -965,9 +965,9 @@ export const fixtures: Fixture[] = [
   //   template: {} as any,
   // },
   {
-    name: 'P2PKH (with P2PKH inputs)',
+    name: 'P2PKH (with P2PKH inputs & P2SH20 address type)',
     transaction: (() => {
-      const contract = new Contract(P2PKH, [alicePkh], { provider });
+      const contract = new Contract(P2PKH, [alicePkh], { provider, addressType: 'p2sh20' });
 
       const regularUtxo = randomUtxo();
       provider.addUtxo(contract.address, regularUtxo);
@@ -1042,7 +1042,6 @@ export const fixtures: Fixture[] = [
             'keys': {
               'privateKeys': {
                 's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
-                'placeholder_key': '0x0000000000000000000000000000000000000000000000000000000000000000',
               },
             },
           },
@@ -1118,7 +1117,7 @@ export const fixtures: Fixture[] = [
           'unlocks': 'lock',
         },
         'lock': {
-          'lockingType': 'p2sh32',
+          'lockingType': 'p2sh20',
           'name': 'lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },

From 55acaceb6c19023e299df6d6d5e5577345a24577 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 6 Aug 2024 11:08:36 +0200
Subject: [PATCH 085/267] Add test case for zero-encoding

---
 packages/cashscript/test/debugging.test.ts | 25 ++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 10c1ba49..5384fc8c 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -122,6 +122,16 @@ contract Test() {
 }
 `;
 
+const CONTRACT_CODE_ZERO_HANDLING = `
+contract Test(int a) {
+  function test_zero_handling(int b) {
+    require(a == 0, "a should be 0");
+    require(b == 0, "b should be 0");
+    require(a == b, "a should equal b");
+  }
+}
+`;
+
 describe('Debugging tests', () => {
   describe('console.log statements', () => {
     const BASE_CONTRACT_CODE = `
@@ -488,6 +498,21 @@ describe('Debugging tests', () => {
     });
   });
 
+  describe('Template encoding', () => {
+    const artifact = compileString(CONTRACT_CODE_ZERO_HANDLING);
+    const provider = new MockNetworkProvider();
+
+    // test_zero_handling
+    it('should encode a locking and unlocking parameter of value 0 correctly and evaluate the execution', async () => {
+      const contract = new Contract(artifact, [0n], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_zero_handling(0n).to(contract.address, 1000n);
+      console.log(await transaction.bitauthUri());
+      await expect(transaction).not.toFailRequireWith(/.*/);
+    });
+  });
+
   describe('JestExtensions', () => {
     const artifact = compileString(CONTRACT_CODE);
     const provider = new MockNetworkProvider();

From 24d77df6789087cbfc5ce494127d51b51b91fadf Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 6 Aug 2024 11:35:43 +0200
Subject: [PATCH 086/267] Support for different hashtypes / signing algorithms
 in unlocking parameters

---
 packages/cashscript/src/LibauthTemplate.ts    | 35 +++++++++++++++++--
 packages/cashscript/src/SignatureTemplate.ts  |  4 +++
 .../test/fixture/libauth-template/fixtures.ts | 11 +++---
 3 files changed, 44 insertions(+), 6 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 9f27a997..f74289e8 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -32,6 +32,8 @@ import {
   LibauthTokenDetails,
   Output,
   AddressType,
+  SignatureAlgorithm,
+  HashType,
 } from './interfaces.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
@@ -389,8 +391,9 @@ const formatParametersForDebugging = (types: AbiInput[], args: EncodedArgument[]
 
   return typesAndArguments.map(([input, arg]) => {
     if (arg instanceof SignatureTemplate) {
-      // TODO: Different signing algorithms / hashtypes
-      return `<${snakeCase(input.name)}.schnorr_signature.all_outputs> // ${input.type}`;
+      const signatureAlgorithmName = getSignatureAlgorithmName(arg.getSignatureAlgorithm());
+      const hashtypeName = getHashTypeName(arg.getHashType(false));
+      return `<${snakeCase(input.name)}.${signatureAlgorithmName}.${hashtypeName}> // ${input.type}`;
     }
 
     const typeStr = input.type === 'bytes' ? `bytes${arg.length}` : input.type;
@@ -401,6 +404,34 @@ const formatParametersForDebugging = (types: AbiInput[], args: EncodedArgument[]
   }).join('\n');
 };
 
+const getSignatureAlgorithmName = (signatureAlgorithm: SignatureAlgorithm): string => {
+  const signatureAlgorithmNames = {
+    [SignatureAlgorithm.SCHNORR]: 'schnorr_signature',
+    [SignatureAlgorithm.ECDSA]: 'ecdsa_signature',
+  };
+
+  return signatureAlgorithmNames[signatureAlgorithm];
+};
+
+const getHashTypeName = (hashType: HashType): string => {
+  const hashtypeNames = {
+    [HashType.SIGHASH_ALL]: 'all_outputs',
+    [HashType.SIGHASH_ALL | HashType.SIGHASH_ANYONECANPAY]: 'all_outputs_single_input',
+    [HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS]: 'all_outputs_all_utxos',
+    [HashType.SIGHASH_ALL | HashType.SIGHASH_ANYONECANPAY | HashType.SIGHASH_UTXOS]: 'all_outputs_single_input_INVALID_all_utxos',
+    [HashType.SIGHASH_SINGLE]: 'corresponding_output',
+    [HashType.SIGHASH_SINGLE | HashType.SIGHASH_ANYONECANPAY]: 'corresponding_output_single_input',
+    [HashType.SIGHASH_SINGLE | HashType.SIGHASH_UTXOS]: 'corresponding_output_all_utxos',
+    [HashType.SIGHASH_SINGLE | HashType.SIGHASH_ANYONECANPAY | HashType.SIGHASH_UTXOS]: 'corresponding_output_single_input_INVALID_all_utxos',
+    [HashType.SIGHASH_NONE]: 'no_outputs',
+    [HashType.SIGHASH_NONE | HashType.SIGHASH_ANYONECANPAY]: 'no_outputs_single_input',
+    [HashType.SIGHASH_NONE | HashType.SIGHASH_UTXOS]: 'no_outputs_all_utxos',
+    [HashType.SIGHASH_NONE | HashType.SIGHASH_ANYONECANPAY | HashType.SIGHASH_UTXOS]: 'no_outputs_single_input_INVALID_all_utxos',
+  };
+
+  return hashtypeNames[hashType];
+};
+
 const formatBytecodeForDebugging = (artifact: Artifact): string => {
   if (!artifact.debug) {
     // TODO: See if we can merge this with code from @cashscript/utils -> script.ts
diff --git a/packages/cashscript/src/SignatureTemplate.ts b/packages/cashscript/src/SignatureTemplate.ts
index 0e9de359..6535636a 100644
--- a/packages/cashscript/src/SignatureTemplate.ts
+++ b/packages/cashscript/src/SignatureTemplate.ts
@@ -39,6 +39,10 @@ export default class SignatureTemplate {
     return bchForkId ? (this.hashtype | SigningSerializationFlag.forkId) : this.hashtype;
   }
 
+  getSignatureAlgorithm(): SignatureAlgorithm {
+    return this.signatureAlgorithm;
+  }
+
   getPublicKey(): Uint8Array {
     return secp256k1.derivePublicKeyCompressed(this.privateKey) as Uint8Array;
   }
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index d1ce7bac..40710515 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -1,4 +1,4 @@
-import { Contract, MockNetworkProvider, SignatureTemplate, Transaction, randomNFT, randomToken, randomUtxo } from '../../../src/index.js';
+import { Contract, HashType, MockNetworkProvider, SignatureAlgorithm, SignatureTemplate, Transaction, randomNFT, randomToken, randomUtxo } from '../../../src/index.js';
 import TransferWithTimeout from '../transfer_with_timeout.json' assert { type: 'json' };
 import Mecenas from '../mecenas.json' assert { type: 'json' };
 import P2PKH from '../p2pkh.json' assert { type: 'json' };
@@ -965,7 +965,7 @@ export const fixtures: Fixture[] = [
   //   template: {} as any,
   // },
   {
-    name: 'P2PKH (with P2PKH inputs & P2SH20 address type)',
+    name: 'P2PKH (with P2PKH inputs & P2SH20 address type & ECDSA signature algorithm)',
     transaction: (() => {
       const contract = new Contract(P2PKH, [alicePkh], { provider, addressType: 'p2sh20' });
 
@@ -979,8 +979,11 @@ export const fixtures: Fixture[] = [
       const amount = 1000n;
 
       const tx = contract.functions
-        .spend(alicePub, new SignatureTemplate(alicePriv))
+        .spend(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_NONE, SignatureAlgorithm.ECDSA))
         .fromP2PKH(p2pkhUtxo, new SignatureTemplate(alicePriv))
+        // TODO: Also allow fromP2PKH with different signing algorithms / hashtypes
+        // + support multiple fromP2PKH inputs with different keys
+        // .fromP2PKH(p2pkhUtxo, new SignatureTemplate(bobPriv, HashType.SIGHASH_ALL, SignatureAlgorithm.ECDSA))
         .from(regularUtxo)
         .to(to, amount);
 
@@ -1113,7 +1116,7 @@ export const fixtures: Fixture[] = [
             'evaluate_function',
           ],
           'name': 'unlock',
-          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'script': '// "spend" function parameters\n<s.ecdsa_signature.no_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
           'unlocks': 'lock',
         },
         'lock': {

From a10040412fabfcaa42ae00bb07d82fbefb0634fa Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 6 Aug 2024 12:01:48 +0200
Subject: [PATCH 087/267] Allow cashscript/jest import instead of
 cashscript/dist/test/...

---
 .eslintrc.cjs                                 | 2 +-
 examples/testing-suite/artifacts/example.json | 9 +++++----
 examples/testing-suite/test/example.test.ts   | 2 +-
 packages/cashscript/.npmignore                | 1 +
 packages/cashscript/jest/package.json         | 5 +++++
 5 files changed, 13 insertions(+), 6 deletions(-)
 create mode 100644 packages/cashscript/jest/package.json

diff --git a/.eslintrc.cjs b/.eslintrc.cjs
index 527115a7..d05a80a6 100644
--- a/.eslintrc.cjs
+++ b/.eslintrc.cjs
@@ -46,6 +46,6 @@ module.exports = {
     'max-classes-per-file': 0, // Multiple classes in one file are allowed (e.g. Errors)
     '@typescript-eslint/no-redeclare': 0, // I sometimes name variables an types the same
     'linebreak-style': 0, // Ignore linebreak lints https://stackoverflow.com/a/43008668/1129108
-    'import/extensions': ['error', 'always'], // ESM requires file extensions
+    'import/extensions': ['error', 'ignorePackages'], // ESM requires file extensions
   },
 }
diff --git a/examples/testing-suite/artifacts/example.json b/examples/testing-suite/artifacts/example.json
index 36e61dcd..b5b4bd75 100644
--- a/examples/testing-suite/artifacts/example.json
+++ b/examples/testing-suite/artifacts/example.json
@@ -24,7 +24,8 @@
         "data": [
           {
             "stackIndex": 0,
-            "type": "int"
+            "type": "int",
+            "ip": 0
           },
           "test"
         ]
@@ -40,7 +41,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.3"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-04-15T03:55:07.781Z"
-}
+  "updatedAt": "2024-08-06T09:59:35.164Z"
+}
\ No newline at end of file
diff --git a/examples/testing-suite/test/example.test.ts b/examples/testing-suite/test/example.test.ts
index 1ab83f28..731f5e22 100644
--- a/examples/testing-suite/test/example.test.ts
+++ b/examples/testing-suite/test/example.test.ts
@@ -1,6 +1,6 @@
 import artifact from '../artifacts/example.json' assert { type: 'json' };
 import { Contract, MockNetworkProvider, randomUtxo } from 'cashscript';
-import 'cashscript/dist/test/JestExtensions.js';
+import 'cashscript/jest';
 
 describe('test example contract functions', () => {
   it('should check for output logs and error messages', async () => {
diff --git a/packages/cashscript/.npmignore b/packages/cashscript/.npmignore
index 5be42fa8..4162c3ac 100644
--- a/packages/cashscript/.npmignore
+++ b/packages/cashscript/.npmignore
@@ -1,3 +1,4 @@
 *
 !dist/**
+!jest/package.json
 *.map
diff --git a/packages/cashscript/jest/package.json b/packages/cashscript/jest/package.json
new file mode 100644
index 00000000..f40996b5
--- /dev/null
+++ b/packages/cashscript/jest/package.json
@@ -0,0 +1,5 @@
+{
+  "type": "module",
+  "types": "../dist/test/JestExtensions.d.ts",
+  "main": "../dist/test/JestExtensions.js"
+}

From 392890932be71b438d4ad6d343ec2b34b46712a1 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 6 Aug 2024 12:02:42 +0200
Subject: [PATCH 088/267] Update Bitcoin-com/cashscript references to
 CashScript/cashscript

---
 README.md                        | 6 +++---
 packages/cashc/README.md         | 4 ++--
 packages/cashc/package.json      | 4 ++--
 packages/cashscript/README.md    | 2 +-
 packages/cashscript/package.json | 4 ++--
 packages/utils/README.md         | 4 ++--
 packages/utils/package.json      | 4 ++--
 website/docs/basics/compiler.md  | 4 ++--
 8 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index 9c203d23..a8cb0483 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # CashScript
 
-[![Build Status](https://travis-ci.org/Bitcoin-com/cashscript.svg)](https://travis-ci.org/Bitcoin-com/cashscript)
-[![Coverage Status](https://img.shields.io/codecov/c/github/Bitcoin-com/cashscript.svg)](https://codecov.io/gh/Bitcoin-com/cashscript/)
+[![Build Status](https://travis-ci.org/CashScript/cashscript.svg)](https://travis-ci.org/CashScript/cashscript)
+[![Coverage Status](https://img.shields.io/codecov/c/github/CashScript/cashscript.svg)](https://codecov.io/gh/CashScript/cashscript/)
 [![NPM Version](https://img.shields.io/npm/v/cashscript.svg)](https://www.npmjs.com/package/cashscript)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/cashscript.svg)](https://www.npmjs.com/package/cashscript)
 [![NPM License](https://img.shields.io/npm/l/cashscript.svg)](https://www.npmjs.com/package/cashscript)
@@ -94,7 +94,7 @@ The "Hello World" of CashScript contracts is defining the P2PKH pattern inside a
 To run the examples, clone this repository and navigate to the `examples/` directory. Since the examples depend on the SDK, be sure to run `npm install` or `yarn` inside the `examples/` directory, which installs all required packages.
 
 ```bash
-git clone git@github.com:Bitcoin-com/cashscript.git
+git clone git@github.com:CashScript/cashscript.git
 cd cashscript/examples
 npm install
 ```
diff --git a/packages/cashc/README.md b/packages/cashc/README.md
index bd336afc..33cdedae 100644
--- a/packages/cashc/README.md
+++ b/packages/cashc/README.md
@@ -1,7 +1,7 @@
 # CashScript
 
-[![Build Status](https://travis-ci.org/Bitcoin-com/cashscript.svg)](https://travis-ci.org/Bitcoin-com/cashscript)
-[![Coverage Status](https://img.shields.io/codecov/c/github/Bitcoin-com/cashscript.svg)](https://codecov.io/gh/Bitcoin-com/cashscript/)
+[![Build Status](https://travis-ci.org/CashScript/cashscript.svg)](https://travis-ci.org/CashScript/cashscript)
+[![Coverage Status](https://img.shields.io/codecov/c/github/CashScript/cashscript.svg)](https://codecov.io/gh/CashScript/cashscript/)
 [![NPM Version](https://img.shields.io/npm/v/cashscript.svg)](https://www.npmjs.com/package/cashscript)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/cashscript.svg)](https://www.npmjs.com/package/cashscript)
 [![NPM License](https://img.shields.io/npm/l/cashscript.svg)](https://www.npmjs.com/package/cashscript)
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 1193d65d..f6589e90 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -11,11 +11,11 @@
   ],
   "homepage": "https://cashscript.org",
   "bugs": {
-    "url": "https://github.com/Bitcoin-com/cashscript/issues"
+    "url": "https://github.com/CashScript/cashscript/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Bitcoin-com/cashscript.git"
+    "url": "git+https://github.com/CashScript/cashscript.git"
   },
   "license": "MIT",
   "author": "Rosco Kalis <roscokalis@gmail.com>",
diff --git a/packages/cashscript/README.md b/packages/cashscript/README.md
index ba38a3a6..1bbd4376 100644
--- a/packages/cashscript/README.md
+++ b/packages/cashscript/README.md
@@ -1,7 +1,7 @@
 # CashScript
 
 ![Build Status](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml/badge.svg)
-[![Coverage Status](https://img.shields.io/codecov/c/github/Bitcoin-com/cashscript.svg)](https://codecov.io/gh/Bitcoin-com/cashscript/)
+[![Coverage Status](https://img.shields.io/codecov/c/github/CashScript/cashscript.svg)](https://codecov.io/gh/CashScript/cashscript/)
 [![NPM Version](https://img.shields.io/npm/v/cashscript.svg)](https://www.npmjs.com/package/cashscript)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/cashscript.svg)](https://www.npmjs.com/package/cashscript)
 [![NPM License](https://img.shields.io/npm/l/cashscript.svg)](https://www.npmjs.com/package/cashscript)
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 0f2f8f65..d703f5ea 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -10,11 +10,11 @@
   ],
   "homepage": "https://cashscript.org",
   "bugs": {
-    "url": "https://github.com/Bitcoin-com/cashscript/issues"
+    "url": "https://github.com/CashScript/cashscript/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Bitcoin-com/cashscript.git"
+    "url": "git+https://github.com/CashScript/cashscript.git"
   },
   "license": "MIT",
   "author": "Rosco Kalis <roscokalis@gmail.com>",
diff --git a/packages/utils/README.md b/packages/utils/README.md
index 2aed4298..bb540adf 100644
--- a/packages/utils/README.md
+++ b/packages/utils/README.md
@@ -1,7 +1,7 @@
 # @cashscript/utils
 
-[![Build Status](https://travis-ci.org/Bitcoin-com/cashscript.svg)](https://travis-ci.org/Bitcoin-com/cashscript)
-[![Coverage Status](https://img.shields.io/codecov/c/github/Bitcoin-com/cashscript.svg)](https://codecov.io/gh/Bitcoin-com/cashscript)
+[![Build Status](https://travis-ci.org/CashScript/cashscript.svg)](https://travis-ci.org/CashScript/cashscript)
+[![Coverage Status](https://img.shields.io/codecov/c/github/CashScript/cashscript.svg)](https://codecov.io/gh/CashScript/cashscript)
 [![NPM Version](https://img.shields.io/npm/v/@cashscript/utils.svg)](https://www.npmjs.com/package/@cashscript/utils)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/@cashscript/utils.svg)](hhttps://www.npmjs.com/package/@cashscript/utils)
 [![NPM License](https://img.shields.io/npm/l/@cashscript/utils.svg)](https://www.npmjs.com/package/@cashscript/utils)
diff --git a/packages/utils/package.json b/packages/utils/package.json
index a73dc4c2..416643d7 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -10,11 +10,11 @@
   ],
   "homepage": "https://cashscript.org",
   "bugs": {
-    "url": "https://github.com/Bitcoin-com/cashscript/issues"
+    "url": "https://github.com/CashScript/cashscript/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Bitcoin-com/cashscript.git"
+    "url": "git+https://github.com/CashScript/cashscript.git"
   },
   "license": "MIT",
   "author": "Rosco Kalis <roscokalis@gmail.com>",
diff --git a/website/docs/basics/compiler.md b/website/docs/basics/compiler.md
index 5d6786c0..e451bf16 100644
--- a/website/docs/basics/compiler.md
+++ b/website/docs/basics/compiler.md
@@ -59,9 +59,9 @@ compileString(sourceCode: string): Artifact
 Compiles a CashScript contract from a source code string. This is the recommended compile method if you're building a webapp, because `compileFile()` only works from a Node.js context. This is also the recommended method if no source file is locally available (e.g. the source code is retrieved with a REST API).
 
 ```ts
-const baseUrl = 'https://raw.githubusercontent.com/Bitcoin-com/cashscript'
+const baseUrl = 'https://raw.githubusercontent.com/CashScript/cashscript'
 const result = await fetch(`${baseUrl}/master/examples/p2pkh.cash`);
 const source = await result.text();
 
 const P2PKH = compileString(source);
-```
\ No newline at end of file
+```

From 8ded3dfae9da8b4d33b793a4d67cf9596120c838 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 13 Aug 2024 10:55:05 +0200
Subject: [PATCH 089/267] Update dev dependencies

---
 package.json                     |   10 +-
 packages/cashc/package.json      |    2 +-
 packages/cashscript/package.json |    2 +-
 packages/utils/package.json      |    2 +-
 yarn.lock                        | 1843 ++++++++++++++++--------------
 5 files changed, 987 insertions(+), 872 deletions(-)

diff --git a/package.json b/package.json
index ebe88dd6..20554e15 100644
--- a/package.json
+++ b/package.json
@@ -11,17 +11,17 @@
     "@jest/reporters": "^26.6.2",
     "@types/jest": "^29.4.0",
     "@types/node": "^14.14.28",
-    "@typescript-eslint/eslint-plugin": "^6.12.0",
-    "@typescript-eslint/parser": "^6.12.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
     "chalk": "^4.1.0",
     "codecov": "^3.8.1",
     "cspell": "^5.2.4",
     "eslint": "^8.54.0",
-    "eslint-config-airbnb-typescript": "^17.1.0",
-    "eslint-plugin-import": "^2.29.0",
+    "eslint-config-airbnb-typescript": "^18.0.0",
+    "eslint-plugin-import": "^2.29.1",
     "lerna": "^3.22.1",
     "tsx": "^4.7.2",
-    "typescript": "^4.9.5"
+    "typescript": "^5.5.4"
   },
   "scripts": {
     "test": "lerna run test --ignore cashscript-examples --ignore testing-suite",
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index f6589e90..7142a7e0 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -62,7 +62,7 @@
     "cpy-cli": "^4.2.0",
     "eslint": "^8.54.0",
     "jest": "^29.4.1",
-    "typescript": "^4.1.5",
+    "typescript": "^5.5.4",
     "url-join": "^5.0.0"
   },
   "gitHead": "bf02a4b641d5d03c035d052247a545109c17b708"
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index d703f5ea..d687d0b1 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -59,7 +59,7 @@
     "bip39": "^3.0.4",
     "eslint": "^8.54.0",
     "jest": "^29.4.1",
-    "typescript": "^4.1.5"
+    "typescript": "^5.5.4"
   },
   "gitHead": "bf02a4b641d5d03c035d052247a545109c17b708"
 }
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 416643d7..99b90e6f 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -47,7 +47,7 @@
     "@jest/globals": "^29.4.1",
     "eslint": "^8.54.0",
     "jest": "^29.4.1",
-    "typescript": "^4.1.5"
+    "typescript": "^5.5.4"
   },
   "gitHead": "bf02a4b641d5d03c035d052247a545109c17b708"
 }
diff --git a/yarn.lock b/yarn.lock
index 0fb4e534..f3964ec9 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2,11 +2,6 @@
 # yarn lockfile v1
 
 
-"@aashutoshrathi/word-wrap@^1.2.3":
-  version "1.2.6"
-  resolved "https://registry.yarnpkg.com/@aashutoshrathi/word-wrap/-/word-wrap-1.2.6.tgz#bd9154aec9983f77b3a034ecaa015c2e4201f6cf"
-  integrity sha512-1Yjs2SvM8TflER/OD3cOjhWWOZb58A2t7wpE2S9XfBYTiIl+XFhQG2bjy4Pu1I+EAlCNUzRDYDdFwFYUKvXcIA==
-
 "@ampproject/remapping@^2.1.0":
   version "2.2.0"
   resolved "https://registry.yarnpkg.com/@ampproject/remapping/-/remapping-2.2.0.tgz#56c133824780de3174aed5ab6834f3026790154d"
@@ -22,7 +17,15 @@
   dependencies:
     "@babel/highlight" "^7.10.4"
 
-"@babel/code-frame@^7.12.13", "@babel/code-frame@^7.18.6":
+"@babel/code-frame@^7.12.13":
+  version "7.24.7"
+  resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.24.7.tgz#882fd9e09e8ee324e496bd040401c6f046ef4465"
+  integrity sha512-BcYH1CVJBO9tvyIZ2jVeXgSIMvGZ2FDRvDdOIVQyuklNKSsx+eppDEBq/g47Ayw+RqNFE+URvOShmf+f/qwAlA==
+  dependencies:
+    "@babel/highlight" "^7.24.7"
+    picocolors "^1.0.0"
+
+"@babel/code-frame@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.18.6.tgz#3b25d38c89600baa2dcc219edfa88a74eb2c427a"
   integrity sha512-TDCmlK5eOvH+eH7cdAFlNXeVJqWIQ7gW9tY1GJIpUtFb6CmjVyq2VM3u71bOyR8CRihcCgMUYoDNyLXao3+70Q==
@@ -261,11 +264,16 @@
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.10.4.tgz#a78c7a7251e01f616512d31b10adcf52ada5e0d2"
   integrity sha512-3U9y+43hz7ZM+rzG24Qe2mufW5KhvFg/NhnNph+i9mgCtdTCtMJuI1TMkrIUiK7Ix4PYlRF9I5dhqaLYA/ADXw==
 
-"@babel/helper-validator-identifier@^7.18.6", "@babel/helper-validator-identifier@^7.19.1":
+"@babel/helper-validator-identifier@^7.19.1":
   version "7.19.1"
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.19.1.tgz#7eea834cf32901ffdc1a7ee555e2f9c27e249ca2"
   integrity sha512-awrNfaMtnHUr653GgGEs++LlAvW6w+DcPrOliSMXWCKo597CwL5Acf/wWdNkf/tfEQE3mjkeD1YOVZOUV/od1w==
 
+"@babel/helper-validator-identifier@^7.24.7":
+  version "7.24.7"
+  resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.24.7.tgz#75b889cfaf9e35c2aaf42cf0d72c8e91719251db"
+  integrity sha512-rR+PBcQ1SMQDDyF6X0wxtG8QyLCgUB0eRAGguqRLfkCA87l7yAP7ehq8SNj96OOGTO8OBV70KhuFYcIkHXOg0w==
+
 "@babel/helper-validator-option@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-option/-/helper-validator-option-7.18.6.tgz#bf0d2b5a509b1f336099e4ff36e1a63aa5db4db8"
@@ -298,14 +306,15 @@
     chalk "^2.0.0"
     js-tokens "^4.0.0"
 
-"@babel/highlight@^7.18.6":
-  version "7.18.6"
-  resolved "https://registry.yarnpkg.com/@babel/highlight/-/highlight-7.18.6.tgz#81158601e93e2563795adcbfbdf5d64be3f2ecdf"
-  integrity sha512-u7stbOuYjaPezCuLj29hNW1v64M2Md2qupEKP1fHc7WdOA3DgLh37suiSrZYY7haUB7iBeQZ9P1uiRF359do3g==
+"@babel/highlight@^7.18.6", "@babel/highlight@^7.24.7":
+  version "7.24.7"
+  resolved "https://registry.yarnpkg.com/@babel/highlight/-/highlight-7.24.7.tgz#a05ab1df134b286558aae0ed41e6c5f731bf409d"
+  integrity sha512-EStJpq4OuY8xYfhGVXngigBJRWxftKX9ksiGDnmlY3o7B/V7KIAc9X4oiK87uPJSc/vs5L869bem5fhZa8caZw==
   dependencies:
-    "@babel/helper-validator-identifier" "^7.18.6"
-    chalk "^2.0.0"
+    "@babel/helper-validator-identifier" "^7.24.7"
+    chalk "^2.4.2"
     js-tokens "^4.0.0"
+    picocolors "^1.0.0"
 
 "@babel/parser@^7.1.0", "@babel/parser@^7.10.4", "@babel/parser@^7.11.0", "@babel/parser@^7.11.4":
   version "7.11.4"
@@ -714,120 +723,125 @@
   resolved "https://registry.yarnpkg.com/@cspell/dict-typescript/-/dict-typescript-1.0.16.tgz#18d20a91c4caf52540c795921a50b0e4ce3bc50c"
   integrity sha512-DEKi6vD605ebDhCC4Hrtz29k59TcijPVsmVKheTpMrL1MD/S96Ftb19gW0pEIVK9vwYZIljmGwgz4qYyuM5Liw==
 
-"@esbuild/aix-ppc64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/aix-ppc64/-/aix-ppc64-0.19.12.tgz#d1bc06aedb6936b3b6d313bf809a5a40387d2b7f"
-  integrity sha512-bmoCYyWdEL3wDQIVbcyzRyeKLgk2WtWLTWz1ZIAZF/EGbNOwSA6ew3PftJ1PqMiOOGu0OyFMzG53L0zqIpPeNA==
-
-"@esbuild/android-arm64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/android-arm64/-/android-arm64-0.19.12.tgz#7ad65a36cfdb7e0d429c353e00f680d737c2aed4"
-  integrity sha512-P0UVNGIienjZv3f5zq0DP3Nt2IE/3plFzuaS96vihvD0Hd6H/q4WXUGpCxD/E8YrSXfNyRPbpTq+T8ZQioSuPA==
-
-"@esbuild/android-arm@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/android-arm/-/android-arm-0.19.12.tgz#b0c26536f37776162ca8bde25e42040c203f2824"
-  integrity sha512-qg/Lj1mu3CdQlDEEiWrlC4eaPZ1KztwGJ9B6J+/6G+/4ewxJg7gqj8eVYWvao1bXrqGiW2rsBZFSX3q2lcW05w==
-
-"@esbuild/android-x64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/android-x64/-/android-x64-0.19.12.tgz#cb13e2211282012194d89bf3bfe7721273473b3d"
-  integrity sha512-3k7ZoUW6Q6YqhdhIaq/WZ7HwBpnFBlW905Fa4s4qWJyiNOgT1dOqDiVAQFwBH7gBRZr17gLrlFCRzF6jFh7Kew==
-
-"@esbuild/darwin-arm64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/darwin-arm64/-/darwin-arm64-0.19.12.tgz#cbee41e988020d4b516e9d9e44dd29200996275e"
-  integrity sha512-B6IeSgZgtEzGC42jsI+YYu9Z3HKRxp8ZT3cqhvliEHovq8HSX2YX8lNocDn79gCKJXOSaEot9MVYky7AKjCs8g==
-
-"@esbuild/darwin-x64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/darwin-x64/-/darwin-x64-0.19.12.tgz#e37d9633246d52aecf491ee916ece709f9d5f4cd"
-  integrity sha512-hKoVkKzFiToTgn+41qGhsUJXFlIjxI/jSYeZf3ugemDYZldIXIxhvwN6erJGlX4t5h417iFuheZ7l+YVn05N3A==
-
-"@esbuild/freebsd-arm64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.19.12.tgz#1ee4d8b682ed363b08af74d1ea2b2b4dbba76487"
-  integrity sha512-4aRvFIXmwAcDBw9AueDQ2YnGmz5L6obe5kmPT8Vd+/+x/JMVKCgdcRwH6APrbpNXsPz+K653Qg8HB/oXvXVukA==
-
-"@esbuild/freebsd-x64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-x64/-/freebsd-x64-0.19.12.tgz#37a693553d42ff77cd7126764b535fb6cc28a11c"
-  integrity sha512-EYoXZ4d8xtBoVN7CEwWY2IN4ho76xjYXqSXMNccFSx2lgqOG/1TBPW0yPx1bJZk94qu3tX0fycJeeQsKovA8gg==
-
-"@esbuild/linux-arm64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm64/-/linux-arm64-0.19.12.tgz#be9b145985ec6c57470e0e051d887b09dddb2d4b"
-  integrity sha512-EoTjyYyLuVPfdPLsGVVVC8a0p1BFFvtpQDB/YLEhaXyf/5bczaGeN15QkR+O4S5LeJ92Tqotve7i1jn35qwvdA==
-
-"@esbuild/linux-arm@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm/-/linux-arm-0.19.12.tgz#207ecd982a8db95f7b5279207d0ff2331acf5eef"
-  integrity sha512-J5jPms//KhSNv+LO1S1TX1UWp1ucM6N6XuL6ITdKWElCu8wXP72l9MM0zDTzzeikVyqFE6U8YAV9/tFyj0ti+w==
-
-"@esbuild/linux-ia32@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-ia32/-/linux-ia32-0.19.12.tgz#d0d86b5ca1562523dc284a6723293a52d5860601"
-  integrity sha512-Thsa42rrP1+UIGaWz47uydHSBOgTUnwBwNq59khgIwktK6x60Hivfbux9iNR0eHCHzOLjLMLfUMLCypBkZXMHA==
-
-"@esbuild/linux-loong64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-loong64/-/linux-loong64-0.19.12.tgz#9a37f87fec4b8408e682b528391fa22afd952299"
-  integrity sha512-LiXdXA0s3IqRRjm6rV6XaWATScKAXjI4R4LoDlvO7+yQqFdlr1Bax62sRwkVvRIrwXxvtYEHHI4dm50jAXkuAA==
-
-"@esbuild/linux-mips64el@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-mips64el/-/linux-mips64el-0.19.12.tgz#4ddebd4e6eeba20b509d8e74c8e30d8ace0b89ec"
-  integrity sha512-fEnAuj5VGTanfJ07ff0gOA6IPsvrVHLVb6Lyd1g2/ed67oU1eFzL0r9WL7ZzscD+/N6i3dWumGE1Un4f7Amf+w==
-
-"@esbuild/linux-ppc64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-ppc64/-/linux-ppc64-0.19.12.tgz#adb67dadb73656849f63cd522f5ecb351dd8dee8"
-  integrity sha512-nYJA2/QPimDQOh1rKWedNOe3Gfc8PabU7HT3iXWtNUbRzXS9+vgB0Fjaqr//XNbd82mCxHzik2qotuI89cfixg==
-
-"@esbuild/linux-riscv64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-riscv64/-/linux-riscv64-0.19.12.tgz#11bc0698bf0a2abf8727f1c7ace2112612c15adf"
-  integrity sha512-2MueBrlPQCw5dVJJpQdUYgeqIzDQgw3QtiAHUC4RBz9FXPrskyyU3VI1hw7C0BSKB9OduwSJ79FTCqtGMWqJHg==
-
-"@esbuild/linux-s390x@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-s390x/-/linux-s390x-0.19.12.tgz#e86fb8ffba7c5c92ba91fc3b27ed5a70196c3cc8"
-  integrity sha512-+Pil1Nv3Umes4m3AZKqA2anfhJiVmNCYkPchwFJNEJN5QxmTs1uzyy4TvmDrCRNT2ApwSari7ZIgrPeUx4UZDg==
-
-"@esbuild/linux-x64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-x64/-/linux-x64-0.19.12.tgz#5f37cfdc705aea687dfe5dfbec086a05acfe9c78"
-  integrity sha512-B71g1QpxfwBvNrfyJdVDexenDIt1CiDN1TIXLbhOw0KhJzE78KIFGX6OJ9MrtC0oOqMWf+0xop4qEU8JrJTwCg==
-
-"@esbuild/netbsd-x64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/netbsd-x64/-/netbsd-x64-0.19.12.tgz#29da566a75324e0d0dd7e47519ba2f7ef168657b"
-  integrity sha512-3ltjQ7n1owJgFbuC61Oj++XhtzmymoCihNFgT84UAmJnxJfm4sYCiSLTXZtE00VWYpPMYc+ZQmB6xbSdVh0JWA==
-
-"@esbuild/openbsd-x64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/openbsd-x64/-/openbsd-x64-0.19.12.tgz#306c0acbdb5a99c95be98bdd1d47c916e7dc3ff0"
-  integrity sha512-RbrfTB9SWsr0kWmb9srfF+L933uMDdu9BIzdA7os2t0TXhCRjrQyCeOt6wVxr79CKD4c+p+YhCj31HBkYcXebw==
-
-"@esbuild/sunos-x64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/sunos-x64/-/sunos-x64-0.19.12.tgz#0933eaab9af8b9b2c930236f62aae3fc593faf30"
-  integrity sha512-HKjJwRrW8uWtCQnQOz9qcU3mUZhTUQvi56Q8DPTLLB+DawoiQdjsYq+j+D3s9I8VFtDr+F9CjgXKKC4ss89IeA==
-
-"@esbuild/win32-arm64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/win32-arm64/-/win32-arm64-0.19.12.tgz#773bdbaa1971b36db2f6560088639ccd1e6773ae"
-  integrity sha512-URgtR1dJnmGvX864pn1B2YUYNzjmXkuJOIqG2HdU62MVS4EHpU2946OZoTMnRUHklGtJdJZ33QfzdjGACXhn1A==
-
-"@esbuild/win32-ia32@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/win32-ia32/-/win32-ia32-0.19.12.tgz#000516cad06354cc84a73f0943a4aa690ef6fd67"
-  integrity sha512-+ZOE6pUkMOJfmxmBZElNOx72NKpIa/HFOMGzu8fqzQJ5kgf6aTGrcJaFsNiVMH4JKpMipyK+7k0n2UXN7a8YKQ==
-
-"@esbuild/win32-x64@0.19.12":
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/@esbuild/win32-x64/-/win32-x64-0.19.12.tgz#c57c8afbb4054a3ab8317591a0b7320360b444ae"
-  integrity sha512-T1QyPSDCyMXaO3pzBkF96E8xMkiRYbUEZADd29SyPGabqxMViNoii+NcK7eWJAEoU6RZyEm5lVSIjTmcdoB9HA==
+"@esbuild/aix-ppc64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/aix-ppc64/-/aix-ppc64-0.23.0.tgz#145b74d5e4a5223489cabdc238d8dad902df5259"
+  integrity sha512-3sG8Zwa5fMcA9bgqB8AfWPQ+HFke6uD3h1s3RIwUNK8EG7a4buxvuFTs3j1IMs2NXAk9F30C/FF4vxRgQCcmoQ==
+
+"@esbuild/android-arm64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-arm64/-/android-arm64-0.23.0.tgz#453bbe079fc8d364d4c5545069e8260228559832"
+  integrity sha512-EuHFUYkAVfU4qBdyivULuu03FhJO4IJN9PGuABGrFy4vUuzk91P2d+npxHcFdpUnfYKy0PuV+n6bKIpHOB3prQ==
+
+"@esbuild/android-arm@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-arm/-/android-arm-0.23.0.tgz#26c806853aa4a4f7e683e519cd9d68e201ebcf99"
+  integrity sha512-+KuOHTKKyIKgEEqKbGTK8W7mPp+hKinbMBeEnNzjJGyFcWsfrXjSTNluJHCY1RqhxFurdD8uNXQDei7qDlR6+g==
+
+"@esbuild/android-x64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-x64/-/android-x64-0.23.0.tgz#1e51af9a6ac1f7143769f7ee58df5b274ed202e6"
+  integrity sha512-WRrmKidLoKDl56LsbBMhzTTBxrsVwTKdNbKDalbEZr0tcsBgCLbEtoNthOW6PX942YiYq8HzEnb4yWQMLQuipQ==
+
+"@esbuild/darwin-arm64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/darwin-arm64/-/darwin-arm64-0.23.0.tgz#d996187a606c9534173ebd78c58098a44dd7ef9e"
+  integrity sha512-YLntie/IdS31H54Ogdn+v50NuoWF5BDkEUFpiOChVa9UnKpftgwzZRrI4J132ETIi+D8n6xh9IviFV3eXdxfow==
+
+"@esbuild/darwin-x64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/darwin-x64/-/darwin-x64-0.23.0.tgz#30c8f28a7ef4e32fe46501434ebe6b0912e9e86c"
+  integrity sha512-IMQ6eme4AfznElesHUPDZ+teuGwoRmVuuixu7sv92ZkdQcPbsNHzutd+rAfaBKo8YK3IrBEi9SLLKWJdEvJniQ==
+
+"@esbuild/freebsd-arm64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.23.0.tgz#30f4fcec8167c08a6e8af9fc14b66152232e7fb4"
+  integrity sha512-0muYWCng5vqaxobq6LB3YNtevDFSAZGlgtLoAc81PjUfiFz36n4KMpwhtAd4he8ToSI3TGyuhyx5xmiWNYZFyw==
+
+"@esbuild/freebsd-x64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-x64/-/freebsd-x64-0.23.0.tgz#1003a6668fe1f5d4439e6813e5b09a92981bc79d"
+  integrity sha512-XKDVu8IsD0/q3foBzsXGt/KjD/yTKBCIwOHE1XwiXmrRwrX6Hbnd5Eqn/WvDekddK21tfszBSrE/WMaZh+1buQ==
+
+"@esbuild/linux-arm64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm64/-/linux-arm64-0.23.0.tgz#3b9a56abfb1410bb6c9138790f062587df3e6e3a"
+  integrity sha512-j1t5iG8jE7BhonbsEg5d9qOYcVZv/Rv6tghaXM/Ug9xahM0nX/H2gfu6X6z11QRTMT6+aywOMA8TDkhPo8aCGw==
+
+"@esbuild/linux-arm@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm/-/linux-arm-0.23.0.tgz#237a8548e3da2c48cd79ae339a588f03d1889aad"
+  integrity sha512-SEELSTEtOFu5LPykzA395Mc+54RMg1EUgXP+iw2SJ72+ooMwVsgfuwXo5Fn0wXNgWZsTVHwY2cg4Vi/bOD88qw==
+
+"@esbuild/linux-ia32@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-ia32/-/linux-ia32-0.23.0.tgz#4269cd19cb2de5de03a7ccfc8855dde3d284a238"
+  integrity sha512-P7O5Tkh2NbgIm2R6x1zGJJsnacDzTFcRWZyTTMgFdVit6E98LTxO+v8LCCLWRvPrjdzXHx9FEOA8oAZPyApWUA==
+
+"@esbuild/linux-loong64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-loong64/-/linux-loong64-0.23.0.tgz#82b568f5658a52580827cc891cb69d2cb4f86280"
+  integrity sha512-InQwepswq6urikQiIC/kkx412fqUZudBO4SYKu0N+tGhXRWUqAx+Q+341tFV6QdBifpjYgUndV1hhMq3WeJi7A==
+
+"@esbuild/linux-mips64el@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-mips64el/-/linux-mips64el-0.23.0.tgz#9a57386c926262ae9861c929a6023ed9d43f73e5"
+  integrity sha512-J9rflLtqdYrxHv2FqXE2i1ELgNjT+JFURt/uDMoPQLcjWQA5wDKgQA4t/dTqGa88ZVECKaD0TctwsUfHbVoi4w==
+
+"@esbuild/linux-ppc64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-ppc64/-/linux-ppc64-0.23.0.tgz#f3a79fd636ba0c82285d227eb20ed8e31b4444f6"
+  integrity sha512-cShCXtEOVc5GxU0fM+dsFD10qZ5UpcQ8AM22bYj0u/yaAykWnqXJDpd77ublcX6vdDsWLuweeuSNZk4yUxZwtw==
+
+"@esbuild/linux-riscv64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-riscv64/-/linux-riscv64-0.23.0.tgz#f9d2ef8356ce6ce140f76029680558126b74c780"
+  integrity sha512-HEtaN7Y5UB4tZPeQmgz/UhzoEyYftbMXrBCUjINGjh3uil+rB/QzzpMshz3cNUxqXN7Vr93zzVtpIDL99t9aRw==
+
+"@esbuild/linux-s390x@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-s390x/-/linux-s390x-0.23.0.tgz#45390f12e802201f38a0229e216a6aed4351dfe8"
+  integrity sha512-WDi3+NVAuyjg/Wxi+o5KPqRbZY0QhI9TjrEEm+8dmpY9Xir8+HE/HNx2JoLckhKbFopW0RdO2D72w8trZOV+Wg==
+
+"@esbuild/linux-x64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-x64/-/linux-x64-0.23.0.tgz#c8409761996e3f6db29abcf9b05bee8d7d80e910"
+  integrity sha512-a3pMQhUEJkITgAw6e0bWA+F+vFtCciMjW/LPtoj99MhVt+Mfb6bbL9hu2wmTZgNd994qTAEw+U/r6k3qHWWaOQ==
+
+"@esbuild/netbsd-x64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/netbsd-x64/-/netbsd-x64-0.23.0.tgz#ba70db0114380d5f6cfb9003f1d378ce989cd65c"
+  integrity sha512-cRK+YDem7lFTs2Q5nEv/HHc4LnrfBCbH5+JHu6wm2eP+d8OZNoSMYgPZJq78vqQ9g+9+nMuIsAO7skzphRXHyw==
+
+"@esbuild/openbsd-arm64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/openbsd-arm64/-/openbsd-arm64-0.23.0.tgz#72fc55f0b189f7a882e3cf23f332370d69dfd5db"
+  integrity sha512-suXjq53gERueVWu0OKxzWqk7NxiUWSUlrxoZK7usiF50C6ipColGR5qie2496iKGYNLhDZkPxBI3erbnYkU0rQ==
+
+"@esbuild/openbsd-x64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/openbsd-x64/-/openbsd-x64-0.23.0.tgz#b6ae7a0911c18fe30da3db1d6d17a497a550e5d8"
+  integrity sha512-6p3nHpby0DM/v15IFKMjAaayFhqnXV52aEmv1whZHX56pdkK+MEaLoQWj+H42ssFarP1PcomVhbsR4pkz09qBg==
+
+"@esbuild/sunos-x64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/sunos-x64/-/sunos-x64-0.23.0.tgz#58f0d5e55b9b21a086bfafaa29f62a3eb3470ad8"
+  integrity sha512-BFelBGfrBwk6LVrmFzCq1u1dZbG4zy/Kp93w2+y83Q5UGYF1d8sCzeLI9NXjKyujjBBniQa8R8PzLFAUrSM9OA==
+
+"@esbuild/win32-arm64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-arm64/-/win32-arm64-0.23.0.tgz#b858b2432edfad62e945d5c7c9e5ddd0f528ca6d"
+  integrity sha512-lY6AC8p4Cnb7xYHuIxQ6iYPe6MfO2CC43XXKo9nBXDb35krYt7KGhQnOkRGar5psxYkircpCqfbNDB4uJbS2jQ==
+
+"@esbuild/win32-ia32@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-ia32/-/win32-ia32-0.23.0.tgz#167ef6ca22a476c6c0c014a58b4f43ae4b80dec7"
+  integrity sha512-7L1bHlOTcO4ByvI7OXVI5pNN6HSu6pUQq9yodga8izeuB1KcT2UkHaH6118QJwopExPn0rMHIseCTx1CRo/uNA==
+
+"@esbuild/win32-x64@0.23.0":
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-x64/-/win32-x64-0.23.0.tgz#db44a6a08520b5f25bbe409f34a59f2d4bcc7ced"
+  integrity sha512-Arm+WgUFLUATuoxCJcahGuk6Yj9Pzxd6l11Zb/2aAuv5kWWvvfhLFo2fni4uSK5vzlUdCGZ/BdV5tH8klj8p8g==
 
 "@eslint-community/eslint-utils@^4.2.0", "@eslint-community/eslint-utils@^4.4.0":
   version "4.4.0"
@@ -836,25 +850,10 @@
   dependencies:
     eslint-visitor-keys "^3.3.0"
 
-"@eslint-community/regexpp@^4.5.1", "@eslint-community/regexpp@^4.6.1":
-  version "4.10.0"
-  resolved "https://registry.yarnpkg.com/@eslint-community/regexpp/-/regexpp-4.10.0.tgz#548f6de556857c8bb73bbee70c35dc82a2e74d63"
-  integrity sha512-Cu96Sd2By9mCNTx2iyKOmq10v22jUVQv0lQnlGNy16oE9589yE+QADPbrMGCkA51cKZSg3Pu/aTJVTGfL/qjUA==
-
-"@eslint/eslintrc@^2.1.3":
-  version "2.1.3"
-  resolved "https://registry.yarnpkg.com/@eslint/eslintrc/-/eslintrc-2.1.3.tgz#797470a75fe0fbd5a53350ee715e85e87baff22d"
-  integrity sha512-yZzuIG+jnVu6hNSzFEN07e8BxF3uAzYtQb6uDkaYZLo6oYZDCq454c5kB8zxnzfCYyP4MIuyBn10L0DqwujTmA==
-  dependencies:
-    ajv "^6.12.4"
-    debug "^4.3.2"
-    espree "^9.6.0"
-    globals "^13.19.0"
-    ignore "^5.2.0"
-    import-fresh "^3.2.1"
-    js-yaml "^4.1.0"
-    minimatch "^3.1.2"
-    strip-json-comments "^3.1.1"
+"@eslint-community/regexpp@^4.10.0", "@eslint-community/regexpp@^4.6.1":
+  version "4.11.0"
+  resolved "https://registry.yarnpkg.com/@eslint-community/regexpp/-/regexpp-4.11.0.tgz#b0ffd0312b4a3fd2d6f77237e7248a5ad3a680ae"
+  integrity sha512-G/M/tIiMrTAxEWRfLfQJMmGNX28IxBg4PBz8XqQhqUHLFI6TL2htpIB1iQCj144V5ee/JaKyT9/WZ0MGZWfA7A==
 
 "@eslint/eslintrc@^2.1.4":
   version "2.1.4"
@@ -871,16 +870,16 @@
     minimatch "^3.1.2"
     strip-json-comments "^3.1.1"
 
-"@eslint/js@8.54.0":
-  version "8.54.0"
-  resolved "https://registry.yarnpkg.com/@eslint/js/-/js-8.54.0.tgz#4fab9a2ff7860082c304f750e94acd644cf984cf"
-  integrity sha512-ut5V+D+fOoWPgGGNj83GGjnntO39xDy6DWxO0wb7Jp3DcMX0TfIqdzHF85VTQkerdyGmuuMD9AKAo5KiNlf/AQ==
-
 "@eslint/js@8.56.0":
   version "8.56.0"
   resolved "https://registry.yarnpkg.com/@eslint/js/-/js-8.56.0.tgz#ef20350fec605a7f7035a01764731b2de0f3782b"
   integrity sha512-gMsVel9D7f2HLkBma9VbtzZRehRogVRfbr++f06nL2vnCGCNlzOD+/MUov/F4p8myyAHspEhVobgjpX64q5m6A==
 
+"@eslint/js@8.57.0":
+  version "8.57.0"
+  resolved "https://registry.yarnpkg.com/@eslint/js/-/js-8.57.0.tgz#a5417ae8427873f1dd08b70b3574b453e67b5f7f"
+  integrity sha512-Ys+3g2TaW7gADOJzPt83SJtCDhMjndcDMFVQ/Tj9iA1BfJzFKD9mAUXT3OenpuPHbI6P/myECxRJrofUsDx/5g==
+
 "@evocateur/libnpmaccess@^3.1.2":
   version "3.1.2"
   resolved "https://registry.yarnpkg.com/@evocateur/libnpmaccess/-/libnpmaccess-3.1.2.tgz#ecf7f6ce6b004e9f942b098d92200be4a4b1c845"
@@ -955,13 +954,13 @@
     unique-filename "^1.1.1"
     which "^1.3.1"
 
-"@humanwhocodes/config-array@^0.11.13":
-  version "0.11.13"
-  resolved "https://registry.yarnpkg.com/@humanwhocodes/config-array/-/config-array-0.11.13.tgz#075dc9684f40a531d9b26b0822153c1e832ee297"
-  integrity sha512-JSBDMiDKSzQVngfRjOdFXgFfklaXI4K9nLF49Auh21lmBWRLIK3+xTErTWD4KU54pb6coM6ESE7Awz/FNU3zgQ==
+"@humanwhocodes/config-array@^0.11.13", "@humanwhocodes/config-array@^0.11.14":
+  version "0.11.14"
+  resolved "https://registry.yarnpkg.com/@humanwhocodes/config-array/-/config-array-0.11.14.tgz#d78e481a039f7566ecc9660b4ea7fe6b1fec442b"
+  integrity sha512-3T8LkOmg45BV5FICb15QQMsyUSWrQ8AygVfC7ZG32zOalnqrilm018ZVCw0eapXux8FtA33q8PSRSstjee3jSg==
   dependencies:
-    "@humanwhocodes/object-schema" "^2.0.1"
-    debug "^4.1.1"
+    "@humanwhocodes/object-schema" "^2.0.2"
+    debug "^4.3.1"
     minimatch "^3.0.5"
 
 "@humanwhocodes/module-importer@^1.0.1":
@@ -969,10 +968,10 @@
   resolved "https://registry.yarnpkg.com/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz#af5b2691a22b44be847b0ca81641c5fb6ad0172c"
   integrity sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==
 
-"@humanwhocodes/object-schema@^2.0.1":
-  version "2.0.1"
-  resolved "https://registry.yarnpkg.com/@humanwhocodes/object-schema/-/object-schema-2.0.1.tgz#e5211452df060fa8522b55c7b3c0c4d1981cb044"
-  integrity sha512-dvuCeX5fC9dXgJn9t+X5atfmgQAzUOWqS1254Gh0m6i8wKd10ebXkfNKiRK+1GWi/yTvvLDHpoxLr0xxxeslWw==
+"@humanwhocodes/object-schema@^2.0.2":
+  version "2.0.3"
+  resolved "https://registry.yarnpkg.com/@humanwhocodes/object-schema/-/object-schema-2.0.3.tgz#4a2868d75d6d6963e423bcf90b7fd1be343409d3"
+  integrity sha512-93zYdMES/c1D69yZiKDBj0V24vqNzB/koF26KPaagAfd3P/4gUlh3Dys5ogAK+Exi9QyzlD8x/08Zt7wIKcDcA==
 
 "@istanbuljs/load-nyc-config@^1.0.0":
   version "1.1.0"
@@ -1065,12 +1064,12 @@
   dependencies:
     jest-get-type "^29.2.0"
 
-"@jest/expect-utils@^29.4.2":
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/@jest/expect-utils/-/expect-utils-29.4.2.tgz#cd0065dfdd8e8a182aa350cc121db97b5eed7b3f"
-  integrity sha512-Dd3ilDJpBnqa0GiPN7QrudVs0cczMMHtehSo2CSTjm3zdHx0RcpmhFNVEltuEFeqfLIyWKFI224FsMSQ/nsJQA==
+"@jest/expect-utils@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/expect-utils/-/expect-utils-29.7.0.tgz#023efe5d26a8a70f21677d0a1afc0f0a44e3a1c6"
+  integrity sha512-GlsNBWiFQFCVi9QVSx7f5AgMeLxe9YCCs5PuP2O2LdjDAA8Jh9eX7lA1Jq/xdXw3Wb3hyvlFNfZIfcRetSzYcA==
   dependencies:
-    jest-get-type "^29.4.2"
+    jest-get-type "^29.6.3"
 
 "@jest/expect@^29.4.1":
   version "29.4.1"
@@ -1171,12 +1170,12 @@
   dependencies:
     "@sinclair/typebox" "^0.25.16"
 
-"@jest/schemas@^29.4.2":
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/@jest/schemas/-/schemas-29.4.2.tgz#cf7cfe97c5649f518452b176c47ed07486270fc1"
-  integrity sha512-ZrGzGfh31NtdVH8tn0mgJw4khQuNHiKqdzJAFbCaERbyCP9tHlxWuL/mnMu8P7e/+k4puWjI1NOzi/sFsjce/g==
+"@jest/schemas@^29.6.3":
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/@jest/schemas/-/schemas-29.6.3.tgz#430b5ce8a4e0044a7e3819663305a7b3091c8e03"
+  integrity sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==
   dependencies:
-    "@sinclair/typebox" "^0.25.16"
+    "@sinclair/typebox" "^0.27.8"
 
 "@jest/source-map@^29.2.0":
   version "29.2.0"
@@ -1282,12 +1281,12 @@
     "@types/yargs" "^17.0.8"
     chalk "^4.0.0"
 
-"@jest/types@^29.4.2":
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/@jest/types/-/types-29.4.2.tgz#8f724a414b1246b2bfd56ca5225d9e1f39540d82"
-  integrity sha512-CKlngyGP0fwlgC1BRUtPZSiWLBhyS9dKwKmyGxk8Z6M82LBEGB2aLQSg+U1MyLsU+M7UjnlLllBM2BLWKVm/Uw==
+"@jest/types@^29.6.3":
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/@jest/types/-/types-29.6.3.tgz#1131f8cf634e7e84c5e77bab12f052af585fba59"
+  integrity sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==
   dependencies:
-    "@jest/schemas" "^29.4.2"
+    "@jest/schemas" "^29.6.3"
     "@types/istanbul-lib-coverage" "^2.0.0"
     "@types/istanbul-reports" "^3.0.0"
     "@types/node" "*"
@@ -2050,14 +2049,6 @@
     call-me-maybe "^1.0.1"
     glob-to-regexp "^0.3.0"
 
-"@nodelib/fs.scandir@2.1.4":
-  version "2.1.4"
-  resolved "https://registry.yarnpkg.com/@nodelib/fs.scandir/-/fs.scandir-2.1.4.tgz#d4b3549a5db5de2683e0c1071ab4f140904bbf69"
-  integrity sha512-33g3pMJk3bg5nXbL/+CY6I2eJDzZAni49PfJnL5fghPTggPvBd/pFNSgJsdAgWptuFu7qq/ERvOYFlhvsLTCKA==
-  dependencies:
-    "@nodelib/fs.stat" "2.0.4"
-    run-parallel "^1.1.9"
-
 "@nodelib/fs.scandir@2.1.5":
   version "2.1.5"
   resolved "https://registry.yarnpkg.com/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz#7619c2eb21b25483f6d167548b4cfd5a7488c3d5"
@@ -2066,12 +2057,7 @@
     "@nodelib/fs.stat" "2.0.5"
     run-parallel "^1.1.9"
 
-"@nodelib/fs.stat@2.0.4", "@nodelib/fs.stat@^2.0.2":
-  version "2.0.4"
-  resolved "https://registry.yarnpkg.com/@nodelib/fs.stat/-/fs.stat-2.0.4.tgz#a3f2dd61bab43b8db8fa108a121cfffe4c676655"
-  integrity sha512-IYlHJA0clt2+Vg7bccq+TzRdJvv19c2INqBSsoOLp1je7xjtr7J26+WXR72MCdvU9q1qTzIWDfhMf+DRvQJK4Q==
-
-"@nodelib/fs.stat@2.0.5":
+"@nodelib/fs.stat@2.0.5", "@nodelib/fs.stat@^2.0.2":
   version "2.0.5"
   resolved "https://registry.yarnpkg.com/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz#5bd262af94e9d25bd1e71b05deed44876a222e8b"
   integrity sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==
@@ -2081,15 +2067,7 @@
   resolved "https://registry.yarnpkg.com/@nodelib/fs.stat/-/fs.stat-1.1.3.tgz#2b5a3ab3f918cca48a8c754c08168e3f03eba61b"
   integrity sha512-shAmDyaQC4H92APFoIaVDHCx5bStIocgvbwQyxPRrbUY20V1EYTbSDchWbuwlMG3V17cprZhA6+78JfB+3DTPw==
 
-"@nodelib/fs.walk@^1.2.3":
-  version "1.2.6"
-  resolved "https://registry.yarnpkg.com/@nodelib/fs.walk/-/fs.walk-1.2.6.tgz#cce9396b30aa5afe9e3756608f5831adcb53d063"
-  integrity sha512-8Broas6vTtW4GIXTAHDoE32hnN2M5ykgCpWGbuXHQ15vEMqr23pB76e/GZcYsZCHALv50ktd24qhEyKr6wBtow==
-  dependencies:
-    "@nodelib/fs.scandir" "2.1.4"
-    fastq "^1.6.0"
-
-"@nodelib/fs.walk@^1.2.8":
+"@nodelib/fs.walk@^1.2.3", "@nodelib/fs.walk@^1.2.8":
   version "1.2.8"
   resolved "https://registry.yarnpkg.com/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz#e95737e8bb6746ddedf69c556953494f196fe69a"
   integrity sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==
@@ -2313,9 +2291,14 @@
     "@psf/bitcoincash-ops" "^2.0.0"
 
 "@sinclair/typebox@^0.25.16":
-  version "0.25.21"
-  resolved "https://registry.yarnpkg.com/@sinclair/typebox/-/typebox-0.25.21.tgz#763b05a4b472c93a8db29b2c3e359d55b29ce272"
-  integrity sha512-gFukHN4t8K4+wVC+ECqeqwzBDeFeTzBXroBTqE6vcWrQGbEUpHO7LYdG0f4xnvYq4VOEwITSlHlp0JBAIFMS/g==
+  version "0.25.24"
+  resolved "https://registry.yarnpkg.com/@sinclair/typebox/-/typebox-0.25.24.tgz#8c7688559979f7079aacaf31aa881c3aa410b718"
+  integrity sha512-XJfwUVUKDHF5ugKwIcxEgc9k8b7HbznCp6eUfWgu710hMPNIO4aw4/zB5RogDQz8nd6gyCDpU9O/m6qYEWY6yQ==
+
+"@sinclair/typebox@^0.27.8":
+  version "0.27.8"
+  resolved "https://registry.yarnpkg.com/@sinclair/typebox/-/typebox-0.27.8.tgz#6667fac16c436b5434a387a34dedb013198f6e6e"
+  integrity sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==
 
 "@sinonjs/commons@^2.0.0":
   version "2.0.0"
@@ -2375,9 +2358,9 @@
     "@babel/types" "^7.3.0"
 
 "@types/color-name@^1.1.1":
-  version "1.1.1"
-  resolved "https://registry.yarnpkg.com/@types/color-name/-/color-name-1.1.1.tgz#1c1261bbeaa10a8055bbc5d8ab84b7b2afc846a0"
-  integrity sha512-rr+OQyAjxze7GgWrSaJwydHStIhHq2lvY3BOC2Mj7KnzI7XK0Uw1TOOdI9lDoajEbSWLiYgoo4f1R51erQfhPQ==
+  version "1.1.4"
+  resolved "https://registry.yarnpkg.com/@types/color-name/-/color-name-1.1.4.tgz#e002611ff627347818d440a05e81650e9a4053b8"
+  integrity sha512-hulKeREDdLFesGQjl96+4aoJSHY5b2GRjagzzcqCfIrWhe5vkCqIvrLbqzBaI1q94Vg8DNJZZqTR5ocdWmWclg==
 
 "@types/glob@^7.1.1":
   version "7.1.3"
@@ -2394,34 +2377,31 @@
   dependencies:
     "@types/node" "*"
 
-"@types/istanbul-lib-coverage@*", "@types/istanbul-lib-coverage@^2.0.0", "@types/istanbul-lib-coverage@^2.0.1":
+"@types/istanbul-lib-coverage@*", "@types/istanbul-lib-coverage@^2.0.0":
+  version "2.0.6"
+  resolved "https://registry.yarnpkg.com/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz#7739c232a1fee9b4d3ce8985f314c0c6d33549d7"
+  integrity sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==
+
+"@types/istanbul-lib-coverage@^2.0.1":
   version "2.0.3"
   resolved "https://registry.yarnpkg.com/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.3.tgz#4ba8ddb720221f432e443bd5f9117fd22cfd4762"
   integrity sha512-sz7iLqvVUg1gIedBOvlkxPlc8/uVzyS5OwGz1cKjXzkl3FpL3al0crU8YGU1WoHkxn0Wxbw5tyi6hvzJKNzFsw==
 
 "@types/istanbul-lib-report@*":
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.0.tgz#c14c24f18ea8190c118ee7562b7ff99a36552686"
-  integrity sha512-plGgXAPfVKFoYfa9NpYDAkseG+g6Jr294RqeqcqDixSbU34MZVJRi/P+7Y8GDpzkEwLaGZZOpKIEmeVZNtKsrg==
+  version "3.0.3"
+  resolved "https://registry.yarnpkg.com/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.3.tgz#53047614ae72e19fc0401d872de3ae2b4ce350bf"
+  integrity sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==
   dependencies:
     "@types/istanbul-lib-coverage" "*"
 
 "@types/istanbul-reports@^3.0.0":
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/@types/istanbul-reports/-/istanbul-reports-3.0.0.tgz#508b13aa344fa4976234e75dddcc34925737d821"
-  integrity sha512-nwKNbvnwJ2/mndE9ItP/zc2TCzw6uuodnF4EHYWD+gCQDVBuRQL5UzbZD0/ezy1iKsFU2ZQiDqg4M9dN4+wZgA==
+  version "3.0.4"
+  resolved "https://registry.yarnpkg.com/@types/istanbul-reports/-/istanbul-reports-3.0.4.tgz#0f03e3d2f670fbdac586e34b433783070cc16f54"
+  integrity sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==
   dependencies:
     "@types/istanbul-lib-report" "*"
 
-"@types/jest@^29.4.0":
-  version "29.4.0"
-  resolved "https://registry.yarnpkg.com/@types/jest/-/jest-29.4.0.tgz#a8444ad1704493e84dbf07bb05990b275b3b9206"
-  integrity sha512-VaywcGQ9tPorCX/Jkkni7RWGFfI11whqzs8dvxF41P17Z+z872thvEvlIbznjPJ02kl1HMX3LmLOonsj2n7HeQ==
-  dependencies:
-    expect "^29.0.0"
-    pretty-format "^29.0.0"
-
-"@types/jest@^29.4.1":
+"@types/jest@^29.4.0", "@types/jest@^29.4.1":
   version "29.5.12"
   resolved "https://registry.yarnpkg.com/@types/jest/-/jest-29.5.12.tgz#7f7dc6eb4cf246d2474ed78744b05d06ce025544"
   integrity sha512-eDC8bTvT/QhYdxJAulQikueigY5AsdBRH2yDKW3yveW7svY3+DzN84/2NUgkw10RTiJbWqZrTtoGVdYlvFJdLw==
@@ -2429,15 +2409,10 @@
     expect "^29.0.0"
     pretty-format "^29.0.0"
 
-"@types/json-schema@^7.0.12":
-  version "7.0.15"
-  resolved "https://registry.yarnpkg.com/@types/json-schema/-/json-schema-7.0.15.tgz#596a1747233694d50f6ad8a7869fcb6f56cf5841"
-  integrity sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==
-
 "@types/json5@^0.0.29":
   version "0.0.29"
   resolved "https://registry.yarnpkg.com/@types/json5/-/json5-0.0.29.tgz#ee28707ae94e11d2b827bcbe5270bcea7f3e71ee"
-  integrity sha1-7ihweulOEdK4J7y+UnC86n8+ce4=
+  integrity sha512-dRLjCWHYg4oaA77cxO64oO+7JwCwnIzkZPdrrC71jQmQtlhM556pwKo5bUzqvZndkVbeFLIIi+9TC40JNF5hNQ==
 
 "@types/minimatch@*":
   version "3.0.3"
@@ -2454,30 +2429,39 @@
   resolved "https://registry.yarnpkg.com/@types/minimist/-/minimist-1.2.2.tgz#ee771e2ba4b3dc5b372935d549fd9617bf345b8c"
   integrity sha512-jhuKLIRrhvCPLqwPcx6INqmKeiA5EWrsCOPhrlFSrbrmU4ZMPjj5Ul/oLCMDO98XRUIwVm78xICz4EPCektzeQ==
 
-"@types/node@*", "@types/node@>= 8":
-  version "14.6.0"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-14.6.0.tgz#7d4411bf5157339337d7cff864d9ff45f177b499"
-  integrity sha512-mikldZQitV94akrc4sCcSjtJfsTKt4p+e/s0AGscVA6XArQ9kFclP+ZiYUMnq987rc6QlYxXv/EivqlfSLxpKA==
+"@types/node@*":
+  version "22.2.0"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-22.2.0.tgz#7cf046a99f0ba4d628ad3088cb21f790df9b0c5b"
+  integrity sha512-bm6EG6/pCpkxDf/0gDNDdtDILMOHgaQBVOJGdwsqClnxA3xL6jtMv76rLBc006RVMWbmaf0xbmom4Z/5o2nRkQ==
+  dependencies:
+    undici-types "~6.13.0"
 
 "@types/node@11.11.6":
   version "11.11.6"
   resolved "https://registry.yarnpkg.com/@types/node/-/node-11.11.6.tgz#df929d1bb2eee5afdda598a41930fe50b43eaa6a"
   integrity sha512-Exw4yUWMBXM3X+8oqzJNRqZSwUAaS4+7NdvHqQuFi/d+synz++xmX3QIf+BFqneW8N31R8Ky+sikfZUXq07ggQ==
 
+"@types/node@>= 8":
+  version "14.6.0"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-14.6.0.tgz#7d4411bf5157339337d7cff864d9ff45f177b499"
+  integrity sha512-mikldZQitV94akrc4sCcSjtJfsTKt4p+e/s0AGscVA6XArQ9kFclP+ZiYUMnq987rc6QlYxXv/EivqlfSLxpKA==
+
 "@types/node@^12.7.8":
   version "12.20.55"
   resolved "https://registry.yarnpkg.com/@types/node/-/node-12.20.55.tgz#c329cbd434c42164f846b909bd6f85b5537f6240"
   integrity sha512-J8xLz7q2OFulZ2cyGTLE1TbbZcjpno7FaN6zdJNrgAdrJ+DZzh/uFR6YrTb4C+nXakvud8Q4+rbhoIWlYQbUFQ==
 
 "@types/node@^14.14.28":
-  version "14.14.28"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-14.14.28.tgz#cade4b64f8438f588951a6b35843ce536853f25b"
-  integrity sha512-lg55ArB+ZiHHbBBttLpzD07akz0QPrZgUODNakeC09i62dnrywr9mFErHuaPlB6I7z+sEbK+IYmplahvplCj2g==
+  version "14.18.63"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-14.18.63.tgz#1788fa8da838dbb5f9ea994b834278205db6ca2b"
+  integrity sha512-fAtCfv4jJg+ExtXhvCkCqUKZ+4ok/JQk01qDKhL5BDDoS3AxKXhV5/MAVUZyQnSEd2GT92fkgZl0pz0Q0AzcIQ==
 
 "@types/node@^18.11.18":
-  version "18.11.18"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-18.11.18.tgz#8dfb97f0da23c2293e554c5a50d61ef134d7697f"
-  integrity sha512-DHQpWGjyQKSHj3ebjFI/wRKcqQcdR+MoFBygntYOZytCqNfkd2ZC4ARDJ2DQqhjH5p85Nnd3jhUJIXrszFX/JA==
+  version "18.19.44"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-18.19.44.tgz#875a8322d17ff12bf82b3af8c07b9310a00e72f8"
+  integrity sha512-ZsbGerYg72WMXUIE9fYxtvfzLEuq6q8mKERdWFnqTmOvudMxnz+CBNRoOwJ2kNpFOncrKjT1hZwxjlFgQ9qvQA==
+  dependencies:
+    undici-types "~5.26.4"
 
 "@types/normalize-package-data@^2.4.0":
   version "2.4.0"
@@ -2500,19 +2484,14 @@
   integrity sha512-KufADq8uQqo1pYKVIYzfKbJfBAc0sOeXqGbFaSpv8MRmC/zXgowNZmFcbngndGk922QDmOASEXUZCaY48gs4cg==
 
 "@types/semver@^7.3.4":
-  version "7.3.4"
-  resolved "https://registry.yarnpkg.com/@types/semver/-/semver-7.3.4.tgz#43d7168fec6fa0988bb1a513a697b29296721afb"
-  integrity sha512-+nVsLKlcUCeMzD2ufHEYuJ9a2ovstb6Dp52A5VsoKxDXgvE051XgHI/33I1EymwkRGQkwnA0LkhnUzituGs4EQ==
-
-"@types/semver@^7.5.0":
-  version "7.5.6"
-  resolved "https://registry.yarnpkg.com/@types/semver/-/semver-7.5.6.tgz#c65b2bfce1bec346582c07724e3f8c1017a20339"
-  integrity sha512-dn1l8LaMea/IjDoHNd9J52uBbInB796CDffS6VdIxvqYCPSG0V0DzHp76GpaWnlhg88uYyPbXCDIowa86ybd5A==
+  version "7.5.8"
+  resolved "https://registry.yarnpkg.com/@types/semver/-/semver-7.5.8.tgz#8268a8c57a3e4abd25c165ecd36237db7948a55e"
+  integrity sha512-I8EUhyrgfLrcTkzV3TSsGyl1tSuPrEDzr0yd5m90UgNxQkyDXULk3b6MlQqTCpZpNtWe1K0hzclnZkTcLBe2UQ==
 
 "@types/stack-utils@^2.0.0":
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/@types/stack-utils/-/stack-utils-2.0.0.tgz#7036640b4e21cc2f259ae826ce843d277dad8cff"
-  integrity sha512-RJJrrySY7A8havqpGObOB4W92QXKJo63/jFLLgpvOtsGUqbQZ9Sbgl35KMm1DjC6j7AvmmU2bIno+3IyEaemaw==
+  version "2.0.3"
+  resolved "https://registry.yarnpkg.com/@types/stack-utils/-/stack-utils-2.0.3.tgz#6209321eb2c1712a7e7466422b8cb1fc0d9dd5d8"
+  integrity sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==
 
 "@types/ws@^7.4.6":
   version "7.4.7"
@@ -2522,9 +2501,9 @@
     "@types/node" "*"
 
 "@types/yargs-parser@*":
-  version "15.0.0"
-  resolved "https://registry.yarnpkg.com/@types/yargs-parser/-/yargs-parser-15.0.0.tgz#cb3f9f741869e20cce330ffbeb9271590483882d"
-  integrity sha512-FA/BWv8t8ZWJ+gEOnLLd8ygxH/2UFbAvgEonyfN6yWGLKc7zVjbpl2Y4CTjid9h2RfgPP6SEt6uHwEOply00yw==
+  version "21.0.3"
+  resolved "https://registry.yarnpkg.com/@types/yargs-parser/-/yargs-parser-21.0.3.tgz#815e30b786d2e8f0dcd85fd5bcf5e1a04d008f15"
+  integrity sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==
 
 "@types/yargs@^15.0.0":
   version "15.0.15"
@@ -2534,96 +2513,92 @@
     "@types/yargs-parser" "*"
 
 "@types/yargs@^17.0.8":
-  version "17.0.22"
-  resolved "https://registry.yarnpkg.com/@types/yargs/-/yargs-17.0.22.tgz#7dd37697691b5f17d020f3c63e7a45971ff71e9a"
-  integrity sha512-pet5WJ9U8yPVRhkwuEIp5ktAeAqRZOq4UdAyWLWzxbtpyXnzbtLdKiXAjJzi/KLmPGS9wk86lUFWZFN6sISo4g==
+  version "17.0.33"
+  resolved "https://registry.yarnpkg.com/@types/yargs/-/yargs-17.0.33.tgz#8c32303da83eec050a84b3c7ae7b9f922d13e32d"
+  integrity sha512-WpxBCKWPLr4xSsHgz511rFJAM+wS28w2zEO1QDNY5zM/S8ok70NNfztH0xwhqKyaK0OHCbN98LDAZuy1ctxDkA==
   dependencies:
     "@types/yargs-parser" "*"
 
-"@typescript-eslint/eslint-plugin@^6.12.0":
-  version "6.12.0"
-  resolved "https://registry.yarnpkg.com/@typescript-eslint/eslint-plugin/-/eslint-plugin-6.12.0.tgz#2a647d278bb48bf397fef07ba0507612ff9dd812"
-  integrity sha512-XOpZ3IyJUIV1b15M7HVOpgQxPPF7lGXgsfcEIu3yDxFPaf/xZKt7s9QO/pbk7vpWQyVulpJbu4E5LwpZiQo4kA==
+"@typescript-eslint/eslint-plugin@^7.0.0":
+  version "7.18.0"
+  resolved "https://registry.yarnpkg.com/@typescript-eslint/eslint-plugin/-/eslint-plugin-7.18.0.tgz#b16d3cf3ee76bf572fdf511e79c248bdec619ea3"
+  integrity sha512-94EQTWZ40mzBc42ATNIBimBEDltSJ9RQHCC8vc/PDbxi4k8dVwUAv4o98dk50M1zB+JGFxp43FP7f8+FP8R6Sw==
   dependencies:
-    "@eslint-community/regexpp" "^4.5.1"
-    "@typescript-eslint/scope-manager" "6.12.0"
-    "@typescript-eslint/type-utils" "6.12.0"
-    "@typescript-eslint/utils" "6.12.0"
-    "@typescript-eslint/visitor-keys" "6.12.0"
-    debug "^4.3.4"
+    "@eslint-community/regexpp" "^4.10.0"
+    "@typescript-eslint/scope-manager" "7.18.0"
+    "@typescript-eslint/type-utils" "7.18.0"
+    "@typescript-eslint/utils" "7.18.0"
+    "@typescript-eslint/visitor-keys" "7.18.0"
     graphemer "^1.4.0"
-    ignore "^5.2.4"
+    ignore "^5.3.1"
     natural-compare "^1.4.0"
-    semver "^7.5.4"
-    ts-api-utils "^1.0.1"
-
-"@typescript-eslint/parser@^6.12.0":
-  version "6.12.0"
-  resolved "https://registry.yarnpkg.com/@typescript-eslint/parser/-/parser-6.12.0.tgz#9fb21ed7d88065a4a2ee21eb80b8578debb8217c"
-  integrity sha512-s8/jNFPKPNRmXEnNXfuo1gemBdVmpQsK1pcu+QIvuNJuhFzGrpD7WjOcvDc/+uEdfzSYpNu7U/+MmbScjoQ6vg==
-  dependencies:
-    "@typescript-eslint/scope-manager" "6.12.0"
-    "@typescript-eslint/types" "6.12.0"
-    "@typescript-eslint/typescript-estree" "6.12.0"
-    "@typescript-eslint/visitor-keys" "6.12.0"
+    ts-api-utils "^1.3.0"
+
+"@typescript-eslint/parser@^7.0.0":
+  version "7.18.0"
+  resolved "https://registry.yarnpkg.com/@typescript-eslint/parser/-/parser-7.18.0.tgz#83928d0f1b7f4afa974098c64b5ce6f9051f96a0"
+  integrity sha512-4Z+L8I2OqhZV8qA132M4wNL30ypZGYOQVBfMgxDH/K5UX0PNqTu1c6za9ST5r9+tavvHiTWmBnKzpCJ/GlVFtg==
+  dependencies:
+    "@typescript-eslint/scope-manager" "7.18.0"
+    "@typescript-eslint/types" "7.18.0"
+    "@typescript-eslint/typescript-estree" "7.18.0"
+    "@typescript-eslint/visitor-keys" "7.18.0"
     debug "^4.3.4"
 
-"@typescript-eslint/scope-manager@6.12.0":
-  version "6.12.0"
-  resolved "https://registry.yarnpkg.com/@typescript-eslint/scope-manager/-/scope-manager-6.12.0.tgz#5833a16dbe19cfbad639d4d33bcca5e755c7044b"
-  integrity sha512-5gUvjg+XdSj8pcetdL9eXJzQNTl3RD7LgUiYTl8Aabdi8hFkaGSYnaS6BLc0BGNaDH+tVzVwmKtWvu0jLgWVbw==
+"@typescript-eslint/scope-manager@7.18.0":
+  version "7.18.0"
+  resolved "https://registry.yarnpkg.com/@typescript-eslint/scope-manager/-/scope-manager-7.18.0.tgz#c928e7a9fc2c0b3ed92ab3112c614d6bd9951c83"
+  integrity sha512-jjhdIE/FPF2B7Z1uzc6i3oWKbGcHb87Qw7AWj6jmEqNOfDFbJWtjt/XfwCpvNkpGWlcJaog5vTR+VV8+w9JflA==
   dependencies:
-    "@typescript-eslint/types" "6.12.0"
-    "@typescript-eslint/visitor-keys" "6.12.0"
+    "@typescript-eslint/types" "7.18.0"
+    "@typescript-eslint/visitor-keys" "7.18.0"
 
-"@typescript-eslint/type-utils@6.12.0":
-  version "6.12.0"
-  resolved "https://registry.yarnpkg.com/@typescript-eslint/type-utils/-/type-utils-6.12.0.tgz#968f7c95162808d69950ab5dff710ad730e58287"
-  integrity sha512-WWmRXxhm1X8Wlquj+MhsAG4dU/Blvf1xDgGaYCzfvStP2NwPQh6KBvCDbiOEvaE0filhranjIlK/2fSTVwtBng==
+"@typescript-eslint/type-utils@7.18.0":
+  version "7.18.0"
+  resolved "https://registry.yarnpkg.com/@typescript-eslint/type-utils/-/type-utils-7.18.0.tgz#2165ffaee00b1fbbdd2d40aa85232dab6998f53b"
+  integrity sha512-XL0FJXuCLaDuX2sYqZUUSOJ2sG5/i1AAze+axqmLnSkNEVMVYLF+cbwlB2w8D1tinFuSikHmFta+P+HOofrLeA==
   dependencies:
-    "@typescript-eslint/typescript-estree" "6.12.0"
-    "@typescript-eslint/utils" "6.12.0"
+    "@typescript-eslint/typescript-estree" "7.18.0"
+    "@typescript-eslint/utils" "7.18.0"
     debug "^4.3.4"
-    ts-api-utils "^1.0.1"
+    ts-api-utils "^1.3.0"
 
-"@typescript-eslint/types@6.12.0":
-  version "6.12.0"
-  resolved "https://registry.yarnpkg.com/@typescript-eslint/types/-/types-6.12.0.tgz#ffc5297bcfe77003c8b7b545b51c2505748314ac"
-  integrity sha512-MA16p/+WxM5JG/F3RTpRIcuOghWO30//VEOvzubM8zuOOBYXsP+IfjoCXXiIfy2Ta8FRh9+IO9QLlaFQUU+10Q==
+"@typescript-eslint/types@7.18.0":
+  version "7.18.0"
+  resolved "https://registry.yarnpkg.com/@typescript-eslint/types/-/types-7.18.0.tgz#b90a57ccdea71797ffffa0321e744f379ec838c9"
+  integrity sha512-iZqi+Ds1y4EDYUtlOOC+aUmxnE9xS/yCigkjA7XpTKV6nCBd3Hp/PRGGmdwnfkV2ThMyYldP1wRpm/id99spTQ==
 
-"@typescript-eslint/typescript-estree@6.12.0":
-  version "6.12.0"
-  resolved "https://registry.yarnpkg.com/@typescript-eslint/typescript-estree/-/typescript-estree-6.12.0.tgz#764ccc32598549e5b48ec99e3b85f89b1385310c"
-  integrity sha512-vw9E2P9+3UUWzhgjyyVczLWxZ3GuQNT7QpnIY3o5OMeLO/c8oHljGc8ZpryBMIyympiAAaKgw9e5Hl9dCWFOYw==
+"@typescript-eslint/typescript-estree@7.18.0":
+  version "7.18.0"
+  resolved "https://registry.yarnpkg.com/@typescript-eslint/typescript-estree/-/typescript-estree-7.18.0.tgz#b5868d486c51ce8f312309ba79bdb9f331b37931"
+  integrity sha512-aP1v/BSPnnyhMHts8cf1qQ6Q1IFwwRvAQGRvBFkWlo3/lH29OXA3Pts+c10nxRxIBrDnoMqzhgdwVe5f2D6OzA==
   dependencies:
-    "@typescript-eslint/types" "6.12.0"
-    "@typescript-eslint/visitor-keys" "6.12.0"
+    "@typescript-eslint/types" "7.18.0"
+    "@typescript-eslint/visitor-keys" "7.18.0"
     debug "^4.3.4"
     globby "^11.1.0"
     is-glob "^4.0.3"
-    semver "^7.5.4"
-    ts-api-utils "^1.0.1"
+    minimatch "^9.0.4"
+    semver "^7.6.0"
+    ts-api-utils "^1.3.0"
 
-"@typescript-eslint/utils@6.12.0":
-  version "6.12.0"
-  resolved "https://registry.yarnpkg.com/@typescript-eslint/utils/-/utils-6.12.0.tgz#c6ce8c06fe9b0212620e5674a2036f6f8f611754"
-  integrity sha512-LywPm8h3tGEbgfyjYnu3dauZ0U7R60m+miXgKcZS8c7QALO9uWJdvNoP+duKTk2XMWc7/Q3d/QiCuLN9X6SWyQ==
+"@typescript-eslint/utils@7.18.0":
+  version "7.18.0"
+  resolved "https://registry.yarnpkg.com/@typescript-eslint/utils/-/utils-7.18.0.tgz#bca01cde77f95fc6a8d5b0dbcbfb3d6ca4be451f"
+  integrity sha512-kK0/rNa2j74XuHVcoCZxdFBMF+aq/vH83CXAOHieC+2Gis4mF8jJXT5eAfyD3K0sAxtPuwxaIOIOvhwzVDt/kw==
   dependencies:
     "@eslint-community/eslint-utils" "^4.4.0"
-    "@types/json-schema" "^7.0.12"
-    "@types/semver" "^7.5.0"
-    "@typescript-eslint/scope-manager" "6.12.0"
-    "@typescript-eslint/types" "6.12.0"
-    "@typescript-eslint/typescript-estree" "6.12.0"
-    semver "^7.5.4"
-
-"@typescript-eslint/visitor-keys@6.12.0":
-  version "6.12.0"
-  resolved "https://registry.yarnpkg.com/@typescript-eslint/visitor-keys/-/visitor-keys-6.12.0.tgz#5877950de42a0f3344261b7a1eee15417306d7e9"
-  integrity sha512-rg3BizTZHF1k3ipn8gfrzDXXSFKyOEB5zxYXInQ6z0hUvmQlhaZQzK+YmHmNViMA9HzW5Q9+bPPt90bU6GQwyw==
-  dependencies:
-    "@typescript-eslint/types" "6.12.0"
-    eslint-visitor-keys "^3.4.1"
+    "@typescript-eslint/scope-manager" "7.18.0"
+    "@typescript-eslint/types" "7.18.0"
+    "@typescript-eslint/typescript-estree" "7.18.0"
+
+"@typescript-eslint/visitor-keys@7.18.0":
+  version "7.18.0"
+  resolved "https://registry.yarnpkg.com/@typescript-eslint/visitor-keys/-/visitor-keys-7.18.0.tgz#0564629b6124d67607378d0f0332a0495b25e7d7"
+  integrity sha512-cDF0/Gf81QpY3xYyJKDV14Zwdmid5+uuENhjH2EqFaF0ni+yAyq/LzMaIJdhNJXZI7uLzwIlA+V7oWoyn6Curg==
+  dependencies:
+    "@typescript-eslint/types" "7.18.0"
+    eslint-visitor-keys "^3.4.3"
 
 "@ungap/structured-clone@^1.2.0":
   version "1.2.0"
@@ -2732,9 +2707,9 @@ acorn@^5.5.0:
   integrity sha512-1D++VG7BhrtvQpNbBzovKNc1FLGGEE/oGe7b9xJm/RFHMBeUaUGpluV9RLjZa47YFdPcDAenEYuq9pQPcMdLJg==
 
 acorn@^8.9.0:
-  version "8.11.2"
-  resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.11.2.tgz#ca0d78b51895be5390a5903c5b3bdcdaf78ae40b"
-  integrity sha512-nc0Axzp/0FILLEVsm4fNwLCwMttvhEI263QtVPQcbpfZZ3ts0hLsZGOpE6czNlid7CJ9MlyH8reXkpsf3YUY4w==
+  version "8.12.1"
+  resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.12.1.tgz#71616bdccbe25e27a54439e0046e89ca76df2248"
+  integrity sha512-tcpGyI9zbizT9JbV6oYE477V6mTlXvvi0T0G3SNIYE2apm/G5huBa1+K89VGeovbg+jycCrfhl3ADxErOuO6Jg==
 
 after@0.8.2:
   version "0.8.2"
@@ -2874,7 +2849,7 @@ ansi-styles@^3.2.0, ansi-styles@^3.2.1:
   dependencies:
     color-convert "^1.9.0"
 
-ansi-styles@^4.0.0, ansi-styles@^4.1.0:
+ansi-styles@^4.0.0:
   version "4.2.1"
   resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-4.2.1.tgz#90ae75c424d008d2624c5bf29ead3177ebfcf359"
   integrity sha512-9VGjrMsG1vePxcSweQsN20KY/c4zN0h9fLjqAbwbPfahM3t+NL+M9HC8xeXG2I8pX5NoamTGNuomEUFI7fcUjA==
@@ -2882,6 +2857,13 @@ ansi-styles@^4.0.0, ansi-styles@^4.1.0:
     "@types/color-name" "^1.1.1"
     color-convert "^2.0.1"
 
+ansi-styles@^4.1.0:
+  version "4.3.0"
+  resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-4.3.0.tgz#edd803628ae71c04c85ae7a0906edad34b648937"
+  integrity sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==
+  dependencies:
+    color-convert "^2.0.1"
+
 ansi-styles@^5.0.0:
   version "5.2.0"
   resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-5.2.0.tgz#07449690ad45777d1924ac2abb2fc8895dba836b"
@@ -2975,13 +2957,13 @@ arr-union@^3.1.0:
   resolved "https://registry.yarnpkg.com/arr-union/-/arr-union-3.1.0.tgz#e39b09aea9def866a8f206e288af63919bae39c4"
   integrity sha1-45sJrqne+Gao8gbiiK9jkZuuOcQ=
 
-array-buffer-byte-length@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/array-buffer-byte-length/-/array-buffer-byte-length-1.0.0.tgz#fabe8bc193fea865f317fe7807085ee0dee5aead"
-  integrity sha512-LPuwb2P+NrQw3XhxGc36+XSvuBPopovXYTR9Ew++Du9Yb/bx5AzBfrIsBoj0EZUifjQU+sHL21sseZ3jerWO/A==
+array-buffer-byte-length@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/array-buffer-byte-length/-/array-buffer-byte-length-1.0.1.tgz#1e5583ec16763540a27ae52eed99ff899223568f"
+  integrity sha512-ahC5W1xgou+KTXix4sAO8Ki12Q+jf4i0+tmk3sC+zgcynshkHxzpXdImBehiUYKKKDwvfFiJl1tZt6ewscS1Mg==
   dependencies:
-    call-bind "^1.0.2"
-    is-array-buffer "^3.0.1"
+    call-bind "^1.0.5"
+    is-array-buffer "^3.0.4"
 
 array-differ@^2.0.3:
   version "2.1.0"
@@ -3013,14 +2995,15 @@ array-includes@^3.1.1:
     is-string "^1.0.5"
 
 array-includes@^3.1.7:
-  version "3.1.7"
-  resolved "https://registry.yarnpkg.com/array-includes/-/array-includes-3.1.7.tgz#8cd2e01b26f7a3086cbc87271593fe921c62abda"
-  integrity sha512-dlcsNBIiWhPkHdOEEKnehA+RNUWDc4UqFtnIXU4uuYDPtA4LDkr7qip2p0VvFAEXNDr0yWZ9PJyIRiGjRLQzwQ==
-  dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
-    get-intrinsic "^1.2.1"
+  version "3.1.8"
+  resolved "https://registry.yarnpkg.com/array-includes/-/array-includes-3.1.8.tgz#5e370cbe172fdd5dd6530c1d4aadda25281ba97d"
+  integrity sha512-itaWrbYbqpGXkGhZPGUulwnhVf5Hpy1xiCFsGqyIGglbBxmG5vSjxQen3/WGOjPpNEv1RtBLKxbmVXm8HpJStQ==
+  dependencies:
+    call-bind "^1.0.7"
+    define-properties "^1.2.1"
+    es-abstract "^1.23.2"
+    es-object-atoms "^1.0.0"
+    get-intrinsic "^1.2.4"
     is-string "^1.0.7"
 
 array-timsort@^1.0.3:
@@ -3051,15 +3034,16 @@ array-unique@^0.3.2:
   integrity sha1-qJS3XUvE9s1nnvMkSp/Y9Gri1Cg=
 
 array.prototype.findlastindex@^1.2.3:
-  version "1.2.3"
-  resolved "https://registry.yarnpkg.com/array.prototype.findlastindex/-/array.prototype.findlastindex-1.2.3.tgz#b37598438f97b579166940814e2c0493a4f50207"
-  integrity sha512-LzLoiOMAxvy+Gd3BAq3B7VeIgPdo+Q8hthvKtXybMvRV0jrXfJM/t8mw7nNlpEcVlVUnCnM2KSX4XU5HmpodOA==
+  version "1.2.5"
+  resolved "https://registry.yarnpkg.com/array.prototype.findlastindex/-/array.prototype.findlastindex-1.2.5.tgz#8c35a755c72908719453f87145ca011e39334d0d"
+  integrity sha512-zfETvRFA8o7EiNn++N5f/kaCw221hrpGsDmcpndVupkPzEc1Wuf3VgC0qby1BbHs7f5DVYjgtEU2LLh5bqeGfQ==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
-    es-shim-unscopables "^1.0.0"
-    get-intrinsic "^1.2.1"
+    call-bind "^1.0.7"
+    define-properties "^1.2.1"
+    es-abstract "^1.23.2"
+    es-errors "^1.3.0"
+    es-object-atoms "^1.0.0"
+    es-shim-unscopables "^1.0.2"
 
 array.prototype.flat@^1.3.2:
   version "1.3.2"
@@ -3081,17 +3065,18 @@ array.prototype.flatmap@^1.3.2:
     es-abstract "^1.22.1"
     es-shim-unscopables "^1.0.0"
 
-arraybuffer.prototype.slice@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.2.tgz#98bd561953e3e74bb34938e77647179dfe6e9f12"
-  integrity sha512-yMBKppFur/fbHu9/6USUe03bZ4knMYiwFBcyiaXB8Go0qNehwX6inYPzK9U0NeQvGxKthcmHcaR8P5MStSRBAw==
+arraybuffer.prototype.slice@^1.0.3:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.3.tgz#097972f4255e41bc3425e37dc3f6421cf9aefde6"
+  integrity sha512-bMxMKAjg13EBSVscxTaYA4mRc5t1UAXa2kXiGTNfZ079HIWXEkKmkgFrh/nJqamaLSrXO5H4WFFkPEaLJWbs3A==
   dependencies:
-    array-buffer-byte-length "^1.0.0"
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
-    get-intrinsic "^1.2.1"
-    is-array-buffer "^3.0.2"
+    array-buffer-byte-length "^1.0.1"
+    call-bind "^1.0.5"
+    define-properties "^1.2.1"
+    es-abstract "^1.22.3"
+    es-errors "^1.2.1"
+    get-intrinsic "^1.2.3"
+    is-array-buffer "^3.0.4"
     is-shared-array-buffer "^1.0.2"
 
 arraybuffer.slice@~0.0.7:
@@ -3180,10 +3165,12 @@ available-typed-arrays@^1.0.0, available-typed-arrays@^1.0.2:
   dependencies:
     array-filter "^1.0.0"
 
-available-typed-arrays@^1.0.5:
-  version "1.0.5"
-  resolved "https://registry.yarnpkg.com/available-typed-arrays/-/available-typed-arrays-1.0.5.tgz#92f95616501069d07d10edb2fc37d3e1c65123b7"
-  integrity sha512-DMD0KiN46eipeziST1LPP/STfDU0sufISXmjSgvVsoU2tqxctQeASejWcfNtxYKqETM1UxQ8sp2OrSBWpHY6sw==
+available-typed-arrays@^1.0.7:
+  version "1.0.7"
+  resolved "https://registry.yarnpkg.com/available-typed-arrays/-/available-typed-arrays-1.0.7.tgz#a5cc375d6a03c2efc87a553f3e0b1522def14846"
+  integrity sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ==
+  dependencies:
+    possible-typed-array-names "^1.0.0"
 
 aws-sign2@~0.7.0:
   version "0.7.0"
@@ -3277,9 +3264,9 @@ backo2@1.0.2:
   integrity sha1-MasayLEpNjRj41s+u2n038+6eUc=
 
 balanced-match@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-1.0.0.tgz#89b4d199ab2bee49de164ea02b89ce462d71b767"
-  integrity sha1-ibTRmasr7kneFk6gK4nORi1xt2c=
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-1.0.2.tgz#e83e3a7e3f300b34cb9d87f615fa0cbf357690ee"
+  integrity sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==
 
 base-x@^3.0.2:
   version "3.0.8"
@@ -3487,6 +3474,13 @@ brace-expansion@^1.1.7:
     balanced-match "^1.0.0"
     concat-map "0.0.1"
 
+brace-expansion@^2.0.1:
+  version "2.0.1"
+  resolved "https://registry.yarnpkg.com/brace-expansion/-/brace-expansion-2.0.1.tgz#1edc459e0f0c548486ecf9fc99f2221364b9a0ae"
+  integrity sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==
+  dependencies:
+    balanced-match "^1.0.0"
+
 braces@^2.3.1:
   version "2.3.2"
   resolved "https://registry.yarnpkg.com/braces/-/braces-2.3.2.tgz#5979fd3f14cd531565e5fa2df1abfff1dfaee729"
@@ -3503,13 +3497,20 @@ braces@^2.3.1:
     split-string "^3.0.2"
     to-regex "^3.0.1"
 
-braces@^3.0.1, braces@^3.0.2:
+braces@^3.0.1:
   version "3.0.2"
   resolved "https://registry.yarnpkg.com/braces/-/braces-3.0.2.tgz#3454e1a462ee8d599e236df336cd9ea4f8afe107"
   integrity sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A==
   dependencies:
     fill-range "^7.0.1"
 
+braces@^3.0.3:
+  version "3.0.3"
+  resolved "https://registry.yarnpkg.com/braces/-/braces-3.0.3.tgz#490332f40919452272d55a8480adc0c441358789"
+  integrity sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==
+  dependencies:
+    fill-range "^7.1.1"
+
 brorand@^1.0.1:
   version "1.1.0"
   resolved "https://registry.yarnpkg.com/brorand/-/brorand-1.1.0.tgz#12c25efe40a45e3c323eb8675a0a0ce57b22371f"
@@ -3677,22 +3678,16 @@ caching-transform@^4.0.0:
     package-hash "^4.0.0"
     write-file-atomic "^3.0.0"
 
-call-bind@^1.0.0:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/call-bind/-/call-bind-1.0.2.tgz#b1d4e89e688119c3c9a903ad30abb2f6a919be3c"
-  integrity sha512-7O+FbCihrB5WGbFYesctwmTKae6rOiIzmz1icreWJ+0aA7LJfuqhEso2T9ncpcFtzMQtzXf2QGGueWJGTYsqrA==
-  dependencies:
-    function-bind "^1.1.1"
-    get-intrinsic "^1.0.2"
-
-call-bind@^1.0.2, call-bind@^1.0.4, call-bind@^1.0.5:
-  version "1.0.5"
-  resolved "https://registry.yarnpkg.com/call-bind/-/call-bind-1.0.5.tgz#6fa2b7845ce0ea49bf4d8b9ef64727a2c2e2e513"
-  integrity sha512-C3nQxfFZxFRVoJoGKKI8y3MOEo129NQ+FgQ08iye+Mk4zNZZGdjfs06bVTr+DBSlA66Q2VEcMki/cUCP4SercQ==
+call-bind@^1.0.0, call-bind@^1.0.2, call-bind@^1.0.5, call-bind@^1.0.6, call-bind@^1.0.7:
+  version "1.0.7"
+  resolved "https://registry.yarnpkg.com/call-bind/-/call-bind-1.0.7.tgz#06016599c40c56498c18769d2730be242b6fa3b9"
+  integrity sha512-GHTSNSYICQ7scH7sZ+M2rFopRoLh8t2bLSW6BbgrtLsahOIB5iyAVJf9GjWK3cYTDaMj4XdBpM1cA6pIS0Kv2w==
   dependencies:
+    es-define-property "^1.0.0"
+    es-errors "^1.3.0"
     function-bind "^1.1.2"
-    get-intrinsic "^1.2.1"
-    set-function-length "^1.1.1"
+    get-intrinsic "^1.2.4"
+    set-function-length "^1.2.1"
 
 call-me-maybe@^1.0.1:
   version "1.0.1"
@@ -3827,10 +3822,6 @@ cashaddrjs@^0.3.3:
   dependencies:
     big-integer "1.6.36"
 
-"cashproof@https://github.com/eyeofpython/cashproof":
-  version "0.0.0"
-  resolved "https://github.com/eyeofpython/cashproof#ff92615faa338e025a9d3a5dd98112233f6daf76"
-
 chalk@^1.1.3:
   version "1.1.3"
   resolved "https://registry.yarnpkg.com/chalk/-/chalk-1.1.3.tgz#a8115c55e4a702fe4d150abd3872822a7e09fc98"
@@ -3851,7 +3842,15 @@ chalk@^2.0.0, chalk@^2.1.0, chalk@^2.3.0, chalk@^2.3.1, chalk@^2.4.2:
     escape-string-regexp "^1.0.5"
     supports-color "^5.3.0"
 
-chalk@^4.0.0, chalk@^4.1.0:
+chalk@^4.0.0:
+  version "4.1.2"
+  resolved "https://registry.yarnpkg.com/chalk/-/chalk-4.1.2.tgz#aac4e2b7734a740867aeb16bf02aad556a1e7a01"
+  integrity sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==
+  dependencies:
+    ansi-styles "^4.1.0"
+    supports-color "^7.1.0"
+
+chalk@^4.1.0:
   version "4.1.0"
   resolved "https://registry.yarnpkg.com/chalk/-/chalk-4.1.0.tgz#4e14870a618d9e2edd97dd8345fd9d9dc315646a"
   integrity sha512-qwx12AxXe2Q5xQ43Ac//I6v5aXTipYrSESdOgzrN+9XjgEpyjpKuvSGaN4qE93f7TQTlerQQ8S+EQ0EyDoVL1A==
@@ -3885,9 +3884,9 @@ ci-info@^2.0.0:
   integrity sha512-5tK7EtrZ0N+OLFMthtqOj4fI2Jeb88C4CAZPu25LDVUgXJ0A3Js4PMGqrn0JU1W0Mh1/Z8wZzYPxqUrXeBboCQ==
 
 ci-info@^3.2.0:
-  version "3.7.1"
-  resolved "https://registry.yarnpkg.com/ci-info/-/ci-info-3.7.1.tgz#708a6cdae38915d597afdf3b145f2f8e1ff55f3f"
-  integrity sha512-4jYS4MOAaCIStSRwiuxc4B8MYhIe676yO1sYGzARnjXkWpmzZMMYxY6zu8WYWDhSuth5zhrQ1rhNSibyyvv4/w==
+  version "3.9.0"
+  resolved "https://registry.yarnpkg.com/ci-info/-/ci-info-3.9.0.tgz#4279a62028a7b1f262f3473fc9605f5e218c59b4"
+  integrity sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==
 
 cipher-base@^1.0.0, cipher-base@^1.0.1, cipher-base@^1.0.3:
   version "1.0.4"
@@ -4038,7 +4037,7 @@ color-convert@^2.0.1:
 color-name@1.1.3:
   version "1.1.3"
   resolved "https://registry.yarnpkg.com/color-name/-/color-name-1.1.3.tgz#a7d0558bd89c42f795dd42328f740831ca53bc25"
-  integrity sha1-p9BVi9icQveV3UIyj3QIMcpTvCU=
+  integrity sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==
 
 color-name@~1.1.4:
   version "1.1.4"
@@ -4125,7 +4124,7 @@ component-inherit@0.0.3:
 concat-map@0.0.1:
   version "0.0.1"
   resolved "https://registry.yarnpkg.com/concat-map/-/concat-map-0.0.1.tgz#d8a96bd77fd68df7793a73036a3ba0d5405d477b"
-  integrity sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=
+  integrity sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==
 
 concat-stream@^1.5.0, concat-stream@^1.6.0:
   version "1.6.2"
@@ -4523,6 +4522,33 @@ dashdash@^1.12.0:
   dependencies:
     assert-plus "^1.0.0"
 
+data-view-buffer@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/data-view-buffer/-/data-view-buffer-1.0.1.tgz#8ea6326efec17a2e42620696e671d7d5a8bc66b2"
+  integrity sha512-0lht7OugA5x3iJLOWFhWK/5ehONdprk0ISXqVFn/NFrDu+cuc8iADFrGQz5BnRK7LLU3JmkbXSxaqX+/mXYtUA==
+  dependencies:
+    call-bind "^1.0.6"
+    es-errors "^1.3.0"
+    is-data-view "^1.0.1"
+
+data-view-byte-length@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/data-view-byte-length/-/data-view-byte-length-1.0.1.tgz#90721ca95ff280677eb793749fce1011347669e2"
+  integrity sha512-4J7wRJD3ABAzr8wP+OcIcqq2dlUKp4DVflx++hs5h5ZKydWMI6/D/fAot+yh6g2tHh8fLFTvNOaVN357NvSrOQ==
+  dependencies:
+    call-bind "^1.0.7"
+    es-errors "^1.3.0"
+    is-data-view "^1.0.1"
+
+data-view-byte-offset@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/data-view-byte-offset/-/data-view-byte-offset-1.0.0.tgz#5e0bbfb4828ed2d1b9b400cd8a7d119bca0ff18a"
+  integrity sha512-t/Ygsytq+R995EJ5PZlD4Cu56sWa8InXySaViRzw9apusqsOO2bQP+SbYzAhR0pFKoB+43lYy8rWban9JSuXnA==
+  dependencies:
+    call-bind "^1.0.6"
+    es-errors "^1.3.0"
+    is-data-view "^1.0.1"
+
 dateformat@^3.0.0:
   version "3.0.3"
   resolved "https://registry.yarnpkg.com/dateformat/-/dateformat-3.0.3.tgz#a6e37499a4d9a9cf85ef5872044d62901c9889ae"
@@ -4540,7 +4566,7 @@ debug@3.1.0, debug@~3.1.0:
   dependencies:
     ms "2.0.0"
 
-debug@4, debug@^4.1.0, debug@^4.1.1, debug@~4.1.0:
+debug@4, debug@^4.1.0, debug@~4.1.0:
   version "4.1.1"
   resolved "https://registry.yarnpkg.com/debug/-/debug-4.1.1.tgz#3b72260255109c6b589cee050f1d516139664791"
   integrity sha512-pYAIzeRo8J6KPEaJ0VWOh5Pzkbw/RetuzehGM7QRRX5he4fPHx2rdKMB256ehJCkX+XRQm16eZLqLNS8RSZXZw==
@@ -4568,10 +4594,10 @@ debug@^3.2.7:
   dependencies:
     ms "^2.1.1"
 
-debug@^4.3.2, debug@^4.3.4:
-  version "4.3.4"
-  resolved "https://registry.yarnpkg.com/debug/-/debug-4.3.4.tgz#1319f6579357f2338d3337d2cdd4914bb5dcc865"
-  integrity sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==
+debug@^4.1.1, debug@^4.3.1, debug@^4.3.2, debug@^4.3.4:
+  version "4.3.6"
+  resolved "https://registry.yarnpkg.com/debug/-/debug-4.3.6.tgz#2ab2c38fbaffebf8aa95fdfe6d88438c7a13c52b"
+  integrity sha512-O/09Bd4Z1fBrU4VzkhFqVgpPzaGbw6Sm9FEkBT1A/YBXQFGuuSxa1dN2nxgxS34JmKXqYx8CZAwEVoJFImUXIg==
   dependencies:
     ms "2.1.2"
 
@@ -4628,7 +4654,12 @@ deep-equal@^2.0.3:
     which-collection "^1.0.1"
     which-typed-array "^1.1.2"
 
-deep-is@^0.1.3, deep-is@~0.1.3:
+deep-is@^0.1.3:
+  version "0.1.4"
+  resolved "https://registry.yarnpkg.com/deep-is/-/deep-is-0.1.4.tgz#a6f2dce612fadd2ef1f519b73551f17e85199831"
+  integrity sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==
+
+deep-is@~0.1.3:
   version "0.1.3"
   resolved "https://registry.yarnpkg.com/deep-is/-/deep-is-0.1.3.tgz#b369d6fb5dbc13eecf524f91b070feedc357cf34"
   integrity sha1-s2nW+128E+7PUk+RsHD+7cNXzzQ=
@@ -4652,23 +4683,23 @@ defaults@^1.0.3:
   dependencies:
     clone "^1.0.2"
 
-define-data-property@^1.0.1, define-data-property@^1.1.1:
-  version "1.1.1"
-  resolved "https://registry.yarnpkg.com/define-data-property/-/define-data-property-1.1.1.tgz#c35f7cd0ab09883480d12ac5cb213715587800b3"
-  integrity sha512-E7uGkTzkk1d0ByLeSc6ZsFS79Axg+m1P/VsgYsxHgiuc3tFSj+MjMIwe90FC4lOAZzNBdY7kkO2P2wKdsQ1vgQ==
+define-data-property@^1.0.1, define-data-property@^1.1.4:
+  version "1.1.4"
+  resolved "https://registry.yarnpkg.com/define-data-property/-/define-data-property-1.1.4.tgz#894dc141bb7d3060ae4366f6a0107e68fbe48c5e"
+  integrity sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==
   dependencies:
-    get-intrinsic "^1.2.1"
+    es-define-property "^1.0.0"
+    es-errors "^1.3.0"
     gopd "^1.0.1"
-    has-property-descriptors "^1.0.0"
 
-define-properties@^1.1.2, define-properties@^1.1.3:
+define-properties@^1.1.2:
   version "1.1.3"
   resolved "https://registry.yarnpkg.com/define-properties/-/define-properties-1.1.3.tgz#cf88da6cbee26fe6db7094f61d870cbd84cee9f1"
   integrity sha512-3MqfYKj2lLzdMSf8ZIZE/V+Zuy+BgD6f164e8K2w7dgnpKArBDerGYpM46IYYcjnkdPNMjPk9A6VFB8+3SKlXQ==
   dependencies:
     object-keys "^1.0.12"
 
-define-properties@^1.1.4, define-properties@^1.2.0:
+define-properties@^1.1.3, define-properties@^1.2.0, define-properties@^1.2.1:
   version "1.2.1"
   resolved "https://registry.yarnpkg.com/define-properties/-/define-properties-1.2.1.tgz#10781cc616eb951a80a034bafcaa7377f6af2b6c"
   integrity sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==
@@ -4759,10 +4790,10 @@ diff-sequences@^29.3.1:
   resolved "https://registry.yarnpkg.com/diff-sequences/-/diff-sequences-29.3.1.tgz#104b5b95fe725932421a9c6e5b4bef84c3f2249e"
   integrity sha512-hlM3QR272NXCi4pq+N4Kok4kOp6EsgOM3ZSpJI7Da3UAs+Ttsi8MRmB6trM/lhyzUxGfOgnpkHtgqm5Q/CTcfQ==
 
-diff-sequences@^29.4.2:
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/diff-sequences/-/diff-sequences-29.4.2.tgz#711fe6bd8a5869fe2539cee4a5152425ff671fda"
-  integrity sha512-R6P0Y6PrsH3n4hUXxL3nns0rbRk6Q33js3ygJBeEpbzLzgcNuJ61+u0RXasFpTKISw99TxUzFnumSnRLsjhLaw==
+diff-sequences@^29.6.3:
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/diff-sequences/-/diff-sequences-29.6.3.tgz#4deaf894d11407c51efc8418012f9e70b84ea921"
+  integrity sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==
 
 dijkstrajs@^1.0.1:
   version "1.0.1"
@@ -5028,50 +5059,69 @@ es-abstract@^1.18.0-next.0:
     string.prototype.trimend "^1.0.1"
     string.prototype.trimstart "^1.0.1"
 
-es-abstract@^1.22.1:
-  version "1.22.3"
-  resolved "https://registry.yarnpkg.com/es-abstract/-/es-abstract-1.22.3.tgz#48e79f5573198de6dee3589195727f4f74bc4f32"
-  integrity sha512-eiiY8HQeYfYH2Con2berK+To6GrK2RxbPawDkGq4UiCQQfZHb6wX9qQqkbpPqaxQFcl8d9QzZqo0tGE0VcrdwA==
-  dependencies:
-    array-buffer-byte-length "^1.0.0"
-    arraybuffer.prototype.slice "^1.0.2"
-    available-typed-arrays "^1.0.5"
-    call-bind "^1.0.5"
-    es-set-tostringtag "^2.0.1"
+es-abstract@^1.22.1, es-abstract@^1.22.3, es-abstract@^1.23.0, es-abstract@^1.23.2:
+  version "1.23.3"
+  resolved "https://registry.yarnpkg.com/es-abstract/-/es-abstract-1.23.3.tgz#8f0c5a35cd215312573c5a27c87dfd6c881a0aa0"
+  integrity sha512-e+HfNH61Bj1X9/jLc5v1owaLYuHdeHHSQlkhCBiTK8rBvKaULl/beGMxwrMXjpYrv4pz22BlY570vVePA2ho4A==
+  dependencies:
+    array-buffer-byte-length "^1.0.1"
+    arraybuffer.prototype.slice "^1.0.3"
+    available-typed-arrays "^1.0.7"
+    call-bind "^1.0.7"
+    data-view-buffer "^1.0.1"
+    data-view-byte-length "^1.0.1"
+    data-view-byte-offset "^1.0.0"
+    es-define-property "^1.0.0"
+    es-errors "^1.3.0"
+    es-object-atoms "^1.0.0"
+    es-set-tostringtag "^2.0.3"
     es-to-primitive "^1.2.1"
     function.prototype.name "^1.1.6"
-    get-intrinsic "^1.2.2"
-    get-symbol-description "^1.0.0"
+    get-intrinsic "^1.2.4"
+    get-symbol-description "^1.0.2"
     globalthis "^1.0.3"
     gopd "^1.0.1"
-    has-property-descriptors "^1.0.0"
-    has-proto "^1.0.1"
+    has-property-descriptors "^1.0.2"
+    has-proto "^1.0.3"
     has-symbols "^1.0.3"
-    hasown "^2.0.0"
-    internal-slot "^1.0.5"
-    is-array-buffer "^3.0.2"
+    hasown "^2.0.2"
+    internal-slot "^1.0.7"
+    is-array-buffer "^3.0.4"
     is-callable "^1.2.7"
-    is-negative-zero "^2.0.2"
+    is-data-view "^1.0.1"
+    is-negative-zero "^2.0.3"
     is-regex "^1.1.4"
-    is-shared-array-buffer "^1.0.2"
+    is-shared-array-buffer "^1.0.3"
     is-string "^1.0.7"
-    is-typed-array "^1.1.12"
+    is-typed-array "^1.1.13"
     is-weakref "^1.0.2"
     object-inspect "^1.13.1"
     object-keys "^1.1.1"
-    object.assign "^4.1.4"
-    regexp.prototype.flags "^1.5.1"
-    safe-array-concat "^1.0.1"
-    safe-regex-test "^1.0.0"
-    string.prototype.trim "^1.2.8"
-    string.prototype.trimend "^1.0.7"
-    string.prototype.trimstart "^1.0.7"
-    typed-array-buffer "^1.0.0"
-    typed-array-byte-length "^1.0.0"
-    typed-array-byte-offset "^1.0.0"
-    typed-array-length "^1.0.4"
+    object.assign "^4.1.5"
+    regexp.prototype.flags "^1.5.2"
+    safe-array-concat "^1.1.2"
+    safe-regex-test "^1.0.3"
+    string.prototype.trim "^1.2.9"
+    string.prototype.trimend "^1.0.8"
+    string.prototype.trimstart "^1.0.8"
+    typed-array-buffer "^1.0.2"
+    typed-array-byte-length "^1.0.1"
+    typed-array-byte-offset "^1.0.2"
+    typed-array-length "^1.0.6"
     unbox-primitive "^1.0.2"
-    which-typed-array "^1.1.13"
+    which-typed-array "^1.1.15"
+
+es-define-property@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/es-define-property/-/es-define-property-1.0.0.tgz#c7faefbdff8b2696cf5f46921edfb77cc4ba3845"
+  integrity sha512-jxayLKShrEqqzJ0eumQbVhTYQM27CfT1T35+gCgDFoL82JLsXqTJ76zv6A0YLOgEnLUMvLzsDsGIrl8NFpT2gQ==
+  dependencies:
+    get-intrinsic "^1.2.4"
+
+es-errors@^1.2.1, es-errors@^1.3.0:
+  version "1.3.0"
+  resolved "https://registry.yarnpkg.com/es-errors/-/es-errors-1.3.0.tgz#05f75a25dab98e4fb1dcd5e1472c0546d5057c8f"
+  integrity sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==
 
 es-get-iterator@^1.1.0:
   version "1.1.0"
@@ -5086,16 +5136,23 @@ es-get-iterator@^1.1.0:
     is-string "^1.0.5"
     isarray "^2.0.5"
 
-es-set-tostringtag@^2.0.1:
-  version "2.0.2"
-  resolved "https://registry.yarnpkg.com/es-set-tostringtag/-/es-set-tostringtag-2.0.2.tgz#11f7cc9f63376930a5f20be4915834f4bc74f9c9"
-  integrity sha512-BuDyupZt65P9D2D2vA/zqcI3G5xRsklm5N3xCwuiy+/vKy8i0ifdsQP1sLgO4tZDSCaQUSnmC48khknGMV3D2Q==
+es-object-atoms@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/es-object-atoms/-/es-object-atoms-1.0.0.tgz#ddb55cd47ac2e240701260bc2a8e31ecb643d941"
+  integrity sha512-MZ4iQ6JwHOBQjahnjwaC1ZtIBH+2ohjamzAO3oaHcXYup7qxjF2fixyH+Q71voWHeOkI2q/TnJao/KfXYIZWbw==
   dependencies:
-    get-intrinsic "^1.2.2"
-    has-tostringtag "^1.0.0"
-    hasown "^2.0.0"
+    es-errors "^1.3.0"
+
+es-set-tostringtag@^2.0.3:
+  version "2.0.3"
+  resolved "https://registry.yarnpkg.com/es-set-tostringtag/-/es-set-tostringtag-2.0.3.tgz#8bb60f0a440c2e4281962428438d58545af39777"
+  integrity sha512-3T8uNMC3OQTHkFUsFq8r/BwAXLHvU/9O9mE0fBc/MY5iq/8H7ncvO947LmYA6ldWw9Uh8Yhf25zu6n7nML5QWQ==
+  dependencies:
+    get-intrinsic "^1.2.4"
+    has-tostringtag "^1.0.2"
+    hasown "^2.0.1"
 
-es-shim-unscopables@^1.0.0:
+es-shim-unscopables@^1.0.0, es-shim-unscopables@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/es-shim-unscopables/-/es-shim-unscopables-1.0.2.tgz#1f6942e71ecc7835ed1c8a83006d8771a63a3763"
   integrity sha512-J3yBRXCzDu4ULnQwxyToo/OjdMx6akgVC7K6few0a7F/0wLtmKKN7I73AH5T2836UuXRqN7Qg+IIUw/+YJksRw==
@@ -5133,34 +5190,35 @@ es6-promisify@^5.0.0:
   dependencies:
     es6-promise "^4.0.3"
 
-esbuild@~0.19.10:
-  version "0.19.12"
-  resolved "https://registry.yarnpkg.com/esbuild/-/esbuild-0.19.12.tgz#dc82ee5dc79e82f5a5c3b4323a2a641827db3e04"
-  integrity sha512-aARqgq8roFBj054KvQr5f1sFu0D65G+miZRCuJyJ0G13Zwx7vRar5Zhn2tkQNzIXcBrNVsv/8stehpj+GAjgbg==
+esbuild@~0.23.0:
+  version "0.23.0"
+  resolved "https://registry.yarnpkg.com/esbuild/-/esbuild-0.23.0.tgz#de06002d48424d9fdb7eb52dbe8e95927f852599"
+  integrity sha512-1lvV17H2bMYda/WaFb2jLPeHU3zml2k4/yagNMG8Q/YtfMjCwEUZa2eXXMgZTVSL5q1n4H7sQ0X6CdJDqqeCFA==
   optionalDependencies:
-    "@esbuild/aix-ppc64" "0.19.12"
-    "@esbuild/android-arm" "0.19.12"
-    "@esbuild/android-arm64" "0.19.12"
-    "@esbuild/android-x64" "0.19.12"
-    "@esbuild/darwin-arm64" "0.19.12"
-    "@esbuild/darwin-x64" "0.19.12"
-    "@esbuild/freebsd-arm64" "0.19.12"
-    "@esbuild/freebsd-x64" "0.19.12"
-    "@esbuild/linux-arm" "0.19.12"
-    "@esbuild/linux-arm64" "0.19.12"
-    "@esbuild/linux-ia32" "0.19.12"
-    "@esbuild/linux-loong64" "0.19.12"
-    "@esbuild/linux-mips64el" "0.19.12"
-    "@esbuild/linux-ppc64" "0.19.12"
-    "@esbuild/linux-riscv64" "0.19.12"
-    "@esbuild/linux-s390x" "0.19.12"
-    "@esbuild/linux-x64" "0.19.12"
-    "@esbuild/netbsd-x64" "0.19.12"
-    "@esbuild/openbsd-x64" "0.19.12"
-    "@esbuild/sunos-x64" "0.19.12"
-    "@esbuild/win32-arm64" "0.19.12"
-    "@esbuild/win32-ia32" "0.19.12"
-    "@esbuild/win32-x64" "0.19.12"
+    "@esbuild/aix-ppc64" "0.23.0"
+    "@esbuild/android-arm" "0.23.0"
+    "@esbuild/android-arm64" "0.23.0"
+    "@esbuild/android-x64" "0.23.0"
+    "@esbuild/darwin-arm64" "0.23.0"
+    "@esbuild/darwin-x64" "0.23.0"
+    "@esbuild/freebsd-arm64" "0.23.0"
+    "@esbuild/freebsd-x64" "0.23.0"
+    "@esbuild/linux-arm" "0.23.0"
+    "@esbuild/linux-arm64" "0.23.0"
+    "@esbuild/linux-ia32" "0.23.0"
+    "@esbuild/linux-loong64" "0.23.0"
+    "@esbuild/linux-mips64el" "0.23.0"
+    "@esbuild/linux-ppc64" "0.23.0"
+    "@esbuild/linux-riscv64" "0.23.0"
+    "@esbuild/linux-s390x" "0.23.0"
+    "@esbuild/linux-x64" "0.23.0"
+    "@esbuild/netbsd-x64" "0.23.0"
+    "@esbuild/openbsd-arm64" "0.23.0"
+    "@esbuild/openbsd-x64" "0.23.0"
+    "@esbuild/sunos-x64" "0.23.0"
+    "@esbuild/win32-arm64" "0.23.0"
+    "@esbuild/win32-ia32" "0.23.0"
+    "@esbuild/win32-x64" "0.23.0"
 
 escalade@^3.1.1:
   version "3.1.1"
@@ -5197,10 +5255,10 @@ eslint-config-airbnb-base@^15.0.0:
     object.entries "^1.1.5"
     semver "^6.3.0"
 
-eslint-config-airbnb-typescript@^17.1.0:
-  version "17.1.0"
-  resolved "https://registry.yarnpkg.com/eslint-config-airbnb-typescript/-/eslint-config-airbnb-typescript-17.1.0.tgz#fda960eee4a510f092a9a1c139035ac588937ddc"
-  integrity sha512-GPxI5URre6dDpJ0CtcthSZVBAfI+Uw7un5OYNVxP2EYi3H81Jw701yFP7AU+/vCE7xBtFmjge7kfhhk4+RAiig==
+eslint-config-airbnb-typescript@^18.0.0:
+  version "18.0.0"
+  resolved "https://registry.yarnpkg.com/eslint-config-airbnb-typescript/-/eslint-config-airbnb-typescript-18.0.0.tgz#b1646db4134858d704b1d2bee47e1d72c180315f"
+  integrity sha512-oc+Lxzgzsu8FQyFVa4QFaVKiitTYiiW3frB9KYW5OWdPrqFc7FzxgB20hP4cHMlr+MBzGcLl3jnCOVOydL9mIg==
   dependencies:
     eslint-config-airbnb-base "^15.0.0"
 
@@ -5240,16 +5298,16 @@ eslint-module-utils@^2.1.1:
     pkg-dir "^2.0.0"
 
 eslint-module-utils@^2.8.0:
-  version "2.8.0"
-  resolved "https://registry.yarnpkg.com/eslint-module-utils/-/eslint-module-utils-2.8.0.tgz#e439fee65fc33f6bba630ff621efc38ec0375c49"
-  integrity sha512-aWajIYfsqCKRDgUfjEXNN/JlrzauMuSEy5sbd7WXbtW3EH6A6MpwEh42c7qD+MqQo9QMJ6fWLAeIJynx0g6OAw==
+  version "2.8.1"
+  resolved "https://registry.yarnpkg.com/eslint-module-utils/-/eslint-module-utils-2.8.1.tgz#52f2404300c3bd33deece9d7372fb337cc1d7c34"
+  integrity sha512-rXDXR3h7cs7dy9RNpUlQf80nX31XWJEyGq1tRMo+6GsO5VmTe4UTwtmonAD4ZkAsrfMVDA2wlGJ3790Ys+D49Q==
   dependencies:
     debug "^3.2.7"
 
-eslint-plugin-import@^2.29.0:
-  version "2.29.0"
-  resolved "https://registry.yarnpkg.com/eslint-plugin-import/-/eslint-plugin-import-2.29.0.tgz#8133232e4329ee344f2f612885ac3073b0b7e155"
-  integrity sha512-QPOO5NO6Odv5lpoTkddtutccQjysJuFxoPS7fAHO+9m9udNHvTCPSAMW9zGAYj8lAIdr40I8yPCdUYrncXtrwg==
+eslint-plugin-import@^2.29.1:
+  version "2.29.1"
+  resolved "https://registry.yarnpkg.com/eslint-plugin-import/-/eslint-plugin-import-2.29.1.tgz#d45b37b5ef5901d639c15270d74d46d161150643"
+  integrity sha512-BbPC0cuExzhiMo4Ff1BTVwHpjjv28C5R+btTOGaCRC7UEz801up0JadwkeSk5Ued6TG34uaczuVuH6qyy5YUxw==
   dependencies:
     array-includes "^3.1.7"
     array.prototype.findlastindex "^1.2.3"
@@ -5267,7 +5325,7 @@ eslint-plugin-import@^2.29.0:
     object.groupby "^1.0.1"
     object.values "^1.1.7"
     semver "^6.3.1"
-    tsconfig-paths "^3.14.2"
+    tsconfig-paths "^3.15.0"
 
 eslint-plugin-import@~2.9.0:
   version "2.9.0"
@@ -5342,15 +5400,15 @@ eslint-visitor-keys@^3.3.0, eslint-visitor-keys@^3.4.1, eslint-visitor-keys@^3.4
   integrity sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==
 
 eslint@^8.54.0:
-  version "8.54.0"
-  resolved "https://registry.yarnpkg.com/eslint/-/eslint-8.54.0.tgz#588e0dd4388af91a2e8fa37ea64924074c783537"
-  integrity sha512-NY0DfAkM8BIZDVl6PgSa1ttZbx3xHgJzSNJKYcQglem6CppHyMhRIQkBVSSMaSRnLhig3jsDbEzOjwCVt4AmmA==
+  version "8.57.0"
+  resolved "https://registry.yarnpkg.com/eslint/-/eslint-8.57.0.tgz#c786a6fd0e0b68941aaf624596fb987089195668"
+  integrity sha512-dZ6+mexnaTIbSBZWgou51U6OmzIhYM2VcNdtiTtI7qPNZm35Akpr0f6vtw3w1Kmn5PYo+tZVfh13WrhpS6oLqQ==
   dependencies:
     "@eslint-community/eslint-utils" "^4.2.0"
     "@eslint-community/regexpp" "^4.6.1"
-    "@eslint/eslintrc" "^2.1.3"
-    "@eslint/js" "8.54.0"
-    "@humanwhocodes/config-array" "^0.11.13"
+    "@eslint/eslintrc" "^2.1.4"
+    "@eslint/js" "8.57.0"
+    "@humanwhocodes/config-array" "^0.11.14"
     "@humanwhocodes/module-importer" "^1.0.1"
     "@nodelib/fs.walk" "^1.2.8"
     "@ungap/structured-clone" "^1.2.0"
@@ -5502,9 +5560,9 @@ esquery@^1.0.0:
     estraverse "^5.1.0"
 
 esquery@^1.4.2:
-  version "1.5.0"
-  resolved "https://registry.yarnpkg.com/esquery/-/esquery-1.5.0.tgz#6ce17738de8577694edd7361c57182ac8cb0db0b"
-  integrity sha512-YQLXUplAwJgCydQ78IMJywZCceoqk1oH01OERdSAJc/7U2AylwjhSCLDEtqwg811idIS/9fIU5GjG73IgjKMVg==
+  version "1.6.0"
+  resolved "https://registry.yarnpkg.com/esquery/-/esquery-1.6.0.tgz#91419234f804d852a82dceec3e16cdc22cf9dae7"
+  integrity sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==
   dependencies:
     estraverse "^5.1.0"
 
@@ -5528,9 +5586,9 @@ estraverse@^4.1.0, estraverse@^4.1.1:
   integrity sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==
 
 estraverse@^5.1.0, estraverse@^5.2.0:
-  version "5.2.0"
-  resolved "https://registry.yarnpkg.com/estraverse/-/estraverse-5.2.0.tgz#307df42547e6cc7324d3cf03c155d5cdb8c53880"
-  integrity sha512-BxbNGGNm0RyRYvUdHpIwv9IWzeM9XClbOxwoATuFdOE7ZE6wHL+HQ5T8hoPM+zHvmKzzsEqhgy0GrQ5X13afiQ==
+  version "5.3.0"
+  resolved "https://registry.yarnpkg.com/estraverse/-/estraverse-5.3.0.tgz#2eea5290702f26ab8fe5370370ff86c965d21123"
+  integrity sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==
 
 esutils@^2.0.2:
   version "2.0.3"
@@ -5602,15 +5660,15 @@ expand-brackets@^2.1.4:
     to-regex "^3.0.1"
 
 expect@^29.0.0:
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/expect/-/expect-29.4.2.tgz#2ae34eb88de797c64a1541ad0f1e2ea8a7a7b492"
-  integrity sha512-+JHYg9O3hd3RlICG90OPVjRkPBoiUH7PxvDVMnRiaq1g6JUgZStX514erMl0v2Dc5SkfVbm7ztqbd6qHHPn+mQ==
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/expect/-/expect-29.7.0.tgz#578874590dcb3214514084c08115d8aee61e11bc"
+  integrity sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==
   dependencies:
-    "@jest/expect-utils" "^29.4.2"
-    jest-get-type "^29.4.2"
-    jest-matcher-utils "^29.4.2"
-    jest-message-util "^29.4.2"
-    jest-util "^29.4.2"
+    "@jest/expect-utils" "^29.7.0"
+    jest-get-type "^29.6.3"
+    jest-matcher-utils "^29.7.0"
+    jest-message-util "^29.7.0"
+    jest-util "^29.7.0"
 
 expect@^29.4.1:
   version "29.4.1"
@@ -5740,9 +5798,9 @@ fast-levenshtein@^2.0.6, fast-levenshtein@~2.0.6:
   integrity sha1-PYpcZog6FqMMqGQ+hR8Zuqd5eRc=
 
 fastq@^1.6.0:
-  version "1.10.1"
-  resolved "https://registry.yarnpkg.com/fastq/-/fastq-1.10.1.tgz#8b8f2ac8bf3632d67afcd65dac248d5fdc45385e"
-  integrity sha512-AWuv6Ery3pM+dY7LYS8YIaCiQvUaos9OB1RyNgaOWnaX+Tik7Onvcsf8x8c+YtDeT0maYLniBip2hox5KtEXXA==
+  version "1.17.1"
+  resolved "https://registry.yarnpkg.com/fastq/-/fastq-1.17.1.tgz#2a523f07a4e7b1e81a42b91b8bf2254107753b47"
+  integrity sha512-sRVD3lWVIXWg6By68ZN7vho9a1pQcN/WBFaAAsDDFzlJjvoGx0P8z7V1t72grFJfJhu3YPZBuu25f7Kaw2jN1w==
   dependencies:
     reusify "^1.0.4"
 
@@ -5800,10 +5858,10 @@ fill-range@^4.0.0:
     repeat-string "^1.6.1"
     to-regex-range "^2.1.0"
 
-fill-range@^7.0.1:
-  version "7.0.1"
-  resolved "https://registry.yarnpkg.com/fill-range/-/fill-range-7.0.1.tgz#1919a6a7c75fe38b2c7c77e5198535da9acdda40"
-  integrity sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ==
+fill-range@^7.0.1, fill-range@^7.1.1:
+  version "7.1.1"
+  resolved "https://registry.yarnpkg.com/fill-range/-/fill-range-7.1.1.tgz#44265d3cac07e3ea7dc247516380643754a05292"
+  integrity sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==
   dependencies:
     to-regex-range "^5.0.1"
 
@@ -5870,17 +5928,18 @@ flat-cache@^1.2.1:
     write "^0.2.1"
 
 flat-cache@^3.0.4:
-  version "3.0.4"
-  resolved "https://registry.yarnpkg.com/flat-cache/-/flat-cache-3.0.4.tgz#61b0338302b2fe9f957dcc32fc2a87f1c3048b11"
-  integrity sha512-dm9s5Pw7Jc0GvMYbshN6zchCA9RgQlzzEZX3vylR9IqFfS8XciblUXOKfW6SiuJ0e13eDYZoZV5wdrev7P3Nwg==
+  version "3.2.0"
+  resolved "https://registry.yarnpkg.com/flat-cache/-/flat-cache-3.2.0.tgz#2c0c2d5040c99b1632771a9d105725c0115363ee"
+  integrity sha512-CYcENa+FtcUKLmhhqyctpclsq7QF38pKjZHsGNiSQF5r4FtoKDWabFDl3hzaEQMvT1LHEysw5twgLvpYYb4vbw==
   dependencies:
-    flatted "^3.1.0"
+    flatted "^3.2.9"
+    keyv "^4.5.3"
     rimraf "^3.0.2"
 
-flatted@^3.1.0:
-  version "3.1.1"
-  resolved "https://registry.yarnpkg.com/flatted/-/flatted-3.1.1.tgz#c4b489e80096d9df1dfc97c79871aea7c617c469"
-  integrity sha512-zAoAQiudy+r5SvnSw3KJy5os/oRJYHzrzja/tBDqrZtNhUw8bt6y8OBzMWcjWr+8liV8Eb6yOhw8WZ7VFZ5ZzA==
+flatted@^3.2.9:
+  version "3.3.1"
+  resolved "https://registry.yarnpkg.com/flatted/-/flatted-3.3.1.tgz#21db470729a6734d4997002f439cb308987f567a"
+  integrity sha512-X8cqMLLie7KsNUDSdzeN8FYK9rEt4Dt67OsG/DNGnYTSDBG4uFAJFBnUeiV+zCVAvwFy56IjM9sH51jVaEhNxw==
 
 flush-write-stream@^1.0.0:
   version "1.1.1"
@@ -5993,7 +6052,7 @@ fs-write-stream-atomic@^1.0.8:
 fs.realpath@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/fs.realpath/-/fs.realpath-1.0.0.tgz#1504ad2523158caa40db4a2787cb01411994ea4f"
-  integrity sha1-FQStJSMVjKpA20onh8sBQRmU6k8=
+  integrity sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==
 
 fsevents@^2.1.2, fsevents@^2.3.2:
   version "2.3.2"
@@ -6005,12 +6064,7 @@ fsevents@~2.3.3:
   resolved "https://registry.yarnpkg.com/fsevents/-/fsevents-2.3.3.tgz#cac6407785d03675a2a5e1a5305c697b347d90d6"
   integrity sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==
 
-function-bind@^1.1.1:
-  version "1.1.1"
-  resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.1.tgz#a56899d3ea3c9bab874bb9773b7c5ede92f4895d"
-  integrity sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==
-
-function-bind@^1.1.2:
+function-bind@^1.1.1, function-bind@^1.1.2:
   version "1.1.2"
   resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.2.tgz#2c02d864d97f3ea6c8830c464cbd11ab6eab7a1c"
   integrity sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==
@@ -6074,20 +6128,12 @@ get-caller-file@^2.0.1, get-caller-file@^2.0.5:
   resolved "https://registry.yarnpkg.com/get-caller-file/-/get-caller-file-2.0.5.tgz#4f94412a82db32f36e3b0b9741f8a97feb031f7e"
   integrity sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==
 
-get-intrinsic@^1.0.2:
-  version "1.1.1"
-  resolved "https://registry.yarnpkg.com/get-intrinsic/-/get-intrinsic-1.1.1.tgz#15f59f376f855c446963948f0d24cd3637b4abc6"
-  integrity sha512-kWZrnVM42QCiEA2Ig1bG8zjoIMOgxWwYCEeNdwY6Tv/cOSeGpcoX4pXHfKUxNKVoArnrEr2e9srnAxxGIraS9Q==
-  dependencies:
-    function-bind "^1.1.1"
-    has "^1.0.3"
-    has-symbols "^1.0.1"
-
-get-intrinsic@^1.1.1, get-intrinsic@^1.1.3, get-intrinsic@^1.2.0, get-intrinsic@^1.2.1, get-intrinsic@^1.2.2:
-  version "1.2.2"
-  resolved "https://registry.yarnpkg.com/get-intrinsic/-/get-intrinsic-1.2.2.tgz#281b7622971123e1ef4b3c90fd7539306da93f3b"
-  integrity sha512-0gSo4ml/0j98Y3lngkFEot/zhiCeWsbYIlZ+uZOVgzLyLaUw7wxUL+nCTP0XJvJg1AXulJRI3UJi8GsbDuxdGA==
+get-intrinsic@^1.1.3, get-intrinsic@^1.2.1, get-intrinsic@^1.2.3, get-intrinsic@^1.2.4:
+  version "1.2.4"
+  resolved "https://registry.yarnpkg.com/get-intrinsic/-/get-intrinsic-1.2.4.tgz#e385f5a4b5227d449c3eabbad05494ef0abbeadd"
+  integrity sha512-5uYhsJH8VJBTv7oslg4BznJYhDoRI6waYCxMmCdnTrcCrHA/fCFKoTFz2JKKE0HdDFUF7/oQuhzumXJK7paBRQ==
   dependencies:
+    es-errors "^1.3.0"
     function-bind "^1.1.2"
     has-proto "^1.0.1"
     has-symbols "^1.0.3"
@@ -6141,18 +6187,19 @@ get-stream@^6.0.0:
   resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-6.0.1.tgz#a262d8eef67aced57c2852ad6167526a43cbf7b7"
   integrity sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==
 
-get-symbol-description@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/get-symbol-description/-/get-symbol-description-1.0.0.tgz#7fdb81c900101fbd564dd5f1a30af5aadc1e58d6"
-  integrity sha512-2EmdH1YvIQiZpltCNgkuiUnyukzxM/R6NDJX31Ke3BG1Nq5b0S2PhX59UKi9vZpPDQVdqn+1IcaAwnzTT5vCjw==
+get-symbol-description@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/get-symbol-description/-/get-symbol-description-1.0.2.tgz#533744d5aa20aca4e079c8e5daf7fd44202821f5"
+  integrity sha512-g0QYk1dZBxGwk+Ngc+ltRH2IBp2f7zBkBMBJZCDerh6EhlhSR6+9irMCuT/09zD6qkarHUSn529sK/yL4S27mg==
   dependencies:
-    call-bind "^1.0.2"
-    get-intrinsic "^1.1.1"
+    call-bind "^1.0.5"
+    es-errors "^1.3.0"
+    get-intrinsic "^1.2.4"
 
-get-tsconfig@^4.7.2:
-  version "4.7.3"
-  resolved "https://registry.yarnpkg.com/get-tsconfig/-/get-tsconfig-4.7.3.tgz#0498163d98f7b58484dd4906999c0c9d5f103f83"
-  integrity sha512-ZvkrzoUA0PQZM6fy6+/Hce561s+faD1rsNwhnO5FelNjyy7EMGJ3Rz1AQ8GYDWjhRs/7dBLOEJvhK8MiEJOAFg==
+get-tsconfig@^4.7.5:
+  version "4.7.6"
+  resolved "https://registry.yarnpkg.com/get-tsconfig/-/get-tsconfig-4.7.6.tgz#118fd5b7b9bae234cc7705a00cd771d7eb65d62a"
+  integrity sha512-ZAqrLlu18NbDdRaHq+AKXzAmqIUPswPWKUchfytdAjiRFnCe5ojG2bstg6mRiZabkKfCoL/e98pbBELIV/YCeA==
   dependencies:
     resolve-pkg-maps "^1.0.0"
 
@@ -6256,7 +6303,7 @@ glob-to-regexp@^0.3.0:
   resolved "https://registry.yarnpkg.com/glob-to-regexp/-/glob-to-regexp-0.3.0.tgz#8c5a1494d2066c570cc3bfe4496175acc4d502ab"
   integrity sha1-jFoUlNIGbFcMw7/kSWF1rMTVAqs=
 
-glob@^7.0.5, glob@^7.1.1, glob@^7.1.2, glob@^7.1.3, glob@^7.1.4, glob@^7.1.6:
+glob@^7.0.5, glob@^7.1.1, glob@^7.1.2, glob@^7.1.4, glob@^7.1.6:
   version "7.1.6"
   resolved "https://registry.yarnpkg.com/glob/-/glob-7.1.6.tgz#141f33b81a7c2492e125594307480c46679278a6"
   integrity sha512-LwaxwyZ72Lk7vZINtNNrywX0ZuLyStrdDtabefZKAY5ZGJhVtgdznluResxNmPitE0SAO+O26sWTHeKSI2wMBA==
@@ -6268,6 +6315,18 @@ glob@^7.0.5, glob@^7.1.1, glob@^7.1.2, glob@^7.1.3, glob@^7.1.4, glob@^7.1.6:
     once "^1.3.0"
     path-is-absolute "^1.0.0"
 
+glob@^7.1.3:
+  version "7.2.3"
+  resolved "https://registry.yarnpkg.com/glob/-/glob-7.2.3.tgz#b8df0fb802bbfa8e89bd1d938b4e16578ed44f2b"
+  integrity sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==
+  dependencies:
+    fs.realpath "^1.0.0"
+    inflight "^1.0.4"
+    inherits "2"
+    minimatch "^3.1.1"
+    once "^1.3.0"
+    path-is-absolute "^1.0.0"
+
 global-dirs@^0.1.1:
   version "0.1.1"
   resolved "https://registry.yarnpkg.com/global-dirs/-/global-dirs-0.1.1.tgz#b319c0dd4607f353f3be9cca4c72fc148c49f445"
@@ -6281,18 +6340,19 @@ globals@^11.0.1, globals@^11.1.0:
   integrity sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==
 
 globals@^13.19.0:
-  version "13.23.0"
-  resolved "https://registry.yarnpkg.com/globals/-/globals-13.23.0.tgz#ef31673c926a0976e1f61dab4dca57e0c0a8af02"
-  integrity sha512-XAmF0RjlrjY23MA51q3HltdlGxUpXPvg0GioKiD9X6HD28iMjo2dKC8Vqwm7lne4GNr78+RHTfliktR6ZH09wA==
+  version "13.24.0"
+  resolved "https://registry.yarnpkg.com/globals/-/globals-13.24.0.tgz#8432a19d78ce0c1e833949c36adb345400bb1171"
+  integrity sha512-AhO5QUcj8llrbG09iWhPU2B204J1xnPeL8kQmVorSsy+Sjj1sk8gIyh6cUocGmH4L0UuhAJy+hJMRA4mgA4mFQ==
   dependencies:
     type-fest "^0.20.2"
 
 globalthis@^1.0.3:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/globalthis/-/globalthis-1.0.3.tgz#5852882a52b80dc301b0660273e1ed082f0b6ccf"
-  integrity sha512-sFdI5LyBiNTHjRd7cGPWapiHWMOXKyuBNX/cWJ3NfzrZQVa8GI/8cofCl74AOVqq9W5kNmguTIzJ/1s2gyI9wA==
+  version "1.0.4"
+  resolved "https://registry.yarnpkg.com/globalthis/-/globalthis-1.0.4.tgz#7430ed3a975d97bfb59bcce41f5cabbafa651236"
+  integrity sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==
   dependencies:
-    define-properties "^1.1.3"
+    define-properties "^1.2.1"
+    gopd "^1.0.1"
 
 globby@^11.1.0:
   version "11.1.0"
@@ -6343,11 +6403,16 @@ graceful-fs@^4.1.11, graceful-fs@^4.1.15, graceful-fs@^4.1.2, graceful-fs@^4.1.6
   resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.4.tgz#2256bde14d3632958c465ebc96dc467ca07a29fb"
   integrity sha512-WjKPNJF79dtJAVniUlGGWHYGz2jWxT6VhN/4m1NdkbZ2nOsEF+cI1Edgql5zCRhs/VsQYRvrXctxktVXZUkixw==
 
-graceful-fs@^4.2.4, graceful-fs@^4.2.9:
+graceful-fs@^4.2.4:
   version "4.2.10"
   resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.10.tgz#147d3a006da4ca3ce14728c7aefc287c367d7a6c"
   integrity sha512-9ByhssR2fPVsNZj478qUUbKfmL0+t5BDVyjShtyZZLiK7ZDAArFFfopyOTj0M05wE2tJPisA4iTnnXl2YoPvOA==
 
+graceful-fs@^4.2.9:
+  version "4.2.11"
+  resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.11.tgz#4183e4e8bf08bb6e05bbb2f7d2e0c8f712ca40e3"
+  integrity sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==
+
 graphemer@^1.4.0:
   version "1.4.0"
   resolved "https://registry.yarnpkg.com/graphemer/-/graphemer-1.4.0.tgz#fb2f1d55e0e3a1849aeffc90c4fa0dd53a0e66c6"
@@ -6415,7 +6480,7 @@ has-cors@1.1.0:
 has-flag@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/has-flag/-/has-flag-3.0.0.tgz#b5d454dc2199ae225699f3467e5a07f3b955bafd"
-  integrity sha1-tdRU3CGZriJWmfNGfloH87lVuv0=
+  integrity sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==
 
 has-flag@^4.0.0:
   version "4.0.0"
@@ -6427,34 +6492,34 @@ has-own-prop@^2.0.0:
   resolved "https://registry.yarnpkg.com/has-own-prop/-/has-own-prop-2.0.0.tgz#f0f95d58f65804f5d218db32563bb85b8e0417af"
   integrity sha512-Pq0h+hvsVm6dDEa8x82GnLSYHOzNDt7f0ddFa3FqcQlgzEiptPqL+XrOJNavjOzSYiYWIrgeVYYgGlLmnxwilQ==
 
-has-property-descriptors@^1.0.0:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/has-property-descriptors/-/has-property-descriptors-1.0.1.tgz#52ba30b6c5ec87fd89fa574bc1c39125c6f65340"
-  integrity sha512-VsX8eaIewvas0xnvinAe9bw4WfIeODpGYikiWYLH+dma0Jw6KHYqWiWfhQlgOVK8D6PvjubK5Uc4P0iIhIcNVg==
+has-property-descriptors@^1.0.0, has-property-descriptors@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz#963ed7d071dc7bf5f084c5bfbe0d1b6222586854"
+  integrity sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==
   dependencies:
-    get-intrinsic "^1.2.2"
+    es-define-property "^1.0.0"
 
-has-proto@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/has-proto/-/has-proto-1.0.1.tgz#1885c1305538958aff469fef37937c22795408e0"
-  integrity sha512-7qE+iP+O+bgF9clE5+UoBFzE65mlBiVj3tKCrlNQ0Ogwm0BjpT/gK4SlLYDMybDh5I3TCTKnPPa0oMG7JDYrhg==
+has-proto@^1.0.1, has-proto@^1.0.3:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/has-proto/-/has-proto-1.0.3.tgz#b31ddfe9b0e6e9914536a6ab286426d0214f77fd"
+  integrity sha512-SJ1amZAJUiZS+PhsVLf5tGydlaVB8EdFpaSO4gmiUKUOxk8qzn5AIy4ZeJUmh22znIdk/uMAUT2pl3FxzVUH+Q==
 
-has-symbols@^1.0.0, has-symbols@^1.0.1:
+has-symbols@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/has-symbols/-/has-symbols-1.0.1.tgz#9f5214758a44196c406d9bd76cebf81ec2dd31e8"
   integrity sha512-PLcsoqu++dmEIZB+6totNFKq/7Do+Z0u4oT0zKOJNl3lYK6vGwwu2hjHs+68OEZbTjiUE9bgOABXbP/GvrS0Kg==
 
-has-symbols@^1.0.2, has-symbols@^1.0.3:
+has-symbols@^1.0.1, has-symbols@^1.0.2, has-symbols@^1.0.3:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/has-symbols/-/has-symbols-1.0.3.tgz#bb7b2c4349251dce87b125f7bdf874aa7c8b39f8"
   integrity sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==
 
-has-tostringtag@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/has-tostringtag/-/has-tostringtag-1.0.0.tgz#7e133818a7d394734f941e73c3d3f9291e658b25"
-  integrity sha512-kFjcSNhnlGV1kyoGk7OXKSawH5JOb/LzUc5w9B02hOTO0dfFRjbHQKvg1d6cf3HbeUmtU9VbbV3qzZ2Teh97WQ==
+has-tostringtag@^1.0.0, has-tostringtag@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/has-tostringtag/-/has-tostringtag-1.0.2.tgz#2cdc42d40bef2e5b4eeab7c01a73c54ce7ab5abc"
+  integrity sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==
   dependencies:
-    has-symbols "^1.0.2"
+    has-symbols "^1.0.3"
 
 has-unicode@^2.0.0, has-unicode@^2.0.1:
   version "2.0.1"
@@ -6492,13 +6557,18 @@ has-values@^1.0.0:
     is-number "^3.0.0"
     kind-of "^4.0.0"
 
-has@^1.0.1, has@^1.0.3:
+has@^1.0.1:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/has/-/has-1.0.3.tgz#722d7cbfc1f6aa8241f16dd814e011e1f41e8796"
   integrity sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==
   dependencies:
     function-bind "^1.1.1"
 
+has@^1.0.3:
+  version "1.0.4"
+  resolved "https://registry.yarnpkg.com/has/-/has-1.0.4.tgz#2eb2860e000011dae4f1406a86fe80e530fb2ec6"
+  integrity sha512-qdSAmqLF6209RFj4VVItywPMbm3vWylknmB3nvNiUIs72xAimcM8nVYxYr7ncvZq5qzk9MKIZR8ijqD/1QuYjQ==
+
 hash-base@^3.0.0:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/hash-base/-/hash-base-3.1.0.tgz#55c381d9e06e1d2997a883b4a3fddfe7f0d3af33"
@@ -6524,10 +6594,10 @@ hasha@^5.0.0:
     is-stream "^2.0.0"
     type-fest "^0.8.0"
 
-hasown@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/hasown/-/hasown-2.0.0.tgz#f4c513d454a57b7c7e1650778de226b11700546c"
-  integrity sha512-vUptKVTpIJhcczKBbgnS+RtcuYMB8+oNzPK2/Hp3hanz8JmpATdmmgLgSaadVREkDm+e2giHwY3ZRkyjSIDDFA==
+hasown@^2.0.0, hasown@^2.0.1, hasown@^2.0.2:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/hasown/-/hasown-2.0.2.tgz#003eaf91be7adc372e84ec59dc37252cedb80003"
+  integrity sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==
   dependencies:
     function-bind "^1.1.2"
 
@@ -6657,15 +6727,10 @@ ignore@^4.0.3:
   resolved "https://registry.yarnpkg.com/ignore/-/ignore-4.0.6.tgz#750e3db5862087b4737ebac8207ffd1ef27b25fc"
   integrity sha512-cyFDKrqc/YdcWFniJhzI42+AzS+gNwmUzOSFcRCQYwySuBBBy/KjuxWLZ/FHEH6Moq1NizMOBWyTcv8O4OZIMg==
 
-ignore@^5.2.0:
-  version "5.2.4"
-  resolved "https://registry.yarnpkg.com/ignore/-/ignore-5.2.4.tgz#a291c0c6178ff1b960befe47fcdec301674a6324"
-  integrity sha512-MAb38BcSbH0eHNBxn7ql2NH/kX33OkB3lZ1BNdh7ENeRChHTYsTvWrMubiIAMNS2llXEEgZ1MUOBtXChP3kaFQ==
-
-ignore@^5.2.4:
-  version "5.3.0"
-  resolved "https://registry.yarnpkg.com/ignore/-/ignore-5.3.0.tgz#67418ae40d34d6999c95ff56016759c718c82f78"
-  integrity sha512-g7dmpshy+gD7mh88OC9NwSGTKoc3kyLAZQRU1mt53Aw/vnvfXnbC+F/7F7QoYVKbV+KNvJx8wArewKy1vXMtlg==
+ignore@^5.2.0, ignore@^5.3.1:
+  version "5.3.2"
+  resolved "https://registry.yarnpkg.com/ignore/-/ignore-5.3.2.tgz#3cd40e729f3643fd87cb04e50bf0eb722bc596f5"
+  integrity sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==
 
 import-fresh@^2.0.0:
   version "2.0.0"
@@ -6702,7 +6767,7 @@ import-local@^3.0.2:
 imurmurhash@^0.1.4:
   version "0.1.4"
   resolved "https://registry.yarnpkg.com/imurmurhash/-/imurmurhash-0.1.4.tgz#9218b9b2b928a238b13dc4fb6b6d576f231453ea"
-  integrity sha1-khi5srkoojixPcT7a21XbyMUU+o=
+  integrity sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==
 
 indent-string@^2.1.0:
   version "2.1.0"
@@ -6739,7 +6804,7 @@ infer-owner@^1.0.3, infer-owner@^1.0.4:
 inflight@^1.0.4:
   version "1.0.6"
   resolved "https://registry.yarnpkg.com/inflight/-/inflight-1.0.6.tgz#49bd6331d7d02d0c09bc910a1075ba8165b56df9"
-  integrity sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=
+  integrity sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==
   dependencies:
     once "^1.3.0"
     wrappy "1"
@@ -6812,12 +6877,12 @@ inquirer@^6.2.0:
     strip-ansi "^5.1.0"
     through "^2.3.6"
 
-internal-slot@^1.0.5:
-  version "1.0.6"
-  resolved "https://registry.yarnpkg.com/internal-slot/-/internal-slot-1.0.6.tgz#37e756098c4911c5e912b8edbf71ed3aa116f930"
-  integrity sha512-Xj6dv+PsbtwyPpEflsejS+oIZxmMlV44zAhG479uYu89MsjcYOhCFnNyKrkJrihbsiasQyY0afoCl/9BLR65bg==
+internal-slot@^1.0.7:
+  version "1.0.7"
+  resolved "https://registry.yarnpkg.com/internal-slot/-/internal-slot-1.0.7.tgz#c06dcca3ed874249881007b0a5523b172a190802"
+  integrity sha512-NGnrKwXzSms2qUUih/ILZ5JBqNTSa1+ZmP6flaIp6KmSElgE9qdndzS3cqjrDovwFdmwsGsLdeFgB6suw+1e9g==
   dependencies:
-    get-intrinsic "^1.2.2"
+    es-errors "^1.3.0"
     hasown "^2.0.0"
     side-channel "^1.0.4"
 
@@ -6845,14 +6910,13 @@ is-arguments@^1.0.4:
   resolved "https://registry.yarnpkg.com/is-arguments/-/is-arguments-1.0.4.tgz#3faf966c7cba0ff437fb31f6250082fcf0448cf3"
   integrity sha512-xPh0Rmt8NE65sNzvyUmWgI1tz3mKq74lGA0mL8LYZcoIzKOzDh6HmrYm3d18k60nHerC8A9Km8kYu87zfSFnLA==
 
-is-array-buffer@^3.0.1, is-array-buffer@^3.0.2:
-  version "3.0.2"
-  resolved "https://registry.yarnpkg.com/is-array-buffer/-/is-array-buffer-3.0.2.tgz#f2653ced8412081638ecb0ebbd0c41c6e0aecbbe"
-  integrity sha512-y+FyyR/w8vfIRq4eQcM1EYgSTnmHXPqaF+IgzgraytCFq5Xh8lllDVmAZolPJiZttZLeFSINPYMaEJ7/vWUa1w==
+is-array-buffer@^3.0.4:
+  version "3.0.4"
+  resolved "https://registry.yarnpkg.com/is-array-buffer/-/is-array-buffer-3.0.4.tgz#7a1f92b3d61edd2bc65d24f130530ea93d7fae98"
+  integrity sha512-wcjaerHw0ydZwfhiKbXJWLDY8A7yV7KhjQOpb83hGgGfId/aQa4TOvwyzn2PuswW2gPCYEL/nEAiSVpdOj1lXw==
   dependencies:
     call-bind "^1.0.2"
-    get-intrinsic "^1.2.0"
-    is-typed-array "^1.1.10"
+    get-intrinsic "^1.2.1"
 
 is-arrayish@^0.2.1:
   version "0.2.1"
@@ -6889,16 +6953,16 @@ is-buffer@^1.1.5:
   resolved "https://registry.yarnpkg.com/is-buffer/-/is-buffer-1.1.6.tgz#efaa2ea9daa0d7ab2ea13a97b2b8ad51fefbe8be"
   integrity sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==
 
-is-callable@^1.1.3, is-callable@^1.1.4, is-callable@^1.2.0:
-  version "1.2.0"
-  resolved "https://registry.yarnpkg.com/is-callable/-/is-callable-1.2.0.tgz#83336560b54a38e35e3a2df7afd0454d691468bb"
-  integrity sha512-pyVD9AaGLxtg6srb2Ng6ynWJqkHU9bEM087AKck0w8QwDarTfNcpIYoU8x8Hv2Icm8u6kFJM18Dag8lyqGkviw==
-
-is-callable@^1.2.7:
+is-callable@^1.1.3, is-callable@^1.1.4, is-callable@^1.2.7:
   version "1.2.7"
   resolved "https://registry.yarnpkg.com/is-callable/-/is-callable-1.2.7.tgz#3bc2a85ea742d9e36205dcacdd72ca1fdc51b055"
   integrity sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==
 
+is-callable@^1.2.0:
+  version "1.2.0"
+  resolved "https://registry.yarnpkg.com/is-callable/-/is-callable-1.2.0.tgz#83336560b54a38e35e3a2df7afd0454d691468bb"
+  integrity sha512-pyVD9AaGLxtg6srb2Ng6ynWJqkHU9bEM087AKck0w8QwDarTfNcpIYoU8x8Hv2Icm8u6kFJM18Dag8lyqGkviw==
+
 is-ci@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/is-ci/-/is-ci-2.0.0.tgz#6bc6334181810e04b5c22b3d589fdca55026404c"
@@ -6907,11 +6971,11 @@ is-ci@^2.0.0:
     ci-info "^2.0.0"
 
 is-core-module@^2.13.0, is-core-module@^2.13.1:
-  version "2.13.1"
-  resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.13.1.tgz#ad0d7532c6fea9da1ebdc82742d74525c6273384"
-  integrity sha512-hHrIjvZsftOsvKSn2TRYl63zvxsgE0K+0mYMoH6gD4omR5IWB2KynivBQczo3+wF1cCkjzvptnI9Q0sPU66ilw==
+  version "2.15.0"
+  resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.15.0.tgz#71c72ec5442ace7e76b306e9d48db361f22699ea"
+  integrity sha512-Dd+Lb2/zvk9SKy1TGCt1wFJFo/MWBPMX5x7KcvLajWTGuomczdQX61PvY5yK6SVACwpoexWo81IfFyoKY2QnTA==
   dependencies:
-    hasown "^2.0.0"
+    hasown "^2.0.2"
 
 is-core-module@^2.5.0, is-core-module@^2.9.0:
   version "2.11.0"
@@ -6934,7 +6998,21 @@ is-data-descriptor@^1.0.0:
   dependencies:
     kind-of "^6.0.0"
 
-is-date-object@^1.0.1, is-date-object@^1.0.2:
+is-data-view@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/is-data-view/-/is-data-view-1.0.1.tgz#4b4d3a511b70f3dc26d42c03ca9ca515d847759f"
+  integrity sha512-AHkaJrsUVW6wq6JS8y3JnM/GJF/9cf+k20+iDzlSaJrinEo5+7vRiteOSwBhHRiAyQATN1AmY4hwzxJKPmYf+w==
+  dependencies:
+    is-typed-array "^1.1.13"
+
+is-date-object@^1.0.1:
+  version "1.0.5"
+  resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.0.5.tgz#0841d5536e724c25597bf6ea62e1bd38298df31f"
+  integrity sha512-9YQaSxsAiSwcvS33MBk3wTCVnWK+HhF8VZR2jRxehM16QcVOdHqPn4VPHmRK4lSr38n9JriurInLcP90xsYNfQ==
+  dependencies:
+    has-tostringtag "^1.0.0"
+
+is-date-object@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.0.2.tgz#bda736f2cd8fd06d32844e7743bfa7494c3bfd7e"
   integrity sha512-USlDT524woQ08aoZFzh3/Z6ch9Y/EWXEHQ/AaRN0SkKq4t2Jw2R2339tSXmwuVoY7LLlBCbOIlx2myP/L5zk0g==
@@ -7023,14 +7101,7 @@ is-glob@^3.1.0:
   dependencies:
     is-extglob "^2.1.0"
 
-is-glob@^4.0.0, is-glob@^4.0.1:
-  version "4.0.1"
-  resolved "https://registry.yarnpkg.com/is-glob/-/is-glob-4.0.1.tgz#7567dbe9f2f5e2467bc77ab83c4a29482407a5dc"
-  integrity sha512-5G0tKtBTFImOqDnLB2hG6Bp2qcKEFduo4tZu9MT/H6NQv/ghhy30o55ufafxJ/LdH79LLs2Kfrn85TLKyA7BUg==
-  dependencies:
-    is-extglob "^2.1.1"
-
-is-glob@^4.0.3:
+is-glob@^4.0.0, is-glob@^4.0.1, is-glob@^4.0.3:
   version "4.0.3"
   resolved "https://registry.yarnpkg.com/is-glob/-/is-glob-4.0.3.tgz#64f61e42cbbb2eec2071a9dac0b28ba1e65d5084"
   integrity sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==
@@ -7054,10 +7125,10 @@ is-negative-zero@^2.0.0:
   resolved "https://registry.yarnpkg.com/is-negative-zero/-/is-negative-zero-2.0.0.tgz#9553b121b0fac28869da9ed459e20c7543788461"
   integrity sha1-lVOxIbD6wohp2p7UWeIMdUN4hGE=
 
-is-negative-zero@^2.0.2:
-  version "2.0.2"
-  resolved "https://registry.yarnpkg.com/is-negative-zero/-/is-negative-zero-2.0.2.tgz#7bf6f03a28003b8b3965de3ac26f664d765f3150"
-  integrity sha512-dqJvarLawXsFbNDeJW7zAz8ItJ9cd28YufuuFzh0G8pNHjJMnY08Dv7sYX2uF5UpQOwieAeOExEYAWWfu7ZZUA==
+is-negative-zero@^2.0.3:
+  version "2.0.3"
+  resolved "https://registry.yarnpkg.com/is-negative-zero/-/is-negative-zero-2.0.3.tgz#ced903a027aca6381b777a5743069d7376a49747"
+  integrity sha512-5KoIu2Ngpyek75jXodFvnafB6DJgr3u8uuK0LEZJjrU19DrMD3EVERaR8sjz8CCGgpZvxPl9SuE1GMVPFHx1mw==
 
 is-number-object@^1.0.3:
   version "1.0.4"
@@ -7140,12 +7211,12 @@ is-set@^2.0.1:
   resolved "https://registry.yarnpkg.com/is-set/-/is-set-2.0.1.tgz#d1604afdab1724986d30091575f54945da7e5f43"
   integrity sha512-eJEzOtVyenDs1TMzSQ3kU3K+E0GUS9sno+F0OBT97xsgcJsF9nXMBtkT9/kut5JEpM7oL7X/0qxR17K3mcwIAA==
 
-is-shared-array-buffer@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/is-shared-array-buffer/-/is-shared-array-buffer-1.0.2.tgz#8f259c573b60b6a32d4058a1a07430c0a7344c79"
-  integrity sha512-sqN2UDu1/0y6uvXyStCOzyhAjCSlHceFoMKJW8W9EU9cvic/QdsZ0kEU93HEy3IUEFZIiH/3w+AH/UQbPHNdhA==
+is-shared-array-buffer@^1.0.2, is-shared-array-buffer@^1.0.3:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/is-shared-array-buffer/-/is-shared-array-buffer-1.0.3.tgz#1237f1cba059cdb62431d378dcc37d9680181688"
+  integrity sha512-nA2hv5XIhLR3uVzDDfCIknerhx8XUKnstuOERPNNIinXG7v9u+ohXF67vxm4TPTEPU6lm61ZkwP3c9PCB97rhg==
   dependencies:
-    call-bind "^1.0.2"
+    call-bind "^1.0.7"
 
 is-ssh@^1.3.0:
   version "1.3.2"
@@ -7164,26 +7235,19 @@ is-stream@^2.0.0:
   resolved "https://registry.yarnpkg.com/is-stream/-/is-stream-2.0.0.tgz#bde9c32680d6fae04129d6ac9d921ce7815f78e3"
   integrity sha512-XCoy+WlUr7d1+Z8GgSuXmpuUFC9fOhRXglJMx+dwLKTkL44Cjd4W1Z5P+BQZpr+cR93aGP4S/s7Ftw6Nd/kiEw==
 
-is-string@^1.0.4, is-string@^1.0.5:
+is-string@^1.0.4:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/is-string/-/is-string-1.0.5.tgz#40493ed198ef3ff477b8c7f92f644ec82a5cd3a6"
   integrity sha512-buY6VNRjhQMiF1qWDouloZlQbRhDPCebwxSjxMjxgemYT46YMd2NR0/H+fBhEfWX4A/w9TBJ+ol+okqJKFE6vQ==
 
-is-string@^1.0.7:
+is-string@^1.0.5, is-string@^1.0.7:
   version "1.0.7"
   resolved "https://registry.yarnpkg.com/is-string/-/is-string-1.0.7.tgz#0dd12bf2006f255bb58f695110eff7491eebc0fd"
   integrity sha512-tE2UXzivje6ofPW7l23cjDOMa09gb7xlAqG6jG5ej6uPV32TlWP3NKPigtaGeHNu9fohccRYvIiZMfOOnOYUtg==
   dependencies:
     has-tostringtag "^1.0.0"
 
-is-symbol@^1.0.2:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/is-symbol/-/is-symbol-1.0.3.tgz#38e1014b9e6329be0de9d24a414fd7441ec61937"
-  integrity sha512-OwijhaRSgqvhm/0ZdAcXNZt9lYdKFpcRDT5ULUuYXPoT794UNOdU+gpT6Rzo7b4V2HUl/op6GqY894AZwv9faQ==
-  dependencies:
-    has-symbols "^1.0.1"
-
-is-symbol@^1.0.3:
+is-symbol@^1.0.2, is-symbol@^1.0.3:
   version "1.0.4"
   resolved "https://registry.yarnpkg.com/is-symbol/-/is-symbol-1.0.4.tgz#a6dac93b635b063ca6872236de88910a57af139c"
   integrity sha512-C/CPBqKWnvdcxqIARxyOh4v1UUEOCHpgDa0WYgpKDFMszcrPcffg5uhwSgPCLD2WWxmq6isisz87tzT01tuGhg==
@@ -7197,12 +7261,12 @@ is-text-path@^1.0.1:
   dependencies:
     text-extensions "^1.0.0"
 
-is-typed-array@^1.1.10, is-typed-array@^1.1.12, is-typed-array@^1.1.9:
-  version "1.1.12"
-  resolved "https://registry.yarnpkg.com/is-typed-array/-/is-typed-array-1.1.12.tgz#d0bab5686ef4a76f7a73097b95470ab199c57d4a"
-  integrity sha512-Z14TF2JNG8Lss5/HMqt0//T9JeHXttXy5pH/DBU4vi98ozO2btxzq9MwYDZYnKwU8nRsz/+GVFVRDq3DkVuSPg==
+is-typed-array@^1.1.13:
+  version "1.1.13"
+  resolved "https://registry.yarnpkg.com/is-typed-array/-/is-typed-array-1.1.13.tgz#d6c5ca56df62334959322d7d7dd1cca50debe229"
+  integrity sha512-uZ25/bUAlUY5fR4OKT4rZQEBrzQWYV9ZJYGGsUmEJ6thodVJ1HX64ePQ6Z0qPWP+m+Uq6e9UugrE38jeYsDSMw==
   dependencies:
-    which-typed-array "^1.1.11"
+    which-typed-array "^1.1.14"
 
 is-typed-array@^1.1.3:
   version "1.1.3"
@@ -7271,7 +7335,7 @@ isarray@^2.0.1, isarray@^2.0.5:
 isexe@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/isexe/-/isexe-2.0.0.tgz#e8fbf374dc556ff8947a10dcb0572d633f2cfa10"
-  integrity sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=
+  integrity sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==
 
 isobject@^2.0.0:
   version "2.1.0"
@@ -7474,15 +7538,15 @@ jest-diff@^29.4.1:
     jest-get-type "^29.2.0"
     pretty-format "^29.4.1"
 
-jest-diff@^29.4.2:
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/jest-diff/-/jest-diff-29.4.2.tgz#b88502d5dc02d97f6512d73c37da8b36f49b4871"
-  integrity sha512-EK8DSajVtnjx9sa1BkjZq3mqChm2Cd8rIzdXkQMA8e0wuXq53ypz6s5o5V8HRZkoEt2ywJ3eeNWFKWeYr8HK4g==
+jest-diff@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-diff/-/jest-diff-29.7.0.tgz#017934a66ebb7ecf6f205e84699be10afd70458a"
+  integrity sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==
   dependencies:
     chalk "^4.0.0"
-    diff-sequences "^29.4.2"
-    jest-get-type "^29.4.2"
-    pretty-format "^29.4.2"
+    diff-sequences "^29.6.3"
+    jest-get-type "^29.6.3"
+    pretty-format "^29.7.0"
 
 jest-docblock@^29.2.0:
   version "29.2.0"
@@ -7519,10 +7583,10 @@ jest-get-type@^29.2.0:
   resolved "https://registry.yarnpkg.com/jest-get-type/-/jest-get-type-29.2.0.tgz#726646f927ef61d583a3b3adb1ab13f3a5036408"
   integrity sha512-uXNJlg8hKFEnDgFsrCjznB+sTxdkuqiCL6zMgA75qEbAJjJYTs9XPrvDctrEig2GDow22T/LvHgO57iJhXB/UA==
 
-jest-get-type@^29.4.2:
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/jest-get-type/-/jest-get-type-29.4.2.tgz#7cb63f154bca8d8f57364d01614477d466fa43fe"
-  integrity sha512-vERN30V5i2N6lqlFu4ljdTqQAgrkTFMC9xaIIfOPYBw04pufjXRty5RuXBiB1d72tGbURa/UgoiHB90ruOSivg==
+jest-get-type@^29.6.3:
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/jest-get-type/-/jest-get-type-29.6.3.tgz#36f499fdcea197c1045a127319c0481723908fd1"
+  integrity sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==
 
 jest-haste-map@^26.6.2:
   version "26.6.2"
@@ -7582,15 +7646,15 @@ jest-matcher-utils@^29.4.1:
     jest-get-type "^29.2.0"
     pretty-format "^29.4.1"
 
-jest-matcher-utils@^29.4.2:
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/jest-matcher-utils/-/jest-matcher-utils-29.4.2.tgz#08d0bf5abf242e3834bec92c7ef5071732839e85"
-  integrity sha512-EZaAQy2je6Uqkrm6frnxBIdaWtSYFoR8SVb2sNLAtldswlR/29JAgx+hy67llT3+hXBaLB0zAm5UfeqerioZyg==
+jest-matcher-utils@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz#ae8fec79ff249fd592ce80e3ee474e83a6c44f12"
+  integrity sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==
   dependencies:
     chalk "^4.0.0"
-    jest-diff "^29.4.2"
-    jest-get-type "^29.4.2"
-    pretty-format "^29.4.2"
+    jest-diff "^29.7.0"
+    jest-get-type "^29.6.3"
+    pretty-format "^29.7.0"
 
 jest-message-util@^26.6.2:
   version "26.6.2"
@@ -7622,18 +7686,18 @@ jest-message-util@^29.4.1:
     slash "^3.0.0"
     stack-utils "^2.0.3"
 
-jest-message-util@^29.4.2:
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/jest-message-util/-/jest-message-util-29.4.2.tgz#309a2924eae6ca67cf7f25781a2af1902deee717"
-  integrity sha512-SElcuN4s6PNKpOEtTInjOAA8QvItu0iugkXqhYyguRvQoXapg5gN+9RQxLAkakChZA7Y26j6yUCsFWN+hlKD6g==
+jest-message-util@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-message-util/-/jest-message-util-29.7.0.tgz#8bc392e204e95dfe7564abbe72a404e28e51f7f3"
+  integrity sha512-GBEV4GRADeP+qtB2+6u61stea8mGcOT4mCtrYISZwfu9/ISHFJ/5zOMXYbpBE9RsS5+Gb63DW4FgmnKJ79Kf6w==
   dependencies:
     "@babel/code-frame" "^7.12.13"
-    "@jest/types" "^29.4.2"
+    "@jest/types" "^29.6.3"
     "@types/stack-utils" "^2.0.0"
     chalk "^4.0.0"
     graceful-fs "^4.2.9"
     micromatch "^4.0.4"
-    pretty-format "^29.4.2"
+    pretty-format "^29.7.0"
     slash "^3.0.0"
     stack-utils "^2.0.3"
 
@@ -7816,12 +7880,12 @@ jest-util@^29.4.1:
     graceful-fs "^4.2.9"
     picomatch "^2.2.3"
 
-jest-util@^29.4.2:
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/jest-util/-/jest-util-29.4.2.tgz#3db8580b295df453a97de4a1b42dd2578dabd2c2"
-  integrity sha512-wKnm6XpJgzMUSRFB7YF48CuwdzuDIHenVuoIb1PLuJ6F+uErZsuDkU+EiExkChf6473XcawBrSfDSnXl+/YG4g==
+jest-util@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-util/-/jest-util-29.7.0.tgz#23c2b62bfb22be82b44de98055802ff3710fc0bc"
+  integrity sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==
   dependencies:
-    "@jest/types" "^29.4.2"
+    "@jest/types" "^29.6.3"
     "@types/node" "*"
     chalk "^4.0.0"
     ci-info "^3.2.0"
@@ -7928,6 +7992,11 @@ jsesc@^2.5.1:
   resolved "https://registry.yarnpkg.com/jsesc/-/jsesc-2.5.2.tgz#80564d2e483dacf6e8ef209650a67df3f0c283a4"
   integrity sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==
 
+json-buffer@3.0.1:
+  version "3.0.1"
+  resolved "https://registry.yarnpkg.com/json-buffer/-/json-buffer-3.0.1.tgz#9338802a30d3b6605fbe0613e094008ca8c05a13"
+  integrity sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==
+
 json-parse-better-errors@^1.0.0, json-parse-better-errors@^1.0.1:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/json-parse-better-errors/-/json-parse-better-errors-1.0.2.tgz#bb867cfb3450e69107c131d1c514bab3dc8bcaa9"
@@ -7956,7 +8025,7 @@ json-schema@0.2.3:
 json-stable-stringify-without-jsonify@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz#9db7b59496ad3f3cfef30a75142d2d930ad72651"
-  integrity sha1-nbe1lJatPzz+8wp1FC0tkwrXJlE=
+  integrity sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==
 
 json-stringify-safe@^5.0.1, json-stringify-safe@~5.0.1:
   version "5.0.1"
@@ -8036,6 +8105,13 @@ keccak@^1.3.0:
     nan "^2.2.1"
     safe-buffer "^5.1.0"
 
+keyv@^4.5.3:
+  version "4.5.4"
+  resolved "https://registry.yarnpkg.com/keyv/-/keyv-4.5.4.tgz#a879a99e29452f942439f2a405e3af8b31d4de93"
+  integrity sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==
+  dependencies:
+    json-buffer "3.0.1"
+
 kind-of@^3.0.2, kind-of@^3.0.3, kind-of@^3.2.0:
   version "3.2.2"
   resolved "https://registry.yarnpkg.com/kind-of/-/kind-of-3.2.2.tgz#31ea21a734bab9bbb0f32466d893aea51e4a3c64"
@@ -8545,11 +8621,11 @@ micromatch@^4.0.2:
     picomatch "^2.0.5"
 
 micromatch@^4.0.4:
-  version "4.0.5"
-  resolved "https://registry.yarnpkg.com/micromatch/-/micromatch-4.0.5.tgz#bc8999a7cbbf77cdc89f132f6e467051b49090c6"
-  integrity sha512-DMy+ERcEW2q8Z2Po+WNXuw3c5YaUSFjAO5GsJqfEl7UjvtIuFKO6ZrKvcItdy98dwFI2N1tg3zNIdKaQT+aNdA==
+  version "4.0.7"
+  resolved "https://registry.yarnpkg.com/micromatch/-/micromatch-4.0.7.tgz#33e8190d9fe474a9895525f5618eee136d46c2e5"
+  integrity sha512-LPP/3KorzCwBxfeUuZmaR6bG2kdeHSbe0P2tY3FLRU4vYrjYz5hI4QZwV0njUx3jeuKe67YukQ1LSPZBKDqO/Q==
   dependencies:
-    braces "^3.0.2"
+    braces "^3.0.3"
     picomatch "^2.3.1"
 
 mime-db@1.44.0:
@@ -8596,20 +8672,27 @@ minimalistic-crypto-utils@^1.0.0, minimalistic-crypto-utils@^1.0.1:
   resolved "https://registry.yarnpkg.com/minimalistic-crypto-utils/-/minimalistic-crypto-utils-1.0.1.tgz#f6c00c1c0b082246e5c4d99dfb8c7c083b2b582a"
   integrity sha1-9sAMHAsIIkblxNmd+4x8CDsrWCo=
 
-minimatch@^3.0.2, minimatch@^3.0.3, minimatch@^3.0.4:
+minimatch@^3.0.2, minimatch@^3.0.3:
   version "3.0.4"
   resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-3.0.4.tgz#5166e286457f03306064be5497e8dbb0c3d32083"
   integrity sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==
   dependencies:
     brace-expansion "^1.1.7"
 
-minimatch@^3.0.5, minimatch@^3.1.2:
+minimatch@^3.0.4, minimatch@^3.0.5, minimatch@^3.1.1, minimatch@^3.1.2:
   version "3.1.2"
   resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-3.1.2.tgz#19cd194bfd3e428f049a70817c038d89ab4be35b"
   integrity sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==
   dependencies:
     brace-expansion "^1.1.7"
 
+minimatch@^9.0.4:
+  version "9.0.5"
+  resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-9.0.5.tgz#d74f9dd6b57d83d8e98cfb82133b03978bc929e5"
+  integrity sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==
+  dependencies:
+    brace-expansion "^2.0.1"
+
 minimist-options@4.1.0:
   version "4.1.0"
   resolved "https://registry.yarnpkg.com/minimist-options/-/minimist-options-4.1.0.tgz#c0655713c53a8a2ebd77ffa247d342c40f010619"
@@ -8627,12 +8710,12 @@ minimist-options@^3.0.1:
     arrify "^1.0.1"
     is-plain-obj "^1.1.0"
 
-minimist@^1.1.0, minimist@^1.1.3, minimist@^1.2.0, minimist@^1.2.5:
+minimist@^1.1.0, minimist@^1.1.3, minimist@^1.2.5:
   version "1.2.5"
   resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.5.tgz#67d66014b66a6a8aaa0c083c5fd58df4e4e97602"
   integrity sha512-FM9nNUYrRBAELZQT3xeZQ7fmMOBg6nWNmJKTcgsJeaLstP/UODVpGsr5OhXhhXg6f+qtJ8uiZ+PUxkDWcgIXLw==
 
-minimist@^1.1.1, minimist@^1.2.6:
+minimist@^1.1.1, minimist@^1.2.0, minimist@^1.2.6:
   version "1.2.8"
   resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.8.tgz#c1a464e7693302e082a075cee0c057741ac4772c"
   integrity sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==
@@ -8717,11 +8800,16 @@ ms@2.0.0:
   resolved "https://registry.yarnpkg.com/ms/-/ms-2.0.0.tgz#5608aeadfc00be6c2901df5f9861788de0d597c8"
   integrity sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g=
 
-ms@2.1.2, ms@^2.0.0, ms@^2.1.1:
+ms@2.1.2, ms@^2.0.0:
   version "2.1.2"
   resolved "https://registry.yarnpkg.com/ms/-/ms-2.1.2.tgz#d09d1f357b443f493382a8eb3ccd183872ae6009"
   integrity sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==
 
+ms@^2.1.1:
+  version "2.1.3"
+  resolved "https://registry.yarnpkg.com/ms/-/ms-2.1.3.tgz#574c8138ce1d2b5861f0b44579dbadd60c6615b2"
+  integrity sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==
+
 multimatch@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/multimatch/-/multimatch-3.0.0.tgz#0e2534cc6bc238d9ab67e1b9cd5fcd85a6dbf70b"
@@ -8781,7 +8869,7 @@ nanomatch@^1.2.9:
 natural-compare@^1.4.0:
   version "1.4.0"
   resolved "https://registry.yarnpkg.com/natural-compare/-/natural-compare-1.4.0.tgz#4abebfeed7541f2c27acfb29bdbbd15c8d5ba4f7"
-  integrity sha1-Sr6/7tdUHywnrPspvbvRXI1bpPc=
+  integrity sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==
 
 negotiator@0.6.2:
   version "0.6.2"
@@ -9072,10 +9160,10 @@ object-copy@^0.1.0:
     define-property "^0.2.5"
     kind-of "^3.0.3"
 
-object-inspect@^1.13.1, object-inspect@^1.9.0:
-  version "1.13.1"
-  resolved "https://registry.yarnpkg.com/object-inspect/-/object-inspect-1.13.1.tgz#b96c6109324ccfef6b12216a956ca4dc2ff94bc2"
-  integrity sha512-5qoj1RUiKOMsCCNLV1CBiPYE10sziTsnmNxkAI/rZhiD63CF7IqdFGC/XzjWjpSgLf0LxXX3bDFIh0E18f6UhQ==
+object-inspect@^1.13.1:
+  version "1.13.2"
+  resolved "https://registry.yarnpkg.com/object-inspect/-/object-inspect-1.13.2.tgz#dea0088467fb991e67af4058147a24824a3043ff"
+  integrity sha512-IRZSRuzJiynemAXPYtPe5BoI/RESNYR7TYm50MC5Mqbd3Jmw5y790sErYw3V6SryFJD64b74qQQs9wn5Bg/k3g==
 
 object-inspect@^1.7.0, object-inspect@^1.8.0:
   version "1.8.0"
@@ -9122,13 +9210,13 @@ object.assign@^4.1.2:
     has-symbols "^1.0.1"
     object-keys "^1.1.1"
 
-object.assign@^4.1.4:
-  version "4.1.4"
-  resolved "https://registry.yarnpkg.com/object.assign/-/object.assign-4.1.4.tgz#9673c7c7c351ab8c4d0b516f4343ebf4dfb7799f"
-  integrity sha512-1mxKf0e58bvyjSCtKYY4sRe9itRk3PJpquJOjeIkz885CczcI4IvJJDLPS72oowuSh+pBxUFROpX+TU++hxhZQ==
+object.assign@^4.1.5:
+  version "4.1.5"
+  resolved "https://registry.yarnpkg.com/object.assign/-/object.assign-4.1.5.tgz#3a833f9ab7fdb80fc9e8d2300c803d216d8fdbb0"
+  integrity sha512-byy+U7gp+FVwmyzKPYhW2h5l3crpmGsxl7X2s8y43IgxvG4g3QZ6CffDtsNQy1WsmZpQbO+ybo0AlW7TY6DcBQ==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.1.4"
+    call-bind "^1.0.5"
+    define-properties "^1.2.1"
     has-symbols "^1.0.3"
     object-keys "^1.1.1"
 
@@ -9142,13 +9230,14 @@ object.entries@^1.1.5:
     es-abstract "^1.22.1"
 
 object.fromentries@^2.0.7:
-  version "2.0.7"
-  resolved "https://registry.yarnpkg.com/object.fromentries/-/object.fromentries-2.0.7.tgz#71e95f441e9a0ea6baf682ecaaf37fa2a8d7e616"
-  integrity sha512-UPbPHML6sL8PI/mOqPwsH4G6iyXcCGzLin8KvEPenOZN5lpCNBZZQ+V62vdjB1mQHrmqGQt5/OJzemUA+KJmEA==
+  version "2.0.8"
+  resolved "https://registry.yarnpkg.com/object.fromentries/-/object.fromentries-2.0.8.tgz#f7195d8a9b97bd95cbc1999ea939ecd1a2b00c65"
+  integrity sha512-k6E21FzySsSK5a21KRADBd/NGneRegFO5pLHfdQLpRDETUNJueLXs3WCzyQ3tFRDYgbq3KHGXfTbi2bs8WQ6rQ==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
+    call-bind "^1.0.7"
+    define-properties "^1.2.1"
+    es-abstract "^1.23.2"
+    es-object-atoms "^1.0.0"
 
 object.getownpropertydescriptors@^2.0.3:
   version "2.1.0"
@@ -9159,14 +9248,13 @@ object.getownpropertydescriptors@^2.0.3:
     es-abstract "^1.17.0-next.1"
 
 object.groupby@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/object.groupby/-/object.groupby-1.0.1.tgz#d41d9f3c8d6c778d9cbac86b4ee9f5af103152ee"
-  integrity sha512-HqaQtqLnp/8Bn4GL16cj+CUYbnpe1bh0TtEaWvybszDG4tgxCJuRpV8VGuvNaI1fAnI4lUJzDG55MXcOH4JZcQ==
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/object.groupby/-/object.groupby-1.0.3.tgz#9b125c36238129f6f7b61954a1e7176148d5002e"
+  integrity sha512-+Lhy3TQTuzXI5hevh8sBGqbmurHbbIjAi0Z4S63nthVLmLxfbj4T54a4CfZrXIrt9iP4mVAPYMo/v99taj3wjQ==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
-    get-intrinsic "^1.2.1"
+    call-bind "^1.0.7"
+    define-properties "^1.2.1"
+    es-abstract "^1.23.2"
 
 object.pick@^1.3.0:
   version "1.3.0"
@@ -9176,13 +9264,13 @@ object.pick@^1.3.0:
     isobject "^3.0.1"
 
 object.values@^1.1.7:
-  version "1.1.7"
-  resolved "https://registry.yarnpkg.com/object.values/-/object.values-1.1.7.tgz#617ed13272e7e1071b43973aa1655d9291b8442a"
-  integrity sha512-aU6xnDFYT3x17e/f0IiiwlGPTy2jzMySGfUB4fq6z7CV8l85CWHDk5ErhyhpfDHhrOMwGFhSQkhMGHaIotA6Ng==
+  version "1.2.0"
+  resolved "https://registry.yarnpkg.com/object.values/-/object.values-1.2.0.tgz#65405a9d92cee68ac2d303002e0b8470a4d9ab1b"
+  integrity sha512-yBYjY9QX2hnRmZHAjG/f13MzmBzxzYgQhFrke06TTyKY5zSTEqkOeukBzIdVA3j3ulu8Qa3MbVFShV7T2RmGtQ==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
+    call-bind "^1.0.7"
+    define-properties "^1.2.1"
+    es-object-atoms "^1.0.0"
 
 octokit-pagination-methods@^1.1.0:
   version "1.1.0"
@@ -9223,16 +9311,16 @@ optionator@^0.8.2:
     word-wrap "~1.2.3"
 
 optionator@^0.9.3:
-  version "0.9.3"
-  resolved "https://registry.yarnpkg.com/optionator/-/optionator-0.9.3.tgz#007397d44ed1872fdc6ed31360190f81814e2c64"
-  integrity sha512-JjCoypp+jKn1ttEFExxhetCKeJt9zhAgAve5FXHixTvFDW/5aEktX9bufBKLRRMdU7bNtpLfcGu94B3cdEJgjg==
+  version "0.9.4"
+  resolved "https://registry.yarnpkg.com/optionator/-/optionator-0.9.4.tgz#7ea1c1a5d91d764fb282139c88fe11e182a3a734"
+  integrity sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==
   dependencies:
-    "@aashutoshrathi/word-wrap" "^1.2.3"
     deep-is "^0.1.3"
     fast-levenshtein "^2.0.6"
     levn "^0.4.1"
     prelude-ls "^1.2.1"
     type-check "^0.4.0"
+    word-wrap "^1.2.5"
 
 os-homedir@^1.0.0:
   version "1.0.2"
@@ -9528,7 +9616,7 @@ path-exists@^4.0.0:
 path-is-absolute@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/path-is-absolute/-/path-is-absolute-1.0.1.tgz#174b9268735534ffbc7ace6bf53a5a9e1b5c5f5f"
-  integrity sha1-F0uSaHNVNP+8es5r9TpanhtcX18=
+  integrity sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==
 
 path-is-inside@^1.0.2:
   version "1.0.2"
@@ -9699,6 +9787,11 @@ posix-character-classes@^0.1.0:
   resolved "https://registry.yarnpkg.com/posix-character-classes/-/posix-character-classes-0.1.1.tgz#01eac0fe3b5af71a2a6c02feabb8c1fef7e00eab"
   integrity sha1-AerA/jta9xoqbAL+q7jB/vfgDqs=
 
+possible-typed-array-names@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/possible-typed-array-names/-/possible-typed-array-names-1.0.0.tgz#89bb63c6fada2c3e90adc4a647beeeb39cc7bf8f"
+  integrity sha512-d7Uw+eZoloe0EHDIYoe+bQ5WXnGMOpmiZFTuMWCwpjzzkL2nTjcKiAk4hh8TjnGye2TwWOk3UXucZ+3rbmBa8Q==
+
 preact@8.2.9:
   version "8.2.9"
   resolved "https://registry.yarnpkg.com/preact/-/preact-8.2.9.tgz#813ba9dd45e5d97c5ea0d6c86d375b3be711cc40"
@@ -9724,12 +9817,12 @@ pretty-format@^26.6.2:
     ansi-styles "^4.0.0"
     react-is "^17.0.1"
 
-pretty-format@^29.0.0, pretty-format@^29.4.2:
-  version "29.4.2"
-  resolved "https://registry.yarnpkg.com/pretty-format/-/pretty-format-29.4.2.tgz#64bf5ccc0d718c03027d94ac957bdd32b3fb2401"
-  integrity sha512-qKlHR8yFVCbcEWba0H0TOC8dnLlO4vPlyEjRPw31FZ2Rupy9nLa8ZLbYny8gWEl8CkEhJqAE6IzdNELTBVcBEg==
+pretty-format@^29.0.0, pretty-format@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/pretty-format/-/pretty-format-29.7.0.tgz#ca42c758310f365bfa71a0bda0a807160b776812"
+  integrity sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==
   dependencies:
-    "@jest/schemas" "^29.4.2"
+    "@jest/schemas" "^29.6.3"
     ansi-styles "^5.0.0"
     react-is "^18.0.0"
 
@@ -9856,7 +9949,12 @@ pumpify@^1.3.3:
     inherits "^2.0.3"
     pump "^2.0.0"
 
-punycode@^2.1.0, punycode@^2.1.1:
+punycode@^2.1.0:
+  version "2.3.1"
+  resolved "https://registry.yarnpkg.com/punycode/-/punycode-2.3.1.tgz#027422e2faec0b25e1549c3e1bd8309b9133b6e5"
+  integrity sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==
+
+punycode@^2.1.1:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/punycode/-/punycode-2.1.1.tgz#b58b010ac40c22c5657616c8d2c2c02c7bf479ec"
   integrity sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==
@@ -9895,9 +9993,9 @@ querystringify@^2.1.1:
   integrity sha512-FIqgj2EUvTa7R50u0rGsyTftzjYmv/a3hO345bZNrqabNqjtgiDMgmo4mkUjd+nzU5oF3dClKqFIPUKybUyqoQ==
 
 queue-microtask@^1.2.2:
-  version "1.2.2"
-  resolved "https://registry.yarnpkg.com/queue-microtask/-/queue-microtask-1.2.2.tgz#abf64491e6ecf0f38a6502403d4cda04f372dfd3"
-  integrity sha512-dB15eXv3p2jDlbOiNLyMabYg1/sXvppd8DP2J3EOCQ0AkuSXCW2tP7mnVouVLJKgUMY6yP0kcQDVpLCN13h4Xg==
+  version "1.2.3"
+  resolved "https://registry.yarnpkg.com/queue-microtask/-/queue-microtask-1.2.3.tgz#4929228bbc724dfac43e0efb058caf7b6cfb6243"
+  integrity sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==
 
 quick-lru@^1.0.0:
   version "1.1.0"
@@ -9937,9 +10035,9 @@ react-is@^17.0.1:
   integrity sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==
 
 react-is@^18.0.0:
-  version "18.2.0"
-  resolved "https://registry.yarnpkg.com/react-is/-/react-is-18.2.0.tgz#199431eeaaa2e09f86427efbb4f1473edb47609b"
-  integrity sha512-xWGDIW6x921xtzPkhiULtthJHoJvBbF3q26fzloPCK0hsvxtPVelvftw3zjbHWSkR2km9Z+4uxbDDK/6Zw9B8w==
+  version "18.3.1"
+  resolved "https://registry.yarnpkg.com/react-is/-/react-is-18.3.1.tgz#e83557dc12eae63a99e003a46388b1dcbb44db7e"
+  integrity sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==
 
 read-cmd-shim@^1.0.1:
   version "1.0.5"
@@ -10143,14 +10241,15 @@ regexp.prototype.flags@^1.3.0:
     define-properties "^1.1.3"
     es-abstract "^1.17.0-next.1"
 
-regexp.prototype.flags@^1.5.1:
-  version "1.5.1"
-  resolved "https://registry.yarnpkg.com/regexp.prototype.flags/-/regexp.prototype.flags-1.5.1.tgz#90ce989138db209f81492edd734183ce99f9677e"
-  integrity sha512-sy6TXMN+hnP/wMy+ISxg3krXx7BAtWVO4UouuCN/ziM9UEne0euamVNafDfvC83bRNr95y0V5iijeDQFUNpvrg==
+regexp.prototype.flags@^1.5.2:
+  version "1.5.2"
+  resolved "https://registry.yarnpkg.com/regexp.prototype.flags/-/regexp.prototype.flags-1.5.2.tgz#138f644a3350f981a858c44f6bb1a61ff59be334"
+  integrity sha512-NcDiDkTLuPR+++OCKB0nWafEmhg/Da8aUPLPMQbK+bxKKCm1/S5he+AqYa4PlMCVBalb4/yxIRub6qkEx5yJbw==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    set-function-name "^2.0.0"
+    call-bind "^1.0.6"
+    define-properties "^1.2.1"
+    es-errors "^1.3.0"
+    set-function-name "^2.0.1"
 
 release-zalgo@^1.0.0:
   version "1.0.0"
@@ -10423,13 +10522,13 @@ rxjs@^6.4.0:
   dependencies:
     tslib "^1.9.0"
 
-safe-array-concat@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/safe-array-concat/-/safe-array-concat-1.0.1.tgz#91686a63ce3adbea14d61b14c99572a8ff84754c"
-  integrity sha512-6XbUAseYE2KtOuGueyeobCySj9L4+66Tn6KQMOPQJrAJEowYKW/YR/MGJZl7FdydUdaFu4LYyDZjxf4/Nmo23Q==
+safe-array-concat@^1.1.2:
+  version "1.1.2"
+  resolved "https://registry.yarnpkg.com/safe-array-concat/-/safe-array-concat-1.1.2.tgz#81d77ee0c4e8b863635227c721278dd524c20edb"
+  integrity sha512-vj6RsCsWBCf19jIeHEfkRMw8DPiBb+DMXklQ/1SGDHOMlHdPUkZXFQ2YdplS23zESTijAcurb1aSgJA3AgMu1Q==
   dependencies:
-    call-bind "^1.0.2"
-    get-intrinsic "^1.2.1"
+    call-bind "^1.0.7"
+    get-intrinsic "^1.2.4"
     has-symbols "^1.0.3"
     isarray "^2.0.5"
 
@@ -10443,13 +10542,13 @@ safe-buffer@~5.1.0, safe-buffer@~5.1.1:
   resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.1.2.tgz#991ec69d296e0313747d59bdfd2b745c35f8828d"
   integrity sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==
 
-safe-regex-test@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/safe-regex-test/-/safe-regex-test-1.0.0.tgz#793b874d524eb3640d1873aad03596db2d4f2295"
-  integrity sha512-JBUUzyOgEwXQY1NuPtvcj/qcBDbDmEvWufhlnXZIm75DEHp+afM1r1ujJpJsV/gSM4t59tpDyPi1sd6ZaPFfsA==
+safe-regex-test@^1.0.3:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/safe-regex-test/-/safe-regex-test-1.0.3.tgz#a5b4c0f06e0ab50ea2c395c14d8371232924c377"
+  integrity sha512-CdASjNJPvRa7roO6Ra/gLYBTzYzzPyyBXxIMdGW3USQLyjWEls2RgW5UBTXaQVp+OrpeCK3bLem8smtmheoRuw==
   dependencies:
-    call-bind "^1.0.2"
-    get-intrinsic "^1.1.3"
+    call-bind "^1.0.6"
+    es-errors "^1.3.0"
     is-regex "^1.1.4"
 
 safe-regex@^1.1.0:
@@ -10539,36 +10638,37 @@ semver@^7.3.5:
   dependencies:
     lru-cache "^6.0.0"
 
-semver@^7.5.4:
-  version "7.5.4"
-  resolved "https://registry.yarnpkg.com/semver/-/semver-7.5.4.tgz#483986ec4ed38e1c6c48c34894a9182dbff68a6e"
-  integrity sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==
-  dependencies:
-    lru-cache "^6.0.0"
+semver@^7.5.4, semver@^7.6.0:
+  version "7.6.3"
+  resolved "https://registry.yarnpkg.com/semver/-/semver-7.6.3.tgz#980f7b5550bc175fb4dc09403085627f9eb33143"
+  integrity sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==
 
 set-blocking@^2.0.0, set-blocking@~2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/set-blocking/-/set-blocking-2.0.0.tgz#045f9782d011ae9a6803ddd382b24392b3d890f7"
   integrity sha1-BF+XgtARrppoA93TgrJDkrPYkPc=
 
-set-function-length@^1.1.1:
-  version "1.1.1"
-  resolved "https://registry.yarnpkg.com/set-function-length/-/set-function-length-1.1.1.tgz#4bc39fafb0307224a33e106a7d35ca1218d659ed"
-  integrity sha512-VoaqjbBJKiWtg4yRcKBQ7g7wnGnLV3M8oLvVWwOk2PdYY6PEFegR1vezXR0tw6fZGF9csVakIRjrJiy2veSBFQ==
+set-function-length@^1.2.1:
+  version "1.2.2"
+  resolved "https://registry.yarnpkg.com/set-function-length/-/set-function-length-1.2.2.tgz#aac72314198eaed975cf77b2c3b6b880695e5449"
+  integrity sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==
   dependencies:
-    define-data-property "^1.1.1"
-    get-intrinsic "^1.2.1"
+    define-data-property "^1.1.4"
+    es-errors "^1.3.0"
+    function-bind "^1.1.2"
+    get-intrinsic "^1.2.4"
     gopd "^1.0.1"
-    has-property-descriptors "^1.0.0"
+    has-property-descriptors "^1.0.2"
 
-set-function-name@^2.0.0:
-  version "2.0.1"
-  resolved "https://registry.yarnpkg.com/set-function-name/-/set-function-name-2.0.1.tgz#12ce38b7954310b9f61faa12701620a0c882793a"
-  integrity sha512-tMNCiqYVkXIZgc2Hnoy2IvC/f8ezc5koaRFkCjrpWzGpCd3qbZXPzVy9MAZzK1ch/X0jvSkojys3oqJN0qCmdA==
+set-function-name@^2.0.1:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/set-function-name/-/set-function-name-2.0.2.tgz#16a705c5a0dc2f5e638ca96d8a8cd4e1c2b90985"
+  integrity sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ==
   dependencies:
-    define-data-property "^1.0.1"
+    define-data-property "^1.1.4"
+    es-errors "^1.3.0"
     functions-have-names "^1.2.3"
-    has-property-descriptors "^1.0.0"
+    has-property-descriptors "^1.0.2"
 
 set-value@^2.0.0, set-value@^2.0.1:
   version "2.0.1"
@@ -10633,13 +10733,14 @@ side-channel@^1.0.2:
     object-inspect "^1.8.0"
 
 side-channel@^1.0.4:
-  version "1.0.4"
-  resolved "https://registry.yarnpkg.com/side-channel/-/side-channel-1.0.4.tgz#efce5c8fdc104ee751b25c58d4290011fa5ea2cf"
-  integrity sha512-q5XPytqFEIKHkGdiMIrY10mvLRvnQh42/+GoBlFW3b2LXLE2xxJpZFdm94we0BaoV3RwJyGqg5wS7epxTv0Zvw==
+  version "1.0.6"
+  resolved "https://registry.yarnpkg.com/side-channel/-/side-channel-1.0.6.tgz#abd25fb7cd24baf45466406b1096b7831c9215f2"
+  integrity sha512-fDW/EZ6Q9RiO8eFG8Hj+7u/oW+XrPTIChwCOM2+th2A6OblDtYYIpve9m+KvI9Z4C9qSEXlaGR6bTEYHReuglA==
   dependencies:
-    call-bind "^1.0.0"
-    get-intrinsic "^1.0.2"
-    object-inspect "^1.9.0"
+    call-bind "^1.0.7"
+    es-errors "^1.3.0"
+    get-intrinsic "^1.2.4"
+    object-inspect "^1.13.1"
 
 signal-exit@^3.0.0, signal-exit@^3.0.2:
   version "3.0.3"
@@ -11056,14 +11157,15 @@ string.prototype.trim@^1.2.1:
     es-abstract "^1.17.0-next.1"
     function-bind "^1.1.1"
 
-string.prototype.trim@^1.2.8:
-  version "1.2.8"
-  resolved "https://registry.yarnpkg.com/string.prototype.trim/-/string.prototype.trim-1.2.8.tgz#f9ac6f8af4bd55ddfa8895e6aea92a96395393bd"
-  integrity sha512-lfjY4HcixfQXOfaqCvcBuOIapyaroTXhbkfJN3gcB1OtyupngWK4sEET9Knd0cXd28kTUqu/kHoV4HKSJdnjiQ==
+string.prototype.trim@^1.2.9:
+  version "1.2.9"
+  resolved "https://registry.yarnpkg.com/string.prototype.trim/-/string.prototype.trim-1.2.9.tgz#b6fa326d72d2c78b6df02f7759c73f8f6274faa4"
+  integrity sha512-klHuCNxiMZ8MlsOihJhJEBJAiMVqU3Z2nEXWfWnIqjN0gEFS9J9+IxKozWWtQGcgoa1WUZzLjKPTr4ZHNFTFxw==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
+    call-bind "^1.0.7"
+    define-properties "^1.2.1"
+    es-abstract "^1.23.0"
+    es-object-atoms "^1.0.0"
 
 string.prototype.trimend@^1.0.1:
   version "1.0.1"
@@ -11073,14 +11175,14 @@ string.prototype.trimend@^1.0.1:
     define-properties "^1.1.3"
     es-abstract "^1.17.5"
 
-string.prototype.trimend@^1.0.7:
-  version "1.0.7"
-  resolved "https://registry.yarnpkg.com/string.prototype.trimend/-/string.prototype.trimend-1.0.7.tgz#1bb3afc5008661d73e2dc015cd4853732d6c471e"
-  integrity sha512-Ni79DqeB72ZFq1uH/L6zJ+DKZTkOtPIHovb3YZHQViE+HDouuU4mBrLOLDn5Dde3RF8qw5qVETEjhu9locMLvA==
+string.prototype.trimend@^1.0.8:
+  version "1.0.8"
+  resolved "https://registry.yarnpkg.com/string.prototype.trimend/-/string.prototype.trimend-1.0.8.tgz#3651b8513719e8a9f48de7f2f77640b26652b229"
+  integrity sha512-p73uL5VCHCO2BZZ6krwwQE3kCzM7NKmis8S//xEC6fQonchbum4eP6kR4DLEjQFO3Wnj3Fuo8NM0kOSjVdHjZQ==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
+    call-bind "^1.0.7"
+    define-properties "^1.2.1"
+    es-object-atoms "^1.0.0"
 
 string.prototype.trimstart@^1.0.1:
   version "1.0.1"
@@ -11090,14 +11192,14 @@ string.prototype.trimstart@^1.0.1:
     define-properties "^1.1.3"
     es-abstract "^1.17.5"
 
-string.prototype.trimstart@^1.0.7:
-  version "1.0.7"
-  resolved "https://registry.yarnpkg.com/string.prototype.trimstart/-/string.prototype.trimstart-1.0.7.tgz#d4cdb44b83a4737ffbac2d406e405d43d0184298"
-  integrity sha512-NGhtDFu3jCEm7B4Fy0DpLewdJQOZcQ0rGbwQ/+stjnrp2i+rlKeCvos9hOIeCmqwratM47OBxY7uFZzjxHXmrg==
+string.prototype.trimstart@^1.0.8:
+  version "1.0.8"
+  resolved "https://registry.yarnpkg.com/string.prototype.trimstart/-/string.prototype.trimstart-1.0.8.tgz#7ee834dda8c7c17eff3118472bb35bfedaa34dde"
+  integrity sha512-UXSH262CSZY1tfu3G3Secr6uGLCFVPMhIqHjlgCUtCCcgihYc/xKs9djMTMUOb2j1mVSeU8EU6NWc/iQKU6Gfg==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
+    call-bind "^1.0.7"
+    define-properties "^1.2.1"
+    es-object-atoms "^1.0.0"
 
 string_decoder@^1.1.1:
   version "1.3.0"
@@ -11158,7 +11260,7 @@ strip-bom@^2.0.0:
 strip-bom@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/strip-bom/-/strip-bom-3.0.0.tgz#2334c18e9c759f7bdd56fdef7e9ae3d588e68ed3"
-  integrity sha1-IzTBjpx1n3vdVv3vfprj1YjmjtM=
+  integrity sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==
 
 strip-bom@^4.0.0:
   version "4.0.0"
@@ -11237,20 +11339,13 @@ supports-color@^5.3.0:
   dependencies:
     has-flag "^3.0.0"
 
-supports-color@^7.0.0:
+supports-color@^7.0.0, supports-color@^7.1.0:
   version "7.2.0"
   resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-7.2.0.tgz#1b7dcdcb32b8138801b3e478ba6a51caa89648da"
   integrity sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==
   dependencies:
     has-flag "^4.0.0"
 
-supports-color@^7.1.0:
-  version "7.1.0"
-  resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-7.1.0.tgz#68e32591df73e25ad1c4b49108a2ec507962bfd1"
-  integrity sha512-oRSIpR8pxT1Wr2FquTNnGet79b3BWljqOuoW/h4oBhxJ/HUbX5nX6JSruTkvXDCFMwDPvsaTTbvMLKZWSy0R5g==
-  dependencies:
-    has-flag "^4.0.0"
-
 supports-color@^8.0.0:
   version "8.1.1"
   resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-8.1.1.tgz#cd6fc17e28500cff56c1b86c0a7fd4a54a73005c"
@@ -11510,15 +11605,15 @@ trim-off-newlines@^1.0.0:
   resolved "https://registry.yarnpkg.com/trim-off-newlines/-/trim-off-newlines-1.0.1.tgz#9f9ba9d9efa8764c387698bcbfeb2c848f11adb3"
   integrity sha1-n5up2e+odkw4dpi8v+sshI8RrbM=
 
-ts-api-utils@^1.0.1:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/ts-api-utils/-/ts-api-utils-1.0.3.tgz#f12c1c781d04427313dbac808f453f050e54a331"
-  integrity sha512-wNMeqtMz5NtwpT/UZGY5alT+VoKdSsOOP/kqHFcUW1P/VRhH2wJ48+DN2WwUliNbQ976ETwDL0Ifd2VVvgonvg==
+ts-api-utils@^1.3.0:
+  version "1.3.0"
+  resolved "https://registry.yarnpkg.com/ts-api-utils/-/ts-api-utils-1.3.0.tgz#4b490e27129f1e8e686b45cc4ab63714dc60eea1"
+  integrity sha512-UQMIo7pb8WRomKR1/+MFVLTroIvDVtMX3K6OUir8ynLyzB8Jeriont2bTAtmNPa1ekAgN7YPDyf6V+ygrdU+eQ==
 
-tsconfig-paths@^3.14.2:
-  version "3.14.2"
-  resolved "https://registry.yarnpkg.com/tsconfig-paths/-/tsconfig-paths-3.14.2.tgz#6e32f1f79412decd261f92d633a9dc1cfa99f088"
-  integrity sha512-o/9iXgCYc5L/JxCHPe3Hvh8Q/2xm5Z+p18PESBU6Ff33695QnCHBEjcytY2q19ua7Mbl/DavtBOLq+oG0RCL+g==
+tsconfig-paths@^3.15.0:
+  version "3.15.0"
+  resolved "https://registry.yarnpkg.com/tsconfig-paths/-/tsconfig-paths-3.15.0.tgz#5299ec605e55b1abb23ec939ef15edaf483070d4"
+  integrity sha512-2Ac2RgzDe/cn48GvOe3M+o82pEFewD3UPbyoUHHdKasHwJKjds4fLXWf/Ux5kATBKN20oaFGu+jbElp1pos0mg==
   dependencies:
     "@types/json5" "^0.0.29"
     json5 "^1.0.2"
@@ -11536,12 +11631,12 @@ tslib@^2.3.1:
   integrity sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q==
 
 tsx@^4.7.2:
-  version "4.7.2"
-  resolved "https://registry.yarnpkg.com/tsx/-/tsx-4.7.2.tgz#a108b1a6e16876cd4c9a4b4ba263f2a07f9cf562"
-  integrity sha512-BCNd4kz6fz12fyrgCTEdZHGJ9fWTGeUzXmQysh0RVocDY3h4frk05ZNCXSy4kIenF7y/QnrdiVpTsyNRn6vlAw==
+  version "4.17.0"
+  resolved "https://registry.yarnpkg.com/tsx/-/tsx-4.17.0.tgz#6ffd9851a0c7aa4ecacf4dc19f28d82112af25c5"
+  integrity sha512-eN4mnDA5UMKDt4YZixo9tBioibaMBpoxBkD+rIPAjVmYERSG0/dWEY1CEFuV89CgASlKL499q8AhmkMnnjtOJg==
   dependencies:
-    esbuild "~0.19.10"
-    get-tsconfig "^4.7.2"
+    esbuild "~0.23.0"
+    get-tsconfig "^4.7.5"
   optionalDependencies:
     fsevents "~2.3.3"
 
@@ -11623,44 +11718,49 @@ type-fest@^1.0.1, type-fest@^1.2.1, type-fest@^1.2.2:
   resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-1.4.0.tgz#e9fb813fe3bf1744ec359d55d1affefa76f14be1"
   integrity sha512-yGSza74xk0UG8k+pLh5oeoYirvIiWo5t0/o3zHHAO2tRDiZcxWP7fywNlXhqb6/r6sWvwi+RsyQMWhVLe4BVuA==
 
-typed-array-buffer@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/typed-array-buffer/-/typed-array-buffer-1.0.0.tgz#18de3e7ed7974b0a729d3feecb94338d1472cd60"
-  integrity sha512-Y8KTSIglk9OZEr8zywiIHG/kmQ7KWyjseXs1CbSo8vC42w7hg2HgYTxSWwP0+is7bWDc1H+Fo026CpHFwm8tkw==
+typed-array-buffer@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/typed-array-buffer/-/typed-array-buffer-1.0.2.tgz#1867c5d83b20fcb5ccf32649e5e2fc7424474ff3"
+  integrity sha512-gEymJYKZtKXzzBzM4jqa9w6Q1Jjm7x2d+sh19AdsD4wqnMPDYyvwpsIc2Q/835kHuo3BEQ7CjelGhfTsoBb2MQ==
   dependencies:
-    call-bind "^1.0.2"
-    get-intrinsic "^1.2.1"
-    is-typed-array "^1.1.10"
+    call-bind "^1.0.7"
+    es-errors "^1.3.0"
+    is-typed-array "^1.1.13"
 
-typed-array-byte-length@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/typed-array-byte-length/-/typed-array-byte-length-1.0.0.tgz#d787a24a995711611fb2b87a4052799517b230d0"
-  integrity sha512-Or/+kvLxNpeQ9DtSydonMxCx+9ZXOswtwJn17SNLvhptaXYDJvkFFP5zbfU/uLmvnBJlI4yrnXRxpdWH/M5tNA==
+typed-array-byte-length@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/typed-array-byte-length/-/typed-array-byte-length-1.0.1.tgz#d92972d3cff99a3fa2e765a28fcdc0f1d89dec67"
+  integrity sha512-3iMJ9q0ao7WE9tWcaYKIptkNBuOIcZCCT0d4MRvuuH88fEoEH62IuQe0OtraD3ebQEoTRk8XCBoknUNc1Y67pw==
   dependencies:
-    call-bind "^1.0.2"
+    call-bind "^1.0.7"
     for-each "^0.3.3"
-    has-proto "^1.0.1"
-    is-typed-array "^1.1.10"
+    gopd "^1.0.1"
+    has-proto "^1.0.3"
+    is-typed-array "^1.1.13"
 
-typed-array-byte-offset@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/typed-array-byte-offset/-/typed-array-byte-offset-1.0.0.tgz#cbbe89b51fdef9cd6aaf07ad4707340abbc4ea0b"
-  integrity sha512-RD97prjEt9EL8YgAgpOkf3O4IF9lhJFr9g0htQkm0rchFp/Vx7LW5Q8fSXXub7BXAODyUQohRMyOc3faCPd0hg==
+typed-array-byte-offset@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/typed-array-byte-offset/-/typed-array-byte-offset-1.0.2.tgz#f9ec1acb9259f395093e4567eb3c28a580d02063"
+  integrity sha512-Ous0vodHa56FviZucS2E63zkgtgrACj7omjwd/8lTEMEPFFyjfixMZ1ZXenpgCFBBt4EC1J2XsyVS2gkG0eTFA==
   dependencies:
-    available-typed-arrays "^1.0.5"
-    call-bind "^1.0.2"
+    available-typed-arrays "^1.0.7"
+    call-bind "^1.0.7"
     for-each "^0.3.3"
-    has-proto "^1.0.1"
-    is-typed-array "^1.1.10"
+    gopd "^1.0.1"
+    has-proto "^1.0.3"
+    is-typed-array "^1.1.13"
 
-typed-array-length@^1.0.4:
-  version "1.0.4"
-  resolved "https://registry.yarnpkg.com/typed-array-length/-/typed-array-length-1.0.4.tgz#89d83785e5c4098bec72e08b319651f0eac9c1bb"
-  integrity sha512-KjZypGq+I/H7HI5HlOoGHkWUUGq+Q0TPhQurLbyrVrvnKTBgzLhIJ7j6J/XTQOi0d1RjyZ0wdas8bKs2p0x3Ng==
+typed-array-length@^1.0.6:
+  version "1.0.6"
+  resolved "https://registry.yarnpkg.com/typed-array-length/-/typed-array-length-1.0.6.tgz#57155207c76e64a3457482dfdc1c9d1d3c4c73a3"
+  integrity sha512-/OxDN6OtAk5KBpGb28T+HZc2M+ADtvRxXrKKbUwtsLgdoxgX13hyy7ek6bFRl5+aBs2yZzB0c4CnQfAtVypW/g==
   dependencies:
-    call-bind "^1.0.2"
+    call-bind "^1.0.7"
     for-each "^0.3.3"
-    is-typed-array "^1.1.9"
+    gopd "^1.0.1"
+    has-proto "^1.0.3"
+    is-typed-array "^1.1.13"
+    possible-typed-array-names "^1.0.0"
 
 typedarray-to-buffer@^3.1.5:
   version "3.1.5"
@@ -11679,16 +11779,16 @@ typeforce@^1.18.0:
   resolved "https://registry.yarnpkg.com/typeforce/-/typeforce-1.18.0.tgz#d7416a2c5845e085034d70fcc5b6cc4a90edbfdc"
   integrity sha512-7uc1O8h1M1g0rArakJdf0uLRSSgFcYexrVoKo+bzJd32gd4gDy2L/Z+8/FjPnU9ydY3pEnVPtr9FyscYY60K1g==
 
-typescript@^4.1.5:
-  version "4.6.4"
-  resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.6.4.tgz#caa78bbc3a59e6a5c510d35703f6a09877ce45e9"
-  integrity sha512-9ia/jWHIEbo49HfjrLGfKbZSuWo9iTMwXO+Ca3pRsSpbsMbc7/IU8NKdCZVRRBafVPGnoJeFL76ZOAA84I9fEg==
-
 typescript@^4.9.5:
   version "4.9.5"
   resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.9.5.tgz#095979f9bcc0d09da324d58d03ce8f8374cbe65a"
   integrity sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==
 
+typescript@^5.5.4:
+  version "5.5.4"
+  resolved "https://registry.yarnpkg.com/typescript/-/typescript-5.5.4.tgz#d9852d6c82bad2d2eda4fd74a5762a8f5909e9ba"
+  integrity sha512-Mtq29sKDAEYP7aljRgtPOpTvOfbwRWlS6dPRzwjdE+C0R4brX/GUyhHSecbHMFLNBLcJIPt9nl9yG5TZ1weH+Q==
+
 uglify-js@^3.1.4:
   version "3.10.2"
   resolved "https://registry.yarnpkg.com/uglify-js/-/uglify-js-3.10.2.tgz#8cfa1209fd04199cc8a7f9930ddedb30b0f1912d"
@@ -11714,6 +11814,16 @@ unbox-primitive@^1.0.2:
     has-symbols "^1.0.3"
     which-boxed-primitive "^1.0.2"
 
+undici-types@~5.26.4:
+  version "5.26.5"
+  resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-5.26.5.tgz#bcd539893d00b56e964fd2657a4866b221a65617"
+  integrity sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==
+
+undici-types@~6.13.0:
+  version "6.13.0"
+  resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-6.13.0.tgz#e3e79220ab8c81ed1496b5812471afd7cf075ea5"
+  integrity sha512-xtFJHudx8S2DSoujjMd1WeWvn7KKWFRESZTMeL1RptAYERu29D6jphMjjY+vn96jvN3kVPDNxU/E13VTaXj6jg==
+
 union-value@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/union-value/-/union-value-1.0.1.tgz#0b6fe7b835aecda61c6ea4d4f02c14221e109847"
@@ -11794,9 +11904,9 @@ update-browserslist-db@^1.0.10:
     picocolors "^1.0.0"
 
 uri-js@^4.2.2:
-  version "4.2.2"
-  resolved "https://registry.yarnpkg.com/uri-js/-/uri-js-4.2.2.tgz#94c540e1ff772956e2299507c010aea6c8838eb0"
-  integrity sha512-KY9Frmirql91X2Qgjry0Wd4Y+YTdrdZheS8TFwvkbLWf/G5KNJDCh6pKL5OZctEW4+0Baa5idK2ZQuELRwPznQ==
+  version "4.4.1"
+  resolved "https://registry.yarnpkg.com/uri-js/-/uri-js-4.4.1.tgz#9b1a52595225859e55f669d928f88c6c57f2a77e"
+  integrity sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==
   dependencies:
     punycode "^2.1.0"
 
@@ -11981,16 +12091,16 @@ which-module@^2.0.0:
   resolved "https://registry.yarnpkg.com/which-module/-/which-module-2.0.0.tgz#d9ef07dce77b9902b8a3a8fa4b31c3e3f7e6e87a"
   integrity sha1-2e8H3Od7mQK4o6j6SzHD4/fm6Ho=
 
-which-typed-array@^1.1.11, which-typed-array@^1.1.13:
-  version "1.1.13"
-  resolved "https://registry.yarnpkg.com/which-typed-array/-/which-typed-array-1.1.13.tgz#870cd5be06ddb616f504e7b039c4c24898184d36"
-  integrity sha512-P5Nra0qjSncduVPEAr7xhoF5guty49ArDTwzJ/yNuPIbZppyRxFQsRCWrocxIY+CnMVG+qfbU2FmDKyvSGClow==
+which-typed-array@^1.1.14, which-typed-array@^1.1.15:
+  version "1.1.15"
+  resolved "https://registry.yarnpkg.com/which-typed-array/-/which-typed-array-1.1.15.tgz#264859e9b11a649b388bfaaf4f767df1f779b38d"
+  integrity sha512-oV0jmFtUky6CXfkqehVvBP/LSWJ2sy4vWMioiENyJLePrBO/yKyV9OyJySfAKosh+RYkIl5zJCNZ8/4JncrpdA==
   dependencies:
-    available-typed-arrays "^1.0.5"
-    call-bind "^1.0.4"
+    available-typed-arrays "^1.0.7"
+    call-bind "^1.0.7"
     for-each "^0.3.3"
     gopd "^1.0.1"
-    has-tostringtag "^1.0.0"
+    has-tostringtag "^1.0.2"
 
 which-typed-array@^1.1.2:
   version "1.1.2"
@@ -12044,6 +12154,11 @@ windows-release@^3.1.0:
   dependencies:
     execa "^1.0.0"
 
+word-wrap@^1.2.5:
+  version "1.2.5"
+  resolved "https://registry.yarnpkg.com/word-wrap/-/word-wrap-1.2.5.tgz#d2c45c6dd4fbce621a66f136cbe328afd0410b34"
+  integrity sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==
+
 word-wrap@~1.2.3:
   version "1.2.3"
   resolved "https://registry.yarnpkg.com/word-wrap/-/word-wrap-1.2.3.tgz#610636f6b1f703891bd34771ccb17fb93b47079c"
@@ -12084,7 +12199,7 @@ wrap-ansi@^7.0.0:
 wrappy@1:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/wrappy/-/wrappy-1.0.2.tgz#b5243d8f3ec1aa35f1364605bc0d1036e30ab69f"
-  integrity sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=
+  integrity sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==
 
 write-file-atomic@^2.0.0, write-file-atomic@^2.3.0, write-file-atomic@^2.4.2:
   version "2.4.3"

From f9b108c1e314f693cf77ce362c0afa0ec9c64b85 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 13 Aug 2024 10:55:37 +0200
Subject: [PATCH 090/267] Fix several failing tests

---
 packages/cashscript/test/debugging.test.ts        | 15 +++++++--------
 packages/cashscript/test/e2e/misc.test.ts         |  2 +-
 .../test/fixture/libauth-template/fixtures.ts     | 10 +++++-----
 3 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 5384fc8c..9f31bed7 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -508,7 +508,6 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.test_zero_handling(0n).to(contract.address, 1000n);
-      console.log(await transaction.bitauthUri());
       await expect(transaction).not.toFailRequireWith(/.*/);
     });
   });
@@ -528,7 +527,7 @@ describe('Debugging tests', () => {
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
         expect(transaction).toLog('^This is definitely not the log$'),
-      ).rejects.toThrow(/Expected: .*This is definitely not the log.*\nReceived: .*Test.cash:4 Hello World/);
+      ).rejects.toThrow(/Expected: .*This is definitely not the log.*\nReceived: (.|\n)*?Test.cash:4 Hello World/);
     });
 
     it('should fail the JestExtensions test if a log is logged that is NOT expected', async () => {
@@ -540,11 +539,11 @@ describe('Debugging tests', () => {
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
         expect(transaction).not.toLog('^Test.cash:4 Hello World$'),
-      ).rejects.toThrow(/Expected: not .*Test.cash:4 Hello World.*\nReceived: .*Test.cash:4 Hello World/);
+      ).rejects.toThrow(/Expected: not .*Test.cash:4 Hello World.*\nReceived: (.|\n)*?Test.cash:4 Hello World/);
 
       await expect(
         expect(transaction).not.toLog(),
-      ).rejects.toThrow(/Expected: not .*undefined.*\nReceived: .*Test.cash:4 Hello World/);
+      ).rejects.toThrow(/Expected: not .*undefined.*\nReceived: (.|\n)*?Test.cash:4 Hello World/);
     });
 
     it('should fail the JestExtensions test if a log is expected where no log is logged', async () => {
@@ -556,7 +555,7 @@ describe('Debugging tests', () => {
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
         expect(transaction).toLog('Hello World'),
-      ).rejects.toThrow(/Expected: .*Hello World.*\nReceived: .*undefined/);
+      ).rejects.toThrow(/Expected: .*Hello World.*\nReceived: (.|\n)*?undefined/);
     });
 
     it('should fail the JestExtensions test if an incorrect require error message is expected', async () => {
@@ -568,7 +567,7 @@ describe('Debugging tests', () => {
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
         expect(transaction).toFailRequireWith('1 should equal 3'),
-      ).rejects.toThrow(/Expected pattern: .*1 should equal 3.*\nReceived string: .*1 should equal 2.*/);
+      ).rejects.toThrow(/Expected pattern: .*1 should equal 3.*\nReceived string: (.|\n)*?1 should equal 2/);
     });
 
     // TODO: Fix this
@@ -593,11 +592,11 @@ describe('Debugging tests', () => {
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
         expect(transaction).not.toFailRequireWith('1 should equal 2'),
-      ).rejects.toThrow(/Expected pattern: not .*1 should equal 2.*\nReceived string: .*1 should equal 2.*/);
+      ).rejects.toThrow(/Expected pattern: not .*1 should equal 2.*\nReceived string: (.|\n)*?1 should equal 2/);
 
       await expect(
         expect(transaction).not.toFailRequireWith(/.*/),
-      ).rejects.toThrow(/Expected pattern: not .*\nReceived string: .*1 should equal 2.*/);
+      ).rejects.toThrow(/Expected pattern: not .*\nReceived string: (.|\n)*?1 should equal 2/);
     });
   });
 });
diff --git a/packages/cashscript/test/e2e/misc.test.ts b/packages/cashscript/test/e2e/misc.test.ts
index b976e3ed..97b4c115 100644
--- a/packages/cashscript/test/e2e/misc.test.ts
+++ b/packages/cashscript/test/e2e/misc.test.ts
@@ -47,7 +47,7 @@ describe('Simple Covenant', () => {
       const utxo1Info: any = await provider.performRequest('blockchain.utxo.get_info', utxos[1].txid, utxos[1].vout);
       const currentBlockHeight = await provider.getBlockHeight();
 
-      const age = Math.max(utxo0Info.confirmed_height, utxo1Info.confirmed_height) - currentBlockHeight;
+      const age = (Math.max(utxo0Info.confirmed_height, utxo1Info.confirmed_height) - currentBlockHeight) || 0;
 
       // when
       const tx = await covenant.functions.spend()
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 40710515..8204dd52 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -128,7 +128,7 @@ export const fixtures: Fixture[] = [
             'evaluate_function',
           ],
           'name': 'unlock',
-          'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
           'unlocks': 'lock',
         },
         'lock': {
@@ -252,7 +252,7 @@ export const fixtures: Fixture[] = [
             'evaluate_function',
           ],
           'name': 'unlock',
-          'script': '// "timeout\" function parameters\n<sender_sig.schnorr_signature.all_outputs> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'script': '// "timeout\" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
           'unlocks': 'lock',
         },
         'lock': {
@@ -515,7 +515,7 @@ export const fixtures: Fixture[] = [
             'evaluate_function',
           ],
           'name': 'unlock',
-          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
           'unlocks': 'lock',
         },
         'lock': {
@@ -786,7 +786,7 @@ export const fixtures: Fixture[] = [
             'evaluate_function',
           ],
           'name': 'unlock',
-          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
           'unlocks': 'lock',
         },
         'lock': {
@@ -932,7 +932,7 @@ export const fixtures: Fixture[] = [
             'evaluate_function',
           ],
           'name': 'unlock',
-          'script': '// "spend" function parameters\n<oracle_message> // bytes8 = <0xa086010030750000>\n<oracle_sig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<owner_sig.schnorr_signature.all_outputs> // sig\n',
+          'script': '// "spend" function parameters\n<oracle_message> // bytes8 = <0xa086010030750000>\n<oracle_sig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<owner_sig.schnorr_signature.all_outputs_all_utxos> // sig\n',
           'unlocks': 'lock',
         },
         'lock': {

From 95ebd52aafdab181cfec65a98e550450e552bd17 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 13 Aug 2024 10:59:13 +0200
Subject: [PATCH 091/267] Add eslint rule for throwing Error objects and fix
 two incorrect cases

---
 .eslintrc.cjs                          | 1 +
 packages/cashscript/src/Transaction.ts | 2 +-
 packages/cashscript/src/utils.ts       | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/.eslintrc.cjs b/.eslintrc.cjs
index d05a80a6..9e77dd1f 100644
--- a/.eslintrc.cjs
+++ b/.eslintrc.cjs
@@ -47,5 +47,6 @@ module.exports = {
     '@typescript-eslint/no-redeclare': 0, // I sometimes name variables an types the same
     'linebreak-style': 0, // Ignore linebreak lints https://stackoverflow.com/a/43008668/1129108
     'import/extensions': ['error', 'ignorePackages'], // ESM requires file extensions
+    '@typescript-eslint/only-throw-error': 'error', // We should only throw Error objects
   },
 }
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 2573e0cd..82324ad0 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -246,7 +246,7 @@ export class Transaction {
 
   private async setInputsAndOutputs(): Promise<void> {
     if (this.outputs.length === 0) {
-      throw Error('Attempted to build a transaction without outputs');
+      throw new Error('Attempted to build a transaction without outputs');
     }
 
     // Fetched utxos are only used when no inputs are available, so only fetch in that case.
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index fe037033..acc36cea 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -297,7 +297,7 @@ function getPushDataOpcode(data: Uint8Array): Uint8Array {
   if (byteLength === 0) return Uint8Array.from([0x4c, 0x00]);
   if (byteLength < 76) return Uint8Array.from([byteLength]);
   if (byteLength < 256) return Uint8Array.from([0x4c, byteLength]);
-  throw Error('Pushdata too large');
+  throw new Error('Pushdata too large');
 }
 
 const randomInt = (): bigint => BigInt(Math.floor(Math.random() * 10000));

From a57af592194fba88125b2a4307248a6fb81ee140 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 13 Aug 2024 11:24:06 +0200
Subject: [PATCH 092/267] Simplify some failed transaction error handling

---
 packages/cashscript/src/Errors.ts      | 12 +++++++++---
 packages/cashscript/src/Transaction.ts | 18 +++++-------------
 packages/cashscript/src/debugging.ts   | 15 ++++++++-------
 3 files changed, 22 insertions(+), 23 deletions(-)

diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index d7034768..38103e84 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -18,21 +18,27 @@ export class TokensToNonTokenAddressError extends Error {
   }
 }
 
+export class NoDebugInformationInArtifactError extends Error {
+  constructor() {
+    super('No debug information found in artifact, please recompile with cashc version 0.10.0 or newer.');
+  }
+}
+
 export class FailedTransactionError extends Error {
+  // TODO: Make bitauthUri required once the advanced transaction builder supports debugging
   constructor(public reason: string, public bitauthUri?: string) {
-    super(`${reason}\n\nBitauth URI: ${bitauthUri}`);
+    super(`${reason}${bitauthUri ? `\n\nBitauth URI: ${bitauthUri}` : ''}`);
   }
 }
 
 // TODO: Add tests for some non-require evaluation errors (e.g. invalid op_split range)
 
 export class FailedRequireError extends Error {
-  public bitauthUri?: string;
-
   constructor(
     public contractName: string,
     public requireStatement: RequireStatement,
     public inputIndex: number,
+    public bitauthUri: string,
     public libauthErrorMessage?: string,
   ) {
     const baseMessage = `${contractName}.cash:${requireStatement.line} Require statement failed at line ${requireStatement.line}`;
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 82324ad0..dbaa8a99 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -42,7 +42,7 @@ import MockNetworkProvider from './network/MockNetworkProvider.js';
 import { buildTemplate, getBitauthUri } from './LibauthTemplate.js';
 import { debugTemplate, evaluateTemplate, DebugResult } from './debugging.js';
 import { EncodedArgument } from './Argument.js';
-import { FailedRequireError, FailedTransactionError } from './Errors.js';
+import { FailedTransactionError } from './Errors.js';
 
 export class Transaction {
   public inputs: Utxo[] = [];
@@ -176,17 +176,9 @@ export class Transaction {
     let template: WalletTemplate | undefined;
 
     // Debug the transaction locally before sending so any errors are caught early
-    try {
-      // Libauth debugging does not work with old-style covenents (or outdated artifacts)
-      if (!this.abiFunction.covenant && this.contract.artifact.debug) {
-        await this.debug();
-      }
-    } catch (error) {
-      if (error instanceof FailedRequireError) {
-        error.bitauthUri = await this.bitauthUri();
-        error.message += `\n\nBitauth URI: ${error.bitauthUri}`;
-      }
-      throw error;
+    // Libauth debugging does not work with outdated artifacts)
+    if (this.contract.artifact.debug) {
+      await this.debug();
     }
 
     try {
@@ -203,7 +195,7 @@ export class Transaction {
       return raw ? await this.getTxDetails(txid, raw) : await this.getTxDetails(txid);
     } catch (error: any) {
       const reason = error.error ?? error.message ?? error;
-      throw new FailedTransactionError(reason, await this.bitauthUri());
+      throw new FailedTransactionError(reason, await this.bitauthUri()); // TODO
     }
   }
 
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 60b46958..d6f5ad41 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -2,6 +2,7 @@ import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationPro
 import { Artifact, LogEntry, Op, PrimitiveType, StackItem, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
 import { findLastIndex, toRegExp } from './utils.js';
 import { FailedRequireError, FailedTransactionError } from './Errors.js';
+import { getBitauthUri } from './LibauthTemplate.js';
 
 // evaluates the fully defined template, throws upon error
 export const evaluateTemplate = (template: WalletTemplate): boolean => {
@@ -9,7 +10,7 @@ export const evaluateTemplate = (template: WalletTemplate): boolean => {
 
   const verifyResult = vm.verify(program);
   if (typeof verifyResult === 'string') {
-    throw new FailedTransactionError(verifyResult);
+    throw new FailedTransactionError(verifyResult, getBitauthUri(template));
   }
 
   return verifyResult;
@@ -60,10 +61,10 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
     // TODO: Also log the require statement that failed (e.g. "require(1 == 2, '1 is not equal to 2')")
     if (requireStatement) {
       const { program: { inputIndex }, error } = lastExecutedDebugStep;
-      throw new FailedRequireError(artifact.contractName, requireStatement, inputIndex, error);
+      throw new FailedRequireError(artifact.contractName, requireStatement, inputIndex, error, getBitauthUri(template));
     }
 
-    throw new FailedTransactionError(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${lastExecutedDebugStep.error}`);
+    throw new FailedTransactionError(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${lastExecutedDebugStep.error}`, getBitauthUri(template));
   }
 
   const evaluationResult = vm.verify(program);
@@ -80,10 +81,10 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
 
     if (requireStatement) {
       const { program: { inputIndex }, error } = lastExecutedDebugStep;
-      throw new FailedRequireError(artifact.contractName, requireStatement, inputIndex, error);
+      throw new FailedRequireError(artifact.contractName, requireStatement, inputIndex, getBitauthUri(template), error);
     }
 
-    throw new FailedTransactionError(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${evaluationResult}`);
+    throw new FailedTransactionError(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${evaluationResult}`, getBitauthUri(template));
   }
 
   return fullDebugSteps;
@@ -111,11 +112,11 @@ const createProgram = (template: WalletTemplate): CreateProgramResult => {
   });
 
   if (typeof scenarioGeneration === 'string') {
-    throw new FailedTransactionError(scenarioGeneration);
+    throw new FailedTransactionError(scenarioGeneration, getBitauthUri(template));
   }
 
   if (typeof scenarioGeneration.scenario === 'string') {
-    throw new FailedTransactionError(scenarioGeneration.scenario);
+    throw new FailedTransactionError(scenarioGeneration.scenario, getBitauthUri(template));
   }
 
   return { vm, program: scenarioGeneration.scenario.program };

From 3c3045a0d306cdfa2c0c01bfe2bdd8563753a431 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 13 Aug 2024 11:46:07 +0200
Subject: [PATCH 093/267] Add warning when debugging without proper debug
 information & remove MockNetworkProvider evaluation step (already covered in
 debug step)

---
 packages/cashscript/src/Transaction.ts | 23 ++++++++---------------
 1 file changed, 8 insertions(+), 15 deletions(-)

diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index dbaa8a99..9df57c86 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -38,9 +38,8 @@ import SignatureTemplate from './SignatureTemplate.js';
 import { P2PKH_INPUT_SIZE } from './constants.js';
 import { TransactionBuilder } from './TransactionBuilder.js';
 import { Contract } from './Contract.js';
-import MockNetworkProvider from './network/MockNetworkProvider.js';
 import { buildTemplate, getBitauthUri } from './LibauthTemplate.js';
-import { debugTemplate, evaluateTemplate, DebugResult } from './debugging.js';
+import { debugTemplate, DebugResult } from './debugging.js';
 import { EncodedArgument } from './Argument.js';
 import { FailedTransactionError } from './Errors.js';
 
@@ -173,34 +172,28 @@ export class Transaction {
 
   async send(raw?: true): Promise<TransactionDetails | string> {
     const tx = await this.build();
-    let template: WalletTemplate | undefined;
 
     // Debug the transaction locally before sending so any errors are caught early
-    // Libauth debugging does not work with outdated artifacts)
-    if (this.contract.artifact.debug) {
+    // Libauth debugging does not work with old-style covenants
+    if (!this.abiFunction.covenant) {
       await this.debug();
     }
 
     try {
-      // TODO: Can we move this to MockNetworkProvider?
-      if (this.contract.provider instanceof MockNetworkProvider) {
-        template = await buildTemplate({
-          transaction: this,
-          transactionHex: tx,
-        });
-        evaluateTemplate(template);
-      }
-
       const txid = await this.contract.provider.sendRawTransaction(tx);
       return raw ? await this.getTxDetails(txid, raw) : await this.getTxDetails(txid);
     } catch (error: any) {
       const reason = error.error ?? error.message ?? error;
-      throw new FailedTransactionError(reason, await this.bitauthUri()); // TODO
+      throw new FailedTransactionError(reason, await this.bitauthUri());
     }
   }
 
   // method to debug the transaction with libauth VM, throws upon evaluation error
   async debug(): Promise<DebugResult> {
+    if (!this.contract.artifact.debug) {
+      console.warn('No debug information found in artifact. Recompile with cashc version 0.10.0 or newer to get better debugging information.');
+    }
+
     const template = await this.getLibauthTemplate();
     return debugTemplate(template, this.contract.artifact);
   }

From 250e329e25e4b6ab8f68bf098c14dda3625c5518 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 13 Aug 2024 12:03:25 +0200
Subject: [PATCH 094/267] Move and resolve some outstanding TODOs

---
 packages/cashscript/src/Argument.ts        | 10 ----------
 packages/cashscript/src/Errors.ts          |  2 --
 packages/cashscript/src/LibauthTemplate.ts | 14 ++++----------
 packages/cashscript/src/debugging.ts       |  1 -
 4 files changed, 4 insertions(+), 23 deletions(-)

diff --git a/packages/cashscript/src/Argument.ts b/packages/cashscript/src/Argument.ts
index 43bb57d2..7a772dd1 100644
--- a/packages/cashscript/src/Argument.ts
+++ b/packages/cashscript/src/Argument.ts
@@ -102,13 +102,3 @@ export const encodeFunctionArguments = (
 
   return encodedArgs;
 };
-
-// Note: BitAuth IDE requires 0 to be encoded as a single byte (rather than the default empty byte array)
-// TODO: Double check this with Pat
-export function encodeArgumentForLibauthTemplate(
-  argument: Argument,
-  typeStr: string,
-): Uint8Array | SignatureTemplate {
-  if (typeStr === PrimitiveType.INT && argument === 0n) return Uint8Array.from([0]);
-  return encodeArgument(argument, typeStr);
-}
diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index 38103e84..45fa93b1 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -31,8 +31,6 @@ export class FailedTransactionError extends Error {
   }
 }
 
-// TODO: Add tests for some non-require evaluation errors (e.g. invalid op_split range)
-
 export class FailedRequireError extends Error {
   constructor(
     public contractName: string,
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index f74289e8..1b90d4f7 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -46,7 +46,6 @@ interface BuildTemplateOptions {
   transactionHex?: string;
 }
 
-// TODO: Can we change this so we don't need to pass in both the transaction and the transactionHex?
 export const buildTemplate = async ({
   transaction,
   transactionHex = undefined, // set this argument to prevent unnecessary call `transaction.build()`
@@ -277,15 +276,11 @@ const generateTemplateScenarioTransaction = (
   const slotIndex = csTransaction.inputs.findIndex((input) => !isUtxoP2PKH(input));
 
   const inputs = libauthTransaction.inputs.map((input, index) => {
-    const csInput = csTransaction.inputs[index] as Utxo; // TODO: Change
+    const csInput = csTransaction.inputs[index] as Utxo; // TODO: Improve code quality here (see zip in other places)
 
     return {
       outpointIndex: input.outpointIndex,
-      outpointTransactionHash:
-      // TODO: This should always be Uint8Array according to the libauth transaction types
-        input.outpointTransactionHash instanceof Uint8Array
-          ? binToHex(input.outpointTransactionHash)
-          : input.outpointTransactionHash,
+      outpointTransactionHash: binToHex(input.outpointTransactionHash),
       sequenceNumber: input.sequenceNumber,
       unlockingBytecode: generateTemplateScenarioBytecode(csInput, 'p2pkh_placeholder_unlock', index === slotIndex),
     } as WalletTemplateScenarioInput;
@@ -294,7 +289,7 @@ const generateTemplateScenarioTransaction = (
   const locktime = libauthTransaction.locktime;
 
   const outputs = libauthTransaction.outputs.map((output, index) => {
-    const csOutput = csTransaction.outputs[index]; // TODO: Change
+    const csOutput = csTransaction.outputs[index]; // TODO: Improve code quality here (see zip in other places)
 
     return {
       lockingBytecode: generateTemplateScenarioTransactionOutputLockingBytecode(csOutput, contract),
@@ -362,8 +357,7 @@ const generateTemplateScenarioParametersValues = (
     .filter(([, arg]) => !(arg instanceof SignatureTemplate))
     .map(([input, arg]) => {
       const encodedArgumentHex = binToHex(arg as Uint8Array);
-      // TODO: Is this really necessary?
-      const prefixedEncodedArgument = encodedArgumentHex.length ? `0x${encodedArgumentHex}` : encodedArgumentHex;
+      const prefixedEncodedArgument = encodedArgumentHex.length > 0 ? `0x${encodedArgumentHex}` : '';
       return [snakeCase(input.name), prefixedEncodedArgument] as const;
     });
 
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index d6f5ad41..0b097065 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -58,7 +58,6 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
     const requireStatement = (artifact.debug?.requires ?? [])
       .find((statement) => statement.ip === requireStatementIp);
 
-    // TODO: Also log the require statement that failed (e.g. "require(1 == 2, '1 is not equal to 2')")
     if (requireStatement) {
       const { program: { inputIndex }, error } = lastExecutedDebugStep;
       throw new FailedRequireError(artifact.contractName, requireStatement, inputIndex, error, getBitauthUri(template));

From 0791f7069b94f04c90c6dce6b3e0ebb860d6e72c Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 20 Aug 2024 10:43:01 +0200
Subject: [PATCH 095/267] Make templates support multiple P2PKH inputs with
 custom signing parameters

---
 packages/cashscript/src/LibauthTemplate.ts    | 68 +++++++++-------
 .../test/fixture/libauth-template/fixtures.ts | 77 +++++++++++++++----
 2 files changed, 99 insertions(+), 46 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 1b90d4f7..c535a894 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -78,34 +78,44 @@ export const buildTemplate = async ({
     ),
   } as WalletTemplate;
 
-  // add extra variables for the p2pkh utxos spent together with our contract
-  const hasSignatureTemplates = transaction.inputs.filter((input) => isUtxoP2PKH(input)).length > 0;
-  if (hasSignatureTemplates) {
-    template.entities.parameters.scripts!.push('p2pkh_placeholder_lock', 'p2pkh_placeholder_unlock');
-    template.entities.parameters.variables = {
-      ...template.entities.parameters.variables,
-      placeholder_key: {
-        description: 'placeholder_key',
-        name: 'placeholder_key',
-        type: 'Key',
-      },
-    };
 
-    // add extra unlocking and locking script for P2PKH inputs spent alongside our contract
-    // this is needed for correct cross-referrences in the template
-    template.scripts.p2pkh_placeholder_unlock = {
-      name: 'p2pkh_placeholder_unlock',
-      script:
-          '<placeholder_key.schnorr_signature.all_outputs>\n<placeholder_key.public_key>',
-      unlocks: 'p2pkh_placeholder_lock',
-    };
-    template.scripts.p2pkh_placeholder_lock = {
-      lockingType: 'standard',
-      name: 'p2pkh_placeholder_lock',
-      script:
-          'OP_DUP\nOP_HASH160 <$(<placeholder_key.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
-    };
-  }
+  transaction.inputs
+    .forEach((input, index) => {
+      if (!isUtxoP2PKH(input)) return;
+
+      const lockScriptName = `p2pkh_placeholder_lock_${index}`;
+      const unlockScriptName = `p2pkh_placeholder_unlock_${index}`;
+      const placeholderKeyName = `placeholder_key_${index}`;
+
+      const signatureAlgorithmName = getSignatureAlgorithmName(input.template.getSignatureAlgorithm());
+      const hashtypeName = getHashTypeName(input.template.getHashType(false));
+      const signatureString = `${placeholderKeyName}.${signatureAlgorithmName}.${hashtypeName}`;
+
+      template.entities.parameters.scripts!.push(lockScriptName, unlockScriptName);
+      template.entities.parameters.variables = {
+        ...template.entities.parameters.variables,
+        [placeholderKeyName]: {
+          description: placeholderKeyName,
+          name: placeholderKeyName,
+          type: 'Key',
+        },
+      };
+
+      // add extra unlocking and locking script for P2PKH inputs spent alongside our contract
+      // this is needed for correct cross-referrences in the template
+      template.scripts[unlockScriptName] = {
+        name: unlockScriptName,
+        script:
+            `<${signatureString}>\n<${placeholderKeyName}.public_key>`,
+        unlocks: lockScriptName,
+      };
+      template.scripts[lockScriptName] = {
+        lockingType: 'standard',
+        name: lockScriptName,
+        script:
+            `OP_DUP\nOP_HASH160 <$(<${placeholderKeyName}.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG`,
+      };
+    });
 
   return template;
 };
@@ -282,7 +292,7 @@ const generateTemplateScenarioTransaction = (
       outpointIndex: input.outpointIndex,
       outpointTransactionHash: binToHex(input.outpointTransactionHash),
       sequenceNumber: input.sequenceNumber,
-      unlockingBytecode: generateTemplateScenarioBytecode(csInput, 'p2pkh_placeholder_unlock', index === slotIndex),
+      unlockingBytecode: generateTemplateScenarioBytecode(csInput, `p2pkh_placeholder_unlock_${index}`, index === slotIndex),
     } as WalletTemplateScenarioInput;
   });
 
@@ -319,7 +329,7 @@ const generateTemplateScenarioSourceOutputs = (
 
   return csTransaction.inputs.map((input, index) => {
     return {
-      lockingBytecode: generateTemplateScenarioBytecode(input, 'p2pkh_placeholder_lock', index === slotIndex),
+      lockingBytecode: generateTemplateScenarioBytecode(input, `p2pkh_placeholder_lock_${index}`, index === slotIndex),
       valueSatoshis: Number(input.satoshis),
       token: serialiseTokenDetails(input.token),
     };
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 8204dd52..34ae49de 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -981,10 +981,8 @@ export const fixtures: Fixture[] = [
       const tx = contract.functions
         .spend(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_NONE, SignatureAlgorithm.ECDSA))
         .fromP2PKH(p2pkhUtxo, new SignatureTemplate(alicePriv))
-        // TODO: Also allow fromP2PKH with different signing algorithms / hashtypes
-        // + support multiple fromP2PKH inputs with different keys
-        // .fromP2PKH(p2pkhUtxo, new SignatureTemplate(bobPriv, HashType.SIGHASH_ALL, SignatureAlgorithm.ECDSA))
         .from(regularUtxo)
+        .fromP2PKH(p2pkhUtxo, new SignatureTemplate(bobPriv, HashType.SIGHASH_ALL, SignatureAlgorithm.ECDSA))
         .to(to, amount);
 
       return tx;
@@ -1004,8 +1002,10 @@ export const fixtures: Fixture[] = [
           'scripts': [
             'lock',
             'unlock_lock',
-            'p2pkh_placeholder_lock',
-            'p2pkh_placeholder_unlock',
+            'p2pkh_placeholder_lock_0',
+            'p2pkh_placeholder_unlock_0',
+            'p2pkh_placeholder_lock_2',
+            'p2pkh_placeholder_unlock_2',
           ],
           'variables': {
             's': {
@@ -1023,9 +1023,14 @@ export const fixtures: Fixture[] = [
               'name': 'pkh',
               'type': 'WalletData',
             },
-            'placeholder_key': {
-              'description': 'placeholder_key',
-              'name': 'placeholder_key',
+            'placeholder_key_0': {
+              'description': 'placeholder_key_0',
+              'name': 'placeholder_key_0',
+              'type': 'Key',
+            },
+            'placeholder_key_2': {
+              'description': 'placeholder_key_2',
+              'name': 'placeholder_key_2',
               'type': 'Key',
             },
           },
@@ -1055,7 +1060,7 @@ export const fixtures: Fixture[] = [
                 'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
                 'sequenceNumber': 4294967294,
                 'unlockingBytecode': {
-                  'script': 'p2pkh_placeholder_unlock',
+                  'script': 'p2pkh_placeholder_unlock_0',
                   'overrides': {
                     'keys': {
                       'privateKeys': {
@@ -1073,6 +1078,21 @@ export const fixtures: Fixture[] = [
                   'slot',
                 ],
               },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_2',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                },
+              },
             ],
             'locktime': 133700,
             'outputs': [
@@ -1090,7 +1110,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'p2pkh_placeholder_lock',
+                'script': 'p2pkh_placeholder_lock_0',
                 'overrides': {
                   'keys': {
                     'privateKeys': {
@@ -1107,6 +1127,19 @@ export const fixtures: Fixture[] = [
               ],
               'valueSatoshis': expect.any(Number),
             },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_2',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
           ],
         },
       },
@@ -1124,15 +1157,25 @@ export const fixtures: Fixture[] = [
           'name': 'lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
-        'p2pkh_placeholder_unlock': {
-          'name': 'p2pkh_placeholder_unlock',
-          'script': '<placeholder_key.schnorr_signature.all_outputs>\n<placeholder_key.public_key>',
-          'unlocks': 'p2pkh_placeholder_lock',
+        'p2pkh_placeholder_unlock_0': {
+          'name': 'p2pkh_placeholder_unlock_0',
+          'script': '<placeholder_key_0.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_0.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock_0',
+        },
+        'p2pkh_placeholder_lock_0': {
+          'lockingType': 'standard',
+          'name': 'p2pkh_placeholder_lock_0',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_0.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+        },
+        'p2pkh_placeholder_unlock_2': {
+          'name': 'p2pkh_placeholder_unlock_2',
+          'script': '<placeholder_key_2.ecdsa_signature.all_outputs>\n<placeholder_key_2.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock_2',
         },
-        'p2pkh_placeholder_lock': {
+        'p2pkh_placeholder_lock_2': {
           'lockingType': 'standard',
-          'name': 'p2pkh_placeholder_lock',
-          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+          'name': 'p2pkh_placeholder_lock_2',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_2.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
         },
       },
     },

From ae3845256370df5ec4004e566c9285ec6607b0c7 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 20 Aug 2024 12:31:12 +0200
Subject: [PATCH 096/267] Improve error messages

- Add test cases for non-require transaction evaluation failures
- Create TransactionEvaluationFailedError for these kinds of failures
- Extract failing statement from source code
- Update some debugging tests
- Still some TODOs / bugs left
---
 packages/cashscript/src/Errors.ts          | 64 ++++++++++++++++++++--
 packages/cashscript/src/debugging.ts       | 29 +++++++---
 packages/cashscript/test/debugging.test.ts | 43 ++++++++++++++-
 3 files changed, 121 insertions(+), 15 deletions(-)

diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index 45fa93b1..3895a9a9 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -1,4 +1,4 @@
-import { RequireStatement, Type } from '@cashscript/utils';
+import { Artifact, RequireStatement, sourceMapToLocationData, Type } from '@cashscript/utils';
 
 export class TypeError extends Error {
   constructor(actual: string, expected: Type) {
@@ -31,17 +31,69 @@ export class FailedTransactionError extends Error {
   }
 }
 
-export class FailedRequireError extends Error {
+// TODO: Merge the location stuff with FailedRequireError
+// TODO: Add tests and make sure it works for multiline statements
+// TODO: Fix that failing statement is incorrect when using multi-function contracts
+export class FailedTransactionEvaluationError extends FailedTransactionError {
   constructor(
-    public contractName: string,
+    public artifact: Artifact,
+    public failingInstructionPointer: number,
+    public inputIndex: number,
+    public bitauthUri: string,
+    public libauthErrorMessage: string,
+  ) {
+    let baseMessage = `${artifact.contractName}.cash Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash.`;
+
+    if (artifact.debug) {
+      const locationData = sourceMapToLocationData(artifact.debug.sourceMap);
+      const failingLocation = locationData[failingInstructionPointer];
+
+      const failingStatementLineString = artifact.source.split('\n')[failingLocation.location.start.line - 1];
+      const failingStatementString = failingStatementLineString.slice(
+        failingLocation.location.start.column,
+        failingLocation.location.end.column,
+      );
+
+      const failingLine = failingLocation.location.start.line;
+
+      baseMessage = `${artifact.contractName}.cash:${failingLine} Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${failingLine}.\nFailing statement: ${failingStatementString}`;
+    }
+
+    super(`${baseMessage}\nReason: ${libauthErrorMessage}`, bitauthUri);
+  }
+}
+
+export class FailedRequireError extends FailedTransactionError {
+  constructor(
+    public artifact: Artifact,
+    public failingInstructionPointer: number,
     public requireStatement: RequireStatement,
     public inputIndex: number,
     public bitauthUri: string,
     public libauthErrorMessage?: string,
   ) {
-    const baseMessage = `${contractName}.cash:${requireStatement.line} Require statement failed at line ${requireStatement.line}`;
-    const fullMessage = `${baseMessage} with the following message: ${requireStatement.message}`;
-    super(requireStatement.message ? fullMessage : baseMessage);
+    const locationData = sourceMapToLocationData(artifact.debug!.sourceMap);
+    const failingLocation = locationData[failingInstructionPointer];
+
+    const failingStatementLineString = artifact.source.split('\n')[failingLocation.location.start.line - 1];
+    let failingStatementString = failingStatementLineString.slice(
+      failingLocation.location.start.column,
+      failingLocation.location.end.column,
+    );
+
+    if (!failingStatementString.includes('require')) {
+      failingStatementString = requireStatement.message
+        ? `require(${failingStatementString}, "${requireStatement.message}")`
+        : `require(${failingStatementString})`;
+    }
+
+    const failingLine = failingLocation.location.start.line;
+
+    const baseMessage = `${artifact.contractName}.cash:${failingLine} Require statement failed at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${failingLine}`;
+    const baseMessageWithRequireMessage = `${baseMessage} with the following message: ${requireStatement.message}`;
+    const fullMessage = `${requireStatement.message ? baseMessageWithRequireMessage : baseMessage}.\nFailing statement: ${failingStatementString}`;
+
+    super(fullMessage, bitauthUri);
   }
 }
 
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 0b097065..e1b89f9f 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -1,7 +1,7 @@
 import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateBCH, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBCH2023, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
 import { Artifact, LogEntry, Op, PrimitiveType, StackItem, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
 import { findLastIndex, toRegExp } from './utils.js';
-import { FailedRequireError, FailedTransactionError } from './Errors.js';
+import { FailedRequireError, FailedTransactionError, FailedTransactionEvaluationError } from './Errors.js';
 import { getBitauthUri } from './LibauthTemplate.js';
 
 // evaluates the fully defined template, throws upon error
@@ -58,12 +58,17 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
     const requireStatement = (artifact.debug?.requires ?? [])
       .find((statement) => statement.ip === requireStatementIp);
 
+    const { program: { inputIndex }, error } = lastExecutedDebugStep;
+
     if (requireStatement) {
-      const { program: { inputIndex }, error } = lastExecutedDebugStep;
-      throw new FailedRequireError(artifact.contractName, requireStatement, inputIndex, error, getBitauthUri(template));
+      throw new FailedRequireError(
+        artifact, requireStatementIp, requireStatement, inputIndex, getBitauthUri(template), error,
+      );
     }
 
-    throw new FailedTransactionError(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${lastExecutedDebugStep.error}`, getBitauthUri(template));
+    throw new FailedTransactionEvaluationError(
+      artifact, requireStatementIp, inputIndex, getBitauthUri(template), error,
+    );
   }
 
   const evaluationResult = vm.verify(program);
@@ -71,6 +76,11 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
   if (failedFinalVerify(evaluationResult)) {
     const finalExecutedVerifyIp = getFinalExecutedVerifyIp(executedDebugSteps);
 
+    // The final executed verify instruction points to the "implicit" VERIFY that is added at the end of the script.
+    // This instruction does not exist in the sourcemap, so we need to decrement the instruction pointer to get the
+    // actual final executed statement (which is *not* the require statement, but the evaluation within)
+    const sourcemapInstructionPointer = finalExecutedVerifyIp - 1;
+
     // logDebugSteps(executedDebugSteps, lastExecutedDebugStep.instructions);
     // console.warn('message', finalExecutedVerifyIp);
     // console.warn(artifact.debug?.requires);
@@ -78,12 +88,17 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
     const requireStatement = (artifact.debug?.requires ?? [])
       .find((message) => message.ip === finalExecutedVerifyIp);
 
+    const { program: { inputIndex } } = lastExecutedDebugStep;
+
     if (requireStatement) {
-      const { program: { inputIndex }, error } = lastExecutedDebugStep;
-      throw new FailedRequireError(artifact.contractName, requireStatement, inputIndex, getBitauthUri(template), error);
+      throw new FailedRequireError(
+        artifact, sourcemapInstructionPointer, requireStatement, inputIndex, getBitauthUri(template),
+      );
     }
 
-    throw new FailedTransactionError(`Error in evaluating input index ${lastExecutedDebugStep.program.inputIndex}.\n${evaluationResult}`, getBitauthUri(template));
+    throw new FailedTransactionEvaluationError(
+      artifact, sourcemapInstructionPointer, inputIndex, getBitauthUri(template), evaluationResult,
+    );
   }
 
   return fullDebugSteps;
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 9f31bed7..1144d4b0 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -6,7 +6,7 @@ import {
 } from './fixture/vars.js';
 import '../src/test/JestExtensions.js';
 import { randomUtxo } from '../src/utils.js';
-import { binToHex, hexToBin } from '@bitauth/libauth';
+import { AuthenticationErrorCommon, binToHex, hexToBin } from '@bitauth/libauth';
 
 const CONTRACT_CODE = `
 contract Test() {
@@ -73,6 +73,16 @@ contract Test() {
     }
   }
 
+  function test_invalid_split_range() {
+    bytes test = 0x1234;
+    bytes test2 = test.split(4)[0];
+    require(test2 == 0x1234);
+  }
+
+  function test_invalid_input_index() {
+    require(tx.inputs[5].value == 1000);
+  }
+
   function test_fail_checksig(sig s, pubkey pk) {
     require(checkSig(s, pk), "Signatures do not match");
     require(1 == 2, "1 should equal 2");
@@ -387,7 +397,7 @@ describe('Debugging tests', () => {
       const transaction = contract.functions
         .test_multiple_require_statements_no_message_final().to(contract.address, 1000n);
 
-      await expect(transaction).toFailRequireWith(new RegExp('^Test\.cash:32 Require statement failed at line 32$'));
+      await expect(transaction).toFailRequireWith(new RegExp('^Test\.cash:32 Require statement failed at input 0 in contract Test.cash at line 32'));
       await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
@@ -498,6 +508,35 @@ describe('Debugging tests', () => {
     });
   });
 
+  describe('Non-require error messages', () => {
+    const artifact = compileString(CONTRACT_CODE);
+    const provider = new MockNetworkProvider();
+
+    // test_invalid_split_range
+    it('should fail with correct error message when an invalid OP_SPLIT range is used', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transactionPromise = contract.functions.test_invalid_split_range()
+        .to(contract.address, 1000n)
+        .debug();
+
+      await expect(transactionPromise).rejects.toThrow(AuthenticationErrorCommon.invalidSplitIndex);
+    });
+
+    // test_invalid_input_index
+    it('should fail with correct error message when an invalid input index is used', async () => {
+      const contract = new Contract(artifact, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transactionPromise = contract.functions.test_invalid_input_index()
+        .to(contract.address, 1000n)
+        .debug();
+
+      await expect(transactionPromise).rejects.toThrow(AuthenticationErrorCommon.invalidTransactionUtxoIndex);
+    });
+  });
+
   describe('Template encoding', () => {
     const artifact = compileString(CONTRACT_CODE_ZERO_HANDLING);
     const provider = new MockNetworkProvider();

From f5038e9e7f5d27d437b8e32d27ae11521b440c94 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 22 Aug 2024 16:20:32 +0200
Subject: [PATCH 097/267] Fix bug in IP -> source code statement mapping and
 update tests/fixtures

---
 packages/cashscript/src/Errors.ts             | 26 ++++--
 packages/cashscript/src/debugging.ts          |  9 +-
 .../cashscript/test/e2e/Announcement.test.ts  |  9 +-
 packages/cashscript/test/e2e/BigInt.test.ts   |  3 +-
 .../cashscript/test/e2e/HodlVault.test.ts     |  6 +-
 packages/cashscript/test/e2e/Mecenas.test.ts  | 12 ++-
 packages/cashscript/test/e2e/P2PKH.test.ts    |  6 +-
 .../test/e2e/TokenCategoryCheck.test.ts       |  3 +-
 .../test/e2e/TransferWithTimeout.test.ts      |  9 +-
 .../test/fixtures/bitauth-script.fixture.ts   | 89 ++++++++++++++++++-
 10 files changed, 146 insertions(+), 26 deletions(-)

diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index 3895a9a9..e89857c8 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -1,4 +1,4 @@
-import { Artifact, RequireStatement, sourceMapToLocationData, Type } from '@cashscript/utils';
+import { Artifact, RequireStatement, SingleLocationData, sourceMapToLocationData, Type } from '@cashscript/utils';
 
 export class TypeError extends Error {
   constructor(actual: string, expected: Type) {
@@ -33,7 +33,6 @@ export class FailedTransactionError extends Error {
 
 // TODO: Merge the location stuff with FailedRequireError
 // TODO: Add tests and make sure it works for multiline statements
-// TODO: Fix that failing statement is incorrect when using multi-function contracts
 export class FailedTransactionEvaluationError extends FailedTransactionError {
   constructor(
     public artifact: Artifact,
@@ -45,8 +44,7 @@ export class FailedTransactionEvaluationError extends FailedTransactionError {
     let baseMessage = `${artifact.contractName}.cash Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash.`;
 
     if (artifact.debug) {
-      const locationData = sourceMapToLocationData(artifact.debug.sourceMap);
-      const failingLocation = locationData[failingInstructionPointer];
+      const failingLocation = getLocationDataForInstructionPointer(artifact, failingInstructionPointer);
 
       const failingStatementLineString = artifact.source.split('\n')[failingLocation.location.start.line - 1];
       const failingStatementString = failingStatementLineString.slice(
@@ -72,8 +70,7 @@ export class FailedRequireError extends FailedTransactionError {
     public bitauthUri: string,
     public libauthErrorMessage?: string,
   ) {
-    const locationData = sourceMapToLocationData(artifact.debug!.sourceMap);
-    const failingLocation = locationData[failingInstructionPointer];
+    const failingLocation = getLocationDataForInstructionPointer(artifact, failingInstructionPointer);
 
     const failingStatementLineString = artifact.source.split('\n')[failingLocation.location.start.line - 1];
     let failingStatementString = failingStatementLineString.slice(
@@ -87,6 +84,8 @@ export class FailedRequireError extends FailedTransactionError {
         : `require(${failingStatementString})`;
     }
 
+    failingStatementString = failingStatementString.trim().replace(/;$/g, '');
+
     const failingLine = failingLocation.location.start.line;
 
     const baseMessage = `${artifact.contractName}.cash:${failingLine} Require statement failed at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${failingLine}`;
@@ -97,6 +96,21 @@ export class FailedRequireError extends FailedTransactionError {
   }
 }
 
+const getLocationDataForInstructionPointer = (
+  artifact: Artifact,
+  instructionPointer: number,
+): SingleLocationData => {
+  const locationData = sourceMapToLocationData(artifact.debug!.sourceMap);
+
+  // We subtract the constructor inputs because these are present in the evaluation (and thus the instruction pointer)
+  // but they are not present in the source code (and thus the location data)
+  const modifiedInstructionPointer = instructionPointer - artifact.constructorInputs.length;
+
+  const location = locationData[modifiedInstructionPointer];
+
+  return location;
+};
+
 // TODO: Expand these reasons with non-script failures (like tx-mempool-conflict)
 export enum NodeErrorReason {
   EVAL_FALSE = 'Script evaluated without error but finished with a false/empty top stack element',
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index e1b89f9f..6e3e69fd 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -51,7 +51,8 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
 
     // Generally speaking, an error is thrown by the OP_VERIFY opcode, but for NULLFAIL, the error is thrown in the
     // preceding OP_CHECKSIG opcode. The error message is registered in the next instruction, so we need to increment
-    // the instruction pointer to get the correct error message.
+    // the instruction pointer to get the correct error message from the require messages in the artifact.
+    // Note that we do NOT use this adjusted IP when passing the failing IP into the FailedRequireError
     const isNullFail = lastExecutedDebugStep.error === AuthenticationErrorCommon.nonNullSignatureFailure;
     const requireStatementIp = failingIp + (isNullFail ? 1 : 0);
 
@@ -61,13 +62,15 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
     const { program: { inputIndex }, error } = lastExecutedDebugStep;
 
     if (requireStatement) {
+      // Note that we use failingIp here rather than requireStatementIp, see comment above
       throw new FailedRequireError(
-        artifact, requireStatementIp, requireStatement, inputIndex, getBitauthUri(template), error,
+        artifact, failingIp, requireStatement, inputIndex, getBitauthUri(template), error,
       );
     }
 
+    // Note that we use failingIp here rather than requireStatementIp, see comment above
     throw new FailedTransactionEvaluationError(
-      artifact, requireStatementIp, inputIndex, getBitauthUri(template), error,
+      artifact, failingIp, inputIndex, getBitauthUri(template), error,
     );
   }
 
diff --git a/packages/cashscript/test/e2e/Announcement.test.ts b/packages/cashscript/test/e2e/Announcement.test.ts
index 4a40c711..7ab3a048 100644
--- a/packages/cashscript/test/e2e/Announcement.test.ts
+++ b/packages/cashscript/test/e2e/Announcement.test.ts
@@ -66,7 +66,8 @@ describe('Announcement', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('Announcement.cash:17 Require statement failed at line 17');
+      await expect(txPromise).rejects.toThrow('Announcement.cash:17 Require statement failed at input 0 in contract Announcement.cash at line 17.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.outputs[0].lockingBytecode == announcement)');
     });
 
     it('should fail when sending incorrect amount of change', async () => {
@@ -88,7 +89,8 @@ describe('Announcement', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('Announcement.cash:25 Require statement failed at line 25');
+      await expect(txPromise).rejects.toThrow('Announcement.cash:25 Require statement failed at input 0 in contract Announcement.cash at line 25.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.outputs[1].value == changeAmount)');
     });
 
     it('should fail when sending the correct change amount to an incorrect address', async () => {
@@ -112,7 +114,8 @@ describe('Announcement', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('Announcement.cash:24 Require statement failed at line 24');
+      await expect(txPromise).rejects.toThrow('Announcement.cash:24 Require statement failed at input 0 in contract Announcement.cash at line 24.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode)');
     });
 
     it('should succeed when announcing correct announcement', async () => {
diff --git a/packages/cashscript/test/e2e/BigInt.test.ts b/packages/cashscript/test/e2e/BigInt.test.ts
index f1e9e0d6..da006313 100644
--- a/packages/cashscript/test/e2e/BigInt.test.ts
+++ b/packages/cashscript/test/e2e/BigInt.test.ts
@@ -39,7 +39,8 @@ describe('BigInt', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('BigInt.cash:4 Require statement failed at line 4');
+      await expect(txPromise).rejects.toThrow('BigInt.cash:4 Require statement failed at input 0 in contract BigInt.cash at line 4');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(x >= maxInt32PlusOne)');
     });
 
     it('should fail when providing numbers that overflow 64 bits when multiplied', async () => {
diff --git a/packages/cashscript/test/e2e/HodlVault.test.ts b/packages/cashscript/test/e2e/HodlVault.test.ts
index 31e47a71..6dcd2f8e 100644
--- a/packages/cashscript/test/e2e/HodlVault.test.ts
+++ b/packages/cashscript/test/e2e/HodlVault.test.ts
@@ -45,7 +45,8 @@ describe('HodlVault', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('HodlVault.cash:26 Require statement failed at line 26');
+      await expect(txPromise).rejects.toThrow('HodlVault.cash:26 Require statement failed at input 0 in contract HodlVault.cash at line 26.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(checkDataSig(oracleSig, oracleMessage, oraclePk))');
     });
 
     it('should fail when price is too low', async () => {
@@ -63,7 +64,8 @@ describe('HodlVault', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('HodlVault.cash:23 Require statement failed at line 23');
+      await expect(txPromise).rejects.toThrow('HodlVault.cash:23 Require statement failed at input 0 in contract HodlVault.cash at line 23.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(price >= priceTarget)');
     });
 
     it('should succeed when price is high enough', async () => {
diff --git a/packages/cashscript/test/e2e/Mecenas.test.ts b/packages/cashscript/test/e2e/Mecenas.test.ts
index 6b4cf5a6..8f85709f 100644
--- a/packages/cashscript/test/e2e/Mecenas.test.ts
+++ b/packages/cashscript/test/e2e/Mecenas.test.ts
@@ -42,7 +42,8 @@ describe('Mecenas', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('Mecenas.cash:24 Require statement failed at line 24');
+      await expect(txPromise).rejects.toThrow('Mecenas.cash:24 Require statement failed at input 0 in contract Mecenas.cash at line 24.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.outputs[0].value == pledge)');
     });
 
     it('should fail when trying to send to wrong person', async () => {
@@ -59,7 +60,8 @@ describe('Mecenas', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('Mecenas.cash:13 Require statement failed at line 13');
+      await expect(txPromise).rejects.toThrow('Mecenas.cash:13 Require statement failed at input 0 in contract Mecenas.cash at line 13.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient))');
     });
 
     it('should fail when trying to send to multiple people', async () => {
@@ -77,7 +79,8 @@ describe('Mecenas', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('Mecenas.cash:25 Require statement failed at line 25');
+      await expect(txPromise).rejects.toThrow('Mecenas.cash:25 Require statement failed at input 0 in contract Mecenas.cash at line 25.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode)');
     });
 
     it('should fail when sending incorrect amount of change', async () => {
@@ -94,7 +97,8 @@ describe('Mecenas', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('Mecenas.cash:26 Require statement failed at line 26');
+      await expect(txPromise).rejects.toThrow('Mecenas.cash:26 Require statement failed at input 0 in contract Mecenas.cash at line 26.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.outputs[1].value == changeValue)');
     });
 
     it('should succeed when sending pledge to receiver', async () => {
diff --git a/packages/cashscript/test/e2e/P2PKH.test.ts b/packages/cashscript/test/e2e/P2PKH.test.ts
index de4614a8..5444f39f 100644
--- a/packages/cashscript/test/e2e/P2PKH.test.ts
+++ b/packages/cashscript/test/e2e/P2PKH.test.ts
@@ -47,7 +47,8 @@ describe('P2PKH-no-tokens', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('P2PKH.cash:4 Require statement failed at line 4');
+      await expect(txPromise).rejects.toThrow('P2PKH.cash:4 Require statement failed at input 0 in contract P2PKH.cash at line 4.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(hash160(pk) == pkh)');
     });
 
     it('should fail when using incorrect signature', async () => {
@@ -63,7 +64,8 @@ describe('P2PKH-no-tokens', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('P2PKH.cash:5 Require statement failed at line 5');
+      await expect(txPromise).rejects.toThrow('P2PKH.cash:5 Require statement failed at input 0 in contract P2PKH.cash at line 5.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(checkSig(s, pk))');
     });
 
     it('should succeed when using correct function arguments', async () => {
diff --git a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
index 1289637f..ef6f9466 100644
--- a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
+++ b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
@@ -49,7 +49,8 @@ describe('TokenCategoryCheck', () => {
         .send();
 
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('Test.cash:3 Require statement failed at line 3');
+      await expect(txPromise).rejects.toThrow('Test.cash:3 Require statement failed at input 0 in contract Test.cash at line 3.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.inputs[1].tokenCategory == 0x)');
     });
 
     it('can send if the input at index 1 does not contain tokens', async () => {
diff --git a/packages/cashscript/test/e2e/TransferWithTimeout.test.ts b/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
index 1315ccae..9d07407b 100644
--- a/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
+++ b/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
@@ -44,7 +44,8 @@ describe('TransferWithTimeout', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:8 Require statement failed at line 8');
+      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:8 Require statement failed at input 0 in contract TransferWithTimeout.cash at line 8.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(checkSig(recipientSig, recipient))');
     });
 
     it('should fail when signing timeout with incorrect private key', async () => {
@@ -60,7 +61,8 @@ describe('TransferWithTimeout', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:13 Require statement failed at line 13');
+      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:13 Require statement failed at input 0 in contract TransferWithTimeout.cash at line 13.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(checkSig(senderSig, sender))');
     });
 
     it('should fail when timeout is called before timeout block', async () => {
@@ -76,7 +78,8 @@ describe('TransferWithTimeout', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:14 Require statement failed at line 14');
+      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:14 Require statement failed at input 0 in contract TransferWithTimeout.cash at line 14.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.time >= timeout)');
     });
 
     it('should succeed when transfer is called after timeout block', async () => {
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index 29b65ec9..363a6d25 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -15,7 +15,7 @@ export interface Fixture {
 
 export const fixtures: Fixture[] = [
   {
-    name: 'TransferWithTimeout',
+    name: 'TransferWithTimeout (Modified with random extra statements)',
     sourceCode: `
 contract TransferWithTimeout(bytes20 senderPkh, bytes20 recipientPkh, int timeout) {
   function transfer(pubkey signingPk, sig s) {
@@ -202,6 +202,93 @@ OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY
 OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */
 OP_NIP OP_NIP                                                                            /*     }                                                                                                              */
 OP_ENDIF                                                                                 /* }                                                                                                                  */
+`.replace(/^\n+/, '').replace(/\n+$/, ''),
+  },
+  {
+    name: 'HodlVault',
+    sourceCode: `
+// This contract forces HODLing until a certain price target has been reached
+// A minimum block is provided to ensure that oracle price entries from before this block are disregarded
+// i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used.
+// Instead, a message with a block number and price from after the minBlock needs to be passed.
+// This contract serves as a simple example for checkDataSig-based contracts.
+contract HodlVault(
+    pubkey ownerPk,
+    pubkey oraclePk,
+    int minBlock,
+    int priceTarget
+) {
+    function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {
+        // message: { blockHeight, price }
+        bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);
+        int blockHeight = int(blockHeightBin);
+        int price = int(priceBin);
+
+        // Check that blockHeight is after minBlock and not in the future
+        require(blockHeight >= minBlock);
+        require(tx.time >= blockHeight);
+
+        // Check that current price is at least priceTarget
+        require(price >= priceTarget);
+
+        // Handle necessary signature checks
+        require(checkDataSig(oracleSig, oracleMessage, oraclePk));
+        require(checkSig(ownerSig, ownerPk));
+    }
+}
+`.replace(/^\n+/, '').replace(/\n+$/, ''),
+    asmBytecode: 'OP_6 OP_PICK OP_4 OP_SPLIT OP_1 OP_ROLL OP_BIN2NUM OP_1 OP_ROLL OP_BIN2NUM OP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP OP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY OP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG',
+    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;;:26::45:1;16:24:16:32:0;;:20::33:1;19:16:19:27:0;;:31::39;;:16:::1;:8::41;20:27:20:38:0;;:8::40:1;;23:16:23:21:0;;:25::36;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:16::64:1;:8::66;27:25:27:33:0;;:35::42;;:16::43:1',
+    expectedLineToOpcodeMap: {
+      14: [Op.OP_6, Op.OP_PICK, Op.OP_4, Op.OP_SPLIT],
+      15: [Op.OP_1, Op.OP_ROLL, Op.OP_BIN2NUM],
+      16: [Op.OP_1, Op.OP_ROLL, Op.OP_BIN2NUM],
+      19: [Op.OP_1, Op.OP_PICK, Op.OP_5, Op.OP_ROLL, Op.OP_GREATERTHANOREQUAL, Op.OP_VERIFY],
+      20: [Op.OP_1, Op.OP_ROLL, Op.OP_CHECKLOCKTIMEVERIFY, Op.OP_DROP],
+      23: [new Uint8Array([]), Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_GREATERTHANOREQUAL, Op.OP_VERIFY],
+      26: [Op.OP_3, Op.OP_ROLL, Op.OP_4, Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_CHECKDATASIG, Op.OP_VERIFY],
+      27: [Op.OP_1, Op.OP_ROLL, Op.OP_1, Op.OP_ROLL, Op.OP_CHECKSIG],
+    },
+    expectedLineToAsmMap: {
+      14: 'OP_6 OP_PICK OP_4 OP_SPLIT',
+      15: 'OP_1 OP_ROLL OP_BIN2NUM',
+      16: 'OP_1 OP_ROLL OP_BIN2NUM',
+      19: 'OP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY',
+      20: 'OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP',
+      23: 'OP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY',
+      26: 'OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY',
+      27: 'OP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG',
+    },
+    expectedBitAuthScript: `
+                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */
+                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */
+                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */
+                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */
+                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */
+                                                                 /* contract HodlVault(                                                                                                    */
+                                                                 /*     pubkey ownerPk,                                                                                                    */
+                                                                 /*     pubkey oraclePk,                                                                                                   */
+                                                                 /*     int minBlock,                                                                                                      */
+                                                                 /*     int priceTarget                                                                                                    */
+                                                                 /* ) {                                                                                                                    */
+                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */
+                                                                 /*         // message: { blockHeight, price }                                                                             */
+OP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */
+OP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */
+OP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */
+                                                                 /*                                                                                                                        */
+                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */
+OP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */
+OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */
+                                                                 /*                                                                                                                        */
+                                                                 /*         // Check that current price is at least priceTarget                                                            */
+OP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */
+                                                                 /*                                                                                                                        */
+                                                                 /*         // Handle necessary signature checks                                                                           */
+OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */
+OP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */
+                                                                 /*     }                                                                                                                  */
+                                                                 /* }                                                                                                                      */
 `.replace(/^\n+/, '').replace(/\n+$/, ''),
   },
 ];

From 55451bdc68f79b0a8ce974052d7cf56a88849486 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 27 Aug 2024 10:21:23 +0200
Subject: [PATCH 098/267] Extend debugging tests so they also cover 'Failing
 statement' checks

---
 packages/cashscript/test/debugging.test.ts | 47 ++++++++++++++--------
 1 file changed, 31 insertions(+), 16 deletions(-)

diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 1144d4b0..82b58920 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -346,7 +346,8 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.test_require().to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/1 should equal 2/);
+      await expect(transaction).toFailRequireWith('Test.cash:13 Require statement failed at input 0 in contract Test.cash at line 13 with the following message: 1 should equal 2.');
+      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
     });
 
     // test_require_single_function
@@ -357,7 +358,8 @@ describe('Debugging tests', () => {
       const transaction = contract.functions.test_require_single_function()
         .to(contract.address, 1000n)
         .to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/should have 1 output/);
+      await expect(transaction).toFailRequireWith('Test.cash:4 Require statement failed at input 0 in contract Test.cash at line 4 with the following message: should have 1 output.');
+      await expect(transaction).toFailRequireWith('Failing statement: require(tx.outputs.length == 1, "should have 1 output")');
     });
 
     // test_multiple_require_statements
@@ -366,7 +368,8 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.test_multiple_require_statements().to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/1 should equal 2/);
+      await expect(transaction).toFailRequireWith('Test.cash:21 Require statement failed at input 0 in contract Test.cash at line 21 with the following message: 1 should equal 2.');
+      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
       await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
@@ -376,7 +379,8 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.test_multiple_require_statements_final_fails().to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/1 should equal 2/);
+      await expect(transaction).toFailRequireWith('Test.cash:27 Require statement failed at input 0 in contract Test.cash at line 27 with the following message: 1 should equal 2.');
+      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
       await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
@@ -397,7 +401,8 @@ describe('Debugging tests', () => {
       const transaction = contract.functions
         .test_multiple_require_statements_no_message_final().to(contract.address, 1000n);
 
-      await expect(transaction).toFailRequireWith(new RegExp('^Test\.cash:32 Require statement failed at input 0 in contract Test.cash at line 32'));
+      await expect(transaction).toFailRequireWith('Test.cash:32 Require statement failed at input 0 in contract Test.cash at line 32.');
+      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2)');
       await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
@@ -408,7 +413,8 @@ describe('Debugging tests', () => {
 
       const transaction = contract.functions.test_timeops_as_final_require().to(contract.address, 1000n);
 
-      await expect(transaction).toFailRequireWith(/time should be HUGE/);
+      await expect(transaction).toFailRequireWith('Test.cash:37 Require statement failed at input 0 in contract Test.cash at line 37 with the following message: time should be HUGE.');
+      await expect(transaction).toFailRequireWith('Failing statement: require(tx.time >= 100000000, "time should be HUGE")');
       await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
@@ -419,15 +425,18 @@ describe('Debugging tests', () => {
 
       const transactionIfBranch = contract.functions
         .test_final_require_in_if_statement(1n).to(contract.address, 1000n);
-      await expect(transactionIfBranch).toFailRequireWith(/1 should equal 2/);
+      await expect(transactionIfBranch).toFailRequireWith('Test.cash:43 Require statement failed at input 0 in contract Test.cash at line 43 with the following message: 1 should equal 2.');
+      await expect(transactionIfBranch).toFailRequireWith('Failing statement: require(1 == a, "1 should equal 2")');
 
       const transactionElseIfBranch = contract.functions
         .test_final_require_in_if_statement(2n).to(contract.address, 1000n);
-      await expect(transactionElseIfBranch).toFailRequireWith(/1 should equal 3/);
+      await expect(transactionElseIfBranch).toFailRequireWith('Test.cash:47 Require statement failed at input 0 in contract Test.cash at line 47 with the following message: 1 should equal 3.');
+      await expect(transactionElseIfBranch).toFailRequireWith('Failing statement: require(1 == b, "1 should equal 3")');
 
       const transactionElseBranch = contract.functions
         .test_final_require_in_if_statement(3n).to(contract.address, 1000n);
-      await expect(transactionElseBranch).toFailRequireWith(/switch should equal 4/);
+      await expect(transactionElseBranch).toFailRequireWith('Test.cash:50 Require statement failed at input 0 in contract Test.cash at line 50 with the following message: switch should equal 4.');
+      await expect(transactionElseBranch).toFailRequireWith('Failing statement: require(switch == c, "switch should equal 4")');
     });
 
     // test_final_require_in_if_statement_with_deep_reassignment
@@ -437,7 +446,8 @@ describe('Debugging tests', () => {
 
       const transaction = contract.functions
         .test_final_require_in_if_statement_with_deep_reassignment().to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/sum should equal 10/);
+      await expect(transaction).toFailRequireWith('Test.cash:62 Require statement failed at input 0 in contract Test.cash at line 62 with the following message: sum should equal 10.');
+      await expect(transaction).toFailRequireWith('Failing statement: require(a + b + c + d + e == 10, "sum should equal 10")');
     });
 
     // test_fail_checksig
@@ -447,7 +457,8 @@ describe('Debugging tests', () => {
 
       const checkSigTransaction = contract.functions
         .test_fail_checksig(new SignatureTemplate(alicePriv), bobPub).to(contract.address, 1000n);
-      await expect(checkSigTransaction).toFailRequireWith(/Signatures do not match/);
+      await expect(checkSigTransaction).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
+      await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
 
       // TODO: Add test for checksig with a NULL Signature (after we refactor Libauth Template generation)
       // const checkSigTransactionNullSignature = contract.functions
@@ -462,7 +473,8 @@ describe('Debugging tests', () => {
 
       const checkSigTransaction = contract.functions
         .test_fail_checksig_final_verify(new SignatureTemplate(alicePriv), bobPub).to(contract.address, 1000n);
-      await expect(checkSigTransaction).toFailRequireWith(/Signatures do not match/);
+      await expect(checkSigTransaction).toFailRequireWith('Test.cash:82 Require statement failed at input 0 in contract Test.cash at line 82 with the following message: Signatures do not match.');
+      await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
     });
 
     // test_fail_checkdatasig
@@ -473,12 +485,14 @@ describe('Debugging tests', () => {
       const checkDataSigTransaction = contract.functions
         .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xbeef')).slice(0, -1), '0xbeef', bobPub)
         .to(contract.address, 1000n);
-      await expect(checkDataSigTransaction).toFailRequireWith(/Data Signatures do not match/);
+      await expect(checkDataSigTransaction).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
+      await expect(checkDataSigTransaction).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
 
       const checkDataSigTransactionWrongMessage = contract.functions
         .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xc0ffee')).slice(0, -1), '0xbeef', alicePub)
         .to(contract.address, 1000n);
-      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith(/Data Signatures do not match/);
+      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
+      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
     });
 
     // test_fail_checkmultisig
@@ -495,7 +509,7 @@ describe('Debugging tests', () => {
           alicePub,
         )
         .to(contract.address, 1000n);
-      await expect(checkmultiSigTransaction).toFailRequireWith(/Multi Signatures do not match/);
+      await expect(checkmultiSigTransaction).toFailRequireWith(/Multi Signatures do not match1/);
     });
 
     // test_fail_large_cleanup
@@ -504,7 +518,8 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.test_fail_large_cleanup().to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith(/1 should equal 2/);
+      await expect(transaction).toFailRequireWith('Test.cash:19 Require statement failed at input 0 in contract Test.cash at line 19 with the following message: 1 should equal 2.');
+      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
     });
   });
 

From 2888465ea94d103a1055b727fc9081035f98e6c8 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 27 Aug 2024 10:47:16 +0200
Subject: [PATCH 099/267] Update Libauth to v3 and enable checkMultiSig test in
 debugging tests

---
 examples/common-js.js                      |  4 ++--
 examples/common.ts                         |  8 ++++----
 examples/package.json                      |  2 +-
 packages/cashc/package.json                |  2 +-
 packages/cashscript/package.json           |  2 +-
 packages/cashscript/src/utils.ts           | 10 ++++++----
 packages/cashscript/test/debugging.test.ts |  6 +++---
 packages/cashscript/test/fixture/vars.ts   |  8 ++++----
 packages/cashscript/test/test-util.ts      |  5 +++--
 packages/utils/package.json                |  2 +-
 yarn.lock                                  | 13 ++++---------
 11 files changed, 30 insertions(+), 32 deletions(-)

diff --git a/examples/common-js.js b/examples/common-js.js
index 7539c2c1..82e1c1a2 100644
--- a/examples/common-js.js
+++ b/examples/common-js.js
@@ -11,7 +11,7 @@ import bip39 from 'bip39';
 
 // Generate entropy from BIP39 mnemonic phrase and initialise a root HD-wallet node
 const seed = await bip39.mnemonicToSeed('CashScript Examples');
-const rootNode = deriveHdPrivateNodeFromSeed(seed, true);
+const rootNode = deriveHdPrivateNodeFromSeed(seed, { assumeValidity: true, throwErrors: true });
 const baseDerivationPath = "m/44'/145'/0'/0";
 
 // Derive Alice's private key, public key, public key hash and address
@@ -20,4 +20,4 @@ if (typeof aliceNode === 'string') throw new Error();
 export const alicePub = secp256k1.derivePublicKeyCompressed(aliceNode.privateKey);
 export const alicePriv = aliceNode.privateKey;
 export const alicePkh = hash160(alicePub);
-export const aliceAddress = encodeCashAddress('bchtest', 'p2pkh', alicePkh);
+export const aliceAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkh', payload: alicePkh, throwErrors: true }).address;
diff --git a/examples/common.ts b/examples/common.ts
index f1559a40..b3445c49 100644
--- a/examples/common.ts
+++ b/examples/common.ts
@@ -10,7 +10,7 @@ import { PriceOracle } from './PriceOracle.js';
 
 // Generate entropy from BIP39 mnemonic phrase and initialise a root HD-wallet node
 const seed = await bip39.mnemonicToSeed('CashScript Examples');
-const rootNode = deriveHdPrivateNodeFromSeed(seed, true);
+const rootNode = deriveHdPrivateNodeFromSeed(seed, { assumeValidity: true, throwErrors: true });
 const baseDerivationPath = "m/44'/145'/0'/0";
 
 // Derive Alice's private key, public key, public key hash and address
@@ -19,7 +19,7 @@ if (typeof aliceNode === 'string') throw new Error();
 export const alicePub = secp256k1.derivePublicKeyCompressed(aliceNode.privateKey) as Uint8Array;
 export const alicePriv = aliceNode.privateKey;
 export const alicePkh = hash160(alicePub);
-export const aliceAddress = encodeCashAddress('bchtest', 'p2pkhWithTokens', alicePkh);
+export const aliceAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkhWithTokens', payload: alicePkh, throwErrors: true }).address;
 
 // Derive Bob's private key, public key, public key hash and address
 const bobNode = deriveHdPath(rootNode, `${baseDerivationPath}/1`);
@@ -27,7 +27,7 @@ if (typeof bobNode === 'string') throw new Error();
 export const bobPub = secp256k1.derivePublicKeyCompressed(bobNode.privateKey) as Uint8Array;
 export const bobPriv = bobNode.privateKey;
 export const bobPkh = hash160(bobPub);
-export const bobAddress = encodeCashAddress('bchtest', 'p2pkhWithTokens', bobPkh);
+export const bobAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkhWithTokens', payload: bobPkh, throwErrors: true }).address;
 
 // Initialise a price oracle with a private key
 const oracleNode = deriveHdPath(rootNode, `${baseDerivationPath}/2`);
@@ -36,4 +36,4 @@ export const oraclePub = secp256k1.derivePublicKeyCompressed(oracleNode.privateK
 export const oraclePriv = oracleNode.privateKey;
 export const oracle = new PriceOracle(oracleNode.privateKey);
 export const oraclePkh = hash160(oraclePub);
-export const oracleAddress = encodeCashAddress('bchtest', 'p2pkhWithTokens', oraclePkh);
+export const oracleAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkhWithTokens', payload: oraclePkh, throwErrors: true }).address;
diff --git a/examples/package.json b/examples/package.json
index a1ac1a94..0307f788 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -11,7 +11,7 @@
     "lint": "eslint . --ext .ts --ignore-path ../.eslintignore"
   },
   "dependencies": {
-    "@bitauth/libauth": "^2.0.0-alpha.8",
+    "@bitauth/libauth": "^3.0.0",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
     "cashc": "^0.10.0-next.6",
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 7142a7e0..3e3a70b5 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -49,7 +49,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^2.0.0",
+    "@bitauth/libauth": "^3.0.0",
     "@cashscript/utils": "^0.10.0-next.6",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index d687d0b1..d58f4a61 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -43,7 +43,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^2.0.0",
+    "@bitauth/libauth": "^3.0.0",
     "@cashscript/utils": "^0.10.0-next.6",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index acc36cea..718febb2 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -211,10 +211,13 @@ export function toRegExp(reasons: string[]): RegExp {
 export function scriptToAddress(
   script: Script, network: string, addressType: AddressType, tokenSupport: boolean,
 ): string {
-  const lockingBytecode = scriptToLockingBytecode(script, addressType);
+  const bytecode = scriptToLockingBytecode(script, addressType);
   const prefix = getNetworkPrefix(network);
-  const address = lockingBytecodeToCashAddress(lockingBytecode, prefix, { tokenSupport }) as string;
-  return address;
+
+  const result = lockingBytecodeToCashAddress({ bytecode, prefix, tokenSupport });
+  if (typeof result === 'string') throw new Error(result);
+
+  return result.address;
 }
 
 export function scriptToLockingBytecode(script: Script, addressType: AddressType): Uint8Array {
@@ -255,7 +258,6 @@ export function utxoTokenComparator(a: Utxo, b: Utxo): number {
 */
 export function addressToLockScript(address: string): Uint8Array {
   const result = cashAddressToLockingBytecode(address);
-
   if (typeof result === 'string') throw new Error(result);
 
   return result.bytecode;
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 82b58920..aed28ae3 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -496,8 +496,7 @@ describe('Debugging tests', () => {
     });
 
     // test_fail_checkmultisig
-    // TODO: Add test for checkmultisig (requires ECDSA signatures) after refactoring Libauth Template generation
-    it.skip('should fail with correct error message when checkMultiSig fails', async () => {
+    it('should fail with correct error message when checkMultiSig fails', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
@@ -509,7 +508,8 @@ describe('Debugging tests', () => {
           alicePub,
         )
         .to(contract.address, 1000n);
-      await expect(checkmultiSigTransaction).toFailRequireWith(/Multi Signatures do not match1/);
+      await expect(checkmultiSigTransaction).toFailRequireWith('Test.cash:90 Require statement failed at input 0 in contract Test.cash at line 90 with the following message: Multi Signatures do not match.');
+      await expect(checkmultiSigTransaction).toFailRequireWith('Failing statement: require(checkMultiSig([s1, s2], [pk1, pk2]), "Multi Signatures do not match")');
     });
 
     // test_fail_large_cleanup
diff --git a/packages/cashscript/test/fixture/vars.ts b/packages/cashscript/test/fixture/vars.ts
index 97b75aae..a228270e 100644
--- a/packages/cashscript/test/fixture/vars.ts
+++ b/packages/cashscript/test/fixture/vars.ts
@@ -13,7 +13,7 @@ export const network = Network.CHIPNET;
 
 const seed = await bip39.mnemonicToSeed('CashScript Tests');
 
-const rootNode = deriveHdPrivateNodeFromSeed(seed, true);
+const rootNode = deriveHdPrivateNodeFromSeed(seed, { assumeValidity: true, throwErrors: true });
 const baseDerivationPath = "m/44'/145'/0'/0";
 
 const aliceNode = deriveHdPath(rootNode, `${baseDerivationPath}/0`);
@@ -26,17 +26,17 @@ if (typeof carolNode === 'string') throw new Error();
 export const alicePriv = aliceNode.privateKey;
 export const alicePub = secp256k1.derivePublicKeyCompressed(alicePriv) as Uint8Array;
 export const alicePkh = hash160(alicePub);
-export const aliceAddress = encodeCashAddress('bchtest', 'p2pkh', alicePkh);
+export const aliceAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkh', payload: alicePkh, throwErrors: true }).address;
 
 export const bobPriv = bobNode.privateKey;
 export const bobPub = secp256k1.derivePublicKeyCompressed(bobPriv) as Uint8Array;
 export const bobPkh = hash160(bobPub);
-export const bobAddress = encodeCashAddress('bchtest', 'p2pkh', bobPkh);
+export const bobAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkh', payload: bobPkh, throwErrors: true }).address;
 
 export const carolPriv = carolNode.privateKey;
 export const carolPub = secp256k1.derivePublicKeyCompressed(carolPriv) as Uint8Array;
 export const carolPkh = hash160(carolPub);
-export const carolAddress = encodeCashAddress('bchtest', 'p2pkh', carolPkh);
+export const carolAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkh', payload: carolPkh, throwErrors: true }).address;
 
 export const oracle = new PriceOracle(bobPriv);
 export const oraclePub = bobPub;
diff --git a/packages/cashscript/test/test-util.ts b/packages/cashscript/test/test-util.ts
index 6ed4cff8..fd7e8f90 100644
--- a/packages/cashscript/test/test-util.ts
+++ b/packages/cashscript/test/test-util.ts
@@ -20,10 +20,11 @@ export function getTxOutputs(tx: Transaction, network: Network = defaultNetwork)
     const prefix = getNetworkPrefix(network);
     const cashscriptOutput = libauthOutputToCashScriptOutput(o);
     const hasTokens = Boolean(cashscriptOutput.token);
-    const address = lockingBytecodeToCashAddress(hexToBin(scriptHex), prefix, { tokenSupport: hasTokens }) as string;
+    const result = lockingBytecodeToCashAddress({ bytecode: hexToBin(scriptHex), prefix, tokenSupport: hasTokens });
+    if (typeof result === 'string') throw new Error(result);
 
     return {
-      to: address,
+      to: result.address,
       amount: o.valueSatoshis,
       token: cashscriptOutput.token,
     };
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 99b90e6f..732ee591 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -40,7 +40,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^2.0.0",
+    "@bitauth/libauth": "^3.0.0",
     "hash.js": "^1.1.7"
   },
   "devDependencies": {
diff --git a/yarn.lock b/yarn.lock
index f3964ec9..1cfb6b96 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -496,15 +496,10 @@
   resolved "https://registry.yarnpkg.com/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz#75a2e8b51cb758a7553d6804a5932d7aace75c39"
   integrity sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==
 
-"@bitauth/libauth@^2.0.0":
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-2.0.0.tgz#200a3c967bf1ab088a9ea17691ee354283aee0a6"
-  integrity sha512-wFnQtnJvz7S7jU7fQuBJzRQrVHk46DELd5s8D0F61bW567bKVVfMLbwNPCs12pzVckueQTlLwCS//I9skGI1zg==
-
-"@bitauth/libauth@^2.0.0-alpha.8":
-  version "2.0.0-alpha.8"
-  resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-2.0.0-alpha.8.tgz#352ade2075517f1548e05553e7bb1c5e1023d1fe"
-  integrity sha512-KINAJbzg5pKs+WM8wCjWw6Ct/CeZG1JMrRXsIyPFztjNtwA5eeQL8eFkyquePsf8aZ5peRYK2eFPUDo/1rkg+w==
+"@bitauth/libauth@^3.0.0":
+  version "3.0.0"
+  resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-3.0.0.tgz#d88535fc5353d5ecd11db96d9a229e11c06a43d2"
+  integrity sha512-3yoL31XpnhAnf5nDVMFk4xPqebxDwXrgYAwpa31ARJnV5A/eXWlpNYvCd6FTZPFM4VvKfjCBi+jRCrw1hOZ0Jg==
 
 "@cnakazawa/watch@^1.0.3":
   version "1.0.4"

From 4446fc1691b05d2bd50df2189ac75be49f32886f Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 27 Aug 2024 10:55:24 +0200
Subject: [PATCH 100/267] Mark some re-exports as 'type' so tsx doesn't
 complain + update example pragmas

---
 examples/announcement.cash               |  2 +-
 examples/hodl_vault.cash                 |  2 +-
 examples/mecenas.cash                    |  2 +-
 examples/mecenas_locktime.cash           |  2 +-
 examples/p2pkh.cash                      |  2 +-
 examples/transfer_with_timeout.cash      |  2 +-
 packages/cashscript/src/index.ts         | 12 +++++-------
 packages/cashscript/src/network/index.ts |  2 +-
 8 files changed, 12 insertions(+), 14 deletions(-)

diff --git a/examples/announcement.cash b/examples/announcement.cash
index e10ccea4..6f06492b 100644
--- a/examples/announcement.cash
+++ b/examples/announcement.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 /* This is a contract showcasing covenants outside of regular transactional use.
  * It enforces the contract to make an "announcement" on Memo.cash, and send the
diff --git a/examples/hodl_vault.cash b/examples/hodl_vault.cash
index a687a4c2..3e92be36 100644
--- a/examples/hodl_vault.cash
+++ b/examples/hodl_vault.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 // This contract forces HODLing until a certain price target has been reached
 // A minimum block is provided to ensure that oracle price entries from before this block are disregarded
diff --git a/examples/mecenas.cash b/examples/mecenas.cash
index 82e1a274..268c4cf7 100644
--- a/examples/mecenas.cash
+++ b/examples/mecenas.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 /* This is an unofficial CashScript port of Licho's Mecenas contract. It is
  * not compatible with Licho's EC plugin, but rather meant as a demonstration
diff --git a/examples/mecenas_locktime.cash b/examples/mecenas_locktime.cash
index 471f9173..8ea17dc4 100644
--- a/examples/mecenas_locktime.cash
+++ b/examples/mecenas_locktime.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 // This is an experimental contract for a more "streaming" Mecenas experience
 // Completely untested, just a concept
diff --git a/examples/p2pkh.cash b/examples/p2pkh.cash
index 02e6ad68..974ca04a 100644
--- a/examples/p2pkh.cash
+++ b/examples/p2pkh.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 contract P2PKH(bytes20 pkh) {
     // Require pk to match stored pkh and signature to match
diff --git a/examples/transfer_with_timeout.cash b/examples/transfer_with_timeout.cash
index ea04b5f8..9d4aaa1a 100644
--- a/examples/transfer_with_timeout.cash
+++ b/examples/transfer_with_timeout.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 contract TransferWithTimeout(
     pubkey sender,
diff --git a/packages/cashscript/src/index.ts b/packages/cashscript/src/index.ts
index f485f4bf..4b9d2228 100644
--- a/packages/cashscript/src/index.ts
+++ b/packages/cashscript/src/index.ts
@@ -1,16 +1,14 @@
-import SignatureTemplate from './SignatureTemplate.js';
-
-export { SignatureTemplate };
-export { Contract, ContractFunction } from './Contract.js';
+export { default as SignatureTemplate } from './SignatureTemplate.js';
+export { Contract, type ContractFunction } from './Contract.js';
 export { Transaction } from './Transaction.js';
 export { TransactionBuilder } from './TransactionBuilder.js';
-export { Argument, encodeArgument } from './Argument.js';
-export { Artifact, AbiFunction, AbiInput } from '@cashscript/utils';
+export { type Argument, encodeArgument } from './Argument.js';
+export type { Artifact, AbiFunction, AbiInput } from '@cashscript/utils';
 export * as utils from '@cashscript/utils';
 export * from './interfaces.js';
 export * from './Errors.js';
 export {
-  NetworkProvider,
+  type NetworkProvider,
   BitcoinRpcNetworkProvider,
   ElectrumNetworkProvider,
   FullStackNetworkProvider,
diff --git a/packages/cashscript/src/network/index.ts b/packages/cashscript/src/network/index.ts
index 6feb6217..8d31ddde 100644
--- a/packages/cashscript/src/network/index.ts
+++ b/packages/cashscript/src/network/index.ts
@@ -1,4 +1,4 @@
-export { default as NetworkProvider } from './NetworkProvider.js';
+export type { default as NetworkProvider } from './NetworkProvider.js';
 export { default as BitcoinRpcNetworkProvider } from './BitcoinRpcNetworkProvider.js';
 export { default as ElectrumNetworkProvider } from './ElectrumNetworkProvider.js';
 export { default as FullStackNetworkProvider } from './FullStackNetworkProvider.js';

From a9954ab038a5931b9cdf90d7143beb6dec051b12 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 27 Aug 2024 11:03:36 +0200
Subject: [PATCH 101/267] Merge getLocationDataForInstructionPointer logic from
 require/non-require errors

---
 packages/cashscript/src/Errors.ts | 55 +++++++++++--------------------
 1 file changed, 20 insertions(+), 35 deletions(-)

diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index e89857c8..7b52be8b 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -1,4 +1,4 @@
-import { Artifact, RequireStatement, SingleLocationData, sourceMapToLocationData, Type } from '@cashscript/utils';
+import { Artifact, RequireStatement, sourceMapToLocationData, Type } from '@cashscript/utils';
 
 export class TypeError extends Error {
   constructor(actual: string, expected: Type) {
@@ -31,8 +31,6 @@ export class FailedTransactionError extends Error {
   }
 }
 
-// TODO: Merge the location stuff with FailedRequireError
-// TODO: Add tests and make sure it works for multiline statements
 export class FailedTransactionEvaluationError extends FailedTransactionError {
   constructor(
     public artifact: Artifact,
@@ -44,17 +42,8 @@ export class FailedTransactionEvaluationError extends FailedTransactionError {
     let baseMessage = `${artifact.contractName}.cash Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash.`;
 
     if (artifact.debug) {
-      const failingLocation = getLocationDataForInstructionPointer(artifact, failingInstructionPointer);
-
-      const failingStatementLineString = artifact.source.split('\n')[failingLocation.location.start.line - 1];
-      const failingStatementString = failingStatementLineString.slice(
-        failingLocation.location.start.column,
-        failingLocation.location.end.column,
-      );
-
-      const failingLine = failingLocation.location.start.line;
-
-      baseMessage = `${artifact.contractName}.cash:${failingLine} Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${failingLine}.\nFailing statement: ${failingStatementString}`;
+      const { statement, lineNumber } = getLocationDataForInstructionPointer(artifact, failingInstructionPointer);
+      baseMessage = `${artifact.contractName}.cash:${lineNumber} Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${lineNumber}.\nFailing statement: ${statement}`;
     }
 
     super(`${baseMessage}\nReason: ${libauthErrorMessage}`, bitauthUri);
@@ -70,45 +59,41 @@ export class FailedRequireError extends FailedTransactionError {
     public bitauthUri: string,
     public libauthErrorMessage?: string,
   ) {
-    const failingLocation = getLocationDataForInstructionPointer(artifact, failingInstructionPointer);
-
-    const failingStatementLineString = artifact.source.split('\n')[failingLocation.location.start.line - 1];
-    let failingStatementString = failingStatementLineString.slice(
-      failingLocation.location.start.column,
-      failingLocation.location.end.column,
-    );
-
-    if (!failingStatementString.includes('require')) {
-      failingStatementString = requireStatement.message
-        ? `require(${failingStatementString}, "${requireStatement.message}")`
-        : `require(${failingStatementString})`;
-    }
+    let { statement, lineNumber } = getLocationDataForInstructionPointer(artifact, failingInstructionPointer);
 
-    failingStatementString = failingStatementString.trim().replace(/;$/g, '');
-
-    const failingLine = failingLocation.location.start.line;
+    if (!statement.includes('require')) {
+      statement = requireStatement.message
+        ? `require(${statement}, "${requireStatement.message}")`
+        : `require(${statement})`;
+    }
 
-    const baseMessage = `${artifact.contractName}.cash:${failingLine} Require statement failed at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${failingLine}`;
+    const baseMessage = `${artifact.contractName}.cash:${lineNumber} Require statement failed at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${lineNumber}`;
     const baseMessageWithRequireMessage = `${baseMessage} with the following message: ${requireStatement.message}`;
-    const fullMessage = `${requireStatement.message ? baseMessageWithRequireMessage : baseMessage}.\nFailing statement: ${failingStatementString}`;
+    const fullMessage = `${requireStatement.message ? baseMessageWithRequireMessage : baseMessage}.\nFailing statement: ${statement}`;
 
     super(fullMessage, bitauthUri);
   }
 }
 
+// TODO: Add tests and make sure it works for multiline statements
 const getLocationDataForInstructionPointer = (
   artifact: Artifact,
   instructionPointer: number,
-): SingleLocationData => {
+): { lineNumber: number, statement: string } => {
   const locationData = sourceMapToLocationData(artifact.debug!.sourceMap);
 
   // We subtract the constructor inputs because these are present in the evaluation (and thus the instruction pointer)
   // but they are not present in the source code (and thus the location data)
   const modifiedInstructionPointer = instructionPointer - artifact.constructorInputs.length;
 
-  const location = locationData[modifiedInstructionPointer];
+  const { location } = locationData[modifiedInstructionPointer];
+
+  const lineString = artifact.source.split('\n')[location.start.line - 1];
+  const statement = lineString.slice(location.start.column, location.end.column);
+
+  const lineNumber = location.start.line;
 
-  return location;
+  return { statement, lineNumber };
 };
 
 // TODO: Expand these reasons with non-script failures (like tx-mempool-conflict)

From 134530874cdb19f4150f5e41824bcdfce67a526e Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 28 Aug 2024 14:58:56 +0200
Subject: [PATCH 102/267] update pragma version in documentation

---
 website/docs/basics/getting-started.md |  2 +-
 website/docs/language/contracts.md     | 10 +++++-----
 website/docs/language/examples.md      |  4 ++--
 website/docs/sdk/examples.md           |  2 +-
 4 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 49b393ab..938f38d9 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -45,7 +45,7 @@ We can start from a basic `TransferWithTimeout` smart contract. Create a new fil
 The `TransferWithTimeout` contract takes in 3 contract arguments and has 2 contract functions: `transfer` and `timeout`.
 
 ```solidity
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
     // Allow the recipient to claim their received money
diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index b89f468b..dd07437d 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -13,7 +13,7 @@ The pragma directive follows regular [semantic versioning rules](https://semver.
 
 #### Example
 ```solidity
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 pragma cashscript >= 0.7.0 < 0.9.3;
 ```
 
@@ -22,7 +22,7 @@ A CashScript constructor works slightly differently than what you might be used
 
 #### Example
 ```solidity
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 contract HTLC(pubkey sender, pubkey recipient, int expiration, bytes32 hash) {
     ...
@@ -38,7 +38,7 @@ The main construct in a CashScript contract is the function. A contract can cont
 
 #### Example
 ```solidity
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
     function transfer(sig recipientSig) {
@@ -69,7 +69,7 @@ The error message in a `require` statement is only available in debug evaluation
 
 #### Example
 ```solidity
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 contract P2PKH(bytes20 pkh) {
     function spend(pubkey pk, sig s) {
@@ -111,7 +111,7 @@ There is no implicit type conversion from non-boolean to boolean types. So `if (
 
 #### Example
 ```solidity
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 contract OneOfTwo(bytes20 pkh1, bytes32 hash1, bytes20 pkh2, bytes32 hash2) {
     function spend(pubkey pk, sig s, bytes message) {
diff --git a/website/docs/language/examples.md b/website/docs/language/examples.md
index 325d3141..47024987 100644
--- a/website/docs/language/examples.md
+++ b/website/docs/language/examples.md
@@ -10,7 +10,7 @@ One interesting use case of Bitcoin Cash is using it for *paper tips*. With pape
 As an alternative, a smart contract can be used for these kinds of gifts. This smart contract allows the recipient to claim their gift at any time, but if they don't claim it in time, the sender can reclaim it.
 
 ```solidity
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
     // Require recipient's signature to match
@@ -36,7 +36,7 @@ This smart contract works by connecting with a price oracle. This price oracle i
 This involves some degree of trust in the price oracle, but since the oracle produces price data for everyone to use, their incentive to attack *your* smart contract is minimised. To improve this situation, you can also choose to connect with multiple oracle providers so you do not have to trust a single party.
 
 ```solidity
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 // A minimum block is provided to ensure that oracle price entries from before
 // this block are disregarded. i.e. when the BCH price was $1000 in the past,
diff --git a/website/docs/sdk/examples.md b/website/docs/sdk/examples.md
index 79028e61..bb1214d3 100644
--- a/website/docs/sdk/examples.md
+++ b/website/docs/sdk/examples.md
@@ -56,7 +56,7 @@ This contract expects a hardcoded transaction fee of 1000 satoshis. This is nece
 To ensure that this leftover money does not get lost in the contract, the contract performs an extra check, and adds the remainder to the transaction fee if it's too low.
 
 ```solidity title="Announcement.cash"
-pragma cashscript ^0.9.0;
+pragma cashscript ^0.10.0;
 
 // This contract enforces making an announcement on Memo.cash and sending the
 // remaining balance back to the contract.

From d50b3995dd020b7d2a5eb9a9fd9cc02df74ff5c7 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 28 Aug 2024 15:09:50 +0200
Subject: [PATCH 103/267] add separate category to sidebar for compiler topics

---
 website/docs/{language => compiler}/artifacts.md |  0
 website/docs/{basics => compiler}/compiler.md    |  0
 website/docs/{language => compiler}/grammar.md   |  0
 website/docs/sdk/instantiation.md                |  2 +-
 website/sidebars.js                              | 12 +++++++++---
 5 files changed, 10 insertions(+), 4 deletions(-)
 rename website/docs/{language => compiler}/artifacts.md (100%)
 rename website/docs/{basics => compiler}/compiler.md (100%)
 rename website/docs/{language => compiler}/grammar.md (100%)

diff --git a/website/docs/language/artifacts.md b/website/docs/compiler/artifacts.md
similarity index 100%
rename from website/docs/language/artifacts.md
rename to website/docs/compiler/artifacts.md
diff --git a/website/docs/basics/compiler.md b/website/docs/compiler/compiler.md
similarity index 100%
rename from website/docs/basics/compiler.md
rename to website/docs/compiler/compiler.md
diff --git a/website/docs/language/grammar.md b/website/docs/compiler/grammar.md
similarity index 100%
rename from website/docs/language/grammar.md
rename to website/docs/compiler/grammar.md
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 71d8fd26..68f617d6 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -25,7 +25,7 @@ new Contract(
 
 A CashScript contract can be instantiated by providing an `Artifact` object, a list of constructor arguments, and optionally an options object configuring `NetworkProvider` and `addressType`.
 
-An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/language/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/basics/compiler) or programmatically with the `cashc` NPM package (see [CashScript Compiler](/docs/basics/compiler#javascript-compilation)).
+An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/language/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/compiler/compiler) or programmatically with the `cashc` NPM package (see [CashScript Compiler](/docs/compiler/compiler#javascript-compilation)).
 
 The `NetworkProvider` option is used to manage network operations for the CashScript contract. By default, a mainnet `ElectrumNetworkProvider` is used, but the network providers can be configured. See the docs on [NetworkProvider](/docs/sdk/network-provider).
 
diff --git a/website/sidebars.js b/website/sidebars.js
index 888c1069..676b87db 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -7,7 +7,6 @@ module.exports = {
         'basics/about',
         // 'basics/about-bch',
         'basics/getting-started',
-        'basics/compiler',
       ],
     },
     {
@@ -18,11 +17,18 @@ module.exports = {
         'language/types',
         'language/functions',
         'language/globals',
-        'language/artifacts',
-        'language/grammar',
         'language/examples',
       ],
     },
+    {
+      type: 'category',
+      label: 'Compiler',
+      items: [
+        'compiler/compiler',
+        'compiler/artifacts',
+        'compiler/grammar',
+      ],
+    },
     {
       type: 'category',
       label: 'JavaScript SDK',

From 089c5508baf5976d567e65ba0cdfe2a938ba49bb Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 28 Aug 2024 15:52:28 +0200
Subject: [PATCH 104/267] fully rewrite intro section to Bitcoin Cash

---
 website/docs/basics/about-bch.md | 43 +++++++++++++-------------------
 website/sidebars.js              |  2 +-
 2 files changed, 18 insertions(+), 27 deletions(-)

diff --git a/website/docs/basics/about-bch.md b/website/docs/basics/about-bch.md
index 9451f43e..47f022b5 100644
--- a/website/docs/basics/about-bch.md
+++ b/website/docs/basics/about-bch.md
@@ -1,43 +1,34 @@
 ---
-title: What is Bitcoin Cash?
+title: Intro to Bitcoin Cash
 sidebar_label: About Bitcoin Cash
 ---
 
-:::warning
-This is a work in progress page, it will be added to the site structure at a later date. If you still somehow arrived at this page, feel free to read it, but note that it is a work in progress.
-:::
-
-Bitcoin Cash (or BCH) is a peer-to-peer electronic cash system. It uses a *blockchain* to distribute its ledger over a network of independent nodes so that there is no single point of failure, and no central control that might be compromised. It uses a consensus algorithm called *Proof-of-Work* that allows these independent nodes to approve correct transactions and reject malicious ones.
+Bitcoin Cash (ticker BCH) is one of the biggest cryptocurrencies. Bitcoin Cash is a fork of Bitcoin started in 2017 because of differences in vision for the future of the Bitcoin project.
 
-## Basics
-The *blockchain* is a data structure that is distributed over a number of independent nodes. It derives its name from the chain of *blocks* that it uses to store its data. All blocks include a *block header* with some metadata and the root of a *Merkle tree* - a special kind of tree that allows quick validation of data. This Merkle tree is then used to store the actual data inside these blocks. To make the chain resistant to
-manipulation, block headers also include a timestamp and a hash of the previous block.
+Bitcoin Cash shares many of the same fundamentals as Bitcoin (BTC) like the *Proof-of-Work* consensus alrgorithm and the *UTXO data-model*. However regarding smart contract programmability, Bitcoin Cash has significantly diverged from Bitcoin (BTC). We will first cover the UTXO data model and then delve into the smart contract capabilities of Bitcoin Cash.
 
-### Proof-of-Work
-Bitcoin Cash and many other public blockchains use a consensus algorithm called *Proof-of-Work (PoW)*. This algorithm works by attaching a nonce to every block header and changing this nonce until the hash of the block header matches a certain prefix. This process is called mining, and is attempted by many nodes at the same time, until one of them has found a correct solution. One of the attributes of this algorithm is that mining is very expensive, but other nodes can verify the solution very quickly.
+:::info
+To learn more about the Bitcoin Basics refer to the book ['Mastering Bitcoin'](https://github.com/bitcoinbook/bitcoinbook). There is also a modified version for BCH specifically called ['Mastering Bitcoin Cash'](https://github.com/Bitcoin-com/mastering-bitcoin-cash).
+:::
 
-Mining is also the process by which new coins are introduced to the total monetary supply. Miners validate transactions and secure the network, for which they are paid new coins - called the *block reward* - in a special transaction called a *coinbase* transaction. The high cost of the mining process attaches a financial risk to incorrectly validating transactions. At the same time the block reward attaches a financial reward to correctly validating transactions. This process ensures that the mutually distrusting nodes can collaborate to validate transactions.
+## UTXO model
+Bitcoin Cash transactions work with in- and outputs. All current balances are so called *Unspent Transaction Outputs (UTXOs)*, which simply means they can be used as inputs for future spending transactions.
 
-### Transactions
-Bitcoin Cash transactions are created using chunks of BCH called transaction outputs. When these outputs are available, they are called *Unspent Transaction Outputs (UTXOs)*. UTXOs are locked using a locking script (or `scriptPubKey`) that specifies the conditions to spend the UTXO. When attempting to spend a UTXO, an unlocking script (or `scriptSig`) is provided. These scripts are then executed together and the transaction is only valid if the scripts execute without errors and the resulting value is `TRUE`.
+When UTXOs are used as inputs to a Bitcoin Cash transaction, they produce new UTXOs as outputs. UTXOs need to be spent in their entirety within a transaction. So whenever the user wishes to use a 10 BCH UTXO to send someone 1 BCH, they need to send 9 BCH back to themselves. Realistically, part of the funds would be reserved for transaction fees as well.
 
 The most used locking/unlocking script pattern is called *Pay-to-Public-Key-Hash (P2PKH)*, where the locking script contains the hash of a public key and expects the unlocking script to contain a public key and transaction signature. The locking script then checks that the provided public key matches the stored hash, and that the transaction signature is valid. This pattern is used in regular Bitcoin Cash wallets. And the user's balance is simply the sum of all UTXOs that can be spent by the user's public keys.
 
-UTXOs are used as inputs to Bitcoin Cash transactions and produce new UTXOs as outputs. UTXOs need to be spent in their entirety within a transaction. So whenever the user wishes to use a 10 BCH UTXO to send someone 1 BCH, they need to send 9 BCH back to themselves. Realistically, part of the funds would be
-reserved for transaction fees as well.
+## Smart Contracts on BCH
+Bitcoin Cash has had many script upgrades, including transaction introspection and CashTokens. Because of these upgrades, DeFi is very much possible on Bitcoin Cash. However, compared to EVM, smart contracts work very differently due to BCH's UTXO architecture.
 
-## Smart Contracts
-Peer-to-peer electronic cash was the first real use case of blockchain technology. But in recent years, smart contracts have grown in popularity. These smart contracts allow people to use the security that blockchains such as Bitcoin, Bitcoin Cash and Ethereum offer and apply it to use cases other than cash. Especially Decentralised Finance (DeFi) applications such as [Maker](https://makerdao.com/), [Uniswap](https://uniswap.org/) and [Aave](https://aave.com/) have skyrocketed.
-
-Most smart contract innovation has happened on Ethereum, but other platforms like Bitcoin and Bitcoin Cash have some support for smart contracts as well. Smart contracts on every platform work differently, and the main differences between smart contracts on Ethereum and Bitcoin Cash is that smart contracts on Ethereum are stateful, while those on Bitcoin Cash are stateless.
-
-This means that Ethereum contracts can record and update variables, while the variables in Bitcoin Cash contracts are immutable. To understand the implications of these differences, refer to the blog post [*Smart Contracts on Ethereum, Bitcoin and Bitcoin Cash*](https://kalis.me/smart-contracts-eth-btc-bch/).
+Smart contracts on Bitcoin Cash only have access to the current transaction context, which enables 'local state'. This model allows transactions to be verified independently and efficiently. Because there is no global state that can impact the execution of these smart contracts, the results are deterministic and predictable.
 
 ### Bitcoin Cash Script
-The locking and unlocking scripts of regular transactions and smart contracts on Bitcoin Cash are written using Bitcoin Cash' transaction scripting language, creatively named Script. To avoid ambiguity, it can also be referred to as Bitcoin Script or Bitcoin Cash Script. Script is a stack based assembly-like language that is intentionally not turing complete as its main use is the validation of programmable money, not general purpose computing.
+UTXOs are locked using a locking script (or `scriptPubKey`) that specifies the conditions to spend the UTXO. When attempting to spend a UTXO, an unlocking script (or `scriptSig`) is provided. These scripts are then executed together and the transaction is only valid if the scripts execute without errors and the resulting value is `TRUE`.
+
+The locking and unlocking scripts of regular transactions and smart contracts on Bitcoin Cash are written using Bitcoin Cash' transaction scripting language, creatively named Script. To avoid ambiguity, it can also be referred to as Bitcoin Cash Script or BCH Script. Script is a stack based assembly-like language, because it is a low-level language and requires stack management it is hard to write complex smart contract in Script directly.
 
-Script is stateless, meaning it only uses the information contained within the locking and unlocking scripts themselves. This statelessness means that a Script can be deterministically validated on any machine. This gives increased performance and predictability, although it does limit the usefulness of the scripting language.
 
-### Bitcoin Cash Contracts
+### CashScript
 
-TODO
+CashScript is a high-level programming language for smart contracts on Bitcoin Cash that offers a strong abstraction for a smoother development experience. The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum.
\ No newline at end of file
diff --git a/website/sidebars.js b/website/sidebars.js
index 676b87db..38a347bf 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -5,7 +5,7 @@ module.exports = {
       label: 'Basics',
       items: [
         'basics/about',
-        // 'basics/about-bch',
+        'basics/about-bch',
         'basics/getting-started',
       ],
     },

From 4d8093e52de7cdf071a0921b4428e7d268eb9bc0 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 28 Aug 2024 16:06:09 +0200
Subject: [PATCH 105/267] fix broken links

---
 website/docs/compiler/compiler.md | 2 +-
 website/docs/sdk/instantiation.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/docs/compiler/compiler.md b/website/docs/compiler/compiler.md
index e451bf16..493900f0 100644
--- a/website/docs/compiler/compiler.md
+++ b/website/docs/compiler/compiler.md
@@ -3,7 +3,7 @@ title: Compiler
 ---
 
 The CashScript compiler is called `cashc` and is used to compile CashScript `.cash` contract files into `.json` artifact files.
-These artifact files can be used to instantiate a CashScript contract with the help of the CashScript SDK. For more information on this artifact format refer to [Artifacts](/docs/language/artifacts).
+These artifact files can be used to instantiate a CashScript contract with the help of the CashScript SDK. For more information on this artifact format refer to [Artifacts](/docs/compiler/artifacts).
 
 ## Command Line Interface
 
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 68f617d6..6ccff29a 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -25,7 +25,7 @@ new Contract(
 
 A CashScript contract can be instantiated by providing an `Artifact` object, a list of constructor arguments, and optionally an options object configuring `NetworkProvider` and `addressType`.
 
-An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/language/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/compiler/compiler) or programmatically with the `cashc` NPM package (see [CashScript Compiler](/docs/compiler/compiler#javascript-compilation)).
+An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/compiler/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/compiler) or programmatically with the `cashc` NPM package (see [CashScript Compiler](/docs/compiler#javascript-compilation)).
 
 The `NetworkProvider` option is used to manage network operations for the CashScript contract. By default, a mainnet `ElectrumNetworkProvider` is used, but the network providers can be configured. See the docs on [NetworkProvider](/docs/sdk/network-provider).
 

From 361868fcda2db6264c2da06b859c8a0629c0177a Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 28 Aug 2024 16:30:03 +0200
Subject: [PATCH 106/267] change the features on the homepage

---
 website/src/pages/index.js | 33 ++++++++++++++-------------------
 1 file changed, 14 insertions(+), 19 deletions(-)

diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index fb588258..40ace446 100755
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -8,45 +8,40 @@ import styles from './index.module.css';
 
 const features = [
   {
-    title: 'Efficient and Reliable Verification',
+    title: 'TypeScript SDK',
     description: (
       <>
-        Smart contracts on Bitcoin Cash are UTXO-based with local state. This
-        model allows transactions to be verified independently and efficiently.
-        Because there is no global state that can impact the execution of these smart
-        contracts, the results are deterministic and predictable.
+        The CashScript TypeScript SDK makes it easy to build smart contract transactions, both in browser or on the server.
+        By offering full type-safety, developers can be confident in the quality and reliability of their applications. 
       </>
     ),
   },
   {
-    title: 'Strong Abstraction',
+    title: 'Familiar Syntax',
     description: (
       <>
-        Bitcoin Cash transactions run on a virtual machine called 'BCH Script'.
-        Writing bytecode for this virtual machine is difficult and error-prone.
-        CashScript offers a strong abstraction for writing Bitcoin Cash smart
-        contracts, improving developer experience and reliability of contracts.
+        The CashScript syntax is based on Ethereum's smart contract language Solidity, 
+        which in turn is influenced by C++, Python, and JavaScript. This should make writing 
+        CashScript contracts feel familar even to new developers.
       </>
     ),
   },
   {
-    title: 'DeFi on Bitcoin Cash',
+    title: 'Integrated Network APIs',
     description: (
       <>
-        Bitcoin Cash has had many script upgrades, such as CashTokens and transaction introspection.
-        Because of this, DeFi is very much possible on Bitcoin Cash.
-        However, compared to EVM, smart contracts work very differently due to BCH's UTXO
-        architecture.
+        To make it easy to get blockchain information, the CashScript SDK exports a standardized network provider to query network APIs.
+        The primary class of network providers are the electrum servers but other network providers are also supported. 
       </>
     ),
   },
   {
-    title: 'Integrated Tooling',
+    title: 'Advanced Debug Tooling',
     description: (
       <>
-        CashScript offers integrated tooling through the JavaScript SDK.
-        The SDK has utilities for easy transaction building and other network functionality.
-        CashScript has built-in debug tooling compatible with the Bitauth-IDE to offer the best developer experience.  
+        To offer the best developer experience for debugging and automated testing easy for developers,
+        CashScript has extensive debug tooling built-in.
+        This makes it possible to develop robust contract testing suites, and to debug your contracts with the Bitauth-IDE.  
       </>
     ),
   },

From 51e9fc58c12cf3fc7b3a9821c53708ad35d79c63 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 29 Aug 2024 13:06:49 +0200
Subject: [PATCH 107/267] rename JS SDK to TS SDK

---
 README.md                              |  4 ++--
 packages/cashc/README.md               |  2 +-
 packages/utils/README.md               |  2 +-
 website/docs/basics/getting-started.md | 13 +++++++++----
 website/docs/guides/debugging.md       |  2 +-
 website/docs/guides/optimization.md    |  2 +-
 website/docs/language/functions.md     |  2 +-
 website/docs/sdk/instantiation.md      |  5 +++--
 website/sidebars.js                    |  2 +-
 9 files changed, 20 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index a8cb0483..478776e6 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@
 
 CashScript is a high-level programming language for smart contracts on Bitcoin Cash. It offers a strong abstraction layer over Bitcoin Cash' native virtual machine, Bitcoin Script. Its syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum. For a detailed comparison of them, refer to the blog post [_Smart Contracts on Ethereum, Bitcoin and Bitcoin Cash_](https://kalis.me/smart-contracts-eth-btc-bch/).
 
-This repository contains the code for the CashScript compiler & command line tool under [`packages/cashc/`](/packages/cashc). This repository also contains the code for the CashScript JavaScript SDK under [`packages/cashscript/`](/packages/cashscript). The source code of the [CashScript.org](https://cashscript.org) website is included under [`website/`](/website). Visit the website for a detailed [Documentation](https://cashscript.org/docs/) on the CashScript language and SDK.
+This repository contains the code for the CashScript compiler & command line tool under [`packages/cashc/`](/packages/cashc). This repository also contains the code for the CashScript TypeScript SDK under [`packages/cashscript/`](/packages/cashscript). The source code of the [CashScript.org](https://cashscript.org) website is included under [`website/`](/website). Visit the website for a detailed [Documentation](https://cashscript.org/docs/) on the CashScript language and SDK.
 
 ## The CashScript Language
 
@@ -16,7 +16,7 @@ CashScript is a high-level language that allows you to write Bitcoin Cash smart
 
 ## The CashScript Compiler
 
-CashScript features a compiler as a standalone command line tool, called `cashc`. It can be installed through npm and used to compile `.cash` files into `.json` artifact files. These artifact files can be imported into the CashScript JavaScript SDK (or other SDKs in the future). The `cashc` NPM package can also be imported inside JavaScript files to compile `.cash` files without using the command line tool.
+CashScript features a compiler as a standalone command line tool, called `cashc`. It can be installed through npm and used to compile `.cash` files into `.json` artifact files. These artifact files can be imported into the CashScript TypeScript SDK (or other SDKs in the future). The `cashc` NPM package can also be imported inside JavaScript files to compile `.cash` files without using the command line tool.
 
 ### Installation
 
diff --git a/packages/cashc/README.md b/packages/cashc/README.md
index 33cdedae..dd1e0ada 100644
--- a/packages/cashc/README.md
+++ b/packages/cashc/README.md
@@ -14,7 +14,7 @@ See the [GitHub repository](https://github.com/CashScript/cashscript) and the [C
 CashScript is a high-level language that allows you to write Bitcoin Cash smart contracts in a straightforward and familiar way. Its syntax is inspired by Ethereum's Solidity language, but its functionality is different since the underlying systems have very different fundamentals. See the [language documentation](https://cashscript.org/docs/language/) for a full reference of the language.
 
 ## The CashScript Compiler
-CashScript features a compiler as a standalone command line tool, called `cashc`. It can be installed through npm and used to compile `.cash` files into `.json` artifact files. These artifact files can be imported into the CashScript JavaScript SDK (or other SDKs in the future). The `cashc` NPM package can also be imported inside JavaScript files to compile `.cash` files without using the command line tool.
+CashScript features a compiler as a standalone command line tool, called `cashc`. It can be installed through npm and used to compile `.cash` files into `.json` artifact files. These artifact files can be imported into the CashScript TypeScript SDK (or other SDKs in the future). The `cashc` NPM package can also be imported inside JavaScript files to compile `.cash` files without using the command line tool.
 
 ### Installation
 ```bash
diff --git a/packages/utils/README.md b/packages/utils/README.md
index bb540adf..09dfc906 100644
--- a/packages/utils/README.md
+++ b/packages/utils/README.md
@@ -6,4 +6,4 @@
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/@cashscript/utils.svg)](hhttps://www.npmjs.com/package/@cashscript/utils)
 [![NPM License](https://img.shields.io/npm/l/@cashscript/utils.svg)](https://www.npmjs.com/package/@cashscript/utils)
 
-`@cashscript/utils` is a package containing a number of utilities and types used by both the CashScript compiler and the JavaScript SDK. This package can be used by other applications as well, but it should be considered an unstable API and will not necessarily follow semantic versioning rules. So if you want to use `@cashscript/utils` as a standalone package, it is recommended to specify a specific version (instead of a range) in your `package.json`.
+`@cashscript/utils` is a package containing a number of utilities and types used by both the CashScript compiler and the TypeScript SDK. This package can be used by other applications as well, but it should be considered an unstable API and will not necessarily follow semantic versioning rules. So if you want to use `@cashscript/utils` as a standalone package, it is recommended to specify a specific version (instead of a range) in your `package.json`.
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 938f38d9..113f0382 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -62,7 +62,7 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 ```
 
 :::tip
-There are some other examples available on the [Examples page](/docs/language/examples) that can be used to take inspiration from. Further examples of the JavaScript integration can be found on [GitHub](https://github.com/CashScript/cashscript/tree/master/examples).
+There are some other examples available on the [Examples page](/docs/language/examples) that can be used to take inspiration from. Further examples of the TypeScript and JavaScript integration can be found on [GitHub](https://github.com/CashScript/cashscript/tree/master/examples).
 :::
 
 ### Compiling your smart contract
@@ -81,10 +81,15 @@ OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_ROLL OP_ROT OP_CHECKSIG OP_NIP OP_NI
 
 ## Creating a CashScript Transaction
 
-After creating a contract artifact, we can now use the JavaScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs. We'll continue with the `TransferWithTimeout` artifact generated in the previous steps.
+After creating a contract artifact, we can now use the TypeScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs. We'll continue with the `TransferWithTimeout` artifact generated in the previous steps.
 
-### Installing the JavaScript SDK
-The JavaScript SDK can be installed into your project with NPM. Note that CashScript is a [pure ESM package](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
+:::info
+The CashScript SDK is written in TypeScript meaning that you can either use TypeScript or vanilla JavaScript to use the SDK.
+It's recommended to use TypeScript for full type-safety of all you contract logic.
+:::
+
+### Installing the TypeScript SDK
+The TypeScript SDK can be installed into your project with NPM. Note that CashScript is a [pure ESM package](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
 
 ```bash
 npm install cashscript
diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 2e041bc0..5fca9e3b 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -23,7 +23,7 @@ Currently the CashScript debugging tools only work with the [Simple Transaction
 
 If a CashScript transaction is sent using any network provider and is rejected by the network (or the `MockNetworkProvider`), the transaction will be evaluated locally using libauth to provide failure reasons and debug information in addition to the failure reason communicated by the network.
 
-Read the error message to see which line in the CashScript contract causes the transaction validation to fail. Investigate whether the contract function invocation is the issue (on the JavaScript SDK side) or whether the issue is in the CashScript contract itself (so you'd need to update your contract and recompile the artifact). If it is not clear **why** the CashScript contract is failing on that line, then you can use the following two strategies: console logging & Bitauth IDE stack trace.
+Read the error message to see which line in the CashScript contract causes the transaction validation to fail. Investigate whether the contract function invocation is the issue (on the TypeScript SDK side) or whether the issue is in the CashScript contract itself (so you'd need to update your contract and recompile the artifact). If it is not clear **why** the CashScript contract is failing on that line, then you can use the following two strategies: console logging & Bitauth IDE stack trace.
 
 ### Console Logging
 
diff --git a/website/docs/guides/optimization.md b/website/docs/guides/optimization.md
index 8ef2a0a4..ad5f6ec3 100644
--- a/website/docs/guides/optimization.md
+++ b/website/docs/guides/optimization.md
@@ -87,7 +87,7 @@ cashc ./contract.cash --opcount --size
 The size output of the `cashc` compiler will always be an underestimate, as the contract hasn't been initialized with contract arguments.
 :::
 
-The `cashc` compiler only knows the opcount and bytesize of a contract before it is initialised with function arguments. Because of this, to get an accurate view of a contracts size, initialise the contract instance first, then get the size from there. This means you will have to re-compile the artifact before checking the contract size through the JavaScript SDK.
+The `cashc` compiler only knows the opcount and bytesize of a contract before it is initialised with function arguments. Because of this, to get an accurate view of a contracts size, initialise the contract instance first, then get the size from there. This means you will have to re-compile the artifact before checking the contract size through the TypeScript SDK.
 
 ```javascript
 import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
diff --git a/website/docs/language/functions.md b/website/docs/language/functions.md
index 61b105b9..6f617172 100644
--- a/website/docs/language/functions.md
+++ b/website/docs/language/functions.md
@@ -89,7 +89,7 @@ bool checkMultiSig(sig[] sigs, pubkey[] pks)
 Performs a multi-signature check using a list of transaction signatures and public keys.
 
 :::note
-While this function can be used inside your smart contracts, it is not supported by the JavaScript SDK, so it is recommended not to use it. Instead a `checkMultiSig()` call can be simulated using multiple `checkSig()` calls.
+While this function can be used inside your smart contracts, it is not supported by the TypeScript SDK, so it is recommended not to use it. Instead a `checkMultiSig()` call can be simulated using multiple `checkSig()` calls.
 :::
 
 ### checkDataSig()
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 6ccff29a..87f54c2a 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -4,8 +4,9 @@ title: Contract Instantiation
 
 Before interacting with a smart contract on the BCH network, the CashScript SDK needs to instantiate a `Contract` object. This is done by providing the contract's information and constructor arguments. After this instantiation, the CashScript SDK can interact with the BCH contract.
 
-:::note
-CashScript only offers a JavaScript SDK, but CashScript contracts can be integrated into other languages as well. Because there are no ready-to-use SDKs available for them, this is considered advanced usage.
+:::info
+CashScript offers a TypeScript SDK, which can also be used easily in vanilla JavaScript codebases. 
+Because of the separation of the compiler and the SDK, CashScript contracts can be integrated into other languages in the future.
 :::
 
 ## Contract class
diff --git a/website/sidebars.js b/website/sidebars.js
index 38a347bf..238673d5 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -31,7 +31,7 @@ module.exports = {
     },
     {
       type: 'category',
-      label: 'JavaScript SDK',
+      label: 'TypeScript SDK',
       items: [
         'sdk/instantiation',
         'sdk/network-provider',

From bf6857d3af76113fa5e4101ddbd182b6319fdea0 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 3 Sep 2024 11:47:00 +0200
Subject: [PATCH 108/267] Fix multiline failing statement error handling

- Add multiple tests for multiline failing statements
- Add functionality to support multiline failing statements
- Fix issues with incorrect PositionHint in source mapping
- Document PositionHint functionality with examples
- Slightly update FailedTransactionEvaluationError message
---
 .../src/generation/GenerateTargetTraversal.ts |  38 ++--
 packages/cashscript/src/Errors.ts             |  18 +-
 packages/cashscript/test/debugging.test.ts    | 173 ++++++++++++++++--
 packages/utils/src/types.ts                   |   5 +
 4 files changed, 199 insertions(+), 35 deletions(-)

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 55eff7e8..cd5497e2 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -264,7 +264,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   // This algorithm can be optimised for hardcoded depths
   // See thesis for explanation
   emitReplace(index: number, node: Node): void {
-    const locationData = { location: node.location };
+    const locationData = { location: node.location, positionHint: PositionHint.END };
 
     this.emit(encodeInt(BigInt(index)), locationData);
     this.emit(Op.OP_ROLL, locationData);
@@ -387,7 +387,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // Special case for sized bytes cast, since it has another node to traverse
     if (node.size) {
       node.size = this.visit(node.size);
-      this.emit(Op.OP_NUM2BIN, { location: node.location });
+      this.emit(Op.OP_NUM2BIN, { location: node.location, positionHint: PositionHint.END });
       this.popFromStack();
     }
 
@@ -431,51 +431,53 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   }
 
   visitInstantiation(node: InstantiationNode): Node {
-    const nodeLocationData = { location: node.location };
 
     if (node.identifier.name === Class.LOCKING_BYTECODE_P2PKH) {
       // OP_DUP OP_HASH160 OP_PUSH<20>
-      this.emit(hexToBin('76a914'), nodeLocationData);
+      this.emit(hexToBin('76a914'), { location: node.location });
       this.pushToStack('(value)');
       // <pkh>
       this.visit(node.parameters[0]);
-      this.emit(Op.OP_CAT, nodeLocationData);
+      this.emit(Op.OP_CAT, { location: node.location, positionHint: PositionHint.END });
       // OP_EQUAL OP_CHECKSIG
-      this.emit(hexToBin('88ac'), nodeLocationData);
-      this.emit(Op.OP_CAT, nodeLocationData);
+      this.emit(hexToBin('88ac'), { location: node.location, positionHint: PositionHint.END });
+      this.emit(Op.OP_CAT, { location: node.location, positionHint: PositionHint.END });
       this.popFromStack(2);
     } else if (node.identifier.name === Class.LOCKING_BYTECODE_P2SH20) {
       // OP_HASH160 OP_PUSH<20>
-      this.emit(hexToBin('a914'), nodeLocationData);
+      this.emit(hexToBin('a914'), { location: node.location });
       this.pushToStack('(value)');
       // <script hash>
       this.visit(node.parameters[0]);
-      this.emit(Op.OP_CAT, nodeLocationData);
+      this.emit(Op.OP_CAT, { location: node.location, positionHint: PositionHint.END });
       // OP_EQUAL
-      this.emit(hexToBin('87'), nodeLocationData);
-      this.emit(Op.OP_CAT, nodeLocationData);
+      this.emit(hexToBin('87'), { location: node.location, positionHint: PositionHint.END });
+      this.emit(Op.OP_CAT, { location: node.location, positionHint: PositionHint.END });
       this.popFromStack(2);
     } else if (node.identifier.name === Class.LOCKING_BYTECODE_P2SH32) {
       // OP_HASH256 OP_PUSH<32>
-      this.emit(hexToBin('aa20'), nodeLocationData);
+      this.emit(hexToBin('aa20'), { location: node.location });
       this.pushToStack('(value)');
       // <script hash>
       this.visit(node.parameters[0]);
-      this.emit(Op.OP_CAT, nodeLocationData);
+      this.emit(Op.OP_CAT, { location: node.location, positionHint: PositionHint.END });
       // OP_EQUAL
-      this.emit(hexToBin('87'), nodeLocationData);
-      this.emit(Op.OP_CAT, nodeLocationData);
+      this.emit(hexToBin('87'), { location: node.location, positionHint: PositionHint.END });
+      this.emit(Op.OP_CAT, { location: node.location, positionHint: PositionHint.END });
       this.popFromStack(2);
     } else if (node.identifier.name === Class.LOCKING_BYTECODE_NULLDATA) {
       // Total script = OP_RETURN (<VarInt> <chunk>)+
       // OP_RETURN
-      this.emit(hexToBin('6a'), nodeLocationData);
+      this.emit(hexToBin('6a'), { location: node.location });
       this.pushToStack('(value)');
       const { elements } = node.parameters[0] as ArrayNode;
       // <VarInt data chunk size (dynamic)>
       elements.forEach((element) => {
-        const elementLocationData = { location: element.location };
         this.visit(element);
+
+        // The element comes first, then all other opcodes have PositionHint.END because they come after the element
+        const elementLocationData = { location: element.location, positionHint: PositionHint.END };
+
         // Push the element's size (and calculate VarInt)
         this.emit(Op.OP_SIZE, elementLocationData);
         if (element instanceof HexLiteralNode) {
@@ -541,7 +543,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
   visitUnaryOp(node: UnaryOpNode): Node {
     node.expression = this.visit(node.expression);
-    this.emit(compileUnaryOp(node.operator), { location: node.location });
+    this.emit(compileUnaryOp(node.operator), { location: node.location, positionHint: PositionHint.END });
     this.popFromStack();
     this.pushToStack('(value)');
     return node;
diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index 7b52be8b..1db1c420 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -39,14 +39,14 @@ export class FailedTransactionEvaluationError extends FailedTransactionError {
     public bitauthUri: string,
     public libauthErrorMessage: string,
   ) {
-    let baseMessage = `${artifact.contractName}.cash Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash.`;
+    let message = `${artifact.contractName}.cash Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash.\nReason: ${libauthErrorMessage}`;
 
     if (artifact.debug) {
       const { statement, lineNumber } = getLocationDataForInstructionPointer(artifact, failingInstructionPointer);
-      baseMessage = `${artifact.contractName}.cash:${lineNumber} Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${lineNumber}.\nFailing statement: ${statement}`;
+      message = `${artifact.contractName}.cash:${lineNumber} Error in transaction at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${lineNumber}.\nReason: ${libauthErrorMessage}\nFailing statement: ${statement}`;
     }
 
-    super(`${baseMessage}\nReason: ${libauthErrorMessage}`, bitauthUri);
+    super(message, bitauthUri);
   }
 }
 
@@ -65,6 +65,9 @@ export class FailedRequireError extends FailedTransactionError {
       statement = requireStatement.message
         ? `require(${statement}, "${requireStatement.message}")`
         : `require(${statement})`;
+
+      // Sometimes in reconstructed multiline require statements, we get double commas
+      statement = statement.replace(/,,/g, ',');
     }
 
     const baseMessage = `${artifact.contractName}.cash:${lineNumber} Require statement failed at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${lineNumber}`;
@@ -88,9 +91,14 @@ const getLocationDataForInstructionPointer = (
 
   const { location } = locationData[modifiedInstructionPointer];
 
-  const lineString = artifact.source.split('\n')[location.start.line - 1];
-  const statement = lineString.slice(location.start.column, location.end.column);
+  const failingLines = artifact.source.split('\n').slice(location.start.line - 1, location.end.line);
+
+  // Slice off the start and end of the statement's start and end lines to only return the failing part
+  // Note that we first slice off the end, to avoid shifting the end column index
+  failingLines[failingLines.length - 1] = failingLines[failingLines.length - 1].slice(0, location.end.column);
+  failingLines[0] = failingLines[0].slice(location.start.column);
 
+  const statement = failingLines.join('\n');
   const lineNumber = location.start.line;
 
   return { statement, lineNumber };
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index aed28ae3..42d3c689 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -68,7 +68,8 @@ contract Test() {
     int d = 3;
     int e = 4;
     if (a == 0) {
-      a = 10;
+      a =
+        10 + 10;
       require(a + b + c + d + e == 10, "sum should equal 10");
     }
   }
@@ -123,12 +124,73 @@ contract Test() {
     int h = 8;
 
     // Use all variables inside this if-statement so they do not get OP_ROLL'ed
-    if (1 == 2) {
+    if (
+    1
+      == 2
+    ) {
       require(a + b + c + d + e + f + g + h == 1, "sum should equal 36");
     }
 
     require(1 == 2, "1 should equal 2");
   }
+
+  function test_fail_multiline_require() {
+    require(
+      1 == 2,
+      "1 should equal 2"
+    );
+
+    require(1 == 1);
+  }
+
+  function test_fail_multiline_final_require() {
+    require(
+      1 == 2,
+      "1 should equal 2"
+    );
+  }
+
+  function test_multiline_non_require_error() {
+    int x =
+      tx.outputs[
+        5
+      ].value +
+      tx.inputs[5].value;
+    require(x == 1000);
+  }
+
+  function test_multiline_require_with_unary_op() {
+    require(
+      !(
+        0x000000
+        .reverse()
+        .length
+        !=
+        -(
+          30
+            +
+          15
+        )
+      )
+    );
+
+    require(1 == 1);
+  }
+
+  function test_multiline_require_with_instantiation() {
+    require(
+      new LockingBytecodeP2PKH(
+        hash160(0x000000)
+      )
+        ==
+      new LockingBytecodeNullData([
+        0x00,
+        bytes("hello world")
+      ])
+    );
+
+    require(1 == 1);
+  }
 }
 `;
 
@@ -341,7 +403,7 @@ describe('Debugging tests', () => {
     const provider = new MockNetworkProvider();
 
     // test_require
-    it('should fail with error message when require statement fails', async () => {
+    it('should fail with error message when require statement fails in a multi-function contract', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
 
@@ -446,7 +508,7 @@ describe('Debugging tests', () => {
 
       const transaction = contract.functions
         .test_final_require_in_if_statement_with_deep_reassignment().to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith('Test.cash:62 Require statement failed at input 0 in contract Test.cash at line 62 with the following message: sum should equal 10.');
+      await expect(transaction).toFailRequireWith('Test.cash:63 Require statement failed at input 0 in contract Test.cash at line 63 with the following message: sum should equal 10.');
       await expect(transaction).toFailRequireWith('Failing statement: require(a + b + c + d + e == 10, "sum should equal 10")');
     });
 
@@ -457,7 +519,7 @@ describe('Debugging tests', () => {
 
       const checkSigTransaction = contract.functions
         .test_fail_checksig(new SignatureTemplate(alicePriv), bobPub).to(contract.address, 1000n);
-      await expect(checkSigTransaction).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
+      await expect(checkSigTransaction).toFailRequireWith('Test.cash:78 Require statement failed at input 0 in contract Test.cash at line 78 with the following message: Signatures do not match.');
       await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
 
       // TODO: Add test for checksig with a NULL Signature (after we refactor Libauth Template generation)
@@ -473,7 +535,7 @@ describe('Debugging tests', () => {
 
       const checkSigTransaction = contract.functions
         .test_fail_checksig_final_verify(new SignatureTemplate(alicePriv), bobPub).to(contract.address, 1000n);
-      await expect(checkSigTransaction).toFailRequireWith('Test.cash:82 Require statement failed at input 0 in contract Test.cash at line 82 with the following message: Signatures do not match.');
+      await expect(checkSigTransaction).toFailRequireWith('Test.cash:83 Require statement failed at input 0 in contract Test.cash at line 83 with the following message: Signatures do not match.');
       await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
     });
 
@@ -485,13 +547,13 @@ describe('Debugging tests', () => {
       const checkDataSigTransaction = contract.functions
         .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xbeef')).slice(0, -1), '0xbeef', bobPub)
         .to(contract.address, 1000n);
-      await expect(checkDataSigTransaction).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
+      await expect(checkDataSigTransaction).toFailRequireWith('Test.cash:87 Require statement failed at input 0 in contract Test.cash at line 87 with the following message: Data Signatures do not match.');
       await expect(checkDataSigTransaction).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
 
       const checkDataSigTransactionWrongMessage = contract.functions
         .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xc0ffee')).slice(0, -1), '0xbeef', alicePub)
         .to(contract.address, 1000n);
-      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
+      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Test.cash:87 Require statement failed at input 0 in contract Test.cash at line 87 with the following message: Data Signatures do not match.');
       await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
     });
 
@@ -508,7 +570,7 @@ describe('Debugging tests', () => {
           alicePub,
         )
         .to(contract.address, 1000n);
-      await expect(checkmultiSigTransaction).toFailRequireWith('Test.cash:90 Require statement failed at input 0 in contract Test.cash at line 90 with the following message: Multi Signatures do not match.');
+      await expect(checkmultiSigTransaction).toFailRequireWith('Test.cash:91 Require statement failed at input 0 in contract Test.cash at line 91 with the following message: Multi Signatures do not match.');
       await expect(checkmultiSigTransaction).toFailRequireWith('Failing statement: require(checkMultiSig([s1, s2], [pk1, pk2]), "Multi Signatures do not match")');
     });
 
@@ -518,13 +580,79 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.test_fail_large_cleanup().to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith('Test.cash:19 Require statement failed at input 0 in contract Test.cash at line 19 with the following message: 1 should equal 2.');
+      await expect(transaction).toFailRequireWith('Test.cash:22 Require statement failed at input 0 in contract Test.cash at line 22 with the following message: 1 should equal 2.');
       await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
     });
+
+    // test_fail_multiline_require
+    it('should fail with correct error message and statement when a multiline require statement fails', async () => {
+      const contract = new Contract(artifact3, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_fail_multiline_require().to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith('Test.cash:26 Require statement failed at input 0 in contract Test.cash at line 26 with the following message: 1 should equal 2.');
+      await expect(transaction).toFailRequireWith(`Failing statement: require(
+      1 == 2,
+      "1 should equal 2"
+    );`);
+    });
+
+    // test_fail_multiline_final_require
+    it('should fail with correct error message and statement when a multiline final require statement fails', async () => {
+      const contract = new Contract(artifact3, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_fail_multiline_final_require().to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith('Test.cash:36 Require statement failed at input 0 in contract Test.cash at line 36 with the following message: 1 should equal 2.');
+      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
+    });
+
+    // test_multiline_require_with_unary_op
+    // Note that we add this test, because we changed the LocationHint for all Unary Ops to "END"
+    it('should fail with correct error message and statement when a multiline require statement with a unary op fails', async () => {
+      const contract = new Contract(artifact3, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_multiline_require_with_unary_op().to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith('Test.cash:51 Require statement failed at input 0 in contract Test.cash at line 51.');
+      await expect(transaction).toFailRequireWith(`Failing statement: require(
+      !(
+        0x000000
+        .reverse()
+        .length
+        !=
+        -(
+          30
+            +
+          15
+        )
+      )
+    );`);
+    });
+
+    // test_multiline_require_with_instantiation
+    it('should fail with correct error message and statement when a multiline require statement with an instantiation fails', async () => {
+      const contract = new Contract(artifact3, [], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transaction = contract.functions.test_multiline_require_with_instantiation().to(contract.address, 1000n);
+      await expect(transaction).toFailRequireWith('Test.cash:69 Require statement failed at input 0 in contract Test.cash at line 69.');
+      await expect(transaction).toFailRequireWith(`Failing statement: require(
+      new LockingBytecodeP2PKH(
+        hash160(0x000000)
+      )
+        ==
+      new LockingBytecodeNullData([
+        0x00,
+        bytes(\"hello world\")
+      ])
+    );`);
+    });
   });
 
   describe('Non-require error messages', () => {
     const artifact = compileString(CONTRACT_CODE);
+    const artifact3 = compileString(CONTRACT_CODE3);
     const provider = new MockNetworkProvider();
 
     // test_invalid_split_range
@@ -536,7 +664,9 @@ describe('Debugging tests', () => {
         .to(contract.address, 1000n)
         .debug();
 
-      await expect(transactionPromise).rejects.toThrow(AuthenticationErrorCommon.invalidSplitIndex);
+      await expect(transactionPromise).rejects.toThrow('Test.cash:69 Error in transaction at input 0 in contract Test.cash at line 69.');
+      await expect(transactionPromise).rejects.toThrow('Failing statement: test.split(4)');
+      await expect(transactionPromise).rejects.toThrow(`Reason: ${AuthenticationErrorCommon.invalidSplitIndex}`);
     });
 
     // test_invalid_input_index
@@ -548,7 +678,26 @@ describe('Debugging tests', () => {
         .to(contract.address, 1000n)
         .debug();
 
-      await expect(transactionPromise).rejects.toThrow(AuthenticationErrorCommon.invalidTransactionUtxoIndex);
+      await expect(transactionPromise).rejects.toThrow('Test.cash:74 Error in transaction at input 0 in contract Test.cash at line 74.');
+      await expect(transactionPromise).rejects.toThrow('Failing statement: tx.inputs[5].value');
+      await expect(transactionPromise).rejects.toThrow(`Reason: ${AuthenticationErrorCommon.invalidTransactionUtxoIndex}`);
+    });
+
+    // test_multiline_non_require_error
+    it('should fail with correct error message and statament when a multiline non-require statement fails', async () => {
+      const contract = new Contract(artifact3, [], { provider });
+
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const transactionPromise = contract.functions.test_multiline_non_require_error()
+        .to(contract.address, 1000n)
+        .debug();
+
+      await expect(transactionPromise).rejects.toThrow('Test.cash:43 Error in transaction at input 0 in contract Test.cash at line 43.');
+      await expect(transactionPromise).rejects.toThrow(`Failing statement: tx.outputs[
+        5
+      ].value`);
+      await expect(transactionPromise).rejects.toThrow(`Reason: ${AuthenticationErrorCommon.invalidTransactionOutputIndex}`);
     });
   });
 
diff --git a/packages/utils/src/types.ts b/packages/utils/src/types.ts
index f5e598aa..7eb3199b 100644
--- a/packages/utils/src/types.ts
+++ b/packages/utils/src/types.ts
@@ -205,6 +205,11 @@ export type SingleLocationData = {
 export type FullLocationData = Array<SingleLocationData>;
 
 // Denotes whether an opcode belongs to the "start" or "end" of the statement it's in (defaults to "start")
+// Examples:
+// require(true); --> the OP_VERIFY comes after the condition (OP_TRUE), so it should get a PositionHint.END
+// !true --> the OP_NOT comes after the condition (OP_TRUE), so it should get a PositionHint.END
+// if (true) { ... } --> the OP_IF comes before the body, so it should get a PositionHint.START,
+//                       the OP_ENDIF comes after the body, so it should get a PositionHint.END
 export enum PositionHint {
   START = 0,
   END = 1,

From d516a69fd2babe05f8d71850b59c3f2cfae2b4d5 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 5 Sep 2024 15:26:46 +0200
Subject: [PATCH 109/267] Make positionHint mandatory and update fixtures

---
 .../src/generation/GenerateTargetTraversal.ts | 37 ++++++++++---------
 .../cashscript/test/fixture/announcement.json |  6 +--
 packages/cashscript/test/fixture/bigint.json  |  4 +-
 .../test/fixture/bounded_bytes.json           |  4 +-
 .../cashscript/test/fixture/hodl_vault.json   |  4 +-
 packages/cashscript/test/fixture/mecenas.json |  6 +--
 .../cashscript/test/fixture/p2palindrome.json |  6 +--
 packages/cashscript/test/fixture/p2pkh.json   |  4 +-
 .../test/fixture/simple_covenant.json         |  6 +--
 .../fixture/token_category_comparison.json    |  6 +--
 .../test/fixture/transfer_with_timeout.json   |  4 +-
 packages/utils/src/source-map.ts              |  6 +--
 packages/utils/src/types.ts                   |  2 +-
 13 files changed, 48 insertions(+), 47 deletions(-)

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index cd5497e2..8e38541d 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -141,7 +141,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     } else {
       this.pushToStack('$$', true);
       node.functions = node.functions.map((f, i) => {
-        const locationData = { location: f.location };
+        const locationData = { location: f.location, positionHint: PositionHint.START };
 
         const stackCopy = [...this.stack];
         const selectorIndex = this.getStackIndex('$$');
@@ -154,10 +154,10 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
           this.emit(Op.OP_PICK, locationData);
         }
 
-        // All functions are if-else statements, except the final one which is
-        // enforced with NUMEQUALVERIFY
+        // All functions are if-else statements, except the final one which is enforced with NUMEQUALVERIFY
         this.emit(encodeInt(BigInt(i)), locationData);
         this.emit(Op.OP_NUMEQUAL, locationData);
+
         if (i < node.functions.length - 1) {
           this.emit(Op.OP_IF, locationData);
         } else {
@@ -173,6 +173,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
         this.stack = [...stackCopy];
         return f;
       });
+
       for (let i = 0; i < node.functions.length - 1; i += 1) {
         this.emit(Op.OP_ENDIF, { location: node.location, positionHint: PositionHint.END });
       }
@@ -349,14 +350,14 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     this.popFromStack();
 
     this.scopeDepth += 1;
-    this.emit(Op.OP_IF, { location: node.ifBlock.location });
+    this.emit(Op.OP_IF, { location: node.ifBlock.location, positionHint: PositionHint.START });
 
     let stackDepth = this.stack.length;
     node.ifBlock = this.visit(node.ifBlock);
     this.removeScopedVariables(stackDepth, node.ifBlock);
 
     if (node.elseBlock) {
-      this.emit(Op.OP_ELSE, { location: node.elseBlock.location });
+      this.emit(Op.OP_ELSE, { location: node.elseBlock.location, positionHint: PositionHint.START });
       stackDepth = this.stack.length;
       node.elseBlock = this.visit(node.elseBlock);
       this.removeScopedVariables(stackDepth, node.elseBlock);
@@ -418,7 +419,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   }
 
   visitMultiSig(node: FunctionCallNode): Node {
-    this.emit(encodeBool(false), { location: node.location });
+    this.emit(encodeBool(false), { location: node.location, positionHint: PositionHint.START });
     this.pushToStack('(value)');
     node.parameters = this.visitList(node.parameters);
     this.emit(Op.OP_CHECKMULTISIG, { location: node.location, positionHint: PositionHint.END });
@@ -434,7 +435,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
     if (node.identifier.name === Class.LOCKING_BYTECODE_P2PKH) {
       // OP_DUP OP_HASH160 OP_PUSH<20>
-      this.emit(hexToBin('76a914'), { location: node.location });
+      this.emit(hexToBin('76a914'), { location: node.location, positionHint: PositionHint.START });
       this.pushToStack('(value)');
       // <pkh>
       this.visit(node.parameters[0]);
@@ -445,7 +446,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
       this.popFromStack(2);
     } else if (node.identifier.name === Class.LOCKING_BYTECODE_P2SH20) {
       // OP_HASH160 OP_PUSH<20>
-      this.emit(hexToBin('a914'), { location: node.location });
+      this.emit(hexToBin('a914'), { location: node.location, positionHint: PositionHint.START });
       this.pushToStack('(value)');
       // <script hash>
       this.visit(node.parameters[0]);
@@ -456,7 +457,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
       this.popFromStack(2);
     } else if (node.identifier.name === Class.LOCKING_BYTECODE_P2SH32) {
       // OP_HASH256 OP_PUSH<32>
-      this.emit(hexToBin('aa20'), { location: node.location });
+      this.emit(hexToBin('aa20'), { location: node.location, positionHint: PositionHint.START });
       this.pushToStack('(value)');
       // <script hash>
       this.visit(node.parameters[0]);
@@ -468,7 +469,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     } else if (node.identifier.name === Class.LOCKING_BYTECODE_NULLDATA) {
       // Total script = OP_RETURN (<VarInt> <chunk>)+
       // OP_RETURN
-      this.emit(hexToBin('6a'), { location: node.location });
+      this.emit(hexToBin('6a'), { location: node.location, positionHint: PositionHint.START });
       this.pushToStack('(value)');
       const { elements } = node.parameters[0] as ArrayNode;
       // <VarInt data chunk size (dynamic)>
@@ -550,7 +551,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   }
 
   visitNullaryOp(node: NullaryOpNode): Node {
-    this.emit(compileNullaryOp(node.operator), { location: node.location });
+    this.emit(compileNullaryOp(node.operator), { location: node.location, positionHint: PositionHint.START });
     this.pushToStack('(value)');
     return node;
   }
@@ -564,7 +565,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
   visitIdentifier(node: IdentifierNode): Node {
     const stackIndex = this.getStackIndex(node.name);
-    this.emit(encodeInt(BigInt(stackIndex)), { location: node.location });
+    this.emit(encodeInt(BigInt(stackIndex)), { location: node.location, positionHint: PositionHint.START });
 
     // If the final use is inside an if-statement, we still OP_PICK it
     // We do this so that there's no difference in stack depths between execution paths
@@ -576,10 +577,10 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
         ip: this.getMostRecentInstructionPointer(),
       };
 
-      this.emit(Op.OP_ROLL, { location: node.location });
+      this.emit(Op.OP_ROLL, { location: node.location, positionHint: PositionHint.START });
       this.removeFromStack(stackIndex);
     } else {
-      this.emit(Op.OP_PICK, { location: node.location });
+      this.emit(Op.OP_PICK, { location: node.location, positionHint: PositionHint.START });
     }
 
     this.pushToStack('(value)');
@@ -591,25 +592,25 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
   }
 
   visitBoolLiteral(node: BoolLiteralNode): Node {
-    this.emit(encodeBool(node.value), { location: node.location });
+    this.emit(encodeBool(node.value), { location: node.location, positionHint: PositionHint.START });
     this.pushToStack('(value)');
     return node;
   }
 
   visitIntLiteral(node: IntLiteralNode): Node {
-    this.emit(encodeInt(node.value), { location: node.location });
+    this.emit(encodeInt(node.value), { location: node.location, positionHint: PositionHint.START });
     this.pushToStack('(value)');
     return node;
   }
 
   visitStringLiteral(node: StringLiteralNode): Node {
-    this.emit(encodeString(node.value), { location: node.location });
+    this.emit(encodeString(node.value), { location: node.location, positionHint: PositionHint.START });
     this.pushToStack('(value)');
     return node;
   }
 
   visitHexLiteral(node: HexLiteralNode): Node {
-    this.emit(node.value, { location: node.location });
+    this.emit(node.value, { location: node.location, positionHint: PositionHint.START });
     this.pushToStack('(value)');
     return node;
   }
diff --git a/packages/cashscript/test/fixture/announcement.json b/packages/cashscript/test/fixture/announcement.json
index 55611351..39c9e255 100644
--- a/packages/cashscript/test/fixture/announcement.json
+++ b/packages/cashscript/test/fixture/announcement.json
@@ -11,7 +11,7 @@
   "source": "pragma cashscript >=0.8.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an \"announcement\" on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes('A contract may not injure a human being or, through inaction, allow a human being to come to harm.')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there's enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n",
   "debug": {
     "bytecode": "016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009c6900cd517a876902e803c0c65179940079527aa26351cdc0c7876951cc51799c69685177",
-    "sourceMap": "10:29:13:10;11:12:11:18;;;;;12:18:12:118;:12::119;;;;;;;;;;;;16:27:16:28;:16::35;:39::40;:16:::1;:8::42;17:27:17:28:0;:16::45;:49::61;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65;:68::76;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49;:63::84;:53::101;:20:::1;:12::103;25:31:25:32:0;:20::39;:43::55;;:20:::1;:12::57;23:38:26:9;8:4:27:5;",
+    "sourceMap": "10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:16:::1;:8::42;17:27:17:28:0;:16::45:1;:49::61:0;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;;:20:::1;:12::57;23:38:26:9;8:4:27:5;",
     "logs": [],
     "requires": [
       {
@@ -34,7 +34,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:16.154Z"
+  "updatedAt": "2024-09-05T13:25:22.357Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index d55eaebf..3313e9bb 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -35,7 +35,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:15.899Z"
+  "updatedAt": "2024-09-05T13:25:22.095Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index a182d87a..7f4a9550 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -31,7 +31,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:10.912Z"
+  "updatedAt": "2024-09-05T13:25:23.083Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index a3ab0568..8937fdea 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -68,7 +68,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:16.379Z"
+  "updatedAt": "2024-09-05T13:25:22.594Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index 8f162076..916d7620 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -37,7 +37,7 @@
   "source": "pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(tx.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
     "bytecode": "5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768",
-    "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1",
+    "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1",
     "logs": [],
     "requires": [
       {
@@ -72,7 +72,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:12.107Z"
+  "updatedAt": "2024-09-05T13:25:24.222Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index 017131c3..67c2b49c 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -16,7 +16,7 @@
   "source": "contract P2Palindrome() {\n    function spend(string palindrome) {\n        require(palindrome.reverse() == palindrome);\n    }\n}\n",
   "debug": {
     "bytecode": "0079bc517a87",
-    "sourceMap": "3:16:3:26;;:::36;:40::50;;:16:::1",
+    "sourceMap": "3:16:3:26;;:::36:1;:40::50:0;;:16:::1",
     "logs": [],
     "requires": [
       {
@@ -27,7 +27,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:16.592Z"
+  "updatedAt": "2024-09-05T13:25:22.851Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index 9ee43904..35574b7a 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -40,7 +40,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:11.867Z"
+  "updatedAt": "2024-09-05T13:25:23.980Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/simple_covenant.json b/packages/cashscript/test/fixture/simple_covenant.json
index 3c4d8bf8..0573f08d 100644
--- a/packages/cashscript/test/fixture/simple_covenant.json
+++ b/packages/cashscript/test/fixture/simple_covenant.json
@@ -11,7 +11,7 @@
   "source": "contract Covenant() {\n    function spend() {\n        require(tx.version >= 2);\n        require(tx.inputs.length >= 1);\n        require(tx.outputs.length >= 1);\n        require(this.activeBytecode.length < 520);\n        require(tx.inputs[0].value >= 546);\n        require(tx.outputs[0].value >= 546);\n    }\n}\n",
   "debug": {
     "bytecode": "c252a269c351a269c451a269c182770208029f6900c6022202a26900cc022202a2",
-    "sourceMap": "3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:32:0;:36::37;:16:::1;:8::39;5:16:5:33:0;:37::38;:16:::1;:8::40;6:16:6:35:0;:::42;;:45::48;:16:::1;:8::50;7:26:7:27:0;:16::34;:38::41;:16:::1;:8::43;8:27:8:28:0;:16::35;:39::42;:16:::1",
+    "sourceMap": "3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:32:0;:36::37;:16:::1;:8::39;5:16:5:33:0;:37::38;:16:::1;:8::40;6:16:6:35:0;:::42:1;;:45::48:0;:16:::1;:8::50;7:26:7:27:0;:16::34:1;:38::41:0;:16:::1;:8::43;8:27:8:28:0;:16::35:1;:39::42:0;:16:::1",
     "logs": [],
     "requires": [
       {
@@ -42,7 +42,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:11.138Z"
+  "updatedAt": "2024-09-05T13:25:23.302Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/token_category_comparison.json b/packages/cashscript/test/fixture/token_category_comparison.json
index 2c4460e7..28b9b243 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.json
+++ b/packages/cashscript/test/fixture/token_category_comparison.json
@@ -11,7 +11,7 @@
   "source": "contract Test() {\n    function send() {\n        require(tx.inputs[1].tokenCategory == 0x);\n    }\n}\n",
   "debug": {
     "bytecode": "51ce0087",
-    "sourceMap": "3:26:3:27;:16::42;:46::48;:16:::1",
+    "sourceMap": "3:26:3:27;:16::42:1;:46::48:0;:16:::1",
     "logs": [],
     "requires": [
       {
@@ -22,7 +22,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:11.613Z"
+  "updatedAt": "2024-09-05T13:25:23.764Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index 4de9b0a9..6064fd4f 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -57,7 +57,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.5"
+    "version": "0.10.0-next.6"
   },
-  "updatedAt": "2024-06-25T09:01:11.370Z"
+  "updatedAt": "2024-09-05T13:25:23.528Z"
 }
\ No newline at end of file
diff --git a/packages/utils/src/source-map.ts b/packages/utils/src/source-map.ts
index e1d7dda5..db7ab5a3 100644
--- a/packages/utils/src/source-map.ts
+++ b/packages/utils/src/source-map.ts
@@ -84,7 +84,7 @@ export const sourceMapToLocationData = (sourceMap: string): FullLocationData =>
   let prevStartColumn = 0;
   let prevEndLine = 0;
   let prevEndColumn = 0;
-  let prevHint: PositionHint | undefined;
+  let prevHint: PositionHint = PositionHint.START;
 
   return sourceMap.split(';').map((entry: string) => {
     const [startLineStr, startColumnStr, endLineStr, endColumnStr, positionHintStr] = entry.split(':');
@@ -101,7 +101,7 @@ export const sourceMapToLocationData = (sourceMap: string): FullLocationData =>
     const endColumn = endColumnStr ? Number(endColumnStr) : prevEndColumn;
     prevEndColumn = endColumn;
 
-    const hint: PositionHint | undefined = parsePositionHint(positionHintStr) ?? prevHint;
+    const hint: PositionHint = parsePositionHint(positionHintStr) ?? prevHint;
     prevHint = hint;
 
     return {
@@ -109,7 +109,7 @@ export const sourceMapToLocationData = (sourceMap: string): FullLocationData =>
         start: { line: startLine, column: startColumn },
         end: { line: endLine, column: endColumn },
       },
-      ...(hint ? { positionHint: hint } : {}),
+      positionHint: hint,
     };
   });
 };
diff --git a/packages/utils/src/types.ts b/packages/utils/src/types.ts
index 7eb3199b..7b68e923 100644
--- a/packages/utils/src/types.ts
+++ b/packages/utils/src/types.ts
@@ -199,7 +199,7 @@ export interface LocationI {
 
 export type SingleLocationData = {
   location: LocationI;
-  positionHint?: PositionHint;
+  positionHint: PositionHint;
 };
 
 export type FullLocationData = Array<SingleLocationData>;

From d8bfa2becd0d418d671fbebf53b237d1ecd8e6db Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 5 Sep 2024 15:37:39 +0200
Subject: [PATCH 110/267] Separate out ConstructorArgument and FunctionArgument
 (breaking)

---
 packages/cashscript/src/Argument.ts        | 22 ++++++++++++----------
 packages/cashscript/src/Contract.ts        | 14 +++++++-------
 packages/cashscript/src/LibauthTemplate.ts | 20 ++++++++++----------
 packages/cashscript/src/Transaction.ts     |  4 ++--
 packages/cashscript/src/index.ts           |  8 +++++++-
 website/docs/sdk/instantiation.md          |  8 ++++----
 6 files changed, 42 insertions(+), 34 deletions(-)

diff --git a/packages/cashscript/src/Argument.ts b/packages/cashscript/src/Argument.ts
index 7a772dd1..915fe84d 100644
--- a/packages/cashscript/src/Argument.ts
+++ b/packages/cashscript/src/Argument.ts
@@ -12,13 +12,15 @@ import {
 import { TypeError } from './Errors.js';
 import SignatureTemplate from './SignatureTemplate.js';
 
-// TODO: Separate ConstructorArgument (no SignatureTemplate) and FunctionArgument (with SignatureTemplate)
-export type Argument = bigint | boolean | string | Uint8Array | SignatureTemplate;
-export type EncodedArgument = Uint8Array | SignatureTemplate;
+export type ConstructorArgument = bigint | boolean | string | Uint8Array;
+export type FunctionArgument = ConstructorArgument | SignatureTemplate;
 
-export type EncodeFunction = (arg: Argument, typeStr: string) => EncodedArgument;
+export type EncodedConstructorArgument = Uint8Array;
+export type EncodedFunctionArgument = Uint8Array | SignatureTemplate;
 
-export function encodeArgument(argument: Argument, typeStr: string): EncodedArgument {
+export type EncodeFunction = (arg: FunctionArgument, typeStr: string) => EncodedFunctionArgument;
+
+export function encodeFunctionArgument(argument: FunctionArgument, typeStr: string): EncodedFunctionArgument {
   let type = parseType(typeStr);
 
   if (type === PrimitiveType.BOOL) {
@@ -79,8 +81,8 @@ export function encodeArgument(argument: Argument, typeStr: string): EncodedArgu
 
 export const encodeConstructorArguments = (
   artifact: Artifact,
-  constructorArgs: Argument[],
-  encodeFunction: EncodeFunction = encodeArgument,
+  constructorArgs: ConstructorArgument[],
+  encodeFunction: EncodeFunction = encodeFunctionArgument,
 ): Uint8Array[] => {
   // Check there's no signature templates in the constructor
   if (constructorArgs.some((arg) => arg instanceof SignatureTemplate)) {
@@ -95,9 +97,9 @@ export const encodeConstructorArguments = (
 
 export const encodeFunctionArguments = (
   abiFunction: AbiFunction,
-  functionArgs: Argument[],
-  encodeFunction: EncodeFunction = encodeArgument,
-): EncodedArgument[] => {
+  functionArgs: FunctionArgument[],
+  encodeFunction: EncodeFunction = encodeFunctionArgument,
+): EncodedFunctionArgument[] => {
   const encodedArgs = functionArgs.map((arg, i) => encodeFunction(arg, abiFunction.inputs[i].type));
 
   return encodedArgs;
diff --git a/packages/cashscript/src/Contract.ts b/packages/cashscript/src/Contract.ts
index c6123abc..b6334963 100644
--- a/packages/cashscript/src/Contract.ts
+++ b/packages/cashscript/src/Contract.ts
@@ -11,7 +11,7 @@ import {
   scriptToBytecode,
 } from '@cashscript/utils';
 import { Transaction } from './Transaction.js';
-import { Argument, encodeArgument, encodeConstructorArguments, encodeFunctionArguments } from './Argument.js';
+import { ConstructorArgument, encodeFunctionArgument, encodeConstructorArguments, encodeFunctionArguments, FunctionArgument } from './Argument.js';
 import {
   Unlocker, ContractOptions, GenerateUnlockingBytecodeOptions, Utxo,
   AddressType,
@@ -41,7 +41,7 @@ export class Contract {
 
   constructor(
     public artifact: Artifact,
-    constructorArgs: Argument[],
+    constructorArgs: ConstructorArgument[],
     private options?: ContractOptions,
   ) {
     this.provider = this.options?.provider ?? new ElectrumNetworkProvider();
@@ -103,7 +103,7 @@ export class Contract {
   }
 
   private createFunction(abiFunction: AbiFunction, selector?: number): ContractFunction {
-    return (...args: Argument[]) => {
+    return (...args: FunctionArgument[]) => {
       if (abiFunction.inputs.length !== args.length) {
         throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}. Expected ${abiFunction.inputs.length} arguments (${abiFunction.inputs.map(input => input.type)}) but got ${args.length}`);
       }
@@ -124,7 +124,7 @@ export class Contract {
   }
 
   private createUnlocker(abiFunction: AbiFunction, selector?: number): ContractUnlocker {
-    return (...args: Argument[]) => {
+    return (...args: FunctionArgument[]) => {
       if (abiFunction.inputs.length !== args.length) {
         throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}. Expected ${abiFunction.inputs.length} arguments (${abiFunction.inputs.map(input => input.type)}) but got ${args.length}`);
       }
@@ -132,7 +132,7 @@ export class Contract {
       const bytecode = scriptToBytecode(this.redeemScript);
 
       const encodedArgs = args
-        .map((arg, i) => encodeArgument(arg, abiFunction.inputs[i].type));
+        .map((arg, i) => encodeFunctionArgument(arg, abiFunction.inputs[i].type));
 
       const generateUnlockingBytecode = (
         { transaction, sourceOutputs, inputIndex }: GenerateUnlockingBytecodeOptions,
@@ -169,5 +169,5 @@ export class Contract {
   }
 }
 
-export type ContractFunction = (...args: Argument[]) => Transaction;
-export type ContractUnlocker = (...args: Argument[]) => Unlocker;
+export type ContractFunction = (...args: FunctionArgument[]) => Transaction;
+export type ContractUnlocker = (...args: FunctionArgument[]) => Unlocker;
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index c535a894..eb89c221 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -37,7 +37,7 @@ import {
 } from './interfaces.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
-import { EncodedArgument } from './Argument.js';
+import { EncodedConstructorArgument, EncodedFunctionArgument } from './Argument.js';
 import { addressToLockScript, extendedStringify, snakeCase, zip } from './utils.js';
 import { Contract } from './Contract.js';
 
@@ -181,8 +181,8 @@ const generateTemplateScripts = (
   artifact: Artifact,
   addressType: AddressType,
   abiFunction: AbiFunction,
-  encodedFunctionArgs: EncodedArgument[],
-  encodedConstructorArgs: EncodedArgument[],
+  encodedFunctionArgs: EncodedFunctionArgument[],
+  encodedConstructorArgs: EncodedConstructorArgument[],
 ): WalletTemplate['scripts'] => {
   // definition of locking scripts and unlocking scripts with their respective bytecode
   return {
@@ -194,7 +194,7 @@ const generateTemplateScripts = (
 const generateTemplateLockScript = (
   artifact: Artifact,
   addressType: AddressType,
-  constructorArguments: EncodedArgument[],
+  constructorArguments: EncodedFunctionArgument[],
 ): WalletTemplateScriptLocking => {
   return {
     lockingType: addressType,
@@ -212,7 +212,7 @@ const generateTemplateLockScript = (
 const generateTemplateUnlockScript = (
   artifact: Artifact,
   abiFunction: AbiFunction,
-  encodedFunctionArgs: EncodedArgument[],
+  encodedFunctionArgs: EncodedFunctionArgument[],
 ): WalletTemplateScriptUnlocking => {
   const functionIndex = artifact.abi.findIndex((func) => func.name === abiFunction.name);
 
@@ -240,8 +240,8 @@ const generateTemplateScenarios = (
   transactionHex: string,
   artifact: Artifact,
   abiFunction: AbiFunction,
-  encodedFunctionArgs: EncodedArgument[],
-  encodedConstructorArgs: EncodedArgument[],
+  encodedFunctionArgs: EncodedFunctionArgument[],
+  encodedConstructorArgs: EncodedConstructorArgument[],
 ): WalletTemplate['scenarios'] => {
   const libauthTransaction = decodeTransaction(hexToBin(transactionHex));
   if (typeof libauthTransaction === 'string') throw Error(libauthTransaction);
@@ -358,7 +358,7 @@ const generateTemplateScenarioBytecode = (
 
 const generateTemplateScenarioParametersValues = (
   types: AbiInput[],
-  encodedArgs: EncodedArgument[],
+  encodedArgs: EncodedFunctionArgument[],
 ): Record<string, string> => {
   const typesAndArguments = zip(types, encodedArgs);
 
@@ -376,7 +376,7 @@ const generateTemplateScenarioParametersValues = (
 
 const generateTemplateScenarioKeys = (
   types: AbiInput[],
-  encodedArgs: EncodedArgument[],
+  encodedArgs: EncodedFunctionArgument[],
 ): Record<string, string> => {
   const typesAndArguments = zip(types, encodedArgs);
 
@@ -387,7 +387,7 @@ const generateTemplateScenarioKeys = (
   return Object.fromEntries(entries);
 };
 
-const formatParametersForDebugging = (types: AbiInput[], args: EncodedArgument[]): string => {
+const formatParametersForDebugging = (types: AbiInput[], args: EncodedFunctionArgument[]): string => {
   if (types.length === 0) return '// none';
 
   // We reverse the arguments because the order of the arguments in the bytecode is reversed
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 9df57c86..11a9e60a 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -40,7 +40,7 @@ import { TransactionBuilder } from './TransactionBuilder.js';
 import { Contract } from './Contract.js';
 import { buildTemplate, getBitauthUri } from './LibauthTemplate.js';
 import { debugTemplate, DebugResult } from './debugging.js';
-import { EncodedArgument } from './Argument.js';
+import { EncodedFunctionArgument } from './Argument.js';
 import { FailedTransactionError } from './Errors.js';
 
 export class Transaction {
@@ -58,7 +58,7 @@ export class Transaction {
     public contract: Contract,
     private unlocker: Unlocker,
     public abiFunction: AbiFunction,
-    public encodedFunctionArgs: EncodedArgument[],
+    public encodedFunctionArgs: EncodedFunctionArgument[],
     private selector?: number,
   ) {}
 
diff --git a/packages/cashscript/src/index.ts b/packages/cashscript/src/index.ts
index 4b9d2228..53c364bb 100644
--- a/packages/cashscript/src/index.ts
+++ b/packages/cashscript/src/index.ts
@@ -2,7 +2,13 @@ export { default as SignatureTemplate } from './SignatureTemplate.js';
 export { Contract, type ContractFunction } from './Contract.js';
 export { Transaction } from './Transaction.js';
 export { TransactionBuilder } from './TransactionBuilder.js';
-export { type Argument, encodeArgument } from './Argument.js';
+export {
+  type ConstructorArgument,
+  type FunctionArgument,
+  type EncodedConstructorArgument,
+  type EncodedFunctionArgument,
+  encodeFunctionArgument,
+} from './Argument.js';
 export type { Artifact, AbiFunction, AbiInput } from '@cashscript/utils';
 export * as utils from '@cashscript/utils';
 export * from './interfaces.js';
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 87f54c2a..7522f7ef 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -5,7 +5,7 @@ title: Contract Instantiation
 Before interacting with a smart contract on the BCH network, the CashScript SDK needs to instantiate a `Contract` object. This is done by providing the contract's information and constructor arguments. After this instantiation, the CashScript SDK can interact with the BCH contract.
 
 :::info
-CashScript offers a TypeScript SDK, which can also be used easily in vanilla JavaScript codebases. 
+CashScript offers a TypeScript SDK, which can also be used easily in vanilla JavaScript codebases.
 Because of the separation of the compiler and the SDK, CashScript contracts can be integrated into other languages in the future.
 :::
 
@@ -16,7 +16,7 @@ The `Contract` class is used to represent a CashScript contract in a JavaScript
 ```ts
 new Contract(
   artifact: Artifact,
-  constructorArgs: Argument[],
+  constructorArgs: ConstructorArgument[],
   options? : {
     provider: NetworkProvider,
     addressType: 'p2sh20' | 'p2sh32',
@@ -153,7 +153,7 @@ const utxos = await contract.getUtxos()
 
 ### Contract functions
 ```ts
-contract.functions.<functionName>(...args: Argument[]): Transaction
+contract.functions.<functionName>(...args: FunctionArgument[]): Transaction
 ```
 
 Once a smart contract has been instantiated, you can invoke a contract function to spend from the contract with the '[Simple transaction-builder](/docs/sdk/transactions)' by calling the function name under the `functions` member field of a contract object.
@@ -174,7 +174,7 @@ const tx = await contract.functions
 ### Contract unlockers
 
 ```ts
-contract.unlock.<functionName>(...args: Argument[]): Unlocker
+contract.unlock.<functionName>(...args: FunctionArgument[]): Unlocker
 ```
 
 Once a smart contract has been instantiated, you can invoke a contract function on a smart contract UTXO to use the '[Advanced transaction-builder](/docs/sdk/transactions-advanced)' by calling the function name under the `unlock` member field of a contract object.

From f4e2a3e1303dd8a4cc4debacc4e5d0ba371f050f Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 5 Sep 2024 15:46:27 +0200
Subject: [PATCH 111/267] Remove NodeErrorReason (breaking)

---
 packages/cashscript/src/Errors.ts             | 50 -----------------
 .../cashscript/test/e2e/FullStack.test.ts     |  4 +-
 .../cashscript/test/e2e/old/Mecenas.test.ts   |  8 +--
 website/docs/sdk/transactions.md              | 55 +------------------
 4 files changed, 8 insertions(+), 109 deletions(-)

diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index 1db1c420..616c1520 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -103,53 +103,3 @@ const getLocationDataForInstructionPointer = (
 
   return { statement, lineNumber };
 };
-
-// TODO: Expand these reasons with non-script failures (like tx-mempool-conflict)
-export enum NodeErrorReason {
-  EVAL_FALSE = 'Script evaluated without error but finished with a false/empty top stack element',
-  VERIFY = 'Script failed an OP_VERIFY operation',
-  EQUALVERIFY = 'Script failed an OP_EQUALVERIFY operation',
-  CHECKMULTISIGVERIFY = 'Script failed an OP_CHECKMULTISIGVERIFY operation',
-  CHECKSIGVERIFY = 'Script failed an OP_CHECKSIGVERIFY operation',
-  CHECKDATASIGVERIFY = 'Script failed an OP_CHECKDATASIGVERIFY operation',
-  NUMEQUALVERIFY = 'Script failed an OP_NUMEQUALVERIFY operation',
-  SCRIPT_SIZE = 'Script is too big',
-  PUSH_SIZE = 'Push value size limit exceeded',
-  OP_COUNT = 'Operation limit exceeded',
-  STACK_SIZE = 'Stack size limit exceeded',
-  SIG_COUNT = 'Signature count negative or greater than pubkey count',
-  PUBKEY_COUNT = 'Pubkey count negative or limit exceeded',
-  INVALID_OPERAND_SIZE = 'Invalid operand size',
-  INVALID_NUMBER_RANGE = 'Given operand is not a number within the valid range',
-  IMPOSSIBLE_ENCODING = 'The requested encoding is impossible to satisfy',
-  INVALID_SPLIT_RANGE = 'Invalid OP_SPLIT range',
-  INVALID_BIT_COUNT = 'Invalid number of bit set in OP_CHECKMULTISIG',
-  BAD_OPCODE = 'Opcode missing or not understood',
-  DISABLED_OPCODE = 'Attempted to use a disabled opcode',
-  INVALID_STACK_OPERATION = 'Operation not valid with the current stack size',
-  INVALID_ALTSTACK_OPERATION = 'Operation not valid with the current altstack size',
-  OP_RETURN = 'OP_RETURN was encountered',
-  UNBALANCED_CONDITIONAL = 'Invalid OP_IF construction',
-  DIV_BY_ZERO = 'Division by zero error',
-  MOD_BY_ZERO = 'Modulo by zero error',
-  INVALID_BITFIELD_SIZE = 'Bitfield of unexpected size error',
-  INVALID_BIT_RANGE = 'Bitfield\'s bit out of the expected range',
-  NEGATIVE_LOCKTIME = 'Negative locktime',
-  UNSATISFIED_LOCKTIME = 'Locktime requirement not satisfied',
-  SIG_HASHTYPE = 'Signature hash type missing or not understood',
-  SIG_DER = 'Non-canonical DER signature',
-  MINIMALDATA = 'Data push larger than necessary',
-  SIG_PUSHONLY = 'Only push operators allowed in signature scripts',
-  SIG_HIGH_S = 'Non-canonical signature: S value is unnecessarily high',
-  MINIMALIF = 'OP_IF/NOTIF argument must be minimal',
-  SIG_NULLFAIL = 'Signature must be zero for failed CHECK(MULTI)SIG operation',
-  SIG_BADLENGTH = 'Signature cannot be 65 bytes in CHECKMULTISIG',
-  SIG_NONSCHNORR = 'Only Schnorr signatures allowed in this operation',
-  DISCOURAGE_UPGRADABLE_NOPS = 'NOPx reserved for soft-fork upgrades',
-  PUBKEYTYPE = 'Public key is neither compressed or uncompressed',
-  CLEANSTACK = 'Script did not clean its stack',
-  NONCOMPRESSED_PUBKEY = 'Using non-compressed public key',
-  ILLEGAL_FORKID = 'Illegal use of SIGHASH_FORKID',
-  MUST_USE_FORKID = 'Signature must use SIGHASH_FORKID',
-  UNKNOWN = 'unknown error',
-}
diff --git a/packages/cashscript/test/e2e/FullStack.test.ts b/packages/cashscript/test/e2e/FullStack.test.ts
index 7ad62ba8..e4c576a0 100644
--- a/packages/cashscript/test/e2e/FullStack.test.ts
+++ b/packages/cashscript/test/e2e/FullStack.test.ts
@@ -7,7 +7,7 @@ import {
   bobPub,
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
-import { FailedRequireError, NodeErrorReason } from '../../src/Errors.js';
+import { FailedRequireError } from '../../src/Errors.js';
 import artifact from '../fixture/p2pkh.json' assert { type: 'json' };
 
 describe.skip('P2PKH (using FullStackNetworkProvider)', () => {
@@ -34,7 +34,7 @@ describe.skip('P2PKH (using FullStackNetworkProvider)', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow(NodeErrorReason.SIG_NULLFAIL);
+      await expect(txPromise).rejects.toThrow('Signature must be zero for failed CHECK(MULTI)SIG operation');
     });
 
     it('should succeed when using correct function arguments', async () => {
diff --git a/packages/cashscript/test/e2e/old/Mecenas.test.ts b/packages/cashscript/test/e2e/old/Mecenas.test.ts
index 24c159d4..4abf09eb 100644
--- a/packages/cashscript/test/e2e/old/Mecenas.test.ts
+++ b/packages/cashscript/test/e2e/old/Mecenas.test.ts
@@ -14,7 +14,7 @@ import {
   alicePriv,
 } from '../../fixture/vars.js';
 import { getTxOutputs } from '../../test-util.js';
-import { FailedTransactionError, NodeErrorReason } from '../../../src/Errors.js';
+import { FailedTransactionError } from '../../../src/Errors.js';
 import artifact from '../../fixture/old/mecenas.json' assert { type: 'json' };
 
 if (!process.env.TESTS_USE_MOCKNET) {
@@ -46,7 +46,7 @@ if (!process.env.TESTS_USE_MOCKNET) {
 
         // then
         await expect(txPromise).rejects.toThrow(FailedTransactionError);
-        await expect(txPromise).rejects.toThrow(NodeErrorReason.EQUALVERIFY);
+        await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
       });
 
       it('should fail when trying to send to wrong person', async () => {
@@ -63,7 +63,7 @@ if (!process.env.TESTS_USE_MOCKNET) {
 
         // then
         await expect(txPromise).rejects.toThrow(FailedTransactionError);
-        await expect(txPromise).rejects.toThrow(NodeErrorReason.EQUALVERIFY);
+        await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
       });
 
       it('should fail when trying to send to multiple people', async () => {
@@ -81,7 +81,7 @@ if (!process.env.TESTS_USE_MOCKNET) {
 
         // then
         await expect(txPromise).rejects.toThrow(FailedTransactionError);
-        await expect(txPromise).rejects.toThrow(NodeErrorReason.EQUALVERIFY);
+        await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
       });
 
       it('should succeed when sending pledge to receiver', async () => {
diff --git a/website/docs/sdk/transactions.md b/website/docs/sdk/transactions.md
index 4db1a075..bda4ae6a 100644
--- a/website/docs/sdk/transactions.md
+++ b/website/docs/sdk/transactions.md
@@ -263,7 +263,7 @@ TODO: Update this section with the new debugging experience
 
 ## Transaction errors
 
-When sending a transaction, the CashScript SDK will throw an error if the transaction fails. If you are using an artifact compiled with `cashc@0.10.0` or later, the error will be of the type `FailedRequireError` or `FailedTransactionError`. In case of a `FailedRequireError`, the error will refer to the corresponding `require` statement in the contract code so you know where your contract failed. If you want more information about the underlying error, you can check the `libauthErrorMessage` property of the error.
+When sending a transaction, the CashScript SDK will throw an error if the transaction fails. If you are using an artifact compiled with `cashc@0.10.0` or later, the error will be of the type `FailedRequireError` or `FailedTransactionEvaluationError`. In case of a `FailedRequireError`, the error will refer to the corresponding `require` statement in the contract code so you know where your contract failed. If you want more information about the underlying error, you can check the `libauthErrorMessage` property of the error.
 
 ```ts
 interface FailedRequireError {
@@ -276,58 +276,7 @@ interface FailedRequireError {
 }
 ```
 
-If you are using an artifact compiled with an older version of `cashc`, the error will always be of the type `FailedTransactionError`. In this case, you can use the `reason` property of the error to determine the reason for the failure. A list of possible reasons can be found in the `NodeErrorReason` enum below.
-
-```ts
-enum NodeErrorReason {
-  EVAL_FALSE = 'Script evaluated without error but finished with a false/empty top stack element',
-  VERIFY = 'Script failed an OP_VERIFY operation',
-  EQUALVERIFY = 'Script failed an OP_EQUALVERIFY operation',
-  CHECKMULTISIGVERIFY = 'Script failed an OP_CHECKMULTISIGVERIFY operation',
-  CHECKSIGVERIFY = 'Script failed an OP_CHECKSIGVERIFY operation',
-  CHECKDATASIGVERIFY = 'Script failed an OP_CHECKDATASIGVERIFY operation',
-  NUMEQUALVERIFY = 'Script failed an OP_NUMEQUALVERIFY operation',
-  SCRIPT_SIZE = 'Script is too big',
-  PUSH_SIZE = 'Push value size limit exceeded',
-  OP_COUNT = 'Operation limit exceeded',
-  STACK_SIZE = 'Stack size limit exceeded',
-  SIG_COUNT = 'Signature count negative or greater than pubkey count',
-  PUBKEY_COUNT = 'Pubkey count negative or limit exceeded',
-  INVALID_OPERAND_SIZE = 'Invalid operand size',
-  INVALID_NUMBER_RANGE = 'Given operand is not a number within the valid range',
-  IMPOSSIBLE_ENCODING = 'The requested encoding is impossible to satisfy',
-  INVALID_SPLIT_RANGE = 'Invalid OP_SPLIT range',
-  INVALID_BIT_COUNT = 'Invalid number of bit set in OP_CHECKMULTISIG',
-  BAD_OPCODE = 'Opcode missing or not understood',
-  DISABLED_OPCODE = 'Attempted to use a disabled opcode',
-  INVALID_STACK_OPERATION = 'Operation not valid with the current stack size',
-  INVALID_ALTSTACK_OPERATION = 'Operation not valid with the current altstack size',
-  OP_RETURN = 'OP_RETURN was encountered',
-  UNBALANCED_CONDITIONAL = 'Invalid OP_IF construction',
-  DIV_BY_ZERO = 'Division by zero error',
-  MOD_BY_ZERO = 'Modulo by zero error',
-  INVALID_BITFIELD_SIZE = 'Bitfield of unexpected size error',
-  INVALID_BIT_RANGE = 'Bitfield\'s bit out of the expected range',
-  NEGATIVE_LOCKTIME = 'Negative locktime',
-  UNSATISFIED_LOCKTIME = 'Locktime requirement not satisfied',
-  SIG_HASHTYPE = 'Signature hash type missing or not understood',
-  SIG_DER = 'Non-canonical DER signature',
-  MINIMALDATA = 'Data push larger than necessary',
-  SIG_PUSHONLY = 'Only push operators allowed in signature scripts',
-  SIG_HIGH_S = 'Non-canonical signature: S value is unnecessarily high',
-  MINIMALIF = 'OP_IF/NOTIF argument must be minimal',
-  SIG_NULLFAIL = 'Signature must be zero for failed CHECK(MULTI)SIG operation',
-  SIG_BADLENGTH = 'Signature cannot be 65 bytes in CHECKMULTISIG',
-  SIG_NONSCHNORR = 'Only Schnorr signatures allowed in this operation',
-  DISCOURAGE_UPGRADABLE_NOPS = 'NOPx reserved for soft-fork upgrades',
-  PUBKEYTYPE = 'Public key is neither compressed or uncompressed',
-  CLEANSTACK = 'Script did not clean its stack',
-  NONCOMPRESSED_PUBKEY = 'Using non-compressed public key',
-  ILLEGAL_FORKID = 'Illegal use of SIGHASH_FORKID',
-  MUST_USE_FORKID = 'Signature must use SIGHASH_FORKID',
-  UNKNOWN = 'unknown error',
-}
-```
+If you are using an artifact compiled with an older version of `cashc`, the error will always be of the type `FailedTransactionError`. In this case, you can use the `reason` property of the error to determine the reason for the failure.
 
 [fetch-api]: https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
 [bip68]: https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki

From 3022848621e663f89b5243c226577130d59211a9 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 5 Sep 2024 16:13:08 +0200
Subject: [PATCH 112/267] Support literal values for sig parameters in addition
 to SignatureTemplate

---
 packages/cashscript/src/LibauthTemplate.ts | 14 +++---
 packages/cashscript/test/debugging.test.ts | 51 +++++++++++++---------
 2 files changed, 39 insertions(+), 26 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index eb89c221..ed0b7901 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -2,7 +2,6 @@ import {
   AbiFunction,
   AbiInput,
   Artifact,
-  PrimitiveType,
   bytecodeToScript,
   formatBitAuthScript,
 } from '@cashscript/utils';
@@ -59,7 +58,7 @@ export const buildTemplate = async ({
     name: contract.artifact.contractName,
     supported: ['BCH_2023_05'],
     version: 0,
-    entities: generateTemplateEntities(contract.artifact, transaction.abiFunction),
+    entities: generateTemplateEntities(contract.artifact, transaction.abiFunction, transaction.encodedFunctionArgs),
     scripts: generateTemplateScripts(
       contract.artifact,
       contract.addressType,
@@ -127,14 +126,18 @@ export const getBitauthUri = (template: WalletTemplate): string => {
 };
 
 
-const generateTemplateEntities = (artifact: Artifact, abiFunction: AbiFunction): WalletTemplate['entities'] => {
+const generateTemplateEntities = (
+  artifact: Artifact,
+  abiFunction: AbiFunction,
+  encodedFunctionArgs: EncodedFunctionArgument[],
+): WalletTemplate['entities'] => {
   const functionParameters = Object.fromEntries<WalletTemplateVariable>(
-    abiFunction.inputs.map((input) => ([
+    abiFunction.inputs.map((input, index) => ([
       snakeCase(input.name),
       {
         description: `"${input.name}" parameter of function "${abiFunction.name}"`,
         name: input.name,
-        type: input.type === PrimitiveType.SIG ? 'Key' : 'WalletData',
+        type: encodedFunctionArgs[index] instanceof SignatureTemplate ? 'Key' : 'WalletData',
       },
     ])),
   );
@@ -269,7 +272,6 @@ const generateTemplateScenarios = (
     },
   };
 
-
   if (artifact.abi.length > 1) {
     const functionIndex = artifact.abi.findIndex((func) => func.name === transaction.abiFunction.name);
     scenarios!.evaluate_function!.data!.bytecode!.function_index = functionIndex.toString();
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 42d3c689..9e0e452a 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -51,7 +51,6 @@ contract Test() {
     if (switch == 1) {
       int a = 2;
       require(1 == a, "1 should equal 2");
-    // TODO: Check if it's better test with or without this else
     } else if (switch == 2) {
       int b = 3;
       require(1 == b, "1 should equal 3");
@@ -486,18 +485,24 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transactionIfBranch = contract.functions
-        .test_final_require_in_if_statement(1n).to(contract.address, 1000n);
+        .test_final_require_in_if_statement(1n)
+        .to(contract.address, 1000n);
+
       await expect(transactionIfBranch).toFailRequireWith('Test.cash:43 Require statement failed at input 0 in contract Test.cash at line 43 with the following message: 1 should equal 2.');
       await expect(transactionIfBranch).toFailRequireWith('Failing statement: require(1 == a, "1 should equal 2")');
 
       const transactionElseIfBranch = contract.functions
-        .test_final_require_in_if_statement(2n).to(contract.address, 1000n);
-      await expect(transactionElseIfBranch).toFailRequireWith('Test.cash:47 Require statement failed at input 0 in contract Test.cash at line 47 with the following message: 1 should equal 3.');
+        .test_final_require_in_if_statement(2n)
+        .to(contract.address, 1000n);
+
+      await expect(transactionElseIfBranch).toFailRequireWith('Test.cash:46 Require statement failed at input 0 in contract Test.cash at line 46 with the following message: 1 should equal 3.');
       await expect(transactionElseIfBranch).toFailRequireWith('Failing statement: require(1 == b, "1 should equal 3")');
 
       const transactionElseBranch = contract.functions
-        .test_final_require_in_if_statement(3n).to(contract.address, 1000n);
-      await expect(transactionElseBranch).toFailRequireWith('Test.cash:50 Require statement failed at input 0 in contract Test.cash at line 50 with the following message: switch should equal 4.');
+        .test_final_require_in_if_statement(3n)
+        .to(contract.address, 1000n);
+
+      await expect(transactionElseBranch).toFailRequireWith('Test.cash:49 Require statement failed at input 0 in contract Test.cash at line 49 with the following message: switch should equal 4.');
       await expect(transactionElseBranch).toFailRequireWith('Failing statement: require(switch == c, "switch should equal 4")');
     });
 
@@ -507,8 +512,10 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions
-        .test_final_require_in_if_statement_with_deep_reassignment().to(contract.address, 1000n);
-      await expect(transaction).toFailRequireWith('Test.cash:63 Require statement failed at input 0 in contract Test.cash at line 63 with the following message: sum should equal 10.');
+        .test_final_require_in_if_statement_with_deep_reassignment()
+        .to(contract.address, 1000n);
+
+      await expect(transaction).toFailRequireWith('Test.cash:62 Require statement failed at input 0 in contract Test.cash at line 62 with the following message: sum should equal 10.');
       await expect(transaction).toFailRequireWith('Failing statement: require(a + b + c + d + e == 10, "sum should equal 10")');
     });
 
@@ -518,14 +525,18 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const checkSigTransaction = contract.functions
-        .test_fail_checksig(new SignatureTemplate(alicePriv), bobPub).to(contract.address, 1000n);
-      await expect(checkSigTransaction).toFailRequireWith('Test.cash:78 Require statement failed at input 0 in contract Test.cash at line 78 with the following message: Signatures do not match.');
+        .test_fail_checksig(new SignatureTemplate(alicePriv), bobPub)
+        .to(contract.address, 1000n);
+
+      await expect(checkSigTransaction).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
       await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
 
-      // TODO: Add test for checksig with a NULL Signature (after we refactor Libauth Template generation)
-      // const checkSigTransactionNullSignature = contract.functions
-      //   .test_fail_checksig('', bobPub).to(contract.address, 1000n);
-      // await expect(checkSigTransactionNullSignature).toFailRequireWith(/Signatures do not match/);
+      const checkSigTransactionNullSignature = contract.functions
+        .test_fail_checksig(hexToBin(''), bobPub)
+        .to(contract.address, 1000n);
+
+      await expect(checkSigTransactionNullSignature).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
+      await expect(checkSigTransactionNullSignature).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
     });
 
     // test_fail_checksig_final_verify
@@ -535,7 +546,7 @@ describe('Debugging tests', () => {
 
       const checkSigTransaction = contract.functions
         .test_fail_checksig_final_verify(new SignatureTemplate(alicePriv), bobPub).to(contract.address, 1000n);
-      await expect(checkSigTransaction).toFailRequireWith('Test.cash:83 Require statement failed at input 0 in contract Test.cash at line 83 with the following message: Signatures do not match.');
+      await expect(checkSigTransaction).toFailRequireWith('Test.cash:82 Require statement failed at input 0 in contract Test.cash at line 82 with the following message: Signatures do not match.');
       await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
     });
 
@@ -547,13 +558,13 @@ describe('Debugging tests', () => {
       const checkDataSigTransaction = contract.functions
         .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xbeef')).slice(0, -1), '0xbeef', bobPub)
         .to(contract.address, 1000n);
-      await expect(checkDataSigTransaction).toFailRequireWith('Test.cash:87 Require statement failed at input 0 in contract Test.cash at line 87 with the following message: Data Signatures do not match.');
+      await expect(checkDataSigTransaction).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
       await expect(checkDataSigTransaction).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
 
       const checkDataSigTransactionWrongMessage = contract.functions
         .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xc0ffee')).slice(0, -1), '0xbeef', alicePub)
         .to(contract.address, 1000n);
-      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Test.cash:87 Require statement failed at input 0 in contract Test.cash at line 87 with the following message: Data Signatures do not match.');
+      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
       await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
     });
 
@@ -570,7 +581,7 @@ describe('Debugging tests', () => {
           alicePub,
         )
         .to(contract.address, 1000n);
-      await expect(checkmultiSigTransaction).toFailRequireWith('Test.cash:91 Require statement failed at input 0 in contract Test.cash at line 91 with the following message: Multi Signatures do not match.');
+      await expect(checkmultiSigTransaction).toFailRequireWith('Test.cash:90 Require statement failed at input 0 in contract Test.cash at line 90 with the following message: Multi Signatures do not match.');
       await expect(checkmultiSigTransaction).toFailRequireWith('Failing statement: require(checkMultiSig([s1, s2], [pk1, pk2]), "Multi Signatures do not match")');
     });
 
@@ -664,7 +675,7 @@ describe('Debugging tests', () => {
         .to(contract.address, 1000n)
         .debug();
 
-      await expect(transactionPromise).rejects.toThrow('Test.cash:69 Error in transaction at input 0 in contract Test.cash at line 69.');
+      await expect(transactionPromise).rejects.toThrow('Test.cash:68 Error in transaction at input 0 in contract Test.cash at line 68.');
       await expect(transactionPromise).rejects.toThrow('Failing statement: test.split(4)');
       await expect(transactionPromise).rejects.toThrow(`Reason: ${AuthenticationErrorCommon.invalidSplitIndex}`);
     });
@@ -678,7 +689,7 @@ describe('Debugging tests', () => {
         .to(contract.address, 1000n)
         .debug();
 
-      await expect(transactionPromise).rejects.toThrow('Test.cash:74 Error in transaction at input 0 in contract Test.cash at line 74.');
+      await expect(transactionPromise).rejects.toThrow('Test.cash:73 Error in transaction at input 0 in contract Test.cash at line 73.');
       await expect(transactionPromise).rejects.toThrow('Failing statement: tx.inputs[5].value');
       await expect(transactionPromise).rejects.toThrow(`Reason: ${AuthenticationErrorCommon.invalidTransactionUtxoIndex}`);
     });

From 9b1d858707b2db279c3030b7e488f453b99917ec Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 5 Sep 2024 16:22:36 +0200
Subject: [PATCH 113/267] Remove TODOs and move some of them to a GitHub issue

---
 packages/cashscript/src/Errors.ts                      | 2 --
 packages/cashscript/src/LibauthTemplate.ts             | 7 ++-----
 packages/cashscript/test/Contract.test.ts              | 2 --
 packages/cashscript/test/debugging.test.ts             | 2 --
 packages/utils/src/script.ts                           | 5 +----
 packages/utils/test/fixtures/bitauth-script.fixture.ts | 1 -
 website/docs/sdk/transactions.md                       | 2 --
 7 files changed, 3 insertions(+), 18 deletions(-)

diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index 616c1520..e2aae1db 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -25,7 +25,6 @@ export class NoDebugInformationInArtifactError extends Error {
 }
 
 export class FailedTransactionError extends Error {
-  // TODO: Make bitauthUri required once the advanced transaction builder supports debugging
   constructor(public reason: string, public bitauthUri?: string) {
     super(`${reason}${bitauthUri ? `\n\nBitauth URI: ${bitauthUri}` : ''}`);
   }
@@ -78,7 +77,6 @@ export class FailedRequireError extends FailedTransactionError {
   }
 }
 
-// TODO: Add tests and make sure it works for multiline statements
 const getLocationDataForInstructionPointer = (
   artifact: Artifact,
   instructionPointer: number,
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index ed0b7901..d7abb633 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -260,7 +260,6 @@ const generateTemplateScenarios = (
           ...generateTemplateScenarioParametersValues(abiFunction.inputs, encodedFunctionArgs),
           ...generateTemplateScenarioParametersValues(artifact.constructorInputs, encodedConstructorArgs),
         },
-        // TODO: Don't hardcode these values
         currentBlockHeight: 2,
         currentBlockTime: Math.round(+new Date() / 1000),
         keys: {
@@ -288,7 +287,7 @@ const generateTemplateScenarioTransaction = (
   const slotIndex = csTransaction.inputs.findIndex((input) => !isUtxoP2PKH(input));
 
   const inputs = libauthTransaction.inputs.map((input, index) => {
-    const csInput = csTransaction.inputs[index] as Utxo; // TODO: Improve code quality here (see zip in other places)
+    const csInput = csTransaction.inputs[index] as Utxo;
 
     return {
       outpointIndex: input.outpointIndex,
@@ -301,7 +300,7 @@ const generateTemplateScenarioTransaction = (
   const locktime = libauthTransaction.locktime;
 
   const outputs = libauthTransaction.outputs.map((output, index) => {
-    const csOutput = csTransaction.outputs[index]; // TODO: Improve code quality here (see zip in other places)
+    const csOutput = csTransaction.outputs[index];
 
     return {
       lockingBytecode: generateTemplateScenarioTransactionOutputLockingBytecode(csOutput, contract),
@@ -440,7 +439,6 @@ const getHashTypeName = (hashType: HashType): string => {
 
 const formatBytecodeForDebugging = (artifact: Artifact): string => {
   if (!artifact.debug) {
-    // TODO: See if we can merge this with code from @cashscript/utils -> script.ts
     return artifact.bytecode
       .split(' ')
       .map((asmElement) => (isHex(asmElement) ? `<0x${asmElement}>` : asmElement))
@@ -454,7 +452,6 @@ const formatBytecodeForDebugging = (artifact: Artifact): string => {
   );
 };
 
-// TODO: Maybe move / refactor
 const serialiseTokenDetails = (token?: TokenDetails | LibauthTokenDetails): LibauthTemplateTokenDetails | undefined => {
   if (!token) return undefined;
 
diff --git a/packages/cashscript/test/Contract.test.ts b/packages/cashscript/test/Contract.test.ts
index ad995a6e..2f1508e1 100644
--- a/packages/cashscript/test/Contract.test.ts
+++ b/packages/cashscript/test/Contract.test.ts
@@ -15,8 +15,6 @@ import hodlVaultArtifact from './fixture/hodl_vault.json' assert { type: 'json'
 import mecenasArtifact from './fixture/mecenas.json' assert { type: 'json' };
 import boundedBytesArtifact from './fixture/bounded_bytes.json' assert { type: 'json' };
 
-// This is failing due to limitations between Jest and bigint (https://github.com/facebook/jest/issues/11617)
-// TODO: Fix this somehow by changing the test, or move away from Jest
 describe('Contract', () => {
   describe('new', () => {
     it('should fail with incorrect constructor args', () => {
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 9e0e452a..ffabec2e 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -450,7 +450,6 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.test_require_no_failure().to(contract.address, 1000n);
-      // TODO: add `toFailRequire` without any arguments to JestExtensions
       await expect(transaction).not.toFailRequireWith(/.*/);
     });
 
@@ -784,7 +783,6 @@ describe('Debugging tests', () => {
       ).rejects.toThrow(/Expected pattern: .*1 should equal 3.*\nReceived string: (.|\n)*?1 should equal 2/);
     });
 
-    // TODO: Fix this
     it('should fail the JestExtensions test if a require error message is expected where no error is thrown', async () => {
       const contract = new Contract(artifact, [], { provider });
       provider.addUtxo(contract.address, randomUtxo());
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index 63095d4d..a0b8fa32 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -19,12 +19,10 @@ export function scriptToAsm(script: Script): string {
   return bytecodeToAsm(scriptToBytecode(script));
 }
 
-// TODO: See note at bytecodeToAsm
 export function scriptToBitAuthAsm(script: Script): string {
   return bytecodeToBitAuthAsm(scriptToBytecode(script));
 }
 
-// TODO: Figure out why OP_0 is decoded to an empty Uint8Array (while e.g. OP_3 is just OP_3)
 export function asmToScript(asm: string): Script {
   return bytecodeToScript(asmToBytecode(asm));
 }
@@ -94,8 +92,7 @@ export function bytecodeToAsm(bytecode: Uint8Array): string {
   return asm;
 }
 
-// TODO: If we decide to change the ASM / artifact format, we can remove this function and merge it
-// with bytecodeToAsm
+// TODO: If we decide to change the ASM / artifact format, we can remove this function and merge it with bytecodeToAsm
 export function bytecodeToBitAuthAsm(bytecode: Uint8Array): string {
   // Convert the bytecode to libauth's ASM format
   let asm = disassembleBytecodeBCH(bytecode);
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index 363a6d25..cc3ef35a 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -88,7 +88,6 @@ OP_ENDIF                                                /* }
 `.replace(/^\n+/, '').replace(/\n+$/, ''),
   },
   {
-    // TODO: These fixtures were copied from the current output of the compiler, but there are some small inaccuracies that we should fix later
     name: 'Mecenas',
     sourceCode: `
 pragma cashscript >=0.8.0;
diff --git a/website/docs/sdk/transactions.md b/website/docs/sdk/transactions.md
index bda4ae6a..66f0e44f 100644
--- a/website/docs/sdk/transactions.md
+++ b/website/docs/sdk/transactions.md
@@ -259,8 +259,6 @@ You can read more about debugging transactions on the [debugging page](/docs/gui
 It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
 :::
 
-TODO: Update this section with the new debugging experience
-
 ## Transaction errors
 
 When sending a transaction, the CashScript SDK will throw an error if the transaction fails. If you are using an artifact compiled with `cashc@0.10.0` or later, the error will be of the type `FailedRequireError` or `FailedTransactionEvaluationError`. In case of a `FailedRequireError`, the error will refer to the corresponding `require` statement in the contract code so you know where your contract failed. If you want more information about the underlying error, you can check the `libauthErrorMessage` property of the error.

From a714dc45fc89281f366f619cbf1e3e123e2f18f8 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 5 Sep 2024 16:30:18 +0200
Subject: [PATCH 114/267] Add JestExtensions toFailRequire() without message +
 update relevant tests

---
 packages/cashscript/src/test/JestExtensions.ts | 17 ++++++++++++++++-
 packages/cashscript/test/debugging.test.ts     |  8 ++++----
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/packages/cashscript/src/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
index e96cf81d..54d61fbb 100644
--- a/packages/cashscript/src/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -10,6 +10,7 @@ declare global {
     interface Matchers<R> {
       toLog(value?: RegExp | string): Promise<void>;
       toFailRequireWith(value: RegExp | string): Promise<void>;
+      toFailRequire(): Promise<void>;
     }
   }
 }
@@ -57,7 +58,7 @@ expect.extend({
       await transaction.debug();
 
       const matcherHint = this.utils.matcherHint('.toFailRequireWith', undefined, match.toString(), { isNot: this.isNot });
-      const message = (): string => `${matcherHint}\n\nContract function did not fail a require statement`;
+      const message = (): string => `${matcherHint}\n\nContract function did not fail a require statement.`;
       return { message, pass: false };
     } catch (transactionError: any) {
       const matcherHint = this.utils.matcherHint('toFailRequireWith', 'received', 'expected', { isNot: this.isNot });
@@ -73,4 +74,18 @@ expect.extend({
       }
     }
   },
+  async toFailRequire(
+    this: MatcherContext,
+    transaction: Transaction,
+  ): Promise<SyncExpectationResult> {
+    try {
+      await transaction.debug();
+      const message = (): string => 'Contract function did not fail a require statement.';
+      return { message, pass: false };
+    } catch (transactionError: any) {
+      const receivedText = `Received string: ${this.utils.printReceived(transactionError?.message ?? '')}`;
+      const message = (): string => `Contract function failed a require statement.\n${receivedText}`;
+      return { message, pass: true };
+    }
+  },
 });
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index ffabec2e..6e8a87db 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -450,7 +450,7 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.test_require_no_failure().to(contract.address, 1000n);
-      await expect(transaction).not.toFailRequireWith(/.*/);
+      await expect(transaction).not.toFailRequire();
     });
 
     // test_multiple_require_statements_no_message_final
@@ -721,7 +721,7 @@ describe('Debugging tests', () => {
       provider.addUtxo(contract.address, randomUtxo());
 
       const transaction = contract.functions.test_zero_handling(0n).to(contract.address, 1000n);
-      await expect(transaction).not.toFailRequireWith(/.*/);
+      await expect(transaction).not.toFailRequire();
     });
   });
 
@@ -807,8 +807,8 @@ describe('Debugging tests', () => {
       ).rejects.toThrow(/Expected pattern: not .*1 should equal 2.*\nReceived string: (.|\n)*?1 should equal 2/);
 
       await expect(
-        expect(transaction).not.toFailRequireWith(/.*/),
-      ).rejects.toThrow(/Expected pattern: not .*\nReceived string: (.|\n)*?1 should equal 2/);
+        expect(transaction).not.toFailRequire(),
+      ).rejects.toThrow(/Contract function failed a require statement\.*\nReceived string: (.|\n)*?1 should equal 2/);
     });
   });
 });

From 6f5f8e698fb11a8263224b0b2778c7474f3e2755 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 5 Sep 2024 16:51:23 +0200
Subject: [PATCH 115/267] Add example for console.log + small docs changes

---
 website/docs/language/contracts.md | 18 ++++++++++++++++++
 website/docs/language/types.md     |  6 +++---
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index dd07437d..271c8a6b 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -136,6 +136,24 @@ The `console.log` statement can be used to log values during debug evaluation of
 Logging is only available in debug evaluation of a transaction, but has no impact on the compiled bytecode or regular (non-debug) execution.
 :::
 
+#### Example
+```solidity
+pragma cashscript ^0.10.0;
+
+contract P2PKH(bytes20 pkh) {
+    function spend(pubkey pk, sig s) {
+        bytes20 hashedPk = hash160(pk);
+
+        // console.log can access any variable in the function scope
+        console.log("passed public key: ", pk, ", hashed: ", hashedPk);
+        console.log("expected pkh: ", pkh);
+
+        require(hashedPk == pkh);
+        require(checkSig(s, pk));
+    }
+}
+```
+
 ## Comments
 Comments can be added anywhere in the contract file. Comment semantics are similar to languages like JavaScript or C. This means that single-line comments can be added with `// ...`, while multiline comments can be added with `/* ... */`.
 
diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index 63068a11..2b8d5807 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -29,7 +29,7 @@ Operators:
 
 Note the lack of the `**` (exponentiation) operator as well as any bitwise operators.
 
-### Over- & Underflows
+#### Over- & Underflows
 
 The maximum range for 64-bit integers is `-9223372036854775807` to `9223372036854775807`, operations exceeding these limits will fail the transaction. So operations like summation, subtraction and multiplication should take into account these boundary cases with over- or underflows.
 
@@ -37,7 +37,7 @@ The maximum range for 64-bit integers is `-9223372036854775807` to `922337203685
 Contract authors should always consider whether `+`, `-` and `*` operations can cause under- or overflows and how this would impact contract security.
 :::
 
-### Division by Zero
+#### Division by Zero
 
 The script will fail when the right hand side of division or modulo operations is zero.
 
@@ -45,7 +45,7 @@ The script will fail when the right hand side of division or modulo operations i
 Contract authors should always consider whether `/` and `%` operations have division-by-zero edge cases and how this would impact contract security.
 :::
 
-### Date Parsing
+#### Date Parsing
 Dates and times are always represented as integers. To get the UTC timestamp of a date use the built-in parser to avoid any potential errors. This will take a date in the format `date("YYYY-MM-DDThh:mm:ss")` and convert it to an integer timestamp.
 
 #### Example

From c2ab68fe82304f759332b098e4c3ab0a0f6b4a15 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 6 Sep 2024 07:21:02 +0200
Subject: [PATCH 116/267] remove note meep

---
 website/docs/sdk/transactions.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/website/docs/sdk/transactions.md b/website/docs/sdk/transactions.md
index 66f0e44f..f491a7b8 100644
--- a/website/docs/sdk/transactions.md
+++ b/website/docs/sdk/transactions.md
@@ -78,10 +78,6 @@ transaction.fromP2PKH(inputs: Utxo[], template: SignatureTemplate): this;
 
 The `fromP2PKH()` function allows you to provide a list of P2PKH UTXOs to be used in the transaction. The passed `SignatureTemplate` is used to sign these UTXOs. This function can be called any number of times, and the provided UTXOs will be added to the list of earlier added UTXOs.
 
-:::note
-If you are using [meep](https://github.com/gcash/meep) to debug a `fromP2PKH()` transaction, meep will always use the first input for the debugging. So if you want to debug the smart contract bytecode, make sure that the first input is not a P2PKH input.
-:::
-
 #### Example
 ```ts
 import { bobAddress, bobPrivateKey } from './somewhere';

From c30e89d2c5ac5b550ace44ebac24206765d8631b Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 6 Sep 2024 22:13:52 +0200
Subject: [PATCH 117/267] move global units

---
 website/docs/language/globals.md | 54 +++++++++++++++++++-------------
 1 file changed, 33 insertions(+), 21 deletions(-)

diff --git a/website/docs/language/globals.md b/website/docs/language/globals.md
index 2459b1a9..37c546c1 100644
--- a/website/docs/language/globals.md
+++ b/website/docs/language/globals.md
@@ -2,27 +2,6 @@
 title: Global Variables
 ---
 
-## Globally available units
-An integer literal can take a suffix of either monetary or temporary units to add semantic value to these integers and to simplify arithmetic. When these units are used, the underlying integer is automatically multiplied by the value of the unit. The units `sats`, `finney`, `bits` and `bitcoin` are used to denote monetary value, while the units `seconds`, `minutes`, `hours`, `days` and `weeks` are used to denote time.
-
-:::caution
-Be careful when using these units in precise calendar calculations though, because not every year equals 365 days and not even every minute has 60 seconds because of [leap seconds](https://en.wikipedia.org/wiki/Leap_second).
-:::
-
-### Example
-```solidity
-require(1 sats == 1);
-require(1 finney == 10);
-require(1 bit == 100);
-require(1 bitcoin == 1e8);
-
-require(1 seconds == 1);
-require(1 minutes == 60 seconds);
-require(1 hours == 60 minutes);
-require(1 days == 24 hours);
-require(1 weeks == 7 days);
-```
-
 ## Global time lock variables
 Bitcoin Cash has support for different kinds of time locks, which can be used to specify time-based conditions inside Bitcoin Cash contracts. These time locks can be separated by **three main attributes**: location, targeting and metric. The *location* can be the *transaction level* or the *contract level*, but *contract level* locks also require you to use a corresponding *transaction level* lock. The targeting can be *relative* (e.g. at least 4 hours have passed) or *absolute* (e.g. the block number is at least 600,000). The metric can be blocks or seconds.
 
@@ -264,6 +243,39 @@ new LockingBytecodeNullData(bytes[] chunks): bytes
 
 Creates new OP_RETURN locking bytecode with `chunks` as its OP_RETURN data.
 
+## Globally available units
+
+An integer literal can take a suffix of either monetary or temporary units to add semantic value to these integers and to simplify arithmetic. When these units are used, the underlying integer is automatically multiplied by the value of the unit.
+
+### BCH Units
+
+The units `sats`, `finney`, `bits` and `bitcoin` are used to Bitcoin Cash amounts.
+
+#### Example
+```solidity
+require(1 sats == 1);
+require(1 finney == 10);
+require(1 bit == 100);
+require(1 bitcoin == 1e8);
+```
+
+### Time Units
+
+The units `seconds`, `minutes`, `hours`, `days` and `weeks` are used to denote time.
+
+:::caution
+Be careful when using these units in precise calendar calculations though, because not every year equals 365 days and not even every minute has 60 seconds because of [leap seconds](https://en.wikipedia.org/wiki/Leap_second).
+:::
+
+#### Example
+```solidity
+require(1 seconds == 1);
+require(1 minutes == 60 seconds);
+require(1 hours == 60 minutes);
+require(1 days == 24 hours);
+require(1 weeks == 7 days);
+```
+
 [bip68]: https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki
 [withAge()]: /docs/sdk/transactions#withage
 [withTime()]: /docs/sdk/transactions#withtime

From 4a8e33fbb60ee79e36d76f4c895289d1a484712c Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 6 Sep 2024 22:40:38 +0200
Subject: [PATCH 118/267] add docs performRequest

---
 website/docs/sdk/network-provider.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/website/docs/sdk/network-provider.md b/website/docs/sdk/network-provider.md
index 52edc1e3..b16ef636 100644
--- a/website/docs/sdk/network-provider.md
+++ b/website/docs/sdk/network-provider.md
@@ -88,6 +88,16 @@ Broadcast a raw hex transaction to the network.
 const txId = await provider.sendRawTransaction(txHex)
 ```
 
+### performRequest
+
+Perform an arbitrary electrum request, refer to the docs at [electrum-cash-protocol](https://electrum-cash-protocol.readthedocs.io/en/latest/).
+
+#### Example
+```ts
+const verbose = true // get parsed transaction as json result
+const txId = await provider.performRequest('blockchain.transaction.get', txid, verbose)
+```
+
 ## Advanced Options
 
 All network functionality that the CashScript SDK needs is encapsulated in a network provider. This allows different network providers to be used and makes it easy to swap out dependencies.

From 12647243e10a3293b15aff71b954231889f51dcf Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 6 Sep 2024 23:16:28 +0200
Subject: [PATCH 119/267] re-add the examples page for the SDK

---
 website/docs/language/globals.md |   4 +-
 website/docs/sdk/examples.md     | 237 +++++++++++++++++--------------
 website/sidebars.js              |   1 +
 3 files changed, 136 insertions(+), 106 deletions(-)

diff --git a/website/docs/language/globals.md b/website/docs/language/globals.md
index 37c546c1..a7780193 100644
--- a/website/docs/language/globals.md
+++ b/website/docs/language/globals.md
@@ -249,7 +249,7 @@ An integer literal can take a suffix of either monetary or temporary units to ad
 
 ### BCH Units
 
-The units `sats`, `finney`, `bits` and `bitcoin` are used to Bitcoin Cash amounts.
+The units `sats`, `finney`, `bits` and `bitcoin` can be used to denominate Bitcoin Cash amounts.
 
 #### Example
 ```solidity
@@ -261,7 +261,7 @@ require(1 bitcoin == 1e8);
 
 ### Time Units
 
-The units `seconds`, `minutes`, `hours`, `days` and `weeks` are used to denote time.
+The units `seconds`, `minutes`, `hours`, `days` and `weeks` can be used to denote time.
 
 :::caution
 Be careful when using these units in precise calendar calculations though, because not every year equals 365 days and not even every minute has 60 seconds because of [leap seconds](https://en.wikipedia.org/wiki/Leap_second).
diff --git a/website/docs/sdk/examples.md b/website/docs/sdk/examples.md
index bb1214d3..583013c0 100644
--- a/website/docs/sdk/examples.md
+++ b/website/docs/sdk/examples.md
@@ -2,136 +2,165 @@
 title: Examples
 ---
 
-An extensive collection of examples is available in the [GitHub repository][github-examples]. Below we discuss a few of these examples in more detail. These examples focus mainly on the use of the SDK, while the [Examples page](/docs/language/examples) in the language section focuses more on the CashScript syntax.
+An extensive collection of examples is available in the [GitHub repository][github-examples]. Below we discuss the HodlVault example from the repository in full detail. The focus of this page is on the use of the SDK, while the [Examples page](/docs/language/examples) in the language section focuses on the CashScript syntax.
+
+## HodlVault
+
+We will break up the development of the smart contract application in 4 manageable steps:
+1. Creating the keypairs
+2. Generating a Contract
+3. Building the Oracle
+4. Sending a Transaction
+
+### Creating the keypairs
+
+To put the `HodlVault.cash` contract to use in a TypeScript application, we have to use the CashScript SDK in combination with a BCH library such as [Libauth][libauth], [Mainnetjs][mainnetjs] or [BCHJS][bchjs]. These libraries are used to generate public/private keys for the contract participants. 
+In this example we'll use [Libauth][libauth] to generate the keys `alicePriv`, `alicePub`, `oracle` & `oraclePub`. Then we can use these keys to create the smart contract.
+
+:::caution
+These 'private keys' are public just for testing, in other contexts you want to very carefully treat private keys as `environment variables`. You would also make sure to use a secure seed phrase and not 'CashScript Examples'... 
+:::
+
+```ts title="common.ts"
+import { hash160 } from '@cashscript/utils';
+import {
+  deriveHdPrivateNodeFromSeed,
+  deriveHdPath,
+  secp256k1,
+  encodeCashAddress,
+} from '@bitauth/libauth';
+import bip39 from 'bip39';
+import { PriceOracle } from './PriceOracle.js';
+
+// Generate entropy from BIP39 mnemonic phrase and initialise a root HD-wallet node
+const seed = await bip39.mnemonicToSeed('CashScript Examples');
+const rootNode = deriveHdPrivateNodeFromSeed(seed, true);
+const baseDerivationPath = "m/44'/145'/0'/0";
+
+// Derive Alice's private key, public key, public key hash and address
+const aliceNode = deriveHdPath(rootNode, `${baseDerivationPath}/0`);
+if (typeof aliceNode === 'string') throw new Error();
+export const alicePub = secp256k1.derivePublicKeyCompressed(aliceNode.privateKey) as Uint8Array;
+export const alicePriv = aliceNode.privateKey;
+export const alicePkh = hash160(alicePub);
+export const aliceAddress = encodeCashAddress('bchtest', 'p2pkhWithTokens', alicePkh);
+
+// Initialise a price oracle with a private key
+const oracleNode = deriveHdPath(rootNode, `${baseDerivationPath}/2`);
+if (typeof oracleNode === 'string') throw new Error();
+export const oraclePub = secp256k1.derivePublicKeyCompressed(oracleNode.privateKey) as Uint8Array;
+export const oraclePriv = oracleNode.privateKey;
+export const oracle = new PriceOracle(oracleNode.privateKey);
+export const oraclePkh = hash160(oraclePub);
+export const oracleAddress = encodeCashAddress('bchtest', 'p2pkhWithTokens', oraclePkh);
+```
 
-## Transfer With Timeout
-The idea of this smart contract is explained on the [Language Examples page](/docs/language/examples#transfer-with-timeout). The gist is that it allows you to send an amount of BCH to someone, but if they don't claim the sent amount, it can be recovered by the sender.
+### Generating a Contract
 
+For the networkprovider, we'll use the `ElectrumNetworkProvider` from the SDK and for `Simple Transaction Builder` for this example. Once you have a smart contract address you can send funds to it. To spend the Bitcoin cash locked in the contract you will have to satisfy the spending conditions on the contract.
 
-```solidity title="TransferWithTimeout.cash"
-contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
-    function transfer(sig recipientSig) {
-        require(checkSig(recipientSig, recipient));
-    }
+```ts title="hodl_vault.ts"
+import { stringify } from '@bitauth/libauth';
+import { Contract, SignatureTemplate, ElectrumNetworkProvider } from 'cashscript';
+import { compileFile } from 'cashc';
+import { URL } from 'url';
 
-    function timeout(sig senderSig) {
-        require(checkSig(senderSig, sender));
-        require(tx.time >= timeout);
-    }
-}
-```
+// Import keys and price oracle from common.ts
+import {
+  alicePub,
+  oraclePub,
+} from './common.ts';
 
-Now to put this smart contract to use in a JavaScript application, we have to use the CashScript SDK in combination with a BCH library such as [BCHJS][bchjs], [bitcore-lib-cash][bitcore] or [Libauth][libauth]. These libraries are used to generate public/private keys for the contract participants. Then these keys can be used in the CashScript SDK. The key generation code is left out of this example, since this works differently for every library.
+// Compile the HodlVault contract to an artifact object
+const artifact = compileFile(new URL('hodl_vault.cash', import.meta.url));
 
-```ts title="TransferWithTimeout.js"
-import { Contract, SignatureTemplate } from 'cashscript';
-import { alicePub, bobPriv, bobPub } from './somewhere.js';
-import artifact from './transfer_with_timeout.json';
+// Initialise a network provider for network operations on CHIPNET
+const provider = new ElectrumNetworkProvider('chipnet');
 
-// Instantiate a new contract using the artifact and constructor arguments:
-// { sender: alicePub, recipient: bobPub, timeout: 1000000 }
-// No network provider is provided, so the default ElectrumNetworkProvider is used
-const options = { addressType: 'p2sh20' };
-const contract = new Contract(artifact, [alicePub, bobPub, 1000000n], options);
+// Instantiate a new contract using the compiled artifact and network provider
+// AND providing the constructor parameters
+const parameters = [alicePub, oraclePub, 100000n, 30000n];
+const contract = new Contract(artifact, parameters, { provider });
 
-// Display contract address and balance
+// Get contract balance & output address + balance
 console.log('contract address:', contract.address);
 console.log('contract balance:', await contract.getBalance());
+```
 
-// Call the transfer function with Bob's signature
-// i.e. Bob claims the money that Alice has sent him
-const txDetails = await contract.functions
-  .transfer(new SignatureTemplate(bobPriv))
-  .to('bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx', 10000n)
-  .send();
+### Building the Oracle
 
-console.log(txDetails);
-```
+We need the create the functionality for generating and signing the oracle message to use in the HodlVault contract:
+
+```ts title="PriceOracle.ts"
+import { padMinimallyEncodedVmNumber, flattenBinArray, secp256k1 } from '@bitauth/libauth';
+import { encodeInt, sha256 } from '@cashscript/utils';
 
-## Memo.cash Announcement
-[Memo.cash](https://memo.cash) is a Twitter-like social network based on Bitcoin Cash. It uses `OP_RETURN` outputs to post messages on-chain. By using a covenant we can create an example contract whose only job is to post Isaac Asimov's first law of smart contracts to Memo.cash. Just to remind its fellow smart contracts.
-
-This contract expects a hardcoded transaction fee of 1000 satoshis. This is necessary due to the nature of covenants (See the [Licho's Mecenas example](/docs/language/examples#lichos-mecenas) for more information on this). The remaining balance after this transaction fee might end up being lower than 1000 satoshis, which means that the contract does not have enough left over to make another announcement.
-
-To ensure that this leftover money does not get lost in the contract, the contract performs an extra check, and adds the remainder to the transaction fee if it's too low.
-
-```solidity title="Announcement.cash"
-pragma cashscript ^0.10.0;
-
-// This contract enforces making an announcement on Memo.cash and sending the
-// remaining balance back to the contract.
-contract Announcement() {
-    function announce() {
-        // Create the memo.cash announcement output
-        bytes announcement = new LockingBytecodeNullData([
-            0x6d02,
-            bytes('A contract may not injure a human being or, '
-             + 'through inaction, allow a human being to come to harm.')
-        ]);
-
-        // Check that the first tx output matches the announcement
-        require(tx.outputs[0].value == 0);
-        require(tx.outputs[0].lockingBytecode == announcement);
-
-        // Calculate leftover money after fee (1000 sats)
-        // Check that the second tx output sends the change back if there's
-        // enough leftover for another announcement
-        int minerFee = 1000;
-        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;
-        if (changeAmount >= minerFee) {
-            bytes changeLock = tx.inputs[this.activeInputIndex].lockingBytecode;
-            require(tx.outputs[1].lockingBytecode == changeLock);
-            require(tx.outputs[1].value == changeAmount);
-        }
-    }
+export class PriceOracle {
+  constructor(public privateKey: Uint8Array) {}
+
+  // Encode a blockHeight and bchUsdPrice into a byte sequence of 8 bytes (4 bytes per value)
+  createMessage(blockHeight: bigint, bchUsdPrice: bigint): Uint8Array {
+    const encodedBlockHeight = padMinimallyEncodedVmNumber(encodeInt(blockHeight), 4);
+    const encodedBchUsdPrice = padMinimallyEncodedVmNumber(encodeInt(bchUsdPrice), 4);
+
+    return flattenBinArray([encodedBlockHeight, encodedBchUsdPrice]);
+  }
+
+  signMessage(message: Uint8Array): Uint8Array {
+    const signature = secp256k1.signMessageHashSchnorr(this.privateKey, sha256(message));
+    if (typeof signature === 'string') throw new Error();
+    return signature;
+  }
 }
 ```
 
-The CashScript code above ensures that the smart contract **can only** be used in the way specified in the code. But the transaction needs to be created by the SDK. To ensure that it complies with the rules of the smart contract, we need to use some of the more advanced options of the SDK.
+### Sending a Transaction
+
+Finnally, we can put all of this together to create a working smart contract application. We use the generated keys as a contract arguments directly or in a `SignatureTemplate` to create a transaction signature.
 
-```ts title="Announcement.js"
-import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
-import { alicePriv, alicePub } from './somewhere.js';
-import artifact from './announcement.json';
+```ts title="hodl_vault.ts"
+import { stringify } from '@bitauth/libauth';
+import { Contract, SignatureTemplate, ElectrumNetworkProvider } from 'cashscript';
+import { compileFile } from 'cashc';
+import { URL } from 'url';
 
-// Initialise a network provider for network operations on MAINNET
-const provider = new ElectrumNetworkProvider('mainnet');
-const addressType = 'p2sh20';
+// Import keys and price oracle from common.ts
+import {
+  alicePriv,
+  alicePub,
+  oracle,
+  oraclePub,
+} from './common.ts';
+
+// Compile the HodlVault contract to an artifact object
+const artifact = compileFile(new URL('hodl_vault.cash', import.meta.url));
+
+// Initialise a network provider for network operations on CHIPNET
+const provider = new ElectrumNetworkProvider('chipnet');
 
 // Instantiate a new contract using the compiled artifact and network provider
-// AND providing the constructor parameters (none)
-const options = { provider, addressType};
-const contract = new Contract(artifact, [], options);
+// AND providing the constructor parameters
+const parameters = [alicePub, oraclePub, 100000n, 30000n];
+const contract = new Contract(artifact, parameters, { provider });
 
-// Display contract address, balance, opcount, and bytesize
+// Get contract balance & output address + balance
 console.log('contract address:', contract.address);
 console.log('contract balance:', await contract.getBalance());
-console.log('contract opcount:', contract.opcount);
-console.log('contract bytesize:', contract.bytesize);
-
-// Create the announcement string. Any other announcement will fail because
-// it does not comply with the smart contract.
-const str = 'A contract may not injure a human being or, '
-  + 'through inaction, allow a human being to come to harm.';
-
-// Send the announcement transaction
-const txDetails = await contract.functions
-  .announce(alicePub, new SignatureTemplate(alicePriv))
-  // Add the announcement string as an OP_RETURN output
-  .withOpReturn(['0x6d02', str])
-  // Hardcodes the transaction fee (like the contract expects)
-  .withHardcodedFee(1000n)
-  // Only add a "change" output if the remainder is higher than 1000
-  .withMinChange(1000n)
+
+// Produce new oracle message and signature
+const oracleMessage = oracle.createMessage(100000n, 30000n);
+const oracleSignature = oracle.signMessage(oracleMessage);
+
+// Spend from the vault
+const tx = await contract.functions
+  .spend(new SignatureTemplate(alicePriv), oracleSignature, oracleMessage)
+  .to(contract.address, 1000n)
   .send();
 
-console.log(txDetails);
+console.log(stringify(tx));
 ```
 
-[bitbox]: https://developer.bitcoin.com/bitbox/
-[electrum-cash]: https://www.npmjs.com/package/electrum-cash
-[fullstack]: https://fullstack.cash/
 [bchjs]: https://bchjs.fullstack.cash/
-[bitcore]: https://github.com/bitpay/bitcore/tree/master/packages/bitcore-lib-cash
+[mainnetjs]: https://mainnet.cash/
 [libauth]: https://libauth.org/
-[github-examples]: https://github.com/CashScript/cashscript/tree/master/examples
+[github-examples]: https://github.com/CashScript/cashscript/tree/master/examples
\ No newline at end of file
diff --git a/website/sidebars.js b/website/sidebars.js
index 238673d5..5b16c91c 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -38,6 +38,7 @@ module.exports = {
         'sdk/transactions',
         'sdk/transactions-advanced',
         'sdk/testing-setup',
+        'sdk/examples',
       ],
     },
     {

From 24c300040c60efa0b0140f3a298241cc68bbae72 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 10 Sep 2024 11:02:08 +0200
Subject: [PATCH 120/267] Update testing setup and network provider docs pages

---
 website/docs/sdk/network-provider.md | 13 ++---
 website/docs/sdk/testing-setup.md    | 78 +++++++++++++++++++++-------
 2 files changed, 63 insertions(+), 28 deletions(-)

diff --git a/website/docs/sdk/network-provider.md b/website/docs/sdk/network-provider.md
index b16ef636..88cfbc6f 100644
--- a/website/docs/sdk/network-provider.md
+++ b/website/docs/sdk/network-provider.md
@@ -7,20 +7,15 @@ The CashScript SDK needs to connect to the BCH network to perform certain operat
 ## ElectrumNetworkProvider
 
 The ElectrumNetworkProvider uses [electrum-cash][electrum-cash] to connect to the BCH network. Both `network` and `electrum` parameters are optional, and they default to mainnet and a 2-of-3 ElectrumCluster with a number of reliable electrum servers.
-```ts
-new ElectrumNetworkProvider(network?: Network, electrum?: ElectrumCluster)
-```
 
-#### Example
 ```ts
-const provider = new ElectrumProvider('chipnet');
+new ElectrumNetworkProvider(network?: Network, electrum?: ElectrumCluster)
 ```
 
 :::note
 In some cases it might be desirable to overwrite the 2-of-3 ElectrumCluster default to use only a 1-of-1 cluster because of network latency.
 :::
 
-## Interface NetworkProvider
 
 ### Network
 ```ts
@@ -119,8 +114,8 @@ provider.addUtxo(contractAddress, newUtxo);
 ### Other NetworkProviders
 
 There are two alternative network providers implemented:
-- `FullStackNetworkProvider`: uses [FullStack.cash][fullstack]' infrastructure to connect to the BCH network. 
-- `BitcoinRpcNetworkProvider`: uses a direct connection to a Bitcoin Cash node. 
+- `FullStackNetworkProvider`: uses [FullStack.cash][fullstack]' infrastructure to connect to the BCH network.
+- `BitcoinRpcNetworkProvider`: uses a direct connection to a Bitcoin Cash node.
 
 Currently neither supports CashTokens, so it is recommended to use the `ElectrumNetworkProvider`.
 
@@ -134,4 +129,4 @@ To implement a Custom NetworkProvider, refer to the [NetworkProvider interface](
 
 [electrum-cash]: https://www.npmjs.com/package/electrum-cash
 [fullstack]: https://fullstack.cash/
-[bchjs]: https://bchjs.fullstack.cash/
\ No newline at end of file
+[bchjs]: https://bchjs.fullstack.cash/
diff --git a/website/docs/sdk/testing-setup.md b/website/docs/sdk/testing-setup.md
index 6bd3d362..82a001d1 100644
--- a/website/docs/sdk/testing-setup.md
+++ b/website/docs/sdk/testing-setup.md
@@ -30,16 +30,18 @@ provider.addUtxo(aliceAddress, randomUtxo({
 The `MockNetworkProvider` only evaluates the transactions locally, so any UTXOs added to a transaction still count as "unspent", even after mocking a `sendTransaction` using the provider.
 :::
 
-## Jest extension
+## Automated testing
+
+To make writing automated tests for CashScript contracts easier, we provide a Jest extension that enables easy testing of `console.log` values and `require` error messages. To use the extension, you can import it from `cashscript/jest`.
 
-To make writing automated tests for CashScript contracts easier, we provide a Jest extension that enables easy testing of `console.log` values and `require` error messages. To use the extension, you can import it from `cashscript/dist/test/JestExtensions`.
+```ts
+import 'cashscript/jest';
+```
 
-:::tip
+:::note
 If you're using a different testing framework, you can test for `console.log` values by spying on the console output, and test for `require` error messages by asserting that an error is thrown with a specific error message.
 :::
 
-## Automated testing
-
 With local transaction evaluation and debugging, it is possible to write efficient automated tests for CashScript contracts to test specific contract behaviour and check `console.log` values and `require` error messages.
 
 ### Logging values
@@ -50,6 +52,16 @@ You can log values during debug evaluation using the `console.log` statement. An
 Logging is only available in debug evaluation of a transaction. It has no impact on the compiled bytecode or regular (non-debug) execution.
 :::
 
+```ts
+describe('Example contract', () => {
+  it('should log the passed parameter', async () => {
+    const contract = new Contract(artifact, [], { provider });
+    const transaction = contract.functions.exampleFunction(1000n).to(contract.address, 10000n);
+    await expect(transaction).toLog('passed parameter: 1000');
+  });
+});
+```
+
 ### Error messages
 
 The `require` statement accepts an optional error message as a second argument. If the condition in the require statement is not met during debug evaluation, the error message is returned. This allows you to write automated tests that check for specific error messages.
@@ -58,13 +70,29 @@ The `require` statement accepts an optional error message as a second argument.
 Similar to `console.log`, the error message in a `require` statement is only available in debug evaluation of a transaction, so the error message has no impact on the compiled bytecode or regular (non-debug) execution.
 :::
 
-## Example
+```ts
+describe('Example contract', () => {
+  const contract = new Contract(artifact, [], { provider });
+
+  it('should fail require statement when incorrect parameter is passed', async () => {
+    const transaction = contract.functions.exampleFunction(999n).to(contract.address, 10000n);
+    await expect(transaction).toFailRequireWith('passed parameter is not 1000');
+  });
+
+  it('should pass require statement when correct parameter is passed', async () => {
+    const transaction = contract.functions.exampleFunction(1000n).to(contract.address, 10000n);
+    await expect(transaction).not.toFailRequire();
+  });
+});
+```
+
+## Full Example
 
 ```solidity title="Example contract"
 contract Example() {
   function exampleFunction(int value) {
-    console.log(value, "test");
-    require(value == 1, "Wrong value passed");
+    console.log("passed parameter:", value);
+    require(value == 1000, "passed parameter is not 1000");
   }
 }
 ```
@@ -72,16 +100,28 @@ contract Example() {
 ```ts title="Example test file"
 import artifact from '../artifacts/example.json' assert { type: "json" };
 import { Contract, MockNetworkProvider, randomUtxo } from 'cashscript';
-import 'cashscript/dist/test/JestExtensions';
-
-const provider = new MockNetworkProvider();
-const contract = new Contract(artifact, [], { provider });
-provider.addUtxo(contract.address, randomUtxo());
-
-let transaction = contract.functions.exampleFunction(0n).to(contract.address, 10000n);
-await (expect(transaction)).toLog(/0 test/);
-await (expect(transaction)).toFailRequireWith(/Wrong value passed/);
+import 'cashscript/jest';
+
+describe('Example contract', () => {
+  const contract = new Contract(artifact, [], { provider });
+  const provider = new MockNetworkProvider();
+  provider.addUtxo(contract.address, randomUtxo());
+
+  it('should log the passed parameter', async () => {
+    const contract = new Contract(artifact, [], { provider });
+    const transaction = contract.functions.exampleFunction(1000n).to(contract.address, 10000n);
+    await expect(transaction).toLog('passed parameter: 1000');
+  });
+
+  it('should fail require statement when incorrect parameter is passed', async () => {
+    const transaction = contract.functions.exampleFunction(999n).to(contract.address, 10000n);
+    await expect(transaction).toFailRequireWith('passed parameter is not 1000');
+  });
+
+  it('should pass require statement when correct parameter is passed', async () => {
+    const transaction = contract.functions.exampleFunction(1000n).to(contract.address, 10000n);
+    await expect(transaction).not.toFailRequire();
+  });
+});
 
-transaction = contract.functions.exampleFunction(1n).to(contract.address, 10000n);
-await expect(transaction.send()).resolves.not.toThrow();
 ```

From a23b10c1938f9c88c189b0b77f9edd17ce0c7d86 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 10 Sep 2024 11:45:38 +0200
Subject: [PATCH 121/267] Change some fields on TransactionBuilder to public

---
 packages/cashc/src/generation/GenerateTargetTraversal.ts | 2 +-
 packages/cashscript/src/TransactionBuilder.ts            | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index 8e38541d..ed4b0159 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -322,9 +322,9 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     const data = node.parameters.map((parameter: ConsoleParameterNode) => {
       if (parameter instanceof IdentifierNode) {
         const symbol = parameter.definition!;
-        const stackIndex = this.getStackIndex(parameter.name, true);
 
         // If the variable is not on the stack, then we add the final stack usage to the console log
+        const stackIndex = this.getStackIndex(parameter.name, true);
         if (stackIndex === -1) {
           if (!this.finalStackUsage[parameter.name]) {
             throw new Error(`Expected variable '${parameter.name}' does not exist on the stack or in final stack usage`);
diff --git a/packages/cashscript/src/TransactionBuilder.ts b/packages/cashscript/src/TransactionBuilder.ts
index 562c16a5..f9c02e92 100644
--- a/packages/cashscript/src/TransactionBuilder.ts
+++ b/packages/cashscript/src/TransactionBuilder.ts
@@ -26,9 +26,9 @@ export interface TransactionBuilderOptions {
 const DEFAULT_SEQUENCE = 0xfffffffe;
 
 export class TransactionBuilder {
-  private provider: NetworkProvider;
-  private inputs: UnlockableUtxo[] = [];
-  private outputs: Output[] = [];
+  public provider: NetworkProvider;
+  public inputs: UnlockableUtxo[] = [];
+  public outputs: Output[] = [];
 
   private locktime: number;
   private maxFee?: bigint;

From d0c0bd8640c874afd1806ac37a0aec1453c4a011 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 10 Sep 2024 11:45:55 +0200
Subject: [PATCH 122/267] Update migration and release notes

---
 website/docs/releases/migration-notes.md | 10 ++++
 website/docs/releases/release-notes.md   | 71 ++++++++++++++++--------
 2 files changed, 57 insertions(+), 24 deletions(-)

diff --git a/website/docs/releases/migration-notes.md b/website/docs/releases/migration-notes.md
index fc3e995c..8c3d9765 100644
--- a/website/docs/releases/migration-notes.md
+++ b/website/docs/releases/migration-notes.md
@@ -2,6 +2,16 @@
 title: Migration Notes
 ---
 
+## v0.9 to 0.10
+
+### CashScript SDK
+
+The `Reason` enum + `FailedTimeCheckError` and `FailedSigCheckError` errors have been removed. If you were using these to check your transaction errors, you should now use the new error classes `FailedRequireError`, `FailedTransactionEvaluationError` and `FailedTransactionError`.
+
+If you were using `transaction.meep()` or using the `meep` string in errors, you should now use `transaction.bitauthUri()` to get a BitAuth URI for debugging or use the `bitauthUri` string in errors.
+
+The `Argument` type has been split into `FunctionArgument` and `ConstructorArgument` and the `encodeArgument` function has been renamed to `encodeFunctionArgument`. If you were using these types in your code, you should update your code to use the new types, depending on whether you were using them as function arguments or constructor arguments.
+
 ## v0.7 to v0.8
 
 ### cashc compiler
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index d7d59175..37debfbf 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -4,22 +4,37 @@ title: Release Notes
 
 ## v0.10.0
 
+In this version we added proper debugging support for transactions and integration with the BitAuth IDE.
+
+Thanks [mainnet_pat](https://x.com/mainnet_pat) for the initiative and significant contributions!
+
 #### cashc compiler
 - :sparkles: Add `console.log()` statements for debugging.
 - :sparkles: Extend `require()` statements to allow custom error messages for debugging.
 - :hammer_and_wrench: Update artifact format to allow for new debugging features.
+- :hammer_and_wrench: Update dependencies to new major versions.
 
 #### CashScript SDK
-- :sparkles: Add `MockNetworkProvider` to simulate network interaction for debugging and testing.
 - :sparkles: Add support for transaction evaluation and debugging using libauth templates.
-- :sparkles: Add extended Jest utilities specifically crafted for CashScript:
-  * `await expect(transaction).toLog(message)`
-  * `await expect(transaction).toFailRequireWith(message)`
-- :sparkles: Output BitAuth IDE URI for debugging when transaction is rejected.
-
-We also added a new example project with a full testing suite to demonstrate the new debugging features under `examples/testing-suite`.
-
-Thanks [mainnet_pat](https://twitter.com/mainnet_pat) for the contributions!
+  - `transaction.debug()` & `transaction.bitauthUri()`
+  - Output BitAuth IDE URI for debugging when transaction is rejected.
+- :sparkles: Add `MockNetworkProvider` to simulate network interaction for debugging and testing.
+  - Add `randomUtxo()`, `randomToken()` and `randomNft()` functions to generate dummy UTXOs for testing.
+- :sparkles: Add CashScript Jest utilities for automated testing.
+  * `expect(transaction).toLog(message)`
+  * `expect(transaction).toFailRequire()`
+  * `expect(transaction).toFailRequireWith(message)`
+- :bug: Fix bug with type exports.
+- :hammer_and_wrench: Update visibility of several classes.
+  - Make `artifact`, `networkProvider`, `addressType` and `encodedConstructorArgs` public on `Contract` class.
+  - Make `contract`, `abiFunction`, `encodedFunctionArgs`, `inputs` and `outputs` public on `Transaction` class.
+  - Make `networkProvider`, `inputs` and `outputs` public on `TransactionBuilder` class.
+  - Make `privateKey` public on `SignatureTemplate` class and add `getSignatureAlgorithm()` method.
+- :hammer_and_wrench: Improve some error messages.
+- :hammer_and_wrench: Add new `FailedRequireError`, `FailedTransactionEvaluationError` and `FailedTransactionError` classes.
+- :boom: **BREAKING**: Remove exported transaction error `Reason` enum + `FailedTimeCheckError` and `FailedSigCheckError` classes in favour of the new error classes.
+- :boom: **BREAKING**: Remove all deprecated references to `meep` including `meep` strings from errors and `transaction.meep()`.
+- :boom: **BREAKING**: Separate the `Argument` type into `FunctionArgument` and `ConstructorArgument` and rename `encodeArgument` to `encodeFunctionArgument`.
 
 ## v0.9.3
 
@@ -47,6 +62,10 @@ Thanks [mainnet_pat](https://twitter.com/mainnet_pat) for the contributions!
 - :sparkles: Add new advanced `TransactionBuilder` class that allows combining UTXOs from multiple different smart contracts and P2PKH UTXOs in a single transaction.
 - :hammer_and_wrench: Deprecate all `meep` functionality. Meep has been unmaintained for years and does not support many new CashScript features. Meep functionality will be removed in a future release.
 
+---
+
+https://x.com/CashScriptBCH/status/1713928572677583023
+
 ## v0.8.2
 
 #### CashScript SDK
@@ -91,6 +110,10 @@ This release also contains several breaking changes, please refer to the [migrat
 - :boom: **BREAKING**: Remove `BitboxNetworkProvider`.
 - :boom: **BREAKING**: All signature templates use  `SIGHASH_ALL | SIGHASH_UTXOS` now, this new default can be overwritten in the constructor of the `SignatureTemplate`.
 
+---
+
+https://x.com/CashScriptBCH/status/1662092546372255744
+
 ## v0.7.5
 
 #### CashScript SDK
@@ -139,7 +162,7 @@ This release also contains several breaking changes, please refer to the [migrat
 - :bug: Small fixes
 
 ---
-https://twitter.com/RoscoKalis/status/1529072055756414976
+https://x.com/RoscoKalis/status/1529072055756414976
 
 ## v0.6.5
 #### cashc compiler
@@ -176,7 +199,7 @@ https://twitter.com/RoscoKalis/status/1529072055756414976
 * :boom: **BREAKING**: Remove dependency on `cashc` and remove `CashCompiler` export
 
 ---
-https://twitter.com/RoscoKalis/status/1371896417443282956
+https://x.com/RoscoKalis/status/1371896417443282956
 
 ## v0.5.7
 #### cashc compiler
@@ -212,7 +235,7 @@ https://twitter.com/RoscoKalis/status/1371896417443282956
 - :bug: Improve reliability of the `ElectrumNetworkProvider` when sending multiple concurrent requests.
 
 ---
-https://twitter.com/RoscoKalis/status/1301521593399685121
+https://x.com/RoscoKalis/status/1301521593399685121
 
 ## v0.5.0
 #### CashScript SDK
@@ -230,7 +253,7 @@ CashScript used to be very tightly coupled with BITBOX. This proved to be proble
 - :hammer_and_wrench: Removed BITBOX as a dependency in favour of libauth for utility functions.
 
 ---
-https://twitter.com/RoscoKalis/status/1298645699559596033
+https://x.com/RoscoKalis/status/1298645699559596033
 
 ## v0.4.4
 #### cashc compiler
@@ -256,7 +279,7 @@ https://twitter.com/RoscoKalis/status/1298645699559596033
   - `Sig` still exists for backward compatibility, but is deprecated and will be removed in a later release.
 
 ---
-https://twitter.com/RoscoKalis/status/1267440143624884227
+https://x.com/RoscoKalis/status/1267440143624884227
 
 ## v0.4.0
 #### cashc compiler
@@ -283,14 +306,14 @@ https://twitter.com/RoscoKalis/status/1267440143624884227
 This update contains several breaking changes. See the [migration notes](/docs/releases/migration-notes#v03-to-v04) for a full migration guide.
 
 ---
-https://twitter.com/RoscoKalis/status/1264921879346917376
+https://x.com/RoscoKalis/status/1264921879346917376
 
 ## v0.3.3
 #### cashc compiler
 - :bug: Fix bug where variables could not reliably be used inside `OutputNullData` instantiation.
 
 ---
-https://twitter.com/RoscoKalis/status/1224389493769342979
+https://x.com/RoscoKalis/status/1224389493769342979
 
 ## v0.3.2
 #### cashc compiler
@@ -309,7 +332,7 @@ https://twitter.com/RoscoKalis/status/1224389493769342979
 - :purse: Add `minChange` to transaction options. If this `minChange` is not reached, the change will be added to the transaction fee instead.
 
 ---
-https://twitter.com/RoscoKalis/status/1223280232343515136
+https://x.com/RoscoKalis/status/1223280232343515136
 
 ## v0.3.1
 #### cashc compiler
@@ -324,7 +347,7 @@ https://twitter.com/RoscoKalis/status/1223280232343515136
 * :bug: Fix a bug where the size of a preimage was not accounted for in fee calculation for covenants.
 
 ---
-https://twitter.com/RoscoKalis/status/1217101473743544320
+https://x.com/RoscoKalis/status/1217101473743544320
 
 ## v0.3.0
 #### cashc compiler
@@ -345,14 +368,14 @@ https://twitter.com/RoscoKalis/status/1217101473743544320
 * :dizzy: Better fee estimation for transactions with many inputs.
 
 ---
-https://twitter.com/RoscoKalis/status/1204765863062188033
+https://x.com/RoscoKalis/status/1204765863062188033
 
 ## v0.2.3
 #### cashc compiler
 * :bug: Fix a bug where unequal bytes types (e.g. `bytes3` & `bytes8`) could not be concatenated together, as they were considered different types.
 
 ---
-https://twitter.com/RoscoKalis/status/1202220857566908416
+https://x.com/RoscoKalis/status/1202220857566908416
 
 ## v0.2.2
 #### CashScript SDK
@@ -367,7 +390,7 @@ https://twitter.com/RoscoKalis/status/1202220857566908416
   * If it is provided, the artifact is written to the file, if not, it is returned as an object.
 
 ---
-https://twitter.com/RoscoKalis/status/1192900277105389568
+https://x.com/RoscoKalis/status/1192900277105389568
 
 ## v0.2.1
 #### cashc compiler
@@ -380,7 +403,7 @@ https://twitter.com/RoscoKalis/status/1192900277105389568
 * :hammer:  Make the `hashtype` parameter in signature placeholders optional.
 
 ---
-https://twitter.com/RoscoKalis/status/1186554051720167424
+https://x.com/RoscoKalis/status/1186554051720167424
 
 ## v0.2.0
 #### cashc compiler
@@ -401,7 +424,7 @@ https://twitter.com/RoscoKalis/status/1186554051720167424
 * :arrow_up: Update `cashc` and other dependencies.
 
 ---
-https://twitter.com/RoscoKalis/status/1178843657069154305
+https://x.com/RoscoKalis/status/1178843657069154305
 
 ## v0.1.2
 #### CashScript SDK
@@ -413,7 +436,7 @@ https://twitter.com/RoscoKalis/status/1178843657069154305
 * :rotating_light: Improve Transaction testing
 
 ---
-https://twitter.com/RoscoKalis/status/1174910060691984385
+https://x.com/RoscoKalis/status/1174910060691984385
 
 ## v0.1.1
 #### CashScript SDK

From c5731c30ae7b4d4f70e4042d625e09666a783c6d Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 10 Sep 2024 11:52:33 +0200
Subject: [PATCH 123/267] Update docs

---
 website/docs/sdk/instantiation.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 7522f7ef..bfeb15cb 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -199,6 +199,8 @@ You may notice the `SignatureTemplate` object in the [example](#example-8) above
 
 So in the place of a signature, a `SignatureTemplate` can be passed, which will automatically generate the correct signature using the `signer` parameter. This signer can be any representation of a private key, including [BCHJS' `ECPair`][ecpair], [bitcore-lib-cash' `PrivateKey`][privatekey], [WIF strings][wif], or raw private key buffers. This ensures that any BCH library can be used.
 
+The default `hashtype` is `HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS` because this is the most secure option for smart contract use cases.
+
 ```ts
 export enum HashType {
   SIGHASH_ALL = 0x01,

From 59162f03fc6e834eadf56bbc1159e4446c94cbc4 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 10 Sep 2024 11:56:45 +0200
Subject: [PATCH 124/267] Bump version to 0.10.0

---
 examples/package.json                                      | 6 +++---
 examples/testing-suite/artifacts/example.json              | 4 ++--
 examples/testing-suite/package.json                        | 7 ++++---
 packages/cashc/package.json                                | 4 ++--
 packages/cashc/src/index.ts                                | 2 +-
 packages/cashscript/package.json                           | 4 ++--
 packages/cashscript/test/fixture/announcement.json         | 4 ++--
 packages/cashscript/test/fixture/bigint.json               | 4 ++--
 packages/cashscript/test/fixture/bounded_bytes.json        | 4 ++--
 packages/cashscript/test/fixture/hodl_vault.json           | 4 ++--
 packages/cashscript/test/fixture/mecenas.json              | 4 ++--
 packages/cashscript/test/fixture/p2palindrome.json         | 4 ++--
 packages/cashscript/test/fixture/p2pkh.json                | 4 ++--
 packages/cashscript/test/fixture/simple_covenant.json      | 4 ++--
 .../cashscript/test/fixture/token_category_comparison.json | 4 ++--
 .../cashscript/test/fixture/transfer_with_timeout.json     | 4 ++--
 packages/utils/package.json                                | 2 +-
 17 files changed, 35 insertions(+), 34 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index 0307f788..c379660e 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.0-next.6",
+  "version": "0.10.0",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -14,8 +14,8 @@
     "@bitauth/libauth": "^3.0.0",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
-    "cashc": "^0.10.0-next.6",
-    "cashscript": "^0.10.0-next.6",
+    "cashc": "^0.10.0",
+    "cashscript": "^0.10.0",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/artifacts/example.json b/examples/testing-suite/artifacts/example.json
index b5b4bd75..7104e362 100644
--- a/examples/testing-suite/artifacts/example.json
+++ b/examples/testing-suite/artifacts/example.json
@@ -41,7 +41,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-08-06T09:59:35.164Z"
+  "updatedAt": "2024-09-10T09:55:42.448Z"
 }
\ No newline at end of file
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 36b5f308..7c0582ce 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.0-next.6",
+  "version": "0.10.0",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -25,8 +25,9 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "cashc": "^0.10.0-next.6",
-    "cashscript": "^0.10.0-next.6"
+    "cashc": "^0.10.0",
+    "cashscript": "^0.10.0",
+    "url-join": "^5.0.0"
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 3e3a70b5..b9ec4434 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.0-next.6",
+  "version": "0.10.0",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.0-next.6",
+    "@cashscript/utils": "^0.10.0",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index e05ef6ec..72b37416 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.0-next.6';
+export const version = '0.10.0';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index d58f4a61..4a8d48ba 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.0-next.6",
+  "version": "0.10.0",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.0-next.6",
+    "@cashscript/utils": "^0.10.0",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
diff --git a/packages/cashscript/test/fixture/announcement.json b/packages/cashscript/test/fixture/announcement.json
index 39c9e255..0b1d40dc 100644
--- a/packages/cashscript/test/fixture/announcement.json
+++ b/packages/cashscript/test/fixture/announcement.json
@@ -34,7 +34,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:22.357Z"
+  "updatedAt": "2024-09-10T09:54:01.248Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index 3313e9bb..ae33572a 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -35,7 +35,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:22.095Z"
+  "updatedAt": "2024-09-10T09:54:00.989Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index 7f4a9550..dadf6205 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -31,7 +31,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:23.083Z"
+  "updatedAt": "2024-09-10T09:54:01.995Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index 8937fdea..d5a511cd 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -68,7 +68,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:22.594Z"
+  "updatedAt": "2024-09-10T09:54:01.493Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index 916d7620..484b62c0 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -72,7 +72,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:24.222Z"
+  "updatedAt": "2024-09-10T09:54:03.279Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index 67c2b49c..9fbf038d 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -27,7 +27,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:22.851Z"
+  "updatedAt": "2024-09-10T09:54:01.764Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index 35574b7a..b17bf5fc 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -40,7 +40,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:23.980Z"
+  "updatedAt": "2024-09-10T09:54:03.012Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/simple_covenant.json b/packages/cashscript/test/fixture/simple_covenant.json
index 0573f08d..614c0fbd 100644
--- a/packages/cashscript/test/fixture/simple_covenant.json
+++ b/packages/cashscript/test/fixture/simple_covenant.json
@@ -42,7 +42,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:23.302Z"
+  "updatedAt": "2024-09-10T09:54:02.299Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/token_category_comparison.json b/packages/cashscript/test/fixture/token_category_comparison.json
index 28b9b243..657da061 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.json
+++ b/packages/cashscript/test/fixture/token_category_comparison.json
@@ -22,7 +22,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:23.764Z"
+  "updatedAt": "2024-09-10T09:54:02.765Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index 6064fd4f..1e94abcc 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -57,7 +57,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0-next.6"
+    "version": "0.10.0"
   },
-  "updatedAt": "2024-09-05T13:25:23.528Z"
+  "updatedAt": "2024-09-10T09:54:02.536Z"
 }
\ No newline at end of file
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 732ee591..c8806c62 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.0-next.6",
+  "version": "0.10.0",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From 65ce867e7798b32d1dadb26819c844df154fff8b Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 10 Sep 2024 12:02:38 +0200
Subject: [PATCH 125/267] Fix build

---
 .eslintrc.cjs                                 |   2 +-
 .../utils/test/fixtures/source-map.fixture.ts | 170 +++++++++---------
 2 files changed, 86 insertions(+), 86 deletions(-)

diff --git a/.eslintrc.cjs b/.eslintrc.cjs
index 9e77dd1f..84ab1988 100644
--- a/.eslintrc.cjs
+++ b/.eslintrc.cjs
@@ -15,7 +15,7 @@ module.exports = {
     'jest': true,
   },
   rules: {
-    'max-len': ['error', { code: 120, ignoreStrings: true, ignoreTemplateLiterals: true }],
+    'max-len': ['error', { code: 125, ignoreStrings: true, ignoreTemplateLiterals: true }],
     'import/no-cycle': 0, // Needed for AST -> AstVisitor -> AST
     'class-methods-use-this': 0, // I don't like this rule
     'no-underscore-dangle': 0, // antlr automatically uses this
diff --git a/packages/utils/test/fixtures/source-map.fixture.ts b/packages/utils/test/fixtures/source-map.fixture.ts
index 58b0cfce..c2fd6a72 100644
--- a/packages/utils/test/fixtures/source-map.fixture.ts
+++ b/packages/utils/test/fixtures/source-map.fixture.ts
@@ -10,40 +10,40 @@ export const fixtures: Fixture[] = [
   {
     name: 'Basic Test',
     locationData: [
-      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
-      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
-      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
-      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
-      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } } },
-      { location: { start: { line: 11, column: 26 }, end: { line: 11, column: 32 } } },
-      { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 24 } } },
-      { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 24 } } },
-      { location: { start: { line: 13, column: 28 }, end: { line: 13, column: 34 } } },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 11, column: 26 }, end: { line: 11, column: 32 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 24 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 24 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 28 }, end: { line: 13, column: 34 } }, positionHint: PositionHint.START },
       { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 34 } }, positionHint: PositionHint.END },
       { location: { start: { line: 13, column: 20 }, end: { line: 13, column: 34 } }, positionHint: PositionHint.END },
       { location: { start: { line: 13, column: 12 }, end: { line: 13, column: 36 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 14, column: 29 }, end: { line: 14, column: 41 } } },
-      { location: { start: { line: 14, column: 29 }, end: { line: 14, column: 41 } } },
-      { location: { start: { line: 14, column: 43 }, end: { line: 14, column: 52 } } },
-      { location: { start: { line: 14, column: 43 }, end: { line: 14, column: 52 } } },
+      { location: { start: { line: 14, column: 29 }, end: { line: 14, column: 41 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 14, column: 29 }, end: { line: 14, column: 41 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 14, column: 43 }, end: { line: 14, column: 52 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 14, column: 43 }, end: { line: 14, column: 52 } }, positionHint: PositionHint.START },
       { location: { start: { line: 14, column: 20 }, end: { line: 14, column: 53 } }, positionHint: PositionHint.END },
       { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.END },
       { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.END },
       { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.END },
       { location: { start: { line: 10, column: 8 }, end: { line: 15, column: 9 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
-      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
-      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
-      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
-      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } } },
-      { location: { start: { line: 19, column: 29 }, end: { line: 19, column: 38 } } },
-      { location: { start: { line: 19, column: 29 }, end: { line: 19, column: 38 } } },
-      { location: { start: { line: 19, column: 40 }, end: { line: 19, column: 46 } } },
-      { location: { start: { line: 19, column: 40 }, end: { line: 19, column: 46 } } },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 19, column: 29 }, end: { line: 19, column: 38 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 19, column: 29 }, end: { line: 19, column: 38 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 19, column: 40 }, end: { line: 19, column: 46 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 19, column: 40 }, end: { line: 19, column: 46 } }, positionHint: PositionHint.START },
       { location: { start: { line: 19, column: 20 }, end: { line: 19, column: 47 } }, positionHint: PositionHint.END },
       { location: { start: { line: 19, column: 12 }, end: { line: 19, column: 49 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 20, column: 31 }, end: { line: 20, column: 38 } } },
-      { location: { start: { line: 20, column: 31 }, end: { line: 20, column: 38 } } },
+      { location: { start: { line: 20, column: 31 }, end: { line: 20, column: 38 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 20, column: 31 }, end: { line: 20, column: 38 } }, positionHint: PositionHint.START },
       { location: { start: { line: 20, column: 12 }, end: { line: 20, column: 40 } }, positionHint: PositionHint.END },
       { location: { start: { line: 20, column: 12 }, end: { line: 20, column: 40 } }, positionHint: PositionHint.END },
       { location: { start: { line: 18, column: 8 }, end: { line: 21, column: 9 } }, positionHint: PositionHint.END },
@@ -55,67 +55,67 @@ export const fixtures: Fixture[] = [
   {
     name: 'Mecenas',
     locationData: [
-      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
-      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
-      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
-      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
-      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } } },
-      { location: { start: { line: 13, column: 27 }, end: { line: 13, column: 28 } } },
-      { location: { start: { line: 13, column: 16 }, end: { line: 13, column: 45 } } },
-      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } } },
-      { location: { start: { line: 13, column: 74 }, end: { line: 13, column: 83 } } },
-      { location: { start: { line: 13, column: 74 }, end: { line: 13, column: 83 } } },
-      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } } },
-      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } } },
-      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } } },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 27 }, end: { line: 13, column: 28 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 16 }, end: { line: 13, column: 45 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 74 }, end: { line: 13, column: 83 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 74 }, end: { line: 13, column: 83 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 13, column: 49 }, end: { line: 13, column: 84 } }, positionHint: PositionHint.START },
       { location: { start: { line: 13, column: 16 }, end: { line: 13, column: 84 } }, positionHint: PositionHint.END },
       { location: { start: { line: 13, column: 8 }, end: { line: 13, column: 86 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 15, column: 23 }, end: { line: 15, column: 27 } } },
-      { location: { start: { line: 16, column: 37 }, end: { line: 16, column: 58 } } },
-      { location: { start: { line: 16, column: 27 }, end: { line: 16, column: 65 } } },
-      { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 38 } } },
-      { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 38 } } },
-      { location: { start: { line: 17, column: 41 }, end: { line: 17, column: 47 } } },
-      { location: { start: { line: 17, column: 41 }, end: { line: 17, column: 47 } } },
+      { location: { start: { line: 15, column: 23 }, end: { line: 15, column: 27 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 16, column: 37 }, end: { line: 16, column: 58 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 16, column: 27 }, end: { line: 16, column: 65 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 38 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 38 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 17, column: 41 }, end: { line: 17, column: 47 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 17, column: 41 }, end: { line: 17, column: 47 } }, positionHint: PositionHint.START },
       { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 47 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 17, column: 50 }, end: { line: 17, column: 58 } } },
-      { location: { start: { line: 17, column: 50 }, end: { line: 17, column: 58 } } },
+      { location: { start: { line: 17, column: 50 }, end: { line: 17, column: 58 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 17, column: 50 }, end: { line: 17, column: 58 } }, positionHint: PositionHint.START },
       { location: { start: { line: 17, column: 26 }, end: { line: 17, column: 58 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 21, column: 12 }, end: { line: 21, column: 23 } } },
-      { location: { start: { line: 21, column: 12 }, end: { line: 21, column: 23 } } },
-      { location: { start: { line: 21, column: 27 }, end: { line: 21, column: 33 } } },
-      { location: { start: { line: 21, column: 27 }, end: { line: 21, column: 33 } } },
-      { location: { start: { line: 21, column: 36 }, end: { line: 21, column: 44 } } },
-      { location: { start: { line: 21, column: 36 }, end: { line: 21, column: 44 } } },
+      { location: { start: { line: 21, column: 12 }, end: { line: 21, column: 23 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 21, column: 12 }, end: { line: 21, column: 23 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 21, column: 27 }, end: { line: 21, column: 33 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 21, column: 27 }, end: { line: 21, column: 33 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 21, column: 36 }, end: { line: 21, column: 44 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 21, column: 36 }, end: { line: 21, column: 44 } }, positionHint: PositionHint.START },
       { location: { start: { line: 21, column: 27 }, end: { line: 21, column: 44 } }, positionHint: PositionHint.END },
       { location: { start: { line: 21, column: 12 }, end: { line: 21, column: 44 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 21, column: 46 }, end: { line: 23, column: 9 } } },
-      { location: { start: { line: 22, column: 31 }, end: { line: 22, column: 32 } } },
-      { location: { start: { line: 22, column: 20 }, end: { line: 22, column: 39 } } },
-      { location: { start: { line: 22, column: 43 }, end: { line: 22, column: 55 } } },
-      { location: { start: { line: 22, column: 43 }, end: { line: 22, column: 55 } } },
-      { location: { start: { line: 22, column: 58 }, end: { line: 22, column: 66 } } },
-      { location: { start: { line: 22, column: 58 }, end: { line: 22, column: 66 } } },
+      { location: { start: { line: 21, column: 46 }, end: { line: 23, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 22, column: 31 }, end: { line: 22, column: 32 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 22, column: 20 }, end: { line: 22, column: 39 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 22, column: 43 }, end: { line: 22, column: 55 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 22, column: 43 }, end: { line: 22, column: 55 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 22, column: 58 }, end: { line: 22, column: 66 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 22, column: 58 }, end: { line: 22, column: 66 } }, positionHint: PositionHint.START },
       { location: { start: { line: 22, column: 43 }, end: { line: 22, column: 66 } }, positionHint: PositionHint.END },
       { location: { start: { line: 22, column: 20 }, end: { line: 22, column: 66 } }, positionHint: PositionHint.END },
       { location: { start: { line: 22, column: 12 }, end: { line: 22, column: 68 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 23, column: 15 }, end: { line: 27, column: 9 } } },
-      { location: { start: { line: 24, column: 31 }, end: { line: 24, column: 32 } } },
-      { location: { start: { line: 24, column: 20 }, end: { line: 24, column: 39 } } },
-      { location: { start: { line: 24, column: 43 }, end: { line: 24, column: 49 } } },
-      { location: { start: { line: 24, column: 43 }, end: { line: 24, column: 49 } } },
+      { location: { start: { line: 23, column: 15 }, end: { line: 27, column: 9 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 24, column: 31 }, end: { line: 24, column: 32 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 24, column: 20 }, end: { line: 24, column: 39 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 24, column: 43 }, end: { line: 24, column: 49 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 24, column: 43 }, end: { line: 24, column: 49 } }, positionHint: PositionHint.START },
       { location: { start: { line: 24, column: 20 }, end: { line: 24, column: 49 } }, positionHint: PositionHint.END },
       { location: { start: { line: 24, column: 12 }, end: { line: 24, column: 51 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 25, column: 31 }, end: { line: 25, column: 32 } } },
-      { location: { start: { line: 25, column: 20 }, end: { line: 25, column: 49 } } },
-      { location: { start: { line: 25, column: 63 }, end: { line: 25, column: 84 } } },
-      { location: { start: { line: 25, column: 53 }, end: { line: 25, column: 101 } } },
+      { location: { start: { line: 25, column: 31 }, end: { line: 25, column: 32 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 25, column: 20 }, end: { line: 25, column: 49 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 25, column: 63 }, end: { line: 25, column: 84 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 25, column: 53 }, end: { line: 25, column: 101 } }, positionHint: PositionHint.START },
       { location: { start: { line: 25, column: 20 }, end: { line: 25, column: 101 } }, positionHint: PositionHint.END },
       { location: { start: { line: 25, column: 12 }, end: { line: 25, column: 103 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 26, column: 31 }, end: { line: 26, column: 32 } } },
-      { location: { start: { line: 26, column: 20 }, end: { line: 26, column: 39 } } },
-      { location: { start: { line: 26, column: 43 }, end: { line: 26, column: 54 } } },
-      { location: { start: { line: 26, column: 43 }, end: { line: 26, column: 54 } } },
+      { location: { start: { line: 26, column: 31 }, end: { line: 26, column: 32 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 26, column: 20 }, end: { line: 26, column: 39 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 26, column: 43 }, end: { line: 26, column: 54 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 26, column: 43 }, end: { line: 26, column: 54 } }, positionHint: PositionHint.START },
       { location: { start: { line: 26, column: 20 }, end: { line: 26, column: 54 } }, positionHint: PositionHint.END },
       { location: { start: { line: 26, column: 12 }, end: { line: 26, column: 56 } }, positionHint: PositionHint.END },
       { location: { start: { line: 23, column: 15 }, end: { line: 27, column: 9 } }, positionHint: PositionHint.END },
@@ -127,22 +127,22 @@ export const fixtures: Fixture[] = [
       { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
       { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
       { location: { start: { line: 9, column: 4 }, end: { line: 28, column: 5 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
-      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
-      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
-      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
-      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } } },
-      { location: { start: { line: 31, column: 24 }, end: { line: 31, column: 26 } } },
-      { location: { start: { line: 31, column: 24 }, end: { line: 31, column: 26 } } },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 31, column: 24 }, end: { line: 31, column: 26 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 31, column: 24 }, end: { line: 31, column: 26 } }, positionHint: PositionHint.START },
       { location: { start: { line: 31, column: 16 }, end: { line: 31, column: 27 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 31, column: 31 }, end: { line: 31, column: 37 } } },
-      { location: { start: { line: 31, column: 31 }, end: { line: 31, column: 37 } } },
+      { location: { start: { line: 31, column: 31 }, end: { line: 31, column: 37 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 31, column: 31 }, end: { line: 31, column: 37 } }, positionHint: PositionHint.START },
       { location: { start: { line: 31, column: 16 }, end: { line: 31, column: 37 } }, positionHint: PositionHint.END },
       { location: { start: { line: 31, column: 8 }, end: { line: 31, column: 39 } }, positionHint: PositionHint.END },
-      { location: { start: { line: 32, column: 25 }, end: { line: 32, column: 26 } } },
-      { location: { start: { line: 32, column: 25 }, end: { line: 32, column: 26 } } },
-      { location: { start: { line: 32, column: 28 }, end: { line: 32, column: 30 } } },
-      { location: { start: { line: 32, column: 28 }, end: { line: 32, column: 30 } } },
+      { location: { start: { line: 32, column: 25 }, end: { line: 32, column: 26 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 32, column: 25 }, end: { line: 32, column: 26 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 32, column: 28 }, end: { line: 32, column: 30 } }, positionHint: PositionHint.START },
+      { location: { start: { line: 32, column: 28 }, end: { line: 32, column: 30 } }, positionHint: PositionHint.START },
       { location: { start: { line: 32, column: 16 }, end: { line: 32, column: 31 } }, positionHint: PositionHint.END },
       { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.END },
       { location: { start: { line: 30, column: 4 }, end: { line: 33, column: 5 } }, positionHint: PositionHint.END },

From cd3031b60dc4ca2d2351608dfd838a50bcc7bbb9 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 10 Sep 2024 12:12:17 +0200
Subject: [PATCH 126/267] Update failing tests

---
 packages/cashc/test/generation/fixtures.ts    | 20 +++++++++----------
 .../test/fixture/libauth-template/fixtures.ts |  2 +-
 .../libauth-template/LibauthTemplate.test.ts  |  4 ++--
 .../test/fixtures/bitauth-script.fixture.ts   |  2 +-
 4 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index 565a6be7..d71f0720 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -113,7 +113,7 @@ export const fixtures: Fixture[] = [
           { ip: 47, line: 10 },
           { ip: 59, line: 13 },
         ],
-        sourceMap: '3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:24:9:9;9:15:11::0;10:20:10:21;;:25::26;;:20:::1;:12::28;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;2:4:14:5;;',
+        sourceMap: '3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22;;;;8:20:8:21:0;;:24::25;;:20:::1;:12::27;5:24:9:9;9:15:11::0;10:20:10:21;;:25::26;;:20:::1;:12::28;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;2:4:14:5;;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/if_statement.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -225,7 +225,7 @@ export const fixtures: Fixture[] = [
           { ip: 104, line: 22 },
           { ip: 114, line: 25 },
         ],
-        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:12:::1;:20:9:9:0;6::6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22:0;;;;8:20:8:21;;:24::25;;:20:::1;:12::27;5:20:9:9;9:15:11::0;10:16:10:17;;:12::18;;;9:15:11:9:1;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;:8::24;2:4:14:5;;;;;;16::26::0;;;;;17:16:17:17;;18:12:18:13;;:16::17;:12:::1;19::19:13:0;;:17::18;;:12:::1;:20:23:9:0;20::20:21;;:24::25;;:20:::1;21:16:21:17:0;;:20::21;;:16:::1;:12::22:0;;;;22:20:22:21;;:24::25;;:20:::1;:12::27;19:20:23:9;;24:12:24:13:0;;25:16:25:17;;:21::22;;:16:::1;16:4:26:5;;1:0:27:1',
+        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:12:::1;:20:9:9:0;6::6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22;;;;8:20:8:21:0;;:24::25;;:20:::1;:12::27;5:20:9:9;9:15:11::0;10:16:10:17;;:12::18:1;;;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;:8::24;2:4:14:5;;;;;;16::26::0;;;;;17:16:17:17;;18:12:18:13;;:16::17;:12:::1;19::19:13:0;;:17::18;;:12:::1;:20:23:9:0;20::20:21;;:24::25;;:20:::1;21:16:21:17:0;;:20::21;;:16:::1;:12::22;;;;22:20:22:21:0;;:24::25;;:20:::1;:12::27;19:20:23:9;;24:12:24:13:0;;25:16:25:17;;:21::22;;:16:::1;16:4:26:5;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/multifunction_if_statements.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -278,7 +278,7 @@ export const fixtures: Fixture[] = [
           { ip: 17, line: 4 },
           { ip: 27, line: 5 },
         ],
-        sourceMap: '3:18:3:19;;:26::27;;:::34;;:37::38;:26:::1;:18::39;:::42;4:16:4:17:0;;:21::22;;:16:::1;;:8::24;5:16:5:17:0;;:24::25;:16::26:1;:::29;:33::34:0;;:16:::1;',
+        sourceMap: '3:18:3:19;;:26::27;;:::34:1;;:37::38:0;:26:::1;:18::39;:::42;4:16:4:17:0;;:21::22;;:16:::1;;:8::24;5:16:5:17:0;;:24::25;:16::26:1;:::29;:33::34:0;;:16:::1;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/split_size.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -306,7 +306,7 @@ export const fixtures: Fixture[] = [
           { ip: 9, line: 3 },
           { ip: 15, line: 4 },
         ],
-        sourceMap: '3:33:3:35;;:17::37:1;:49::51:0;:41::52:1;:17;:57::61:0;:56;:17:::1;:8::64;4:25:4:26:0;;:28::30;;:16::31:1',
+        sourceMap: '3:33:3:35;;:17::37:1;:49::51:0;:41::52:1;:17;:57::61:0;:56:::1;:17;:8::64;4:25:4:26:0;;:28::30;;:16::31:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/cast_hash_checksig.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -395,7 +395,7 @@ export const fixtures: Fixture[] = [
         bytecode: '5152535455565579539f6353567a757c6b7c6b7c6b7c6b7c6c6c6c6c68557a557a557a93547a93537a93527a93a0',
         logs: [],
         requires: [{ ip: 46, line: 14 }],
-        sourceMap: '3:16:3:17;4::4;5::5;6::6;7::7;8::8;10:12:10:13;;:16::17;:12:::1;:19:12:9:0;11:16:11:17;:12::18;;;;;;;;;;;;;;;;10:19:12:9:1;14:16:14:17:0;;:20::21;;:24::25;;:20:::1;:28::29:0;;:20:::1;:32::33:0;;:20:::1;:36::37:0;;:20:::1;:16',
+        sourceMap: '3:16:3:17;4::4;5::5;6::6;7::7;8::8;10:12:10:13;;:16::17;:12:::1;:19:12:9:0;11:16:11:17;:12::18:1;;;;;;;;;;;;;;;;10:19:12:9;14:16:14:17:0;;:20::21;;:24::25;;:20:::1;:28::29:0;;:20:::1;:32::33:0;;:20:::1;:36::37:0;;:20:::1;:16',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/deep_replace.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -531,7 +531,7 @@ export const fixtures: Fixture[] = [
           { ip: 96, line: 21 },
           { ip: 101, line: 22 },
         ],
-        sourceMap: '3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:27:0;:31::32;:16:::1;:8::34;5:16:5:32:0;:36::37;:16:::1;:8::39;6:16:6:33:0;:37::38;:16:::1;:8::40;7:16:7:37:0;:41::42;:16:::1;:8::44;8:16:8:35:0;:::42;;:46::49;:16:::1;:8::51;9:26:9:27:0;:16::34;:38::43;:16:::1;:8::45;10:26:10:27:0;:16::44;:::51;;:55::60;:16:::1;:8::62;11:26:11:27:0;:16::52;:56::121;:16:::1;:8::123;12:26:12:27:0;:16::42;:46::47;:16:::1;:8::49;13:26:13:27:0;:16::46;:::53;;:57::60;:16:::1;:8::62;14:26:14:27:0;:16::43;:47::48;:16:::1;:8::50;15:27:15:28:0;:16::35;:39::44;:16:::1;:8::46;16:27:16:28:0;:16::45;:::52;;:56::59;:16:::1;:8::61;17:26:17:27:0;:16::42;:46::111;:16:::1;:8::113;18:26:18:27:0;:16::42;:46::50;:16:::1;:8::52;19:26:19:27:0;:16::40;:44::47;:16:::1;:8::49;20:27:20:28:0;:16::43;:47::112;:16:::1;:8::114;21:27:21:28:0;:16::43;:47::51;:16:::1;:8::53;22:27:22:28:0;:16::41;:45::48;:16:::1',
+        sourceMap: '3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:27:0;:31::32;:16:::1;:8::34;5:16:5:32:0;:36::37;:16:::1;:8::39;6:16:6:33:0;:37::38;:16:::1;:8::40;7:16:7:37:0;:41::42;:16:::1;:8::44;8:16:8:35:0;:::42:1;;:46::49:0;:16:::1;:8::51;9:26:9:27:0;:16::34:1;:38::43:0;:16:::1;:8::45;10:26:10:27:0;:16::44:1;:::51;;:55::60:0;:16:::1;:8::62;11:26:11:27:0;:16::52:1;:56::121:0;:16:::1;:8::123;12:26:12:27:0;:16::42:1;:46::47:0;:16:::1;:8::49;13:26:13:27:0;:16::46:1;:::53;;:57::60:0;:16:::1;:8::62;14:26:14:27:0;:16::43:1;:47::48:0;:16:::1;:8::50;15:27:15:28:0;:16::35:1;:39::44:0;:16:::1;:8::46;16:27:16:28:0;:16::45:1;:::52;;:56::59:0;:16:::1;:8::61;17:26:17:27:0;:16::42:1;:46::111:0;:16:::1;:8::113;18:26:18:27:0;:16::42:1;:46::50:0;:16:::1;:8::52;19:26:19:27:0;:16::40:1;:44::47:0;:16:::1;:8::49;20:27:20:28:0;:16::43:1;:47::112:0;:16:::1;:8::114;21:27:21:28:0;:16::43:1;:47::51:0;:16:::1;:8::53;22:27:22:28:0;:16::41:1;:45::48:0;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/covenant_all_fields.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -605,7 +605,7 @@ export const fixtures: Fixture[] = [
           { ip: 91, line: 24 },
           { ip: 97, line: 25 },
         ],
-        sourceMap: '2:4:21:5;;;;;3:26:3:32;;:8::34:1;;6:27:6:28:0;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;8:23:8:27:0;9:37:9:58;:27::65;10:26:10:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;16:15:20:9:0;17:31:17:32;:20::39;:43::49;;:20:::1;:12::51;18:31:18:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;19:31:19:32:0;:20::39;:43::54;;:20:::1;:12::56;16:15:20:9;2:4:21:5;;;;;;;;23::26::0;;;;;24:24:24:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
+        sourceMap: '2:4:21:5;;;;;3:26:3:32;;:8::34:1;;6:27:6:28:0;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;8:23:8:27:0;9:37:9:58;:27::65:1;10:26:10:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;16:15:20:9:0;17:31:17:32;:20::39:1;:43::49:0;;:20:::1;:12::51;18:31:18:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;19:31:19:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;16:15:20:9;2:4:21:5;;;;;;;;23::26::0;;;;;24:24:24:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/mecenas.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -655,7 +655,7 @@ export const fixtures: Fixture[] = [
           { ip: 47, line: 24 },
           { ip: 53, line: 25 },
         ],
-        sourceMap: '10:29:13:10;11:12:11:18;;;;;12:18:12:118;:12::119;;;;;;;;;;;;16:27:16:28;:16::35;:39::40;:16:::1;:8::42;17:27:17:28:0;:16::45;:49::61;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65;:68::76;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49;:63::84;:53::101;:20:::1;:12::103;25:31:25:32:0;:20::39;:43::55;;:20:::1;:12::57;23:38:26:9;8:4:27:5;',
+        sourceMap: '10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:16:::1;:8::42;17:27:17:28:0;:16::45:1;:49::61:0;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;;:20:::1;:12::57;23:38:26:9;8:4:27:5;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/announcement.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -678,7 +678,7 @@ export const fixtures: Fixture[] = [
         bytecode: '0079bc517a87',
         logs: [],
         requires: [{ ip: 6, line: 3 }],
-        sourceMap: '3:16:3:26;;:::36;:40::50;;:16:::1',
+        sourceMap: '3:16:3:26;;:::36:1;:40::50:0;;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/p2palindrome.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -701,7 +701,7 @@ export const fixtures: Fixture[] = [
         bytecode: '5a517a80007a815a9c',
         logs: [],
         requires: [{ ip: 9, line: 4 }],
-        sourceMap: '3:28:3:30;:32::36;;:22::37;4:20:4:25;;:16::26:1;:30::32:0;:16:::1',
+        sourceMap: '3:28:3:30;:32::36;;:22::37:1;4:20:4:25:0;;:16::26:1;:30::32:0;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/num2bin_variable.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 34ae49de..9dc021b6 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -565,7 +565,7 @@ export const fixtures: Fixture[] = [
             's': {
               'description': '"s" parameter of function "spend"',
               'name': 's',
-              'type': 'Key',
+              'type': 'WalletData',
             },
             'pk': {
               'description': '"pk" parameter of function "spend"',
diff --git a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
index 1c18fafc..ea5de55b 100644
--- a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
+++ b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
@@ -4,8 +4,8 @@ describe('Libauth Template generation tests', () => {
   fixtures.forEach((fixture) => {
     it(`should generate a valid libauth template for ${fixture.name}`, async () => {
       const generatedTemplate = await fixture.transaction.getLibauthTemplate();
-      console.log(JSON.stringify(generatedTemplate, null, 2));
-      console.log(await fixture.transaction.bitauthUri());
+      // console.log(JSON.stringify(generatedTemplate, null, 2));
+      // console.log(await fixture.transaction.bitauthUri());
       expect(generatedTemplate).toEqual(fixture.template);
     });
   });
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index cc3ef35a..c1dfdde5 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -125,7 +125,7 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
     }
 }`.replace(/^\n+/, '').replace(/\n+$/, ''),
     asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_2 OP_ROLL OP_CAT 88ac OP_CAT OP_EQUAL OP_VERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY OP_ENDIF OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
-    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45;:49::84;:74::83;;:49::84;;;:16:::1;:8::86;15:23:15:27:0;16:37:16:58;:27::65;17:26:17:38;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39;:43::55;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39;:43::49;;:20:::1;:12::51;25:31:25:32:0;:20::49;:63::84;:53::101;:20:::1;:12::103;26:31:26:32:0;:20::39;:43::54;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
+    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
     expectedLineToOpcodeMap: {
       9: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
       13: [new Uint8Array([]), Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_2, Op.OP_ROLL, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUAL, Op.OP_VERIFY],

From 368ba7c1d43995bdae64166af46911e4c110bd16 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Thu, 12 Sep 2024 11:14:03 +0200
Subject: [PATCH 127/267] add example error messages to debugging docs (#205)

---
 website/docs/guides/debugging.md | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 5fca9e3b..91d7e858 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -21,7 +21,13 @@ Currently the CashScript debugging tools only work with the [Simple Transaction
 
 ### Error messages
 
-If a CashScript transaction is sent using any network provider and is rejected by the network (or the `MockNetworkProvider`), the transaction will be evaluated locally using libauth to provide failure reasons and debug information in addition to the failure reason communicated by the network.
+If a CashScript transaction is evaluated with `.debug()` or is sent to a network and rejected, then the transaction will be evaluated locally using libauth to provide the failure reason and debug information. Here is an example of what a CashScript error message looks like:
+
+```bash
+HodlVault.cash:23 Require statement failed at input 0 in contract HodlVault.cash at line 23.
+Failing statement: require(price >= priceTarget)
+Bithauth IDE: [link]
+```
 
 Read the error message to see which line in the CashScript contract causes the transaction validation to fail. Investigate whether the contract function invocation is the issue (on the TypeScript SDK side) or whether the issue is in the CashScript contract itself (so you'd need to update your contract and recompile the artifact). If it is not clear **why** the CashScript contract is failing on that line, then you can use the following two strategies: console logging & Bitauth IDE stack trace.
 
@@ -76,7 +82,14 @@ Because the advanced transaction builder does not yet support the advanced debug
 
 ### Failing Opcode
 
-When a transaction gets rejected by a full node, it will return a cryptic error message. Read the message carefully to investigate whether the issue is a failing script (failing OpCode) or whether a standardness rule like minimum-relay-fee is violated. If the cause is a failing OpCode, you can check the contract's Artifact to see how many appearances this OpCode has. Sometimes the OpCode only appears once or twice, indicating where the failing `require` statement is. Other times you might see 15 appearances of the OpCode leaving you to try the next strategies.
+When a transaction gets rejected by a full node, it will return a cryptic error message. An example error looks like this:
+
+```bash
+mandatory-script-verify-flag-failed (Script failed an OP_VERIFY operation) (code 16)
+```
+
+Read the message carefully to investigate whether the issue is a failing script (failing OpCode) or whether a standardness rule like minimum-relay-fee is violated. 
+If the cause is a failing OpCode, you can check the contract's Artifact to see how many appearances this OpCode has. Sometimes the OpCode only appears once or twice, indicating where the failing `require` statement is. Other times you might see 15 appearances of the OpCode leaving you to try the next strategies.
 
 ### Removing Contract Checks
 

From 344ac7ccecd6f638377b840f8e6d17210eb2ebc6 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 17 Sep 2024 08:28:47 +0200
Subject: [PATCH 128/267] add Fundme.cash, remove BCHouse

---
 website/docs/showcase.md       |   8 +-
 website/static/img/bchouse.svg | 146 ---------------------------------
 website/static/img/fundme.png  | Bin 0 -> 781018 bytes
 website/static/img/slp.png     | Bin 6110 -> 0 bytes
 4 files changed, 5 insertions(+), 149 deletions(-)
 delete mode 100644 website/static/img/bchouse.svg
 create mode 100644 website/static/img/fundme.png
 delete mode 100644 website/static/img/slp.png

diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index 3557b3be..1ec20d9c 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -60,13 +60,15 @@ The CashTokens Studio is an application for creating CashTokens and for their ma
 
 BadgerCoin is a fungible CashToken using a novel distibution mechanism. BadgerCoins are earned through staking Bitcoin Cash in the Badgers Smart Contract. The staking duration is predetermined, and depending on the stake amount and period you earn tokens. The website allows for anyone to invoke contract unlocks.
 
-## BCHouse
+## FundMe.cash
 
 <div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
-    <a href="https://bchouse.fly.dev/" target="_blank"><img style={{borderRadius: '100%'}} src="/img/bchouse.svg" /></a>
+    <a href="https://fundme.cash/" target="_blank">
+        <img style={{maxHeight: '320px'}} src="/img/fundme.png" />
+    </a>
 </div>
 
-BCHouse is a brand new BCH social media site and the first CashTokens-based crowdfunding application on Bitcoin Cash. BCHouse uses CashScript for the crowdfunding smart contract to allow an unlimited number of contributions to a campaign and to enable any BCH wallet to pledge by using forwarding addresses.
+FundMe is a new BCH crowdfunding platform using WalletConnect. Fundme campaigns have revocable and refundable pledges through the use of CashTokens receipts. By using receipts, Fundme does not have a maximum limit on the number of participants in a campaign.
 
 ## Unspent Phi
 
diff --git a/website/static/img/bchouse.svg b/website/static/img/bchouse.svg
deleted file mode 100644
index 82924e18..00000000
--- a/website/static/img/bchouse.svg
+++ /dev/null
@@ -1,146 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
-
-<svg
-   width="800px"
-   height="800px"
-   viewBox="0 0 45 45"
-   fill="none"
-   version="1.1"
-   id="svg17"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg">
-  <g
-     clip-path="url(#clip0_2_1369)"
-     id="g17"
-     style="display:inline;fill:#0ac18e;fill-opacity:1">
-    <g
-       id="g23"
-       style="fill:#0ac18e;fill-opacity:1">
-      <path
-         d="M 29.502687,17.099202 C 29.338359,12.800399 25.654798,9.1089502 18.704409,5.9065392 L 17.676377,5.4424657 16.648345,5.9065392 C 9.5362589,9.1838835 5.8448089,12.972614 5.8448089,17.40025 v 1.314618 l 2.629238,-0.0013 h 2.6292371 13.146186 2.629238 l 2.629237,0.0013 V 17.40025 Z"
-         fill="#3c3c3c"
-         id="path2094"
-         style="display:inline;fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
-      <path
-         d="M 25.564089,25.665374 H 9.7807779 V 17.780291 H 25.564089 Z"
-         stroke="#3c3c3c"
-         stroke-width="2"
-         stroke-linecap="round"
-         stroke-linejoin="round"
-         id="path2"
-         style="display:inline;fill:#0ac18e;fill-opacity:1;stroke:#0ac18e;stroke-opacity:1" />
-    </g>
-    <g
-       id="g22"
-       style="display:inline;fill:#0ac18e;fill-opacity:1">
-      <path
-         d="m 36.677875,10.142357 c 0.494297,1.832578 0.717782,3.857091 0.717782,6.32463 0,3.084095 -0.786142,6.155045 -2.343965,9.202331 l -2.997331,-0.0013 c 1.814174,-3.093298 2.712059,-6.156359 2.712059,-9.201016 0,-2.530641 -0.249778,-4.486793 -0.797974,-6.232607 1.208135,-2.3124139 2.112592,-2.3124139 2.709429,-0.09202 z"
-         fill="#3c3c3c"
-         id="path4"
-         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
-      <path
-         d="m 36.2125,7.3172415 c 2.805396,0.3733517 -1.695858,4.6629525 -2.244054,2.9171385 -1.024088,0.506129 -1.745813,1.530216 -1.824691,2.730463 l -0.0066,0.215598 h -2.629237 c 0,-2.563507 1.630127,-4.744459 3.909676,-5.5674103 -0.195878,-0.9018284 3.132736,-1.0622119 2.794879,-0.2957892 z"
-         fill="#3c3c3c"
-         id="path5"
-         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
-      <path
-         d="m 36.2125,7.3172415 c 2.805396,0.3733517 4.987663,2.7120585 5.12044,5.5845005 l 0.0066,0.278699 h -2.629237 c 0,-1.371148 -0.838727,-2.545102 -2.032401,-3.038084 C 35.828631,9.5205424 35.154232,9.1747976 33.417621,7.6130307 33.221743,6.7112023 36.550357,6.5508188 36.2125,7.3172415 Z"
-         fill="#3c3c3c"
-         id="path6"
-         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
-      <path
-         d="M 36.2125,7.3172415 C 35.960093,7.4355572 34.517957,8.0021578 33.417621,7.6130307 33.221743,6.7112023 32.171362,5.9500381 30.822564,5.9500381 c -1.425047,0 -2.514866,0.8492437 -2.62135,1.8181176 l -0.0079,0.1538104 h -2.629237 c 0,-2.5990011 2.401808,-4.6011653 5.258475,-4.6011653 1.553879,0 2.973667,0.5928931 3.94517,1.5512501 0.970189,-0.9596717 1.782623,1.6787679 1.444766,2.4451906 z"
-         fill="#3c3c3c"
-         id="path7"
-         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
-      <path
-         d="m 38.710276,3.3208008 c 2.764643,0 5.103349,1.8746462 5.250586,4.3513877 l 0.0079,0.2497776 h -2.629237 c 0,-1.030661 -1.129258,-1.971928 -2.629237,-1.971928 -1.197618,0 -2.159919,0.6007807 -2.497776,1.3672034 -0.115686,0.1787881 -1.142404,0.1906197 -2.794879,0.2957892 -0.195878,-0.9018284 0.37861,-3.6993368 1.350113,-2.7409798 0.970189,-0.9596717 2.388662,-1.5512501 3.942542,-1.5512501 z"
-         fill="#3c3c3c"
-         id="path8"
-         style="fill:#0ac18e;fill-opacity:1;stroke-width:1.31462" />
-    </g>
-    <mask
-       id="mask0_2_1369"
-       maskUnits="userSpaceOnUse"
-       x="-17"
-       y="-18"
-       width="80"
-       height="81">
-      <path
-         d="m 63,-17.5 h -80 v 80 h 80 z"
-         fill="#f2ddbb"
-         id="path9" />
-    </mask>
-    <g
-       mask="url(#mask0_2_1369)"
-       id="g12"
-       transform="matrix(1.3146186,0,0,1.3146186,-5.3294492,-7.1961488)"
-       style="display:inline;fill:#0ac18e;fill-opacity:1">
-      <path
-         d="m 31.556,28 c 1.119,0.001 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 c -1.119,0 -2.201,-0.411 -3.017,-1.176 C 32.767,30.225 32.175,30 31.556,30 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L 23.872,30.636 C 23.433,30.225 22.842,30 22.222,30 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C 14.1,30.225 13.509,30 12.889,30 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.74501,1.116 -2.77801,1.17 l -0.23901,0.006 v -2 c 0.551,0 1.07901,-0.178 1.49801,-0.506 l 0.15199,-0.13 C 10.688,28.411 11.77,28.001 12.889,28 c 1.119,0.001 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.62,0 1.211,-0.225 1.649,-0.636 0.816,-0.765 1.898,-1.175 3.018,-1.176 z"
-         fill="#3c3c3c"
-         id="path10"
-         style="fill:#0ac18e;fill-opacity:1" />
-      <path
-         d="m 59.209,28 c 1.119,0.001 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 c -1.119,0 -2.201,-0.411 -3.017,-1.176 C 60.42,30.225 59.828,30 59.209,30 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L 51.525,30.636 C 51.086,30.225 50.495,30 49.875,30 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C 41.753,30.225 41.162,30 40.542,30 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.745,1.116 -2.778,1.17 l -0.239,0.006 v -2 c 0.551,0 1.079,-0.178 1.498,-0.506 l 0.152,-0.13 c 0.816,-0.765 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.62,0 1.211,-0.225 1.649,-0.636 0.816,-0.765 1.898,-1.175 3.018,-1.176 z"
-         fill="#3c3c3c"
-         id="path11"
-         style="fill:#0ac18e;fill-opacity:1" />
-      <path
-         d="m 3.709,28 c 1.119,0.001 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 C 7.256,31.812 6.174,31.401 5.358,30.636 4.92,30.225 4.328,30 3.709,30 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898001,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L -3.975,30.636 C -4.414,30.225 -5.005,30 -5.625,30 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C -13.747,30.225 -14.338,30 -14.958,30 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.745,1.116 -2.778,1.17 l -0.239,0.006 v -2 c 0.551,0 1.079,-0.178 1.498,-0.506 l 0.152,-0.13 c 0.816,-0.765 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,0.001 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.620001,0 1.211,-0.225 1.649,-0.636 C 1.507,28.411 2.589,28.001 3.709,28 Z"
-         fill="#3c3c3c"
-         id="path12"
-         style="fill:#0ac18e;fill-opacity:1" />
-    </g>
-    <mask
-       id="mask1_2_1369"
-       maskUnits="userSpaceOnUse"
-       x="-17"
-       y="-18"
-       width="80"
-       height="81">
-      <path
-         d="m 63,-17.5 h -80 v 80 h 80 z"
-         fill="#f2ddbb"
-         id="path13" />
-    </mask>
-    <g
-       mask="url(#mask1_2_1369)"
-       id="g16"
-       transform="matrix(1.3146186,0,0,1.3146186,-5.3294492,-7.1961488)"
-       style="display:inline;fill:#0ac18e;fill-opacity:1">
-      <path
-         d="m 31.556,33 c 1.119,10e-4 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 c -1.119,0 -2.201,-0.411 -3.017,-1.176 C 32.767,35.225 32.175,35 31.556,35 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L 23.872,35.636 C 23.433,35.225 22.842,35 22.222,35 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C 14.1,35.225 13.509,35 12.889,35 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.74501,1.116 -2.77801,1.17 l -0.23901,0.006 v -2 c 0.551,0 1.07901,-0.178 1.49801,-0.506 l 0.15199,-0.13 C 10.688,33.411 11.77,33.001 12.889,33 c 1.119,10e-4 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.62,0 1.211,-0.225 1.649,-0.636 0.816,-0.765 1.898,-1.175 3.018,-1.176 z"
-         fill="#3c3c3c"
-         id="path14"
-         style="fill:#0ac18e;fill-opacity:1" />
-      <path
-         d="m 59.209,33 c 1.119,10e-4 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 c -1.119,0 -2.201,-0.411 -3.017,-1.176 C 60.42,35.225 59.828,35 59.209,35 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L 51.525,35.636 C 51.086,35.225 50.495,35 49.875,35 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C 41.753,35.225 41.162,35 40.542,35 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.745,1.116 -2.778,1.17 l -0.239,0.006 v -2 c 0.551,0 1.079,-0.178 1.498,-0.506 l 0.152,-0.13 c 0.816,-0.765 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.62,0 1.211,-0.225 1.649,-0.636 0.816,-0.765 1.898,-1.175 3.018,-1.176 z"
-         fill="#3c3c3c"
-         id="path15"
-         style="fill:#0ac18e;fill-opacity:1" />
-      <path
-         d="m 3.709,33 c 1.119,10e-4 2.201,0.411 3.016,1.176 0.39,0.365 0.901,0.584 1.444,0.628 l 0.206,0.008 v 2 C 7.256,36.812 6.174,36.401 5.358,35.636 4.92,35.225 4.328,35 3.709,35 c -0.62,0 -1.212,0.225 -1.65,0.636 -0.816,0.765 -1.898001,1.176 -3.017,1.176 -1.039,0 -2.047,-0.354 -2.838,-1.017 L -3.975,35.636 C -4.414,35.225 -5.005,35 -5.625,35 c -0.62,0 -1.211,0.225 -1.649,0.636 -0.816,0.765 -1.899,1.176 -3.018,1.176 -1.119,0 -2.201,-0.411 -3.017,-1.176 C -13.747,35.225 -14.338,35 -14.958,35 c -0.62,0 -1.211,0.225 -1.65,0.636 -0.758,0.71 -1.745,1.116 -2.778,1.17 l -0.239,0.006 v -2 c 0.551,0 1.079,-0.178 1.498,-0.506 l 0.152,-0.13 c 0.816,-0.765 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.438,0.411 1.029,0.636 1.649,0.636 0.62,0 1.211,-0.224 1.65,-0.636 0.816,-0.764 1.898,-1.175 3.017,-1.176 1.119,10e-4 2.201,0.411 3.017,1.176 0.439,0.411 1.03,0.636 1.65,0.636 0.620001,0 1.211,-0.225 1.649,-0.636 C 1.507,33.411 2.589,33.001 3.709,33 Z"
-         fill="#3c3c3c"
-         id="path16"
-         style="fill:#0ac18e;fill-opacity:1" />
-    </g>
-  </g>
-  <defs
-     id="defs17">
-    <clipPath
-       id="clip0_2_1369">
-      <rect
-         width="45"
-         height="45"
-         fill="white"
-         id="rect17" />
-    </clipPath>
-  </defs>
-  <path
-     id="symbol_1_"
-     class="st1"
-     d="m 20.453518,14.463763 c -0.478593,-1.085294 -1.57839,-1.31734 -2.924734,-1.092545 l -0.432665,-1.677492 -1.020032,0.263468 0.425417,1.672657 c -0.268302,0.06768 -0.543857,0.125697 -0.816992,0.20304 l -0.425417,-1.662989 -1.020029,0.263467 0.432667,1.677492 c -0.219961,0.06285 -2.059399,0.534188 -2.059399,0.534188 l 0.280387,1.092544 c 0,0 0.749311,-0.210292 0.742061,-0.193371 0.415746,-0.108764 0.611534,0.09911 0.703386,0.29489 l 1.18923,4.59739 c 0.01449,0.132939 -0.0097,0.360154 -0.29489,0.437501 0.01692,0.0097 -0.742061,0.190953 -0.742061,0.190953 l 0.111181,1.27383 c 0,0 1.822518,-0.466507 2.061816,-0.526934 l 0.437501,1.696828 1.020031,-0.263467 -0.437503,-1.708915 c 0.280389,-0.06527 0.553524,-0.13294 0.819409,-0.20304 l 0.435084,1.699246 1.020031,-0.263466 -0.4375,-1.694413 c 1.571136,-0.381906 2.680601,-1.372932 2.453391,-2.888475 -0.145029,-0.913677 -1.143305,-1.66299 -1.972382,-1.747588 0.510015,-0.452004 0.768648,-1.111882 0.452004,-1.974799 z m -0.490679,4.000357 c 0.20304,1.50104 -1.882947,1.684744 -2.57183,1.866028 l -0.59945,-2.245519 c 0.6913,-0.181284 2.828047,-0.942681 3.17128,0.379491 z M 18.70593,15.406444 c 0.215123,1.33426 -1.568721,1.488956 -2.143999,1.6364 l -0.546273,-2.037645 c 0.577696,-0.14261 2.252771,-0.83391 2.690272,0.401245 z"
-     style="fill:#ffffff;stroke-width:0.0241713" />
-</svg>
diff --git a/website/static/img/fundme.png b/website/static/img/fundme.png
new file mode 100644
index 0000000000000000000000000000000000000000..ecb82517f745410d8f4012226bb16403b5e62514
GIT binary patch
literal 781018
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%0Al24>WvI%r81-SLd3$E8G$6CljC2KLe=e&9#`
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

literal 0
HcmV?d00001

diff --git a/website/static/img/slp.png b/website/static/img/slp.png
deleted file mode 100644
index f7dd8c4a2208b017f5214c090399ee7eeb9f96b1..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6110
zcmaJ^cU)6hx4obOf{`Xj6GK2iS_qv;FA;R;VCWJ^XbOoCA%GO6qjUu6Lq|ZmNJph8
zT|_{nhye*m301245@+W7-XCw?{UbT&+_m>!XRmed{herI!>b@h9!3BFK>B(*rT{>b
zKp6)!&{2M0eM*5+{<!hFmUuI)Gu{{Fg#k3tSVs(4-vi}>F~y+Jes_8?DgbZ-;%07%
zw>0<z?u7M_LQyeN1P>e~8UR$(2{@F~Eesy)h;ecARE3aRIv`*-v?>HCZy;@e)5f^E
z>G^wM%=`__o&0Y(DWf6kYG4%toRYu;gGYf09=AQc;RIF4@4Rrzn7RywfPX{qw^Sj2
zk+L)}25V!zFkpEpX-Ow(1sGUCP6{R`tt_W30hW=5Nkd^WP-#U;m^55o5iSh_|9wFy
z)x6Noa8n(`-?b<+RfsDdkAp*@zP`RvzOqtSFBd3GSy>q>Ed!O2k)$9bz5P7#D1xM?
zx8Oe+bTHmdUT!$N8`cv{&4_Zu-o>jzC`|v_f(PzDX+6FFZWE<pPyz}Eg-J<MxAYIt
zz~KLfdU*T??Tt6Z{Fm?lnb_Oh4~K!8V!W|;y__h*ISW!t;o#a{7!)4sWsb$({-=w^
zu2?+Q+ZBrgYn#bS!N5p2Pc+uo`#0Xe0Iu)pjYoMpVf1xWA(RYKZf<C}rUF7<OIJn?
zAuF#7gXt=1Dl5X2m0+53ax%I~y4u?R#Oh$3?s{N6@&Cl4{~Ig+ud!4sc;G0NbueCT
zJ{UB@3+n;?y=A!DzjKlK*L;7+qW_(X?7zlBDP*8jVgHxV|1445LmmFdwv@?#jF0i8
zxZR6l>(*}{p8&u)Q+*vxbHb<9Yy;D&Yv&_)WBiT>&B84;2N)BOA>7grnF3DT=K#cC
zR=hM!Os7{8*Raye;`q~i=3v)OQ|&@_fo1CM=uFb>-k@BuuO%Apcgv4j0}n|%Bf09q
zA4WzJX#t=*^4?Ji@A1Jo+nqgcT<jPrzF&+#@FWcl5Yl!oE{@@i^d`G{BmW83bS(|a
zGb$85uh7_j5-CDbRApsjrln+HVct?$5ABCF-V)OyYEwXS8)2OsUvQGS8s3neZ9x_m
z0C26sC6s7x^Zkg)(X)SR2ZnevFaW@62~KC5Z%@8xE;>O145pA#C&JEE71V`)D251K
zr$XwHO4D=0(K4CfD%zZj2gjQ<)RJp#XRn5J&TMAxi^0@ssa%~IuZ|;L+Rgu+=$*<Y
z!MK~3#&>X^>n7!;#dC@Ohow<R@3a<$-=9{-?>b%mJdHN5l@@EVuLx2L$+2(g%syE0
z#bt|sx-=9KF!6em%hu)GBUWm?!A1M91*B`^WC+$qkNA3%WsT{62moko=k@MHGen=~
z+W2)UIQ|^;*|SVHQzZy>EARN5^P=t@xj?kMgtcl*O_UH;S4IS=H`F3t?V6<?4V^e)
z<SnFXG1w;w73OQ=KYQ{d0DL+Px;67K;Y?>}o?5UFt1{9@{6(vA*b;Y!OQ?gO0EOo1
z?_#&}SCfDWL#_oD(Y-Q)$kAaSorVSgIH;c#ax5c?oN>N*XQe#JrGTo1L&wRmkB|QB
z*V3AOi@^m-3i46q_;`~hI)M9=$eD}>`grOzYtA2}6P^0ghsqH6;|@pFc*a{}PAa7k
z*3LQqG?WarNq`{X*V`Atvrc*Qzk&64KDY;UQCk5>cU!1b?4sen<p4CMV-kM%8hE0`
z|2BCbzL8oMC{~K;>>&-sQ|SU|O?$n?V+Lvs4c4cB`2>LLYzwLv93--*oTfld<U8FZ
zZBW2}TD?11?B{HCxk#16;DL5k?&TIIw-<~<Cn(|<zZUqId#)<tK?o&AnlmYns9ntW
zo39ybFMNuR8l!Ptk8cwZ@tcN%7BME_FGdPlGUit@F8)^YNLMK1VpAkFNi{3mmX_-z
zHkh|pQ-jjQUtwJw0?S&IA@Gr**Ep;&71P0hp`<<PBgLC_qfGd}+^5{D-bL_PY#uYH
zP<xF1vJ|CAq@S?ZsLCNmbx^kf6f(Xs-mJA}OK`)fMnY;24?I>$R7xSZF!5?(u|Ow*
z)4lUI1yJNLodr%R?MO+!<~)N%Vj{t-N-%#uL+CWs?LJIb(`B_)Sd*F}_I}%6mG$gZ
zi}Q~skSg`^k6msJ{_gM`E?m$+FK6tV(#-S$>+h#YTd9Ft`p#u7nHwrukKsCWzmqY%
zsWgNLVZ(fCuX;=VwqXX8zi7|hTtaB!@s1!YG=ysPFsD)<yj}`j4nyxHs%9CN_&qmB
zx3pX1R5+u;Pf=A-+#BQ6d;xJy`q7e2FY{yseGNHX&g}l<9h-V%&>P$AaQ`NI>yAYS
zg!}4Zvl(=P-~9sMz}&`KTVrztWt{vp2`4HN5pj%=$zQRa>2EuCuo>`VqyIT}zqV4$
zzJZSBY4WSpyg6PKy3f0Lx(9yO@z?y9!cr>PMLYdlS!>gfQ*e}V=aAY@P%s-V-^8Tv
zc5-}_O6t*^pBYR^&7Gd|8ajQNdu_Yfh-=^_a?|b`ERLxwG&SLe#ASZ{h%d7Ab!zUE
zeQ;4gn;wJl61qx5@4EzVYS7h*m^8z|yZ1ovx$+Sdu@a*sLRU1y(Dr6x66RTk!f&{V
znh`&Im~>(HqbRo@Cv+Kc?TGuAiM)m}hL?rRpW9seu;ho1);s^41^_C;x|kx<Q<}|G
zR?(ps8AnL*ZO_e^Vo!ys#>Y87@Qp#<<onU)nt%0aVxz|OK@#4WiQ@m1ghw3Aw_-u-
z))C(`NXjasLZdfOfg_F3fXT&vdC5t;Fj|=>i7ywzPw@BGrJkal=Q!r0_>K9>%v0<y
z<I==@cDjq&ycIC>A`x)wM8R9$cQ?0(U*pcJ?4?=X^lxCWi0>|5;x>C8W57(QW~o=|
zG}Ety!tsB?gyxCaF?WsOe0zGHCNP|F#*@q4r;25%@AL#hOvH1gGIDrKZm2ztKFxvg
z#*z0*wGeb-TSMn3Qmlgd4D$+b+uZ%hq-U6a{#nGKotS(SMTk|92>ngk*4ybm-B*Z2
z-Gq-L)3Nr|h@d!e$g%#j;Y$aQ_FcLl+u`e57xIrK7F1I~$7k)H^B~&vj_KO=g17c)
z^KgJ`Zb;Vp%W4(TOpTz>$=pYu)tN=e$RoQ5<>7VlxX;hw7nR%y$l;OGGU>l6c8-%Z
z1N--vtz7l!Wv}+RT5i+_tv2PPWWN~YdCRMhHQzkW%xsJgTPP<2*+=t}m7KMBc4Ct`
zM$pEkWLdAIfVaH!y8c9!LB;5(MGVqT>N)4+$C3+0%ffK~pl5#eMHh5sku`E{4HgrH
zA^V8f#%z2jb7`08%DVb;)cy9;>urZNHBB{{{KrW@C9WJo9QHW(n!j|vk|Z~HhBdJo
zqy*we2q8lzN^i#PN5HIY=5T?Qa<(Chl7hy0*(V3@moG!dZEs?WM(5Bz_4~e;pZPuc
z+<3>1Z2k?}2a6UR^2>=lP+(22@U{7R<;d2%;krr2GnV89KD`mXNI@FTsez(ALIo*z
z{nGp!y6S<asB)LdZS-aSI}u6o9=rpJ76z{0zV}$n`|p^AnJYHBp1W`~(=6$g)#7{b
z{lZ`~PtkJf@jCh1uhQ|j)_I%#q1$0=I=7?)9>ZOdNH)E79-m5ThD=k)`J^3j*U>BN
zEZMUgX8rTX^emSokLp!j(ZT&Sf01@^1ST`*>X@G=(pElbB3Bvmty@aHVBOdzi;L%d
zu2_H*StilbIs<#->i{`@Z)SeE*iZRIlETcd-s<)?62lH8)id?S!xE2i{e_*;+u^xp
zL-8I@dseh9TR-?b9cg@8Gg~VBD3456LUb`X75MQ^j%O(Lur<7Q8Qzv%g7Yj{W?!9t
zXe4`V#@%j-KJ#M-!%*0=sA-xR*wjACHfiu`i-Xx{(5yce<e(1QkuedDY^*7f`-4@y
zk38|{7+!<VezLdgEc9f#XDZn%$7TBJ@~n`K$hD(s#}u$yRf>EX&sU4*y~V`_`NI~Q
zXo)@RCK69<?@*0QPX<&|IZiw)(z46{PTc*u#1)mYrinGz_Fog0@d-S0;nvTj`?r_A
z4Qe0AEEPt%-a*q<@|txEJm6>R<P-Y&*&D>nTN)JO@O3y?H!qq{xhgNLQRy6%og%>P
zzi3g}HkTWFX=dN?d@^cyfo0pYPdT{#QLtK?%)<bKnd;SDMXi?T`hfJ$gvZY1MA{s5
zqmgi@$_RQfIqI|p@nTu@b=|rdpR&TwPKYH_Go8`tjj9@fNY8xw$1eM}7HSQ@oDgKh
zo_TN3V9%cYyp1h}OY3ZhajRIo|AK+qrVMw*hx48JpKrVk0Xbh}(>6gb4V~%Bf!`Ah
zm2-Q3(<pt|ZYHe{`fFBC_{r{+P=H_W;jFB6{cAxP{i<{$3;C*>&3T#D&+|8wv=7J<
zxf74C8JzlwRhsQ%H}=%trqnt2T}saSo-U}|#YEE|^)Yp<u7|kgpMgO}n7CTL7Xw?^
z`oAFVEq(a@%(5#cY^Us9AZhmI2-lrtqn6{Ot(k#XI%cbGP*U>2+Kqn1L;!Kot@dT+
zNR?=ZAcj+Ew;w_3bM6)lpqr01jB$HYJ6L`)_GB27hqZ~39NW2!kVC~RJ*TvW%V?yt
z0y>_K18x0oDTZfIH~QXy?5NS=#K2l*5~M(FjQ<G3x_L{iA0AniloL1^Thx2#S77yh
zluaP|UJ>s!URG%(pLpzCG^M{VDHW0Hr|hz6v3B{5GRGyh#4_75SN+)l?J#uSh+w+A
z+KN>H>4ppQLb>KV)IZ)xzHPoFhIjHFJ;XAVsldNr;)=cd!co3sXz|gkXVG%4fwgs^
zjpwgE=cBu4)+X%zFCNg=9y*Z94sqXvgw%_!Hi)<1;<3G1CvbkVV2)&{uWf44zLL?k
z!nyFO-sMnGk$Eud(W)n*^6MsB#51!5&w~rI_d4P<+e?)@n!g?wJirHYjgfZazRmUk
zD&sQwDnALuJ4W0ecJ+LkX#RL1b7bQm_blWIPiXV3w#Px!b#1}-C#Rp2jbl*<MTum?
z=tEPBHZzWJ;RB3-?L(fesb|l!zF*ULAC4CCwBi6cAYJmI;$=W{xqj;flD4Ay(AoCz
zlC#Vm#iWV=aHhwtOxpJzQMd#7lx_OKqad>PCAFG;uJYZba>h^R$9yF}ho(OH-jLz_
zWA<Gz$4*qni9mJxj7HTMq)(IbE2zh^!nG&gY@(M+76NiEi+1l?S$vR6azn~{p=9Yz
zbz3&s*NSbv9PuZF6!H>v^Yh-_bu)hJN%)Lfcc<Tdw*#_@TXnnKe_8Er9zlIodbf@L
zb=gl97EYRGesq!6$g6c$MS6G&%~^JL-aXNXXCYpd(eu{1L)*e~a`Iz*UX-sNu9{!3
zIpLA1Pp6i~OM&@ve}yNn9)4b^DJIj?OgdWEABd{&$VLB=U6OEL+kL@6v9Mj!Sk1Wd
z#6z#y6Ex}P8TGbB)M$8=0S%>D>uUk6yzDP$=mA>V@3};S%rU06Aw*?rcBq319lzM;
zaSbc7twz3gSUIDA>5D|h?Td?z5gp_Y8z8*T*9O>*UUGY;WG~suqR=s$M37&YI9481
zHFPvO6&C;JqaoJHZv*Q@mbYAswHz+&i5(SrSCP7;xh<eQ#bpU}<I8~r=n9L)U7f!1
zQ3<?);U_w^lSL=P)HWOtB5~crn_uff`lA^3fC$``Tk{VWef4sZ{~X=NFS&C?LTI>o
zCSWozrzhQ*dS#Z#V7rof0n*WhhsQU*oc@TvA%%i`<7Am#|CO_Ozd2@jlgrw?A@7sQ
z33x1dpKtt(d_di1-2Ldh3GQ*RE%S$APX);(HdRY|A~Er%LD*jDZf2*d*0aMUtvHb6
zw#`t&wxW;3){4R^xJ8vcf#_XaK&O_Nd@A>Kol5N^&Oq01-0u?`RwCb%U~fp(#e(+v
znWOvsa=h(nurtK-{sPmz1jZ{MTlyOy-|dY834yG0{t#O-(Z%~p(ys{wZ_J<!u3<s*
zNA;FvUAPT$Um?7Fdar3hf>eKEI>$k{jHJVuMZB?0r(Vd27f&k_tzBu%Pv~b!e04i<
zW6`ka&E$yt#^knfP6TlG=lDa8dd&^ZpFb*4CnFqPiyimJK~j5;b^h-Hmp#-J2{-j?
z&*<S)S3va=8V4fli8zpRzvYEFjW{37P9dJ8uC%qSve{OuJz4jbWSkDVuPX9>EfTZq
zrP?4t%ByGo_!Pt(_H=9Cn*E-IQR#i{B5^vg=7?*-p^HwMp%R}>-jzEgvb4pNu-dW5
zen~5a(({)Pys<qc-dke5uI;8I{4gnYwsko{&M)n-6KS>FoR{Y2**duX1v8pyA7y~H
zAKKIDJD?F3HqdCK|1eb>Wo(VK3>;%<oo-{aRqq4IZuz!PX{lvQy=^*EX{tlEh#)uf
zyw*H;IE;kHM5bkD;g@p?(_|A-9r<#0tmTcqP45P(MDm-~G4D5g5|=h1(fV2{f86dC
z)vX|Rwk|O!Fn71V*_uf_I+8v=&>NA+H8502B8_J?K#BL;F1CmamSW`fu0FQnJn&L|
zj2hMl9c;*L=b5U6G<Q{`iS>j|iWZ%TaI_6{ySUl((CqS_XV2b>+nK6IUCApIptX&S
zIA}hLI(SX1{Y7#{j_EHRLW3u9rUjC5U0*S0!f0z7-OS`SUhZsHAW&bPqS8V<t?M?*
zaUo$>^SzI3e*&pC<k}RyR`}3kHG{TtM;==eOFW{QWxno%d%|s{o+48r)~7*l@qFV`
z4TL&dIuf_X0PBfVzL?d;dmZ733?_Z=#6)NH#Ntd;S3m}nc+#%$;D(Rs)+ZzVi8>yE
zFDkiDcRXlKKE0@^$I5mI@<^t?MlYP!YkkmRo2wsR$=JQyy^$6EWd?TJ0#nseGO#xy
zQKUE_%jUK2Fs)zEn%s<<9kJwo=XP2kIu5Cp?CXBse0{nH(WgTDQp>-S6!CeOnG7R?
zi;GCS<C)?$B00Lv-?Kw4N*Y~I{rB8NTsBk`lt)C54?b(%ynqbg@%G4m6wkkF926~%
zUGeyXNzC@frOI!Q?oREj+$&j7+<NV6tDf6lt}t9^-xYyaEYit}yxzk*`*zXPv15)K
ze`6r~L-~GyuWXlT?-A7eXIYKP`UfB3sk97?GH8W+7^Tx`UJ~7)i`hLQCtRN#(^zps
z<n)wSHc1q%9f}3)nzZuWCFy+3St@EN#iuxq8NzE&Wz5mdHxzypwtZYNNi9$h{#ja3
zAgJeNh6+7SUAbQvTXzD-wf2SeD$VLyoq5VB51<@<S5;>~%zPRel;drv**O~OsrEK*
z;%8)NGZ+j2#&6vpTc7MYK|O|B3l%WTGf*yI4rq-u>^<t;)<gLB^r%r*9EQ6E;bVA5
zzhFGUl8=vuasjJNgoFtV`u@bIGnd#Zop2rHN?SOu7fNv<u7HRrEuaxgi2hXv-q19Y
zi>%?63eyceIgjvIKZ=4d3#Rf@h*VGDmi!rKpYS7cPHFGCB@)0fzS=KYIDtQdSidX{
zj<Ol0i^WATZHCa(0!q@X0_6J;sCo=Z(`BmV)GS@}DUkOd3^n@)OYC`|`pS*Gv3UvU
fHzQ|%LSF*1s+}(%0@hZP76AIXhB}p64iEkZExq5P


From ad50ad8ae09e6ca7bfb627f32b03831b83264182 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 24 Sep 2024 11:19:33 +0200
Subject: [PATCH 129/267] Update node version in github actions

---
 .github/workflows/github-actions.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/github-actions.yml b/.github/workflows/github-actions.yml
index a536b5d2..3dca4218 100644
--- a/.github/workflows/github-actions.yml
+++ b/.github/workflows/github-actions.yml
@@ -25,7 +25,7 @@ jobs:
       - name: Setup node
         uses: actions/setup-node@v3
         with:
-          node-version: 16
+          node-version: 20
       - run: yarn
       - run: yarn test -- -- --coverage
       - run: yarn lint

From 037757ad1c816cb9f257c23cd32efb5656d33a7a Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 24 Sep 2024 11:39:57 +0200
Subject: [PATCH 130/267] Fix failing github actions test + use mocknet for
 github actions tests

---
 .github/workflows/github-actions.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/github-actions.yml b/.github/workflows/github-actions.yml
index 3dca4218..eba0753a 100644
--- a/.github/workflows/github-actions.yml
+++ b/.github/workflows/github-actions.yml
@@ -27,6 +27,6 @@ jobs:
         with:
           node-version: 20
       - run: yarn
-      - run: yarn test -- -- --coverage
+      - run: TESTS_USE_MOCKNET=true yarn test -- -- --coverage --coverageProvider=v8
       - run: yarn lint
       - run: yarn spellcheck

From 1d2b05f5b2a6bef62193f7fb877bfa851b3c8b67 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 24 Sep 2024 11:52:53 +0200
Subject: [PATCH 131/267] Fix spellcheck

---
 .cspell.json                                  | 27 ++++++++++++++++++-
 packages/cashscript/src/LibauthTemplate.ts    |  2 +-
 packages/cashscript/src/Transaction.ts        |  2 +-
 packages/cashscript/src/TransactionBuilder.ts |  2 +-
 packages/cashscript/test/debugging.test.ts    |  2 +-
 website/docs/basics/about-bch.md              |  4 +--
 website/docs/basics/getting-started.md        |  4 +--
 website/docs/guides/debugging.md              | 12 ++++-----
 website/docs/guides/optimization.md           |  4 +--
 website/docs/language/globals.md              |  2 +-
 website/docs/sdk/examples.md                  |  8 +++---
 website/docs/sdk/instantiation.md             |  2 +-
 website/docs/sdk/transactions-advanced.md     |  8 +++---
 website/docs/showcase.md                      |  4 +--
 website/src/pages/index.js                    | 12 ++++-----
 15 files changed, 60 insertions(+), 35 deletions(-)

diff --git a/.cspell.json b/.cspell.json
index e7ea603c..6fd7d3a6 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -33,6 +33,7 @@
         "cashc",
         "cashproof",
         "cashscript",
+        "cashtokens",
         "castable",
         "checkdatasig",
         "checkdatasigverify",
@@ -79,6 +80,7 @@
         "INPUTBYTECODE",
         "INPUTINDEX",
         "INPUTSEQUENCENUMBER",
+        "ints",
         "kalis",
         "keypair",
         "keypairs",
@@ -98,6 +100,7 @@
         "meep",
         "minimaldata",
         "minimalif",
+        "mocknet",
         "n",
         "noncompressed",
         "nonschnorr",
@@ -109,6 +112,7 @@
         "numequal",
         "numequalverify",
         "numnotequal",
+        "NOTEQUAL",
         "op",
         "opcode",
         "opcodes",
@@ -156,14 +160,19 @@
         "sigs",
         "spedn",
         "startup",
+        "standardness",
         "tagline",
         "teardown",
         "tendo",
         "timeout",
+        "timeops",
+        "timelock",
+        "timelocks",
         "toaltstack",
         "troutner",
         "tuple",
         "tuples",
+        "typeof",
         "txid",
         "TXINPUTCOUNT",
         "TXLOCKTIME",
@@ -171,6 +180,8 @@
         "txvalue",
         "TXVERSION",
         "unary",
+        "unlocker",
+        "unlockers",
         "utxo",
         "utxo's",
         "UTXOBYTECODE",
@@ -185,29 +196,43 @@
         "workdir"
     ],
     "ignoreWords": [
+        "bitcats",
         "bitcoincashjs",
+        "branchup",
+        "bchguru",
         "cashcompiler",
+        "cashninjas",
         "cherian",
+        "CSCriptNum",
         "docu",
+        "fundme",
+        "hardhat",
         "infima",
         "jedex",
         "lichos",
+        "mainnetjs",
         "maxdepth",
         "networkprovider",
         "outputnulldata",
         "outputp",
+        "pako",
+        "popd",
+        "pushd",
         "setfiletype",
         "tada",
+        "tapswap",
         "txage",
         "txbytecode",
         "txhashoutputs",
         "txtime",
+        "vite",
         "withage",
         "withfeeperbyte",
         "withhardcodedfee",
         "withminchange",
         "withopreturn",
-        "withtime"
+        "withtime",
+        "XBVJRKV"
     ],
     "ignorePaths": [
         // Do not spellcheck NPM files
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index d7abb633..d348425e 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -101,7 +101,7 @@ export const buildTemplate = async ({
       };
 
       // add extra unlocking and locking script for P2PKH inputs spent alongside our contract
-      // this is needed for correct cross-referrences in the template
+      // this is needed for correct cross-references in the template
       template.scripts[unlockScriptName] = {
         name: unlockScriptName,
         script:
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 11a9e60a..f3ff1373 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -278,7 +278,7 @@ export class Transaction {
       // Compare nfts in- and outputs, check if inputs have nfts corresponding to outputs
       // Keep list of nfts in inputs without matching output
       // First check immutable nfts, then mutable & minting nfts together
-      // This is so an immutible input gets matched first and is removed from the list of unused nfts
+      // This is so an immutable input gets matched first and is removed from the list of unused nfts
       let unusedNfts = listNftsInputs;
       for (const nftInput of listNftsInputs) {
         if (nftInput.capability === 'none') {
diff --git a/packages/cashscript/src/TransactionBuilder.ts b/packages/cashscript/src/TransactionBuilder.ts
index f9c02e92..6b2049c1 100644
--- a/packages/cashscript/src/TransactionBuilder.ts
+++ b/packages/cashscript/src/TransactionBuilder.ts
@@ -52,7 +52,7 @@ export class TransactionBuilder {
       (!unlocker && utxos.some((utxo) => !isUnlockableUtxo(utxo)))
       || (unlocker && utxos.some((utxo) => isUnlockableUtxo(utxo)))
     ) {
-      throw new Error('Either all UTXOs must have an individual unlocker speciifed, or no UTXOs must have an individual unlocker specified and a shared unlocker must be provided');
+      throw new Error('Either all UTXOs must have an individual unlocker specified, or no UTXOs must have an individual unlocker specified and a shared unlocker must be provided');
     }
 
     if (!unlocker) {
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 6e8a87db..85d0ac69 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -694,7 +694,7 @@ describe('Debugging tests', () => {
     });
 
     // test_multiline_non_require_error
-    it('should fail with correct error message and statament when a multiline non-require statement fails', async () => {
+    it('should fail with correct error message and statement when a multiline non-require statement fails', async () => {
       const contract = new Contract(artifact3, [], { provider });
 
       provider.addUtxo(contract.address, randomUtxo());
diff --git a/website/docs/basics/about-bch.md b/website/docs/basics/about-bch.md
index 47f022b5..6a60ba5c 100644
--- a/website/docs/basics/about-bch.md
+++ b/website/docs/basics/about-bch.md
@@ -5,7 +5,7 @@ sidebar_label: About Bitcoin Cash
 
 Bitcoin Cash (ticker BCH) is one of the biggest cryptocurrencies. Bitcoin Cash is a fork of Bitcoin started in 2017 because of differences in vision for the future of the Bitcoin project.
 
-Bitcoin Cash shares many of the same fundamentals as Bitcoin (BTC) like the *Proof-of-Work* consensus alrgorithm and the *UTXO data-model*. However regarding smart contract programmability, Bitcoin Cash has significantly diverged from Bitcoin (BTC). We will first cover the UTXO data model and then delve into the smart contract capabilities of Bitcoin Cash.
+Bitcoin Cash shares many of the same fundamentals as Bitcoin (BTC) like the *Proof-of-Work* consensus algorithm and the *UTXO data-model*. However regarding smart contract programmability, Bitcoin Cash has significantly diverged from Bitcoin (BTC). We will first cover the UTXO data model and then delve into the smart contract capabilities of Bitcoin Cash.
 
 :::info
 To learn more about the Bitcoin Basics refer to the book ['Mastering Bitcoin'](https://github.com/bitcoinbook/bitcoinbook). There is also a modified version for BCH specifically called ['Mastering Bitcoin Cash'](https://github.com/Bitcoin-com/mastering-bitcoin-cash).
@@ -31,4 +31,4 @@ The locking and unlocking scripts of regular transactions and smart contracts on
 
 ### CashScript
 
-CashScript is a high-level programming language for smart contracts on Bitcoin Cash that offers a strong abstraction for a smoother development experience. The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum.
\ No newline at end of file
+CashScript is a high-level programming language for smart contracts on Bitcoin Cash that offers a strong abstraction for a smoother development experience. The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum.
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 113f0382..1a4f7553 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -20,7 +20,7 @@ With the CashScript playground there's a nice integrated editor to get started,
 
 To write CashScript smart contracts locally you use a code editor. For the best developer experience, we recommend to use VS Code with the CashScript extension. This way it will automatically recognize `.cash` files and offer highlighting and autocompletion.
 
-:::note prerequisties
+:::note prerequisites
 - Basic familiarity with the command line
 - Node.js installed
 - A code editor (VS Code recommended)
@@ -149,4 +149,4 @@ const transferDetails = await contract.functions
 console.log(transferDetails);
 ```
 
-Congrats 🎉! You've successfully created a transaction spending from a Bitcoin Cash smart contract! 
+Congrats 🎉! You've successfully created a transaction spending from a Bitcoin Cash smart contract!
diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 91d7e858..42f65c94 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -26,14 +26,14 @@ If a CashScript transaction is evaluated with `.debug()` or is sent to a network
 ```bash
 HodlVault.cash:23 Require statement failed at input 0 in contract HodlVault.cash at line 23.
 Failing statement: require(price >= priceTarget)
-Bithauth IDE: [link]
+Bitauth IDE: [link]
 ```
 
 Read the error message to see which line in the CashScript contract causes the transaction validation to fail. Investigate whether the contract function invocation is the issue (on the TypeScript SDK side) or whether the issue is in the CashScript contract itself (so you'd need to update your contract and recompile the artifact). If it is not clear **why** the CashScript contract is failing on that line, then you can use the following two strategies: console logging & Bitauth IDE stack trace.
 
 ### Console Logging
 
-To help with debugging you can add `console.log` statements to your CashScript contract file to log variables. This way you investigate whether the variables have the expected values when they get to the failing `require` statement in the CashScript file. After adding the `console.log` statements, recompile your contract so they are added to your contract's Artifact. 
+To help with debugging you can add `console.log` statements to your CashScript contract file to log variables. This way you investigate whether the variables have the expected values when they get to the failing `require` statement in the CashScript file. After adding the `console.log` statements, recompile your contract so they are added to your contract's Artifact.
 
 ### Bitauth IDE
 
@@ -50,7 +50,7 @@ const uri = await transaction.bitauthUri();
 It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
 :::
 
-The Bithauth IDE will show you the two-way mapping between the CashScript contract code generated opcodes. Here is [a Bithauth IDE link][BitauthIDE] for the basic `TransferWithTimeout` contract as an example:
+The Bitauth IDE will show you the two-way mapping between the CashScript contract code generated opcodes. Here is [a Bitauth IDE link][BitauthIDE] for the basic `TransferWithTimeout` contract as an example:
 
 ```js
 // "TransferWithTimeout" contract constructor parameters
@@ -73,7 +73,7 @@ OP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(send
 OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                         */
 OP_1 OP_NIP                                     /*     }                                                                        */
 OP_ENDIF                                        /* }                                                                            */
-                                                /*      
+                                                /*
 ```
 
 ## Advanced Transaction Builder
@@ -88,12 +88,12 @@ When a transaction gets rejected by a full node, it will return a cryptic error
 mandatory-script-verify-flag-failed (Script failed an OP_VERIFY operation) (code 16)
 ```
 
-Read the message carefully to investigate whether the issue is a failing script (failing OpCode) or whether a standardness rule like minimum-relay-fee is violated. 
+Read the message carefully to investigate whether the issue is a failing script (failing OpCode) or whether a standardness rule like minimum-relay-fee is violated.
 If the cause is a failing OpCode, you can check the contract's Artifact to see how many appearances this OpCode has. Sometimes the OpCode only appears once or twice, indicating where the failing `require` statement is. Other times you might see 15 appearances of the OpCode leaving you to try the next strategies.
 
 ### Removing Contract Checks
 
-If your contract fails, you can remove (or comment out) the lines that are the likely cause of the error. After recompiling to a new Artifact you can test whether the remaining subcontract works or fails with a different error. If this is the case, then you learned that there is an issue in the removed CashScript code block. In the worst case, when you have no indication from the failing opcode (previous strategy), then you will have to try to remove different parts of your contract and try different sub-contracts repeatedly. 
+If your contract fails, you can remove (or comment out) the lines that are the likely cause of the error. After recompiling to a new Artifact you can test whether the remaining subcontract works or fails with a different error. If this is the case, then you learned that there is an issue in the removed CashScript code block. In the worst case, when you have no indication from the failing opcode (previous strategy), then you will have to try to remove different parts of your contract and try different sub-contracts repeatedly.
 
 To use this strategy effectively, the contract setup with funding should be automated as to avoid having to send testnet coins manually to each different subcontract. However inefficient, this strategy should always be able to get you to find the failing line in your CashScript contract. Then you can investigate whether the issue is the contract invocation or the `require` statement in the CashScript file.
 
diff --git a/website/docs/guides/optimization.md b/website/docs/guides/optimization.md
index ad5f6ec3..3ee0ad89 100644
--- a/website/docs/guides/optimization.md
+++ b/website/docs/guides/optimization.md
@@ -109,7 +109,7 @@ console.log(contract.opcount);
 console.log(contract.bytesize);
 ```
 
-With this workflow, you can make changes to the contract and the run the JavaScript program to 
+With this workflow, you can make changes to the contract and the run the JavaScript program to
 get an accurate measure of how the bytesize of your contract changes with different optimizations.
 
 ## To optimize or not to optimize?
@@ -120,5 +120,5 @@ In the context of optimizing contract bytecode, there's an important remark to c
 
 >We should forget about small efficiencies, say about 97% of the time: premature optimization is the root of all evil. Yet we should not pass up our opportunities in that critical 3%.
 
-It's worth considering whether optimizing the redeem script is necessary at all. If the contract is accepted by the network, and there is no glaring inefficiency in the bytecode, perhaps the best optimization is to not to obsess prematurely about things like blocksize.
+It's worth considering whether optimizing the redeem script is necessary at all. If the contract is accepted by the network, and there is no glaring inefficiency in the bytecode, perhaps the best optimization is to not to obsess prematurely about things like block size.
 
diff --git a/website/docs/language/globals.md b/website/docs/language/globals.md
index a7780193..8b40a77f 100644
--- a/website/docs/language/globals.md
+++ b/website/docs/language/globals.md
@@ -71,7 +71,7 @@ int tx.locktime
 Represents the `nLocktime` field of the transaction. This is similar to the [`tx.time`][tx.time] global variable but `tx.time` can only be used in `require` statements, not for variable declaration.
 
 :::tip
- The usecase for `tx.locktime` is to read the `nLocktime` value and add to the local state. Example usage for this is demonstrated in the [Sablier example](/docs/guides/covenants#keeping-local-state-in-nfts).
+ The use case for `tx.locktime` is to read the `nLocktime` value and add to the local state. Example usage for this is demonstrated in the [Sablier example](/docs/guides/covenants#keeping-local-state-in-nfts).
 :::
 
 ### tx.inputs
diff --git a/website/docs/sdk/examples.md b/website/docs/sdk/examples.md
index 583013c0..2ac0ccd1 100644
--- a/website/docs/sdk/examples.md
+++ b/website/docs/sdk/examples.md
@@ -14,11 +14,11 @@ We will break up the development of the smart contract application in 4 manageab
 
 ### Creating the keypairs
 
-To put the `HodlVault.cash` contract to use in a TypeScript application, we have to use the CashScript SDK in combination with a BCH library such as [Libauth][libauth], [Mainnetjs][mainnetjs] or [BCHJS][bchjs]. These libraries are used to generate public/private keys for the contract participants. 
+To put the `HodlVault.cash` contract to use in a TypeScript application, we have to use the CashScript SDK in combination with a BCH library such as [Libauth][libauth], [Mainnetjs][mainnetjs] or [BCHJS][bchjs]. These libraries are used to generate public/private keys for the contract participants.
 In this example we'll use [Libauth][libauth] to generate the keys `alicePriv`, `alicePub`, `oracle` & `oraclePub`. Then we can use these keys to create the smart contract.
 
 :::caution
-These 'private keys' are public just for testing, in other contexts you want to very carefully treat private keys as `environment variables`. You would also make sure to use a secure seed phrase and not 'CashScript Examples'... 
+These 'private keys' are public just for testing, in other contexts you want to very carefully treat private keys as `environment variables`. You would also make sure to use a secure seed phrase and not 'CashScript Examples'...
 :::
 
 ```ts title="common.ts"
@@ -116,7 +116,7 @@ export class PriceOracle {
 
 ### Sending a Transaction
 
-Finnally, we can put all of this together to create a working smart contract application. We use the generated keys as a contract arguments directly or in a `SignatureTemplate` to create a transaction signature.
+Finally, we can put all of this together to create a working smart contract application. We use the generated keys as a contract arguments directly or in a `SignatureTemplate` to create a transaction signature.
 
 ```ts title="hodl_vault.ts"
 import { stringify } from '@bitauth/libauth';
@@ -163,4 +163,4 @@ console.log(stringify(tx));
 [bchjs]: https://bchjs.fullstack.cash/
 [mainnetjs]: https://mainnet.cash/
 [libauth]: https://libauth.org/
-[github-examples]: https://github.com/CashScript/cashscript/tree/master/examples
\ No newline at end of file
+[github-examples]: https://github.com/CashScript/cashscript/tree/master/examples
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index bfeb15cb..28142d9d 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -62,7 +62,7 @@ contract.address: string
 A contract's regular address (without token-support) can be retrieved through the `address` member field.
 
 :::note
-Wallets will not allow you to send CashTokens to this address. For that you must use the [tokenAddress](#tokenaddress) below. Wallets which have not upgraded might not recognize this new address type.
+Wallets will not allow you to send CashTokens to this address. For that you must use the [tokenAddress](#tokenAddress) below. Wallets which have not upgraded might not recognize this new address type.
 :::
 
 #### Example
diff --git a/website/docs/sdk/transactions-advanced.md b/website/docs/sdk/transactions-advanced.md
index 4eb0c9aa..97865c00 100644
--- a/website/docs/sdk/transactions-advanced.md
+++ b/website/docs/sdk/transactions-advanced.md
@@ -43,10 +43,10 @@ It is possible to create custom unlockers by implementing the `Unlocker` interfa
 
 #### Example
 ```ts
-import { contract, aliceTemplate, aliceAdress, transactionBuilder } from './somewhere.js';
+import { contract, aliceTemplate, aliceAddress, transactionBuilder } from './somewhere.js';
 
 const contractUtxos = await contract.getUtxos();
-const aliceUtxos = await provider.getUtxos(aliceAdress);
+const aliceUtxos = await provider.getUtxos(aliceAddress);
 
 transactionBuilder.addInput(contractUtxos[0], contract.unlock.spend());
 transactionBuilder.addInput(aliceUtxos[0], aliceTemplate.unlockP2PKH());
@@ -69,10 +69,10 @@ Adds a list of input UTXOs, either with a single shared unlocker or with individ
 
 #### Example
 ```ts
-import { contract, aliceTemplate, aliceAdress, transactionBuilder } from './somewhere.js';
+import { contract, aliceTemplate, aliceAddress, transactionBuilder } from './somewhere.js';
 
 const contractUtxos = await contract.getUtxos();
-const aliceUtxos = await provider.getUtxos(aliceAdress);
+const aliceUtxos = await provider.getUtxos(aliceAddress);
 
 // Use a single unlocker for all inputs you're adding at a time
 transactionBuilder.addInputs(contractUtxos, contract.unlock.spend());
diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index 1ec20d9c..4ea23280 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -58,7 +58,7 @@ The CashTokens Studio is an application for creating CashTokens and for their ma
     <a href="https://badgers.cash/" target="_blank"><img style={{borderRadius: '100%'}} src="/img/badgers.png" /></a>
 </div>
 
-BadgerCoin is a fungible CashToken using a novel distibution mechanism. BadgerCoins are earned through staking Bitcoin Cash in the Badgers Smart Contract. The staking duration is predetermined, and depending on the stake amount and period you earn tokens. The website allows for anyone to invoke contract unlocks.
+BadgerCoin is a fungible CashToken using a novel distribution mechanism. BadgerCoins are earned through staking Bitcoin Cash in the Badgers Smart Contract. The staking duration is predetermined, and depending on the stake amount and period you earn tokens. The website allows for anyone to invoke contract unlocks.
 
 ## FundMe.cash
 
@@ -76,4 +76,4 @@ FundMe is a new BCH crowdfunding platform using WalletConnect. Fundme campaigns
     <a href="https://unspent.app/" target="_blank"><img src="/img/unspent_phi.png" /></a>
 </div>
 
-Unspent Phi allows users to convert Bitcoin Cash they have today into a series of periodic payments over a long period of time.  It's a set of simple contracts that rely on rolling timelocks and introspection rather than signatures; meaning as long as the correct recipients are paid, anyone may build and submit transactions. 
\ No newline at end of file
+Unspent Phi allows users to convert Bitcoin Cash they have today into a series of periodic payments over a long period of time.  It's a set of simple contracts that rely on rolling timelocks and introspection rather than signatures; meaning as long as the correct recipients are paid, anyone may build and submit transactions.
diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index 40ace446..6183bed3 100755
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -12,7 +12,7 @@ const features = [
     description: (
       <>
         The CashScript TypeScript SDK makes it easy to build smart contract transactions, both in browser or on the server.
-        By offering full type-safety, developers can be confident in the quality and reliability of their applications. 
+        By offering full type-safety, developers can be confident in the quality and reliability of their applications.
       </>
     ),
   },
@@ -20,9 +20,9 @@ const features = [
     title: 'Familiar Syntax',
     description: (
       <>
-        The CashScript syntax is based on Ethereum's smart contract language Solidity, 
-        which in turn is influenced by C++, Python, and JavaScript. This should make writing 
-        CashScript contracts feel familar even to new developers.
+        The CashScript syntax is based on Ethereum's smart contract language Solidity,
+        which in turn is influenced by C++, Python, and JavaScript. This should make writing
+        CashScript contracts feel familiar even to new developers.
       </>
     ),
   },
@@ -31,7 +31,7 @@ const features = [
     description: (
       <>
         To make it easy to get blockchain information, the CashScript SDK exports a standardized network provider to query network APIs.
-        The primary class of network providers are the electrum servers but other network providers are also supported. 
+        The primary class of network providers are the electrum servers but other network providers are also supported.
       </>
     ),
   },
@@ -41,7 +41,7 @@ const features = [
       <>
         To offer the best developer experience for debugging and automated testing easy for developers,
         CashScript has extensive debug tooling built-in.
-        This makes it possible to develop robust contract testing suites, and to debug your contracts with the Bitauth-IDE.  
+        This makes it possible to develop robust contract testing suites, and to debug your contracts with the Bitauth-IDE.
       </>
     ),
   },

From 43d7f0bb24f2dcbb88987d4622c648028879ebd7 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 1 Oct 2024 10:57:29 +0200
Subject: [PATCH 132/267] Fix debug tooling bug #213

---
 packages/cashscript/src/LibauthTemplate.ts                | 8 ++++----
 .../cashscript/test/fixture/libauth-template/fixtures.ts  | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index d348425e..e07faa14 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -293,7 +293,7 @@ const generateTemplateScenarioTransaction = (
       outpointIndex: input.outpointIndex,
       outpointTransactionHash: binToHex(input.outpointTransactionHash),
       sequenceNumber: input.sequenceNumber,
-      unlockingBytecode: generateTemplateScenarioBytecode(csInput, `p2pkh_placeholder_unlock_${index}`, index === slotIndex),
+      unlockingBytecode: generateTemplateScenarioBytecode(csInput, `p2pkh_placeholder_unlock_${index}`, `placeholder_key_${index}`, index === slotIndex),
     } as WalletTemplateScenarioInput;
   });
 
@@ -330,7 +330,7 @@ const generateTemplateScenarioSourceOutputs = (
 
   return csTransaction.inputs.map((input, index) => {
     return {
-      lockingBytecode: generateTemplateScenarioBytecode(input, `p2pkh_placeholder_lock_${index}`, index === slotIndex),
+      lockingBytecode: generateTemplateScenarioBytecode(input, `p2pkh_placeholder_lock_${index}`, `placeholder_key_${index}`, index === slotIndex),
       valueSatoshis: Number(input.satoshis),
       token: serialiseTokenDetails(input.token),
     };
@@ -339,7 +339,7 @@ const generateTemplateScenarioSourceOutputs = (
 
 // Used for generating the locking / unlocking bytecode for source outputs and inputs
 const generateTemplateScenarioBytecode = (
-  input: Utxo, p2pkhScriptName: string, insertSlot?: boolean,
+  input: Utxo, p2pkhScriptName: string, placeholderKeyName: string, insertSlot?: boolean,
 ): WalletTemplateScenarioBytecode | ['slot'] => {
   if (isUtxoP2PKH(input)) {
     return {
@@ -347,7 +347,7 @@ const generateTemplateScenarioBytecode = (
       overrides: {
         keys: {
           privateKeys: {
-            placeholder_key: binToHex(input.template.privateKey),
+            [placeholderKeyName]: binToHex(input.template.privateKey),
           },
         },
       },
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 9dc021b6..335f9fff 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -1064,7 +1064,7 @@ export const fixtures: Fixture[] = [
                   'overrides': {
                     'keys': {
                       'privateKeys': {
-                        'placeholder_key': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                        'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
                       },
                     },
                   },
@@ -1087,7 +1087,7 @@ export const fixtures: Fixture[] = [
                   'overrides': {
                     'keys': {
                       'privateKeys': {
-                        'placeholder_key': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                        'placeholder_key_2': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
                       },
                     },
                   },
@@ -1114,7 +1114,7 @@ export const fixtures: Fixture[] = [
                 'overrides': {
                   'keys': {
                     'privateKeys': {
-                      'placeholder_key': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
                     },
                   },
                 },
@@ -1133,7 +1133,7 @@ export const fixtures: Fixture[] = [
                 'overrides': {
                   'keys': {
                     'privateKeys': {
-                      'placeholder_key': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      'placeholder_key_2': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
                     },
                   },
                 },

From e69aaa9a4da041042e5637db8efbb61ccdd7a0da Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 1 Oct 2024 10:59:02 +0200
Subject: [PATCH 133/267] Fix network for MockNetworkProvider (#207)

---
 packages/cashscript/src/interfaces.ts                  | 1 +
 packages/cashscript/src/network/MockNetworkProvider.ts | 2 +-
 packages/cashscript/src/utils.ts                       | 1 +
 3 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/cashscript/src/interfaces.ts b/packages/cashscript/src/interfaces.ts
index 5ebd13c6..583becfb 100644
--- a/packages/cashscript/src/interfaces.ts
+++ b/packages/cashscript/src/interfaces.ts
@@ -104,6 +104,7 @@ export const Network = {
   TESTNET3: literal('testnet3'),
   TESTNET4: literal('testnet4'),
   CHIPNET: literal('chipnet'),
+  MOCKNET: literal('mocknet'),
   REGTEST: literal('regtest'),
 };
 
diff --git a/packages/cashscript/src/network/MockNetworkProvider.ts b/packages/cashscript/src/network/MockNetworkProvider.ts
index 501ba9b8..de771e95 100644
--- a/packages/cashscript/src/network/MockNetworkProvider.ts
+++ b/packages/cashscript/src/network/MockNetworkProvider.ts
@@ -12,7 +12,7 @@ const carolAddress = 'bchtest:qqsr7nqwe6rq5crj63gy5gdqchpnwmguusmr7tfmsj';
 export default class MockNetworkProvider implements NetworkProvider {
   private utxoMap: Record<string, Utxo[]> = {};
   private transactionMap: Record<string, string> = {};
-  public network: Network = Network.CHIPNET;
+  public network: Network = Network.MOCKNET;
 
   constructor() {
     for (let i = 0; i < 3; i += 1) {
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index 718febb2..b9dca04b 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -270,6 +270,7 @@ export function getNetworkPrefix(network: string): 'bitcoincash' | 'bchtest' | '
     case Network.TESTNET4:
     case Network.TESTNET3:
     case Network.CHIPNET:
+    case Network.MOCKNET:
       return 'bchtest';
     case Network.REGTEST:
       return 'bchreg';

From d2b760b197eeb380e2956f1a4bcbe44c59a4372d Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 1 Oct 2024 11:30:35 +0200
Subject: [PATCH 134/267] Add test verifying that issues #209 and #210 were
 with the playground, not library

---
 packages/cashscript/test/Contract.test.ts | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/cashscript/test/Contract.test.ts b/packages/cashscript/test/Contract.test.ts
index 2f1508e1..a90d5a6f 100644
--- a/packages/cashscript/test/Contract.test.ts
+++ b/packages/cashscript/test/Contract.test.ts
@@ -3,7 +3,9 @@ import { placeholder } from '@cashscript/utils';
 import {
   Contract,
   ElectrumNetworkProvider,
+  MockNetworkProvider,
   Network,
+  randomUtxo,
   SignatureTemplate,
 } from '../src/index.js';
 import {
@@ -110,6 +112,21 @@ describe('Contract', () => {
     });
   });
 
+  describe('getUtxos', () => {
+    it('should return utxos for existing contract on mocknet', async () => {
+      const provider = new MockNetworkProvider();
+      const instance = new Contract(p2pkhArtifact, [alicePkh], { provider });
+
+      provider.addUtxo(instance.address, randomUtxo());
+
+      const utxos = await instance.getUtxos();
+      const utxosFromProvider = await provider.getUtxos(instance.address);
+
+      expect(utxos).toHaveLength(1);
+      expect(utxos).toEqual(utxosFromProvider);
+    });
+  });
+
   describe('Contract functions', () => {
     let instance: Contract;
     let bbInstance: Contract;

From 0dd95d5b05a438ac1884bdb2252aec6a4c77e5b2 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 1 Oct 2024 11:33:22 +0200
Subject: [PATCH 135/267] Bump version to 0.10.1 and add release notes for it

---
 examples/package.json                  | 6 +++---
 examples/testing-suite/package.json    | 6 +++---
 packages/cashc/package.json            | 4 ++--
 packages/cashc/src/index.ts            | 2 +-
 packages/cashscript/package.json       | 4 ++--
 packages/utils/package.json            | 2 +-
 website/docs/releases/release-notes.md | 6 ++++++
 7 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index c379660e..4b409753 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -14,8 +14,8 @@
     "@bitauth/libauth": "^3.0.0",
     "@types/node": "^12.7.8",
     "bip39": "^3.0.4",
-    "cashc": "^0.10.0",
-    "cashscript": "^0.10.0",
+    "cashc": "^0.10.1",
+    "cashscript": "^0.10.1",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 7c0582ce..683610a6 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -25,8 +25,8 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "cashc": "^0.10.0",
-    "cashscript": "^0.10.0",
+    "cashc": "^0.10.1",
+    "cashscript": "^0.10.1",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index b9ec4434..42282d96 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.0",
+    "@cashscript/utils": "^0.10.1",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 72b37416..e405f28e 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.0';
+export const version = '0.10.1';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 4a8d48ba..66af3c71 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.0",
+    "@cashscript/utils": "^0.10.1",
     "bip68": "^1.0.4",
     "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index c8806c62..61a0a452 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 37debfbf..0d9242e6 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,6 +2,12 @@
 title: Release Notes
 ---
 
+## v0.10.1
+
+#### CashScript SDK
+- :bug: Fix bug with `MockNetworkProvider` returning the wrong `Network` type (now returns `Network.MOCKNET` / `"mocknet"`).
+- :bug: Fix bug in debug tooling where incorrect placeholder keys were used when evaluating transactions with P2PKH inputs.
+
 ## v0.10.0
 
 In this version we added proper debugging support for transactions and integration with the BitAuth IDE.

From 7bd9ba5b420aad62c0d49ef4120b0330eb3d1669 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Tue, 22 Oct 2024 13:43:57 +0200
Subject: [PATCH 136/267] improve docs (#216)

- improved getting started
- added Cauldron DEX to examples, remove transferWithTimeout
- moved operators section to types page
- improved notice on pragma usage
- improved optimization guide
- added a guide page for walletconnect
- add SignatureAlgorithm  to the SignatureTemplate  docs
- separated the SignatureTemplate  docs to a separate page
- Improved the 'Contract Instantiation' page sub titles
---
 website/docs/basics/getting-started.md  | 21 ++++--
 website/docs/guides/optimization.md     | 76 +++++++++-----------
 website/docs/guides/walletconnect.md    | 93 +++++++++++++++++++++++++
 website/docs/language/contracts.md      |  8 +--
 website/docs/language/examples.md       | 78 ++++++++++++++-------
 website/docs/language/functions.md      | 27 +------
 website/docs/language/types.md          | 27 ++++++-
 website/docs/sdk/instantiation.md       | 41 ++---------
 website/docs/sdk/signature-templates.md | 86 +++++++++++++++++++++++
 website/sidebars.js                     |  2 +
 10 files changed, 318 insertions(+), 141 deletions(-)
 create mode 100644 website/docs/guides/walletconnect.md
 create mode 100644 website/docs/sdk/signature-templates.md

diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 1a4f7553..07409b4b 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -6,15 +6,22 @@ title: Getting Started
 
 To get started with writing CashScript smart contracts quickly, it is recommended to try out the [CashScript Playground](https://playground.cashscript.org/), a web application which lets you easily write and create contracts!
 
-Here you will learn what a CashScript contract looks like through the `TransferWithTimeout` example contract. Then you can compile the contract and provide the contract arguments to create a smart contract address. To actually create the smart contract itself, you fund the address so that it has a UTXO on the contract address. After setting up the smart contract, you can try spending from the smart contract by invoking a contract function!
+The Playground supports 'Mocknet', allowing you to create virtual UTXOs for development without having to get Testnet coins and set up a Testnet wallet.
 
 :::tip
-The [CashScript Playground](https://playground.cashscript.org/) is a great way to get started without doing any JavaScript coding to set up wallets, fetch balances and invoke contract functions. This way you can focus on learning one thing at a time!
+The [CashScript Playground](https://playground.cashscript.org/) is a great way to get started without doing any JavaScript/TypeScript coding to set up wallets, fetch balances and invoke contract functions. This way you can focus on learning just CashScript!
 :::
 
-## Creating a CashScript Smart Contract
+Here are the 5 simple steps for creating your first smart contract transaction with the Playground:
+1. Compile a contract, for example the default `TransferWithTimeout` contract.
+2. Create a new contract in the 'New Contract' tab by providing the contract arguments.
+3. Add UTXOs to the smart contract address and the wallets used for testing. 
+4. Next, go to the TansactionBuilder select the contract and the function to invoke
+5. Finally, specify the in- and outputs for the transaction and click 'Send'!
 
-With the CashScript playground there's a nice integrated editor to get started, as well as an integrated compiler to change your CashScript contract into a Contract `Artifact` behind the scenes. Now, to get started we will have to set up a CashScript editor — outside of the Playground — and learn how to work with the `cashc` compiler to create CashScript contract artifacts.
+## Creating a CashScript Contract
+
+To get started coding locally we will use a code editor and learn how to work with the `cashc` compiler to create CashScript contract artifacts.
 
 ### Prerequisites
 
@@ -37,7 +44,7 @@ The command line CashScript compiler `cashc` can be installed from NPM.
 npm install -g cashc
 ```
 
-### Writing your first smart contract
+### Writing your first contract
 
 Open your code editor to start writing your first CashScript smart contract.
 We can start from a basic `TransferWithTimeout` smart contract. Create a new file `TransferWithTimeout.cash`.
@@ -65,7 +72,7 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 There are some other examples available on the [Examples page](/docs/language/examples) that can be used to take inspiration from. Further examples of the TypeScript and JavaScript integration can be found on [GitHub](https://github.com/CashScript/cashscript/tree/master/examples).
 :::
 
-### Compiling your smart contract
+### Compiling your contract
 
 The next step after writing your smart contract is using the command line compiler to create a contract artifact, so that it can be imported into the CashScript SDK.
 
@@ -81,7 +88,7 @@ OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_ROLL OP_ROT OP_CHECKSIG OP_NIP OP_NI
 
 ## Creating a CashScript Transaction
 
-After creating a contract artifact, we can now use the TypeScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs. We'll continue with the `TransferWithTimeout` artifact generated in the previous steps.
+After creating a contract artifact, we can now use the TypeScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs. We'll continue with the `TransferWithTimeout` artifact generated earlier.
 
 :::info
 The CashScript SDK is written in TypeScript meaning that you can either use TypeScript or vanilla JavaScript to use the SDK.
diff --git a/website/docs/guides/optimization.md b/website/docs/guides/optimization.md
index 3ee0ad89..ce1c0b7b 100644
--- a/website/docs/guides/optimization.md
+++ b/website/docs/guides/optimization.md
@@ -5,7 +5,26 @@ sidebar_label: Optimization
 
 CashScript contracts are transpiled from a solidity syntax to [BCH Script](https://reference.cash/protocol/blockchain/script) by the `cashc` compiler. BCH Script is a lower level language (a list of stack-based operations) where each available operation is mapped to a single byte.
 
-Depending on the complexity of the contract or system design, it may sometimes be useful to optimize the Bitcoin Script by tweaking the contract in CashScript before it is compiled. Below are some ideas to get started.
+Depending on the complexity of the contract or system design, it may be useful to optimize the Bitcoin Script by tweaking the contract in CashScript before it is compiled because the minimum fees on the Bitcoin Cash network are based on the bytesize of a transaction (including your contract).
+
+## Example Workflow
+
+When optimizing your contract, you will need to compare the contract size to see if the changes have a positive impact.
+With the compiler CLI, you can easily check the opcode count and bytesize directly from the generated contract artifact.
+
+```bash
+cashc ./contract.cash --opcount --size
+```
+
+The size outputs of the `cashc` compiler are based on the bytecode without constructor arguments. This means they will always be an underestimate, as the contract hasn't been initialized with contract arguments.
+
+:::note
+The compiler opcount and bytesize outputs are still helpful to compare the effect of changes to the smart contract code on the compiled output, given that the contract constructor arguments stay the same.
+:::
+
+:::tip
+To get the exact contract opcount and bytesize including constructor parameters, initialise the contract with the TypScript SDK and check the values of `contract.opcount` and `contract.bytesize`.
+:::
 
 ## Optimization Tips & Tricks
 
@@ -73,52 +92,25 @@ The concept of having NFT functions was first introduced by the [Jedex demo](htt
 By using function NFTs you can use a modular contract design where the contract functions are offloaded to different UTXOs, each identifiable by the main contract by using the same tokenId.
 :::
 
-## Example Workflow
-
-When trying to optimize your contract, you will need to compare the contract size to see if the changes have a positive impact.
-With the compiler CLI, you can easily check the opcode count and bytesize directly from the contract (without creating a new artifact).
-It's important to know the minimum fees on the Bitcoin Cash network are based on the bytesize of a transaction (including your contract).
-
-```bash
-cashc ./contract.cash --opcount --size
-```
-
-:::caution
-The size output of the `cashc` compiler will always be an underestimate, as the contract hasn't been initialized with contract arguments.
-:::
-
-The `cashc` compiler only knows the opcount and bytesize of a contract before it is initialised with function arguments. Because of this, to get an accurate view of a contracts size, initialise the contract instance first, then get the size from there. This means you will have to re-compile the artifact before checking the contract size through the TypeScript SDK.
+## Hand-optimizing Bytecode
 
-```javascript
-import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
-import { alicePub, bobPriv, bobPub } from './keys.js';
-import { compileFile } from 'cashc';
+It's worth considering whether hand-optimizing the contract is necessary at all. If the contract works and there is no glaring inefficiency in the bytecode, perhaps the best optimization is to not to obsess prematurely about things like transaction size.
 
-// compile contract code on the fly
-const artifact = compileFile(new URL('contract.cash', import.meta.url));
+>We should forget about small efficiencies, say about 97% of the time: premature optimization is the root of all evil. Yet we should not pass up our opportunities in that critical 3%.
 
-// Initialise a network provider for network operations
-const provider = new ElectrumNetworkProvider('chipnet');
+### Overwriting the Artifact
 
-// Instantiate a new TransferWithTimeout contract
-const contractArguments = [alicePub, bobPub, 100000n]
-const options = { provider }
-const contract = new Contract(artifact, contractArguments, options);
+To manually change the contract bytecode, you need to overwrite the `bytecode` key of your contract artifact.
 
-console.log(contract.opcount);
-console.log(contract.bytesize);
+```typescript
+interface Artifact {
+  bytecode: string // Compiled Script without constructor parameters added (in ASM format)
+}
 ```
 
-With this workflow, you can make changes to the contract and the run the JavaScript program to
-get an accurate measure of how the bytesize of your contract changes with different optimizations.
-
-## To optimize or not to optimize?
-
-In the context of optimizing contract bytecode, there's an important remark to consider:
-
-### OP_NOP
-
->We should forget about small efficiencies, say about 97% of the time: premature optimization is the root of all evil. Yet we should not pass up our opportunities in that critical 3%.
-
-It's worth considering whether optimizing the redeem script is necessary at all. If the contract is accepted by the network, and there is no glaring inefficiency in the bytecode, perhaps the best optimization is to not to obsess prematurely about things like block size.
+This way you can still use the CashScript TypeScript SDK while using a hand-optimized contract.
 
+:::caution
+If you manually overwite the `bytecode` in the artifact, this will make the auto generated 2-way-mapping to become obsolete.
+This result of this is that the dubugging functionality will no longer work for the contract.
+:::
diff --git a/website/docs/guides/walletconnect.md b/website/docs/guides/walletconnect.md
new file mode 100644
index 00000000..2d0b8fad
--- /dev/null
+++ b/website/docs/guides/walletconnect.md
@@ -0,0 +1,93 @@
+---
+title: WalletConnect
+---
+
+The BCH WalletConnect specification was created in July of 2023 and has become popular since. The standard integrates nicely with CashScript contract development as it was designed with CashScript contract usage in mind.
+
+You can find a full list of Bitcoin Cash dapps supporting WalletConnect on [Tokenaut.cash](https://tokenaut.cash/dapps?filter=walletconnect).
+
+:::tip
+The specification is called ['wc2-bch-bcr'](https://github.com/mainnet-pat/wc2-bch-bcr) and has extra discussion and info on the [BCH research forum](https://bitcoincashresearch.org/t/wallet-connect-v2-support-for-bitcoincash/).
+:::
+
+## signTransaction Interface
+
+Most relevant for smart contract usage is the BCH-WalletConnect `signTransaction` interface.
+
+> This is a most generic interface to propose a bitcoincash transaction to a wallet which reconstructs it and signs it on behalf of the wallet user.
+
+```typescript
+signTransaction: (
+  options: {
+    transaction: string | TransactionBCH,
+    sourceOutputs: (Input | Output | ContractInfo)[],
+    broadcast?: boolean,
+    userPrompt?: string
+  }
+) => Promise<{ signedTransaction: string, signedTransactionHash: string } | undefined>;
+```
+
+Important to note is how the wallet knows which inputs to sign:
+
+>To signal that the wallet needs to sign an input, the app sets the corresponding input's `unlockingBytecode` to empty Uint8Array.
+
+## signTransaction Example
+
+### Create wcTransactionObj
+
+Example code from the 'Cash-Ninjas' minting dapp repository, [link to source code](https://github.com/cashninjas/ninjas.cash/blob/main/js/mint.js).
+
+```javascript
+import { Contract } from "cashscript";
+import { hexToBin, decodeTransaction } from "@bitauth/libauth";
+
+async function transactionWalletConnect(){
+  // use the CashScript SDK to build a transaction
+  const rawTransactionHex = await transaction.build();
+  const decodedTransaction = decodeTransaction(hexToBin(rawTransactionHex));
+
+  // set input unlockingBytecode to empty Uint8Array for wallet signing
+  decodedTransaction.inputs[1].unlockingBytecode = Uint8Array.from([]);
+
+  // construct list SourceOutputs, see source code
+  const listSourceOutputs = constructSourceOuputs(decodedTransaction, utxoInfo, contract)
+
+  // wcTransactionObj to pass to signTransaction endpoint
+  const wcTransactionObj = {
+    transaction: decodedTransaction,
+    sourceOutputs: listSourceOutputs,
+    broadcast: true,
+    userPrompt: "Mint Cash-Ninja NFT"
+  };
+
+  // pass wcTransactionObj to WalletConnect client
+  const signResult = await signTransaction(wcTransactionObj);
+
+  // Handle signResult success / failure
+}
+```
+
+### signTransaction Client interaction
+
+Below is an implementation of `signTransaction` used earlier, this is where the communication with the client for 'signTransaction' takes place. See the source code for `signClient`, `connectedChain` and `session` details.
+
+```javascript
+import SignClient from '@walletconnect/sign-client';
+import { stringify } from "@bitauth/libauth";
+
+async function signTransaction(options){
+  try {
+    const result = await signClient.request({
+      chainId: connectedChain,
+      topic: session.topic,
+      request: {
+        method: "bch_signTransaction",
+        params: JSON.parse(stringify(options)),
+      },
+    });
+    return result;
+  } catch (error) {
+    return undefined;
+  }
+}
+```
diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index 271c8a6b..35bccd6e 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -5,10 +5,10 @@ title: Contract Structure
 Contracts in CashScript are somewhat similar to classes in object-oriented languages. A notable difference is that there is no mutable state. So once a contract is instantiated with certain parameters, these values cannot change. Instead, functions can be called on the contract that act on the contract's values to spend money from the contract. The extension of CashScript source code files is `.cash`, and the structure of these source files is explained below.
 
 ## Pragma
-A contract file may start with a pragma directive to indicate the CashScript version the contract was written for. This ensures that a contract is not compiled with an unsupported compiler version, which could cause unintended side effects.
+A contract file may start with a pragma directive to indicate the CashScript version the contract was written for. This ensures that a contract is not compiled with an unsupported compiler version. The pragma directive follows regular [semantic versioning (SemVer)](https://semver.npmjs.com/) rules.
 
-:::note
-The pragma directive follows regular [semantic versioning rules](https://semver.npmjs.com/).
+:::caution
+Contract authors should be careful when allowing a range of versions to check that no breaking changes to the compiler were introduced in these versions which would result in different bytecode and smart contract address.
 :::
 
 #### Example
@@ -82,7 +82,7 @@ contract P2PKH(bytes20 pkh) {
 ### Variable declaration
 Variables can be declared by specifying their type and name. All variables need to be initialised at the time of their declaration, but can be reassigned later on — unless specifying the `constant` keyword. Since CashScript is strongly typed and has no type inference, it is not possible to use keywords such as `var` or `let` to declare variables.
 
-:::caution
+:::note
 CashScript disallows variable shadowing and unused variables.
 :::
 
diff --git a/website/docs/language/examples.md b/website/docs/language/examples.md
index 47024987..6d49ff62 100644
--- a/website/docs/language/examples.md
+++ b/website/docs/language/examples.md
@@ -2,31 +2,7 @@
 title: Examples
 ---
 
-An extensive collection of examples is available in the [GitHub repository](https://github.com/CashScript/cashscript/tree/master/examples). Below we discuss a few of these examples in more details and go through their functionality. These examples focus mainly on the CashScript syntax, while the [Examples page](/docs/sdk/examples) in the sdk section focuses more on the use of the SDK.
-
-## Transfer With Timeout
-One interesting use case of Bitcoin Cash is using it for *paper tips*. With paper tips, you send a small amount of money to an address, and print the corresponding private key on a piece of paper. Then you can hand out these pieces of paper as a tip or gift to people in person. In practice, however, people might not know what to do with these gifts or they might lose or forget about it.
-
-As an alternative, a smart contract can be used for these kinds of gifts. This smart contract allows the recipient to claim their gift at any time, but if they don't claim it in time, the sender can reclaim it.
-
-```solidity
-pragma cashscript ^0.10.0;
-
-contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
-    // Require recipient's signature to match
-    function transfer(sig recipientSig) {
-        require(checkSig(recipientSig, recipient));
-    }
-
-    // Require timeout time to be reached and sender's signature to match
-    function timeout(sig senderSig) {
-        require(checkSig(senderSig, sender));
-        require(tx.time >= timeout);
-    }
-}
-```
-
-For an example of how to put this contract to use in a JavaScript application, see the [SDK examples page](/docs/sdk/examples#transfer-with-timeout)
+An extensive collection of examples is available in the [GitHub repository](https://github.com/CashScript/cashscript/tree/master/examples). Below we discuss a few of these examples in more details and go through their functionality. This example page focuses on the CashScript syntax, while the [SDK Examples page](/docs/sdk/examples) in the SDK section focuses on use of the SDK to build an application.
 
 ## HodlVault
 For better or worse, HODLing and waiting for price increases is one of the main things people want to do with their cryptocurrency. But it can be difficult to hold on to your cryptocurrency when the price is going down. So to prevent weak hands from getting the best of you, it's better to store your stash in a smart contract that enforces HODLing for you.
@@ -66,6 +42,9 @@ contract HodlVault(pubkey ownerPk, pubkey oraclePk, int minBlock, int priceTarge
 }
 ```
 
+For how to put the HodlVault contract to use in a Typescript application, see the [SDK examples page](/docs/sdk/examples#hodlvault).
+
+
 ## Licho's Mecenas
 Donations are a great way to support the projects you love, and periodic donations can incentivise continuous improvement to the product. But platforms like Patreon generally take fees of 10%+ and don't accept cryptocurrencies. Instead you can create a peer-to-peer smart contract that allows a recipient to withdraw a specific amount every month.
 
@@ -74,6 +53,8 @@ The contract works by checking that a UTXO is at least 30 days old, after which
 Due to the nature of covenants, we have to be very specific about the outputs (amounts and destinations) of the transaction. This also means that we have to account for the special case where the remaining contract balance is lower than the `pledge` amount, meaning no remainder should be sent back. Finally, we have to account for a small fee that has to be taken from the contract's balance to pay the miners.
 
 ```solidity
+pragma cashscript ^0.10.0;
+
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
     function receive() {
         require(tx.age >= period);
@@ -107,4 +88,51 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
 }
 ```
 
+## AMM DEX
+
+AMM DEX contract based on [the Cauldron DEX contract](https://www.cauldron.quest/_files/ugd/ae85be_b1dc04d2b6b94ab5a200e3d8cd197aa3.pdf), you can read more details about the contract design there.
+
+Compared to the manually written and hand-optimized opcodes version of the contract, the CashScript compiled bytecode has just 5 extra opcodes overhead (7 extra bytes).
+
+```solidity
+pragma cashscript ^0.10.0;
+
+contract DexContract(bytes20 poolOwnerPkh) {
+    function swap() {
+        // Verify it is the correct token category
+        bytes inputToken = tx.inputs[this.activeInputIndex].tokenCategory;
+        bytes outputToken = tx.outputs[this.activeInputIndex].tokenCategory;
+        require(inputToken == outputToken);
+
+        // Enforce version 2
+        // Enforcing version is to make sure that tools that
+        // use this contract stay compatible, when and if
+        // transaction format changes in the future.
+        require(tx.version == 2);
+
+        // Verify that this contract lives on on the output with the same input as this contract.
+        bytes inputBytecode = tx.inputs[this.activeInputIndex].lockingBytecode;
+        bytes outputBytecode = tx.outputs[this.activeInputIndex].lockingBytecode;
+        require(inputBytecode == outputBytecode);
+
+        // Calculate target K
+        int targetK = tx.inputs[this.activeInputIndex].value * tx.inputs[this.activeInputIndex].tokenAmount;
+
+        // Calculate fee for trade. Fee is ~0.3%
+        int tradeValue = abs(tx.inputs[this.activeInputIndex].value - tx.outputs[this.activeInputIndex].value);
+        int fee = (tradeValue * 3) / 1000;
+
+        // Get effective output K when including the fee.
+        int effectiveOutputK = (tx.outputs[this.activeInputIndex].value - fee) * tx.outputs[this.activeInputIndex].tokenAmount;
+
+        // Verify that effective K > target K
+        require(effectiveOutputK >= targetK);
+    }
+    function withdrawal(pubkey poolOwnerPk, sig poolOwnerSig) {
+        require(hash160(poolOwnerPk) == poolOwner);
+        require(checkSig(poolOwnerSig, poolOwnerPk));
+    }
+}
+```
+
 More advanced examples on covenants, using NFTs to keep local state and issuing NFTs as receipts can be found in the [Covenants & Introspection Guide](/docs/guides/covenants).
diff --git a/website/docs/language/functions.md b/website/docs/language/functions.md
index 6f617172..d0740e10 100644
--- a/website/docs/language/functions.md
+++ b/website/docs/language/functions.md
@@ -1,5 +1,5 @@
 ---
-title: Global Functions & Operators
+title: Global Functions
 ---
 
 CashScript has several built-in functions for things like cryptographic and arithmetic applications, and it includes many common arithmetic and other operators that you would expect in a programming language.
@@ -99,29 +99,4 @@ bool checkDataSig(datasig s, bytes msg, pubkey pk)
 
 Checks that sig `s` is a valid signature for message `msg` and matches with public key `pk`.
 
-## Operators
-An overview of all supported operators and their precedence is included below. Notable is a lack of exponentiation, since these operations are not supported by the underlying Bitcoin Script.
-
-| Precedence | Description                         | Operator                 |
-| ---------- | ----------------------------------- | ------------------------ |
-| 1          | Parentheses                         | `(<expression>)`         |
-| 2          | Type cast                           | `<type>(<expression>)`   |
-| 3          | Object instantiation                | `new <class>(<args...>)` |
-| 4          | Function call                       | `<function>(<args...>)`  |
-| 5          | Tuple index                         | `<tuple>[<index>]`       |
-| 6          | Member access                       | `<object>.<member>`      |
-| 7          | Unary minus                         | `-`                      |
-| 7          | Logical NOT                         | `!`                      |
-| 8          | Multiplication, division and modulo | `*`, `/`, `%`            |
-| 9          | Addition and subtraction            | `+`, `-`                 |
-| 9          | String / bytes concatenation        | `+`                      |
-| 10         | Numeric comparison                  | `<`, `>`, `<=`, `>=`     |
-| 11         | Equality and inequality             | `==`, `!=`               |
-| 12         | Bitwise AND                         | `&`                      |
-| 13         | Bitwise XOR                         | `^`                      |
-| 14         | Bitwise OR                          | \|                       |
-| 15         | Logical AND                         | `&&`                     |
-| 16         | Logical OR                          | \|\|                     |
-| 17         | Assignment                          | `=`                      |
-
 [bip146]: https://github.com/bitcoin/bips/blob/master/bip-0146.mediawiki
diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index 2b8d5807..ca548665 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -1,5 +1,5 @@
 ---
-title: Types
+title: Types & Operators
 ---
 
 CashScript is a statically typed language, which means that the type of each variable needs to be specified. Types can also be implicitly or explicitly cast to other types. For a quick reference of the various casting possibilities, see [Type Casting](#type-casting).
@@ -186,3 +186,28 @@ VM numbers follow Script Number format (A.K.A. CSCriptNum), to convert VM number
 :::caution
 When casting bytes types to integer, you should be sure that the bytes value fits inside a 64-bit signed integer, or the script will fail.
 :::
+
+## Operators
+An overview of all supported operators and their precedence is included below. Notable is a lack of exponentiation, since these operations are not supported by the underlying Bitcoin Script.
+
+| Precedence | Description                         | Operator                 |
+| ---------- | ----------------------------------- | ------------------------ |
+| 1          | Parentheses                         | `(<expression>)`         |
+| 2          | Type cast                           | `<type>(<expression>)`   |
+| 3          | Object instantiation                | `new <class>(<args...>)` |
+| 4          | Function call                       | `<function>(<args...>)`  |
+| 5          | Tuple index                         | `<tuple>[<index>]`       |
+| 6          | Member access                       | `<object>.<member>`      |
+| 7          | Unary minus                         | `-`                      |
+| 7          | Logical NOT                         | `!`                      |
+| 8          | Multiplication, division and modulo | `*`, `/`, `%`            |
+| 9          | Addition and subtraction            | `+`, `-`                 |
+| 9          | String / bytes concatenation        | `+`                      |
+| 10         | Numeric comparison                  | `<`, `>`, `<=`, `>=`     |
+| 11         | Equality and inequality             | `==`, `!=`               |
+| 12         | Bitwise AND                         | `&`                      |
+| 13         | Bitwise XOR                         | `^`                      |
+| 14         | Bitwise OR                          | \|                       |
+| 15         | Logical AND                         | `&&`                     |
+| 16         | Logical OR                          | \|\|                     |
+| 17         | Assignment                          | `=`                      |
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 28142d9d..4d7a3980 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -9,7 +9,7 @@ CashScript offers a TypeScript SDK, which can also be used easily in vanilla Jav
 Because of the separation of the compiler and the SDK, CashScript contracts can be integrated into other languages in the future.
 :::
 
-## Contract class
+## Creating a Contract
 The `Contract` class is used to represent a CashScript contract in a JavaScript object. These objects can be used to retrieve information such as the contract's address and balance. They can also be used to interact with the contract by calling the contract's functions.
 
 ### Constructor
@@ -54,6 +54,8 @@ const options = { provider, addressType}
 const contract = new Contract(P2PKH, contractArguments, options);
 ```
 
+## Contract Properties
+
 ### address
 ```ts
 contract.address: string
@@ -118,6 +120,8 @@ Returns the contract's redeem script encoded as a hex string.
 console.log(contract.bytecode)
 ```
 
+## Contract Methods
+
 ### getBalance()
 ```ts
 async contract.getBalance(): Promise<bigint>
@@ -189,38 +193,3 @@ const contractUtxos = await contract.getUtxos();
 
 transactionBuilder.addInput(contractUtxos[0], contract.unlock.spend());
 ```
-
-## SignatureTemplate
-```ts
-new SignatureTemplate(signer: Keypair | Uint8Array | string, hashtype?: HashType)
-```
-
-You may notice the `SignatureTemplate` object in the [example](#example-8) above. When a contract function has a `sig` parameter, it requires a cryptographic signature over the spending transaction. But to generate this signature, the transaction needs to be built first, which is not yet the case when a contract function is first called.
-
-So in the place of a signature, a `SignatureTemplate` can be passed, which will automatically generate the correct signature using the `signer` parameter. This signer can be any representation of a private key, including [BCHJS' `ECPair`][ecpair], [bitcore-lib-cash' `PrivateKey`][privatekey], [WIF strings][wif], or raw private key buffers. This ensures that any BCH library can be used.
-
-The default `hashtype` is `HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS` because this is the most secure option for smart contract use cases.
-
-```ts
-export enum HashType {
-  SIGHASH_ALL = 0x01,
-  SIGHASH_NONE = 0x02,
-  SIGHASH_SINGLE = 0x03,
-  SIGHASH_UTXOS = 0x20,
-  SIGHASH_ANYONECANPAY = 0x80,
-}
-```
-
-:::note
-If you're using "old-style" covenants (using CashScript v0.6.0 or lower), you need to configure `HashType.SIGHASH_ALL` as the `hashtype` parameter for the SignatureTemplate.
-:::
-
-#### Example
-```ts
-const wif = 'L4vmKsStbQaCvaKPnCzdRArZgdAxTqVx8vjMGLW5nHtWdRguiRi1';
-const sig = new SignatureTemplate(wif, HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS );
-```
-
-[wif]: https://en.bitcoin.it/wiki/Wallet_import_format
-[ecpair]: https://bchjs.fullstack.cash/#api-ECPair
-[privatekey]: https://github.com/bitpay/bitcore/blob/master/packages/bitcore-lib-cash/docs/privatekey.md
diff --git a/website/docs/sdk/signature-templates.md b/website/docs/sdk/signature-templates.md
new file mode 100644
index 00000000..172756ac
--- /dev/null
+++ b/website/docs/sdk/signature-templates.md
@@ -0,0 +1,86 @@
+---
+title: Signature Templates
+---
+
+When a contract function has a `sig` parameter, it needs a cryptographic signature from a private key for the spending transaction. 
+In place of a signature, a `SignatureTemplate` can be passed, which will automatically generate the correct signature once the transaction is built.
+
+## SignatureTemplate
+
+### Constructor
+
+```ts
+new SignatureTemplate(
+  signer: Keypair | Uint8Array | string,
+  hashtype?: HashType,
+  signatureAlgorithm?: SignatureAlgorithm
+)
+```
+
+In place of a signature, a `SignatureTemplate` can be passed, which will automatically generate the correct signature using the `signer` parameter. This signer can be any representation of a private key, including [BCHJS' `ECPair`][ecpair], [bitcore-lib-cash' `PrivateKey`][privatekey], [WIF strings][wif], or raw private key buffers. This ensures that any BCH library can be used.
+
+#### Example
+```ts
+const aliceWif = 'L4vmKsStbQaCvaKPnCzdRArZgdAxTqVx8vjMGLW5nHtWdRguiRi1';
+const aliceSignatureTemplate = new SignatureTemplate(aliceWif)
+
+const tx = await contract.functions
+  .transfer(aliceSignatureTemplate)
+  .to('bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx', 10000n)
+  .send()
+```
+
+The `hashtype` and `signatureAlgorithm` options are covered under ['Advanced Usage'](/docs/sdk/signature-templates#advanced-usage).
+
+## Advanced Usage
+
+### HashType
+
+The default `hashtype` is `HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS` because this is the most secure option for smart contract use cases.
+
+```ts
+export enum HashType {
+  SIGHASH_ALL = 0x01,
+  SIGHASH_NONE = 0x02,
+  SIGHASH_SINGLE = 0x03,
+  SIGHASH_UTXOS = 0x20,
+  SIGHASH_ANYONECANPAY = 0x80,
+}
+```
+
+:::note
+If you're using "old-style" covenants (using CashScript v0.6.0 or lower), you need to configure `HashType.SIGHASH_ALL` as the `hashtype` parameter for the SignatureTemplate.
+:::
+
+#### Example
+```ts
+const wif = 'L4vmKsStbQaCvaKPnCzdRArZgdAxTqVx8vjMGLW5nHtWdRguiRi1';
+
+const signatureTemplate = new SignatureTemplate(
+  wif, HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS
+);
+```
+
+### SignatureAlgorithm
+
+The `signatureAlgorithm` parameter determines the cryptographic algorithm used for signing. By default, the modern and compact Schnorr algorithm is used.
+
+```ts
+export enum SignatureAlgorithm {
+  ECDSA = 0x00,
+  SCHNORR = 0x01,
+}
+```
+
+#### Example
+```ts
+const wif = 'L4vmKsStbQaCvaKPnCzdRArZgdAxTqVx8vjMGLW5nHtWdRguiRi1';
+
+const hashType = HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS
+const signatureAlgorithm = SignatureAlgorithm.SCHNORR
+const signatureTemplate = new SignatureTemplate(wif, hashType,signatureAlgorithm);
+```
+
+[wif]: https://en.bitcoin.it/wiki/Wallet_import_format
+[ecpair]: https://bchjs.fullstack.cash/#api-ECPair
+[privatekey]: https://github.com/bitpay/bitcore/blob/master/packages/bitcore-lib-cash/docs/privatekey.md
diff --git a/website/sidebars.js b/website/sidebars.js
index 5b16c91c..d7f98d05 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -34,6 +34,7 @@ module.exports = {
       label: 'TypeScript SDK',
       items: [
         'sdk/instantiation',
+        'sdk/signature-templates',
         'sdk/network-provider',
         'sdk/transactions',
         'sdk/transactions-advanced',
@@ -47,6 +48,7 @@ module.exports = {
       items: [
         'guides/syntax-highlighting',
         'guides/covenants',
+        'guides/walletconnect',
         'guides/debugging',
         'guides/optimization'
       ],

From 66c772419a89b91990a0a58c20f12bea4c87a224 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 22 Oct 2024 13:54:26 +0200
Subject: [PATCH 137/267] Spelling fixes

---
 .cspell.json                           | 3 +++
 website/docs/basics/getting-started.md | 4 ++--
 website/docs/guides/optimization.md    | 4 ++--
 website/docs/guides/walletconnect.md   | 2 +-
 4 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/.cspell.json b/.cspell.json
index 6fd7d3a6..29a1b2b9 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -207,6 +207,7 @@
         "docu",
         "fundme",
         "hardhat",
+        "hodlvault",
         "infima",
         "jedex",
         "lichos",
@@ -221,11 +222,13 @@
         "setfiletype",
         "tada",
         "tapswap",
+        "tokenaut",
         "txage",
         "txbytecode",
         "txhashoutputs",
         "txtime",
         "vite",
+        "walletconnect",
         "withage",
         "withfeeperbyte",
         "withhardcodedfee",
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 07409b4b..a3d6f351 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -15,8 +15,8 @@ The [CashScript Playground](https://playground.cashscript.org/) is a great way t
 Here are the 5 simple steps for creating your first smart contract transaction with the Playground:
 1. Compile a contract, for example the default `TransferWithTimeout` contract.
 2. Create a new contract in the 'New Contract' tab by providing the contract arguments.
-3. Add UTXOs to the smart contract address and the wallets used for testing. 
-4. Next, go to the TansactionBuilder select the contract and the function to invoke
+3. Add UTXOs to the smart contract address and the wallets used for testing.
+4. Next, go to the TransactionBuilder select the contract and the function to invoke
 5. Finally, specify the in- and outputs for the transaction and click 'Send'!
 
 ## Creating a CashScript Contract
diff --git a/website/docs/guides/optimization.md b/website/docs/guides/optimization.md
index ce1c0b7b..6d188039 100644
--- a/website/docs/guides/optimization.md
+++ b/website/docs/guides/optimization.md
@@ -111,6 +111,6 @@ interface Artifact {
 This way you can still use the CashScript TypeScript SDK while using a hand-optimized contract.
 
 :::caution
-If you manually overwite the `bytecode` in the artifact, this will make the auto generated 2-way-mapping to become obsolete.
-This result of this is that the dubugging functionality will no longer work for the contract.
+If you manually overwrite the `bytecode` in the artifact, this will make the auto generated 2-way-mapping to become obsolete.
+This result of this is that the debugging functionality will no longer work for the contract.
 :::
diff --git a/website/docs/guides/walletconnect.md b/website/docs/guides/walletconnect.md
index 2d0b8fad..d6f2c15e 100644
--- a/website/docs/guides/walletconnect.md
+++ b/website/docs/guides/walletconnect.md
@@ -50,7 +50,7 @@ async function transactionWalletConnect(){
   decodedTransaction.inputs[1].unlockingBytecode = Uint8Array.from([]);
 
   // construct list SourceOutputs, see source code
-  const listSourceOutputs = constructSourceOuputs(decodedTransaction, utxoInfo, contract)
+  const listSourceOutputs = constructSourceOutputs(decodedTransaction, utxoInfo, contract)
 
   // wcTransactionObj to pass to signTransaction endpoint
   const wcTransactionObj = {

From 6a787bfe841438c6b62fac103e953523c0c31627 Mon Sep 17 00:00:00 2001
From: "cypherpunk.bch" <kuldeepbb.grewal@gmail.com>
Date: Tue, 29 Oct 2024 14:42:15 +0530
Subject: [PATCH 138/267] Replace import-assertions syntax by import-attributes
 (#227)

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
---
 README.md                                              |  2 +-
 examples/testing-suite/test/example.test.ts            |  2 +-
 packages/cashscript/README.md                          |  2 +-
 packages/cashscript/test/Contract.test.ts              | 10 +++++-----
 packages/cashscript/test/e2e/Announcement.test.ts      |  2 +-
 packages/cashscript/test/e2e/BigInt.test.ts            |  2 +-
 packages/cashscript/test/e2e/FullStack.test.ts         |  2 +-
 packages/cashscript/test/e2e/HodlVault.test.ts         |  2 +-
 packages/cashscript/test/e2e/Mecenas.test.ts           |  2 +-
 packages/cashscript/test/e2e/P2PKH-tokens.test.ts      |  2 +-
 packages/cashscript/test/e2e/P2PKH.test.ts             |  2 +-
 .../cashscript/test/e2e/TokenCategoryCheck.test.ts     |  2 +-
 .../cashscript/test/e2e/TransferWithTimeout.test.ts    |  2 +-
 packages/cashscript/test/e2e/misc.test.ts              |  2 +-
 packages/cashscript/test/e2e/old/Mecenas.test.ts       |  2 +-
 packages/cashscript/test/e2e/old/misc.test.ts          |  4 ++--
 .../e2e/transaction-builder/TransactionBuilder.test.ts |  4 ++--
 .../test/fixture/libauth-template/fixtures.ts          |  8 ++++----
 website/docs/sdk/testing-setup.md                      |  2 +-
 19 files changed, 28 insertions(+), 28 deletions(-)

diff --git a/README.md b/README.md
index 478776e6..03114fda 100644
--- a/README.md
+++ b/README.md
@@ -60,7 +60,7 @@ Using the CashScript SDK, you can import contract artifact files, create new ins
 ```ts
 ...
   // Import the P2PKH artifact
-  import P2PKH from './p2pkh-artifact.json' assert { type: 'json' };
+  import P2PKH from './p2pkh-artifact.json' with { type: 'json' };
 
   // Instantiate a network provider for CashScript's network operations
   const provider = new ElectrumNetworkProvider('mainnet');
diff --git a/examples/testing-suite/test/example.test.ts b/examples/testing-suite/test/example.test.ts
index 731f5e22..f793c428 100644
--- a/examples/testing-suite/test/example.test.ts
+++ b/examples/testing-suite/test/example.test.ts
@@ -1,4 +1,4 @@
-import artifact from '../artifacts/example.json' assert { type: 'json' };
+import artifact from '../artifacts/example.json' with { type: 'json' };
 import { Contract, MockNetworkProvider, randomUtxo } from 'cashscript';
 import 'cashscript/jest';
 
diff --git a/packages/cashscript/README.md b/packages/cashscript/README.md
index 1bbd4376..bd8bdf1f 100644
--- a/packages/cashscript/README.md
+++ b/packages/cashscript/README.md
@@ -31,7 +31,7 @@ Using the CashScript SDK, you can import contract artifact files, create new ins
 ```ts
 ...
   // Import the P2PKH artifact
-  import P2PKH from './p2pkh-artifact.json' assert { type: 'json' };
+  import P2PKH from './p2pkh-artifact.json' with { type: 'json' };
 
   // Instantiate a network provider for CashScript's network operations
   const provider = new ElectrumNetworkProvider('mainnet');
diff --git a/packages/cashscript/test/Contract.test.ts b/packages/cashscript/test/Contract.test.ts
index a90d5a6f..142fec38 100644
--- a/packages/cashscript/test/Contract.test.ts
+++ b/packages/cashscript/test/Contract.test.ts
@@ -11,11 +11,11 @@ import {
 import {
   alicePkh, alicePriv, alicePub, bobPriv,
 } from './fixture/vars.js';
-import p2pkhArtifact from './fixture/p2pkh.json' assert { type: 'json' };
-import twtArtifact from './fixture/transfer_with_timeout.json' assert { type: 'json' };
-import hodlVaultArtifact from './fixture/hodl_vault.json' assert { type: 'json' };
-import mecenasArtifact from './fixture/mecenas.json' assert { type: 'json' };
-import boundedBytesArtifact from './fixture/bounded_bytes.json' assert { type: 'json' };
+import p2pkhArtifact from './fixture/p2pkh.json' with { type: 'json' };
+import twtArtifact from './fixture/transfer_with_timeout.json' with { type: 'json' };
+import hodlVaultArtifact from './fixture/hodl_vault.json' with { type: 'json' };
+import mecenasArtifact from './fixture/mecenas.json' with { type: 'json' };
+import boundedBytesArtifact from './fixture/bounded_bytes.json' with { type: 'json' };
 
 describe('Contract', () => {
   describe('new', () => {
diff --git a/packages/cashscript/test/e2e/Announcement.test.ts b/packages/cashscript/test/e2e/Announcement.test.ts
index 7ab3a048..d45ecf2c 100644
--- a/packages/cashscript/test/e2e/Announcement.test.ts
+++ b/packages/cashscript/test/e2e/Announcement.test.ts
@@ -7,7 +7,7 @@ import {
   createOpReturnOutput, randomUtxo, utxoComparator,
 } from '../../src/utils.js';
 import { aliceAddress } from '../fixture/vars.js';
-import artifact from '../fixture/announcement.json' assert { type: 'json' };
+import artifact from '../fixture/announcement.json' with { type: 'json' };
 
 describe('Announcement', () => {
   let announcement: Contract;
diff --git a/packages/cashscript/test/e2e/BigInt.test.ts b/packages/cashscript/test/e2e/BigInt.test.ts
index da006313..bc811561 100644
--- a/packages/cashscript/test/e2e/BigInt.test.ts
+++ b/packages/cashscript/test/e2e/BigInt.test.ts
@@ -8,7 +8,7 @@ import {
   Network,
 } from '../../src/index.js';
 import { getTxOutputs } from '../test-util.js';
-import artifact from '../fixture/bigint.json' assert { type: 'json' };
+import artifact from '../fixture/bigint.json' with { type: 'json' };
 import { randomUtxo } from '../../src/utils.js';
 
 describe('BigInt', () => {
diff --git a/packages/cashscript/test/e2e/FullStack.test.ts b/packages/cashscript/test/e2e/FullStack.test.ts
index e4c576a0..002d74a9 100644
--- a/packages/cashscript/test/e2e/FullStack.test.ts
+++ b/packages/cashscript/test/e2e/FullStack.test.ts
@@ -8,7 +8,7 @@ import {
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
 import { FailedRequireError } from '../../src/Errors.js';
-import artifact from '../fixture/p2pkh.json' assert { type: 'json' };
+import artifact from '../fixture/p2pkh.json' with { type: 'json' };
 
 describe.skip('P2PKH (using FullStackNetworkProvider)', () => {
   let p2pkhInstance: Contract;
diff --git a/packages/cashscript/test/e2e/HodlVault.test.ts b/packages/cashscript/test/e2e/HodlVault.test.ts
index 6dcd2f8e..d62156b0 100644
--- a/packages/cashscript/test/e2e/HodlVault.test.ts
+++ b/packages/cashscript/test/e2e/HodlVault.test.ts
@@ -13,7 +13,7 @@ import {
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
 import { FailedRequireError } from '../../src/Errors.js';
-import artifact from '../fixture/hodl_vault.json' assert { type: 'json' };
+import artifact from '../fixture/hodl_vault.json' with { type: 'json' };
 import { randomUtxo } from '../../src/utils.js';
 
 describe('HodlVault', () => {
diff --git a/packages/cashscript/test/e2e/Mecenas.test.ts b/packages/cashscript/test/e2e/Mecenas.test.ts
index 8f85709f..ede860e1 100644
--- a/packages/cashscript/test/e2e/Mecenas.test.ts
+++ b/packages/cashscript/test/e2e/Mecenas.test.ts
@@ -9,7 +9,7 @@ import {
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
 import { FailedRequireError } from '../../src/Errors.js';
-import artifact from '../fixture/mecenas.json' assert { type: 'json' };
+import artifact from '../fixture/mecenas.json' with { type: 'json' };
 import { randomUtxo } from '../../src/utils.js';
 
 // Mecenas has tx.age check omitted for testing
diff --git a/packages/cashscript/test/e2e/P2PKH-tokens.test.ts b/packages/cashscript/test/e2e/P2PKH-tokens.test.ts
index cd4a06ea..dbca1fcb 100644
--- a/packages/cashscript/test/e2e/P2PKH-tokens.test.ts
+++ b/packages/cashscript/test/e2e/P2PKH-tokens.test.ts
@@ -9,7 +9,7 @@ import {
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
 import { Network, TokenDetails, Utxo } from '../../src/interfaces.js';
-import artifact from '../fixture/p2pkh.json' assert { type: 'json' };
+import artifact from '../fixture/p2pkh.json' with { type: 'json' };
 
 describe('P2PKH-tokens', () => {
   let p2pkhInstance: Contract;
diff --git a/packages/cashscript/test/e2e/P2PKH.test.ts b/packages/cashscript/test/e2e/P2PKH.test.ts
index 5444f39f..a9826c2e 100644
--- a/packages/cashscript/test/e2e/P2PKH.test.ts
+++ b/packages/cashscript/test/e2e/P2PKH.test.ts
@@ -16,7 +16,7 @@ import { Network, Utxo } from '../../src/interfaces.js';
 import {
   createOpReturnOutput, randomUtxo, utxoComparator,
 } from '../../src/utils.js';
-import artifact from '../fixture/p2pkh.json' assert { type: 'json' };
+import artifact from '../fixture/p2pkh.json' with { type: 'json' };
 
 describe('P2PKH-no-tokens', () => {
   let p2pkhInstance: Contract;
diff --git a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
index ef6f9466..5ecdfd1f 100644
--- a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
+++ b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
@@ -3,7 +3,7 @@ import {
   Contract, ElectrumNetworkProvider, FailedRequireError, MockNetworkProvider,
 } from '../../src/index.js';
 import { Network, Utxo } from '../../src/interfaces.js';
-import artifact from '../fixture/token_category_comparison.json' assert { type: 'json' };
+import artifact from '../fixture/token_category_comparison.json' with { type: 'json' };
 
 describe('TokenCategoryCheck', () => {
   let tokenCategoryCheckInstance: Contract;
diff --git a/packages/cashscript/test/e2e/TransferWithTimeout.test.ts b/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
index 9d07407b..f83595a6 100644
--- a/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
+++ b/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
@@ -10,7 +10,7 @@ import {
   alicePriv, alicePub, bobPriv, bobPub,
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
-import artifact from '../fixture/transfer_with_timeout.json' assert { type: 'json' };
+import artifact from '../fixture/transfer_with_timeout.json' with { type: 'json' };
 import { randomUtxo } from '../../src/utils.js';
 
 describe('TransferWithTimeout', () => {
diff --git a/packages/cashscript/test/e2e/misc.test.ts b/packages/cashscript/test/e2e/misc.test.ts
index 97b4c115..a4f7b5e8 100644
--- a/packages/cashscript/test/e2e/misc.test.ts
+++ b/packages/cashscript/test/e2e/misc.test.ts
@@ -3,7 +3,7 @@ import {
   Contract, MockNetworkProvider, ElectrumNetworkProvider, Network,
 } from '../../src/index.js';
 import { getTxOutputs } from '../test-util.js';
-import artifact from '../fixture/simple_covenant.json' assert { type: 'json' };
+import artifact from '../fixture/simple_covenant.json' with { type: 'json' };
 
 describe('Simple Covenant', () => {
   const provider = process.env.TESTS_USE_MOCKNET
diff --git a/packages/cashscript/test/e2e/old/Mecenas.test.ts b/packages/cashscript/test/e2e/old/Mecenas.test.ts
index 4abf09eb..143f76d2 100644
--- a/packages/cashscript/test/e2e/old/Mecenas.test.ts
+++ b/packages/cashscript/test/e2e/old/Mecenas.test.ts
@@ -15,7 +15,7 @@ import {
 } from '../../fixture/vars.js';
 import { getTxOutputs } from '../../test-util.js';
 import { FailedTransactionError } from '../../../src/Errors.js';
-import artifact from '../../fixture/old/mecenas.json' assert { type: 'json' };
+import artifact from '../../fixture/old/mecenas.json' with { type: 'json' };
 
 if (!process.env.TESTS_USE_MOCKNET) {
 // Mecenas has tx.age check omitted for testing
diff --git a/packages/cashscript/test/e2e/old/misc.test.ts b/packages/cashscript/test/e2e/old/misc.test.ts
index 2aed7ad3..31f0b84d 100644
--- a/packages/cashscript/test/e2e/old/misc.test.ts
+++ b/packages/cashscript/test/e2e/old/misc.test.ts
@@ -13,8 +13,8 @@ import {
   alicePriv,
 } from '../../fixture/vars.js';
 import { getTxOutputs } from '../../test-util.js';
-import simpleCovenantArtifact from '../../fixture/old/simple_covenant.json' assert { type: 'json' };
-import mecenasBorderArtifact from '../../fixture/old/mecenas_border.json' assert { type: 'json' };
+import simpleCovenantArtifact from '../../fixture/old/simple_covenant.json' with { type: 'json' };
+import mecenasBorderArtifact from '../../fixture/old/mecenas_border.json' with { type: 'json' };
 
 if (!process.env.TESTS_USE_MOCKNET) {
   describe('v0.6.0 - Simple Covenant', () => {
diff --git a/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts b/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts
index 4d6887f6..aa02c50b 100644
--- a/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts
+++ b/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts
@@ -11,8 +11,8 @@ import {
 } from '../../fixture/vars.js';
 import { Network, Utxo } from '../../../src/interfaces.js';
 import { utxoComparator, calculateDust } from '../../../src/utils.js';
-import p2pkhArtifact from '../../fixture/p2pkh.json' assert { type: 'json' };
-import twtArtifact from '../../fixture/transfer_with_timeout.json' assert { type: 'json' };
+import p2pkhArtifact from '../../fixture/p2pkh.json' with { type: 'json' };
+import twtArtifact from '../../fixture/transfer_with_timeout.json' with { type: 'json' };
 import { TransactionBuilder } from '../../../src/TransactionBuilder.js';
 import { getTxOutputs } from '../../test-util.js';
 
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 335f9fff..608497a8 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -1,8 +1,8 @@
 import { Contract, HashType, MockNetworkProvider, SignatureAlgorithm, SignatureTemplate, Transaction, randomNFT, randomToken, randomUtxo } from '../../../src/index.js';
-import TransferWithTimeout from '../transfer_with_timeout.json' assert { type: 'json' };
-import Mecenas from '../mecenas.json' assert { type: 'json' };
-import P2PKH from '../p2pkh.json' assert { type: 'json' };
-import HoldVault from '../hodl_vault.json' assert { type: 'json' };
+import TransferWithTimeout from '../transfer_with_timeout.json' with { type: 'json' };
+import Mecenas from '../mecenas.json' with { type: 'json' };
+import P2PKH from '../p2pkh.json' with { type: 'json' };
+import HoldVault from '../hodl_vault.json' with { type: 'json' };
 import { aliceAddress, alicePkh, alicePriv, alicePub, bobPkh, bobPriv, bobPub, oracle, oraclePub } from '../vars.js';
 import { WalletTemplate, hexToBin } from '@bitauth/libauth';
 
diff --git a/website/docs/sdk/testing-setup.md b/website/docs/sdk/testing-setup.md
index 82a001d1..7cb9234e 100644
--- a/website/docs/sdk/testing-setup.md
+++ b/website/docs/sdk/testing-setup.md
@@ -98,7 +98,7 @@ contract Example() {
 ```
 
 ```ts title="Example test file"
-import artifact from '../artifacts/example.json' assert { type: "json" };
+import artifact from '../artifacts/example.json' with { type: "json" };
 import { Contract, MockNetworkProvider, randomUtxo } from 'cashscript';
 import 'cashscript/jest';
 

From 53cb61fa697e4a731e32768748cc3d69851e45e2 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Tue, 29 Oct 2024 10:13:50 +0100
Subject: [PATCH 139/267] Replace bitcoin-rpc-promise-retry by
 @mr-zwets/bchn-api-wrapper (#229)

---
 .cspell.json                                  |  1 -
 packages/cashscript/package.json              |  2 +-
 .../bitcoin-rpc-promise-retry.d.ts            |  1 -
 .../src/network/BitcoinRpcNetworkProvider.ts  | 64 ++++++-------------
 yarn.lock                                     | 17 ++---
 5 files changed, 24 insertions(+), 61 deletions(-)
 delete mode 100644 packages/cashscript/src/external-types/bitcoin-rpc-promise-retry.d.ts

diff --git a/.cspell.json b/.cspell.json
index 29a1b2b9..f321eba6 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -261,6 +261,5 @@
         "**/grammar/**",
         // Do not spellcheck vendor code
         "**/node_modules/**",
-        "**/bitcoin-rpc-promise-retry.d.ts"
     ]
 }
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 66af3c71..dc3e2128 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -45,8 +45,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
     "@cashscript/utils": "^0.10.1",
+    "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "bip68": "^1.0.4",
-    "bitcoin-rpc-promise-retry": "^1.3.0",
     "delay": "^5.0.0",
     "electrum-cash": "^2.0.10",
     "fast-deep-equal": "^3.1.3",
diff --git a/packages/cashscript/src/external-types/bitcoin-rpc-promise-retry.d.ts b/packages/cashscript/src/external-types/bitcoin-rpc-promise-retry.d.ts
deleted file mode 100644
index 650d4d75..00000000
--- a/packages/cashscript/src/external-types/bitcoin-rpc-promise-retry.d.ts
+++ /dev/null
@@ -1 +0,0 @@
-declare module 'bitcoin-rpc-promise-retry';
diff --git a/packages/cashscript/src/network/BitcoinRpcNetworkProvider.ts b/packages/cashscript/src/network/BitcoinRpcNetworkProvider.ts
index 8aa883dc..bde9098d 100644
--- a/packages/cashscript/src/network/BitcoinRpcNetworkProvider.ts
+++ b/packages/cashscript/src/network/BitcoinRpcNetworkProvider.ts
@@ -1,20 +1,29 @@
-import RpcClientRetry from 'bitcoin-rpc-promise-retry';
 import { Utxo, Network } from '../interfaces.js';
 import NetworkProvider from './NetworkProvider.js';
+import {
+  BchnRpcClient,
+  type GetBlockCount,
+  type GetRawTransactionVerbosity0,
+  type ListUnspent,
+  type SendRawTransaction,
+} from '@mr-zwets/bchn-api-wrapper';
 
 export default class BitcoinRpcNetworkProvider implements NetworkProvider {
-  private rpcClient: IRpcClientRetry;
+  private rpcClient: BchnRpcClient;
 
   constructor(
     public network: Network,
     url: string,
-    opts?: object,
+    opts: {
+      rpcUser: string;
+      rpcPassword: string;
+    },
   ) {
-    this.rpcClient = new RpcClientRetry(url, opts);
+    this.rpcClient = new BchnRpcClient({ url, ...opts });
   }
 
   async getUtxos(address: string): Promise<Utxo[]> {
-    const result = await this.rpcClient.listUnspent(0, 9999999, [address]);
+    const result = await this.rpcClient.request<ListUnspent>('listunspent', 0, 9999999, [address]);
 
     const utxos = result.map((utxo) => ({
       txid: utxo.txid,
@@ -26,55 +35,18 @@ export default class BitcoinRpcNetworkProvider implements NetworkProvider {
   }
 
   async getBlockHeight(): Promise<number> {
-    return this.rpcClient.getBlockCount();
+    return this.rpcClient.request<GetBlockCount>('getblockcount');
   }
 
   async getRawTransaction(txid: string): Promise<string> {
-    return this.rpcClient.getRawTransaction(txid);
+    return this.rpcClient.request<GetRawTransactionVerbosity0>('getrawtransaction', txid, 0);
   }
 
   async sendRawTransaction(txHex: string): Promise<string> {
-    return this.rpcClient.sendRawTransaction(txHex);
+    return this.rpcClient.request<SendRawTransaction>('sendrawtransaction', txHex);
   }
 
-  getClient(): IRpcClientRetry {
+  getClient(): BchnRpcClient {
     return this.rpcClient;
   }
 }
-
-interface ListUnspentItem {
-  txid: string;
-  vout: number;
-  address: string;
-  label: string;
-  scriptPubKey: string;
-  amount: number;
-  confirmations: number;
-  redeemScript: string;
-  spendable: boolean;
-  solvable: boolean;
-  safe: boolean;
-}
-
-interface IRpcClientRetry {
-  constructor(url: string, opts?: object): void;
-  listUnspent(
-    minConf?: number,
-    maxConf?: number,
-    addresses?: string[],
-    includeUnsafe?: boolean,
-    queryOptions?: object,
-  ): Promise<ListUnspentItem[]>;
-  getBlockCount(): Promise<number>;
-  getRawTransaction(txid: string, verbose?: boolean, blockHash?: string): Promise<string>;
-  sendRawTransaction(hexString: string, allowHighFees?: boolean): Promise<string>;
-
-  // below are not required for NetworkProvider interface, but very useful
-  generate(nBlocks: number, maxTries?: number): Promise<string[]>;
-  generateToAddress(nBlocks: number, address: string, maxTries?: number): Promise<string[]>;
-  getNewAddress(label?: string): Promise<string>;
-  dumpPrivKey(address: string): Promise<string>;
-  getBalance(dummy?: string, minConf?: number, includeWatchOnly?: boolean): Promise<number>;
-  getBlock(blockHash: string, verbosity?: number): Promise<string>;
-  importAddress(address: string, label?: string, rescan?: boolean, p2sh?: boolean): Promise<void>;
-}
diff --git a/yarn.lock b/yarn.lock
index 1cfb6b96..fa9c965f 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2036,6 +2036,11 @@
     npmlog "^4.1.2"
     write-file-atomic "^2.3.0"
 
+"@mr-zwets/bchn-api-wrapper@^1.0.1":
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/@mr-zwets/bchn-api-wrapper/-/bchn-api-wrapper-1.0.1.tgz#1ecd9fca91ed7e33df9769e243ae04871d2d356f"
+  integrity sha512-EyKT6zgXh31JqTRsi+KCX04WPDjIqs80nfsafrKiUZTg8FgWzql1wSyYdggmeByB74yLHD0LouC40S8PMmvcZA==
+
 "@mrmlnc/readdir-enhanced@^2.2.1":
   version "2.2.1"
   resolved "https://registry.yarnpkg.com/@mrmlnc/readdir-enhanced/-/readdir-enhanced-2.2.1.tgz#524af240d1a360527b730475ecfa1344aa540dde"
@@ -3422,18 +3427,6 @@ bip68@^1.0.4:
   resolved "https://registry.yarnpkg.com/bip68/-/bip68-1.0.4.tgz#78a95c7a43fad183957995cc2e08d79b0c372c4d"
   integrity sha512-O1htyufFTYy3EO0JkHg2CLykdXEtV2ssqw47Gq9A0WByp662xpJnMEB9m43LZjsSDjIAOozWRExlFQk2hlV1XQ==
 
-bitcoin-rpc-promise-retry@^1.3.0:
-  version "1.3.0"
-  resolved "https://registry.yarnpkg.com/bitcoin-rpc-promise-retry/-/bitcoin-rpc-promise-retry-1.3.0.tgz#28a9f5aa7b5528b0518b0bcccde63e7384e1626b"
-  integrity sha512-xhldBhYwiUNY4spzkXXcU9LEq+nbSKJ5tvYWEUe/XTCe1VYoe8tEb5jJq4MBA2d+5egiUOA+P1QTTYm1FqPtOg==
-  dependencies:
-    bitcoind-rpc "^0.8.0"
-
-bitcoind-rpc@^0.8.0:
-  version "0.8.1"
-  resolved "https://registry.yarnpkg.com/bitcoind-rpc/-/bitcoind-rpc-0.8.1.tgz#11889972e46c346870d26cf680e3a7e3e52b1ff1"
-  integrity sha512-NfhykAT/x/P1SOiog8UzltvTiv6A6d2X5VWJ3UjGeAqFLXv+IYHy+E4fFCBmgQRyIb1EIcyIZK1SVpSOGRHsaw==
-
 bitcoinjs-message@^2.0.0:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/bitcoinjs-message/-/bitcoinjs-message-2.1.1.tgz#c55d78f4461691b77fa5f9341216f8cd7ae0d0f4"

From 34dbb50c4e2afb4556f3664161401919cab9744c Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 29 Oct 2024 10:18:47 +0100
Subject: [PATCH 140/267] Fix spellcheck

---
 .cspell.json | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/.cspell.json b/.cspell.json
index f321eba6..0eb10029 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -200,12 +200,15 @@
         "bitcoincashjs",
         "branchup",
         "bchguru",
+        "bchn",
         "cashcompiler",
         "cashninjas",
         "cherian",
         "CSCriptNum",
         "docu",
         "fundme",
+        "getblockcount",
+        "getrawtransaction",
         "hardhat",
         "hodlvault",
         "infima",
@@ -219,6 +222,7 @@
         "pako",
         "popd",
         "pushd",
+        "sendrawtransaction",
         "setfiletype",
         "tada",
         "tapswap",
@@ -235,7 +239,8 @@
         "withminchange",
         "withopreturn",
         "withtime",
-        "XBVJRKV"
+        "XBVJRKV",
+        "zwets"
     ],
     "ignorePaths": [
         // Do not spellcheck NPM files

From b8fd36e9a324333dc4ef0b476d21d09ebd19eb20 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 29 Oct 2024 10:25:13 +0100
Subject: [PATCH 141/267] Remove hash.js in favour of libauth hashing functions

---
 packages/utils/package.json | 3 +--
 packages/utils/src/hash.ts  | 9 ++++-----
 2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/packages/utils/package.json b/packages/utils/package.json
index 61a0a452..969aa2a8 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -40,8 +40,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^3.0.0",
-    "hash.js": "^1.1.7"
+    "@bitauth/libauth": "^3.0.0"
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
diff --git a/packages/utils/src/hash.ts b/packages/utils/src/hash.ts
index 2127afd5..e8b5d644 100644
--- a/packages/utils/src/hash.ts
+++ b/packages/utils/src/hash.ts
@@ -1,16 +1,15 @@
-// TODO: Replace with libauth
-import hash from 'hash.js';
+import { sha256 as sha256Lib, ripemd160 as ripemd160Lib, sha512 as sha512Lib } from '@bitauth/libauth';
 
 export function sha512(payload: Uint8Array): Uint8Array {
-  return Uint8Array.from(hash.sha512().update(payload).digest());
+  return sha512Lib.hash(payload);
 }
 
 export function sha256(payload: Uint8Array): Uint8Array {
-  return Uint8Array.from(hash.sha256().update(payload).digest());
+  return sha256Lib.hash(payload);
 }
 
 export function ripemd160(payload: Uint8Array): Uint8Array {
-  return Uint8Array.from(hash.ripemd160().update(payload).digest());
+  return ripemd160Lib.hash(payload);
 }
 
 export function hash160(payload: Uint8Array): Uint8Array {

From fd689870dccb09b64869abcb0878b3d284eb1510 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 29 Oct 2024 10:35:32 +0100
Subject: [PATCH 142/267] Fix tests

---
 .../cashscript/test/e2e/Announcement.test.ts  | 31 +++++--------------
 packages/cashscript/test/e2e/P2PKH.test.ts    |  8 ++---
 .../TransactionBuilder.test.ts                | 19 ++++++------
 packages/cashscript/test/test-util.ts         |  7 ++++-
 4 files changed, 25 insertions(+), 40 deletions(-)

diff --git a/packages/cashscript/test/e2e/Announcement.test.ts b/packages/cashscript/test/e2e/Announcement.test.ts
index d45ecf2c..2821362d 100644
--- a/packages/cashscript/test/e2e/Announcement.test.ts
+++ b/packages/cashscript/test/e2e/Announcement.test.ts
@@ -1,11 +1,9 @@
 import {
   Contract, ElectrumNetworkProvider, MockNetworkProvider, Network,
 } from '../../src/index.js';
-import { getTxOutputs } from '../test-util.js';
+import { getLargestUtxo, getTxOutputs } from '../test-util.js';
 import { FailedRequireError } from '../../src/Errors.js';
-import {
-  createOpReturnOutput, randomUtxo, utxoComparator,
-} from '../../src/utils.js';
+import { createOpReturnOutput, randomUtxo } from '../../src/utils.js';
 import { aliceAddress } from '../fixture/vars.js';
 import artifact from '../fixture/announcement.json' with { type: 'json' };
 
@@ -28,10 +26,7 @@ describe('Announcement', () => {
       const to = announcement.address;
       const amount = 1000n;
 
-      const largestUtxo = (await announcement.getUtxos())
-        .sort(utxoComparator)
-        .reverse()
-        .slice(0, 1);
+      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
 
       // when
       const txPromise = announcement.functions
@@ -50,10 +45,7 @@ describe('Announcement', () => {
     it('should fail when trying to announce incorrect announcement', async () => {
       // given
       const str = 'A contract may injure a human being and, through inaction, allow a human being to come to harm.';
-      const largestUtxo = (await announcement.getUtxos())
-        .sort(utxoComparator)
-        .reverse()
-        .slice(0, 1);
+      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
 
       // when
       const txPromise = announcement.functions
@@ -73,10 +65,7 @@ describe('Announcement', () => {
     it('should fail when sending incorrect amount of change', async () => {
       // given
       const str = 'A contract may not injure a human being or, through inaction, allow a human being to come to harm.';
-      const largestUtxo = (await announcement.getUtxos())
-        .sort(utxoComparator)
-        .reverse()
-        .slice(0, 1);
+      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
 
       // when
       const txPromise = announcement.functions
@@ -96,10 +85,7 @@ describe('Announcement', () => {
     it('should fail when sending the correct change amount to an incorrect address', async () => {
       // given
       const str = 'A contract may not injure a human being or, through inaction, allow a human being to come to harm.';
-      const [largestUtxo] = (await announcement.getUtxos())
-        .sort(utxoComparator)
-        .reverse()
-        .slice(0, 1);
+      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
       const changeAmount = largestUtxo?.satoshis - minerFee;
 
       // when
@@ -121,10 +107,7 @@ describe('Announcement', () => {
     it('should succeed when announcing correct announcement', async () => {
       // given
       const str = 'A contract may not injure a human being or, through inaction, allow a human being to come to harm.';
-      const largestUtxo = (await announcement.getUtxos())
-        .sort(utxoComparator)
-        .reverse()
-        .slice(0, 1);
+      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
 
       // when
       const tx = await announcement.functions
diff --git a/packages/cashscript/test/e2e/P2PKH.test.ts b/packages/cashscript/test/e2e/P2PKH.test.ts
index a9826c2e..9a313829 100644
--- a/packages/cashscript/test/e2e/P2PKH.test.ts
+++ b/packages/cashscript/test/e2e/P2PKH.test.ts
@@ -89,8 +89,7 @@ describe('P2PKH-no-tokens', () => {
       // given
       const to = p2pkhInstance.address;
       const amount = 1000n;
-      const utxos = await p2pkhInstance.getUtxos();
-      utxos.sort(utxoComparator).reverse();
+      const utxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
       const { utxos: gathered } = gatherUtxos(utxos, { amount });
       const failureAmount = gathered.reduce((acc, utxo) => acc + utxo.satoshis, 0n) + 1n;
 
@@ -109,8 +108,7 @@ describe('P2PKH-no-tokens', () => {
       // given
       const to = p2pkhInstance.address;
       const amount = 1000n;
-      const utxos = await p2pkhInstance.getUtxos();
-      utxos.sort(utxoComparator).reverse();
+      const utxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
       const { utxos: gathered } = gatherUtxos(utxos, { amount });
 
       // when
@@ -191,7 +189,7 @@ describe('P2PKH-no-tokens', () => {
       const to = bobAddress;
       const amount = 10000n;
 
-      const contractUtxos = await p2pkhInstance.getUtxos();
+      const contractUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
       const bobUtxos = await provider.getUtxos(bobAddress);
 
       // when
diff --git a/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts b/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts
index aa02c50b..bd6ce3b2 100644
--- a/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts
+++ b/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts
@@ -36,8 +36,7 @@ describe('Transaction Builder', () => {
       const amount = 1000n;
       const fee = 1000n;
 
-      const utxos = await p2pkhInstance.getUtxos();
-      utxos.sort(utxoComparator).reverse();
+      const utxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
       const { utxos: gathered, total } = gatherUtxos(utxos, { amount });
 
       const change = total - amount - fee;
@@ -76,7 +75,7 @@ describe('Transaction Builder', () => {
       const amount = 10000n;
       const fee = 1000n;
 
-      const contractUtxos = await p2pkhInstance.getUtxos();
+      const contractUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
       const bobUtxos = await getAddressUtxos(bobAddress);
       const bobTemplate = new SignatureTemplate(bobPriv);
 
@@ -125,9 +124,9 @@ describe('Transaction Builder', () => {
   it('should build a transaction that can spend from 2 different contracts and P2PKH + OP_RETURN', async () => {
     const fee = 1000n;
 
-    const carolUtxos = await provider.getUtxos(carolAddress);
-    const p2pkhUtxos = await p2pkhInstance.getUtxos();
-    const twtUtxos = await twtInstance.getUtxos();
+    const carolUtxos = (await provider.getUtxos(carolAddress)).sort(utxoComparator).reverse();
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
+    const twtUtxos = (await twtInstance.getUtxos()).sort(utxoComparator).reverse();
 
     const change = carolUtxos[0].satoshis - fee;
     const dustAmount = calculateDust({ to: carolAddress, amount: change });
@@ -157,7 +156,7 @@ describe('Transaction Builder', () => {
   it('should fail when fee is higher than maxFee', async () => {
     const fee = 2000n;
     const maxFee = 1000n;
-    const p2pkhUtxos = await p2pkhInstance.getUtxos();
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
 
     const amount = p2pkhUtxos[0].satoshis - fee;
     const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
@@ -178,7 +177,7 @@ describe('Transaction Builder', () => {
   it('should succeed when fee is lower than maxFee', async () => {
     const fee = 1000n;
     const maxFee = 2000n;
-    const p2pkhUtxos = await p2pkhInstance.getUtxos();
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
 
     const amount = p2pkhUtxos[0].satoshis - fee;
     const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
@@ -199,7 +198,7 @@ describe('Transaction Builder', () => {
 
   it('should fail when locktime is higher than current block height', async () => {
     const fee = 1000n;
-    const p2pkhUtxos = await p2pkhInstance.getUtxos();
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
 
     const amount = p2pkhUtxos[0].satoshis - fee;
     const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
@@ -221,7 +220,7 @@ describe('Transaction Builder', () => {
 
   it('should succeed when locktime is lower than current block height', async () => {
     const fee = 1000n;
-    const p2pkhUtxos = await p2pkhInstance.getUtxos();
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
 
     const amount = p2pkhUtxos[0].satoshis - fee;
     const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
diff --git a/packages/cashscript/test/test-util.ts b/packages/cashscript/test/test-util.ts
index fd7e8f90..e4852f10 100644
--- a/packages/cashscript/test/test-util.ts
+++ b/packages/cashscript/test/test-util.ts
@@ -4,9 +4,10 @@ import {
   Transaction,
   binToHex,
 } from '@bitauth/libauth';
-import { Output, Network } from '../src/interfaces.js';
+import { Output, Network, Utxo } from '../src/interfaces.js';
 import { network as defaultNetwork } from './fixture/vars.js';
 import { getNetworkPrefix, libauthOutputToCashScriptOutput } from '../src/utils.js';
+import { utxoComparator } from '../src/utils.js';
 
 export function getTxOutputs(tx: Transaction, network: Network = defaultNetwork): Output[] {
   return tx.outputs.map((o) => {
@@ -30,3 +31,7 @@ export function getTxOutputs(tx: Transaction, network: Network = defaultNetwork)
     };
   });
 }
+
+export function getLargestUtxo(utxos: Utxo[]): Utxo {
+  return [...utxos].sort(utxoComparator).reverse()[0];
+}

From e9e1babf1dc09740fdd8bed299fd35558b7471b6 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 29 Oct 2024 10:42:28 +0100
Subject: [PATCH 143/267] Remove bip39 devDependency in favour of libauth

---
 examples/common-js.js                    | 4 ++--
 examples/common.ts                       | 4 ++--
 examples/package.json                    | 1 -
 packages/cashscript/package.json         | 1 -
 packages/cashscript/test/fixture/vars.ts | 5 ++---
 website/docs/sdk/examples.md             | 4 ++--
 6 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/examples/common-js.js b/examples/common-js.js
index 82e1c1a2..722eebcc 100644
--- a/examples/common-js.js
+++ b/examples/common-js.js
@@ -4,13 +4,13 @@ import {
   deriveHdPath,
   secp256k1,
   encodeCashAddress,
+  deriveSeedFromBip39Mnemonic,
 } from '@bitauth/libauth';
-import bip39 from 'bip39';
 
 // This is duplicated from common.ts because it is not possible to import from a .ts file in p2pkh.js
 
 // Generate entropy from BIP39 mnemonic phrase and initialise a root HD-wallet node
-const seed = await bip39.mnemonicToSeed('CashScript Examples');
+const seed = deriveSeedFromBip39Mnemonic('CashScript Examples');
 const rootNode = deriveHdPrivateNodeFromSeed(seed, { assumeValidity: true, throwErrors: true });
 const baseDerivationPath = "m/44'/145'/0'/0";
 
diff --git a/examples/common.ts b/examples/common.ts
index b3445c49..c8b43231 100644
--- a/examples/common.ts
+++ b/examples/common.ts
@@ -4,12 +4,12 @@ import {
   deriveHdPath,
   secp256k1,
   encodeCashAddress,
+  deriveSeedFromBip39Mnemonic,
 } from '@bitauth/libauth';
-import bip39 from 'bip39';
 import { PriceOracle } from './PriceOracle.js';
 
 // Generate entropy from BIP39 mnemonic phrase and initialise a root HD-wallet node
-const seed = await bip39.mnemonicToSeed('CashScript Examples');
+const seed = deriveSeedFromBip39Mnemonic('CashScript Examples');
 const rootNode = deriveHdPrivateNodeFromSeed(seed, { assumeValidity: true, throwErrors: true });
 const baseDerivationPath = "m/44'/145'/0'/0";
 
diff --git a/examples/package.json b/examples/package.json
index 4b409753..49248b1c 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -13,7 +13,6 @@
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
     "@types/node": "^12.7.8",
-    "bip39": "^3.0.4",
     "cashc": "^0.10.1",
     "cashscript": "^0.10.1",
     "eslint": "^8.56.0",
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index dc3e2128..f20588c8 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -56,7 +56,6 @@
     "@jest/globals": "^29.4.1",
     "@psf/bch-js": "^4.15.0",
     "@types/pako": "^2.0.3",
-    "bip39": "^3.0.4",
     "eslint": "^8.54.0",
     "jest": "^29.4.1",
     "typescript": "^5.5.4"
diff --git a/packages/cashscript/test/fixture/vars.ts b/packages/cashscript/test/fixture/vars.ts
index a228270e..70614c91 100644
--- a/packages/cashscript/test/fixture/vars.ts
+++ b/packages/cashscript/test/fixture/vars.ts
@@ -1,18 +1,17 @@
 import {
   deriveHdPath,
   deriveHdPrivateNodeFromSeed,
+  deriveSeedFromBip39Mnemonic,
   encodeCashAddress,
   secp256k1,
 } from '@bitauth/libauth';
 import { hash160 } from '@cashscript/utils';
-import bip39 from 'bip39';
 import { PriceOracle } from './PriceOracle.js';
 import { Network } from '../../src/interfaces.js';
 
 export const network = Network.CHIPNET;
 
-const seed = await bip39.mnemonicToSeed('CashScript Tests');
-
+const seed = deriveSeedFromBip39Mnemonic('CashScript Tests');
 const rootNode = deriveHdPrivateNodeFromSeed(seed, { assumeValidity: true, throwErrors: true });
 const baseDerivationPath = "m/44'/145'/0'/0";
 
diff --git a/website/docs/sdk/examples.md b/website/docs/sdk/examples.md
index 2ac0ccd1..c03a8af7 100644
--- a/website/docs/sdk/examples.md
+++ b/website/docs/sdk/examples.md
@@ -26,14 +26,14 @@ import { hash160 } from '@cashscript/utils';
 import {
   deriveHdPrivateNodeFromSeed,
   deriveHdPath,
+  deriveSeedFromBip39Mnemonic,
   secp256k1,
   encodeCashAddress,
 } from '@bitauth/libauth';
-import bip39 from 'bip39';
 import { PriceOracle } from './PriceOracle.js';
 
 // Generate entropy from BIP39 mnemonic phrase and initialise a root HD-wallet node
-const seed = await bip39.mnemonicToSeed('CashScript Examples');
+const seed = deriveSeedFromBip39Mnemonic('CashScript Examples');
 const rootNode = deriveHdPrivateNodeFromSeed(seed, true);
 const baseDerivationPath = "m/44'/145'/0'/0";
 

From 188537d18212687d2eb8477168832551e34ecf36 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 29 Oct 2024 11:38:08 +0100
Subject: [PATCH 144/267] Copy bip68 library code and adapt it to TypeScript

---
 packages/cashscript/package.json              |  1 -
 packages/cashscript/src/Transaction.ts        |  4 +-
 .../cashscript/src/external-types/bip68.d.ts  |  1 -
 packages/utils/src/bip68.ts                   | 60 +++++++++++++++++++
 packages/utils/src/index.ts                   |  5 +-
 website/docs/guides/covenants.md              |  5 +-
 yarn.lock                                     | 17 +-----
 7 files changed, 68 insertions(+), 25 deletions(-)
 delete mode 100644 packages/cashscript/src/external-types/bip68.d.ts
 create mode 100644 packages/utils/src/bip68.ts

diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index f20588c8..fee9e483 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -46,7 +46,6 @@
     "@bitauth/libauth": "^3.0.0",
     "@cashscript/utils": "^0.10.1",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
-    "bip68": "^1.0.4",
     "delay": "^5.0.0",
     "electrum-cash": "^2.0.10",
     "fast-deep-equal": "^3.1.3",
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index f3ff1373..9bae0bc2 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -1,4 +1,3 @@
-import bip68 from 'bip68';
 import {
   hexToBin,
   decodeTransaction,
@@ -8,6 +7,7 @@ import {
 import delay from 'delay';
 import {
   AbiFunction,
+  encodeBip68,
   placeholder,
   scriptToBytecode,
 } from '@cashscript/utils';
@@ -114,7 +114,7 @@ export class Transaction {
   }
 
   withAge(age: number): this {
-    this.sequence = bip68.encode({ blocks: age });
+    this.sequence = encodeBip68({ blocks: age });
     return this;
   }
 
diff --git a/packages/cashscript/src/external-types/bip68.d.ts b/packages/cashscript/src/external-types/bip68.d.ts
deleted file mode 100644
index 610a1628..00000000
--- a/packages/cashscript/src/external-types/bip68.d.ts
+++ /dev/null
@@ -1 +0,0 @@
-declare module 'bip68';
diff --git a/packages/utils/src/bip68.ts b/packages/utils/src/bip68.ts
new file mode 100644
index 00000000..46763061
--- /dev/null
+++ b/packages/utils/src/bip68.ts
@@ -0,0 +1,60 @@
+// Code taken and adapted from https://github.com/bitcoinjs/bip68
+// If we make signficant changes to this code, we should also take and adapt the tests from that repository.
+
+// see https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki#compatibility
+
+const SEQUENCE_FINAL = 0xffffffff;
+const SEQUENCE_LOCKTIME_DISABLE_FLAG = (1 << 31);
+const SEQUENCE_LOCKTIME_GRANULARITY = 9;
+const SEQUENCE_LOCKTIME_MASK = 0x0000ffff;
+const SEQUENCE_LOCKTIME_TYPE_FLAG = (1 << 22);
+
+const BLOCKS_MAX = SEQUENCE_LOCKTIME_MASK;
+const SECONDS_MOD = 1 << SEQUENCE_LOCKTIME_GRANULARITY;
+const SECONDS_MAX = SEQUENCE_LOCKTIME_MASK << SEQUENCE_LOCKTIME_GRANULARITY;
+
+interface DecodedSequence {
+  blocks?: number;
+  seconds?: number;
+}
+
+export function decodeBip68(sequence: number): DecodedSequence {
+  // If the disable flag is set, we return an empty object
+  if (sequence & SEQUENCE_LOCKTIME_DISABLE_FLAG) return {};
+
+  // If the SEQUENCE_LOCKTIME_TYPE_FLAG is set, that means that the sequence is in seconds
+  if (sequence & SEQUENCE_LOCKTIME_TYPE_FLAG) {
+    // If the sequence is in seconds, we need to shift it by the granularity
+    // (because every "unit" of time corresponds to 512 seconds)
+    const seconds = (sequence & SEQUENCE_LOCKTIME_MASK) << SEQUENCE_LOCKTIME_GRANULARITY;
+    return { seconds };
+  }
+
+  // If the disable flag is not set, and the SEQUENCE_LOCKTIME_TYPE_FLAG is not set, the sequence is in blocks
+  const blocks = sequence & SEQUENCE_LOCKTIME_MASK;
+  return { blocks };
+}
+
+export function encodeBip68({ blocks, seconds }: DecodedSequence): number {
+  if (blocks !== undefined && seconds !== undefined) throw new TypeError('Cannot encode blocks AND seconds');
+
+  // If the input is correct, we encode it as a sequence in seconds (using the SEQUENCE_LOCKTIME_TYPE_FLAG)
+  if (seconds !== undefined) {
+    if (!Number.isFinite(seconds)) throw new TypeError('Expected Number seconds');
+    if (seconds > SECONDS_MAX) throw new TypeError('Expected Number seconds <= ' + SECONDS_MAX);
+    if (seconds % SECONDS_MOD !== 0) throw new TypeError('Expected Number seconds as a multiple of ' + SECONDS_MOD);
+
+    return SEQUENCE_LOCKTIME_TYPE_FLAG | (seconds >> SEQUENCE_LOCKTIME_GRANULARITY);
+  }
+
+  // If the input is correct, we return the blocks (no further encoding needed)
+  if (blocks !== undefined) {
+    if (!Number.isFinite(blocks)) throw new TypeError('Expected Number blocks');
+    if (blocks > SEQUENCE_LOCKTIME_MASK) throw new TypeError('Expected Number blocks <= ' + BLOCKS_MAX);
+
+    return blocks;
+  }
+
+  // If neither blocks nor seconds are provided, we assume the sequence is final
+  return SEQUENCE_FINAL;
+}
diff --git a/packages/utils/src/index.ts b/packages/utils/src/index.ts
index 616354ab..de1295c9 100644
--- a/packages/utils/src/index.ts
+++ b/packages/utils/src/index.ts
@@ -1,7 +1,8 @@
 export * from './artifact.js';
+export * from './bip68.js';
+export * from './bitauth-script.js';
 export * from './data.js';
 export * from './hash.js';
 export * from './script.js';
-export * from './types.js';
 export * from './source-map.js';
-export * from './bitauth-script.js';
+export * from './types.js';
diff --git a/website/docs/guides/covenants.md b/website/docs/guides/covenants.md
index bd08db0e..9f8b3c86 100644
--- a/website/docs/guides/covenants.md
+++ b/website/docs/guides/covenants.md
@@ -137,7 +137,7 @@ This contract applies similar techniques as the previous two examples to verify
 
 ## Local State
 
-Smart contracts which persist for multiple transactions might want to keep data for later use. This is called local state. With the CashTokens upgrade, local state can be kept in the commitment field of the NFT of the smart contract UTXO. Because the state is not kept in the script of the smart contract itself, the address can remain the same. 
+Smart contracts which persist for multiple transactions might want to keep data for later use. This is called local state. With the CashTokens upgrade, local state can be kept in the commitment field of the NFT of the smart contract UTXO. Because the state is not kept in the script of the smart contract itself, the address can remain the same.
 
 :::info
 Covenants can also use 'simulated state', where state is kept in the contract script and the contract enforces a new P2SH locking bytecode of the contract with a different state update. This method causes the contract address to change with each state update.
@@ -211,7 +211,7 @@ We use `tx.locktime` to introspect the value of the timelock, and to write the v
 
 ### Issuing NFTs as receipts
 
-A covenant that manages funds (BCH + fungible tokens of a certain category) which are pooled together from different people often wants to enable its participants to also exit the covenants with their funds. It would be incredibly hard continuously updating a data structure to keep track of which address contributed how much in the local state of the contract. A much better solution is to issue receipts each time funds are added to the pool! This way the contract does not have a 'global view' of who owns what at any time, but it can validate the receipts when invoking a withdrawal. 
+A covenant that manages funds (BCH + fungible tokens of a certain category) which are pooled together from different people often wants to enable its participants to also exit the covenants with their funds. It would be incredibly hard continuously updating a data structure to keep track of which address contributed how much in the local state of the contract. A much better solution is to issue receipts each time funds are added to the pool! This way the contract does not have a 'global view' of who owns what at any time, but it can validate the receipts when invoking a withdrawal.
 
 Technically this happens by minting a new NFT, with in the commitment field the amount of satoshis or fungible tokens that were contributed to the pool, and sending this to the address of the contributor.
 
@@ -320,4 +320,3 @@ We have discussed the main uses for covenants as they exist on Bitcoin Cash toda
 Keeping local state in NFTs and issuing NFTs as receipts are two strategies which can be used to create much more sophisticated decentralized applications such as the AMM-style DEX named [Jedex](https://blog.bitjson.com/jedex-decentralized-exchanges-on-bitcoin-cash/).
 
 [bitcoin-covenants]: https://fc16.ifca.ai/bitcoin/papers/MES16.pdf
-[bip68]: https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki
diff --git a/yarn.lock b/yarn.lock
index fa9c965f..17e8a677 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -3405,16 +3405,6 @@ bip39@^3.0.2:
     pbkdf2 "^3.0.9"
     randombytes "^2.0.1"
 
-bip39@^3.0.4:
-  version "3.0.4"
-  resolved "https://registry.yarnpkg.com/bip39/-/bip39-3.0.4.tgz#5b11fed966840b5e1b8539f0f54ab6392969b2a0"
-  integrity sha512-YZKQlb752TrUWqHWj7XAwCSjYEgGAk+/Aas3V7NyjQeZYsztO8JnQUaCWhcnL4T+jL8nvB8typ2jRPzTlgugNw==
-  dependencies:
-    "@types/node" "11.11.6"
-    create-hash "^1.1.0"
-    pbkdf2 "^3.0.9"
-    randombytes "^2.0.1"
-
 bip66@^1.1.0, bip66@^1.1.5:
   version "1.1.5"
   resolved "https://registry.yarnpkg.com/bip66/-/bip66-1.1.5.tgz#01fa8748785ca70955d5011217d1b3139969ca22"
@@ -3422,11 +3412,6 @@ bip66@^1.1.0, bip66@^1.1.5:
   dependencies:
     safe-buffer "^5.0.1"
 
-bip68@^1.0.4:
-  version "1.0.4"
-  resolved "https://registry.yarnpkg.com/bip68/-/bip68-1.0.4.tgz#78a95c7a43fad183957995cc2e08d79b0c372c4d"
-  integrity sha512-O1htyufFTYy3EO0JkHg2CLykdXEtV2ssqw47Gq9A0WByp662xpJnMEB9m43LZjsSDjIAOozWRExlFQk2hlV1XQ==
-
 bitcoinjs-message@^2.0.0:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/bitcoinjs-message/-/bitcoinjs-message-2.1.1.tgz#c55d78f4461691b77fa5f9341216f8cd7ae0d0f4"
@@ -6566,7 +6551,7 @@ hash-base@^3.0.0:
     readable-stream "^3.6.0"
     safe-buffer "^5.2.0"
 
-hash.js@^1.0.0, hash.js@^1.0.3, hash.js@^1.1.7:
+hash.js@^1.0.0, hash.js@^1.0.3:
   version "1.1.7"
   resolved "https://registry.yarnpkg.com/hash.js/-/hash.js-1.1.7.tgz#0babca538e8d4ee4a0f8988d68866537a003cf42"
   integrity sha512-taOaskGt4z4SOANNseOviYDvjEJinIkRgmp7LbKP2YTTmVxWBl87s/uzK9r+44BclBSp2X7K1hqeNfz9JbBeXA==

From 6d7fccc7227ea03a05b70d3436f6bf18d37ac917 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 29 Oct 2024 11:54:34 +0100
Subject: [PATCH 145/267] Fix fee estimation when using ECDSA signatures

---
 packages/cashscript/src/Transaction.ts | 17 +++++++++++++----
 packages/utils/src/bip68.ts            |  2 +-
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 9bae0bc2..f5c78fec 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -21,6 +21,7 @@ import {
   isUtxoP2PKH,
   TransactionDetails,
   Unlocker,
+  SignatureAlgorithm,
 } from './interfaces.js';
 import {
   createInputScript,
@@ -336,10 +337,18 @@ export class Transaction {
       }
     }
 
-    // Replace all SignatureTemplate with 65-length placeholder Uint8Arrays
-    const placeholderArgs = this.encodedFunctionArgs.map((arg) => (
-      arg instanceof SignatureTemplate ? placeholder(65) : arg
-    ));
+    // Replace all SignatureTemplate with placeholder Uint8Arrays
+    const placeholderArgs = this.encodedFunctionArgs.map((arg) => {
+      if (!(arg instanceof SignatureTemplate)) return arg;
+
+      // Schnorr signatures are *always* 65 bytes: 64 for signature + 1 byte for hashtype.
+      if (arg.getSignatureAlgorithm() === SignatureAlgorithm.SCHNORR) return placeholder(65);
+
+      // ECDSA signatures are at least 71 bytes: 64 bytes for signature + 1 byte for hashtype + 6 bytes for encoding
+      // overhead. But it may have up to 2 extra bytes for padding, so we overestimate by 2 bytes.
+      // (see https://transactionfee.info/charts/bitcoin-script-ecdsa-length/)
+      return placeholder(73);
+    });
 
     // Create a placeholder preimage of the correct size
     const placeholderPreimage = this.abiFunction.covenant
diff --git a/packages/utils/src/bip68.ts b/packages/utils/src/bip68.ts
index 46763061..1c31fc4b 100644
--- a/packages/utils/src/bip68.ts
+++ b/packages/utils/src/bip68.ts
@@ -1,5 +1,5 @@
 // Code taken and adapted from https://github.com/bitcoinjs/bip68
-// If we make signficant changes to this code, we should also take and adapt the tests from that repository.
+// If we make significant changes to this code, we should also take and adapt the tests from that repository.
 
 // see https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki#compatibility
 

From bb90f4b2283baf4c44f47fa6e871c40ede8ee75c Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Mon, 4 Nov 2024 08:50:09 +0100
Subject: [PATCH 146/267] update FullStackNetworkProvider & improve tests
 (#232)

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
---
 packages/cashscript/package.json              |    2 +-
 .../cashscript/test/e2e/FullStack.test.ts     |   57 -
 .../test/e2e/network/FullStack.test.ts        |   76 +
 yarn.lock                                     | 1844 ++---------------
 4 files changed, 242 insertions(+), 1737 deletions(-)
 delete mode 100644 packages/cashscript/test/e2e/FullStack.test.ts
 create mode 100644 packages/cashscript/test/e2e/network/FullStack.test.ts

diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index fee9e483..219b0e89 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -53,7 +53,7 @@
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
-    "@psf/bch-js": "^4.15.0",
+    "@psf/bch-js": "^6.8.0",
     "@types/pako": "^2.0.3",
     "eslint": "^8.54.0",
     "jest": "^29.4.1",
diff --git a/packages/cashscript/test/e2e/FullStack.test.ts b/packages/cashscript/test/e2e/FullStack.test.ts
deleted file mode 100644
index 002d74a9..00000000
--- a/packages/cashscript/test/e2e/FullStack.test.ts
+++ /dev/null
@@ -1,57 +0,0 @@
-import BCHJS from '@psf/bch-js';
-import { Contract, SignatureTemplate, FullStackNetworkProvider } from '../../src/index.js';
-import {
-  alicePriv,
-  bobPkh,
-  bobPriv,
-  bobPub,
-} from '../fixture/vars.js';
-import { getTxOutputs } from '../test-util.js';
-import { FailedRequireError } from '../../src/Errors.js';
-import artifact from '../fixture/p2pkh.json' with { type: 'json' };
-
-describe.skip('P2PKH (using FullStackNetworkProvider)', () => {
-  let p2pkhInstance: Contract;
-
-  beforeAll(() => {
-    const provider = new FullStackNetworkProvider('mainnet', new BCHJS({ restURL: 'https://free-main.fullstack.cash/v5/' }));
-    // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
-    p2pkhInstance = new Contract(artifact, [bobPkh], { provider });
-    console.log(p2pkhInstance.address);
-  });
-
-  describe('send', () => {
-    it('should fail when using incorrect function arguments', async () => {
-      // given
-      const to = p2pkhInstance.address;
-      const amount = 10000n;
-
-      // when
-      const txPromise = p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(alicePriv))
-        .to(to, amount)
-        .send();
-
-      // then
-      await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('Signature must be zero for failed CHECK(MULTI)SIG operation');
-    });
-
-    it('should succeed when using correct function arguments', async () => {
-      // given
-      const to = p2pkhInstance.address;
-      const amount = 10000n;
-
-      // when
-      const tx = await p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(bobPriv))
-        .to(to, amount)
-        .send();
-
-      // then
-      const txOutputs = getTxOutputs(tx);
-      expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-      expect(tx.txid).toBeDefined();
-    });
-  });
-});
diff --git a/packages/cashscript/test/e2e/network/FullStack.test.ts b/packages/cashscript/test/e2e/network/FullStack.test.ts
new file mode 100644
index 00000000..d231ef50
--- /dev/null
+++ b/packages/cashscript/test/e2e/network/FullStack.test.ts
@@ -0,0 +1,76 @@
+import BCHJS from '@psf/bch-js';
+import { Contract, SignatureTemplate, FullStackNetworkProvider } from '../../../src/index.js';
+import {
+  alicePriv,
+  bobPkh,
+  bobPriv,
+  bobPub,
+} from '../../fixture/vars.js';
+import { getTxOutputs } from '../../test-util.js';
+import { FailedRequireError } from '../../../src/Errors.js';
+import artifact from '../../fixture/p2pkh.json' with { type: 'json' };
+
+if (!process.env.TESTS_USE_MOCKNET) {
+  describe('test FullStackNetworkProvider', () => {
+    const provider = new FullStackNetworkProvider('mainnet', new BCHJS({ restURL: 'https://api.fullstack.cash/v5/' }));
+
+    describe('get utxos using FullStackNetworkProvider', () => {
+      it('should get the utxos for a p2sh20 contract', async () => {
+        // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
+        const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh20' });
+        console.log(p2pkhInstance.address);
+
+        const utxos = await p2pkhInstance.getUtxos();
+        expect(Array.isArray(utxos)).toBe(true);
+      });
+      // Note: does not currently support p2sh32
+      it.skip('should get the utxos for a p2sh32 contract', async () => {
+        // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
+        const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh32' });
+        console.log(p2pkhInstance.address);
+
+        const utxos = await p2pkhInstance.getUtxos();
+        expect(Array.isArray(utxos)).toBe(true);
+      });
+    });
+
+    describe('send using FullStackNetworkProvider', () => {
+      // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
+      const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh20' });
+      console.log(p2pkhInstance.address);
+
+      it('should fail when using incorrect function arguments', async () => {
+        // given
+        const to = p2pkhInstance.address;
+        const amount = 10000n;
+
+        // when
+        const txPromise = p2pkhInstance.functions
+          .spend(bobPub, new SignatureTemplate(alicePriv))
+          .to(to, amount)
+          .send();
+
+        // then
+        await expect(txPromise).rejects.toThrow(FailedRequireError);
+        await expect(txPromise).rejects.toThrow('P2PKH.cash:5 Require statement failed at input 0 in contract P2PKH.cash at line 5.');
+      });
+
+      it('should succeed when using correct function arguments', async () => {
+        // given
+        const to = p2pkhInstance.address;
+        const amount = 10000n;
+
+        // when
+        const tx = await p2pkhInstance.functions
+          .spend(bobPub, new SignatureTemplate(bobPriv))
+          .to(to, amount)
+          .send();
+
+        // then
+        const txOutputs = getTxOutputs(tx, 'mainnet');
+        expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
+        expect(tx.txid).toBeDefined();
+      });
+    });
+  });
+}
diff --git a/yarn.lock b/yarn.lock
index 17e8a677..6836e89e 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -501,6 +501,14 @@
   resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-3.0.0.tgz#d88535fc5353d5ecd11db96d9a229e11c06a43d2"
   integrity sha512-3yoL31XpnhAnf5nDVMFk4xPqebxDwXrgYAwpa31ARJnV5A/eXWlpNYvCd6FTZPFM4VvKfjCBi+jRCrw1hOZ0Jg==
 
+"@chris.troutner/bip32-utils@1.0.5":
+  version "1.0.5"
+  resolved "https://registry.yarnpkg.com/@chris.troutner/bip32-utils/-/bip32-utils-1.0.5.tgz#b6722aeaad5fcda6fba69cbeda7e2a5e8afbd692"
+  integrity sha512-pa9dh5VpPmfol1bdLy+FyqONmxlf/QH6Q01a57OP6C9gTVOZM1Rt0kCLXxXKC6e2AnNIrXpYN1UtlyBm+r6P0g==
+  dependencies:
+    keccak "^3.0.1"
+    tape "*"
+
 "@cnakazawa/watch@^1.0.3":
   version "1.0.4"
   resolved "https://registry.yarnpkg.com/@cnakazawa/watch/-/watch-1.0.4.tgz#f864ae85004d0fcab6f50be9141c4da368d1656a"
@@ -2184,81 +2192,52 @@
   dependencies:
     "@types/node" ">= 8"
 
-"@psf/bch-js@^4.15.0":
-  version "4.15.0"
-  resolved "https://registry.yarnpkg.com/@psf/bch-js/-/bch-js-4.15.0.tgz#16050bd002141fee4587612d7f3b7799ac7a722d"
-  integrity sha512-i/FcMeTc2WrusLKvSh0yhrPIsa4r7mRW7Ze9qAXjbcXHwPc6Cg06axFQGQ5PXL1px0re7PbY+r7jAlmgBD7W+Q==
-  dependencies:
-    "@psf/bip21" "^2.0.1"
-    "@psf/bip32-utils" "^0.13.1"
-    "@psf/bitcoincash-ops" "^2.0.0"
-    "@psf/bitcoincashjs-lib" "^4.0.2"
-    "@psf/coininfo" "^4.0.0"
-    "@uppy/core" "^1.10.4"
-    "@uppy/tus" "^1.5.12"
-    assert "^2.0.0"
-    axios "^0.21.1"
-    bc-bip68 "^1.0.5"
-    bchaddrjs-slp "^0.2.5"
-    bigi "^1.4.2"
-    bignumber.js "^9.0.0"
-    bip-schnorr "^0.3.0"
-    bip38 "^2.0.2"
-    bip39 "^3.0.2"
-    bip66 "^1.1.5"
-    bitcoinjs-message "^2.0.0"
-    bs58 "^4.0.1"
-    buffer "^5.1.0"
-    cashaddrjs "^0.3.3"
-    chalk "^2.3.0"
-    clear "0.1.0"
-    commander "^3.0.0"
-    cp-file "^7.0.0"
-    ecurve "^1.0.6"
-    figlet "^1.2.0"
-    git-clone "^0.1.0"
-    ini "^1.3.8"
-    mkdirp "^0.5.1"
-    node-cmd "^3.0.0"
-    node-emoji "^1.8.1"
-    qrcode "^1.4.1"
-    randombytes "^2.0.6"
-    repl.history "^0.1.4"
-    safe-buffer "^5.1.2"
-    satoshi-bitcoin "^1.0.4"
+"@psf/bch-js@^6.8.0":
+  version "6.8.0"
+  resolved "https://registry.yarnpkg.com/@psf/bch-js/-/bch-js-6.8.0.tgz#c7b4c77a52c82795df4f249c78ad11d55ffc6af4"
+  integrity sha512-6my2gpIfwnMv3iL2IsdWYoHfZW6fVd4wpw4A0XGmgxra2E2fQEBWlfj8jIsu3f54ZTbcpTvO4tp5QT4dKKBlZQ==
+  dependencies:
+    "@chris.troutner/bip32-utils" "1.0.5"
+    "@psf/bip21" "2.0.1"
+    "@psf/bitcoincash-ops" "2.0.0"
+    "@psf/bitcoincashjs-lib" "4.0.3"
+    "@psf/coininfo" "4.0.0"
+    axios "0.26.1"
+    bc-bip68 "1.0.5"
+    bchaddrjs-slp "0.2.5"
+    bigi "1.4.2"
+    bignumber.js "9.0.0"
+    bip-schnorr "0.3.0"
+    bip38 "2.0.2"
+    bip39 "3.0.2"
+    bip66 "1.1.5"
+    bitcoinjs-message "2.0.0"
+    bs58 "4.0.1"
+    ecashaddrjs "1.0.7"
+    ini "1.3.8"
+    randombytes "2.0.6"
+    safe-buffer "5.1.2"
+    satoshi-bitcoin "1.0.4"
     slp-mdm "0.0.6"
     slp-parser "0.0.4"
-    socket.io "^2.1.1"
-    socket.io-client "^2.1.1"
-    touch "^3.1.0"
-    wif "^2.0.6"
+    wif "2.0.6"
 
-"@psf/bip21@^2.0.1":
+"@psf/bip21@2.0.1":
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/@psf/bip21/-/bip21-2.0.1.tgz#633a36e21176662620f2700324d0d8797f6bc03e"
   integrity sha512-U9c8xBV31n+D7qxOPBO0vQ015DNvKskWCUbVgoMfH5AUNHLYrSDWIrCx4P7v9etfdu6LpPdsYr53KDSAIk0b7Q==
   dependencies:
     qs "^6.3.0"
 
-"@psf/bip32-utils@^0.13.1":
-  version "0.13.1"
-  resolved "https://registry.yarnpkg.com/@psf/bip32-utils/-/bip32-utils-0.13.1.tgz#c3de9ea75825fecf938730507dccde821fc80f0d"
-  integrity sha512-5yM2o4TXW3gWKI3zxUFj9eeYqMYbA4Q1w+ptcfb+XnGpSZLrmwGtX48q8rApIKtikRceMEFXp1Jq6ed+bS+1nA==
-  dependencies:
-    keccak "^1.3.0"
-    nyc "*"
-    standard "^11.0.1"
-    tape "*"
-
-"@psf/bitcoincash-ops@^2.0.0":
+"@psf/bitcoincash-ops@2.0.0", "@psf/bitcoincash-ops@^2.0.0":
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/@psf/bitcoincash-ops/-/bitcoincash-ops-2.0.0.tgz#9d91fd4140b0908d8ab2a9244a0ecb2987780f9d"
   integrity sha512-M3PWqRpeJq6rli2NqWGbas76z9TrdGOmNuDFACBWBMctPucEAsFQY2AmyFHRSa7hEwythwvrPh9AG/n6ehmEog==
 
-"@psf/bitcoincashjs-lib@^4.0.2":
-  version "4.0.2"
-  resolved "https://registry.yarnpkg.com/@psf/bitcoincashjs-lib/-/bitcoincashjs-lib-4.0.2.tgz#e390fad47ca9ca77ed99ea1380c80eef02776660"
-  integrity sha512-fTy9mW4H0NkQ+dojGtf+nPduA27F3V2YpBi5licYUVjdVRD/xpUCTgEN1cYRAupOaeDH/AYOWT0MWLkbQSTxAQ==
+"@psf/bitcoincashjs-lib@4.0.3":
+  version "4.0.3"
+  resolved "https://registry.yarnpkg.com/@psf/bitcoincashjs-lib/-/bitcoincashjs-lib-4.0.3.tgz#d4e05bc8adf36e3f4e28e33110c774e8a1443852"
+  integrity sha512-sJYi7jYUqR7S+Z8TjN3W/5Lcju7xcIBxYLhIEpnOF+jR9kMt0ftpVjQBt8vVsJZUD8ArL9bf59oDETjdOUcdGQ==
   dependencies:
     "@psf/bitcoincash-ops" "^2.0.0"
     "@psf/pushdata-bitcoin" "^1.2.2"
@@ -2276,7 +2255,7 @@
     varuint-bitcoin "^1.0.4"
     wif "^2.0.1"
 
-"@psf/coininfo@^4.0.0":
+"@psf/coininfo@4.0.0":
   version "4.0.0"
   resolved "https://registry.yarnpkg.com/@psf/coininfo/-/coininfo-4.0.0.tgz#d65f95869549300cedf8217a05e1735d13a2af87"
   integrity sha512-RwBc09790kbaOt8uZJMyvLqf1UziTd20FXu78bM8bMlkClnZQTJyNDdLCsFSBkJQYAJtGMkjdQ/o3/UaSC7c2Q==
@@ -2319,11 +2298,6 @@
   resolved "https://registry.yarnpkg.com/@tootallnate/once/-/once-1.1.2.tgz#ccb91445360179a04e7fe6aff78c00ffc1eeaf82"
   integrity sha512-RbzJvlNzmRq5c3O09UipeuXno4tA1FE6ikOjxZK0tuxVv3412l64l5t1W5pj4+rJq9vpkm/kwiR07aZXnsKPxw==
 
-"@transloadit/prettier-bytes@0.0.7":
-  version "0.0.7"
-  resolved "https://registry.yarnpkg.com/@transloadit/prettier-bytes/-/prettier-bytes-0.0.7.tgz#cdb5399f445fdd606ed833872fa0cabdbc51686b"
-  integrity sha512-VeJbUb0wEKbcwaSlj5n+LscBl9IPgLPkHVGBkh00cztv6X4L/TJXK58LzFuBKX7/GAfiGhIwH67YTLTlzvIzBA==
-
 "@types/babel__core@^7.1.14":
   version "7.20.0"
   resolved "https://registry.yarnpkg.com/@types/babel__core/-/babel__core-7.20.0.tgz#61bc5a4cae505ce98e1e36c5445e4bee060d8891"
@@ -2605,50 +2579,6 @@
   resolved "https://registry.yarnpkg.com/@ungap/structured-clone/-/structured-clone-1.2.0.tgz#756641adb587851b5ccb3e095daf27ae581c8406"
   integrity sha512-zuVdFrMJiuCDQUMCzQaD6KL28MjnqqN8XnAqiEq9PNm/hCPTSGfrXCOfwj1ow4LFb/tNymJPwsNbVePc1xFqrQ==
 
-"@uppy/companion-client@^1.5.3":
-  version "1.5.3"
-  resolved "https://registry.yarnpkg.com/@uppy/companion-client/-/companion-client-1.5.3.tgz#bae47802494d3d91aa14f2bc88680cabba5edf41"
-  integrity sha512-VN1JssHZiOjleJcoTyubTvGua3R6P9ENkqKlCt9dPKabGn9diNQ4EZebZlAvUD5hz+zBuzvNyAwgC7xbqZlyMw==
-  dependencies:
-    "@uppy/utils" "^3.2.2"
-    namespace-emitter "^2.0.1"
-
-"@uppy/core@^1.10.4":
-  version "1.13.1"
-  resolved "https://registry.yarnpkg.com/@uppy/core/-/core-1.13.1.tgz#fcec53cac4b4e89c56beeade125b27df6a257c63"
-  integrity sha512-HaWHUGDgcjya0NljV6dvEkVjGm+/WtrUEw+Zo7JA3Ah3VfgIUS/f7/uX+INsw+I4++TzcKSxr9fjTf+IzXSwJA==
-  dependencies:
-    "@transloadit/prettier-bytes" "0.0.7"
-    "@uppy/store-default" "^1.2.3"
-    "@uppy/utils" "^3.2.2"
-    cuid "^2.1.1"
-    lodash.throttle "^4.1.1"
-    mime-match "^1.0.2"
-    namespace-emitter "^2.0.1"
-    preact "8.2.9"
-
-"@uppy/store-default@^1.2.3":
-  version "1.2.3"
-  resolved "https://registry.yarnpkg.com/@uppy/store-default/-/store-default-1.2.3.tgz#3274acf97c77f3d7d2c71bd7faefff17e2115527"
-  integrity sha512-9DFq4ccIqfy8mBOO5Mj52X26JsplY3hydSooM+64NKMZ9ccs6LpSm7j8WVbvvNFnSrd7SgP/53vFwo953KCKgg==
-
-"@uppy/tus@^1.5.12":
-  version "1.7.5"
-  resolved "https://registry.yarnpkg.com/@uppy/tus/-/tus-1.7.5.tgz#50fae77bc6e6f92b9bd57fe0a511ed75b907b3d3"
-  integrity sha512-aW8k8k5hUHL8SOq1tTvhoDWPXBsebaZ4dXDxeUSua1axjS1iA9F7C6RRlrVLxJgRPAPIJfW2zv3QtoJAbnhpFA==
-  dependencies:
-    "@uppy/companion-client" "^1.5.3"
-    "@uppy/utils" "^3.2.2"
-    tus-js-client "^2.1.1"
-
-"@uppy/utils@^3.2.2":
-  version "3.2.2"
-  resolved "https://registry.yarnpkg.com/@uppy/utils/-/utils-3.2.2.tgz#ea4b3f1473e52a700ceff47449ff804b5619700d"
-  integrity sha512-ze3NrG23MbYR29Oj6ik6iGZIpXxmhZK3VYwevfqJbzTknF/yh8BWLRWNyPoyOflNpsmQbxo/Y2hmqTnUC3wEPg==
-  dependencies:
-    abortcontroller-polyfill "^1.4.0"
-    lodash.throttle "^4.1.1"
-
 "@zkochan/cmd-shim@^3.1.0":
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/@zkochan/cmd-shim/-/cmd-shim-3.1.0.tgz#2ab8ed81f5bb5452a85f25758eb9b8681982fd2e"
@@ -2671,51 +2601,16 @@ abbrev@1:
   resolved "https://registry.yarnpkg.com/abbrev/-/abbrev-1.1.1.tgz#f8f2c887ad10bf67f634f005b6987fed3179aac8"
   integrity sha512-nne9/IiQ/hzIhY6pdDnbBtz7DjPTKrY00P/zvPSm5pOFkl6xuGrGnXn/VtTNNfNtAfZ9/1RtehkszU9qcTii0Q==
 
-abortcontroller-polyfill@^1.4.0:
-  version "1.5.0"
-  resolved "https://registry.yarnpkg.com/abortcontroller-polyfill/-/abortcontroller-polyfill-1.5.0.tgz#2c562f530869abbcf88d949a2b60d1d402e87a7c"
-  integrity sha512-O6Xk757Jb4o0LMzMOMdWvxpHWrQzruYBaUruFaIOfAQRnWFxfdXYobw12jrVHGtoXk6WiiyYzc0QWN9aL62HQA==
-
-accepts@~1.3.4:
-  version "1.3.7"
-  resolved "https://registry.yarnpkg.com/accepts/-/accepts-1.3.7.tgz#531bc726517a3b2b41f850021c6cc15eaab507cd"
-  integrity sha512-Il80Qs2WjYlJIBNzNkK6KYqlVMTbZLXgHx2oT0pU/fjRHyEp+PEfEPY0R3WCwAGVOtauxh1hOxNgIf5bv7dQpA==
-  dependencies:
-    mime-types "~2.1.24"
-    negotiator "0.6.2"
-
-acorn-jsx@^3.0.0:
-  version "3.0.1"
-  resolved "https://registry.yarnpkg.com/acorn-jsx/-/acorn-jsx-3.0.1.tgz#afdf9488fb1ecefc8348f6fb22f464e32a58b36b"
-  integrity sha1-r9+UiPsezvyDSPb7IvRk4ypYs2s=
-  dependencies:
-    acorn "^3.0.4"
-
 acorn-jsx@^5.3.2:
   version "5.3.2"
   resolved "https://registry.yarnpkg.com/acorn-jsx/-/acorn-jsx-5.3.2.tgz#7ed5bb55908b3b2f1bc55c6af1653bada7f07937"
   integrity sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==
 
-acorn@^3.0.4:
-  version "3.3.0"
-  resolved "https://registry.yarnpkg.com/acorn/-/acorn-3.3.0.tgz#45e37fb39e8da3f25baee3ff5369e2bb5f22017a"
-  integrity sha1-ReN/s56No/JbruP/U2niu18iAXo=
-
-acorn@^5.5.0:
-  version "5.7.4"
-  resolved "https://registry.yarnpkg.com/acorn/-/acorn-5.7.4.tgz#3e8d8a9947d0599a1796d10225d7432f4a4acf5e"
-  integrity sha512-1D++VG7BhrtvQpNbBzovKNc1FLGGEE/oGe7b9xJm/RFHMBeUaUGpluV9RLjZa47YFdPcDAenEYuq9pQPcMdLJg==
-
 acorn@^8.9.0:
   version "8.12.1"
   resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.12.1.tgz#71616bdccbe25e27a54439e0046e89ca76df2248"
   integrity sha512-tcpGyI9zbizT9JbV6oYE477V6mTlXvvi0T0G3SNIYE2apm/G5huBa1+K89VGeovbg+jycCrfhl3ADxErOuO6Jg==
 
-after@0.8.2:
-  version "0.8.2"
-  resolved "https://registry.yarnpkg.com/after/-/after-0.8.2.tgz#fedb394f9f0e02aa9768e702bda23b505fae7e1f"
-  integrity sha1-/ts5T58OAqqXaOcCvaI7UF+ufh8=
-
 agent-base@4, agent-base@^4.3.0:
   version "4.3.0"
   resolved "https://registry.yarnpkg.com/agent-base/-/agent-base-4.3.0.tgz#8165f01c436009bccad0b1d122f05ed770efc6ee"
@@ -2749,14 +2644,6 @@ agentkeepalive@^3.4.1:
   dependencies:
     humanize-ms "^1.2.1"
 
-aggregate-error@^3.0.0:
-  version "3.1.0"
-  resolved "https://registry.yarnpkg.com/aggregate-error/-/aggregate-error-3.1.0.tgz#92670ff50f5359bdb7a3e0d40d0ec30c5737687a"
-  integrity sha512-4I7Td01quW/RpocfNayFdFVk1qSuoh0E7JrbRJ16nH01HhKFQ88INq9Sd+nd72zqRySlr9BmDA8xlEJ6vJMrYA==
-  dependencies:
-    clean-stack "^2.0.0"
-    indent-string "^4.0.0"
-
 aggregate-error@^4.0.0:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/aggregate-error/-/aggregate-error-4.0.1.tgz#25091fe1573b9e0be892aeda15c7c66a545f758e"
@@ -2765,21 +2652,6 @@ aggregate-error@^4.0.0:
     clean-stack "^4.0.0"
     indent-string "^5.0.0"
 
-ajv-keywords@^2.1.0:
-  version "2.1.1"
-  resolved "https://registry.yarnpkg.com/ajv-keywords/-/ajv-keywords-2.1.1.tgz#617997fc5f60576894c435f940d819e135b80762"
-  integrity sha1-YXmX/F9gV2iUxDX5QNgZ4TW4B2I=
-
-ajv@^5.2.3, ajv@^5.3.0:
-  version "5.5.2"
-  resolved "https://registry.yarnpkg.com/ajv/-/ajv-5.5.2.tgz#73b5eeca3fab653e3d3f9422b341ad42205dc965"
-  integrity sha1-c7Xuyj+rZT49P5Qis0GtQiBdyWU=
-  dependencies:
-    co "^4.6.0"
-    fast-deep-equal "^1.0.0"
-    fast-json-stable-stringify "^2.0.0"
-    json-schema-traverse "^0.3.0"
-
 ajv@^6.12.3:
   version "6.12.4"
   resolved "https://registry.yarnpkg.com/ajv/-/ajv-6.12.4.tgz#0614facc4522127fa713445c6bfd3ebd376e2234"
@@ -2800,7 +2672,7 @@ ajv@^6.12.4:
     json-schema-traverse "^0.4.1"
     uri-js "^4.2.2"
 
-ansi-escapes@^3.0.0, ansi-escapes@^3.2.0:
+ansi-escapes@^3.2.0:
   version "3.2.0"
   resolved "https://registry.yarnpkg.com/ansi-escapes/-/ansi-escapes-3.2.0.tgz#8780b98ff9dbf5638152d1f1fe5c1d7b4442976b"
   integrity sha512-cBhpre4ma+U0T1oM5fXg7Dy1Jw7zzwv7lt/GoCpr+hDQJoYnKVPLL4dCvSEFMmQurOQvSrwT7SL/DAlhBI97RQ==
@@ -2837,11 +2709,6 @@ ansi-regex@^5.0.1:
   resolved "https://registry.yarnpkg.com/ansi-regex/-/ansi-regex-5.0.1.tgz#082cb2c89c9fe8659a311a53bd6a4dc5301db304"
   integrity sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==
 
-ansi-styles@^2.2.1:
-  version "2.2.1"
-  resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-2.2.1.tgz#b432dd3358b634cf75e1e4664368240533c1ddbe"
-  integrity sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=
-
 ansi-styles@^3.2.0, ansi-styles@^3.2.1:
   version "3.2.1"
   resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-3.2.1.tgz#41fbb20243e50b12be0f04b8dedbf07520ce841d"
@@ -2895,13 +2762,6 @@ anymatch@^3.0.3:
     normalize-path "^3.0.0"
     picomatch "^2.0.4"
 
-append-transform@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/append-transform/-/append-transform-2.0.0.tgz#99d9d29c7b38391e6f428d28ce136551f0b77e12"
-  integrity sha512-7yeyCEurROLQJFv5Xj4lEGTy0borxepjFv1g22oAdqFu//SrAlDl1O1Nxx15SH1RoliUml6p8dwJW9jvZughhg==
-  dependencies:
-    default-require-extensions "^3.0.0"
-
 aproba@^1.0.3, aproba@^1.1.1:
   version "1.2.0"
   resolved "https://registry.yarnpkg.com/aproba/-/aproba-1.2.0.tgz#6802e6264efd18c790a1b0d517f0f2627bf2c94a"
@@ -2912,11 +2772,6 @@ aproba@^2.0.0:
   resolved "https://registry.yarnpkg.com/aproba/-/aproba-2.0.0.tgz#52520b8ae5b569215b354efc0caa3fe1e45a8adc"
   integrity sha512-lYe4Gx7QT+MKGbDsA+Z+he/Wtef0BiwDOlK/XkBrdfsh9J/jPPXbX0tE9x9cl27Tmu5gg3QUbUrQYa/y+KOHPQ==
 
-archy@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/archy/-/archy-1.0.0.tgz#f9c8c13757cc1dd7bc379ac77b2c62a5c2868c40"
-  integrity sha1-+cjBN1fMHde8N5rHeyxipcKGjEA=
-
 are-we-there-yet@~1.1.2:
   version "1.1.5"
   resolved "https://registry.yarnpkg.com/are-we-there-yet/-/are-we-there-yet-1.1.5.tgz#4b35c2944f062a8bfcda66410760350fe9ddfc21"
@@ -2985,15 +2840,6 @@ array-ify@^1.0.0:
   resolved "https://registry.yarnpkg.com/array-ify/-/array-ify-1.0.0.tgz#9e528762b4a9066ad163a6962a364418e9626ece"
   integrity sha1-nlKHYrSpBmrRY6aWKjZEGOlibs4=
 
-array-includes@^3.1.1:
-  version "3.1.1"
-  resolved "https://registry.yarnpkg.com/array-includes/-/array-includes-3.1.1.tgz#cdd67e6852bdf9c1215460786732255ed2459348"
-  integrity sha512-c2VXaCHl7zPsvpkFsw4nxvFie4fh1ur9bpcgsVkIjqn0H/Xwdg+7fv3n2r/isyS8EBj5b06M9kHyZuIr4El6WQ==
-  dependencies:
-    define-properties "^1.1.3"
-    es-abstract "^1.17.0"
-    is-string "^1.0.5"
-
 array-includes@^3.1.7:
   version "3.1.8"
   resolved "https://registry.yarnpkg.com/array-includes/-/array-includes-3.1.8.tgz#5e370cbe172fdd5dd6530c1d4aadda25281ba97d"
@@ -3079,11 +2925,6 @@ arraybuffer.prototype.slice@^1.0.3:
     is-array-buffer "^3.0.4"
     is-shared-array-buffer "^1.0.2"
 
-arraybuffer.slice@~0.0.7:
-  version "0.0.7"
-  resolved "https://registry.yarnpkg.com/arraybuffer.slice/-/arraybuffer.slice-0.0.7.tgz#3bbc4275dd584cc1b10809b89d4e8b63a69e7675"
-  integrity sha512-wGUIVQXuehL5TCqQun8OW81jGzAWycqzFF8lFp+GOM5BXLYj3bKNsYC4daB7n6XjCqxQA/qgTJ+8ANR3acjrog==
-
 arrify@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/arrify/-/arrify-1.0.1.tgz#898508da2226f380df904728456849c1501a4b0d"
@@ -3111,26 +2952,11 @@ assert-plus@1.0.0, assert-plus@^1.0.0:
   resolved "https://registry.yarnpkg.com/assert-plus/-/assert-plus-1.0.0.tgz#f12e0f3c5d77b0b1cdd9146942e4e96c1e4dd525"
   integrity sha1-8S4PPF13sLHN2RRpQuTpbB5N1SU=
 
-assert@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/assert/-/assert-2.0.0.tgz#95fc1c616d48713510680f2eaf2d10dd22e02d32"
-  integrity sha512-se5Cd+js9dXJnu6Ag2JFc00t+HmHOen+8Q+L7O9zI0PqQXr20uk2J0XQqMxZEeo5U50o8Nvmmx7dZrl+Ufr35A==
-  dependencies:
-    es6-object-assign "^1.1.0"
-    is-nan "^1.2.1"
-    object-is "^1.0.1"
-    util "^0.12.0"
-
 assign-symbols@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/assign-symbols/-/assign-symbols-1.0.0.tgz#59667f41fadd4f20ccbc2bb96b8d4f7f78ec0367"
   integrity sha1-WWZ/QfrdTyDMvCu5a41Pf3jsA2c=
 
-async-limiter@~1.0.0:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/async-limiter/-/async-limiter-1.0.1.tgz#dd379e94f0db8310b08291f9d64c3209766617fd"
-  integrity sha512-csOlWGAcRFJaI6m+F2WKdnMKr4HhdhFVBk0H/QbJFMCr+uO2kwohwXQPxw/9OCxp05r5ghVBFSyioixx3gfkNQ==
-
 async-mutex@^0.3.1:
   version "0.3.2"
   resolved "https://registry.yarnpkg.com/async-mutex/-/async-mutex-0.3.2.tgz#1485eda5bda1b0ec7c8df1ac2e815757ad1831df"
@@ -3182,21 +3008,12 @@ aws4@^1.8.0:
   resolved "https://registry.yarnpkg.com/aws4/-/aws4-1.10.1.tgz#e1e82e4f3e999e2cfd61b161280d16a111f86428"
   integrity sha512-zg7Hz2k5lI8kb7U32998pRRFin7zJlkfezGJjUc2heaD4Pw2wObakCDVzkKztTm/Ln7eiVvYsjqak0Ed4LkMDA==
 
-axios@^0.21.1:
-  version "0.21.1"
-  resolved "https://registry.yarnpkg.com/axios/-/axios-0.21.1.tgz#22563481962f4d6bde9a76d516ef0e5d3c09b2b8"
-  integrity sha512-dKQiRHxGD9PPRIUNIWvZhPTPpl1rf/OxTYKsqKUDjBwYylTvV7SjSHJb9ratfyzM6wCdLCOYLzs73qpg5c4iGA==
-  dependencies:
-    follow-redirects "^1.10.0"
-
-babel-code-frame@^6.22.0:
-  version "6.26.0"
-  resolved "https://registry.yarnpkg.com/babel-code-frame/-/babel-code-frame-6.26.0.tgz#63fd43f7dc1e3bb7ce35947db8fe369a3f58c74b"
-  integrity sha1-Y/1D99weO7fONZR9uP42mj9Yx0s=
+axios@0.26.1:
+  version "0.26.1"
+  resolved "https://registry.yarnpkg.com/axios/-/axios-0.26.1.tgz#1ede41c51fcf51bbbd6fd43669caaa4f0495aaa9"
+  integrity sha512-fPwcX4EvnSHuInCMItEhAGnaSEXRBjtzh9fOtsE6E1G6p7vl7edEeZe11QHf18+6+9gR5PbKV/sGKNaD8YaMeA==
   dependencies:
-    chalk "^1.1.3"
-    esutils "^2.0.2"
-    js-tokens "^3.0.2"
+    follow-redirects "^1.14.8"
 
 babel-jest@^29.4.1:
   version "29.4.1"
@@ -3258,11 +3075,6 @@ babel-preset-jest@^29.4.0:
     babel-plugin-jest-hoist "^29.4.0"
     babel-preset-current-node-syntax "^1.0.0"
 
-backo2@1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/backo2/-/backo2-1.0.2.tgz#31ab1ac8b129363463e35b3ebb69f4dfcfba7947"
-  integrity sha1-MasayLEpNjRj41s+u2n038+6eUc=
-
 balanced-match@^1.0.0:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-1.0.2.tgz#e83e3a7e3f300b34cb9d87f615fa0cbf357690ee"
@@ -3275,21 +3087,6 @@ base-x@^3.0.2:
   dependencies:
     safe-buffer "^5.0.1"
 
-base64-arraybuffer@0.1.5:
-  version "0.1.5"
-  resolved "https://registry.yarnpkg.com/base64-arraybuffer/-/base64-arraybuffer-0.1.5.tgz#73926771923b5a19747ad666aa5cd4bf9c6e9ce8"
-  integrity sha1-c5JncZI7Whl0etZmqlzUv5xunOg=
-
-base64-js@^1.0.2:
-  version "1.3.1"
-  resolved "https://registry.yarnpkg.com/base64-js/-/base64-js-1.3.1.tgz#58ece8cb75dd07e71ed08c736abc5fac4dbf8df1"
-  integrity sha512-mLQ4i2QO1ytvGWFWmcngKO//JXAQueZvwEKtjgQFM4jIK0kU+ytMfplL8j+n5mspOfjHwoAg+9yhb7BwAHm36g==
-
-base64id@2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/base64id/-/base64id-2.0.0.tgz#2770ac6bc47d312af97a8bf9a634342e0cd25cb6"
-  integrity sha512-lGe34o6EHj9y3Kts9R4ZYs/Gr+6N7MCaMlIFA3F1R2O5/m7K06AxfSeO5530PEERE6/WyEg3lsuyw4GHlPZHog==
-
 base@^0.11.1:
   version "0.11.2"
   resolved "https://registry.yarnpkg.com/base/-/base-0.11.2.tgz#7bde5ced145b6d551a90db87f83c558b4eb48a8f"
@@ -3303,18 +3100,18 @@ base@^0.11.1:
     mixin-deep "^1.2.0"
     pascalcase "^0.1.1"
 
-bc-bip68@^1.0.5:
+bc-bip68@1.0.5:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/bc-bip68/-/bc-bip68-1.0.5.tgz#4d3774067d8c9e922e225f5f2c4178ee9ae8dc94"
   integrity sha512-GzaMlN7pNthrY5BhReVhnfr4Ixx+GUSfyNRHYh0QiMUF0d0+0YaD8MpEdv6AjFBksg/zlqL1fVCBBm6PpTt2Rg==
 
-bchaddrjs-slp@^0.2.5:
-  version "0.2.9"
-  resolved "https://registry.yarnpkg.com/bchaddrjs-slp/-/bchaddrjs-slp-0.2.9.tgz#fe1a90430a57f7d79b464a6b431557cb7cf74c94"
-  integrity sha512-+jWviCay+q8Kg73EpsKwHGipX3VBpyil4uGdLKEgj88sNqAM1fL7WZO0g+FbASF/n+TCYCPkBbM5TznRD1yHuA==
+bchaddrjs-slp@0.2.5:
+  version "0.2.5"
+  resolved "https://registry.yarnpkg.com/bchaddrjs-slp/-/bchaddrjs-slp-0.2.5.tgz#37ea030cb5a6801ef9fba1832cddf70a49fa05b1"
+  integrity sha512-33flmPcqMFswerKu7477DSUNMVMQR3tHDk3lvbmsdkEva+TxVGGWWE/p5Lqx9M/8t3vkbe7fzmVhj4QhChcCyA==
   dependencies:
     bs58check "^2.1.2"
-    cashaddrjs-slp "^0.2.12"
+    cashaddrjs-slp "^0.2.11"
 
 bcrypt-pbkdf@^1.0.0:
   version "1.0.2"
@@ -3323,7 +3120,7 @@ bcrypt-pbkdf@^1.0.0:
   dependencies:
     tweetnacl "^0.14.3"
 
-bech32@^1.1.2, bech32@^1.1.3:
+bech32@^1.1.2:
   version "1.1.4"
   resolved "https://registry.yarnpkg.com/bech32/-/bech32-1.1.4.tgz#e38c9f37bf179b8eb16ae3a772b40c356d4832e9"
   integrity sha512-s0IrSOzLlbvX7yp4WBfPITzpAU8sqQcpsmwXDiKwrG4r491vwCO/XpejasRNl0piBMe/DvP4Tz0mIS/X1DPJBQ==
@@ -3333,13 +3130,6 @@ before-after-hook@^2.0.0:
   resolved "https://registry.yarnpkg.com/before-after-hook/-/before-after-hook-2.1.0.tgz#b6c03487f44e24200dd30ca5e6a1979c5d2fb635"
   integrity sha512-IWIbu7pMqyw3EAJHzzHbWa85b6oud/yfKYg5rqB5hNE8CeMi3nX+2C2sj0HswfblST86hpVEOAb9x34NZd6P7A==
 
-better-assert@~1.0.0:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/better-assert/-/better-assert-1.0.2.tgz#40866b9e1b9e0b55b481894311e68faffaebc522"
-  integrity sha1-QIZrnhueC1W0gYlDEeaPr/rrxSI=
-  dependencies:
-    callsite "1.0.0"
-
 big-integer@1.6.36:
   version "1.6.36"
   resolved "https://registry.yarnpkg.com/big-integer/-/big-integer-1.6.36.tgz#78631076265d4ae3555c04f85e7d9d2f3a071a36"
@@ -3355,24 +3145,24 @@ big.js@^3.1.3:
   resolved "https://registry.yarnpkg.com/big.js/-/big.js-3.2.0.tgz#a5fc298b81b9e0dca2e458824784b65c52ba588e"
   integrity sha512-+hN/Zh2D08Mx65pZ/4g5bsmNiZUuChDiQfTUQ7qJr4/kuopCr88xZsAXv6mBoZEsUI4OuGHlX59qE94K2mMW8Q==
 
-bigi@^1.1.0, bigi@^1.2.0, bigi@^1.4.0, bigi@^1.4.2:
+bigi@1.4.2, bigi@^1.1.0, bigi@^1.2.0, bigi@^1.4.0:
   version "1.4.2"
   resolved "https://registry.yarnpkg.com/bigi/-/bigi-1.4.2.tgz#9c665a95f88b8b08fc05cfd731f561859d725825"
-  integrity sha1-nGZalfiLiwj8Bc/XMfVhhZ1yWCU=
+  integrity sha512-ddkU+dFIuEIW8lE7ZwdIAf2UPoM90eaprg5m3YXAVVTmKlqV/9BX4A2M8BOK2yOq6/VgZFVhK6QAxJebhlbhzw==
 
-bignumber.js@^9.0.0:
+bignumber.js@9.0.0, bignumber.js@^9.0.0:
   version "9.0.0"
   resolved "https://registry.yarnpkg.com/bignumber.js/-/bignumber.js-9.0.0.tgz#805880f84a329b5eac6e7cb6f8274b6d82bdf075"
   integrity sha512-t/OYhhJ2SD+YGBQcjY8GzzDHEk9f3nerxjtfa6tlMXfe7frs/WozhvCNoGvpM0P3bNf3Gq5ZRMlGr5f3r4/N8A==
 
-bindings@^1.2.1, bindings@^1.5.0:
+bindings@^1.5.0:
   version "1.5.0"
   resolved "https://registry.yarnpkg.com/bindings/-/bindings-1.5.0.tgz#10353c9e945334bc0511a6d90b38fbc7c9c504df"
   integrity sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==
   dependencies:
     file-uri-to-path "1.0.0"
 
-bip-schnorr@^0.3.0:
+bip-schnorr@0.3.0:
   version "0.3.0"
   resolved "https://registry.yarnpkg.com/bip-schnorr/-/bip-schnorr-0.3.0.tgz#e6490379603704e9dd123d874b41755aea4f352c"
   integrity sha512-Sc1Hn2+1n+okPEW8G+JLjeaM12dsUOwr+oFlMDSKR9wYwNGMw0alskeBIHTmXxBxMZSWKhCW7PwKQVDyGmnaVg==
@@ -3382,10 +3172,10 @@ bip-schnorr@^0.3.0:
     random-bytes "^1.0.0"
     safe-buffer "^5.0.1"
 
-bip38@^2.0.2:
-  version "2.0.3"
-  resolved "https://registry.yarnpkg.com/bip38/-/bip38-2.0.3.tgz#12e48749d6c28dd14e8bcb37a9f2dae67a797da0"
-  integrity sha512-HiABhYNhhRNAAeGmkt3LS2El6oonIftNkHq6uFxHCjaCIEbHr7I6RIBhKMQWw5AhGzIPpO5Mt7I8bFOfKqqh9w==
+bip38@2.0.2:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/bip38/-/bip38-2.0.2.tgz#6f7762bc90b0bdf63b489ff95349354aecf9baee"
+  integrity sha512-22KDak0RDyghFbR0Si7wyq9IgY423YzGYzWLpGeofH3DaolOQqjD3mNN08eFoubKlbyclOQKFwtONMv2SD9V3A==
   dependencies:
     bigi "^1.2.0"
     browserify-aes "^1.0.1"
@@ -3395,7 +3185,7 @@ bip38@^2.0.2:
     ecurve "^1.0.0"
     scryptsy "^2.0.0"
 
-bip39@^3.0.2:
+bip39@3.0.2:
   version "3.0.2"
   resolved "https://registry.yarnpkg.com/bip39/-/bip39-3.0.2.tgz#2baf42ff3071fc9ddd5103de92e8f80d9257ee32"
   integrity sha512-J4E1r2N0tUylTKt07ibXvhpT2c5pyAFgvuA5q1H9uDy6dEGpjV8jmymh3MTYJDLCNbIVClSB9FbND49I6N24MQ==
@@ -3405,30 +3195,24 @@ bip39@^3.0.2:
     pbkdf2 "^3.0.9"
     randombytes "^2.0.1"
 
-bip66@^1.1.0, bip66@^1.1.5:
+bip66@1.1.5, bip66@^1.1.0, bip66@^1.1.5:
   version "1.1.5"
   resolved "https://registry.yarnpkg.com/bip66/-/bip66-1.1.5.tgz#01fa8748785ca70955d5011217d1b3139969ca22"
   integrity sha1-AfqHSHhcpwlV1QESF9GzE5lpyiI=
   dependencies:
     safe-buffer "^5.0.1"
 
-bitcoinjs-message@^2.0.0:
-  version "2.1.1"
-  resolved "https://registry.yarnpkg.com/bitcoinjs-message/-/bitcoinjs-message-2.1.1.tgz#c55d78f4461691b77fa5f9341216f8cd7ae0d0f4"
-  integrity sha512-aOXdP3a8ol0uTY32KDCiI2cEn1Cy4iUWx6jHjClENsKbBLdY5q9JkeebAemWNrWOmYOT2+oEWn8cDjmxE0M6mA==
+bitcoinjs-message@2.0.0:
+  version "2.0.0"
+  resolved "https://registry.yarnpkg.com/bitcoinjs-message/-/bitcoinjs-message-2.0.0.tgz#e285d223607dabf2b33a6ee486a223b59d1b1548"
+  integrity sha512-H5pJC7/eSqVjREiEOZ4jifX+7zXYP3Y28GIOIqg9hrgE7Vj8Eva9+HnVqnxwA1rJPOwZKuw0vo6k0UxgVc6q1A==
   dependencies:
-    bech32 "^1.1.3"
-    bs58check "^2.1.2"
+    bs58check "^2.0.2"
     buffer-equals "^1.0.3"
     create-hash "^1.1.2"
     secp256k1 "^3.0.1"
     varuint-bitcoin "^1.0.1"
 
-blob@0.0.5:
-  version "0.0.5"
-  resolved "https://registry.yarnpkg.com/blob/-/blob-0.0.5.tgz#d680eeef25f8cd91ad533f5b01eed48e64caf683"
-  integrity sha512-gaqbzQPqOoamawKg0LGVd7SzLgXS+JH61oWprSLH+P+abTczqJbhTR8CmJ2u9/bUYNmHTGJx/UEmn6doAvvuig==
-
 bluebird@^3.5.1, bluebird@^3.5.3, bluebird@^3.5.5:
   version "3.7.2"
   resolved "https://registry.yarnpkg.com/bluebird/-/bluebird-3.7.2.tgz#9f229c15be272454ffa973ace0dbee79a1b0c36f"
@@ -3511,14 +3295,14 @@ browserslist@^4.21.3:
     node-releases "^2.0.8"
     update-browserslist-db "^1.0.10"
 
-bs58@^4.0.0, bs58@^4.0.1:
+bs58@4.0.1, bs58@^4.0.0:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/bs58/-/bs58-4.0.1.tgz#be161e76c354f6f788ae4071f63f34e8c4f0a42a"
   integrity sha1-vhYedsNU9veIrkBx9j806MTwpCo=
   dependencies:
     base-x "^3.0.2"
 
-bs58check@<3.0.0, bs58check@^2.0.0, bs58check@^2.1.2:
+bs58check@<3.0.0, bs58check@^2.0.0, bs58check@^2.0.2, bs58check@^2.1.2:
   version "2.1.2"
   resolved "https://registry.yarnpkg.com/bs58check/-/bs58check-2.1.2.tgz#53b018291228d82a5aa08e7d796fdafda54aebfc"
   integrity sha512-0TS1jicxdU09dwJMNZtVAfzPi6Q6QeN0pM1Fkzrjn+XYHvzMKPU3pHVpva+769iNVSfIYWf7LJ6WR+BuuMf8cA==
@@ -3539,35 +3323,12 @@ btoa-lite@^1.0.0:
   resolved "https://registry.yarnpkg.com/btoa-lite/-/btoa-lite-1.0.0.tgz#337766da15801210fdd956c22e9c6891ab9d0337"
   integrity sha1-M3dm2hWAEhD92VbCLpxokaudAzc=
 
-buffer-alloc-unsafe@^1.1.0:
-  version "1.1.0"
-  resolved "https://registry.yarnpkg.com/buffer-alloc-unsafe/-/buffer-alloc-unsafe-1.1.0.tgz#bd7dc26ae2972d0eda253be061dba992349c19f0"
-  integrity sha512-TEM2iMIEQdJ2yjPJoSIsldnleVaAk1oW3DBVUykyOLsEsFmEc9kn+SFFPz+gl54KQNxlDnAwCXosOS9Okx2xAg==
-
-buffer-alloc@^1.2.0:
-  version "1.2.0"
-  resolved "https://registry.yarnpkg.com/buffer-alloc/-/buffer-alloc-1.2.0.tgz#890dd90d923a873e08e10e5fd51a57e5b7cce0ec"
-  integrity sha512-CFsHQgjtW1UChdXgbyJGtnm+O/uLQeZdtbDo8mfUgYXCHSM1wgrVxXm6bSyrUuErEb+4sYVGCzASBRot7zyrow==
-  dependencies:
-    buffer-alloc-unsafe "^1.1.0"
-    buffer-fill "^1.0.0"
-
 buffer-equals@^1.0.3:
   version "1.0.4"
   resolved "https://registry.yarnpkg.com/buffer-equals/-/buffer-equals-1.0.4.tgz#0353b54fd07fd9564170671ae6f66b9cf10d27f5"
   integrity sha1-A1O1T9B/2VZBcGca5vZrnPENJ/U=
 
-buffer-fill@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/buffer-fill/-/buffer-fill-1.0.0.tgz#f8f78b76789888ef39f205cd637f68e702122b2c"
-  integrity sha1-+PeLdniYiO858gXNY39o5wISKyw=
-
-buffer-from@^0.1.1:
-  version "0.1.2"
-  resolved "https://registry.yarnpkg.com/buffer-from/-/buffer-from-0.1.2.tgz#15f4b9bcef012044df31142c14333caf6e0260d0"
-  integrity sha512-RiWIenusJsmI2KcvqQABB83tLxCByE3upSP8QU3rJDMVFGPWLvPQJt/O1Su9moRWeH7d+Q2HYb68f6+v+tw2vg==
-
-buffer-from@^1.0.0, buffer-from@^1.1.1:
+buffer-from@^1.0.0:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/buffer-from/-/buffer-from-1.1.1.tgz#32713bc028f75c02fdb710d7c7bcec1f2c6070ef"
   integrity sha512-MQcXEUbCKtEo7bhqEs6560Hyd4XaovZlO/k9V3hjVUF/zwW7KBVdSK4gIt/bzwS9MbR5qob+F5jusZsb0YQK2A==
@@ -3577,19 +3338,6 @@ buffer-xor@^1.0.2, buffer-xor@^1.0.3:
   resolved "https://registry.yarnpkg.com/buffer-xor/-/buffer-xor-1.0.3.tgz#26e61ed1422fb70dd42e6e36729ed51d855fe8d9"
   integrity sha1-JuYe0UIvtw3ULm42cp7VHYVf6Nk=
 
-buffer@^5.1.0, buffer@^5.4.3:
-  version "5.6.0"
-  resolved "https://registry.yarnpkg.com/buffer/-/buffer-5.6.0.tgz#a31749dc7d81d84db08abf937b6b8c4033f62786"
-  integrity sha512-/gDYp/UtU0eA1ys8bOs9J6a+E/KWIY+DZ+Q2WESNUA0jFRsJOc0SNUO6xJ5SGA1xueg3NL65W6s+NY5l9cunuw==
-  dependencies:
-    base64-js "^1.0.2"
-    ieee754 "^1.1.4"
-
-builtin-modules@^1.1.1:
-  version "1.1.1"
-  resolved "https://registry.yarnpkg.com/builtin-modules/-/builtin-modules-1.1.1.tgz#270f076c5a72c02f5b65a47df94c5fe3a278892f"
-  integrity sha1-Jw8HbFpywC9bZaR9+Uxf46J4iS8=
-
 builtins@^1.0.3:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/builtins/-/builtins-1.0.3.tgz#cb94faeb61c8696451db36534e1422f94f0aee88"
@@ -3641,16 +3389,6 @@ cache-base@^1.0.1:
     union-value "^1.0.0"
     unset-value "^1.0.0"
 
-caching-transform@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.yarnpkg.com/caching-transform/-/caching-transform-4.0.0.tgz#00d297a4206d71e2163c39eaffa8157ac0651f0f"
-  integrity sha512-kpqOvwXnjjN44D89K5ccQC+RUrsy7jB/XLlRrx0D7/2HNcTPqzsb6XgYoErwko6QsV184CA2YgS1fxDiiDZMWA==
-  dependencies:
-    hasha "^5.0.0"
-    make-dir "^3.0.0"
-    package-hash "^4.0.0"
-    write-file-atomic "^3.0.0"
-
 call-bind@^1.0.0, call-bind@^1.0.2, call-bind@^1.0.5, call-bind@^1.0.6, call-bind@^1.0.7:
   version "1.0.7"
   resolved "https://registry.yarnpkg.com/call-bind/-/call-bind-1.0.7.tgz#06016599c40c56498c18769d2730be242b6fa3b9"
@@ -3674,13 +3412,6 @@ caller-callsite@^2.0.0:
   dependencies:
     callsites "^2.0.0"
 
-caller-path@^0.1.0:
-  version "0.1.0"
-  resolved "https://registry.yarnpkg.com/caller-path/-/caller-path-0.1.0.tgz#94085ef63581ecd3daa92444a8fe94e82577751f"
-  integrity sha1-lAhe9jWB7NPaqSREqP6U6CV3dR8=
-  dependencies:
-    callsites "^0.2.0"
-
 caller-path@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/caller-path/-/caller-path-2.0.0.tgz#468f83044e369ab2010fac5f06ceee15bb2cb1f4"
@@ -3688,16 +3419,6 @@ caller-path@^2.0.0:
   dependencies:
     caller-callsite "^2.0.0"
 
-callsite@1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/callsite/-/callsite-1.0.0.tgz#280398e5d664bd74038b6f0905153e6e8af1bc20"
-  integrity sha1-KAOY5dZkvXQDi28JBRU+borxvCA=
-
-callsites@^0.2.0:
-  version "0.2.0"
-  resolved "https://registry.yarnpkg.com/callsites/-/callsites-0.2.0.tgz#afab96262910a7f33c19a5775825c69f34e350ca"
-  integrity sha1-r6uWJikQp/M8GaV3WCXGnzTjUMo=
-
 callsites@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/callsites/-/callsites-2.0.0.tgz#06eb84f00eea413da86affefacbffb36093b3c50"
@@ -3781,32 +3502,14 @@ caseless@~0.12.0:
   resolved "https://registry.yarnpkg.com/caseless/-/caseless-0.12.0.tgz#1b681c21ff84033c826543090689420d187151dc"
   integrity sha1-G2gcIf+EAzyCZUMJBolCDRhxUdw=
 
-cashaddrjs-slp@^0.2.12:
+cashaddrjs-slp@^0.2.11:
   version "0.2.12"
   resolved "https://registry.yarnpkg.com/cashaddrjs-slp/-/cashaddrjs-slp-0.2.12.tgz#30eda56cfc3ad4a949911258a0356459f45879d4"
   integrity sha512-n2TTIuW6vZZxYvjvsUAA+wOM0Zkj+3RRKUtDC1XSu4Ic4XVr0yFJkl1bzQkHWda7nkVT51sxjZneygz7D0SyrQ==
   dependencies:
     big-integer "^1.6.34"
 
-cashaddrjs@^0.3.3:
-  version "0.3.12"
-  resolved "https://registry.yarnpkg.com/cashaddrjs/-/cashaddrjs-0.3.12.tgz#73089588113459741e854aa842db1f7816d8428d"
-  integrity sha512-GdjCYMVwd86HXcFcxyEZQLPLFv8a/u0ccYPsO0PpnUW26LhZzHX9l9QA+DjaeUah7tnebwPs33NWDbbUy8iVYQ==
-  dependencies:
-    big-integer "1.6.36"
-
-chalk@^1.1.3:
-  version "1.1.3"
-  resolved "https://registry.yarnpkg.com/chalk/-/chalk-1.1.3.tgz#a8115c55e4a702fe4d150abd3872822a7e09fc98"
-  integrity sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=
-  dependencies:
-    ansi-styles "^2.2.1"
-    escape-string-regexp "^1.0.2"
-    has-ansi "^2.0.0"
-    strip-ansi "^3.0.0"
-    supports-color "^2.0.0"
-
-chalk@^2.0.0, chalk@^2.1.0, chalk@^2.3.0, chalk@^2.3.1, chalk@^2.4.2:
+chalk@^2.0.0, chalk@^2.3.1, chalk@^2.4.2:
   version "2.4.2"
   resolved "https://registry.yarnpkg.com/chalk/-/chalk-2.4.2.tgz#cd42541677a54333cf541a49108c1432b44c9424"
   integrity sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==
@@ -3836,11 +3539,6 @@ char-regex@^1.0.2:
   resolved "https://registry.yarnpkg.com/char-regex/-/char-regex-1.0.2.tgz#d744358226217f981ed58f479b1d6bcc29545dcf"
   integrity sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==
 
-chardet@^0.4.0:
-  version "0.4.2"
-  resolved "https://registry.yarnpkg.com/chardet/-/chardet-0.4.2.tgz#b5473b33dc97c424e5d98dc87d55d4d8a29c8bf2"
-  integrity sha1-tUc7M9yXxCTl2Y3IfVXU2KKci/I=
-
 chardet@^0.7.0:
   version "0.7.0"
   resolved "https://registry.yarnpkg.com/chardet/-/chardet-0.7.0.tgz#90094849f0937f2eedc2425d0d28a9e5f0cbad9e"
@@ -3869,11 +3567,6 @@ cipher-base@^1.0.0, cipher-base@^1.0.1, cipher-base@^1.0.3:
     inherits "^2.0.1"
     safe-buffer "^5.0.1"
 
-circular-json@^0.3.1:
-  version "0.3.3"
-  resolved "https://registry.yarnpkg.com/circular-json/-/circular-json-0.3.3.tgz#815c99ea84f6809529d2f45791bdf82711352d66"
-  integrity sha512-UZK3NBx2Mca+b5LsG7bY183pHWt5Y1xts4P3Pz7ENTwGVnJOUWbRb3ocjvX7hx9tq/yTAdclXm9sZ38gNuem4A==
-
 cjs-module-lexer@^1.0.0:
   version "1.2.2"
   resolved "https://registry.yarnpkg.com/cjs-module-lexer/-/cjs-module-lexer-1.2.2.tgz#9f84ba3244a512f3a54e5277e8eef4c489864e40"
@@ -3889,11 +3582,6 @@ class-utils@^0.3.5:
     isobject "^3.0.0"
     static-extend "^0.1.1"
 
-clean-stack@^2.0.0:
-  version "2.2.0"
-  resolved "https://registry.yarnpkg.com/clean-stack/-/clean-stack-2.2.0.tgz#ee8472dbb129e727b31e8a10a427dee9dfe4008b"
-  integrity sha512-4diC9HaTE+KRAMWhDhrGOECgWZxoevMc5TlkObMqNSsVU62PYzXZ/SMTjzyGAFF1YusgxGcSWTEXBhp0CPwQ1A==
-
 clean-stack@^4.0.0:
   version "4.2.0"
   resolved "https://registry.yarnpkg.com/clean-stack/-/clean-stack-4.2.0.tgz#c464e4cde4ac789f4e0735c5d75beb49d7b30b31"
@@ -3901,11 +3589,6 @@ clean-stack@^4.0.0:
   dependencies:
     escape-string-regexp "5.0.0"
 
-clear@0.1.0:
-  version "0.1.0"
-  resolved "https://registry.yarnpkg.com/clear/-/clear-0.1.0.tgz#b81b1e03437a716984fd7ac97c87d73bdfe7048a"
-  integrity sha512-qMjRnoL+JDPJHeLePZJuao6+8orzHMGP04A8CdwCNsKhRbOnKRjefxONR7bwILT3MHecxKBjHkKL/tkZ8r4Uzw==
-
 cli-cursor@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/cli-cursor/-/cli-cursor-2.1.0.tgz#b35dac376479facc3e94747d41d0d0f5238ffcb5"
@@ -3927,15 +3610,6 @@ cliui@^5.0.0:
     strip-ansi "^5.2.0"
     wrap-ansi "^5.1.0"
 
-cliui@^6.0.0:
-  version "6.0.0"
-  resolved "https://registry.yarnpkg.com/cliui/-/cliui-6.0.0.tgz#511d702c0c4e41ca156d7d0e96021f23e13225b1"
-  integrity sha512-t6wbgtoCXvAzst7QgXxJYqPt0usEfbgQdftEPbLL/cvv6HPE5VgvqCuAIDR0NgU52ds6rFwqrgakNLrHEjCbrQ==
-  dependencies:
-    string-width "^4.2.0"
-    strip-ansi "^6.0.0"
-    wrap-ansi "^6.2.0"
-
 cliui@^8.0.1:
   version "8.0.1"
   resolved "https://registry.yarnpkg.com/cliui/-/cliui-8.0.1.tgz#0c04b075db02cbfe60dc8e6cf2f5486b1a3608aa"
@@ -4025,14 +3699,6 @@ columnify@^1.5.4:
     strip-ansi "^3.0.0"
     wcwidth "^1.0.0"
 
-combine-errors@^3.0.3:
-  version "3.0.3"
-  resolved "https://registry.yarnpkg.com/combine-errors/-/combine-errors-3.0.3.tgz#f4df6740083e5703a3181110c2b10551f003da86"
-  integrity sha1-9N9nQAg+VwOjGBEQwrEFUfAD2oY=
-  dependencies:
-    custom-error-instance "2.1.1"
-    lodash.uniqby "4.5.0"
-
 combined-stream@^1.0.6, combined-stream@~1.0.6:
   version "1.0.8"
   resolved "https://registry.yarnpkg.com/combined-stream/-/combined-stream-1.0.8.tgz#c3d45a8b34fd730631a110a8a2520682b31d5a7f"
@@ -4040,11 +3706,6 @@ combined-stream@^1.0.6, combined-stream@~1.0.6:
   dependencies:
     delayed-stream "~1.0.0"
 
-commander@^3.0.0:
-  version "3.0.2"
-  resolved "https://registry.yarnpkg.com/commander/-/commander-3.0.2.tgz#6837c3fb677ad9933d1cfba42dd14d5117d6b39e"
-  integrity sha512-Gar0ASD4BDyKC4hl4DwHqDrmvjoxWKZigVnAbn5H1owvm4CxCPdb0HQDehwNYMJpla5+M2tPmPARzhtYuwpHow==
-
 commander@^7.0.0, commander@^7.1.0:
   version "7.1.0"
   resolved "https://registry.yarnpkg.com/commander/-/commander-7.1.0.tgz#f2eaecf131f10e36e07d894698226e36ae0eb5ff"
@@ -4061,11 +3722,6 @@ comment-json@^4.1.0:
     has-own-prop "^2.0.0"
     repeat-string "^1.6.1"
 
-commondir@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/commondir/-/commondir-1.0.1.tgz#ddd800da0c66127393cca5950ea968a3aaf1253b"
-  integrity sha1-3dgA2gxmEnOTzKWVDqloo6rxJTs=
-
 compare-func@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/compare-func/-/compare-func-2.0.0.tgz#fb65e75edbddfd2e568554e8b5b05fff7a51fcb3"
@@ -4074,32 +3730,17 @@ compare-func@^2.0.0:
     array-ify "^1.0.0"
     dot-prop "^5.1.0"
 
-component-bind@1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/component-bind/-/component-bind-1.0.0.tgz#00c608ab7dcd93897c0009651b1d3a8e1e73bbd1"
-  integrity sha1-AMYIq33Nk4l8AAllGx06jh5zu9E=
-
-component-emitter@1.2.1:
-  version "1.2.1"
-  resolved "https://registry.yarnpkg.com/component-emitter/-/component-emitter-1.2.1.tgz#137918d6d78283f7df7a6b7c5a63e140e69425e6"
-  integrity sha1-E3kY1teCg/ffemt8WmPhQOaUJeY=
-
-component-emitter@^1.2.1, component-emitter@~1.3.0:
+component-emitter@^1.2.1:
   version "1.3.0"
   resolved "https://registry.yarnpkg.com/component-emitter/-/component-emitter-1.3.0.tgz#16e4070fba8ae29b679f2215853ee181ab2eabc0"
   integrity sha512-Rd3se6QB+sO1TwqZjscQrurpEPIfO0/yYnSin6Q/rD3mOutHvUrCAhJub3r90uNb+SESBuE0QYoB90YdfatsRg==
 
-component-inherit@0.0.3:
-  version "0.0.3"
-  resolved "https://registry.yarnpkg.com/component-inherit/-/component-inherit-0.0.3.tgz#645fc4adf58b72b649d5cae65135619db26ff143"
-  integrity sha1-ZF/ErfWLcrZJ1crmUTVhnbJv8UM=
-
 concat-map@0.0.1:
   version "0.0.1"
   resolved "https://registry.yarnpkg.com/concat-map/-/concat-map-0.0.1.tgz#d8a96bd77fd68df7793a73036a3ba0d5405d477b"
   integrity sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==
 
-concat-stream@^1.5.0, concat-stream@^1.6.0:
+concat-stream@^1.5.0:
   version "1.6.2"
   resolved "https://registry.yarnpkg.com/concat-stream/-/concat-stream-1.6.2.tgz#904bdf194cd3122fc675c77fc4ac3d4ff0fd1a34"
   integrity sha512-27HBghJxjiZtIk3Ycvn/4kbJk/1uZuJFfuPEns6LaEvpvG1f0hTea8lilrouyo9mVc2GWdcEZ8OLoGmSADlrCw==
@@ -4149,11 +3790,6 @@ console-control-strings@^1.0.0, console-control-strings@~1.1.0:
   resolved "https://registry.yarnpkg.com/console-control-strings/-/console-control-strings-1.1.0.tgz#3d7cf4464db6446ea644bf4b39507f9851008e8e"
   integrity sha1-PXz0Rk22RG6mRL9LOVB/mFEAjo4=
 
-contains-path@^0.1.0:
-  version "0.1.0"
-  resolved "https://registry.yarnpkg.com/contains-path/-/contains-path-0.1.0.tgz#fe8cf184ff6670b6baef01a9d4861a5cbec4120a"
-  integrity sha1-/ozxhP9mcLa67wGp1IYaXL7EEgo=
-
 conventional-changelog-angular@^5.0.3:
   version "5.0.11"
   resolved "https://registry.yarnpkg.com/conventional-changelog-angular/-/conventional-changelog-angular-5.0.11.tgz#99a3ca16e4a5305e0c2c2fae3ef74fd7631fc3fb"
@@ -4254,11 +3890,6 @@ convert-source-map@^2.0.0:
   resolved "https://registry.yarnpkg.com/convert-source-map/-/convert-source-map-2.0.0.tgz#4b560f649fc4e918dd0ab75cf4961e8bc882d82a"
   integrity sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==
 
-cookie@0.3.1:
-  version "0.3.1"
-  resolved "https://registry.yarnpkg.com/cookie/-/cookie-0.3.1.tgz#e7e0a1f9ef43b4c8ba925c5c5a96e806d16873bb"
-  integrity sha1-5+Ch+e9DtMi6klxcWpboBtFoc7s=
-
 copy-concurrently@^1.0.0:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/copy-concurrently/-/copy-concurrently-1.0.5.tgz#92297398cae34937fcafd6ec8139c18051f0b5e0"
@@ -4302,16 +3933,6 @@ cosmiconfig@^7.0.0:
     path-type "^4.0.0"
     yaml "^1.10.0"
 
-cp-file@^7.0.0:
-  version "7.0.0"
-  resolved "https://registry.yarnpkg.com/cp-file/-/cp-file-7.0.0.tgz#b9454cfd07fe3b974ab9ea0e5f29655791a9b8cd"
-  integrity sha512-0Cbj7gyvFVApzpK/uhCtQ/9kE9UnYpxMzaq5nQQC/Dh4iaj5fxp7iEFIullrYwzj8nf0qnsI1Qsx34hAeAebvw==
-  dependencies:
-    graceful-fs "^4.1.2"
-    make-dir "^3.0.0"
-    nested-error-stacks "^2.0.0"
-    p-event "^4.1.0"
-
 cp-file@^9.1.0:
   version "9.1.0"
   resolved "https://registry.yarnpkg.com/cp-file/-/cp-file-9.1.0.tgz#e98e30db72d57d47b5b1d444deb70d05e5684921"
@@ -4367,15 +3988,6 @@ create-hmac@^1.1.3, create-hmac@^1.1.4:
     safe-buffer "^5.0.1"
     sha.js "^2.4.8"
 
-cross-spawn@^5.1.0:
-  version "5.1.0"
-  resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-5.1.0.tgz#e8bd0efee58fcff6f8f94510a0a554bbfa235449"
-  integrity sha1-6L0O/uWPz/b4+UUQoKVUu/ojVEk=
-  dependencies:
-    lru-cache "^4.0.1"
-    shebang-command "^1.2.0"
-    which "^1.2.9"
-
 cross-spawn@^6.0.0:
   version "6.0.5"
   resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-6.0.5.tgz#4a5ec7c64dfae22c3a14124dbacdee846d80cbc4"
@@ -4387,7 +3999,7 @@ cross-spawn@^6.0.0:
     shebang-command "^1.2.0"
     which "^1.2.9"
 
-cross-spawn@^7.0.0, cross-spawn@^7.0.2, cross-spawn@^7.0.3:
+cross-spawn@^7.0.2, cross-spawn@^7.0.3:
   version "7.0.3"
   resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.3.tgz#f73a85b9d5d41d045551c177e2882d4ac85728a6"
   integrity sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==
@@ -4459,11 +4071,6 @@ cspell@^5.2.4:
     minimatch "^3.0.4"
     strip-ansi "^6.0.0"
 
-cuid@^2.1.1:
-  version "2.1.8"
-  resolved "https://registry.yarnpkg.com/cuid/-/cuid-2.1.8.tgz#cbb88f954171e0d5747606c0139fb65c5101eac0"
-  integrity sha512-xiEMER6E7TlTPnDxrM4eRiC6TRgjNX9xzEZ5U/Se2YJKr7Mq4pJn/2XEHjl3STcSh96GmkHPcBXLES8M29wyyg==
-
 currently-unhandled@^0.4.1:
   version "0.4.1"
   resolved "https://registry.yarnpkg.com/currently-unhandled/-/currently-unhandled-0.4.1.tgz#988df33feab191ef799a61369dd76c17adf957ea"
@@ -4471,11 +4078,6 @@ currently-unhandled@^0.4.1:
   dependencies:
     array-find-index "^1.0.1"
 
-custom-error-instance@2.1.1:
-  version "2.1.1"
-  resolved "https://registry.yarnpkg.com/custom-error-instance/-/custom-error-instance-2.1.1.tgz#3cf6391487a6629a6247eb0ca0ce00081b7e361a"
-  integrity sha1-PPY5FIemYppiR+sMoM4ACBt+Nho=
-
 cyclist@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/cyclist/-/cyclist-1.0.1.tgz#596e9698fd0c80e12038c2b82d6eb1b35b6224d9"
@@ -4527,26 +4129,21 @@ dateformat@^3.0.0:
   resolved "https://registry.yarnpkg.com/dateformat/-/dateformat-3.0.3.tgz#a6e37499a4d9a9cf85ef5872044d62901c9889ae"
   integrity sha512-jyCETtSl3VMZMWeRo7iY1FL19ges1t55hMo5yaam4Jrsm5EPL89UQkoQRyiI+Yf4k8r2ZpdngkV8hr1lIdjb3Q==
 
-debug-log@^1.0.0:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/debug-log/-/debug-log-1.0.1.tgz#2307632d4c04382b8df8a32f70b895046d52745f"
-  integrity sha1-IwdjLUwEOCuN+KMvcLiVBG1SdF8=
-
-debug@3.1.0, debug@~3.1.0:
+debug@3.1.0:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/debug/-/debug-3.1.0.tgz#5bb5a0672628b64149566ba16819e61518c67261"
   integrity sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==
   dependencies:
     ms "2.0.0"
 
-debug@4, debug@^4.1.0, debug@~4.1.0:
+debug@4, debug@^4.1.0:
   version "4.1.1"
   resolved "https://registry.yarnpkg.com/debug/-/debug-4.1.1.tgz#3b72260255109c6b589cee050f1d516139664791"
   integrity sha512-pYAIzeRo8J6KPEaJ0VWOh5Pzkbw/RetuzehGM7QRRX5he4fPHx2rdKMB256ehJCkX+XRQm16eZLqLNS8RSZXZw==
   dependencies:
     ms "^2.1.1"
 
-debug@^2.2.0, debug@^2.3.3, debug@^2.6.8, debug@^2.6.9:
+debug@^2.2.0, debug@^2.3.3:
   version "2.6.9"
   resolved "https://registry.yarnpkg.com/debug/-/debug-2.6.9.tgz#5d128515df134ff327e90a4c93f4e077a536341f"
   integrity sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==
@@ -4632,23 +4229,11 @@ deep-is@^0.1.3:
   resolved "https://registry.yarnpkg.com/deep-is/-/deep-is-0.1.4.tgz#a6f2dce612fadd2ef1f519b73551f17e85199831"
   integrity sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==
 
-deep-is@~0.1.3:
-  version "0.1.3"
-  resolved "https://registry.yarnpkg.com/deep-is/-/deep-is-0.1.3.tgz#b369d6fb5dbc13eecf524f91b070feedc357cf34"
-  integrity sha1-s2nW+128E+7PUk+RsHD+7cNXzzQ=
-
 deepmerge@^4.2.2:
   version "4.2.2"
   resolved "https://registry.yarnpkg.com/deepmerge/-/deepmerge-4.2.2.tgz#44d2ea3679b8f4d4ffba33f03d865fc1e7bf4955"
   integrity sha512-FJ3UgI4gIl+PHZm53knsuSFpE+nESMr7M4v9QcgB7S63Kj/6WqMiFQJpBBYz1Pt+66bZpP3Q7Lye0Oo9MPKEdg==
 
-default-require-extensions@^3.0.0:
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/default-require-extensions/-/default-require-extensions-3.0.0.tgz#e03f93aac9b2b6443fc52e5e4a37b3ad9ad8df96"
-  integrity sha512-ek6DpXq/SCpvjhpFsLFRVtIxJCRw6fUR42lYMVZuUMK7n8eMz4Uh5clckdBjEpLhn/gEBZo7hDJnJcwdKLKQjg==
-  dependencies:
-    strip-bom "^4.0.0"
-
 defaults@^1.0.3:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/defaults/-/defaults-1.0.3.tgz#c656051e9817d9ff08ed881477f3fe4019f3ef7d"
@@ -4708,18 +4293,6 @@ defined@^1.0.0:
   resolved "https://registry.yarnpkg.com/defined/-/defined-1.0.0.tgz#c98d9bcef75674188e110969151199e39b1fa693"
   integrity sha1-yY2bzvdWdBiOEQlpFRGZ45sfppM=
 
-deglob@^2.1.0:
-  version "2.1.1"
-  resolved "https://registry.yarnpkg.com/deglob/-/deglob-2.1.1.tgz#d268e168727799862e8eac07042e165957c1f3be"
-  integrity sha512-2kjwuGGonL7gWE1XU4Fv79+vVzpoQCl0V+boMwWtOQJV2AGDabCwez++nB1Nli/8BabAfZQ/UuHPlp6AymKdWw==
-  dependencies:
-    find-root "^1.0.0"
-    glob "^7.0.5"
-    ignore "^3.0.9"
-    pkg-config "^1.1.0"
-    run-parallel "^1.1.2"
-    uniq "^1.0.1"
-
 delay@^5.0.0:
   version "5.0.0"
   resolved "https://registry.yarnpkg.com/delay/-/delay-5.0.0.tgz#137045ef1b96e5071060dd5be60bf9334436bd1d"
@@ -4768,11 +4341,6 @@ diff-sequences@^29.6.3:
   resolved "https://registry.yarnpkg.com/diff-sequences/-/diff-sequences-29.6.3.tgz#4deaf894d11407c51efc8418012f9e70b84ea921"
   integrity sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==
 
-dijkstrajs@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/dijkstrajs/-/dijkstrajs-1.0.1.tgz#d3cd81221e3ea40742cfcde556d4e99e98ddc71b"
-  integrity sha1-082BIh4+pAdCz83lVtTpnpjdxxs=
-
 dir-glob@^2.2.2:
   version "2.2.2"
   resolved "https://registry.yarnpkg.com/dir-glob/-/dir-glob-2.2.2.tgz#fa09f0694153c8918b18ba0deafae94769fc50c4"
@@ -4787,15 +4355,7 @@ dir-glob@^3.0.1:
   dependencies:
     path-type "^4.0.0"
 
-doctrine@1.5.0:
-  version "1.5.0"
-  resolved "https://registry.yarnpkg.com/doctrine/-/doctrine-1.5.0.tgz#379dce730f6166f76cefa4e6707a159b02c5a6fa"
-  integrity sha1-N53Ocw9hZvds76TmcHoVmwLFpvo=
-  dependencies:
-    esutils "^2.0.2"
-    isarray "^1.0.0"
-
-doctrine@^2.0.2, doctrine@^2.1.0:
+doctrine@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/doctrine/-/doctrine-2.1.0.tgz#5cd01fc101621b42c4cd7f5d1a66243716d3f39d"
   integrity sha512-35mSku4ZXK0vfCuHEDAwt55dg2jNajHZ1odvF+8SSr82EsZY4QmXfuWso8oEd8zRhVObSN18aM0CjSdoBX7zIw==
@@ -4861,6 +4421,13 @@ duplexify@^3.4.2, duplexify@^3.6.0:
     readable-stream "^2.0.0"
     stream-shift "^1.0.0"
 
+ecashaddrjs@1.0.7:
+  version "1.0.7"
+  resolved "https://registry.yarnpkg.com/ecashaddrjs/-/ecashaddrjs-1.0.7.tgz#22dc0842d0c3e186f9f160ca55299b679ab17d8a"
+  integrity sha512-KsvHYLlYtLr/GBkEPiwwQDIDBzqRx61qC34n1puHKOjVE4Uwg3syHccjFCqNynLa6T6xI0Rd7ByCRUJcuJcoIw==
+  dependencies:
+    big-integer "1.6.36"
+
 ecc-jsbn@~0.1.1:
   version "0.1.2"
   resolved "https://registry.yarnpkg.com/ecc-jsbn/-/ecc-jsbn-0.1.2.tgz#3a83a904e54353287874c564b7549386849a98c9"
@@ -4935,46 +4502,6 @@ end-of-stream@^1.0.0, end-of-stream@^1.1.0:
   dependencies:
     once "^1.4.0"
 
-engine.io-client@~3.4.0:
-  version "3.4.3"
-  resolved "https://registry.yarnpkg.com/engine.io-client/-/engine.io-client-3.4.3.tgz#192d09865403e3097e3575ebfeb3861c4d01a66c"
-  integrity sha512-0NGY+9hioejTEJCaSJZfWZLk4FPI9dN+1H1C4+wj2iuFba47UgZbJzfWs4aNFajnX/qAaYKbe2lLTfEEWzCmcw==
-  dependencies:
-    component-emitter "~1.3.0"
-    component-inherit "0.0.3"
-    debug "~4.1.0"
-    engine.io-parser "~2.2.0"
-    has-cors "1.1.0"
-    indexof "0.0.1"
-    parseqs "0.0.5"
-    parseuri "0.0.5"
-    ws "~6.1.0"
-    xmlhttprequest-ssl "~1.5.4"
-    yeast "0.1.2"
-
-engine.io-parser@~2.2.0:
-  version "2.2.0"
-  resolved "https://registry.yarnpkg.com/engine.io-parser/-/engine.io-parser-2.2.0.tgz#312c4894f57d52a02b420868da7b5c1c84af80ed"
-  integrity sha512-6I3qD9iUxotsC5HEMuuGsKA0cXerGz+4uGcXQEkfBidgKf0amsjrrtwcbwK/nzpZBxclXlV7gGl9dgWvu4LF6w==
-  dependencies:
-    after "0.8.2"
-    arraybuffer.slice "~0.0.7"
-    base64-arraybuffer "0.1.5"
-    blob "0.0.5"
-    has-binary2 "~1.0.2"
-
-engine.io@~3.4.0:
-  version "3.4.2"
-  resolved "https://registry.yarnpkg.com/engine.io/-/engine.io-3.4.2.tgz#8fc84ee00388e3e228645e0a7d3dfaeed5bd122c"
-  integrity sha512-b4Q85dFkGw+TqgytGPrGgACRUhsdKc9S9ErRAXpPGy/CXKs4tYoHDkvIRdsseAF7NjfVwjRFIn6KTnbw7LwJZg==
-  dependencies:
-    accepts "~1.3.4"
-    base64id "2.0.0"
-    cookie "0.3.1"
-    debug "~4.1.0"
-    engine.io-parser "~2.2.0"
-    ws "^7.1.2"
-
 env-paths@^2.2.0:
   version "2.2.0"
   resolved "https://registry.yarnpkg.com/env-paths/-/env-paths-2.2.0.tgz#cdca557dc009152917d6166e2febe1f039685e43"
@@ -4997,7 +4524,7 @@ error-ex@^1.2.0, error-ex@^1.3.1:
   dependencies:
     is-arrayish "^0.2.1"
 
-es-abstract@^1.17.0, es-abstract@^1.17.0-next.1, es-abstract@^1.17.4, es-abstract@^1.17.5:
+es-abstract@^1.17.0-next.1, es-abstract@^1.17.4, es-abstract@^1.17.5:
   version "1.17.6"
   resolved "https://registry.yarnpkg.com/es-abstract/-/es-abstract-1.17.6.tgz#9142071707857b2cacc7b89ecb670316c3e2d52a"
   integrity sha512-Fr89bON3WFyUi5EvAeI48QTWX0AyekGgLA8H+c+7fbfCkJwRWRMLd8CQedNEyJuoYYhmtEqY92pgte1FAhBlhw==
@@ -5141,16 +4668,6 @@ es-to-primitive@^1.2.1:
     is-date-object "^1.0.1"
     is-symbol "^1.0.2"
 
-es6-error@^4.0.1:
-  version "4.1.1"
-  resolved "https://registry.yarnpkg.com/es6-error/-/es6-error-4.1.1.tgz#9e3af407459deed47e9a91f9b885a84eb05c561d"
-  integrity sha512-Um/+FxMr9CISWh0bi5Zv0iOD+4cFh5qLeks1qhAopKVAJw3drgKbKySikp7wGhDL0HPeaja0P5ULZrxLkniUVg==
-
-es6-object-assign@^1.1.0:
-  version "1.1.0"
-  resolved "https://registry.yarnpkg.com/es6-object-assign/-/es6-object-assign-1.1.0.tgz#c2c3582656247c39ea107cb1e6652b6f9f24523c"
-  integrity sha1-wsNYJlYkfDnqEHyx5mUrb58kUjw=
-
 es6-promise@^4.0.3:
   version "4.2.8"
   resolved "https://registry.yarnpkg.com/es6-promise/-/es6-promise-4.2.8.tgz#4eb21594c972bc40553d276e510539143db53e0a"
@@ -5203,7 +4720,7 @@ escape-string-regexp@5.0.0:
   resolved "https://registry.yarnpkg.com/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz#4683126b500b61762f2dbebace1806e8be31b1c8"
   integrity sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==
 
-escape-string-regexp@^1.0.2, escape-string-regexp@^1.0.5:
+escape-string-regexp@^1.0.5:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz#1b61c0562190a8dff6ae3bb2cf0200ca130b86d4"
   integrity sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=
@@ -5235,24 +4752,6 @@ eslint-config-airbnb-typescript@^18.0.0:
   dependencies:
     eslint-config-airbnb-base "^15.0.0"
 
-eslint-config-standard-jsx@5.0.0:
-  version "5.0.0"
-  resolved "https://registry.yarnpkg.com/eslint-config-standard-jsx/-/eslint-config-standard-jsx-5.0.0.tgz#4abfac554f38668e0078c664569e7b2384e5d2aa"
-  integrity sha512-rLToPAEqLMPBfWnYTu6xRhm2OWziS2n40QFqJ8jAM8NSVzeVKTa3nclhsU4DpPJQRY60F34Oo1wi/71PN/eITg==
-
-eslint-config-standard@11.0.0:
-  version "11.0.0"
-  resolved "https://registry.yarnpkg.com/eslint-config-standard/-/eslint-config-standard-11.0.0.tgz#87ee0d3c9d95382dc761958cbb23da9eea31e0ba"
-  integrity sha512-oDdENzpViEe5fwuRCWla7AXQd++/oyIp8zP+iP9jiUPG6NBj3SHgdgtl/kTn00AjeN+1HNvavTKmYbMo+xMOlw==
-
-eslint-import-resolver-node@^0.3.1:
-  version "0.3.4"
-  resolved "https://registry.yarnpkg.com/eslint-import-resolver-node/-/eslint-import-resolver-node-0.3.4.tgz#85ffa81942c25012d8231096ddf679c03042c717"
-  integrity sha512-ogtf+5AB/O+nM6DIeBUNr2fuT7ot9Qg/1harBfBtaP13ekEWFQEEMP94BCB7zaNW3gyY+8SHYF00rnqYwXKWOA==
-  dependencies:
-    debug "^2.6.9"
-    resolve "^1.13.1"
-
 eslint-import-resolver-node@^0.3.9:
   version "0.3.9"
   resolved "https://registry.yarnpkg.com/eslint-import-resolver-node/-/eslint-import-resolver-node-0.3.9.tgz#d4eaac52b8a2e7c3cd1903eb00f7e053356118ac"
@@ -5262,14 +4761,6 @@ eslint-import-resolver-node@^0.3.9:
     is-core-module "^2.13.0"
     resolve "^1.22.4"
 
-eslint-module-utils@^2.1.1:
-  version "2.6.0"
-  resolved "https://registry.yarnpkg.com/eslint-module-utils/-/eslint-module-utils-2.6.0.tgz#579ebd094f56af7797d19c9866c9c9486629bfa6"
-  integrity sha512-6j9xxegbqe8/kZY8cYpcp0xhbK0EgJlg3g9mib3/miLaExuuwc3n5UEfSnU6hWMbT0FAYVvDbL9RrRgpUeQIvA==
-  dependencies:
-    debug "^2.6.9"
-    pkg-dir "^2.0.0"
-
 eslint-module-utils@^2.8.0:
   version "2.8.1"
   resolved "https://registry.yarnpkg.com/eslint-module-utils/-/eslint-module-utils-2.8.1.tgz#52f2404300c3bd33deece9d7372fb337cc1d7c34"
@@ -5300,60 +4791,6 @@ eslint-plugin-import@^2.29.1:
     semver "^6.3.1"
     tsconfig-paths "^3.15.0"
 
-eslint-plugin-import@~2.9.0:
-  version "2.9.0"
-  resolved "https://registry.yarnpkg.com/eslint-plugin-import/-/eslint-plugin-import-2.9.0.tgz#26002efbfca5989b7288ac047508bd24f217b169"
-  integrity sha1-JgAu+/ylmJtyiKwEdQi9JPIXsWk=
-  dependencies:
-    builtin-modules "^1.1.1"
-    contains-path "^0.1.0"
-    debug "^2.6.8"
-    doctrine "1.5.0"
-    eslint-import-resolver-node "^0.3.1"
-    eslint-module-utils "^2.1.1"
-    has "^1.0.1"
-    lodash "^4.17.4"
-    minimatch "^3.0.3"
-    read-pkg-up "^2.0.0"
-
-eslint-plugin-node@~6.0.0:
-  version "6.0.1"
-  resolved "https://registry.yarnpkg.com/eslint-plugin-node/-/eslint-plugin-node-6.0.1.tgz#bf19642298064379315d7a4b2a75937376fa05e4"
-  integrity sha512-Q/Cc2sW1OAISDS+Ji6lZS2KV4b7ueA/WydVWd1BECTQwVvfQy5JAi3glhINoKzoMnfnuRgNP+ZWKrGAbp3QDxw==
-  dependencies:
-    ignore "^3.3.6"
-    minimatch "^3.0.4"
-    resolve "^1.3.3"
-    semver "^5.4.1"
-
-eslint-plugin-promise@~3.7.0:
-  version "3.7.0"
-  resolved "https://registry.yarnpkg.com/eslint-plugin-promise/-/eslint-plugin-promise-3.7.0.tgz#f4bde5c2c77cdd69557a8f69a24d1ad3cfc9e67e"
-  integrity sha512-2WO+ZFh7vxUKRfR0cOIMrWgYKdR6S1AlOezw6pC52B6oYpd5WFghN+QHxvrRdZMtbo8h3dfUZ2o1rWb0UPbKtg==
-
-eslint-plugin-react@~7.7.0:
-  version "7.7.0"
-  resolved "https://registry.yarnpkg.com/eslint-plugin-react/-/eslint-plugin-react-7.7.0.tgz#f606c719dbd8a1a2b3d25c16299813878cca0160"
-  integrity sha512-KC7Snr4YsWZD5flu6A5c0AcIZidzW3Exbqp7OT67OaD2AppJtlBr/GuPrW/vaQM/yfZotEvKAdrxrO+v8vwYJA==
-  dependencies:
-    doctrine "^2.0.2"
-    has "^1.0.1"
-    jsx-ast-utils "^2.0.1"
-    prop-types "^15.6.0"
-
-eslint-plugin-standard@~3.0.1:
-  version "3.0.1"
-  resolved "https://registry.yarnpkg.com/eslint-plugin-standard/-/eslint-plugin-standard-3.0.1.tgz#34d0c915b45edc6f010393c7eef3823b08565cf2"
-  integrity sha1-NNDJFbRe3G8BA5PH7vOCOwhWXPI=
-
-eslint-scope@^3.7.1:
-  version "3.7.3"
-  resolved "https://registry.yarnpkg.com/eslint-scope/-/eslint-scope-3.7.3.tgz#bb507200d3d17f60247636160b4826284b108535"
-  integrity sha512-W+B0SvF4gamyCTmUc+uITPY0989iXVfKvhwtmJocTaYoc/3khEHmEmvfY/Gn9HA9VV75jrQECsHizkNw1b68FA==
-  dependencies:
-    esrecurse "^4.1.0"
-    estraverse "^4.1.1"
-
 eslint-scope@^7.2.2:
   version "7.2.2"
   resolved "https://registry.yarnpkg.com/eslint-scope/-/eslint-scope-7.2.2.tgz#deb4f92563390f32006894af62a22dba1c46423f"
@@ -5362,11 +4799,6 @@ eslint-scope@^7.2.2:
     esrecurse "^4.3.0"
     estraverse "^5.2.0"
 
-eslint-visitor-keys@^1.0.0:
-  version "1.3.0"
-  resolved "https://registry.yarnpkg.com/eslint-visitor-keys/-/eslint-visitor-keys-1.3.0.tgz#30ebd1ef7c2fdff01c3a4f151044af25fab0523e"
-  integrity sha512-6J72N8UNa462wa/KFODt/PJ3IU60SDpC3QXC1Hjc1BXXpfL2C9R5+AU7jhe0F6GREqVMh4Juu+NY7xn+6dipUQ==
-
 eslint-visitor-keys@^3.3.0, eslint-visitor-keys@^3.4.1, eslint-visitor-keys@^3.4.3:
   version "3.4.3"
   resolved "https://registry.yarnpkg.com/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz#0cd72fe8550e3c2eae156a96a4dddcd1c8ac5800"
@@ -5460,57 +4892,6 @@ eslint@^8.56.0:
     strip-ansi "^6.0.1"
     text-table "^0.2.0"
 
-eslint@~4.18.0:
-  version "4.18.2"
-  resolved "https://registry.yarnpkg.com/eslint/-/eslint-4.18.2.tgz#0f81267ad1012e7d2051e186a9004cc2267b8d45"
-  integrity sha512-qy4i3wODqKMYfz9LUI8N2qYDkHkoieTbiHpMrYUI/WbjhXJQr7lI4VngixTgaG+yHX+NBCv7nW4hA0ShbvaNKw==
-  dependencies:
-    ajv "^5.3.0"
-    babel-code-frame "^6.22.0"
-    chalk "^2.1.0"
-    concat-stream "^1.6.0"
-    cross-spawn "^5.1.0"
-    debug "^3.1.0"
-    doctrine "^2.1.0"
-    eslint-scope "^3.7.1"
-    eslint-visitor-keys "^1.0.0"
-    espree "^3.5.2"
-    esquery "^1.0.0"
-    esutils "^2.0.2"
-    file-entry-cache "^2.0.0"
-    functional-red-black-tree "^1.0.1"
-    glob "^7.1.2"
-    globals "^11.0.1"
-    ignore "^3.3.3"
-    imurmurhash "^0.1.4"
-    inquirer "^3.0.6"
-    is-resolvable "^1.0.0"
-    js-yaml "^3.9.1"
-    json-stable-stringify-without-jsonify "^1.0.1"
-    levn "^0.3.0"
-    lodash "^4.17.4"
-    minimatch "^3.0.2"
-    mkdirp "^0.5.1"
-    natural-compare "^1.4.0"
-    optionator "^0.8.2"
-    path-is-inside "^1.0.2"
-    pluralize "^7.0.0"
-    progress "^2.0.0"
-    require-uncached "^1.0.3"
-    semver "^5.3.0"
-    strip-ansi "^4.0.0"
-    strip-json-comments "~2.0.1"
-    table "4.0.2"
-    text-table "~0.2.0"
-
-espree@^3.5.2:
-  version "3.5.4"
-  resolved "https://registry.yarnpkg.com/espree/-/espree-3.5.4.tgz#b0f447187c8a8bed944b815a660bddf5deb5d1a7"
-  integrity sha512-yAcIQxtmMiB/jL32dzEp2enBeidsB7xWPLNiw3IIkpVds1P+h7qF9YwJq1yUNzp2OKXgAprs4F61ih66UsoD1A==
-  dependencies:
-    acorn "^5.5.0"
-    acorn-jsx "^3.0.0"
-
 espree@^9.6.0, espree@^9.6.1:
   version "9.6.1"
   resolved "https://registry.yarnpkg.com/espree/-/espree-9.6.1.tgz#a2a17b8e434690a5432f2f8018ce71d331a48c6f"
@@ -5525,13 +4906,6 @@ esprima@^4.0.0, esprima@^4.0.1:
   resolved "https://registry.yarnpkg.com/esprima/-/esprima-4.0.1.tgz#13b04cdb3e6c5d19df91ab6987a8695619b0aa71"
   integrity sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==
 
-esquery@^1.0.0:
-  version "1.3.1"
-  resolved "https://registry.yarnpkg.com/esquery/-/esquery-1.3.1.tgz#b78b5828aa8e214e29fb74c4d5b752e1c033da57"
-  integrity sha512-olpvt9QG0vniUBZspVRN6lwB7hOZoTRtT+jzR+tS4ffYx2mzbw+z0XCOk44aaLYKApNX5nMm+E+P6o25ip/DHQ==
-  dependencies:
-    estraverse "^5.1.0"
-
 esquery@^1.4.2:
   version "1.6.0"
   resolved "https://registry.yarnpkg.com/esquery/-/esquery-1.6.0.tgz#91419234f804d852a82dceec3e16cdc22cf9dae7"
@@ -5539,13 +4913,6 @@ esquery@^1.4.2:
   dependencies:
     estraverse "^5.1.0"
 
-esrecurse@^4.1.0:
-  version "4.2.1"
-  resolved "https://registry.yarnpkg.com/esrecurse/-/esrecurse-4.2.1.tgz#007a3b9fdbc2b3bb87e4879ea19c92fdbd3942cf"
-  integrity sha512-64RBB++fIOAXPw3P9cy89qfMlvZEXZkqqJkjqqXIvzP5ezRZjW+lPWjw35UX/3EhUPFYbg5ER4JYgDw4007/DQ==
-  dependencies:
-    estraverse "^4.1.0"
-
 esrecurse@^4.3.0:
   version "4.3.0"
   resolved "https://registry.yarnpkg.com/esrecurse/-/esrecurse-4.3.0.tgz#7ad7964d679abb28bee72cec63758b1c5d2c9921"
@@ -5553,11 +4920,6 @@ esrecurse@^4.3.0:
   dependencies:
     estraverse "^5.2.0"
 
-estraverse@^4.1.0, estraverse@^4.1.1:
-  version "4.3.0"
-  resolved "https://registry.yarnpkg.com/estraverse/-/estraverse-4.3.0.tgz#398ad3f3c5a24948be7725e83d11a7de28cdbd1d"
-  integrity sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==
-
 estraverse@^5.1.0, estraverse@^5.2.0:
   version "5.3.0"
   resolved "https://registry.yarnpkg.com/estraverse/-/estraverse-5.3.0.tgz#2eea5290702f26ab8fe5370370ff86c965d21123"
@@ -5674,15 +5036,6 @@ extend@~3.0.2:
   resolved "https://registry.yarnpkg.com/extend/-/extend-3.0.2.tgz#f8b1136b4071fbd8eb140aff858b1019ec2915fa"
   integrity sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==
 
-external-editor@^2.0.4:
-  version "2.2.0"
-  resolved "https://registry.yarnpkg.com/external-editor/-/external-editor-2.2.0.tgz#045511cfd8d133f3846673d1047c154e214ad3d5"
-  integrity sha512-bSn6gvGxKt+b7+6TKEv1ZycHleA7aHhRHyAqJyp5pbUFuYYNIzpZnQDk7AsYckyWdEnTeAnay0aCy2aV6iTk9A==
-  dependencies:
-    chardet "^0.4.0"
-    iconv-lite "^0.4.17"
-    tmp "^0.0.33"
-
 external-editor@^3.0.3:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/external-editor/-/external-editor-3.1.0.tgz#cb03f740befae03ea4d283caed2741a83f335495"
@@ -5716,11 +5069,6 @@ extsprintf@^1.2.0:
   resolved "https://registry.yarnpkg.com/extsprintf/-/extsprintf-1.4.0.tgz#e2689f8f356fad62cca65a3a91c5df5f9551692f"
   integrity sha1-4mifjzVvrWLMplo6kcXfX5VRaS8=
 
-fast-deep-equal@^1.0.0:
-  version "1.1.0"
-  resolved "https://registry.yarnpkg.com/fast-deep-equal/-/fast-deep-equal-1.1.0.tgz#c053477817c86b51daa853c81e059b733d023614"
-  integrity sha1-wFNHeBfIa1HaqFPIHgWbcz0CNhQ=
-
 fast-deep-equal@^3.1.1, fast-deep-equal@^3.1.3:
   version "3.1.3"
   resolved "https://registry.yarnpkg.com/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz#3a7d56b559d6cbc3eb512325244e619a65c6c525"
@@ -5765,7 +5113,7 @@ fast-json-stable-stringify@^2.0.0, fast-json-stable-stringify@^2.1.0:
   resolved "https://registry.yarnpkg.com/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz#874bf69c6f404c2b5d99c481341399fd55892633"
   integrity sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==
 
-fast-levenshtein@^2.0.6, fast-levenshtein@~2.0.6:
+fast-levenshtein@^2.0.6:
   version "2.0.6"
   resolved "https://registry.yarnpkg.com/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz#3d8a5c66883a16a30ca8643e851f19baa7797917"
   integrity sha1-PYpcZog6FqMMqGQ+hR8Zuqd5eRc=
@@ -5789,11 +5137,6 @@ figgy-pudding@^3.4.1, figgy-pudding@^3.5.1:
   resolved "https://registry.yarnpkg.com/figgy-pudding/-/figgy-pudding-3.5.2.tgz#b4eee8148abb01dcf1d1ac34367d59e12fa61d6e"
   integrity sha512-0btnI/H8f2pavGMN8w40mlSKOfTK2SVJmBfBeVIj3kNw0swwgzyRq0d5TJVOwodFmtvpPeWPN/MCcfuWF0Ezbw==
 
-figlet@^1.2.0:
-  version "1.5.0"
-  resolved "https://registry.yarnpkg.com/figlet/-/figlet-1.5.0.tgz#2db4d00a584e5155a96080632db919213c3e003c"
-  integrity sha512-ZQJM4aifMpz6H19AW1VqvZ7l4pOE9p7i/3LyxgO2kp+PO/VcDYNqIHEMtkccqIhTXMKci4kjueJr/iCQEaT/Ww==
-
 figures@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/figures/-/figures-2.0.0.tgz#3ab1a2d2a62c8bfb431a0c94cb797a2fce27c962"
@@ -5801,14 +5144,6 @@ figures@^2.0.0:
   dependencies:
     escape-string-regexp "^1.0.5"
 
-file-entry-cache@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/file-entry-cache/-/file-entry-cache-2.0.0.tgz#c392990c3e684783d838b8c84a45d8a048458361"
-  integrity sha1-w5KZDD5oR4PYOLjISkXYoEhFg2E=
-  dependencies:
-    flat-cache "^1.2.1"
-    object-assign "^4.0.1"
-
 file-entry-cache@^6.0.1:
   version "6.0.1"
   resolved "https://registry.yarnpkg.com/file-entry-cache/-/file-entry-cache-6.0.1.tgz#211b2dd9659cb0394b073e7323ac3c933d522027"
@@ -5838,20 +5173,6 @@ fill-range@^7.0.1, fill-range@^7.1.1:
   dependencies:
     to-regex-range "^5.0.1"
 
-find-cache-dir@^3.2.0:
-  version "3.3.1"
-  resolved "https://registry.yarnpkg.com/find-cache-dir/-/find-cache-dir-3.3.1.tgz#89b33fad4a4670daa94f855f7fbe31d6d84fe880"
-  integrity sha512-t2GDMt3oGC/v+BMwzmllWDuJF/xcDtE5j/fCGbqDD7OLuJkj0cfh1YSA5VKPvwMeLFLNDBkwOKZ2X85jGLVftQ==
-  dependencies:
-    commondir "^1.0.1"
-    make-dir "^3.0.2"
-    pkg-dir "^4.1.0"
-
-find-root@^1.0.0:
-  version "1.1.0"
-  resolved "https://registry.yarnpkg.com/find-root/-/find-root-1.1.0.tgz#abcfc8ba76f708c42a97b3d685b7e9450bfb9ce4"
-  integrity sha512-NKfW6bec6GfKc0SGx1e07QZY9PE99u0Bft/0rzSD5k3sO/vwkVUpDUKVm5Gpp5Ue3YfShPFTX2070tDs5kB9Ng==
-
 find-up@^1.0.0:
   version "1.1.2"
   resolved "https://registry.yarnpkg.com/find-up/-/find-up-1.1.2.tgz#6b2e9822b1a2ce0a60ab64d610eccad53cb24d0f"
@@ -5860,7 +5181,7 @@ find-up@^1.0.0:
     path-exists "^2.0.0"
     pinkie-promise "^2.0.0"
 
-find-up@^2.0.0, find-up@^2.1.0:
+find-up@^2.0.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/find-up/-/find-up-2.1.0.tgz#45d1b7e506c717ddd482775a2b77920a3c0c57a7"
   integrity sha1-RdG35QbHF93UgndaK3eSCjwMV6c=
@@ -5890,16 +5211,6 @@ find-up@^5.0.0:
     locate-path "^6.0.0"
     path-exists "^4.0.0"
 
-flat-cache@^1.2.1:
-  version "1.3.4"
-  resolved "https://registry.yarnpkg.com/flat-cache/-/flat-cache-1.3.4.tgz#2c2ef77525cc2929007dfffa1dd314aa9c9dee6f"
-  integrity sha512-VwyB3Lkgacfik2vhqR4uv2rvebqmDvFu4jlN/C1RzWoJEo8I7z4Q404oiqYCkq41mni8EzQnm95emU9seckwtg==
-  dependencies:
-    circular-json "^0.3.1"
-    graceful-fs "^4.1.2"
-    rimraf "~2.6.2"
-    write "^0.2.1"
-
 flat-cache@^3.0.4:
   version "3.2.0"
   resolved "https://registry.yarnpkg.com/flat-cache/-/flat-cache-3.2.0.tgz#2c0c2d5040c99b1632771a9d105725c0115363ee"
@@ -5922,10 +5233,10 @@ flush-write-stream@^1.0.0:
     inherits "^2.0.3"
     readable-stream "^2.3.6"
 
-follow-redirects@^1.10.0:
-  version "1.13.2"
-  resolved "https://registry.yarnpkg.com/follow-redirects/-/follow-redirects-1.13.2.tgz#dd73c8effc12728ba5cf4259d760ea5fb83e3147"
-  integrity sha512-6mPTgLxYm3r6Bkkg0vNM0HTjfGrOEtsfbhagQvbxDEsEkpNhw582upBaoRZylzen6krEmxXJgt9Ju6HiI4O7BA==
+follow-redirects@^1.14.8:
+  version "1.15.9"
+  resolved "https://registry.yarnpkg.com/follow-redirects/-/follow-redirects-1.15.9.tgz#a604fa10e443bf98ca94228d9eebcc2e8a2c8ee1"
+  integrity sha512-gew4GsXizNgdoRyqmyfMHyAmXsZDk6mHkSxZFCzW9gwlbtOW44CDtYavM+y+72qD/Vq2l550kMF52DT8fOLJqQ==
 
 for-each@^0.3.3:
   version "0.3.3"
@@ -5944,14 +5255,6 @@ foreach@^2.0.5:
   resolved "https://registry.yarnpkg.com/foreach/-/foreach-2.0.5.tgz#0bee005018aeb260d0a3af3ae658dd0136ec1b99"
   integrity sha1-C+4AUBiusmDQo6865ljdATbsG5k=
 
-foreground-child@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/foreground-child/-/foreground-child-2.0.0.tgz#71b32800c9f15aa8f2f83f4a6bd9bff35d861a53"
-  integrity sha512-dCIq9FpEcyQyXKCkyzmlPTFNgrCzPudOe+mhvJU5zAtlBnGVy2yKxtfsxK2tQBThwq225jcvBjpw1Gr40uzZCA==
-  dependencies:
-    cross-spawn "^7.0.0"
-    signal-exit "^3.0.2"
-
 forever-agent@~0.6.1:
   version "0.6.1"
   resolved "https://registry.yarnpkg.com/forever-agent/-/forever-agent-0.6.1.tgz#fbc71f0c41adeb37f96c577ad1ed42d8fdacca91"
@@ -5981,11 +5284,6 @@ from2@^2.1.0:
     inherits "^2.0.1"
     readable-stream "^2.0.0"
 
-fromentries@^1.2.0:
-  version "1.2.1"
-  resolved "https://registry.yarnpkg.com/fromentries/-/fromentries-1.2.1.tgz#64c31665630479bc993cd800d53387920dc61b4d"
-  integrity sha512-Xu2Qh8yqYuDhQGOhD5iJGninErSfI9A3FrriD3tjUgV5VbJFeH8vfgZ9HnC6jWN80QDVNQK5vmxRAmEAp7Mevw==
-
 fs-extra@^8.1.0:
   version "8.1.0"
   resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-8.1.0.tgz#49d43c45a88cd9677668cb7be1b46efdb8d2e1c0"
@@ -6052,11 +5350,6 @@ function.prototype.name@^1.1.6:
     es-abstract "^1.22.1"
     functions-have-names "^1.2.3"
 
-functional-red-black-tree@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/functional-red-black-tree/-/functional-red-black-tree-1.0.1.tgz#1b0ab3bd553b2a0d6399d29c0e3ea0b252078327"
-  integrity sha1-GwqzvVU7Kg1jmdKcDj6gslIHgyc=
-
 functions-have-names@^1.2.3:
   version "1.2.3"
   resolved "https://registry.yarnpkg.com/functions-have-names/-/functions-have-names-1.2.3.tgz#0404fe4ee2ba2f607f0e0ec3c80bae994133b834"
@@ -6138,11 +5431,6 @@ get-stdin@^4.0.1:
   resolved "https://registry.yarnpkg.com/get-stdin/-/get-stdin-4.0.1.tgz#b968c6b0a04384324902e8bf1a5df32579a450fe"
   integrity sha1-uWjGsKBDhDJJAui/Gl3zJXmkUP4=
 
-get-stdin@^6.0.0:
-  version "6.0.0"
-  resolved "https://registry.yarnpkg.com/get-stdin/-/get-stdin-6.0.0.tgz#9e09bf712b360ab9225e812048f71fde9c89657b"
-  integrity sha512-jp4tHawyV7+fkkSKyvjuLZswblUtz+SQKzSWnBbii16BuZksJlU1wuBYXY75r+duh/llF1ur6oNwi+2ZzjKZ7g==
-
 get-stdin@^8.0.0:
   version "8.0.0"
   resolved "https://registry.yarnpkg.com/get-stdin/-/get-stdin-8.0.0.tgz#cbad6a73feb75f6eeb22ba9e01f89aa28aa97a53"
@@ -6188,11 +5476,6 @@ getpass@^0.1.1:
   dependencies:
     assert-plus "^1.0.0"
 
-git-clone@^0.1.0:
-  version "0.1.0"
-  resolved "https://registry.yarnpkg.com/git-clone/-/git-clone-0.1.0.tgz#0d76163778093aef7f1c30238f2a9ef3f07a2eb9"
-  integrity sha1-DXYWN3gJOu9/HDAjjyqe8/B6Lrk=
-
 git-raw-commits@2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/git-raw-commits/-/git-raw-commits-2.0.0.tgz#d92addf74440c14bcc5c83ecce3fb7f8a79118b5"
@@ -6276,7 +5559,7 @@ glob-to-regexp@^0.3.0:
   resolved "https://registry.yarnpkg.com/glob-to-regexp/-/glob-to-regexp-0.3.0.tgz#8c5a1494d2066c570cc3bfe4496175acc4d502ab"
   integrity sha1-jFoUlNIGbFcMw7/kSWF1rMTVAqs=
 
-glob@^7.0.5, glob@^7.1.1, glob@^7.1.2, glob@^7.1.4, glob@^7.1.6:
+glob@^7.1.1, glob@^7.1.2, glob@^7.1.4, glob@^7.1.6:
   version "7.1.6"
   resolved "https://registry.yarnpkg.com/glob/-/glob-7.1.6.tgz#141f33b81a7c2492e125594307480c46679278a6"
   integrity sha512-LwaxwyZ72Lk7vZINtNNrywX0ZuLyStrdDtabefZKAY5ZGJhVtgdznluResxNmPitE0SAO+O26sWTHeKSI2wMBA==
@@ -6307,7 +5590,7 @@ global-dirs@^0.1.1:
   dependencies:
     ini "^1.3.4"
 
-globals@^11.0.1, globals@^11.1.0:
+globals@^11.1.0:
   version "11.12.0"
   resolved "https://registry.yarnpkg.com/globals/-/globals-11.12.0.tgz#ab8795338868a0babd8525758018c2a7eb95c42e"
   integrity sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==
@@ -6426,30 +5709,11 @@ hard-rejection@^2.1.0:
   resolved "https://registry.yarnpkg.com/hard-rejection/-/hard-rejection-2.1.0.tgz#1c6eda5c1685c63942766d79bb40ae773cecd883"
   integrity sha512-VIZB+ibDhx7ObhAe7OVtoEbuP4h/MuOTHJ+J8h/eBXotJYl0fBgR72xDFCKgIh22OJZIOVNxBMWuhAr10r8HdA==
 
-has-ansi@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/has-ansi/-/has-ansi-2.0.0.tgz#34f5049ce1ecdf2b0649af3ef24e45ed35416d91"
-  integrity sha1-NPUEnOHs3ysGSa8+8k5F7TVBbZE=
-  dependencies:
-    ansi-regex "^2.0.0"
-
 has-bigints@^1.0.1, has-bigints@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/has-bigints/-/has-bigints-1.0.2.tgz#0871bd3e3d51626f6ca0966668ba35d5602d6eaa"
   integrity sha512-tSvCKtBr9lkF0Ex0aQiP9N+OpV4zi2r/Nee5VkRDbaqv35RLYMzbwQfFSZZH0kR+Rd6302UJZ2p/bJCEoR3VoQ==
 
-has-binary2@~1.0.2:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/has-binary2/-/has-binary2-1.0.3.tgz#7776ac627f3ea77250cfc332dab7ddf5e4f5d11d"
-  integrity sha512-G1LWKhDSvhGeAQ8mPVQlqNcOB2sJdwATtZKl2pDKKHfpf/rYj24lkinxf69blJbnsvtqqNU+L3SL50vzZhXOnw==
-  dependencies:
-    isarray "2.0.1"
-
-has-cors@1.1.0:
-  version "1.1.0"
-  resolved "https://registry.yarnpkg.com/has-cors/-/has-cors-1.1.0.tgz#5e474793f7ea9843d1bb99c23eef49ff126fff39"
-  integrity sha1-XkdHk/fqmEPRu5nCPu9J/xJv/zk=
-
 has-flag@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/has-flag/-/has-flag-3.0.0.tgz#b5d454dc2199ae225699f3467e5a07f3b955bafd"
@@ -6530,13 +5794,6 @@ has-values@^1.0.0:
     is-number "^3.0.0"
     kind-of "^4.0.0"
 
-has@^1.0.1:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/has/-/has-1.0.3.tgz#722d7cbfc1f6aa8241f16dd814e011e1f41e8796"
-  integrity sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==
-  dependencies:
-    function-bind "^1.1.1"
-
 has@^1.0.3:
   version "1.0.4"
   resolved "https://registry.yarnpkg.com/has/-/has-1.0.4.tgz#2eb2860e000011dae4f1406a86fe80e530fb2ec6"
@@ -6559,14 +5816,6 @@ hash.js@^1.0.0, hash.js@^1.0.3:
     inherits "^2.0.3"
     minimalistic-assert "^1.0.1"
 
-hasha@^5.0.0:
-  version "5.2.0"
-  resolved "https://registry.yarnpkg.com/hasha/-/hasha-5.2.0.tgz#33094d1f69c40a4a6ac7be53d5fe3ff95a269e0c"
-  integrity sha512-2W+jKdQbAdSIrggA8Q35Br8qKadTrqCTC8+XZvBWepKDK6m9XkX6Iz1a2yh2KP01kzAR/dpuMeUnocoLYDcskw==
-  dependencies:
-    is-stream "^2.0.0"
-    type-fest "^0.8.0"
-
 hasown@^2.0.0, hasown@^2.0.1, hasown@^2.0.2:
   version "2.0.2"
   resolved "https://registry.yarnpkg.com/hasown/-/hasown-2.0.2.tgz#003eaf91be7adc372e84ec59dc37252cedb80003"
@@ -6659,7 +5908,7 @@ humanize-ms@^1.2.1:
   dependencies:
     ms "^2.0.0"
 
-iconv-lite@^0.4.17, iconv-lite@^0.4.24:
+iconv-lite@^0.4.24:
   version "0.4.24"
   resolved "https://registry.yarnpkg.com/iconv-lite/-/iconv-lite-0.4.24.tgz#2022b4b25fbddc21d2f524974a474aafe733908b"
   integrity sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==
@@ -6673,11 +5922,6 @@ iconv-lite@^0.6.2:
   dependencies:
     safer-buffer ">= 2.1.2 < 3.0.0"
 
-ieee754@^1.1.4:
-  version "1.1.13"
-  resolved "https://registry.yarnpkg.com/ieee754/-/ieee754-1.1.13.tgz#ec168558e95aa181fd87d37f55c32bbcb6708b84"
-  integrity sha512-4vf7I2LYV/HaWerSo3XmlMkp5eZ83i+/CDluXi/IGTs/O1sejBNhTtnxzmRZfvOUqj7lZjqHkeTvpgSFDlWZTg==
-
 iferr@^0.1.5:
   version "0.1.5"
   resolved "https://registry.yarnpkg.com/iferr/-/iferr-0.1.5.tgz#c60eed69e6d8fdb6b3104a1fcbca1c192dc5b501"
@@ -6690,11 +5934,6 @@ ignore-walk@3.0.3, ignore-walk@^3.0.1:
   dependencies:
     minimatch "^3.0.4"
 
-ignore@^3.0.9, ignore@^3.3.3, ignore@^3.3.6:
-  version "3.3.10"
-  resolved "https://registry.yarnpkg.com/ignore/-/ignore-3.3.10.tgz#0a97fb876986e8081c631160f8f9f389157f0043"
-  integrity sha512-Pgs951kaMm5GXP7MOvxERINe3gsaVjUWFm+UZPSq9xYriQAksyhg0csnS0KXSNRD5NmNdapXEpjxG49+AKh/ug==
-
 ignore@^4.0.3:
   version "4.0.6"
   resolved "https://registry.yarnpkg.com/ignore/-/ignore-4.0.6.tgz#750e3db5862087b4737ebac8207ffd1ef27b25fc"
@@ -6764,11 +6003,6 @@ indent-string@^5.0.0:
   resolved "https://registry.yarnpkg.com/indent-string/-/indent-string-5.0.0.tgz#4fd2980fccaf8622d14c64d694f4cf33c81951a5"
   integrity sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg==
 
-indexof@0.0.1:
-  version "0.0.1"
-  resolved "https://registry.yarnpkg.com/indexof/-/indexof-0.0.1.tgz#82dc336d232b9062179d05ab3293a66059fd435d"
-  integrity sha1-gtwzbSMrkGIXnQWrMpOmYFn9Q10=
-
 infer-owner@^1.0.3, infer-owner@^1.0.4:
   version "1.0.4"
   resolved "https://registry.yarnpkg.com/infer-owner/-/infer-owner-1.0.4.tgz#c4cefcaa8e51051c2a40ba2ce8a3d27295af9467"
@@ -6787,16 +6021,16 @@ inherits@2, inherits@^2.0.1, inherits@^2.0.3, inherits@^2.0.4, inherits@~2.0.3:
   resolved "https://registry.yarnpkg.com/inherits/-/inherits-2.0.4.tgz#0fa2c64f932917c3433a0ded55363aae37416b7c"
   integrity sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==
 
+ini@1.3.8:
+  version "1.3.8"
+  resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.8.tgz#a29da425b48806f34767a4efce397269af28432c"
+  integrity sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==
+
 ini@^1.3.2, ini@^1.3.4:
   version "1.3.5"
   resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.5.tgz#eee25f56db1c9ec6085e0c22778083f596abf927"
   integrity sha512-RZY5huIKCMRWDUqZlEi72f/lmXKMvuszcMBduliQ3nnWbx9X/ZBQO7DijMEYS9EhHBb2qacRUMtC7svLwe0lcw==
 
-ini@^1.3.8:
-  version "1.3.8"
-  resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.8.tgz#a29da425b48806f34767a4efce397269af28432c"
-  integrity sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==
-
 init-package-json@^1.10.3:
   version "1.10.3"
   resolved "https://registry.yarnpkg.com/init-package-json/-/init-package-json-1.10.3.tgz#45ffe2f610a8ca134f2bd1db5637b235070f6cbe"
@@ -6811,26 +6045,6 @@ init-package-json@^1.10.3:
     validate-npm-package-license "^3.0.1"
     validate-npm-package-name "^3.0.0"
 
-inquirer@^3.0.6:
-  version "3.3.0"
-  resolved "https://registry.yarnpkg.com/inquirer/-/inquirer-3.3.0.tgz#9dd2f2ad765dcab1ff0443b491442a20ba227dc9"
-  integrity sha512-h+xtnyk4EwKvFWHrUYsWErEVR+igKtLdchu+o0Z1RL7VU/jVMFbYir2bp6bAj8efFNxWqHX0dIss6fJQ+/+qeQ==
-  dependencies:
-    ansi-escapes "^3.0.0"
-    chalk "^2.0.0"
-    cli-cursor "^2.1.0"
-    cli-width "^2.0.0"
-    external-editor "^2.0.4"
-    figures "^2.0.0"
-    lodash "^4.3.0"
-    mute-stream "0.0.7"
-    run-async "^2.2.0"
-    rx-lite "^4.0.8"
-    rx-lite-aggregates "^4.0.8"
-    string-width "^2.1.0"
-    strip-ansi "^4.0.0"
-    through "^2.3.6"
-
 inquirer@^6.2.0:
   version "6.5.2"
   resolved "https://registry.yarnpkg.com/inquirer/-/inquirer-6.5.2.tgz#ad50942375d036d327ff528c08bd5fab089928ca"
@@ -7062,11 +6276,6 @@ is-generator-fn@^2.0.0:
   resolved "https://registry.yarnpkg.com/is-generator-fn/-/is-generator-fn-2.1.0.tgz#7d140adc389aaf3011a8f2a2a4cfa6faadffb118"
   integrity sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==
 
-is-generator-function@^1.0.7:
-  version "1.0.7"
-  resolved "https://registry.yarnpkg.com/is-generator-function/-/is-generator-function-1.0.7.tgz#d2132e529bb0000a7f80794d4bdf5cd5e5813522"
-  integrity sha512-YZc5EwyO4f2kWCax7oegfuSr9mFz1ZvieNYBEjmukLxgXfBUbxAWGVF7GZf0zidYtoBl3WvC07YK0wT76a+Rtw==
-
 is-glob@^3.1.0:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/is-glob/-/is-glob-3.1.0.tgz#7ba5ae24217804ac70707b96922567486cc3e84a"
@@ -7086,13 +6295,6 @@ is-map@^2.0.1:
   resolved "https://registry.yarnpkg.com/is-map/-/is-map-2.0.1.tgz#520dafc4307bb8ebc33b813de5ce7c9400d644a1"
   integrity sha512-T/S49scO8plUiAOA2DBTBG3JHpn1yiw0kRp6dgiZ0v2/6twi5eiB0rHtHFH9ZIrvlWc6+4O+m4zg5+Z833aXgw==
 
-is-nan@^1.2.1:
-  version "1.3.0"
-  resolved "https://registry.yarnpkg.com/is-nan/-/is-nan-1.3.0.tgz#85d1f5482f7051c2019f5673ccebdb06f3b0db03"
-  integrity sha512-z7bbREymOqt2CCaZVly8aC4ML3Xhfi0ekuOnjO2L8vKdl+CttdVoGZQhd4adMFAsxQ5VeRVwORs4tU8RH+HFtQ==
-  dependencies:
-    define-properties "^1.1.3"
-
 is-negative-zero@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/is-negative-zero/-/is-negative-zero-2.0.0.tgz#9553b121b0fac28869da9ed459e20c7543788461"
@@ -7174,11 +6376,6 @@ is-regex@^1.1.4:
     call-bind "^1.0.2"
     has-tostringtag "^1.0.0"
 
-is-resolvable@^1.0.0:
-  version "1.1.0"
-  resolved "https://registry.yarnpkg.com/is-resolvable/-/is-resolvable-1.1.0.tgz#fb18f87ce1feb925169c9a407c19318a3206ed88"
-  integrity sha512-qgDYXFSR5WvEfuS5dMj6oTMEbrrSaM0CrFk2Yiq/gXnBvD9pMa2jGXxyhGLfvhZpuMZe18CJpFxAt3CRs42NMg==
-
 is-set@^2.0.1:
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/is-set/-/is-set-2.0.1.tgz#d1604afdab1724986d30091575f54945da7e5f43"
@@ -7290,17 +6487,12 @@ is-wsl@^2.2.0:
   dependencies:
     is-docker "^2.0.0"
 
-isarray@1.0.0, isarray@^1.0.0, isarray@~1.0.0:
+isarray@1.0.0, isarray@~1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/isarray/-/isarray-1.0.0.tgz#bb935d48582cba168c06834957a54a3e07124f11"
   integrity sha1-u5NdSFgsuhaMBoNJV6VKPgcSTxE=
 
-isarray@2.0.1:
-  version "2.0.1"
-  resolved "https://registry.yarnpkg.com/isarray/-/isarray-2.0.1.tgz#a37d94ed9cda2d59865c9f76fe596ee1f338741e"
-  integrity sha1-o32U7ZzaLVmGXJ92/llu4fM4dB4=
-
-isarray@^2.0.1, isarray@^2.0.5:
+isarray@^2.0.5:
   version "2.0.5"
   resolved "https://registry.yarnpkg.com/isarray/-/isarray-2.0.5.tgz#8af1e4c1221244cc62459faf38940d4e644a5723"
   integrity sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw==
@@ -7332,7 +6524,7 @@ isstream@~0.1.2:
   resolved "https://registry.yarnpkg.com/isstream/-/isstream-0.1.2.tgz#47e63f7af55afa6f92e1500e690eb8b8529c099a"
   integrity sha1-R+Y/evVa+m+S4VAOaQ64uFKcCZo=
 
-istanbul-lib-coverage@^3.0.0, istanbul-lib-coverage@^3.0.0-alpha.1:
+istanbul-lib-coverage@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/istanbul-lib-coverage/-/istanbul-lib-coverage-3.0.0.tgz#f5944a37c70b550b02a78a5c3b2055b280cec8ec"
   integrity sha512-UiUIqxMgRDET6eR+o5HbfRYP1l0hqkWOs7vNxC/mggutCMUIhWMm8gAHb8tHlyfD3/l6rlgNA5cKdDzEAf6hEg==
@@ -7342,14 +6534,7 @@ istanbul-lib-coverage@^3.2.0:
   resolved "https://registry.yarnpkg.com/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.0.tgz#189e7909d0a39fa5a3dfad5b03f71947770191d3"
   integrity sha512-eOeJ5BHCmHYvQK7xt9GkdHuzuCGS1Y6g9Gvnx3Ym33fz/HpLRYxiS0wHNr+m/MBC8B647Xt608vCDEvhl9c6Mw==
 
-istanbul-lib-hook@^3.0.0:
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/istanbul-lib-hook/-/istanbul-lib-hook-3.0.0.tgz#8f84c9434888cc6b1d0a9d7092a76d239ebf0cc6"
-  integrity sha512-Pt/uge1Q9s+5VAZ+pCo16TYMWPBIl+oaNIjgLQxcX0itS6ueeaA+pEfThZpH8WxhFgCiEb8sAJY6MdUKgiIWaQ==
-  dependencies:
-    append-transform "^2.0.0"
-
-istanbul-lib-instrument@^4.0.0, istanbul-lib-instrument@^4.0.3:
+istanbul-lib-instrument@^4.0.3:
   version "4.0.3"
   resolved "https://registry.yarnpkg.com/istanbul-lib-instrument/-/istanbul-lib-instrument-4.0.3.tgz#873c6fff897450118222774696a3f28902d77c1d"
   integrity sha512-BXgQl9kf4WTCPCCpmFGoJkz/+uhvm7h7PFKUYxh7qarQd3ER33vHG//qaE8eN25l07YqZPpHXU9I09l/RD5aGQ==
@@ -7370,19 +6555,6 @@ istanbul-lib-instrument@^5.0.4, istanbul-lib-instrument@^5.1.0:
     istanbul-lib-coverage "^3.2.0"
     semver "^6.3.0"
 
-istanbul-lib-processinfo@^2.0.2:
-  version "2.0.2"
-  resolved "https://registry.yarnpkg.com/istanbul-lib-processinfo/-/istanbul-lib-processinfo-2.0.2.tgz#e1426514662244b2f25df728e8fd1ba35fe53b9c"
-  integrity sha512-kOwpa7z9hme+IBPZMzQ5vdQj8srYgAtaRqeI48NGmAQ+/5yKiHLV0QbYqQpxsdEF0+w14SoB8YbnHKcXE2KnYw==
-  dependencies:
-    archy "^1.0.0"
-    cross-spawn "^7.0.0"
-    istanbul-lib-coverage "^3.0.0-alpha.1"
-    make-dir "^3.0.0"
-    p-map "^3.0.0"
-    rimraf "^3.0.0"
-    uuid "^3.3.3"
-
 istanbul-lib-report@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/istanbul-lib-report/-/istanbul-lib-report-3.0.0.tgz#7518fe52ea44de372f460a76b5ecda9ffb73d8a6"
@@ -7920,27 +7092,17 @@ jest@^29.4.1:
     import-local "^3.0.2"
     jest-cli "^29.4.1"
 
-js-base64@^2.4.9:
-  version "2.6.4"
-  resolved "https://registry.yarnpkg.com/js-base64/-/js-base64-2.6.4.tgz#f4e686c5de1ea1f867dbcad3d46d969428df98c4"
-  integrity sha512-pZe//GGmwJndub7ZghVHz7vjb2LgC1m8B07Au3eYqeqv9emhESByMXxaEgkUkEqJe87oBbSniGYoQNIBklc7IQ==
-
 js-sha256@^0.9.0:
   version "0.9.0"
   resolved "https://registry.yarnpkg.com/js-sha256/-/js-sha256-0.9.0.tgz#0b89ac166583e91ef9123644bd3c5334ce9d0966"
   integrity sha512-sga3MHh9sgQN2+pJ9VYZ+1LPwXOxuBJBA5nrR5/ofPfuiJBE2hnjsaN8se8JznOmGLN2p49Pe5U/ttafcs/apA==
 
-"js-tokens@^3.0.0 || ^4.0.0", js-tokens@^4.0.0:
+js-tokens@^4.0.0:
   version "4.0.0"
   resolved "https://registry.yarnpkg.com/js-tokens/-/js-tokens-4.0.0.tgz#19203fb59991df98e3a287050d4647cdeaf32499"
   integrity sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==
 
-js-tokens@^3.0.2:
-  version "3.0.2"
-  resolved "https://registry.yarnpkg.com/js-tokens/-/js-tokens-3.0.2.tgz#9866df395102130e38f7f996bceb65443209c25b"
-  integrity sha1-mGbfOVECEw449/mWvOtlRDIJwls=
-
-js-yaml@3.14.0, js-yaml@^3.13.1, js-yaml@^3.9.1:
+js-yaml@3.14.0, js-yaml@^3.13.1:
   version "3.14.0"
   resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-3.14.0.tgz#a7a34170f26a21bb162424d8adacb4113a69e482"
   integrity sha512-/4IbIeHcD9VMHFqDR/gQ7EdZdLimOvW2DdcxFjdyyZ9NsbS+ccrXqVWDtab/lRl5AlUqmpBx8EhPaWR+OtY17A==
@@ -7980,11 +7142,6 @@ json-parse-even-better-errors@^2.3.0:
   resolved "https://registry.yarnpkg.com/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.0.tgz#371873c5ffa44304a6ba12419bcfa95f404ae081"
   integrity sha512-o3aP+RsWDJZayj1SbHNQAI8x0v3T3SKiGoZlNYfbUP1S3omJQ6i9CnqADqkSPaOAxwua4/1YWx5CM7oiChJt2Q==
 
-json-schema-traverse@^0.3.0:
-  version "0.3.1"
-  resolved "https://registry.yarnpkg.com/json-schema-traverse/-/json-schema-traverse-0.3.1.tgz#349a6d44c53a51de89b40805c5d5e59b417d3340"
-  integrity sha1-NJptRMU6Ud6JtAgFxdXlm0F9M0A=
-
 json-schema-traverse@^0.4.1:
   version "0.4.1"
   resolved "https://registry.yarnpkg.com/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz#69f6a87d9513ab8bb8fe63bdb0979c448e684660"
@@ -8055,28 +7212,19 @@ jsprim@^1.2.2:
     json-schema "0.2.3"
     verror "1.10.0"
 
-jsx-ast-utils@^2.0.1:
-  version "2.4.1"
-  resolved "https://registry.yarnpkg.com/jsx-ast-utils/-/jsx-ast-utils-2.4.1.tgz#1114a4c1209481db06c690c2b4f488cc665f657e"
-  integrity sha512-z1xSldJ6imESSzOjd3NNkieVJKRlKYSOtMG8SFyCj2FIrvSaSuli/WjpBkEzCBoR9bYYYFgqJw61Xhu7Lcgk+w==
-  dependencies:
-    array-includes "^3.1.1"
-    object.assign "^4.1.0"
-
 junk@^4.0.0:
   version "4.0.0"
   resolved "https://registry.yarnpkg.com/junk/-/junk-4.0.0.tgz#9b1104ddf5281cd24ffa3c8a7443d19ce192b37f"
   integrity sha512-ojtSU++zLJ3jQG9bAYjg94w+/DOJtRyD7nPaerMFrBhmdVmiV5/exYH5t4uHga4G/95nT6hr1OJoKIFbYbrW5w==
 
-keccak@^1.3.0:
-  version "1.4.0"
-  resolved "https://registry.yarnpkg.com/keccak/-/keccak-1.4.0.tgz#572f8a6dbee8e7b3aa421550f9e6408ca2186f80"
-  integrity sha512-eZVaCpblK5formjPjeTBik7TAg+pqnDrMHIffSvi9Lh7PQgM1+hSzakUeZFCk9DVVG0dacZJuaz2ntwlzZUIBw==
+keccak@^3.0.1:
+  version "3.0.4"
+  resolved "https://registry.yarnpkg.com/keccak/-/keccak-3.0.4.tgz#edc09b89e633c0549da444432ecf062ffadee86d"
+  integrity sha512-3vKuW0jV8J3XNTzvfyicFR5qvxrSAGl7KIhvgOu5cmWwM7tZRj3fMbj/pfIf4be7aznbc+prBWGjywox/g2Y6Q==
   dependencies:
-    bindings "^1.2.1"
-    inherits "^2.0.3"
-    nan "^2.2.1"
-    safe-buffer "^5.1.0"
+    node-addon-api "^2.0.0"
+    node-gyp-build "^4.2.0"
+    readable-stream "^3.6.0"
 
 keyv@^4.5.3:
   version "4.5.4"
@@ -8143,14 +7291,6 @@ leven@^3.1.0:
   resolved "https://registry.yarnpkg.com/leven/-/leven-3.1.0.tgz#77891de834064cccba82ae7842bb6b14a13ed7f2"
   integrity sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==
 
-levn@^0.3.0, levn@~0.3.0:
-  version "0.3.0"
-  resolved "https://registry.yarnpkg.com/levn/-/levn-0.3.0.tgz#3b09924edf9f083c0490fdd4c0bc4421e04764ee"
-  integrity sha1-OwmSTt+fCDwEkP3UwLxEIeBHZO4=
-  dependencies:
-    prelude-ls "~1.1.2"
-    type-check "~0.3.2"
-
 levn@^0.4.1:
   version "0.4.1"
   resolved "https://registry.yarnpkg.com/levn/-/levn-0.4.1.tgz#ae4562c007473b932a6200d403268dd2fffc6ade"
@@ -8175,16 +7315,6 @@ load-json-file@^1.0.0:
     pinkie-promise "^2.0.0"
     strip-bom "^2.0.0"
 
-load-json-file@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/load-json-file/-/load-json-file-2.0.0.tgz#7947e42149af80d696cbf797bcaabcfe1fe29ca8"
-  integrity sha1-eUfkIUmvgNaWy/eXvKq8/h/inKg=
-  dependencies:
-    graceful-fs "^4.1.2"
-    parse-json "^2.2.0"
-    pify "^2.0.0"
-    strip-bom "^3.0.0"
-
 load-json-file@^4.0.0:
   version "4.0.0"
   resolved "https://registry.yarnpkg.com/load-json-file/-/load-json-file-4.0.0.tgz#2f5f45ab91e33216234fd53adab668eb4ec0993b"
@@ -8236,58 +7366,16 @@ locate-path@^6.0.0:
   dependencies:
     p-locate "^5.0.0"
 
-lodash._baseiteratee@~4.7.0:
-  version "4.7.0"
-  resolved "https://registry.yarnpkg.com/lodash._baseiteratee/-/lodash._baseiteratee-4.7.0.tgz#34a9b5543572727c3db2e78edae3c0e9e66bd102"
-  integrity sha1-NKm1VDVycnw9sueO2uPA6eZr0QI=
-  dependencies:
-    lodash._stringtopath "~4.8.0"
-
-lodash._basetostring@~4.12.0:
-  version "4.12.0"
-  resolved "https://registry.yarnpkg.com/lodash._basetostring/-/lodash._basetostring-4.12.0.tgz#9327c9dc5158866b7fa4b9d42f4638e5766dd9df"
-  integrity sha1-kyfJ3FFYhmt/pLnUL0Y45XZt2d8=
-
-lodash._baseuniq@~4.6.0:
-  version "4.6.0"
-  resolved "https://registry.yarnpkg.com/lodash._baseuniq/-/lodash._baseuniq-4.6.0.tgz#0ebb44e456814af7905c6212fa2c9b2d51b841e8"
-  integrity sha1-DrtE5FaBSveQXGIS+iybLVG4Qeg=
-  dependencies:
-    lodash._createset "~4.0.0"
-    lodash._root "~3.0.0"
-
-lodash._createset@~4.0.0:
-  version "4.0.3"
-  resolved "https://registry.yarnpkg.com/lodash._createset/-/lodash._createset-4.0.3.tgz#0f4659fbb09d75194fa9e2b88a6644d363c9fe26"
-  integrity sha1-D0ZZ+7CddRlPqeK4imZE02PJ/iY=
-
 lodash._reinterpolate@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/lodash._reinterpolate/-/lodash._reinterpolate-3.0.0.tgz#0ccf2d89166af03b3663c796538b75ac6e114d9d"
   integrity sha1-DM8tiRZq8Ds2Y8eWU4t1rG4RTZ0=
 
-lodash._root@~3.0.0:
-  version "3.0.1"
-  resolved "https://registry.yarnpkg.com/lodash._root/-/lodash._root-3.0.1.tgz#fba1c4524c19ee9a5f8136b4609f017cf4ded692"
-  integrity sha1-+6HEUkwZ7ppfgTa0YJ8BfPTe1pI=
-
-lodash._stringtopath@~4.8.0:
-  version "4.8.0"
-  resolved "https://registry.yarnpkg.com/lodash._stringtopath/-/lodash._stringtopath-4.8.0.tgz#941bcf0e64266e5fc1d66fed0a6959544c576824"
-  integrity sha1-lBvPDmQmbl/B1m/tCmlZVExXaCQ=
-  dependencies:
-    lodash._basetostring "~4.12.0"
-
 lodash.clonedeep@^4.5.0:
   version "4.5.0"
   resolved "https://registry.yarnpkg.com/lodash.clonedeep/-/lodash.clonedeep-4.5.0.tgz#e23f3f9c4f8fbdde872529c1071857a086e5ccef"
   integrity sha1-4j8/nE+Pvd6HJSnBBxhXoIblzO8=
 
-lodash.flattendeep@^4.4.0:
-  version "4.4.0"
-  resolved "https://registry.yarnpkg.com/lodash.flattendeep/-/lodash.flattendeep-4.4.0.tgz#fb030917f86a3134e5bc9bec0d69e0013ddfedb2"
-  integrity sha1-+wMJF/hqMTTlvJvsDWngAT3f7bI=
-
 lodash.get@^4.4.2:
   version "4.4.2"
   resolved "https://registry.yarnpkg.com/lodash.get/-/lodash.get-4.4.2.tgz#2d177f652fa31e939b4438d5341499dfa3825e99"
@@ -8328,41 +7416,16 @@ lodash.templatesettings@^4.0.0:
   dependencies:
     lodash._reinterpolate "^3.0.0"
 
-lodash.throttle@^4.1.1:
-  version "4.1.1"
-  resolved "https://registry.yarnpkg.com/lodash.throttle/-/lodash.throttle-4.1.1.tgz#c23e91b710242ac70c37f1e1cda9274cc39bf2f4"
-  integrity sha1-wj6RtxAkKscMN/HhzaknTMOb8vQ=
-
-lodash.toarray@^4.4.0:
-  version "4.4.0"
-  resolved "https://registry.yarnpkg.com/lodash.toarray/-/lodash.toarray-4.4.0.tgz#24c4bfcd6b2fba38bfd0594db1179d8e9b656561"
-  integrity sha1-JMS/zWsvuji/0FlNsRedjptlZWE=
-
 lodash.uniq@^4.5.0:
   version "4.5.0"
   resolved "https://registry.yarnpkg.com/lodash.uniq/-/lodash.uniq-4.5.0.tgz#d0225373aeb652adc1bc82e4945339a842754773"
   integrity sha1-0CJTc662Uq3BvILklFM5qEJ1R3M=
 
-lodash.uniqby@4.5.0:
-  version "4.5.0"
-  resolved "https://registry.yarnpkg.com/lodash.uniqby/-/lodash.uniqby-4.5.0.tgz#a3a17bbf62eeb6240f491846e97c1c4e2a5e1e21"
-  integrity sha1-o6F7v2LutiQPSRhG6XwcTipeHiE=
-  dependencies:
-    lodash._baseiteratee "~4.7.0"
-    lodash._baseuniq "~4.6.0"
-
-lodash@^4.17.12, lodash@^4.17.15, lodash@^4.17.19, lodash@^4.17.4, lodash@^4.2.1, lodash@^4.3.0:
+lodash@^4.17.12, lodash@^4.17.15, lodash@^4.17.19, lodash@^4.2.1:
   version "4.17.20"
   resolved "https://registry.yarnpkg.com/lodash/-/lodash-4.17.20.tgz#b44a9b6297bcb698f1c51a3545a2b3b368d59c52"
   integrity sha512-PlhdFcillOINfeV7Ni6oF1TAEayyZBoZ8bcshTHqOYJYlrqzRK5hagpagky5o4HfCzzd1TRkXPMFq6cKk9rGmA==
 
-loose-envify@^1.4.0:
-  version "1.4.0"
-  resolved "https://registry.yarnpkg.com/loose-envify/-/loose-envify-1.4.0.tgz#71ee51fa7be4caec1a63839f7e682d8132d30caf"
-  integrity sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==
-  dependencies:
-    js-tokens "^3.0.0 || ^4.0.0"
-
 loud-rejection@^1.0.0:
   version "1.6.0"
   resolved "https://registry.yarnpkg.com/loud-rejection/-/loud-rejection-1.6.0.tgz#5b46f80147edee578870f086d04821cf998e551f"
@@ -8371,14 +7434,6 @@ loud-rejection@^1.0.0:
     currently-unhandled "^0.4.1"
     signal-exit "^3.0.0"
 
-lru-cache@^4.0.1:
-  version "4.1.5"
-  resolved "https://registry.yarnpkg.com/lru-cache/-/lru-cache-4.1.5.tgz#8bbe50ea85bed59bc9e33dcab8235ee9bcf443cd"
-  integrity sha512-sWZlbEP2OsHNkXrMl5GYk/jKk70MBng6UU4YI/qGDYbgf6YbP4EvmqISbXCoJiRKs+1bSpFHVgQxvJ17F2li5g==
-  dependencies:
-    pseudomap "^1.0.2"
-    yallist "^2.1.2"
-
 lru-cache@^5.1.1:
   version "5.1.1"
   resolved "https://registry.yarnpkg.com/lru-cache/-/lru-cache-5.1.1.tgz#1da27e6710271947695daf6848e847f01d84b920"
@@ -8413,7 +7468,7 @@ make-dir@^2.1.0:
     pify "^4.0.1"
     semver "^5.6.0"
 
-make-dir@^3.0.0, make-dir@^3.0.2:
+make-dir@^3.0.0:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/make-dir/-/make-dir-3.1.0.tgz#415e967046b3a7f1d185277d84aa58203726a13f"
   integrity sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==
@@ -8606,14 +7661,7 @@ mime-db@1.44.0:
   resolved "https://registry.yarnpkg.com/mime-db/-/mime-db-1.44.0.tgz#fa11c5eb0aca1334b4233cb4d52f10c5a6272f92"
   integrity sha512-/NOTfLrsPBVeH7YtFPgsVWveuL+4SjjYxaQ1xtM1KMFj7HdxlBlxeyNLzhyJVx7r4rZGJAZ/6lkKCitSc/Nmpg==
 
-mime-match@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/mime-match/-/mime-match-1.0.2.tgz#3f87c31e9af1a5fd485fb9db134428b23bbb7ba8"
-  integrity sha1-P4fDHprxpf1IX7nbE0Qosju7e6g=
-  dependencies:
-    wildcard "^1.1.0"
-
-mime-types@^2.1.12, mime-types@~2.1.19, mime-types@~2.1.24:
+mime-types@^2.1.12, mime-types@~2.1.19:
   version "2.1.27"
   resolved "https://registry.yarnpkg.com/mime-types/-/mime-types-2.1.27.tgz#47949f98e279ea53119f5722e0f34e529bec009f"
   integrity sha512-JIhqnCasI9yD+SsmkquHBxTSEuZdQX5BuQnS2Vc7puQQQ+8yiP5AY5uWhpdv4YL4VM5c6iliiYWPgJ/nJQLp7w==
@@ -8645,13 +7693,6 @@ minimalistic-crypto-utils@^1.0.0, minimalistic-crypto-utils@^1.0.1:
   resolved "https://registry.yarnpkg.com/minimalistic-crypto-utils/-/minimalistic-crypto-utils-1.0.1.tgz#f6c00c1c0b082246e5c4d99dfb8c7c083b2b582a"
   integrity sha1-9sAMHAsIIkblxNmd+4x8CDsrWCo=
 
-minimatch@^3.0.2, minimatch@^3.0.3:
-  version "3.0.4"
-  resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-3.0.4.tgz#5166e286457f03306064be5497e8dbb0c3d32083"
-  integrity sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==
-  dependencies:
-    brace-expansion "^1.1.7"
-
 minimatch@^3.0.4, minimatch@^3.0.5, minimatch@^3.1.1, minimatch@^3.1.2:
   version "3.1.2"
   resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-3.1.2.tgz#19cd194bfd3e428f049a70817c038d89ab4be35b"
@@ -8683,16 +7724,16 @@ minimist-options@^3.0.1:
     arrify "^1.0.1"
     is-plain-obj "^1.1.0"
 
-minimist@^1.1.0, minimist@^1.1.3, minimist@^1.2.5:
-  version "1.2.5"
-  resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.5.tgz#67d66014b66a6a8aaa0c083c5fd58df4e4e97602"
-  integrity sha512-FM9nNUYrRBAELZQT3xeZQ7fmMOBg6nWNmJKTcgsJeaLstP/UODVpGsr5OhXhhXg6f+qtJ8uiZ+PUxkDWcgIXLw==
-
 minimist@^1.1.1, minimist@^1.2.0, minimist@^1.2.6:
   version "1.2.8"
   resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.8.tgz#c1a464e7693302e082a075cee0c057741ac4772c"
   integrity sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==
 
+minimist@^1.1.3, minimist@^1.2.5:
+  version "1.2.5"
+  resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.5.tgz#67d66014b66a6a8aaa0c083c5fd58df4e4e97602"
+  integrity sha512-FM9nNUYrRBAELZQT3xeZQ7fmMOBg6nWNmJKTcgsJeaLstP/UODVpGsr5OhXhhXg6f+qtJ8uiZ+PUxkDWcgIXLw==
+
 minipass@^2.3.5, minipass@^2.6.0, minipass@^2.8.6, minipass@^2.9.0:
   version "2.9.0"
   resolved "https://registry.yarnpkg.com/minipass/-/minipass-2.9.0.tgz#e713762e7d3e32fed803115cf93e04bca9fcc9a6"
@@ -8812,12 +7853,7 @@ mz@^2.5.0:
     object-assign "^4.0.1"
     thenify-all "^1.0.0"
 
-namespace-emitter@^2.0.1:
-  version "2.0.1"
-  resolved "https://registry.yarnpkg.com/namespace-emitter/-/namespace-emitter-2.0.1.tgz#978d51361c61313b4e6b8cf6f3853d08dfa2b17c"
-  integrity sha512-N/sMKHniSDJBjfrkbS/tpkPj4RAbvW3mr8UAzvlMHyun93XEm83IAvhWtJVHo+RHn/oO8Job5YN4b+wRjSVp5g==
-
-nan@^2.14.0, nan@^2.2.1:
+nan@^2.14.0:
   version "2.14.1"
   resolved "https://registry.yarnpkg.com/nan/-/nan-2.14.1.tgz#d7be34dfa3105b91494c3147089315eff8874b01"
   integrity sha512-isWHgVjnFjh2x2yuJ/tj3JbwoHu3UC2dX5G/88Cm24yB6YopVgxvBObDY7n5xW6ExmFhJpSEQqFPvq9zaXc8Jw==
@@ -8844,11 +7880,6 @@ natural-compare@^1.4.0:
   resolved "https://registry.yarnpkg.com/natural-compare/-/natural-compare-1.4.0.tgz#4abebfeed7541f2c27acfb29bdbbd15c8d5ba4f7"
   integrity sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==
 
-negotiator@0.6.2:
-  version "0.6.2"
-  resolved "https://registry.yarnpkg.com/negotiator/-/negotiator-0.6.2.tgz#feacf7ccf525a77ae9634436a64883ffeca346fb"
-  integrity sha512-hZXc7K2e+PgeI1eDBe/10Ard4ekbfrrqG8Ep+8Jmf4JID2bNg7NvCPOZN+kfF574pFQI7mum2AUqDidoKqcTOw==
-
 neo-async@^2.6.0:
   version "2.6.2"
   resolved "https://registry.yarnpkg.com/neo-async/-/neo-async-2.6.2.tgz#b4aafb93e3aeb2d8174ca53cf163ab7d7308305f"
@@ -8869,17 +7900,10 @@ nice-try@^1.0.4:
   resolved "https://registry.yarnpkg.com/nice-try/-/nice-try-1.0.5.tgz#a3378a7696ce7d223e88fc9b764bd7ef1089e366"
   integrity sha512-1nh45deeb5olNY7eX82BkPO7SSxR5SSYJiPTrTdFUVYwAl8CKMA5N9PjTYkHiRjisVcxcQ1HXdLhx2qxxJzLNQ==
 
-node-cmd@^3.0.0:
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/node-cmd/-/node-cmd-3.0.0.tgz#38fff70a4aaa4f659d203eb57862737018e24f6f"
-  integrity sha1-OP/3CkqqT2WdID61eGJzcBjiT28=
-
-node-emoji@^1.8.1:
-  version "1.10.0"
-  resolved "https://registry.yarnpkg.com/node-emoji/-/node-emoji-1.10.0.tgz#8886abd25d9c7bb61802a658523d1f8d2a89b2da"
-  integrity sha512-Yt3384If5H6BYGVHiHwTL+99OzJKHhgp82S8/dktEK73T26BazdgZ4JZh92xSVtGNJvz9UbXdNAc5hcrXV42vw==
-  dependencies:
-    lodash.toarray "^4.4.0"
+node-addon-api@^2.0.0:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/node-addon-api/-/node-addon-api-2.0.2.tgz#432cfa82962ce494b132e9d72a15b29f71ff5d32"
+  integrity sha512-Ntyt4AIXyaLIuMHF6IOoTakB3K+RWxwtsHNRxllEoA6vPwP9o4866g6YWDLUdnucilZhmkxiHwHr11gAENw+QA==
 
 node-fetch-npm@^2.0.2:
   version "2.0.4"
@@ -8895,6 +7919,11 @@ node-fetch@^2.2.0, node-fetch@^2.3.0, node-fetch@^2.5.0:
   resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.6.0.tgz#e633456386d4aa55863f676a7ab0daa8fdecb0fd"
   integrity sha512-8dG4H5ujfvFiqDmVu9fQ5bOHUC15JMjMY/Zumv26oOvvVJjM67KF8koCWIabKQ1GJIa9r2mMZscBq/TbdOcmNA==
 
+node-gyp-build@^4.2.0:
+  version "4.8.2"
+  resolved "https://registry.yarnpkg.com/node-gyp-build/-/node-gyp-build-4.8.2.tgz#4f802b71c1ab2ca16af830e6c1ea7dd1ad9496fa"
+  integrity sha512-IRUxE4BVsHWXkV/SFOut4qTlagw2aM8T5/vnTsmrHJvVoKueJHRc/JaFND7QDDc61kLYUJ6qlZM3sqTSyx2dTw==
+
 node-gyp@^5.0.2:
   version "5.1.1"
   resolved "https://registry.yarnpkg.com/node-gyp/-/node-gyp-5.1.1.tgz#eb915f7b631c937d282e33aed44cb7a025f62a3e"
@@ -8929,13 +7958,6 @@ node-notifier@^8.0.0:
     uuid "^8.3.0"
     which "^2.0.2"
 
-node-preload@^0.2.1:
-  version "0.2.1"
-  resolved "https://registry.yarnpkg.com/node-preload/-/node-preload-0.2.1.tgz#c03043bb327f417a18fee7ab7ee57b408a144301"
-  integrity sha512-RM5oyBy45cLEoHqCeh+MNuFAxO0vTFBLskvQbOKnEE7YTTSN4tbN8QWDIPQ6L+WvKsB/qLEGpYe2ZZ9d4W9OIQ==
-  dependencies:
-    process-on-spawn "^1.0.0"
-
 node-releases@^2.0.8:
   version "2.0.9"
   resolved "https://registry.yarnpkg.com/node-releases/-/node-releases-2.0.9.tgz#fe66405285382b0c4ac6bcfbfbe7e8a510650b4d"
@@ -8949,13 +7971,6 @@ nopt@^4.0.1:
     abbrev "1"
     osenv "^0.1.4"
 
-nopt@~1.0.10:
-  version "1.0.10"
-  resolved "https://registry.yarnpkg.com/nopt/-/nopt-1.0.10.tgz#6ddd21bd2a31417b92727dd585f8a6f37608ebee"
-  integrity sha1-bd0hvSoxQXuScn3Vhfim83YI6+4=
-  dependencies:
-    abbrev "1"
-
 normalize-package-data@^2.0.0, normalize-package-data@^2.3.0, normalize-package-data@^2.3.2, normalize-package-data@^2.3.4, normalize-package-data@^2.3.5, normalize-package-data@^2.4.0, normalize-package-data@^2.5.0:
   version "2.5.0"
   resolved "https://registry.yarnpkg.com/normalize-package-data/-/normalize-package-data-2.5.0.tgz#e66db1838b200c1dfc233225d12cb36520e234a8"
@@ -9076,54 +8091,16 @@ number-is-nan@^1.0.0:
   resolved "https://registry.yarnpkg.com/number-is-nan/-/number-is-nan-1.0.1.tgz#097b602b53422a522c1afb8790318336941a011d"
   integrity sha1-CXtgK1NCKlIsGvuHkDGDNpQaAR0=
 
-nyc@*:
-  version "15.1.0"
-  resolved "https://registry.yarnpkg.com/nyc/-/nyc-15.1.0.tgz#1335dae12ddc87b6e249d5a1994ca4bdaea75f02"
-  integrity sha512-jMW04n9SxKdKi1ZMGhvUTHBN0EICCRkHemEoE5jm6mTYcqcdas0ATzgUgejlQUHMvpnOZqGB5Xxsv9KxJW1j8A==
-  dependencies:
-    "@istanbuljs/load-nyc-config" "^1.0.0"
-    "@istanbuljs/schema" "^0.1.2"
-    caching-transform "^4.0.0"
-    convert-source-map "^1.7.0"
-    decamelize "^1.2.0"
-    find-cache-dir "^3.2.0"
-    find-up "^4.1.0"
-    foreground-child "^2.0.0"
-    get-package-type "^0.1.0"
-    glob "^7.1.6"
-    istanbul-lib-coverage "^3.0.0"
-    istanbul-lib-hook "^3.0.0"
-    istanbul-lib-instrument "^4.0.0"
-    istanbul-lib-processinfo "^2.0.2"
-    istanbul-lib-report "^3.0.0"
-    istanbul-lib-source-maps "^4.0.0"
-    istanbul-reports "^3.0.2"
-    make-dir "^3.0.0"
-    node-preload "^0.2.1"
-    p-map "^3.0.0"
-    process-on-spawn "^1.0.0"
-    resolve-from "^5.0.0"
-    rimraf "^3.0.0"
-    signal-exit "^3.0.2"
-    spawn-wrap "^2.0.0"
-    test-exclude "^6.0.0"
-    yargs "^15.0.2"
-
 oauth-sign@~0.9.0:
   version "0.9.0"
   resolved "https://registry.yarnpkg.com/oauth-sign/-/oauth-sign-0.9.0.tgz#47a7b016baa68b5fa0ecf3dee08a85c679ac6455"
   integrity sha512-fexhUFFPTGV8ybAtSIGbV6gOkSv8UtRbDBnAyLQw4QPKkgNlsH2ByPGtMUqdWkos6YCRmAqViwgZrJc/mRDzZQ==
 
-object-assign@^4.0.1, object-assign@^4.1.0, object-assign@^4.1.1:
+object-assign@^4.0.1, object-assign@^4.1.0:
   version "4.1.1"
   resolved "https://registry.yarnpkg.com/object-assign/-/object-assign-4.1.1.tgz#2109adc7965887cfc05cbbd442cac8bfbb360863"
   integrity sha1-IQmtx5ZYh8/AXLvUQsrIv7s2CGM=
 
-object-component@0.0.3:
-  version "0.0.3"
-  resolved "https://registry.yarnpkg.com/object-component/-/object-component-0.0.3.tgz#f0c69aa50efc95b866c186f400a33769cb2f1291"
-  integrity sha1-8MaapQ78lbhmwYb0AKM3acsvEpE=
-
 object-copy@^0.1.0:
   version "0.1.0"
   resolved "https://registry.yarnpkg.com/object-copy/-/object-copy-0.1.0.tgz#7e7d858b781bd7c991a41ba975ed3812754e998c"
@@ -9143,7 +8120,7 @@ object-inspect@^1.7.0, object-inspect@^1.8.0:
   resolved "https://registry.yarnpkg.com/object-inspect/-/object-inspect-1.8.0.tgz#df807e5ecf53a609cc6bfe93eac3cc7be5b3a9d0"
   integrity sha512-jLdtEOB112fORuypAyl/50VRVIBIdVQOSUUGQHzJ4xBSbit81zRarz7GThkEFZy1RceYrWYcPcBFPQwHyAc1gA==
 
-object-is@^1.0.1, object-is@^1.1.2:
+object-is@^1.1.2:
   version "1.1.2"
   resolved "https://registry.yarnpkg.com/object-is/-/object-is-1.1.2.tgz#c5d2e87ff9e119f78b7a088441519e2eec1573b6"
   integrity sha512-5lHCz+0uufF6wZ7CRFWJN3hp8Jqblpgve06U5CMQ3f//6iDjPr2PEo9MWCjEssDsa+UZEL4PkFpr+BMop6aKzQ==
@@ -9271,18 +8248,6 @@ onetime@^5.1.2:
   dependencies:
     mimic-fn "^2.1.0"
 
-optionator@^0.8.2:
-  version "0.8.3"
-  resolved "https://registry.yarnpkg.com/optionator/-/optionator-0.8.3.tgz#84fa1d036fe9d3c7e21d99884b601167ec8fb495"
-  integrity sha512-+IW9pACdk3XWmmTXG8m3upGUJst5XRGzxMRjXzAuJ1XnIFNvfhjjIuYkDvysnPQ7qzqVzLt78BCruntqRhWQbA==
-  dependencies:
-    deep-is "~0.1.3"
-    fast-levenshtein "~2.0.6"
-    levn "~0.3.0"
-    prelude-ls "~1.1.2"
-    type-check "~0.3.2"
-    word-wrap "~1.2.3"
-
 optionator@^0.9.3:
   version "0.9.4"
   resolved "https://registry.yarnpkg.com/optionator/-/optionator-0.9.4.tgz#7ea1c1a5d91d764fb282139c88fe11e182a3a734"
@@ -9401,13 +8366,6 @@ p-map@^2.1.0:
   resolved "https://registry.yarnpkg.com/p-map/-/p-map-2.1.0.tgz#310928feef9c9ecc65b68b17693018a665cea175"
   integrity sha512-y3b8Kpd8OAN444hxfBbFfj1FY/RjtTd8tzYwhUqNYXx0fXx2iX4maP4Qr6qhIKbQXI02wTLAda4fYUbDagTUFw==
 
-p-map@^3.0.0:
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/p-map/-/p-map-3.0.0.tgz#d704d9af8a2ba684e2600d9a215983d4141a979d"
-  integrity sha512-d3qXVTF/s+W+CdJ5A29wywV2n8CQQYahlgz2bFiA+4eVNJbHJodPZ+/gXwPGh0bOqA+j8S+6+ckmvLGPk1QpxQ==
-  dependencies:
-    aggregate-error "^3.0.0"
-
 p-map@^5.1.0, p-map@^5.3.0:
   version "5.5.0"
   resolved "https://registry.yarnpkg.com/p-map/-/p-map-5.5.0.tgz#054ca8ca778dfa4cf3f8db6638ccb5b937266715"
@@ -9456,16 +8414,6 @@ p-waterfall@^1.0.0:
   dependencies:
     p-reduce "^1.0.0"
 
-package-hash@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.yarnpkg.com/package-hash/-/package-hash-4.0.0.tgz#3537f654665ec3cc38827387fc904c163c54f506"
-  integrity sha512-whdkPIooSu/bASggZ96BWVvZTRMOFxnyUG5PnTSGKoJE2gd5mbVNmR2Nj20QFzxYYgAXpoqC+AiXzl+UMRh7zQ==
-  dependencies:
-    graceful-fs "^4.1.15"
-    hasha "^5.0.0"
-    lodash.flattendeep "^4.4.0"
-    release-zalgo "^1.0.0"
-
 pako@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/pako/-/pako-2.1.0.tgz#266cc37f98c7d883545d11335c00fbd4062c9a86"
@@ -9545,20 +8493,6 @@ parse-url@^5.0.0:
     parse-path "^4.0.0"
     protocols "^1.4.0"
 
-parseqs@0.0.5:
-  version "0.0.5"
-  resolved "https://registry.yarnpkg.com/parseqs/-/parseqs-0.0.5.tgz#d5208a3738e46766e291ba2ea173684921a8b89d"
-  integrity sha1-1SCKNzjkZ2bikbouoXNoSSGouJ0=
-  dependencies:
-    better-assert "~1.0.0"
-
-parseuri@0.0.5:
-  version "0.0.5"
-  resolved "https://registry.yarnpkg.com/parseuri/-/parseuri-0.0.5.tgz#80204a50d4dbb779bfdc6ebe2778d90e4bce320a"
-  integrity sha1-gCBKUNTbt3m/3G6+J3jZDkvOMgo=
-  dependencies:
-    better-assert "~1.0.0"
-
 pascalcase@^0.1.1:
   version "0.1.1"
   resolved "https://registry.yarnpkg.com/pascalcase/-/pascalcase-0.1.1.tgz#b363e55e8006ca6fe21784d2db22bd15d7917f14"
@@ -9591,11 +8525,6 @@ path-is-absolute@^1.0.0:
   resolved "https://registry.yarnpkg.com/path-is-absolute/-/path-is-absolute-1.0.1.tgz#174b9268735534ffbc7ace6bf53a5a9e1b5c5f5f"
   integrity sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==
 
-path-is-inside@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/path-is-inside/-/path-is-inside-1.0.2.tgz#365417dede44430d1c11af61027facf074bdfc53"
-  integrity sha1-NlQX3t5EQw0cEa9hAn+s8HS9/FM=
-
 path-key@^2.0.0, path-key@^2.0.1:
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/path-key/-/path-key-2.0.1.tgz#411cadb574c5a140d3a4b1910d40d80cc9f40b40"
@@ -9625,13 +8554,6 @@ path-type@^1.0.0:
     pify "^2.0.0"
     pinkie-promise "^2.0.0"
 
-path-type@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/path-type/-/path-type-2.0.0.tgz#f012ccb8415b7096fc2daa1054c3d72389594c73"
-  integrity sha1-8BLMuEFbcJb8LaoQVMPXI4lZTHM=
-  dependencies:
-    pify "^2.0.0"
-
 path-type@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/path-type/-/path-type-3.0.0.tgz#cef31dc8e0a1a3bb0d105c0cd97cf3bf47f4e36f"
@@ -9707,30 +8629,6 @@ pirates@^4.0.1, pirates@^4.0.4:
   resolved "https://registry.yarnpkg.com/pirates/-/pirates-4.0.5.tgz#feec352ea5c3268fb23a37c702ab1699f35a5f3b"
   integrity sha512-8V9+HQPupnaXMA23c5hvl69zXvTwTzyAYasnkb0Tts4XvO4CliqONMOnvlq26rkhLC3nWDFBJf73LU1e1VZLaQ==
 
-pkg-conf@^2.0.0:
-  version "2.1.0"
-  resolved "https://registry.yarnpkg.com/pkg-conf/-/pkg-conf-2.1.0.tgz#2126514ca6f2abfebd168596df18ba57867f0058"
-  integrity sha1-ISZRTKbyq/69FoWW3xi6V4Z/AFg=
-  dependencies:
-    find-up "^2.0.0"
-    load-json-file "^4.0.0"
-
-pkg-config@^1.1.0:
-  version "1.1.1"
-  resolved "https://registry.yarnpkg.com/pkg-config/-/pkg-config-1.1.1.tgz#557ef22d73da3c8837107766c52eadabde298fe4"
-  integrity sha1-VX7yLXPaPIg3EHdmxS6tq94pj+Q=
-  dependencies:
-    debug-log "^1.0.0"
-    find-root "^1.0.0"
-    xtend "^4.0.1"
-
-pkg-dir@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/pkg-dir/-/pkg-dir-2.0.0.tgz#f6d5d1109e19d63edf428e0bd57e12777615334b"
-  integrity sha1-9tXREJ4Z1j7fQo4L1X4Sd3YVM0s=
-  dependencies:
-    find-up "^2.1.0"
-
 pkg-dir@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/pkg-dir/-/pkg-dir-3.0.0.tgz#2749020f239ed990881b1f71210d51eb6523bea3"
@@ -9738,23 +8636,13 @@ pkg-dir@^3.0.0:
   dependencies:
     find-up "^3.0.0"
 
-pkg-dir@^4.1.0, pkg-dir@^4.2.0:
+pkg-dir@^4.2.0:
   version "4.2.0"
   resolved "https://registry.yarnpkg.com/pkg-dir/-/pkg-dir-4.2.0.tgz#f099133df7ede422e81d1d8448270eeb3e4261f3"
   integrity sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==
   dependencies:
     find-up "^4.0.0"
 
-pluralize@^7.0.0:
-  version "7.0.0"
-  resolved "https://registry.yarnpkg.com/pluralize/-/pluralize-7.0.0.tgz#298b89df8b93b0221dbf421ad2b1b1ea23fc6777"
-  integrity sha512-ARhBOdzS3e41FbkW/XWrTEtukqqLoK5+Z/4UeDaLuSW+39JPeFgs4gCGqsrJHVZX0fUrx//4OF0K1CUGwlIFow==
-
-pngjs@^3.3.0:
-  version "3.4.0"
-  resolved "https://registry.yarnpkg.com/pngjs/-/pngjs-3.4.0.tgz#99ca7d725965fb655814eaf65f38f12bbdbf555f"
-  integrity sha512-NCrCHhWmnQklfH4MtJMRjZ2a8c80qXeMlQMv2uVp9ISJMTt562SbGd6n2oq0PaPgKm7Z6pL9E2UlLIhC+SHL3w==
-
 posix-character-classes@^0.1.0:
   version "0.1.1"
   resolved "https://registry.yarnpkg.com/posix-character-classes/-/posix-character-classes-0.1.1.tgz#01eac0fe3b5af71a2a6c02feabb8c1fef7e00eab"
@@ -9765,21 +8653,11 @@ possible-typed-array-names@^1.0.0:
   resolved "https://registry.yarnpkg.com/possible-typed-array-names/-/possible-typed-array-names-1.0.0.tgz#89bb63c6fada2c3e90adc4a647beeeb39cc7bf8f"
   integrity sha512-d7Uw+eZoloe0EHDIYoe+bQ5WXnGMOpmiZFTuMWCwpjzzkL2nTjcKiAk4hh8TjnGye2TwWOk3UXucZ+3rbmBa8Q==
 
-preact@8.2.9:
-  version "8.2.9"
-  resolved "https://registry.yarnpkg.com/preact/-/preact-8.2.9.tgz#813ba9dd45e5d97c5ea0d6c86d375b3be711cc40"
-  integrity sha512-ThuGXBmJS3VsT+jIP+eQufD3L8pRw/PY3FoCys6O9Pu6aF12Pn9zAJDX99TfwRAFOCEKm/P0lwiPTbqKMJp0fA==
-
 prelude-ls@^1.2.1:
   version "1.2.1"
   resolved "https://registry.yarnpkg.com/prelude-ls/-/prelude-ls-1.2.1.tgz#debc6489d7a6e6b0e7611888cec880337d316396"
   integrity sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==
 
-prelude-ls@~1.1.2:
-  version "1.1.2"
-  resolved "https://registry.yarnpkg.com/prelude-ls/-/prelude-ls-1.1.2.tgz#21932a549f5e52ffd9a827f570e04be62a97da54"
-  integrity sha1-IZMqVJ9eUv/ZqCf1cOBL5iqX2lQ=
-
 pretty-format@^26.6.2:
   version "26.6.2"
   resolved "https://registry.yarnpkg.com/pretty-format/-/pretty-format-26.6.2.tgz#e35c2705f14cb7fe2fe94fa078345b444120fc93"
@@ -9813,18 +8691,6 @@ process-nextick-args@~2.0.0:
   resolved "https://registry.yarnpkg.com/process-nextick-args/-/process-nextick-args-2.0.1.tgz#7820d9b16120cc55ca9ae7792680ae7dba6d7fe2"
   integrity sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==
 
-process-on-spawn@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/process-on-spawn/-/process-on-spawn-1.0.0.tgz#95b05a23073d30a17acfdc92a440efd2baefdc93"
-  integrity sha512-1WsPDsUSMmZH5LeMLegqkPDrsGgsWwk1Exipy2hvB0o/F0ASzbpIctSCcZIK1ykJvtTJULEH+20WOFjMvGnCTg==
-  dependencies:
-    fromentries "^1.2.0"
-
-progress@^2.0.0:
-  version "2.0.3"
-  resolved "https://registry.yarnpkg.com/progress/-/progress-2.0.3.tgz#7e8cf8d8f5b8f239c1bc68beb4eb78567d572ef8"
-  integrity sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==
-
 promise-inflight@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/promise-inflight/-/promise-inflight-1.0.1.tgz#98472870bf228132fcbdd868129bad12c3c029e3"
@@ -9853,23 +8719,6 @@ promzard@^0.3.0:
   dependencies:
     read "1"
 
-prop-types@^15.6.0:
-  version "15.7.2"
-  resolved "https://registry.yarnpkg.com/prop-types/-/prop-types-15.7.2.tgz#52c41e75b8c87e72b9d9360e0206b99dcbffa6c5"
-  integrity sha512-8QQikdH7//R2vurIJSutZ1smHYTcLpRWEOlHnzcWHmBYrOGUysKwSsrC89BCiFj3CbrfJ/nXFdJepOVrY1GCHQ==
-  dependencies:
-    loose-envify "^1.4.0"
-    object-assign "^4.1.1"
-    react-is "^16.8.1"
-
-proper-lockfile@^2.0.1:
-  version "2.0.1"
-  resolved "https://registry.yarnpkg.com/proper-lockfile/-/proper-lockfile-2.0.1.tgz#159fb06193d32003f4b3691dd2ec1a634aa80d1d"
-  integrity sha1-FZ+wYZPTIAP0s2kd0uwaY0qoDR0=
-  dependencies:
-    graceful-fs "^4.1.2"
-    retry "^0.10.0"
-
 proto-list@~1.2.1:
   version "1.2.4"
   resolved "https://registry.yarnpkg.com/proto-list/-/proto-list-1.2.4.tgz#212d5bfe1318306a420f6402b8e26ff39647a849"
@@ -9887,11 +8736,6 @@ protoduck@^5.0.1:
   dependencies:
     genfun "^5.0.0"
 
-pseudomap@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/pseudomap/-/pseudomap-1.0.2.tgz#f052a28da70e618917ef0a8ac34c1ae5a68286b3"
-  integrity sha1-8FKijacOYYkX7wqKw0wa5aaChrM=
-
 psl@^1.1.28:
   version "1.8.0"
   resolved "https://registry.yarnpkg.com/psl/-/psl-1.8.0.tgz#9326f8bcfb013adcc005fdff056acce020e51c24"
@@ -9937,19 +8781,6 @@ q@^1.5.1:
   resolved "https://registry.yarnpkg.com/q/-/q-1.5.1.tgz#7e32f75b41381291d04611f1bf14109ac00651d7"
   integrity sha1-fjL3W0E4EpHQRhHxvxQQmsAGUdc=
 
-qrcode@^1.4.1:
-  version "1.4.4"
-  resolved "https://registry.yarnpkg.com/qrcode/-/qrcode-1.4.4.tgz#f0c43568a7e7510a55efc3b88d9602f71963ea83"
-  integrity sha512-oLzEC5+NKFou9P0bMj5+v6Z40evexeE29Z9cummZXZ9QXyMr3lphkURzxjXgPJC5azpxcshoDWV1xE46z+/c3Q==
-  dependencies:
-    buffer "^5.4.3"
-    buffer-alloc "^1.2.0"
-    buffer-from "^1.1.1"
-    dijkstrajs "^1.0.1"
-    isarray "^2.0.1"
-    pngjs "^3.3.0"
-    yargs "^13.2.4"
-
 qs@^6.3.0:
   version "6.9.4"
   resolved "https://registry.yarnpkg.com/qs/-/qs-6.9.4.tgz#9090b290d1f91728d3c22e54843ca44aea5ab687"
@@ -9960,11 +8791,6 @@ qs@~6.5.2:
   resolved "https://registry.yarnpkg.com/qs/-/qs-6.5.2.tgz#cb3ae806e8740444584ef154ce8ee98d403f3e36"
   integrity sha512-N5ZAX4/LxJmF+7wN74pUD6qAh9/wnvdQcjq9TZjevvXzSUo7bfmw91saqMjzGS2xq91/odN2dW/WOl7qQHNDGA==
 
-querystringify@^2.1.1:
-  version "2.2.0"
-  resolved "https://registry.yarnpkg.com/querystringify/-/querystringify-2.2.0.tgz#3345941b4153cb9d082d8eee4cda2016a9aef7f6"
-  integrity sha512-FIqgj2EUvTa7R50u0rGsyTftzjYmv/a3hO345bZNrqabNqjtgiDMgmo4mkUjd+nzU5oF3dClKqFIPUKybUyqoQ==
-
 queue-microtask@^1.2.2:
   version "1.2.3"
   resolved "https://registry.yarnpkg.com/queue-microtask/-/queue-microtask-1.2.3.tgz#4929228bbc724dfac43e0efb058caf7b6cfb6243"
@@ -9990,18 +8816,20 @@ random-bytes@^1.0.0:
   resolved "https://registry.yarnpkg.com/random-bytes/-/random-bytes-1.0.0.tgz#4f68a1dc0ae58bd3fb95848c30324db75d64360b"
   integrity sha1-T2ih3Arli9P7lYSMMDJNt11kNgs=
 
-randombytes@^2.0.1, randombytes@^2.0.6:
+randombytes@2.0.6:
+  version "2.0.6"
+  resolved "https://registry.yarnpkg.com/randombytes/-/randombytes-2.0.6.tgz#d302c522948588848a8d300c932b44c24231da80"
+  integrity sha512-CIQ5OFxf4Jou6uOKe9t1AOgqpeU5fd70A8NPdHSGeYXqXsPe6peOwI0cUl88RWZ6sP1vPMV3avd/R6cZ5/sP1A==
+  dependencies:
+    safe-buffer "^5.1.0"
+
+randombytes@^2.0.1:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/randombytes/-/randombytes-2.1.0.tgz#df6f84372f0270dc65cdf6291349ab7a473d4f2a"
   integrity sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==
   dependencies:
     safe-buffer "^5.1.0"
 
-react-is@^16.8.1:
-  version "16.13.1"
-  resolved "https://registry.yarnpkg.com/react-is/-/react-is-16.13.1.tgz#789729a4dc36de2999dc156dd6c1d9c18cea56a4"
-  integrity sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==
-
 react-is@^17.0.1:
   version "17.0.2"
   resolved "https://registry.yarnpkg.com/react-is/-/react-is-17.0.2.tgz#e691d4a8e9c789365655539ab372762b0efb54f0"
@@ -10046,14 +8874,6 @@ read-pkg-up@^1.0.1:
     find-up "^1.0.0"
     read-pkg "^1.0.0"
 
-read-pkg-up@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/read-pkg-up/-/read-pkg-up-2.0.0.tgz#6b72a8048984e0c41e79510fd5e9fa99b3b549be"
-  integrity sha1-a3KoBImE4MQeeVEP1en6mbO1Sb4=
-  dependencies:
-    find-up "^2.0.0"
-    read-pkg "^2.0.0"
-
 read-pkg-up@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/read-pkg-up/-/read-pkg-up-3.0.0.tgz#3ed496685dba0f8fe118d0691dc51f4a1ff96f07"
@@ -10089,15 +8909,6 @@ read-pkg@^1.0.0:
     normalize-package-data "^2.3.2"
     path-type "^1.0.0"
 
-read-pkg@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/read-pkg/-/read-pkg-2.0.0.tgz#8ef1c0623c6a6db0dc6713c4bfac46332b2368f8"
-  integrity sha1-jvHAYjxqbbDcZxPEv6xGMysjaPg=
-  dependencies:
-    load-json-file "^2.0.0"
-    normalize-package-data "^2.3.2"
-    path-type "^2.0.0"
-
 read-pkg@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/read-pkg/-/read-pkg-3.0.0.tgz#9cbc686978fee65d16c00e2b19c237fcf6e38389"
@@ -10224,13 +9035,6 @@ regexp.prototype.flags@^1.5.2:
     es-errors "^1.3.0"
     set-function-name "^2.0.1"
 
-release-zalgo@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/release-zalgo/-/release-zalgo-1.0.0.tgz#09700b7e5074329739330e535c5a90fb67851730"
-  integrity sha1-CXALflB0Mpc5Mw5TXFqQ+2eFFzA=
-  dependencies:
-    es6-error "^4.0.1"
-
 remove-trailing-separator@^1.0.1:
   version "1.1.0"
   resolved "https://registry.yarnpkg.com/remove-trailing-separator/-/remove-trailing-separator-1.1.0.tgz#c24bce2a283adad5bc3f58e0d48249b92379d8ef"
@@ -10253,11 +9057,6 @@ repeating@^2.0.0:
   dependencies:
     is-finite "^1.0.0"
 
-repl.history@^0.1.4:
-  version "0.1.4"
-  resolved "https://registry.yarnpkg.com/repl.history/-/repl.history-0.1.4.tgz#80367171f3781d6e4299c71758c253097f5d5832"
-  integrity sha1-gDZxcfN4HW5CmccXWMJTCX9dWDI=
-
 request@^2.88.0:
   version "2.88.2"
   resolved "https://registry.yarnpkg.com/request/-/request-2.88.2.tgz#d73c918731cb5a87da047e207234146f664d12b3"
@@ -10294,19 +9093,6 @@ require-main-filename@^2.0.0:
   resolved "https://registry.yarnpkg.com/require-main-filename/-/require-main-filename-2.0.0.tgz#d0b329ecc7cc0f61649f62215be69af54aa8989b"
   integrity sha512-NKN5kMDylKuldxYLSUfrbo5Tuzh4hd+2E8NPPX02mZtn1VuREQToYe/ZdlJy+J3uCpfaiGF05e7B8W0iXbQHmg==
 
-require-uncached@^1.0.3:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/require-uncached/-/require-uncached-1.0.3.tgz#4e0d56d6c9662fd31e43011c4b95aa49955421d3"
-  integrity sha1-Tg1W1slmL9MeQwEcS5WqSZVUIdM=
-  dependencies:
-    caller-path "^0.1.0"
-    resolve-from "^1.0.0"
-
-requires-port@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/requires-port/-/requires-port-1.0.0.tgz#925d2601d39ac485e091cf0da5c6e694dc3dcaff"
-  integrity sha1-kl0mAdOaxIXgkc8NpcbmlNw9yv8=
-
 resolve-cwd@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/resolve-cwd/-/resolve-cwd-2.0.0.tgz#00a9f7387556e27038eae232caa372a6a59b665a"
@@ -10321,11 +9107,6 @@ resolve-cwd@^3.0.0:
   dependencies:
     resolve-from "^5.0.0"
 
-resolve-from@^1.0.0:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/resolve-from/-/resolve-from-1.0.1.tgz#26cbfe935d1aeeeabb29bc3fe5aeb01e93d44226"
-  integrity sha1-Jsv+k10a7uq7Kbw/5a6wHpPUQiY=
-
 resolve-from@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/resolve-from/-/resolve-from-3.0.0.tgz#b22c7af7d9d6881bc8b6e653335eebcb0a188748"
@@ -10363,7 +9144,7 @@ resolve.exports@^2.0.0:
   resolved "https://registry.yarnpkg.com/resolve.exports/-/resolve.exports-2.0.0.tgz#c1a0028c2d166ec2fbf7d0644584927e76e7400e"
   integrity sha512-6K/gDlqgQscOlg9fSRpWstA8sYe8rbELsSTNpx+3kTrsVCzvSl0zIvRErM7fdl9ERWDsKnrLnwB+Ne89918XOg==
 
-resolve@^1.10.0, resolve@^1.13.1, resolve@^1.17.0, resolve@^1.3.2, resolve@^1.3.3:
+resolve@^1.10.0, resolve@^1.17.0, resolve@^1.3.2:
   version "1.17.0"
   resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.17.0.tgz#b25941b54968231cc2d1bb76a79cb7f2c0bf8444"
   integrity sha512-ic+7JYiV8Vi2yzQGFWOkiZD5Z9z7O2Zhm9XMaTxdJExKasieFCr+yXZ/WmXsckHiKl12ar0y6XiXDx3m4RHn1w==
@@ -10425,20 +9206,13 @@ rimraf@^2.5.4, rimraf@^2.6.2, rimraf@^2.6.3:
   dependencies:
     glob "^7.1.3"
 
-rimraf@^3.0.0, rimraf@^3.0.2:
+rimraf@^3.0.2:
   version "3.0.2"
   resolved "https://registry.yarnpkg.com/rimraf/-/rimraf-3.0.2.tgz#f1a5402ba6220ad52cc1282bac1ae3aa49fd061a"
   integrity sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==
   dependencies:
     glob "^7.1.3"
 
-rimraf@~2.6.2:
-  version "2.6.3"
-  resolved "https://registry.yarnpkg.com/rimraf/-/rimraf-2.6.3.tgz#b2d104fe0d8fb27cf9e0a1cda8262dd3833c6cab"
-  integrity sha512-mwqeW5XsA2qAejG46gYdENaxXjx9onRNCfn7L0duuP4hCuTIi/QO7PDK07KJfp1d+izWPrzEJDcSqBa0OZQriA==
-  dependencies:
-    glob "^7.1.3"
-
 ripemd160@^2.0.0, ripemd160@^2.0.1:
   version "2.0.2"
   resolved "https://registry.yarnpkg.com/ripemd160/-/ripemd160-2.0.2.tgz#a1c1a6f624751577ba5d07914cbc92850585890c"
@@ -10457,11 +9231,6 @@ run-async@^2.2.0:
   resolved "https://registry.yarnpkg.com/run-async/-/run-async-2.4.1.tgz#8440eccf99ea3e70bd409d49aab88e10c189a455"
   integrity sha512-tvVnVv01b8c1RrA6Ep7JkStj85Guv/YrMcwqYQnwjsAS2cTmmPGBBjAjpCW7RrSodNSoE2/qg9O4bceNvUuDgQ==
 
-run-parallel@^1.1.2:
-  version "1.1.9"
-  resolved "https://registry.yarnpkg.com/run-parallel/-/run-parallel-1.1.9.tgz#c9dd3a7cf9f4b2c4b6244e173a6ed866e61dd679"
-  integrity sha512-DEqnSRTDw/Tc3FXf49zedI638Z9onwUotBMiUFKmrO2sdFKIbXamXGQ3Axd4qgphxKB4kw/qP1w5kTxnfU1B9Q==
-
 run-parallel@^1.1.9:
   version "1.2.0"
   resolved "https://registry.yarnpkg.com/run-parallel/-/run-parallel-1.2.0.tgz#66d1368da7bdf921eb9d95bd1a9229e7f21a43ee"
@@ -10476,18 +9245,6 @@ run-queue@^1.0.0, run-queue@^1.0.3:
   dependencies:
     aproba "^1.1.1"
 
-rx-lite-aggregates@^4.0.8:
-  version "4.0.8"
-  resolved "https://registry.yarnpkg.com/rx-lite-aggregates/-/rx-lite-aggregates-4.0.8.tgz#753b87a89a11c95467c4ac1626c4efc4e05c67be"
-  integrity sha1-dTuHqJoRyVRnxKwWJsTvxOBcZ74=
-  dependencies:
-    rx-lite "*"
-
-rx-lite@*, rx-lite@^4.0.8:
-  version "4.0.8"
-  resolved "https://registry.yarnpkg.com/rx-lite/-/rx-lite-4.0.8.tgz#0b1e11af8bc44836f04a6407e92da42467b79444"
-  integrity sha1-Cx4Rr4vESDbwSmQH6S2kJGe3lEQ=
-
 rxjs@^6.4.0:
   version "6.6.2"
   resolved "https://registry.yarnpkg.com/rxjs/-/rxjs-6.6.2.tgz#8096a7ac03f2cc4fe5860ef6e572810d9e01c0d2"
@@ -10505,16 +9262,16 @@ safe-array-concat@^1.1.2:
     has-symbols "^1.0.3"
     isarray "^2.0.5"
 
+safe-buffer@5.1.2, safe-buffer@~5.1.0, safe-buffer@~5.1.1:
+  version "5.1.2"
+  resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.1.2.tgz#991ec69d296e0313747d59bdfd2b745c35f8828d"
+  integrity sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==
+
 safe-buffer@^5.0.1, safe-buffer@^5.1.0, safe-buffer@^5.1.1, safe-buffer@^5.1.2, safe-buffer@^5.2.0, safe-buffer@~5.2.0:
   version "5.2.1"
   resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.2.1.tgz#1eaf9fa9bdb1fdd4ec75f58f9cdb4e6b7827eec6"
   integrity sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==
 
-safe-buffer@~5.1.0, safe-buffer@~5.1.1:
-  version "5.1.2"
-  resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.1.2.tgz#991ec69d296e0313747d59bdfd2b745c35f8828d"
-  integrity sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==
-
 safe-regex-test@^1.0.3:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/safe-regex-test/-/safe-regex-test-1.0.3.tgz#a5b4c0f06e0ab50ea2c395c14d8371232924c377"
@@ -10551,10 +9308,10 @@ sane@^4.0.3:
     minimist "^1.1.1"
     walker "~1.0.5"
 
-satoshi-bitcoin@^1.0.4:
+satoshi-bitcoin@1.0.4:
   version "1.0.4"
   resolved "https://registry.yarnpkg.com/satoshi-bitcoin/-/satoshi-bitcoin-1.0.4.tgz#d002b677075d5cbbf2c211a8df3254bcdf50b1e4"
-  integrity sha1-0AK2dwddXLvywhGo3zJUvN9QseQ=
+  integrity sha512-YuHOmw5wsz6wuHIQdsz5b2cgtuKtV/jEcZ4NGmWN5tM/gz5T9Q+DSuLlnuf5BP/jsQWgR0ofmY4f8Dm6JnqSug==
   dependencies:
     big.js "^3.1.3"
 
@@ -10577,7 +9334,7 @@ secp256k1@^3.0.1:
     nan "^2.14.0"
     safe-buffer "^5.1.2"
 
-"semver@2 || 3 || 4 || 5", "semver@2.x || 3.x || 4 || 5", semver@^5.3.0, semver@^5.4.1, semver@^5.5.0, semver@^5.5.1, semver@^5.6.0, semver@^5.7.0, semver@^5.7.1:
+"semver@2 || 3 || 4 || 5", "semver@2.x || 3.x || 4 || 5", semver@^5.4.1, semver@^5.5.0, semver@^5.5.1, semver@^5.6.0, semver@^5.7.0, semver@^5.7.1:
   version "5.7.1"
   resolved "https://registry.yarnpkg.com/semver/-/semver-5.7.1.tgz#a954f931aeba508d307bbf069eff0c01c96116f7"
   integrity sha512-sauaDf/PZdVgrLTNYHRtpXa1iRiKcaebiKQ1BJdpQlWH2lCvexQdX55snPFyK7QzpudqbCI0qXFfOasHdyNDGQ==
@@ -10745,13 +9502,6 @@ slash@^4.0.0:
   resolved "https://registry.yarnpkg.com/slash/-/slash-4.0.0.tgz#2422372176c4c6c5addb5e2ada885af984b396a7"
   integrity sha512-3dOsAHXXUkQTpOYcoAxLIorMTp4gIQr5IW3iVb7A7lFIp0VHhnynm9izx6TssdrIcVIESAlVjtnO2K8bg+Coew==
 
-slice-ansi@1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/slice-ansi/-/slice-ansi-1.0.0.tgz#044f1a49d8842ff307aad6b505ed178bd950134d"
-  integrity sha512-POqxBK6Lb3q6s047D/XsDVNPnF9Dl8JSaqe9h9lURl0OdNqy/ujDrOiIHtsqXMGbWWTIomRzAMaTyawAU//Reg==
-  dependencies:
-    is-fullwidth-code-point "^2.0.0"
-
 slide@^1.1.6:
   version "1.1.6"
   resolved "https://registry.yarnpkg.com/slide/-/slide-1.1.6.tgz#56eb027d65b4d2dce6cb2e2d32c4d4afc9e1d707"
@@ -10806,61 +9556,6 @@ snapdragon@^0.8.1:
     source-map-resolve "^0.5.0"
     use "^3.1.0"
 
-socket.io-adapter@~1.1.0:
-  version "1.1.2"
-  resolved "https://registry.yarnpkg.com/socket.io-adapter/-/socket.io-adapter-1.1.2.tgz#ab3f0d6f66b8fc7fca3959ab5991f82221789be9"
-  integrity sha512-WzZRUj1kUjrTIrUKpZLEzFZ1OLj5FwLlAFQs9kuZJzJi5DKdU7FsWc36SNmA8iDOtwBQyT8FkrriRM8vXLYz8g==
-
-socket.io-client@2.3.0, socket.io-client@^2.1.1:
-  version "2.3.0"
-  resolved "https://registry.yarnpkg.com/socket.io-client/-/socket.io-client-2.3.0.tgz#14d5ba2e00b9bcd145ae443ab96b3f86cbcc1bb4"
-  integrity sha512-cEQQf24gET3rfhxZ2jJ5xzAOo/xhZwK+mOqtGRg5IowZsMgwvHwnf/mCRapAAkadhM26y+iydgwsXGObBB5ZdA==
-  dependencies:
-    backo2 "1.0.2"
-    base64-arraybuffer "0.1.5"
-    component-bind "1.0.0"
-    component-emitter "1.2.1"
-    debug "~4.1.0"
-    engine.io-client "~3.4.0"
-    has-binary2 "~1.0.2"
-    has-cors "1.1.0"
-    indexof "0.0.1"
-    object-component "0.0.3"
-    parseqs "0.0.5"
-    parseuri "0.0.5"
-    socket.io-parser "~3.3.0"
-    to-array "0.1.4"
-
-socket.io-parser@~3.3.0:
-  version "3.3.0"
-  resolved "https://registry.yarnpkg.com/socket.io-parser/-/socket.io-parser-3.3.0.tgz#2b52a96a509fdf31440ba40fed6094c7d4f1262f"
-  integrity sha512-hczmV6bDgdaEbVqhAeVMM/jfUfzuEZHsQg6eOmLgJht6G3mPKMxYm75w2+qhAQZ+4X+1+ATZ+QFKeOZD5riHng==
-  dependencies:
-    component-emitter "1.2.1"
-    debug "~3.1.0"
-    isarray "2.0.1"
-
-socket.io-parser@~3.4.0:
-  version "3.4.1"
-  resolved "https://registry.yarnpkg.com/socket.io-parser/-/socket.io-parser-3.4.1.tgz#b06af838302975837eab2dc980037da24054d64a"
-  integrity sha512-11hMgzL+WCLWf1uFtHSNvliI++tcRUWdoeYuwIl+Axvwy9z2gQM+7nJyN3STj1tLj5JyIUH8/gpDGxzAlDdi0A==
-  dependencies:
-    component-emitter "1.2.1"
-    debug "~4.1.0"
-    isarray "2.0.1"
-
-socket.io@^2.1.1:
-  version "2.3.0"
-  resolved "https://registry.yarnpkg.com/socket.io/-/socket.io-2.3.0.tgz#cd762ed6a4faeca59bc1f3e243c0969311eb73fb"
-  integrity sha512-2A892lrj0GcgR/9Qk81EaY2gYhCBxurV0PfmmESO6p27QPrUK1J3zdns+5QPqvUYK2q657nSj0guoIil9+7eFg==
-  dependencies:
-    debug "~4.1.0"
-    engine.io "~3.4.0"
-    has-binary2 "~1.0.2"
-    socket.io-adapter "~1.1.0"
-    socket.io-client "2.3.0"
-    socket.io-parser "~3.4.0"
-
 socks-proxy-agent@^4.0.0:
   version "4.0.2"
   resolved "https://registry.yarnpkg.com/socks-proxy-agent/-/socks-proxy-agent-4.0.2.tgz#3c8991f3145b2799e70e11bd5fbc8b1963116386"
@@ -10923,18 +9618,6 @@ source-map@^0.7.3:
   resolved "https://registry.yarnpkg.com/source-map/-/source-map-0.7.4.tgz#a9bbe705c9d8846f4e08ff6765acf0f1b0898656"
   integrity sha512-l3BikUxvPOcn5E74dZiq5BGsTb5yEwhaTSzccU6t4sDOH8NWJCstKO5QT2CvtFoK6F0saL7p9xHAqHOlCPJygA==
 
-spawn-wrap@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/spawn-wrap/-/spawn-wrap-2.0.0.tgz#103685b8b8f9b79771318827aa78650a610d457e"
-  integrity sha512-EeajNjfN9zMnULLwhZZQU3GWBoFNkbngTUPfaawT4RkMiviTxcX0qfhVbGey39mfctfDHkWtuecgQ8NJcyQWHg==
-  dependencies:
-    foreground-child "^2.0.0"
-    is-windows "^1.0.2"
-    make-dir "^3.0.0"
-    rimraf "^3.0.0"
-    signal-exit "^3.0.2"
-    which "^2.0.1"
-
 spdx-correct@^3.0.0:
   version "3.1.1"
   resolved "https://registry.yarnpkg.com/spdx-correct/-/spdx-correct-3.1.1.tgz#dece81ac9c1e6713e5f7d1b6f17d468fa53d89a9"
@@ -11016,31 +9699,6 @@ stack-utils@^2.0.2, stack-utils@^2.0.3:
   dependencies:
     escape-string-regexp "^2.0.0"
 
-standard-engine@~8.0.0:
-  version "8.0.1"
-  resolved "https://registry.yarnpkg.com/standard-engine/-/standard-engine-8.0.1.tgz#0b77be8d7ab963675717dbeac1ef1d6675fb62f0"
-  integrity sha512-LA531C3+nljom/XRvdW/hGPXwmilRkaRkENhO3FAGF1Vtq/WtCXzgmnc5S6vUHHsgv534MRy02C1ikMwZXC+tw==
-  dependencies:
-    deglob "^2.1.0"
-    get-stdin "^6.0.0"
-    minimist "^1.1.0"
-    pkg-conf "^2.0.0"
-
-standard@^11.0.1:
-  version "11.0.1"
-  resolved "https://registry.yarnpkg.com/standard/-/standard-11.0.1.tgz#49be40c76f1d564964b22bbf7309929ad0335e29"
-  integrity sha512-nu0jAcHiSc8H+gJCXeiziMVZNDYi8MuqrYJKxTgjP4xKXZMKm311boqQIzDrYI/ktosltxt2CbDjYQs9ANC8IA==
-  dependencies:
-    eslint "~4.18.0"
-    eslint-config-standard "11.0.0"
-    eslint-config-standard-jsx "5.0.0"
-    eslint-plugin-import "~2.9.0"
-    eslint-plugin-node "~6.0.0"
-    eslint-plugin-promise "~3.7.0"
-    eslint-plugin-react "~7.7.0"
-    eslint-plugin-standard "~3.0.1"
-    standard-engine "~8.0.0"
-
 static-extend@^0.1.1:
   version "0.1.2"
   resolved "https://registry.yarnpkg.com/static-extend/-/static-extend-0.1.2.tgz#60809c39cbff55337226fd5e0b520f341f1fb5c6"
@@ -11086,7 +9744,7 @@ string-width@^1.0.1:
     is-fullwidth-code-point "^1.0.0"
     strip-ansi "^3.0.0"
 
-"string-width@^1.0.2 || 2", string-width@^2.1.0, string-width@^2.1.1:
+"string-width@^1.0.2 || 2", string-width@^2.1.0:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/string-width/-/string-width-2.1.1.tgz#ab93f27a8dc13d28cac815c462143a6d9012ae9e"
   integrity sha512-nOqH59deCq9SRHlxq1Aw85Jnt4w6KvLKqWVik6oA9ZklXLNIOlqg4F2yrT1MVaTjAqvVwdfeZ7w7aCvJD7ugkw==
@@ -11281,11 +9939,6 @@ strip-json-comments@^3.1.1:
   resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-3.1.1.tgz#31f1281b3832630434831c310c01cccda8cbe006"
   integrity sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==
 
-strip-json-comments@~2.0.1:
-  version "2.0.1"
-  resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-2.0.1.tgz#3c531942e908c2697c0ec344858c286c7ca0a60a"
-  integrity sha1-PFMZQukIwml8DsNEhYwobHygpgo=
-
 strong-log-transformer@^2.0.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/strong-log-transformer/-/strong-log-transformer-2.1.0.tgz#0f5ed78d325e0421ac6f90f7f10e691d6ae3ae10"
@@ -11300,11 +9953,6 @@ stubs@^3.0.0:
   resolved "https://registry.yarnpkg.com/stubs/-/stubs-3.0.0.tgz#e8d2ba1fa9c90570303c030b6900f7d5f89abe5b"
   integrity sha1-6NK6H6nJBXAwPAMLaQD31fiavls=
 
-supports-color@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-2.0.0.tgz#535d045ce6b6363fa40117084629995e9df324c7"
-  integrity sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=
-
 supports-color@^5.3.0:
   version "5.5.0"
   resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-5.5.0.tgz#e2e69a44ac8772f78a1ec0b35b689df6530efc8f"
@@ -11339,18 +9987,6 @@ supports-preserve-symlinks-flag@^1.0.0:
   resolved "https://registry.yarnpkg.com/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz#6eda4bd344a3c94aea376d4cc31bc77311039e09"
   integrity sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==
 
-table@4.0.2:
-  version "4.0.2"
-  resolved "https://registry.yarnpkg.com/table/-/table-4.0.2.tgz#a33447375391e766ad34d3486e6e2aedc84d2e36"
-  integrity sha512-UUkEAPdSGxtRpiV9ozJ5cMTtYiqz7Ni1OGqLXRCynrvzdtR1p+cfOWe2RJLwvUG8hNanaSRjecIqwOjqeatDsA==
-  dependencies:
-    ajv "^5.2.3"
-    ajv-keywords "^2.1.0"
-    chalk "^2.1.0"
-    lodash "^4.17.4"
-    slice-ansi "1.0.0"
-    string-width "^2.1.1"
-
 tape@*:
   version "5.0.1"
   resolved "https://registry.yarnpkg.com/tape/-/tape-5.0.1.tgz#0d70ce90a586387c4efda4393e72872672a416a3"
@@ -11437,7 +10073,7 @@ text-extensions@^1.0.0:
   resolved "https://registry.yarnpkg.com/text-extensions/-/text-extensions-1.9.0.tgz#1853e45fee39c945ce6f6c36b2d659b5aabc2a26"
   integrity sha512-wiBrwC1EhBelW12Zy26JeOUkQ5mRu+5o8rpsJk5+2t+Y5vE7e842qtZDQ2g1NpX/29HdyFeJ4nSIhI47ENSxlQ==
 
-text-table@^0.2.0, text-table@~0.2.0:
+text-table@^0.2.0:
   version "0.2.0"
   resolved "https://registry.yarnpkg.com/text-table/-/text-table-0.2.0.tgz#7f5ee823ae805207c00af2df4a84ec3fcfa570b4"
   integrity sha1-f17oI66AUgfACvLfSoTsP8+lcLQ=
@@ -11489,11 +10125,6 @@ tmpl@1.0.5:
   resolved "https://registry.yarnpkg.com/tmpl/-/tmpl-1.0.5.tgz#8683e0b902bb9c20c4f726e3c0b69f36518c07cc"
   integrity sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==
 
-to-array@0.1.4:
-  version "0.1.4"
-  resolved "https://registry.yarnpkg.com/to-array/-/to-array-0.1.4.tgz#17e6c11f73dd4f3d74cda7a4ff3238e9ad9bf890"
-  integrity sha1-F+bBH3PdTz10zaek/zI46a2b+JA=
-
 to-fast-properties@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/to-fast-properties/-/to-fast-properties-2.0.0.tgz#dc5e698cbd079265bc73e0377681a4e4e83f616e"
@@ -11531,13 +10162,6 @@ to-regex@^3.0.1, to-regex@^3.0.2:
     regex-not "^1.0.2"
     safe-regex "^1.1.0"
 
-touch@^3.1.0:
-  version "3.1.0"
-  resolved "https://registry.yarnpkg.com/touch/-/touch-3.1.0.tgz#fe365f5f75ec9ed4e56825e0bb76d24ab74af83b"
-  integrity sha512-WBx8Uy5TLtOSRtIq+M03/sKDrXCLHxwDcquSP2c43Le03/9serjQBIztjRz6FkJez9D/hleyAXTBGLwwZUw9lA==
-  dependencies:
-    nopt "~1.0.10"
-
 tough-cookie@~2.5.0:
   version "2.5.0"
   resolved "https://registry.yarnpkg.com/tough-cookie/-/tough-cookie-2.5.0.tgz#cd9fb2a0aa1d5a12b473bd9fb96fa3dcff65ade2"
@@ -11620,18 +10244,6 @@ tunnel-agent@^0.6.0:
   dependencies:
     safe-buffer "^5.0.1"
 
-tus-js-client@^2.1.1:
-  version "2.1.1"
-  resolved "https://registry.yarnpkg.com/tus-js-client/-/tus-js-client-2.1.1.tgz#e7bd94226e1fa1860fcb22d67414b13474a85087"
-  integrity sha512-ILpgHlR0nfKxmlkXfrZ2z61upkHEXhADOGbGyvXSPjp7bn1NhU50p/Mu59q577Xirayr9vlW4tmoFqUrHKcWeQ==
-  dependencies:
-    buffer-from "^0.1.1"
-    combine-errors "^3.0.3"
-    js-base64 "^2.4.9"
-    lodash.throttle "^4.1.1"
-    proper-lockfile "^2.0.1"
-    url-parse "^1.4.3"
-
 tweetnacl@^0.14.3, tweetnacl@~0.14.0:
   version "0.14.5"
   resolved "https://registry.yarnpkg.com/tweetnacl/-/tweetnacl-0.14.5.tgz#5ae68177f192d4456269d108afa93ff8743f4f64"
@@ -11644,13 +10256,6 @@ type-check@^0.4.0, type-check@~0.4.0:
   dependencies:
     prelude-ls "^1.2.1"
 
-type-check@~0.3.2:
-  version "0.3.2"
-  resolved "https://registry.yarnpkg.com/type-check/-/type-check-0.3.2.tgz#5884cab512cf1d355e3fb784f30804b2b520db72"
-  integrity sha1-WITKtRLPHTVeP7eE8wgEsrUg23I=
-  dependencies:
-    prelude-ls "~1.1.2"
-
 type-detect@4.0.8:
   version "4.0.8"
   resolved "https://registry.yarnpkg.com/type-detect/-/type-detect-4.0.8.tgz#7646fb5f18871cfbb7749e69bd39a6388eb7450c"
@@ -11681,7 +10286,7 @@ type-fest@^0.6.0:
   resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.6.0.tgz#8d2a2370d3df886eb5c90ada1c5bf6188acf838b"
   integrity sha512-q+MB8nYR1KDLrgr4G5yemftpMC7/QLqVndBmEEdqzmNj5dcFOO4Oo8qlwZE3ULT3+Zim1F8Kq4cBnikNhlCMlg==
 
-type-fest@^0.8.0, type-fest@^0.8.1:
+type-fest@^0.8.1:
   version "0.8.1"
   resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.8.1.tgz#09e249ebde851d3b1e48d27c105444667f17b83d"
   integrity sha512-4dbzIzqvjtgiM5rw1k5rEHtBANKmdudhGyBEajN01fEyhaAIhsoKNy6y7+IN93IfpFtwY9iqi7kD+xwKhQsNJA==
@@ -11807,11 +10412,6 @@ union-value@^1.0.0:
     is-extendable "^0.1.1"
     set-value "^2.0.1"
 
-uniq@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/uniq/-/uniq-1.0.1.tgz#b31c5ae8254844a3a8281541ce2b04b865a734ff"
-  integrity sha1-sxxa6CVIRKOoKBVBzisEuGWnNP8=
-
 unique-filename@^1.1.1:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/unique-filename/-/unique-filename-1.1.1.tgz#1d69769369ada0583103a1e6ae87681b56573230"
@@ -11893,14 +10493,6 @@ url-join@^5.0.0:
   resolved "https://registry.yarnpkg.com/url-join/-/url-join-5.0.0.tgz#c2f1e5cbd95fa91082a93b58a1f42fecb4bdbcf1"
   integrity sha512-n2huDr9h9yzd6exQVnH/jU5mr+Pfx08LRXXZhkLLetAMESRj+anQsTAh940iMrIetKAmry9coFuZQ2jY8/p3WA==
 
-url-parse@^1.4.3:
-  version "1.4.7"
-  resolved "https://registry.yarnpkg.com/url-parse/-/url-parse-1.4.7.tgz#a8a83535e8c00a316e403a5db4ac1b9b853ae278"
-  integrity sha512-d3uaVyzDB9tQoSXFvuSUNFibTd9zxd2bkVrDRvF5TmvWWQwqE4lgYJ5m+x1DbecWkw+LK4RNl2CU1hHuOKPVlg==
-  dependencies:
-    querystringify "^2.1.1"
-    requires-port "^1.0.0"
-
 urlgrey@0.4.4:
   version "0.4.4"
   resolved "https://registry.yarnpkg.com/urlgrey/-/urlgrey-0.4.4.tgz#892fe95960805e85519f1cd4389f2cb4cbb7652f"
@@ -11923,19 +10515,7 @@ util-promisify@^2.1.0:
   dependencies:
     object.getownpropertydescriptors "^2.0.3"
 
-util@^0.12.0:
-  version "0.12.3"
-  resolved "https://registry.yarnpkg.com/util/-/util-0.12.3.tgz#971bb0292d2cc0c892dab7c6a5d37c2bec707888"
-  integrity sha512-I8XkoQwE+fPQEhy9v012V+TSdH2kp9ts29i20TaaDUXsg7x/onePbhFJUExBfv/2ay1ZOp/Vsm3nDlmnFGSAog==
-  dependencies:
-    inherits "^2.0.3"
-    is-arguments "^1.0.4"
-    is-generator-function "^1.0.7"
-    is-typed-array "^1.1.3"
-    safe-buffer "^5.1.2"
-    which-typed-array "^1.1.2"
-
-uuid@^3.0.1, uuid@^3.3.2, uuid@^3.3.3:
+uuid@^3.0.1, uuid@^3.3.2:
   version "3.4.0"
   resolved "https://registry.yarnpkg.com/uuid/-/uuid-3.4.0.tgz#b23e4358afa8a202fe7a100af1f5f883f02007ee"
   integrity sha512-HjSDRw6gZE5JMggctHBcjVak08+KEVhSIiDzFnT9S9aegmp85S/bReBVTb4QTFaRNptJ9kuYaNhnbNEOkbKb/A==
@@ -12108,18 +10688,13 @@ wide-align@^1.1.0:
   dependencies:
     string-width "^1.0.2 || 2"
 
-wif@^2.0.1, wif@^2.0.6:
+wif@2.0.6, wif@^2.0.1:
   version "2.0.6"
   resolved "https://registry.yarnpkg.com/wif/-/wif-2.0.6.tgz#08d3f52056c66679299726fade0d432ae74b4704"
   integrity sha1-CNP1IFbGZnkplyb63g1DKudLRwQ=
   dependencies:
     bs58check "<3.0.0"
 
-wildcard@^1.1.0:
-  version "1.1.2"
-  resolved "https://registry.yarnpkg.com/wildcard/-/wildcard-1.1.2.tgz#a7020453084d8cd2efe70ba9d3696263de1710a5"
-  integrity sha1-pwIEUwhNjNLv5wup02liY94XEKU=
-
 windows-release@^3.1.0:
   version "3.3.3"
   resolved "https://registry.yarnpkg.com/windows-release/-/windows-release-3.3.3.tgz#1c10027c7225743eec6b89df160d64c2e0293999"
@@ -12132,11 +10707,6 @@ word-wrap@^1.2.5:
   resolved "https://registry.yarnpkg.com/word-wrap/-/word-wrap-1.2.5.tgz#d2c45c6dd4fbce621a66f136cbe328afd0410b34"
   integrity sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==
 
-word-wrap@~1.2.3:
-  version "1.2.3"
-  resolved "https://registry.yarnpkg.com/word-wrap/-/word-wrap-1.2.3.tgz#610636f6b1f703891bd34771ccb17fb93b47079c"
-  integrity sha512-Hz/mrNwitNRh/HUAtM/VT/5VH+ygD6DV7mYKZAtHOrbs8U7lvPS6xf7EJKMF0uW1KJCl0H701g3ZGus+muE5vQ==
-
 wordwrap@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/wordwrap/-/wordwrap-1.0.0.tgz#27584810891456a4171c8d0226441ade90cbcaeb"
@@ -12151,15 +10721,6 @@ wrap-ansi@^5.1.0:
     string-width "^3.0.0"
     strip-ansi "^5.0.0"
 
-wrap-ansi@^6.2.0:
-  version "6.2.0"
-  resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-6.2.0.tgz#e9393ba07102e6c91a3b221478f0257cd2856e53"
-  integrity sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA==
-  dependencies:
-    ansi-styles "^4.0.0"
-    string-width "^4.1.0"
-    strip-ansi "^6.0.0"
-
 wrap-ansi@^7.0.0:
   version "7.0.0"
   resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43"
@@ -12233,41 +10794,17 @@ write-pkg@^3.1.0:
     sort-keys "^2.0.0"
     write-json-file "^2.2.0"
 
-write@^0.2.1:
-  version "0.2.1"
-  resolved "https://registry.yarnpkg.com/write/-/write-0.2.1.tgz#5fc03828e264cea3fe91455476f7a3c566cb0757"
-  integrity sha1-X8A4KOJkzqP+kUVUdvejxWbLB1c=
-  dependencies:
-    mkdirp "^0.5.1"
-
-ws@^7.1.2:
-  version "7.3.1"
-  resolved "https://registry.yarnpkg.com/ws/-/ws-7.3.1.tgz#d0547bf67f7ce4f12a72dfe31262c68d7dc551c8"
-  integrity sha512-D3RuNkynyHmEJIpD2qrgVkc9DQ23OrN/moAwZX4L8DfvszsJxpjQuUq3LMx6HoYji9fbIOBY18XWBsAux1ZZUA==
-
 ws@^7.5.2:
   version "7.5.9"
   resolved "https://registry.yarnpkg.com/ws/-/ws-7.5.9.tgz#54fa7db29f4c7cec68b1ddd3a89de099942bb591"
   integrity sha512-F+P9Jil7UiSKSkppIiD94dN07AwvFixvLIj1Og1Rl9GGMuNipJnV9JzjD6XuqmAeiswGvUmNLjr5cFuXwNS77Q==
 
-ws@~6.1.0:
-  version "6.1.4"
-  resolved "https://registry.yarnpkg.com/ws/-/ws-6.1.4.tgz#5b5c8800afab925e94ccb29d153c8d02c1776ef9"
-  integrity sha512-eqZfL+NE/YQc1/ZynhojeV8q+H050oR8AZ2uIev7RU10svA9ZnJUddHcOUZTJLinZ9yEfdA2kSATS2qZK5fhJA==
-  dependencies:
-    async-limiter "~1.0.0"
-
 xdg-basedir@^4.0.0:
   version "4.0.0"
   resolved "https://registry.yarnpkg.com/xdg-basedir/-/xdg-basedir-4.0.0.tgz#4bc8d9984403696225ef83a1573cbbcb4e79db13"
   integrity sha512-PSNhEJDejZYV7h50BohL09Er9VaIefr2LMAf3OEmpCkjOi34eYyQYAXUTjEQtZJTKcF0E2UKTh+osDLsgNim9Q==
 
-xmlhttprequest-ssl@~1.5.4:
-  version "1.5.5"
-  resolved "https://registry.yarnpkg.com/xmlhttprequest-ssl/-/xmlhttprequest-ssl-1.5.5.tgz#c2876b06168aadc40e57d97e81191ac8f4398b3e"
-  integrity sha1-wodrBhaKrcQOV9l+gRkayPQ5iz4=
-
-xtend@^4.0.1, xtend@~4.0.1:
+xtend@~4.0.1:
   version "4.0.2"
   resolved "https://registry.yarnpkg.com/xtend/-/xtend-4.0.2.tgz#bb72779f5fa465186b1f438f674fa347fdb5db54"
   integrity sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==
@@ -12282,11 +10819,6 @@ y18n@^5.0.5:
   resolved "https://registry.yarnpkg.com/y18n/-/y18n-5.0.8.tgz#7f4934d0f7ca8c56f95314939ddcd2dd91ce1d55"
   integrity sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==
 
-yallist@^2.1.2:
-  version "2.1.2"
-  resolved "https://registry.yarnpkg.com/yallist/-/yallist-2.1.2.tgz#1c11f9218f076089a47dd512f93c6699a6a81d52"
-  integrity sha1-HBH5IY8HYImkfdUS+TxmmaaoHVI=
-
 yallist@^3.0.0, yallist@^3.0.2, yallist@^3.0.3:
   version "3.1.1"
   resolved "https://registry.yarnpkg.com/yallist/-/yallist-3.1.1.tgz#dbb7daf9bfd8bac9ab45ebf602b8cbad0d5d08fd"
@@ -12302,14 +10834,6 @@ yaml@^1.10.0:
   resolved "https://registry.yarnpkg.com/yaml/-/yaml-1.10.0.tgz#3b593add944876077d4d683fee01081bd9fff31e"
   integrity sha512-yr2icI4glYaNG+KWONODapy2/jDdMSDnrONSjblABjD9B4Z5LgiircSt8m8sRZFNi08kG9Sm0uSHtEmP3zaEGg==
 
-yargs-parser@^13.1.2:
-  version "13.1.2"
-  resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-13.1.2.tgz#130f09702ebaeef2650d54ce6e3e5706f7a4fb38"
-  integrity sha512-3lbsNRf/j+A4QuSZfDRA7HRSfWrzO0YjqTJd5kjAq37Zep1CEgaYmrH9Q3GwPiB9cHyd1Y1UwggGhJGoxipbzg==
-  dependencies:
-    camelcase "^5.0.0"
-    decamelize "^1.2.0"
-
 yargs-parser@^15.0.1:
   version "15.0.1"
   resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-15.0.1.tgz#54786af40b820dcb2fb8025b11b4d659d76323b3"
@@ -12318,7 +10842,7 @@ yargs-parser@^15.0.1:
     camelcase "^5.0.0"
     decamelize "^1.2.0"
 
-yargs-parser@^18.1.2, yargs-parser@^18.1.3:
+yargs-parser@^18.1.3:
   version "18.1.3"
   resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-18.1.3.tgz#be68c4975c6b2abf469236b0c870362fab09a7b0"
   integrity sha512-o50j0JeToy/4K6OZcaQmW6lyXXKhq7csREXcDwk2omFPJEwUNOVtJKvmDr9EI1fAJZUyZcRF7kxGBWmRXudrCQ==
@@ -12336,22 +10860,6 @@ yargs-parser@^21.1.1:
   resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-21.1.1.tgz#9096bceebf990d21bb31fa9516e0ede294a77d35"
   integrity sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==
 
-yargs@^13.2.4:
-  version "13.3.2"
-  resolved "https://registry.yarnpkg.com/yargs/-/yargs-13.3.2.tgz#ad7ffefec1aa59565ac915f82dccb38a9c31a2dd"
-  integrity sha512-AX3Zw5iPruN5ie6xGRIDgqkT+ZhnRlZMLMHAs8tg7nRruy2Nb+i5o9bwghAogtM08q1dpr2LVoS8KSTMYpWXUw==
-  dependencies:
-    cliui "^5.0.0"
-    find-up "^3.0.0"
-    get-caller-file "^2.0.1"
-    require-directory "^2.1.1"
-    require-main-filename "^2.0.0"
-    set-blocking "^2.0.0"
-    string-width "^3.0.0"
-    which-module "^2.0.0"
-    y18n "^4.0.0"
-    yargs-parser "^13.1.2"
-
 yargs@^14.2.2:
   version "14.2.3"
   resolved "https://registry.yarnpkg.com/yargs/-/yargs-14.2.3.tgz#1a1c3edced1afb2a2fea33604bc6d1d8d688a414"
@@ -12369,23 +10877,6 @@ yargs@^14.2.2:
     y18n "^4.0.0"
     yargs-parser "^15.0.1"
 
-yargs@^15.0.2:
-  version "15.4.1"
-  resolved "https://registry.yarnpkg.com/yargs/-/yargs-15.4.1.tgz#0d87a16de01aee9d8bec2bfbf74f67851730f4f8"
-  integrity sha512-aePbxDmcYW++PaqBsJ+HYUFwCdv4LVvdnhBy78E57PIor8/OVvhMrADFFEDh8DHDFRv/O9i3lPhsENjO7QX0+A==
-  dependencies:
-    cliui "^6.0.0"
-    decamelize "^1.2.0"
-    find-up "^4.1.0"
-    get-caller-file "^2.0.1"
-    require-directory "^2.1.1"
-    require-main-filename "^2.0.0"
-    set-blocking "^2.0.0"
-    string-width "^4.2.0"
-    which-module "^2.0.0"
-    y18n "^4.0.0"
-    yargs-parser "^18.1.2"
-
 yargs@^17.3.1:
   version "17.6.2"
   resolved "https://registry.yarnpkg.com/yargs/-/yargs-17.6.2.tgz#2e23f2944e976339a1ee00f18c77fedee8332541"
@@ -12399,11 +10890,6 @@ yargs@^17.3.1:
     y18n "^5.0.5"
     yargs-parser "^21.1.1"
 
-yeast@0.1.2:
-  version "0.1.2"
-  resolved "https://registry.yarnpkg.com/yeast/-/yeast-0.1.2.tgz#008e06d8094320c372dbc2f8ed76a0ca6c8ac419"
-  integrity sha1-AI4G2AlDIMNy28L47XagymyKxBk=
-
 yocto-queue@^0.1.0:
   version "0.1.0"
   resolved "https://registry.yarnpkg.com/yocto-queue/-/yocto-queue-0.1.0.tgz#0294eb3dee05028d31ee1a5fa2c556a6aaf10a1b"

From 28a65439b5406a428a34962b507055ca4c245067 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 4 Nov 2024 09:09:01 +0100
Subject: [PATCH 147/267] Fix scientific notation for number literals

---
 packages/cashc/src/ast/AstBuilder.ts          | 10 +++++++-
 .../incorrect_scientific_notation.cash        |  5 ++++
 packages/cashc/test/generation/fixtures.ts    | 23 +++++++++++++++++++
 .../integer_formatting.cash                   | 12 ++++++++++
 4 files changed, 49 insertions(+), 1 deletion(-)
 create mode 100644 packages/cashc/test/compiler/ParseError/incorrect_scientific_notation.cash
 create mode 100644 packages/cashc/test/valid-contract-files/integer_formatting.cash

diff --git a/packages/cashc/src/ast/AstBuilder.ts b/packages/cashc/src/ast/AstBuilder.ts
index a3510267..7e92f12c 100644
--- a/packages/cashc/src/ast/AstBuilder.ts
+++ b/packages/cashc/src/ast/AstBuilder.ts
@@ -347,7 +347,7 @@ export default class AstBuilder
     const numberCtx = ctx.numberLiteral();
     const numberString = numberCtx.NumberLiteral().getText();
     const numberUnit = numberCtx.NumberUnit()?.getText();
-    const numberValue = BigInt(numberString) * BigInt(numberUnit ? NumberUnit[numberUnit.toUpperCase()] : 1);
+    const numberValue = parseNumberString(numberString) * BigInt(numberUnit ? NumberUnit[numberUnit.toUpperCase()] : 1);
     const intLiteral = new IntLiteralNode(numberValue);
     intLiteral.location = Location.fromCtx(ctx);
     return intLiteral;
@@ -411,3 +411,11 @@ export default class AstBuilder
     throw new Error('Safety Warning: Unhandled node in AST builder');
   }
 }
+
+const parseNumberString = (numberString: string): bigint => {
+  const isScientificNotation = /[eE]/.test(numberString);
+  if (!isScientificNotation) return BigInt(numberString);
+
+  const [coefficient, exponent] = numberString.split(/[eE]/);
+  return BigInt(coefficient) * BigInt(10) ** BigInt(exponent);
+};
diff --git a/packages/cashc/test/compiler/ParseError/incorrect_scientific_notation.cash b/packages/cashc/test/compiler/ParseError/incorrect_scientific_notation.cash
new file mode 100644
index 00000000..0e7436af
--- /dev/null
+++ b/packages/cashc/test/compiler/ParseError/incorrect_scientific_notation.cash
@@ -0,0 +1,5 @@
+contract Test() {
+    function hello() {
+        require(1000 == 1e-3);
+    }
+}
diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index d71f0720..882c095f 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -737,4 +737,27 @@ export const fixtures: Fixture[] = [
       updatedAt: '',
     },
   },
+  {
+    fn: 'integer_formatting.cash',
+    artifact: {
+      contractName: 'IntegerFormatting',
+      constructorInputs: [],
+      abi: [
+        { name: 'test', inputs: [] },
+      ],
+      bytecode: '00ca9a3b 00ca9a3b 00ca9a3b OP_ROT OP_OVER OP_NUMEQUALVERIFY OP_NUMEQUAL',
+      debug: {
+        bytecode: '0400ca9a3b0400ca9a3b0400ca9a3b527a51799c69517a517a9c',
+        logs: [],
+        requires: [{ ip: 8, line: 8 }, { ip: 14, line: 9 }],
+        sourceMap: '3:26:3:29;4::4;6:22:6:32;8:16:8:27;;:31::38;;:16:::1;:8::40;9:16:9:27:0;;:31::38;;:16:::1',
+      },
+      source: fs.readFileSync(new URL('../valid-contract-files/integer_formatting.cash', import.meta.url), { encoding: 'utf-8' }),
+      compiler: {
+        name: 'cashc',
+        version,
+      },
+      updatedAt: '',
+    },
+  },
 ];
diff --git a/packages/cashc/test/valid-contract-files/integer_formatting.cash b/packages/cashc/test/valid-contract-files/integer_formatting.cash
new file mode 100644
index 00000000..1ad05cc6
--- /dev/null
+++ b/packages/cashc/test/valid-contract-files/integer_formatting.cash
@@ -0,0 +1,12 @@
+contract IntegerFormatting() {
+    function test() {
+        int scientific1 = 1e9;
+        int scientific2 = 1E9;
+        // int underscores = 1_000_000_000;
+        int regular = 1000000000;
+
+        require(scientific1 == regular);
+        require(scientific2 == regular);
+        // require()
+    }
+}

From abca8b9f62b04012946e5fba140f92012d64d9db Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 4 Nov 2024 09:20:22 +0100
Subject: [PATCH 148/267] Allow underscores in number literals & update docs

---
 packages/cashc/src/ast/AstBuilder.ts          |   8 +-
 packages/cashc/src/grammar/CashScript.g4      |  10 +-
 packages/cashc/src/grammar/CashScript.interp  |   6 +-
 packages/cashc/src/grammar/CashScript.tokens  |  24 +-
 .../cashc/src/grammar/CashScriptLexer.interp  |   8 +-
 .../cashc/src/grammar/CashScriptLexer.tokens  |  24 +-
 packages/cashc/src/grammar/CashScriptLexer.ts | 551 +++++++++---------
 .../cashc/src/grammar/CashScriptParser.ts     |  88 +--
 .../incorrect_underscore_in_number_1.cash     |   5 +
 .../incorrect_underscore_in_number_2.cash     |   5 +
 .../incorrect_underscore_in_number_3.cash     |   5 +
 packages/cashc/test/generation/fixtures.ts    |   8 +-
 .../integer_formatting.cash                   |  13 +-
 website/docs/language/types.md                |   4 +
 14 files changed, 409 insertions(+), 350 deletions(-)
 create mode 100644 packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_1.cash
 create mode 100644 packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_2.cash
 create mode 100644 packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_3.cash

diff --git a/packages/cashc/src/ast/AstBuilder.ts b/packages/cashc/src/ast/AstBuilder.ts
index 7e92f12c..50d0083a 100644
--- a/packages/cashc/src/ast/AstBuilder.ts
+++ b/packages/cashc/src/ast/AstBuilder.ts
@@ -413,9 +413,11 @@ export default class AstBuilder
 }
 
 const parseNumberString = (numberString: string): bigint => {
-  const isScientificNotation = /[eE]/.test(numberString);
-  if (!isScientificNotation) return BigInt(numberString);
+  const cleanedNumberString = numberString.replace(/_/g, '');
 
-  const [coefficient, exponent] = numberString.split(/[eE]/);
+  const isScientificNotation = /[eE]/.test(cleanedNumberString);
+  if (!isScientificNotation) return BigInt(cleanedNumberString);
+
+  const [coefficient, exponent] = cleanedNumberString.split(/[eE]/);
   return BigInt(coefficient) * BigInt(10) ** BigInt(exponent);
 };
diff --git a/packages/cashc/src/grammar/CashScript.g4 b/packages/cashc/src/grammar/CashScript.g4
index bdbdbce6..eec1fb9f 100644
--- a/packages/cashc/src/grammar/CashScript.g4
+++ b/packages/cashc/src/grammar/CashScript.g4
@@ -165,7 +165,15 @@ NumberUnit
     ;
 
 NumberLiteral
-    : [-]?[0-9]+ ([eE] [0-9]+)?
+    : '-'? NumberPart ExponentPart?
+    ;
+
+NumberPart
+    : [0-9]+ ('_' [0-9]+)*
+    ;
+
+ExponentPart
+    : [eE] NumberPart
     ;
 
 Bytes
diff --git a/packages/cashc/src/grammar/CashScript.interp b/packages/cashc/src/grammar/CashScript.interp
index 97221ccb..2fd3ea96 100644
--- a/packages/cashc/src/grammar/CashScript.interp
+++ b/packages/cashc/src/grammar/CashScript.interp
@@ -72,6 +72,8 @@ null
 null
 null
 null
+null
+null
 
 token symbolic names:
 null
@@ -136,6 +138,8 @@ VersionLiteral
 BooleanLiteral
 NumberUnit
 NumberLiteral
+NumberPart
+ExponentPart
 Bytes
 Bound
 StringLiteral
@@ -181,4 +185,4 @@ typeName
 
 
 atn:
-[4, 1, 72, 365, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 2, 25, 7, 25, 2, 26, 7, 26, 2, 27, 7, 27, 2, 28, 7, 28, 1, 0, 5, 0, 60, 8, 0, 10, 0, 12, 0, 63, 9, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 1, 2, 1, 3, 1, 3, 3, 3, 77, 8, 3, 1, 4, 3, 4, 80, 8, 4, 1, 4, 1, 4, 1, 5, 1, 5, 1, 6, 1, 6, 1, 6, 1, 6, 1, 6, 5, 6, 91, 8, 6, 10, 6, 12, 6, 94, 9, 6, 1, 6, 1, 6, 1, 7, 1, 7, 1, 7, 1, 7, 1, 7, 5, 7, 103, 8, 7, 10, 7, 12, 7, 106, 9, 7, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 8, 5, 8, 114, 8, 8, 10, 8, 12, 8, 117, 9, 8, 1, 8, 3, 8, 120, 8, 8, 3, 8, 122, 8, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 9, 1, 10, 1, 10, 5, 10, 131, 8, 10, 10, 10, 12, 10, 134, 9, 10, 1, 10, 1, 10, 3, 10, 138, 8, 10, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 3, 11, 147, 8, 11, 1, 12, 1, 12, 5, 12, 151, 8, 12, 10, 12, 12, 12, 154, 9, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 14, 1, 14, 1, 14, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 3, 15, 182, 8, 15, 1, 15, 1, 15, 1, 15, 1, 16, 1, 16, 1, 16, 1, 16, 1, 16, 3, 16, 192, 8, 16, 1, 16, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 3, 17, 204, 8, 17, 1, 18, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 20, 1, 20, 3, 20, 214, 8, 20, 1, 21, 1, 21, 1, 21, 1, 21, 5, 21, 220, 8, 21, 10, 21, 12, 21, 223, 9, 21, 1, 21, 3, 21, 226, 8, 21, 3, 21, 228, 8, 21, 1, 21, 1, 21, 1, 22, 1, 22, 1, 22, 1, 23, 1, 23, 1, 23, 1, 23, 5, 23, 239, 8, 23, 10, 23, 12, 23, 242, 9, 23, 1, 23, 3, 23, 245, 8, 23, 3, 23, 247, 8, 23, 1, 23, 1, 23, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 3, 24, 261, 8, 24, 1, 24, 3, 24, 264, 8, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 5, 24, 290, 8, 24, 10, 24, 12, 24, 293, 9, 24, 1, 24, 3, 24, 296, 8, 24, 3, 24, 298, 8, 24, 1, 24, 1, 24, 1, 24, 1, 24, 3, 24, 304, 8, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 5, 24, 345, 8, 24, 10, 24, 12, 24, 348, 9, 24, 1, 25, 1, 25, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 3, 26, 357, 8, 26, 1, 27, 1, 27, 3, 27, 361, 8, 27, 1, 28, 1, 28, 1, 28, 0, 1, 48, 29, 0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, 52, 54, 56, 0, 10, 1, 0, 4, 10, 1, 0, 26, 30, 2, 0, 26, 30, 32, 35, 1, 0, 39, 40, 1, 0, 41, 43, 2, 0, 40, 40, 44, 44, 1, 0, 6, 9, 1, 0, 45, 46, 1, 0, 36, 37, 2, 0, 52, 57, 62, 62, 394, 0, 61, 1, 0, 0, 0, 2, 67, 1, 0, 0, 0, 4, 72, 1, 0, 0, 0, 6, 74, 1, 0, 0, 0, 8, 79, 1, 0, 0, 0, 10, 83, 1, 0, 0, 0, 12, 85, 1, 0, 0, 0, 14, 97, 1, 0, 0, 0, 16, 109, 1, 0, 0, 0, 18, 125, 1, 0, 0, 0, 20, 137, 1, 0, 0, 0, 22, 146, 1, 0, 0, 0, 24, 148, 1, 0, 0, 0, 26, 160, 1, 0, 0, 0, 28, 169, 1, 0, 0, 0, 30, 174, 1, 0, 0, 0, 32, 186, 1, 0, 0, 0, 34, 196, 1, 0, 0, 0, 36, 205, 1, 0, 0, 0, 38, 209, 1, 0, 0, 0, 40, 213, 1, 0, 0, 0, 42, 215, 1, 0, 0, 0, 44, 231, 1, 0, 0, 0, 46, 234, 1, 0, 0, 0, 48, 303, 1, 0, 0, 0, 50, 349, 1, 0, 0, 0, 52, 356, 1, 0, 0, 0, 54, 358, 1, 0, 0, 0, 56, 362, 1, 0, 0, 0, 58, 60, 3, 2, 1, 0, 59, 58, 1, 0, 0, 0, 60, 63, 1, 0, 0, 0, 61, 59, 1, 0, 0, 0, 61, 62, 1, 0, 0, 0, 62, 64, 1, 0, 0, 0, 63, 61, 1, 0, 0, 0, 64, 65, 3, 12, 6, 0, 65, 66, 5, 0, 0, 1, 66, 1, 1, 0, 0, 0, 67, 68, 5, 1, 0, 0, 68, 69, 3, 4, 2, 0, 69, 70, 3, 6, 3, 0, 70, 71, 5, 2, 0, 0, 71, 3, 1, 0, 0, 0, 72, 73, 5, 3, 0, 0, 73, 5, 1, 0, 0, 0, 74, 76, 3, 8, 4, 0, 75, 77, 3, 8, 4, 0, 76, 75, 1, 0, 0, 0, 76, 77, 1, 0, 0, 0, 77, 7, 1, 0, 0, 0, 78, 80, 3, 10, 5, 0, 79, 78, 1, 0, 0, 0, 79, 80, 1, 0, 0, 0, 80, 81, 1, 0, 0, 0, 81, 82, 5, 58, 0, 0, 82, 9, 1, 0, 0, 0, 83, 84, 7, 0, 0, 0, 84, 11, 1, 0, 0, 0, 85, 86, 5, 11, 0, 0, 86, 87, 5, 69, 0, 0, 87, 88, 3, 16, 8, 0, 88, 92, 5, 12, 0, 0, 89, 91, 3, 14, 7, 0, 90, 89, 1, 0, 0, 0, 91, 94, 1, 0, 0, 0, 92, 90, 1, 0, 0, 0, 92, 93, 1, 0, 0, 0, 93, 95, 1, 0, 0, 0, 94, 92, 1, 0, 0, 0, 95, 96, 5, 13, 0, 0, 96, 13, 1, 0, 0, 0, 97, 98, 5, 14, 0, 0, 98, 99, 5, 69, 0, 0, 99, 100, 3, 16, 8, 0, 100, 104, 5, 12, 0, 0, 101, 103, 3, 22, 11, 0, 102, 101, 1, 0, 0, 0, 103, 106, 1, 0, 0, 0, 104, 102, 1, 0, 0, 0, 104, 105, 1, 0, 0, 0, 105, 107, 1, 0, 0, 0, 106, 104, 1, 0, 0, 0, 107, 108, 5, 13, 0, 0, 108, 15, 1, 0, 0, 0, 109, 121, 5, 15, 0, 0, 110, 115, 3, 18, 9, 0, 111, 112, 5, 16, 0, 0, 112, 114, 3, 18, 9, 0, 113, 111, 1, 0, 0, 0, 114, 117, 1, 0, 0, 0, 115, 113, 1, 0, 0, 0, 115, 116, 1, 0, 0, 0, 116, 119, 1, 0, 0, 0, 117, 115, 1, 0, 0, 0, 118, 120, 5, 16, 0, 0, 119, 118, 1, 0, 0, 0, 119, 120, 1, 0, 0, 0, 120, 122, 1, 0, 0, 0, 121, 110, 1, 0, 0, 0, 121, 122, 1, 0, 0, 0, 122, 123, 1, 0, 0, 0, 123, 124, 5, 17, 0, 0, 124, 17, 1, 0, 0, 0, 125, 126, 3, 56, 28, 0, 126, 127, 5, 69, 0, 0, 127, 19, 1, 0, 0, 0, 128, 132, 5, 12, 0, 0, 129, 131, 3, 22, 11, 0, 130, 129, 1, 0, 0, 0, 131, 134, 1, 0, 0, 0, 132, 130, 1, 0, 0, 0, 132, 133, 1, 0, 0, 0, 133, 135, 1, 0, 0, 0, 134, 132, 1, 0, 0, 0, 135, 138, 5, 13, 0, 0, 136, 138, 3, 22, 11, 0, 137, 128, 1, 0, 0, 0, 137, 136, 1, 0, 0, 0, 138, 21, 1, 0, 0, 0, 139, 147, 3, 24, 12, 0, 140, 147, 3, 26, 13, 0, 141, 147, 3, 28, 14, 0, 142, 147, 3, 30, 15, 0, 143, 147, 3, 32, 16, 0, 144, 147, 3, 34, 17, 0, 145, 147, 3, 36, 18, 0, 146, 139, 1, 0, 0, 0, 146, 140, 1, 0, 0, 0, 146, 141, 1, 0, 0, 0, 146, 142, 1, 0, 0, 0, 146, 143, 1, 0, 0, 0, 146, 144, 1, 0, 0, 0, 146, 145, 1, 0, 0, 0, 147, 23, 1, 0, 0, 0, 148, 152, 3, 56, 28, 0, 149, 151, 3, 50, 25, 0, 150, 149, 1, 0, 0, 0, 151, 154, 1, 0, 0, 0, 152, 150, 1, 0, 0, 0, 152, 153, 1, 0, 0, 0, 153, 155, 1, 0, 0, 0, 154, 152, 1, 0, 0, 0, 155, 156, 5, 69, 0, 0, 156, 157, 5, 10, 0, 0, 157, 158, 3, 48, 24, 0, 158, 159, 5, 2, 0, 0, 159, 25, 1, 0, 0, 0, 160, 161, 3, 56, 28, 0, 161, 162, 5, 69, 0, 0, 162, 163, 5, 16, 0, 0, 163, 164, 3, 56, 28, 0, 164, 165, 5, 69, 0, 0, 165, 166, 5, 10, 0, 0, 166, 167, 3, 48, 24, 0, 167, 168, 5, 2, 0, 0, 168, 27, 1, 0, 0, 0, 169, 170, 5, 69, 0, 0, 170, 171, 5, 10, 0, 0, 171, 172, 3, 48, 24, 0, 172, 173, 5, 2, 0, 0, 173, 29, 1, 0, 0, 0, 174, 175, 5, 18, 0, 0, 175, 176, 5, 15, 0, 0, 176, 177, 5, 67, 0, 0, 177, 178, 5, 6, 0, 0, 178, 181, 3, 48, 24, 0, 179, 180, 5, 16, 0, 0, 180, 182, 3, 38, 19, 0, 181, 179, 1, 0, 0, 0, 181, 182, 1, 0, 0, 0, 182, 183, 1, 0, 0, 0, 183, 184, 5, 17, 0, 0, 184, 185, 5, 2, 0, 0, 185, 31, 1, 0, 0, 0, 186, 187, 5, 18, 0, 0, 187, 188, 5, 15, 0, 0, 188, 191, 3, 48, 24, 0, 189, 190, 5, 16, 0, 0, 190, 192, 3, 38, 19, 0, 191, 189, 1, 0, 0, 0, 191, 192, 1, 0, 0, 0, 192, 193, 1, 0, 0, 0, 193, 194, 5, 17, 0, 0, 194, 195, 5, 2, 0, 0, 195, 33, 1, 0, 0, 0, 196, 197, 5, 19, 0, 0, 197, 198, 5, 15, 0, 0, 198, 199, 3, 48, 24, 0, 199, 200, 5, 17, 0, 0, 200, 203, 3, 20, 10, 0, 201, 202, 5, 20, 0, 0, 202, 204, 3, 20, 10, 0, 203, 201, 1, 0, 0, 0, 203, 204, 1, 0, 0, 0, 204, 35, 1, 0, 0, 0, 205, 206, 5, 21, 0, 0, 206, 207, 3, 42, 21, 0, 207, 208, 5, 2, 0, 0, 208, 37, 1, 0, 0, 0, 209, 210, 5, 64, 0, 0, 210, 39, 1, 0, 0, 0, 211, 214, 5, 69, 0, 0, 212, 214, 3, 52, 26, 0, 213, 211, 1, 0, 0, 0, 213, 212, 1, 0, 0, 0, 214, 41, 1, 0, 0, 0, 215, 227, 5, 15, 0, 0, 216, 221, 3, 40, 20, 0, 217, 218, 5, 16, 0, 0, 218, 220, 3, 40, 20, 0, 219, 217, 1, 0, 0, 0, 220, 223, 1, 0, 0, 0, 221, 219, 1, 0, 0, 0, 221, 222, 1, 0, 0, 0, 222, 225, 1, 0, 0, 0, 223, 221, 1, 0, 0, 0, 224, 226, 5, 16, 0, 0, 225, 224, 1, 0, 0, 0, 225, 226, 1, 0, 0, 0, 226, 228, 1, 0, 0, 0, 227, 216, 1, 0, 0, 0, 227, 228, 1, 0, 0, 0, 228, 229, 1, 0, 0, 0, 229, 230, 5, 17, 0, 0, 230, 43, 1, 0, 0, 0, 231, 232, 5, 69, 0, 0, 232, 233, 3, 46, 23, 0, 233, 45, 1, 0, 0, 0, 234, 246, 5, 15, 0, 0, 235, 240, 3, 48, 24, 0, 236, 237, 5, 16, 0, 0, 237, 239, 3, 48, 24, 0, 238, 236, 1, 0, 0, 0, 239, 242, 1, 0, 0, 0, 240, 238, 1, 0, 0, 0, 240, 241, 1, 0, 0, 0, 241, 244, 1, 0, 0, 0, 242, 240, 1, 0, 0, 0, 243, 245, 5, 16, 0, 0, 244, 243, 1, 0, 0, 0, 244, 245, 1, 0, 0, 0, 245, 247, 1, 0, 0, 0, 246, 235, 1, 0, 0, 0, 246, 247, 1, 0, 0, 0, 247, 248, 1, 0, 0, 0, 248, 249, 5, 17, 0, 0, 249, 47, 1, 0, 0, 0, 250, 251, 6, 24, -1, 0, 251, 252, 5, 15, 0, 0, 252, 253, 3, 48, 24, 0, 253, 254, 5, 17, 0, 0, 254, 304, 1, 0, 0, 0, 255, 256, 3, 56, 28, 0, 256, 257, 5, 15, 0, 0, 257, 260, 3, 48, 24, 0, 258, 259, 5, 16, 0, 0, 259, 261, 3, 48, 24, 0, 260, 258, 1, 0, 0, 0, 260, 261, 1, 0, 0, 0, 261, 263, 1, 0, 0, 0, 262, 264, 5, 16, 0, 0, 263, 262, 1, 0, 0, 0, 263, 264, 1, 0, 0, 0, 264, 265, 1, 0, 0, 0, 265, 266, 5, 17, 0, 0, 266, 304, 1, 0, 0, 0, 267, 304, 3, 44, 22, 0, 268, 269, 5, 22, 0, 0, 269, 270, 5, 69, 0, 0, 270, 304, 3, 46, 23, 0, 271, 272, 5, 25, 0, 0, 272, 273, 5, 23, 0, 0, 273, 274, 3, 48, 24, 0, 274, 275, 5, 24, 0, 0, 275, 276, 7, 1, 0, 0, 276, 304, 1, 0, 0, 0, 277, 278, 5, 31, 0, 0, 278, 279, 5, 23, 0, 0, 279, 280, 3, 48, 24, 0, 280, 281, 5, 24, 0, 0, 281, 282, 7, 2, 0, 0, 282, 304, 1, 0, 0, 0, 283, 284, 7, 3, 0, 0, 284, 304, 3, 48, 24, 14, 285, 297, 5, 23, 0, 0, 286, 291, 3, 48, 24, 0, 287, 288, 5, 16, 0, 0, 288, 290, 3, 48, 24, 0, 289, 287, 1, 0, 0, 0, 290, 293, 1, 0, 0, 0, 291, 289, 1, 0, 0, 0, 291, 292, 1, 0, 0, 0, 292, 295, 1, 0, 0, 0, 293, 291, 1, 0, 0, 0, 294, 296, 5, 16, 0, 0, 295, 294, 1, 0, 0, 0, 295, 296, 1, 0, 0, 0, 296, 298, 1, 0, 0, 0, 297, 286, 1, 0, 0, 0, 297, 298, 1, 0, 0, 0, 298, 299, 1, 0, 0, 0, 299, 304, 5, 24, 0, 0, 300, 304, 5, 68, 0, 0, 301, 304, 5, 69, 0, 0, 302, 304, 3, 52, 26, 0, 303, 250, 1, 0, 0, 0, 303, 255, 1, 0, 0, 0, 303, 267, 1, 0, 0, 0, 303, 268, 1, 0, 0, 0, 303, 271, 1, 0, 0, 0, 303, 277, 1, 0, 0, 0, 303, 283, 1, 0, 0, 0, 303, 285, 1, 0, 0, 0, 303, 300, 1, 0, 0, 0, 303, 301, 1, 0, 0, 0, 303, 302, 1, 0, 0, 0, 304, 346, 1, 0, 0, 0, 305, 306, 10, 13, 0, 0, 306, 307, 7, 4, 0, 0, 307, 345, 3, 48, 24, 14, 308, 309, 10, 12, 0, 0, 309, 310, 7, 5, 0, 0, 310, 345, 3, 48, 24, 13, 311, 312, 10, 11, 0, 0, 312, 313, 7, 6, 0, 0, 313, 345, 3, 48, 24, 12, 314, 315, 10, 10, 0, 0, 315, 316, 7, 7, 0, 0, 316, 345, 3, 48, 24, 11, 317, 318, 10, 9, 0, 0, 318, 319, 5, 47, 0, 0, 319, 345, 3, 48, 24, 10, 320, 321, 10, 8, 0, 0, 321, 322, 5, 4, 0, 0, 322, 345, 3, 48, 24, 9, 323, 324, 10, 7, 0, 0, 324, 325, 5, 48, 0, 0, 325, 345, 3, 48, 24, 8, 326, 327, 10, 6, 0, 0, 327, 328, 5, 49, 0, 0, 328, 345, 3, 48, 24, 7, 329, 330, 10, 5, 0, 0, 330, 331, 5, 50, 0, 0, 331, 345, 3, 48, 24, 6, 332, 333, 10, 19, 0, 0, 333, 334, 5, 23, 0, 0, 334, 335, 5, 61, 0, 0, 335, 345, 5, 24, 0, 0, 336, 337, 10, 16, 0, 0, 337, 345, 7, 8, 0, 0, 338, 339, 10, 15, 0, 0, 339, 340, 5, 38, 0, 0, 340, 341, 5, 15, 0, 0, 341, 342, 3, 48, 24, 0, 342, 343, 5, 17, 0, 0, 343, 345, 1, 0, 0, 0, 344, 305, 1, 0, 0, 0, 344, 308, 1, 0, 0, 0, 344, 311, 1, 0, 0, 0, 344, 314, 1, 0, 0, 0, 344, 317, 1, 0, 0, 0, 344, 320, 1, 0, 0, 0, 344, 323, 1, 0, 0, 0, 344, 326, 1, 0, 0, 0, 344, 329, 1, 0, 0, 0, 344, 332, 1, 0, 0, 0, 344, 336, 1, 0, 0, 0, 344, 338, 1, 0, 0, 0, 345, 348, 1, 0, 0, 0, 346, 344, 1, 0, 0, 0, 346, 347, 1, 0, 0, 0, 347, 49, 1, 0, 0, 0, 348, 346, 1, 0, 0, 0, 349, 350, 5, 51, 0, 0, 350, 51, 1, 0, 0, 0, 351, 357, 5, 59, 0, 0, 352, 357, 3, 54, 27, 0, 353, 357, 5, 64, 0, 0, 354, 357, 5, 65, 0, 0, 355, 357, 5, 66, 0, 0, 356, 351, 1, 0, 0, 0, 356, 352, 1, 0, 0, 0, 356, 353, 1, 0, 0, 0, 356, 354, 1, 0, 0, 0, 356, 355, 1, 0, 0, 0, 357, 53, 1, 0, 0, 0, 358, 360, 5, 61, 0, 0, 359, 361, 5, 60, 0, 0, 360, 359, 1, 0, 0, 0, 360, 361, 1, 0, 0, 0, 361, 55, 1, 0, 0, 0, 362, 363, 7, 9, 0, 0, 363, 57, 1, 0, 0, 0, 32, 61, 76, 79, 92, 104, 115, 119, 121, 132, 137, 146, 152, 181, 191, 203, 213, 221, 225, 227, 240, 244, 246, 260, 263, 291, 295, 297, 303, 344, 346, 356, 360]
\ No newline at end of file
+[4, 1, 74, 365, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 2, 25, 7, 25, 2, 26, 7, 26, 2, 27, 7, 27, 2, 28, 7, 28, 1, 0, 5, 0, 60, 8, 0, 10, 0, 12, 0, 63, 9, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 1, 2, 1, 3, 1, 3, 3, 3, 77, 8, 3, 1, 4, 3, 4, 80, 8, 4, 1, 4, 1, 4, 1, 5, 1, 5, 1, 6, 1, 6, 1, 6, 1, 6, 1, 6, 5, 6, 91, 8, 6, 10, 6, 12, 6, 94, 9, 6, 1, 6, 1, 6, 1, 7, 1, 7, 1, 7, 1, 7, 1, 7, 5, 7, 103, 8, 7, 10, 7, 12, 7, 106, 9, 7, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 8, 5, 8, 114, 8, 8, 10, 8, 12, 8, 117, 9, 8, 1, 8, 3, 8, 120, 8, 8, 3, 8, 122, 8, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 9, 1, 10, 1, 10, 5, 10, 131, 8, 10, 10, 10, 12, 10, 134, 9, 10, 1, 10, 1, 10, 3, 10, 138, 8, 10, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 1, 11, 3, 11, 147, 8, 11, 1, 12, 1, 12, 5, 12, 151, 8, 12, 10, 12, 12, 12, 154, 9, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 14, 1, 14, 1, 14, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 1, 15, 3, 15, 182, 8, 15, 1, 15, 1, 15, 1, 15, 1, 16, 1, 16, 1, 16, 1, 16, 1, 16, 3, 16, 192, 8, 16, 1, 16, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 3, 17, 204, 8, 17, 1, 18, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 20, 1, 20, 3, 20, 214, 8, 20, 1, 21, 1, 21, 1, 21, 1, 21, 5, 21, 220, 8, 21, 10, 21, 12, 21, 223, 9, 21, 1, 21, 3, 21, 226, 8, 21, 3, 21, 228, 8, 21, 1, 21, 1, 21, 1, 22, 1, 22, 1, 22, 1, 23, 1, 23, 1, 23, 1, 23, 5, 23, 239, 8, 23, 10, 23, 12, 23, 242, 9, 23, 1, 23, 3, 23, 245, 8, 23, 3, 23, 247, 8, 23, 1, 23, 1, 23, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 3, 24, 261, 8, 24, 1, 24, 3, 24, 264, 8, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 5, 24, 290, 8, 24, 10, 24, 12, 24, 293, 9, 24, 1, 24, 3, 24, 296, 8, 24, 3, 24, 298, 8, 24, 1, 24, 1, 24, 1, 24, 1, 24, 3, 24, 304, 8, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 5, 24, 345, 8, 24, 10, 24, 12, 24, 348, 9, 24, 1, 25, 1, 25, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 3, 26, 357, 8, 26, 1, 27, 1, 27, 3, 27, 361, 8, 27, 1, 28, 1, 28, 1, 28, 0, 1, 48, 29, 0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, 52, 54, 56, 0, 10, 1, 0, 4, 10, 1, 0, 26, 30, 2, 0, 26, 30, 32, 35, 1, 0, 39, 40, 1, 0, 41, 43, 2, 0, 40, 40, 44, 44, 1, 0, 6, 9, 1, 0, 45, 46, 1, 0, 36, 37, 2, 0, 52, 57, 64, 64, 394, 0, 61, 1, 0, 0, 0, 2, 67, 1, 0, 0, 0, 4, 72, 1, 0, 0, 0, 6, 74, 1, 0, 0, 0, 8, 79, 1, 0, 0, 0, 10, 83, 1, 0, 0, 0, 12, 85, 1, 0, 0, 0, 14, 97, 1, 0, 0, 0, 16, 109, 1, 0, 0, 0, 18, 125, 1, 0, 0, 0, 20, 137, 1, 0, 0, 0, 22, 146, 1, 0, 0, 0, 24, 148, 1, 0, 0, 0, 26, 160, 1, 0, 0, 0, 28, 169, 1, 0, 0, 0, 30, 174, 1, 0, 0, 0, 32, 186, 1, 0, 0, 0, 34, 196, 1, 0, 0, 0, 36, 205, 1, 0, 0, 0, 38, 209, 1, 0, 0, 0, 40, 213, 1, 0, 0, 0, 42, 215, 1, 0, 0, 0, 44, 231, 1, 0, 0, 0, 46, 234, 1, 0, 0, 0, 48, 303, 1, 0, 0, 0, 50, 349, 1, 0, 0, 0, 52, 356, 1, 0, 0, 0, 54, 358, 1, 0, 0, 0, 56, 362, 1, 0, 0, 0, 58, 60, 3, 2, 1, 0, 59, 58, 1, 0, 0, 0, 60, 63, 1, 0, 0, 0, 61, 59, 1, 0, 0, 0, 61, 62, 1, 0, 0, 0, 62, 64, 1, 0, 0, 0, 63, 61, 1, 0, 0, 0, 64, 65, 3, 12, 6, 0, 65, 66, 5, 0, 0, 1, 66, 1, 1, 0, 0, 0, 67, 68, 5, 1, 0, 0, 68, 69, 3, 4, 2, 0, 69, 70, 3, 6, 3, 0, 70, 71, 5, 2, 0, 0, 71, 3, 1, 0, 0, 0, 72, 73, 5, 3, 0, 0, 73, 5, 1, 0, 0, 0, 74, 76, 3, 8, 4, 0, 75, 77, 3, 8, 4, 0, 76, 75, 1, 0, 0, 0, 76, 77, 1, 0, 0, 0, 77, 7, 1, 0, 0, 0, 78, 80, 3, 10, 5, 0, 79, 78, 1, 0, 0, 0, 79, 80, 1, 0, 0, 0, 80, 81, 1, 0, 0, 0, 81, 82, 5, 58, 0, 0, 82, 9, 1, 0, 0, 0, 83, 84, 7, 0, 0, 0, 84, 11, 1, 0, 0, 0, 85, 86, 5, 11, 0, 0, 86, 87, 5, 71, 0, 0, 87, 88, 3, 16, 8, 0, 88, 92, 5, 12, 0, 0, 89, 91, 3, 14, 7, 0, 90, 89, 1, 0, 0, 0, 91, 94, 1, 0, 0, 0, 92, 90, 1, 0, 0, 0, 92, 93, 1, 0, 0, 0, 93, 95, 1, 0, 0, 0, 94, 92, 1, 0, 0, 0, 95, 96, 5, 13, 0, 0, 96, 13, 1, 0, 0, 0, 97, 98, 5, 14, 0, 0, 98, 99, 5, 71, 0, 0, 99, 100, 3, 16, 8, 0, 100, 104, 5, 12, 0, 0, 101, 103, 3, 22, 11, 0, 102, 101, 1, 0, 0, 0, 103, 106, 1, 0, 0, 0, 104, 102, 1, 0, 0, 0, 104, 105, 1, 0, 0, 0, 105, 107, 1, 0, 0, 0, 106, 104, 1, 0, 0, 0, 107, 108, 5, 13, 0, 0, 108, 15, 1, 0, 0, 0, 109, 121, 5, 15, 0, 0, 110, 115, 3, 18, 9, 0, 111, 112, 5, 16, 0, 0, 112, 114, 3, 18, 9, 0, 113, 111, 1, 0, 0, 0, 114, 117, 1, 0, 0, 0, 115, 113, 1, 0, 0, 0, 115, 116, 1, 0, 0, 0, 116, 119, 1, 0, 0, 0, 117, 115, 1, 0, 0, 0, 118, 120, 5, 16, 0, 0, 119, 118, 1, 0, 0, 0, 119, 120, 1, 0, 0, 0, 120, 122, 1, 0, 0, 0, 121, 110, 1, 0, 0, 0, 121, 122, 1, 0, 0, 0, 122, 123, 1, 0, 0, 0, 123, 124, 5, 17, 0, 0, 124, 17, 1, 0, 0, 0, 125, 126, 3, 56, 28, 0, 126, 127, 5, 71, 0, 0, 127, 19, 1, 0, 0, 0, 128, 132, 5, 12, 0, 0, 129, 131, 3, 22, 11, 0, 130, 129, 1, 0, 0, 0, 131, 134, 1, 0, 0, 0, 132, 130, 1, 0, 0, 0, 132, 133, 1, 0, 0, 0, 133, 135, 1, 0, 0, 0, 134, 132, 1, 0, 0, 0, 135, 138, 5, 13, 0, 0, 136, 138, 3, 22, 11, 0, 137, 128, 1, 0, 0, 0, 137, 136, 1, 0, 0, 0, 138, 21, 1, 0, 0, 0, 139, 147, 3, 24, 12, 0, 140, 147, 3, 26, 13, 0, 141, 147, 3, 28, 14, 0, 142, 147, 3, 30, 15, 0, 143, 147, 3, 32, 16, 0, 144, 147, 3, 34, 17, 0, 145, 147, 3, 36, 18, 0, 146, 139, 1, 0, 0, 0, 146, 140, 1, 0, 0, 0, 146, 141, 1, 0, 0, 0, 146, 142, 1, 0, 0, 0, 146, 143, 1, 0, 0, 0, 146, 144, 1, 0, 0, 0, 146, 145, 1, 0, 0, 0, 147, 23, 1, 0, 0, 0, 148, 152, 3, 56, 28, 0, 149, 151, 3, 50, 25, 0, 150, 149, 1, 0, 0, 0, 151, 154, 1, 0, 0, 0, 152, 150, 1, 0, 0, 0, 152, 153, 1, 0, 0, 0, 153, 155, 1, 0, 0, 0, 154, 152, 1, 0, 0, 0, 155, 156, 5, 71, 0, 0, 156, 157, 5, 10, 0, 0, 157, 158, 3, 48, 24, 0, 158, 159, 5, 2, 0, 0, 159, 25, 1, 0, 0, 0, 160, 161, 3, 56, 28, 0, 161, 162, 5, 71, 0, 0, 162, 163, 5, 16, 0, 0, 163, 164, 3, 56, 28, 0, 164, 165, 5, 71, 0, 0, 165, 166, 5, 10, 0, 0, 166, 167, 3, 48, 24, 0, 167, 168, 5, 2, 0, 0, 168, 27, 1, 0, 0, 0, 169, 170, 5, 71, 0, 0, 170, 171, 5, 10, 0, 0, 171, 172, 3, 48, 24, 0, 172, 173, 5, 2, 0, 0, 173, 29, 1, 0, 0, 0, 174, 175, 5, 18, 0, 0, 175, 176, 5, 15, 0, 0, 176, 177, 5, 69, 0, 0, 177, 178, 5, 6, 0, 0, 178, 181, 3, 48, 24, 0, 179, 180, 5, 16, 0, 0, 180, 182, 3, 38, 19, 0, 181, 179, 1, 0, 0, 0, 181, 182, 1, 0, 0, 0, 182, 183, 1, 0, 0, 0, 183, 184, 5, 17, 0, 0, 184, 185, 5, 2, 0, 0, 185, 31, 1, 0, 0, 0, 186, 187, 5, 18, 0, 0, 187, 188, 5, 15, 0, 0, 188, 191, 3, 48, 24, 0, 189, 190, 5, 16, 0, 0, 190, 192, 3, 38, 19, 0, 191, 189, 1, 0, 0, 0, 191, 192, 1, 0, 0, 0, 192, 193, 1, 0, 0, 0, 193, 194, 5, 17, 0, 0, 194, 195, 5, 2, 0, 0, 195, 33, 1, 0, 0, 0, 196, 197, 5, 19, 0, 0, 197, 198, 5, 15, 0, 0, 198, 199, 3, 48, 24, 0, 199, 200, 5, 17, 0, 0, 200, 203, 3, 20, 10, 0, 201, 202, 5, 20, 0, 0, 202, 204, 3, 20, 10, 0, 203, 201, 1, 0, 0, 0, 203, 204, 1, 0, 0, 0, 204, 35, 1, 0, 0, 0, 205, 206, 5, 21, 0, 0, 206, 207, 3, 42, 21, 0, 207, 208, 5, 2, 0, 0, 208, 37, 1, 0, 0, 0, 209, 210, 5, 66, 0, 0, 210, 39, 1, 0, 0, 0, 211, 214, 5, 71, 0, 0, 212, 214, 3, 52, 26, 0, 213, 211, 1, 0, 0, 0, 213, 212, 1, 0, 0, 0, 214, 41, 1, 0, 0, 0, 215, 227, 5, 15, 0, 0, 216, 221, 3, 40, 20, 0, 217, 218, 5, 16, 0, 0, 218, 220, 3, 40, 20, 0, 219, 217, 1, 0, 0, 0, 220, 223, 1, 0, 0, 0, 221, 219, 1, 0, 0, 0, 221, 222, 1, 0, 0, 0, 222, 225, 1, 0, 0, 0, 223, 221, 1, 0, 0, 0, 224, 226, 5, 16, 0, 0, 225, 224, 1, 0, 0, 0, 225, 226, 1, 0, 0, 0, 226, 228, 1, 0, 0, 0, 227, 216, 1, 0, 0, 0, 227, 228, 1, 0, 0, 0, 228, 229, 1, 0, 0, 0, 229, 230, 5, 17, 0, 0, 230, 43, 1, 0, 0, 0, 231, 232, 5, 71, 0, 0, 232, 233, 3, 46, 23, 0, 233, 45, 1, 0, 0, 0, 234, 246, 5, 15, 0, 0, 235, 240, 3, 48, 24, 0, 236, 237, 5, 16, 0, 0, 237, 239, 3, 48, 24, 0, 238, 236, 1, 0, 0, 0, 239, 242, 1, 0, 0, 0, 240, 238, 1, 0, 0, 0, 240, 241, 1, 0, 0, 0, 241, 244, 1, 0, 0, 0, 242, 240, 1, 0, 0, 0, 243, 245, 5, 16, 0, 0, 244, 243, 1, 0, 0, 0, 244, 245, 1, 0, 0, 0, 245, 247, 1, 0, 0, 0, 246, 235, 1, 0, 0, 0, 246, 247, 1, 0, 0, 0, 247, 248, 1, 0, 0, 0, 248, 249, 5, 17, 0, 0, 249, 47, 1, 0, 0, 0, 250, 251, 6, 24, -1, 0, 251, 252, 5, 15, 0, 0, 252, 253, 3, 48, 24, 0, 253, 254, 5, 17, 0, 0, 254, 304, 1, 0, 0, 0, 255, 256, 3, 56, 28, 0, 256, 257, 5, 15, 0, 0, 257, 260, 3, 48, 24, 0, 258, 259, 5, 16, 0, 0, 259, 261, 3, 48, 24, 0, 260, 258, 1, 0, 0, 0, 260, 261, 1, 0, 0, 0, 261, 263, 1, 0, 0, 0, 262, 264, 5, 16, 0, 0, 263, 262, 1, 0, 0, 0, 263, 264, 1, 0, 0, 0, 264, 265, 1, 0, 0, 0, 265, 266, 5, 17, 0, 0, 266, 304, 1, 0, 0, 0, 267, 304, 3, 44, 22, 0, 268, 269, 5, 22, 0, 0, 269, 270, 5, 71, 0, 0, 270, 304, 3, 46, 23, 0, 271, 272, 5, 25, 0, 0, 272, 273, 5, 23, 0, 0, 273, 274, 3, 48, 24, 0, 274, 275, 5, 24, 0, 0, 275, 276, 7, 1, 0, 0, 276, 304, 1, 0, 0, 0, 277, 278, 5, 31, 0, 0, 278, 279, 5, 23, 0, 0, 279, 280, 3, 48, 24, 0, 280, 281, 5, 24, 0, 0, 281, 282, 7, 2, 0, 0, 282, 304, 1, 0, 0, 0, 283, 284, 7, 3, 0, 0, 284, 304, 3, 48, 24, 14, 285, 297, 5, 23, 0, 0, 286, 291, 3, 48, 24, 0, 287, 288, 5, 16, 0, 0, 288, 290, 3, 48, 24, 0, 289, 287, 1, 0, 0, 0, 290, 293, 1, 0, 0, 0, 291, 289, 1, 0, 0, 0, 291, 292, 1, 0, 0, 0, 292, 295, 1, 0, 0, 0, 293, 291, 1, 0, 0, 0, 294, 296, 5, 16, 0, 0, 295, 294, 1, 0, 0, 0, 295, 296, 1, 0, 0, 0, 296, 298, 1, 0, 0, 0, 297, 286, 1, 0, 0, 0, 297, 298, 1, 0, 0, 0, 298, 299, 1, 0, 0, 0, 299, 304, 5, 24, 0, 0, 300, 304, 5, 70, 0, 0, 301, 304, 5, 71, 0, 0, 302, 304, 3, 52, 26, 0, 303, 250, 1, 0, 0, 0, 303, 255, 1, 0, 0, 0, 303, 267, 1, 0, 0, 0, 303, 268, 1, 0, 0, 0, 303, 271, 1, 0, 0, 0, 303, 277, 1, 0, 0, 0, 303, 283, 1, 0, 0, 0, 303, 285, 1, 0, 0, 0, 303, 300, 1, 0, 0, 0, 303, 301, 1, 0, 0, 0, 303, 302, 1, 0, 0, 0, 304, 346, 1, 0, 0, 0, 305, 306, 10, 13, 0, 0, 306, 307, 7, 4, 0, 0, 307, 345, 3, 48, 24, 14, 308, 309, 10, 12, 0, 0, 309, 310, 7, 5, 0, 0, 310, 345, 3, 48, 24, 13, 311, 312, 10, 11, 0, 0, 312, 313, 7, 6, 0, 0, 313, 345, 3, 48, 24, 12, 314, 315, 10, 10, 0, 0, 315, 316, 7, 7, 0, 0, 316, 345, 3, 48, 24, 11, 317, 318, 10, 9, 0, 0, 318, 319, 5, 47, 0, 0, 319, 345, 3, 48, 24, 10, 320, 321, 10, 8, 0, 0, 321, 322, 5, 4, 0, 0, 322, 345, 3, 48, 24, 9, 323, 324, 10, 7, 0, 0, 324, 325, 5, 48, 0, 0, 325, 345, 3, 48, 24, 8, 326, 327, 10, 6, 0, 0, 327, 328, 5, 49, 0, 0, 328, 345, 3, 48, 24, 7, 329, 330, 10, 5, 0, 0, 330, 331, 5, 50, 0, 0, 331, 345, 3, 48, 24, 6, 332, 333, 10, 19, 0, 0, 333, 334, 5, 23, 0, 0, 334, 335, 5, 61, 0, 0, 335, 345, 5, 24, 0, 0, 336, 337, 10, 16, 0, 0, 337, 345, 7, 8, 0, 0, 338, 339, 10, 15, 0, 0, 339, 340, 5, 38, 0, 0, 340, 341, 5, 15, 0, 0, 341, 342, 3, 48, 24, 0, 342, 343, 5, 17, 0, 0, 343, 345, 1, 0, 0, 0, 344, 305, 1, 0, 0, 0, 344, 308, 1, 0, 0, 0, 344, 311, 1, 0, 0, 0, 344, 314, 1, 0, 0, 0, 344, 317, 1, 0, 0, 0, 344, 320, 1, 0, 0, 0, 344, 323, 1, 0, 0, 0, 344, 326, 1, 0, 0, 0, 344, 329, 1, 0, 0, 0, 344, 332, 1, 0, 0, 0, 344, 336, 1, 0, 0, 0, 344, 338, 1, 0, 0, 0, 345, 348, 1, 0, 0, 0, 346, 344, 1, 0, 0, 0, 346, 347, 1, 0, 0, 0, 347, 49, 1, 0, 0, 0, 348, 346, 1, 0, 0, 0, 349, 350, 5, 51, 0, 0, 350, 51, 1, 0, 0, 0, 351, 357, 5, 59, 0, 0, 352, 357, 3, 54, 27, 0, 353, 357, 5, 66, 0, 0, 354, 357, 5, 67, 0, 0, 355, 357, 5, 68, 0, 0, 356, 351, 1, 0, 0, 0, 356, 352, 1, 0, 0, 0, 356, 353, 1, 0, 0, 0, 356, 354, 1, 0, 0, 0, 356, 355, 1, 0, 0, 0, 357, 53, 1, 0, 0, 0, 358, 360, 5, 61, 0, 0, 359, 361, 5, 60, 0, 0, 360, 359, 1, 0, 0, 0, 360, 361, 1, 0, 0, 0, 361, 55, 1, 0, 0, 0, 362, 363, 7, 9, 0, 0, 363, 57, 1, 0, 0, 0, 32, 61, 76, 79, 92, 104, 115, 119, 121, 132, 137, 146, 152, 181, 191, 203, 213, 221, 225, 227, 240, 244, 246, 260, 263, 291, 295, 297, 303, 344, 346, 356, 360]
\ No newline at end of file
diff --git a/packages/cashc/src/grammar/CashScript.tokens b/packages/cashc/src/grammar/CashScript.tokens
index c7289b6a..c4593418 100644
--- a/packages/cashc/src/grammar/CashScript.tokens
+++ b/packages/cashc/src/grammar/CashScript.tokens
@@ -59,17 +59,19 @@ VersionLiteral=58
 BooleanLiteral=59
 NumberUnit=60
 NumberLiteral=61
-Bytes=62
-Bound=63
-StringLiteral=64
-DateLiteral=65
-HexLiteral=66
-TxVar=67
-NullaryOp=68
-Identifier=69
-WHITESPACE=70
-COMMENT=71
-LINE_COMMENT=72
+NumberPart=62
+ExponentPart=63
+Bytes=64
+Bound=65
+StringLiteral=66
+DateLiteral=67
+HexLiteral=68
+TxVar=69
+NullaryOp=70
+Identifier=71
+WHITESPACE=72
+COMMENT=73
+LINE_COMMENT=74
 'pragma'=1
 ';'=2
 'cashscript'=3
diff --git a/packages/cashc/src/grammar/CashScriptLexer.interp b/packages/cashc/src/grammar/CashScriptLexer.interp
index da62082b..e1f0983f 100644
--- a/packages/cashc/src/grammar/CashScriptLexer.interp
+++ b/packages/cashc/src/grammar/CashScriptLexer.interp
@@ -72,6 +72,8 @@ null
 null
 null
 null
+null
+null
 
 token symbolic names:
 null
@@ -136,6 +138,8 @@ VersionLiteral
 BooleanLiteral
 NumberUnit
 NumberLiteral
+NumberPart
+ExponentPart
 Bytes
 Bound
 StringLiteral
@@ -210,6 +214,8 @@ VersionLiteral
 BooleanLiteral
 NumberUnit
 NumberLiteral
+NumberPart
+ExponentPart
 Bytes
 Bound
 StringLiteral
@@ -230,4 +236,4 @@ mode names:
 DEFAULT_MODE
 
 atn:
-[4, 0, 72, 820, 6, -1, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 2, 25, 7, 25, 2, 26, 7, 26, 2, 27, 7, 27, 2, 28, 7, 28, 2, 29, 7, 29, 2, 30, 7, 30, 2, 31, 7, 31, 2, 32, 7, 32, 2, 33, 7, 33, 2, 34, 7, 34, 2, 35, 7, 35, 2, 36, 7, 36, 2, 37, 7, 37, 2, 38, 7, 38, 2, 39, 7, 39, 2, 40, 7, 40, 2, 41, 7, 41, 2, 42, 7, 42, 2, 43, 7, 43, 2, 44, 7, 44, 2, 45, 7, 45, 2, 46, 7, 46, 2, 47, 7, 47, 2, 48, 7, 48, 2, 49, 7, 49, 2, 50, 7, 50, 2, 51, 7, 51, 2, 52, 7, 52, 2, 53, 7, 53, 2, 54, 7, 54, 2, 55, 7, 55, 2, 56, 7, 56, 2, 57, 7, 57, 2, 58, 7, 58, 2, 59, 7, 59, 2, 60, 7, 60, 2, 61, 7, 61, 2, 62, 7, 62, 2, 63, 7, 63, 2, 64, 7, 64, 2, 65, 7, 65, 2, 66, 7, 66, 2, 67, 7, 67, 2, 68, 7, 68, 2, 69, 7, 69, 2, 70, 7, 70, 2, 71, 7, 71, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 3, 1, 3, 1, 4, 1, 4, 1, 5, 1, 5, 1, 5, 1, 6, 1, 6, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 11, 1, 11, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 15, 1, 15, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 19, 1, 19, 1, 19, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 21, 1, 21, 1, 21, 1, 21, 1, 22, 1, 22, 1, 23, 1, 23, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 38, 1, 38, 1, 39, 1, 39, 1, 40, 1, 40, 1, 41, 1, 41, 1, 42, 1, 42, 1, 43, 1, 43, 1, 44, 1, 44, 1, 44, 1, 45, 1, 45, 1, 45, 1, 46, 1, 46, 1, 47, 1, 47, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49, 1, 49, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 51, 1, 51, 1, 51, 1, 51, 1, 52, 1, 52, 1, 52, 1, 52, 1, 52, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 55, 1, 55, 1, 55, 1, 55, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 57, 4, 57, 508, 8, 57, 11, 57, 12, 57, 509, 1, 57, 1, 57, 4, 57, 514, 8, 57, 11, 57, 12, 57, 515, 1, 57, 1, 57, 4, 57, 520, 8, 57, 11, 57, 12, 57, 521, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 3, 58, 533, 8, 58, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 3, 59, 592, 8, 59, 1, 60, 3, 60, 595, 8, 60, 1, 60, 4, 60, 598, 8, 60, 11, 60, 12, 60, 599, 1, 60, 1, 60, 4, 60, 604, 8, 60, 11, 60, 12, 60, 605, 3, 60, 608, 8, 60, 1, 61, 1, 61, 1, 61, 1, 61, 1, 61, 1, 61, 1, 61, 3, 61, 617, 8, 61, 1, 61, 1, 61, 1, 61, 1, 61, 3, 61, 623, 8, 61, 1, 62, 1, 62, 5, 62, 627, 8, 62, 10, 62, 12, 62, 630, 9, 62, 1, 63, 1, 63, 1, 63, 1, 63, 5, 63, 636, 8, 63, 10, 63, 12, 63, 639, 9, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 5, 63, 646, 8, 63, 10, 63, 12, 63, 649, 9, 63, 1, 63, 3, 63, 652, 8, 63, 1, 64, 1, 64, 1, 64, 1, 64, 1, 64, 1, 64, 1, 64, 1, 64, 1, 64, 1, 65, 1, 65, 1, 65, 5, 65, 666, 8, 65, 10, 65, 12, 65, 669, 9, 65, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 3, 66, 684, 8, 66, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 1, 67, 3, 67, 780, 8, 67, 1, 68, 1, 68, 5, 68, 784, 8, 68, 10, 68, 12, 68, 787, 9, 68, 1, 69, 4, 69, 790, 8, 69, 11, 69, 12, 69, 791, 1, 69, 1, 69, 1, 70, 1, 70, 1, 70, 1, 70, 5, 70, 800, 8, 70, 10, 70, 12, 70, 803, 9, 70, 1, 70, 1, 70, 1, 70, 1, 70, 1, 70, 1, 71, 1, 71, 1, 71, 1, 71, 5, 71, 814, 8, 71, 10, 71, 12, 71, 817, 9, 71, 1, 71, 1, 71, 3, 637, 647, 801, 0, 72, 1, 1, 3, 2, 5, 3, 7, 4, 9, 5, 11, 6, 13, 7, 15, 8, 17, 9, 19, 10, 21, 11, 23, 12, 25, 13, 27, 14, 29, 15, 31, 16, 33, 17, 35, 18, 37, 19, 39, 20, 41, 21, 43, 22, 45, 23, 47, 24, 49, 25, 51, 26, 53, 27, 55, 28, 57, 29, 59, 30, 61, 31, 63, 32, 65, 33, 67, 34, 69, 35, 71, 36, 73, 37, 75, 38, 77, 39, 79, 40, 81, 41, 83, 42, 85, 43, 87, 44, 89, 45, 91, 46, 93, 47, 95, 48, 97, 49, 99, 50, 101, 51, 103, 52, 105, 53, 107, 54, 109, 55, 111, 56, 113, 57, 115, 58, 117, 59, 119, 60, 121, 61, 123, 62, 125, 63, 127, 64, 129, 65, 131, 66, 133, 67, 135, 68, 137, 69, 139, 70, 141, 71, 143, 72, 1, 0, 12, 1, 0, 48, 57, 1, 0, 45, 45, 2, 0, 69, 69, 101, 101, 1, 0, 49, 57, 3, 0, 10, 10, 13, 13, 34, 34, 3, 0, 10, 10, 13, 13, 39, 39, 2, 0, 88, 88, 120, 120, 3, 0, 48, 57, 65, 70, 97, 102, 2, 0, 65, 90, 97, 122, 4, 0, 48, 57, 65, 90, 95, 95, 97, 122, 3, 0, 9, 10, 12, 13, 32, 32, 2, 0, 10, 10, 13, 13, 855, 0, 1, 1, 0, 0, 0, 0, 3, 1, 0, 0, 0, 0, 5, 1, 0, 0, 0, 0, 7, 1, 0, 0, 0, 0, 9, 1, 0, 0, 0, 0, 11, 1, 0, 0, 0, 0, 13, 1, 0, 0, 0, 0, 15, 1, 0, 0, 0, 0, 17, 1, 0, 0, 0, 0, 19, 1, 0, 0, 0, 0, 21, 1, 0, 0, 0, 0, 23, 1, 0, 0, 0, 0, 25, 1, 0, 0, 0, 0, 27, 1, 0, 0, 0, 0, 29, 1, 0, 0, 0, 0, 31, 1, 0, 0, 0, 0, 33, 1, 0, 0, 0, 0, 35, 1, 0, 0, 0, 0, 37, 1, 0, 0, 0, 0, 39, 1, 0, 0, 0, 0, 41, 1, 0, 0, 0, 0, 43, 1, 0, 0, 0, 0, 45, 1, 0, 0, 0, 0, 47, 1, 0, 0, 0, 0, 49, 1, 0, 0, 0, 0, 51, 1, 0, 0, 0, 0, 53, 1, 0, 0, 0, 0, 55, 1, 0, 0, 0, 0, 57, 1, 0, 0, 0, 0, 59, 1, 0, 0, 0, 0, 61, 1, 0, 0, 0, 0, 63, 1, 0, 0, 0, 0, 65, 1, 0, 0, 0, 0, 67, 1, 0, 0, 0, 0, 69, 1, 0, 0, 0, 0, 71, 1, 0, 0, 0, 0, 73, 1, 0, 0, 0, 0, 75, 1, 0, 0, 0, 0, 77, 1, 0, 0, 0, 0, 79, 1, 0, 0, 0, 0, 81, 1, 0, 0, 0, 0, 83, 1, 0, 0, 0, 0, 85, 1, 0, 0, 0, 0, 87, 1, 0, 0, 0, 0, 89, 1, 0, 0, 0, 0, 91, 1, 0, 0, 0, 0, 93, 1, 0, 0, 0, 0, 95, 1, 0, 0, 0, 0, 97, 1, 0, 0, 0, 0, 99, 1, 0, 0, 0, 0, 101, 1, 0, 0, 0, 0, 103, 1, 0, 0, 0, 0, 105, 1, 0, 0, 0, 0, 107, 1, 0, 0, 0, 0, 109, 1, 0, 0, 0, 0, 111, 1, 0, 0, 0, 0, 113, 1, 0, 0, 0, 0, 115, 1, 0, 0, 0, 0, 117, 1, 0, 0, 0, 0, 119, 1, 0, 0, 0, 0, 121, 1, 0, 0, 0, 0, 123, 1, 0, 0, 0, 0, 125, 1, 0, 0, 0, 0, 127, 1, 0, 0, 0, 0, 129, 1, 0, 0, 0, 0, 131, 1, 0, 0, 0, 0, 133, 1, 0, 0, 0, 0, 135, 1, 0, 0, 0, 0, 137, 1, 0, 0, 0, 0, 139, 1, 0, 0, 0, 0, 141, 1, 0, 0, 0, 0, 143, 1, 0, 0, 0, 1, 145, 1, 0, 0, 0, 3, 152, 1, 0, 0, 0, 5, 154, 1, 0, 0, 0, 7, 165, 1, 0, 0, 0, 9, 167, 1, 0, 0, 0, 11, 169, 1, 0, 0, 0, 13, 172, 1, 0, 0, 0, 15, 174, 1, 0, 0, 0, 17, 176, 1, 0, 0, 0, 19, 179, 1, 0, 0, 0, 21, 181, 1, 0, 0, 0, 23, 190, 1, 0, 0, 0, 25, 192, 1, 0, 0, 0, 27, 194, 1, 0, 0, 0, 29, 203, 1, 0, 0, 0, 31, 205, 1, 0, 0, 0, 33, 207, 1, 0, 0, 0, 35, 209, 1, 0, 0, 0, 37, 217, 1, 0, 0, 0, 39, 220, 1, 0, 0, 0, 41, 225, 1, 0, 0, 0, 43, 237, 1, 0, 0, 0, 45, 241, 1, 0, 0, 0, 47, 243, 1, 0, 0, 0, 49, 245, 1, 0, 0, 0, 51, 256, 1, 0, 0, 0, 53, 263, 1, 0, 0, 0, 55, 280, 1, 0, 0, 0, 57, 295, 1, 0, 0, 0, 59, 310, 1, 0, 0, 0, 61, 323, 1, 0, 0, 0, 63, 333, 1, 0, 0, 0, 65, 358, 1, 0, 0, 0, 67, 373, 1, 0, 0, 0, 69, 392, 1, 0, 0, 0, 71, 408, 1, 0, 0, 0, 73, 419, 1, 0, 0, 0, 75, 427, 1, 0, 0, 0, 77, 434, 1, 0, 0, 0, 79, 436, 1, 0, 0, 0, 81, 438, 1, 0, 0, 0, 83, 440, 1, 0, 0, 0, 85, 442, 1, 0, 0, 0, 87, 444, 1, 0, 0, 0, 89, 446, 1, 0, 0, 0, 91, 449, 1, 0, 0, 0, 93, 452, 1, 0, 0, 0, 95, 454, 1, 0, 0, 0, 97, 456, 1, 0, 0, 0, 99, 459, 1, 0, 0, 0, 101, 462, 1, 0, 0, 0, 103, 471, 1, 0, 0, 0, 105, 475, 1, 0, 0, 0, 107, 480, 1, 0, 0, 0, 109, 487, 1, 0, 0, 0, 111, 494, 1, 0, 0, 0, 113, 498, 1, 0, 0, 0, 115, 507, 1, 0, 0, 0, 117, 532, 1, 0, 0, 0, 119, 591, 1, 0, 0, 0, 121, 594, 1, 0, 0, 0, 123, 622, 1, 0, 0, 0, 125, 624, 1, 0, 0, 0, 127, 651, 1, 0, 0, 0, 129, 653, 1, 0, 0, 0, 131, 662, 1, 0, 0, 0, 133, 683, 1, 0, 0, 0, 135, 779, 1, 0, 0, 0, 137, 781, 1, 0, 0, 0, 139, 789, 1, 0, 0, 0, 141, 795, 1, 0, 0, 0, 143, 809, 1, 0, 0, 0, 145, 146, 5, 112, 0, 0, 146, 147, 5, 114, 0, 0, 147, 148, 5, 97, 0, 0, 148, 149, 5, 103, 0, 0, 149, 150, 5, 109, 0, 0, 150, 151, 5, 97, 0, 0, 151, 2, 1, 0, 0, 0, 152, 153, 5, 59, 0, 0, 153, 4, 1, 0, 0, 0, 154, 155, 5, 99, 0, 0, 155, 156, 5, 97, 0, 0, 156, 157, 5, 115, 0, 0, 157, 158, 5, 104, 0, 0, 158, 159, 5, 115, 0, 0, 159, 160, 5, 99, 0, 0, 160, 161, 5, 114, 0, 0, 161, 162, 5, 105, 0, 0, 162, 163, 5, 112, 0, 0, 163, 164, 5, 116, 0, 0, 164, 6, 1, 0, 0, 0, 165, 166, 5, 94, 0, 0, 166, 8, 1, 0, 0, 0, 167, 168, 5, 126, 0, 0, 168, 10, 1, 0, 0, 0, 169, 170, 5, 62, 0, 0, 170, 171, 5, 61, 0, 0, 171, 12, 1, 0, 0, 0, 172, 173, 5, 62, 0, 0, 173, 14, 1, 0, 0, 0, 174, 175, 5, 60, 0, 0, 175, 16, 1, 0, 0, 0, 176, 177, 5, 60, 0, 0, 177, 178, 5, 61, 0, 0, 178, 18, 1, 0, 0, 0, 179, 180, 5, 61, 0, 0, 180, 20, 1, 0, 0, 0, 181, 182, 5, 99, 0, 0, 182, 183, 5, 111, 0, 0, 183, 184, 5, 110, 0, 0, 184, 185, 5, 116, 0, 0, 185, 186, 5, 114, 0, 0, 186, 187, 5, 97, 0, 0, 187, 188, 5, 99, 0, 0, 188, 189, 5, 116, 0, 0, 189, 22, 1, 0, 0, 0, 190, 191, 5, 123, 0, 0, 191, 24, 1, 0, 0, 0, 192, 193, 5, 125, 0, 0, 193, 26, 1, 0, 0, 0, 194, 195, 5, 102, 0, 0, 195, 196, 5, 117, 0, 0, 196, 197, 5, 110, 0, 0, 197, 198, 5, 99, 0, 0, 198, 199, 5, 116, 0, 0, 199, 200, 5, 105, 0, 0, 200, 201, 5, 111, 0, 0, 201, 202, 5, 110, 0, 0, 202, 28, 1, 0, 0, 0, 203, 204, 5, 40, 0, 0, 204, 30, 1, 0, 0, 0, 205, 206, 5, 44, 0, 0, 206, 32, 1, 0, 0, 0, 207, 208, 5, 41, 0, 0, 208, 34, 1, 0, 0, 0, 209, 210, 5, 114, 0, 0, 210, 211, 5, 101, 0, 0, 211, 212, 5, 113, 0, 0, 212, 213, 5, 117, 0, 0, 213, 214, 5, 105, 0, 0, 214, 215, 5, 114, 0, 0, 215, 216, 5, 101, 0, 0, 216, 36, 1, 0, 0, 0, 217, 218, 5, 105, 0, 0, 218, 219, 5, 102, 0, 0, 219, 38, 1, 0, 0, 0, 220, 221, 5, 101, 0, 0, 221, 222, 5, 108, 0, 0, 222, 223, 5, 115, 0, 0, 223, 224, 5, 101, 0, 0, 224, 40, 1, 0, 0, 0, 225, 226, 5, 99, 0, 0, 226, 227, 5, 111, 0, 0, 227, 228, 5, 110, 0, 0, 228, 229, 5, 115, 0, 0, 229, 230, 5, 111, 0, 0, 230, 231, 5, 108, 0, 0, 231, 232, 5, 101, 0, 0, 232, 233, 5, 46, 0, 0, 233, 234, 5, 108, 0, 0, 234, 235, 5, 111, 0, 0, 235, 236, 5, 103, 0, 0, 236, 42, 1, 0, 0, 0, 237, 238, 5, 110, 0, 0, 238, 239, 5, 101, 0, 0, 239, 240, 5, 119, 0, 0, 240, 44, 1, 0, 0, 0, 241, 242, 5, 91, 0, 0, 242, 46, 1, 0, 0, 0, 243, 244, 5, 93, 0, 0, 244, 48, 1, 0, 0, 0, 245, 246, 5, 116, 0, 0, 246, 247, 5, 120, 0, 0, 247, 248, 5, 46, 0, 0, 248, 249, 5, 111, 0, 0, 249, 250, 5, 117, 0, 0, 250, 251, 5, 116, 0, 0, 251, 252, 5, 112, 0, 0, 252, 253, 5, 117, 0, 0, 253, 254, 5, 116, 0, 0, 254, 255, 5, 115, 0, 0, 255, 50, 1, 0, 0, 0, 256, 257, 5, 46, 0, 0, 257, 258, 5, 118, 0, 0, 258, 259, 5, 97, 0, 0, 259, 260, 5, 108, 0, 0, 260, 261, 5, 117, 0, 0, 261, 262, 5, 101, 0, 0, 262, 52, 1, 0, 0, 0, 263, 264, 5, 46, 0, 0, 264, 265, 5, 108, 0, 0, 265, 266, 5, 111, 0, 0, 266, 267, 5, 99, 0, 0, 267, 268, 5, 107, 0, 0, 268, 269, 5, 105, 0, 0, 269, 270, 5, 110, 0, 0, 270, 271, 5, 103, 0, 0, 271, 272, 5, 66, 0, 0, 272, 273, 5, 121, 0, 0, 273, 274, 5, 116, 0, 0, 274, 275, 5, 101, 0, 0, 275, 276, 5, 99, 0, 0, 276, 277, 5, 111, 0, 0, 277, 278, 5, 100, 0, 0, 278, 279, 5, 101, 0, 0, 279, 54, 1, 0, 0, 0, 280, 281, 5, 46, 0, 0, 281, 282, 5, 116, 0, 0, 282, 283, 5, 111, 0, 0, 283, 284, 5, 107, 0, 0, 284, 285, 5, 101, 0, 0, 285, 286, 5, 110, 0, 0, 286, 287, 5, 67, 0, 0, 287, 288, 5, 97, 0, 0, 288, 289, 5, 116, 0, 0, 289, 290, 5, 101, 0, 0, 290, 291, 5, 103, 0, 0, 291, 292, 5, 111, 0, 0, 292, 293, 5, 114, 0, 0, 293, 294, 5, 121, 0, 0, 294, 56, 1, 0, 0, 0, 295, 296, 5, 46, 0, 0, 296, 297, 5, 110, 0, 0, 297, 298, 5, 102, 0, 0, 298, 299, 5, 116, 0, 0, 299, 300, 5, 67, 0, 0, 300, 301, 5, 111, 0, 0, 301, 302, 5, 109, 0, 0, 302, 303, 5, 109, 0, 0, 303, 304, 5, 105, 0, 0, 304, 305, 5, 116, 0, 0, 305, 306, 5, 109, 0, 0, 306, 307, 5, 101, 0, 0, 307, 308, 5, 110, 0, 0, 308, 309, 5, 116, 0, 0, 309, 58, 1, 0, 0, 0, 310, 311, 5, 46, 0, 0, 311, 312, 5, 116, 0, 0, 312, 313, 5, 111, 0, 0, 313, 314, 5, 107, 0, 0, 314, 315, 5, 101, 0, 0, 315, 316, 5, 110, 0, 0, 316, 317, 5, 65, 0, 0, 317, 318, 5, 109, 0, 0, 318, 319, 5, 111, 0, 0, 319, 320, 5, 117, 0, 0, 320, 321, 5, 110, 0, 0, 321, 322, 5, 116, 0, 0, 322, 60, 1, 0, 0, 0, 323, 324, 5, 116, 0, 0, 324, 325, 5, 120, 0, 0, 325, 326, 5, 46, 0, 0, 326, 327, 5, 105, 0, 0, 327, 328, 5, 110, 0, 0, 328, 329, 5, 112, 0, 0, 329, 330, 5, 117, 0, 0, 330, 331, 5, 116, 0, 0, 331, 332, 5, 115, 0, 0, 332, 62, 1, 0, 0, 0, 333, 334, 5, 46, 0, 0, 334, 335, 5, 111, 0, 0, 335, 336, 5, 117, 0, 0, 336, 337, 5, 116, 0, 0, 337, 338, 5, 112, 0, 0, 338, 339, 5, 111, 0, 0, 339, 340, 5, 105, 0, 0, 340, 341, 5, 110, 0, 0, 341, 342, 5, 116, 0, 0, 342, 343, 5, 84, 0, 0, 343, 344, 5, 114, 0, 0, 344, 345, 5, 97, 0, 0, 345, 346, 5, 110, 0, 0, 346, 347, 5, 115, 0, 0, 347, 348, 5, 97, 0, 0, 348, 349, 5, 99, 0, 0, 349, 350, 5, 116, 0, 0, 350, 351, 5, 105, 0, 0, 351, 352, 5, 111, 0, 0, 352, 353, 5, 110, 0, 0, 353, 354, 5, 72, 0, 0, 354, 355, 5, 97, 0, 0, 355, 356, 5, 115, 0, 0, 356, 357, 5, 104, 0, 0, 357, 64, 1, 0, 0, 0, 358, 359, 5, 46, 0, 0, 359, 360, 5, 111, 0, 0, 360, 361, 5, 117, 0, 0, 361, 362, 5, 116, 0, 0, 362, 363, 5, 112, 0, 0, 363, 364, 5, 111, 0, 0, 364, 365, 5, 105, 0, 0, 365, 366, 5, 110, 0, 0, 366, 367, 5, 116, 0, 0, 367, 368, 5, 73, 0, 0, 368, 369, 5, 110, 0, 0, 369, 370, 5, 100, 0, 0, 370, 371, 5, 101, 0, 0, 371, 372, 5, 120, 0, 0, 372, 66, 1, 0, 0, 0, 373, 374, 5, 46, 0, 0, 374, 375, 5, 117, 0, 0, 375, 376, 5, 110, 0, 0, 376, 377, 5, 108, 0, 0, 377, 378, 5, 111, 0, 0, 378, 379, 5, 99, 0, 0, 379, 380, 5, 107, 0, 0, 380, 381, 5, 105, 0, 0, 381, 382, 5, 110, 0, 0, 382, 383, 5, 103, 0, 0, 383, 384, 5, 66, 0, 0, 384, 385, 5, 121, 0, 0, 385, 386, 5, 116, 0, 0, 386, 387, 5, 101, 0, 0, 387, 388, 5, 99, 0, 0, 388, 389, 5, 111, 0, 0, 389, 390, 5, 100, 0, 0, 390, 391, 5, 101, 0, 0, 391, 68, 1, 0, 0, 0, 392, 393, 5, 46, 0, 0, 393, 394, 5, 115, 0, 0, 394, 395, 5, 101, 0, 0, 395, 396, 5, 113, 0, 0, 396, 397, 5, 117, 0, 0, 397, 398, 5, 101, 0, 0, 398, 399, 5, 110, 0, 0, 399, 400, 5, 99, 0, 0, 400, 401, 5, 101, 0, 0, 401, 402, 5, 78, 0, 0, 402, 403, 5, 117, 0, 0, 403, 404, 5, 109, 0, 0, 404, 405, 5, 98, 0, 0, 405, 406, 5, 101, 0, 0, 406, 407, 5, 114, 0, 0, 407, 70, 1, 0, 0, 0, 408, 409, 5, 46, 0, 0, 409, 410, 5, 114, 0, 0, 410, 411, 5, 101, 0, 0, 411, 412, 5, 118, 0, 0, 412, 413, 5, 101, 0, 0, 413, 414, 5, 114, 0, 0, 414, 415, 5, 115, 0, 0, 415, 416, 5, 101, 0, 0, 416, 417, 5, 40, 0, 0, 417, 418, 5, 41, 0, 0, 418, 72, 1, 0, 0, 0, 419, 420, 5, 46, 0, 0, 420, 421, 5, 108, 0, 0, 421, 422, 5, 101, 0, 0, 422, 423, 5, 110, 0, 0, 423, 424, 5, 103, 0, 0, 424, 425, 5, 116, 0, 0, 425, 426, 5, 104, 0, 0, 426, 74, 1, 0, 0, 0, 427, 428, 5, 46, 0, 0, 428, 429, 5, 115, 0, 0, 429, 430, 5, 112, 0, 0, 430, 431, 5, 108, 0, 0, 431, 432, 5, 105, 0, 0, 432, 433, 5, 116, 0, 0, 433, 76, 1, 0, 0, 0, 434, 435, 5, 33, 0, 0, 435, 78, 1, 0, 0, 0, 436, 437, 5, 45, 0, 0, 437, 80, 1, 0, 0, 0, 438, 439, 5, 42, 0, 0, 439, 82, 1, 0, 0, 0, 440, 441, 5, 47, 0, 0, 441, 84, 1, 0, 0, 0, 442, 443, 5, 37, 0, 0, 443, 86, 1, 0, 0, 0, 444, 445, 5, 43, 0, 0, 445, 88, 1, 0, 0, 0, 446, 447, 5, 61, 0, 0, 447, 448, 5, 61, 0, 0, 448, 90, 1, 0, 0, 0, 449, 450, 5, 33, 0, 0, 450, 451, 5, 61, 0, 0, 451, 92, 1, 0, 0, 0, 452, 453, 5, 38, 0, 0, 453, 94, 1, 0, 0, 0, 454, 455, 5, 124, 0, 0, 455, 96, 1, 0, 0, 0, 456, 457, 5, 38, 0, 0, 457, 458, 5, 38, 0, 0, 458, 98, 1, 0, 0, 0, 459, 460, 5, 124, 0, 0, 460, 461, 5, 124, 0, 0, 461, 100, 1, 0, 0, 0, 462, 463, 5, 99, 0, 0, 463, 464, 5, 111, 0, 0, 464, 465, 5, 110, 0, 0, 465, 466, 5, 115, 0, 0, 466, 467, 5, 116, 0, 0, 467, 468, 5, 97, 0, 0, 468, 469, 5, 110, 0, 0, 469, 470, 5, 116, 0, 0, 470, 102, 1, 0, 0, 0, 471, 472, 5, 105, 0, 0, 472, 473, 5, 110, 0, 0, 473, 474, 5, 116, 0, 0, 474, 104, 1, 0, 0, 0, 475, 476, 5, 98, 0, 0, 476, 477, 5, 111, 0, 0, 477, 478, 5, 111, 0, 0, 478, 479, 5, 108, 0, 0, 479, 106, 1, 0, 0, 0, 480, 481, 5, 115, 0, 0, 481, 482, 5, 116, 0, 0, 482, 483, 5, 114, 0, 0, 483, 484, 5, 105, 0, 0, 484, 485, 5, 110, 0, 0, 485, 486, 5, 103, 0, 0, 486, 108, 1, 0, 0, 0, 487, 488, 5, 112, 0, 0, 488, 489, 5, 117, 0, 0, 489, 490, 5, 98, 0, 0, 490, 491, 5, 107, 0, 0, 491, 492, 5, 101, 0, 0, 492, 493, 5, 121, 0, 0, 493, 110, 1, 0, 0, 0, 494, 495, 5, 115, 0, 0, 495, 496, 5, 105, 0, 0, 496, 497, 5, 103, 0, 0, 497, 112, 1, 0, 0, 0, 498, 499, 5, 100, 0, 0, 499, 500, 5, 97, 0, 0, 500, 501, 5, 116, 0, 0, 501, 502, 5, 97, 0, 0, 502, 503, 5, 115, 0, 0, 503, 504, 5, 105, 0, 0, 504, 505, 5, 103, 0, 0, 505, 114, 1, 0, 0, 0, 506, 508, 7, 0, 0, 0, 507, 506, 1, 0, 0, 0, 508, 509, 1, 0, 0, 0, 509, 507, 1, 0, 0, 0, 509, 510, 1, 0, 0, 0, 510, 511, 1, 0, 0, 0, 511, 513, 5, 46, 0, 0, 512, 514, 7, 0, 0, 0, 513, 512, 1, 0, 0, 0, 514, 515, 1, 0, 0, 0, 515, 513, 1, 0, 0, 0, 515, 516, 1, 0, 0, 0, 516, 517, 1, 0, 0, 0, 517, 519, 5, 46, 0, 0, 518, 520, 7, 0, 0, 0, 519, 518, 1, 0, 0, 0, 520, 521, 1, 0, 0, 0, 521, 519, 1, 0, 0, 0, 521, 522, 1, 0, 0, 0, 522, 116, 1, 0, 0, 0, 523, 524, 5, 116, 0, 0, 524, 525, 5, 114, 0, 0, 525, 526, 5, 117, 0, 0, 526, 533, 5, 101, 0, 0, 527, 528, 5, 102, 0, 0, 528, 529, 5, 97, 0, 0, 529, 530, 5, 108, 0, 0, 530, 531, 5, 115, 0, 0, 531, 533, 5, 101, 0, 0, 532, 523, 1, 0, 0, 0, 532, 527, 1, 0, 0, 0, 533, 118, 1, 0, 0, 0, 534, 535, 5, 115, 0, 0, 535, 536, 5, 97, 0, 0, 536, 537, 5, 116, 0, 0, 537, 538, 5, 111, 0, 0, 538, 539, 5, 115, 0, 0, 539, 540, 5, 104, 0, 0, 540, 541, 5, 105, 0, 0, 541, 592, 5, 115, 0, 0, 542, 543, 5, 115, 0, 0, 543, 544, 5, 97, 0, 0, 544, 545, 5, 116, 0, 0, 545, 592, 5, 115, 0, 0, 546, 547, 5, 102, 0, 0, 547, 548, 5, 105, 0, 0, 548, 549, 5, 110, 0, 0, 549, 550, 5, 110, 0, 0, 550, 551, 5, 101, 0, 0, 551, 592, 5, 121, 0, 0, 552, 553, 5, 98, 0, 0, 553, 554, 5, 105, 0, 0, 554, 555, 5, 116, 0, 0, 555, 592, 5, 115, 0, 0, 556, 557, 5, 98, 0, 0, 557, 558, 5, 105, 0, 0, 558, 559, 5, 116, 0, 0, 559, 560, 5, 99, 0, 0, 560, 561, 5, 111, 0, 0, 561, 562, 5, 105, 0, 0, 562, 592, 5, 110, 0, 0, 563, 564, 5, 115, 0, 0, 564, 565, 5, 101, 0, 0, 565, 566, 5, 99, 0, 0, 566, 567, 5, 111, 0, 0, 567, 568, 5, 110, 0, 0, 568, 569, 5, 100, 0, 0, 569, 592, 5, 115, 0, 0, 570, 571, 5, 109, 0, 0, 571, 572, 5, 105, 0, 0, 572, 573, 5, 110, 0, 0, 573, 574, 5, 117, 0, 0, 574, 575, 5, 116, 0, 0, 575, 576, 5, 101, 0, 0, 576, 592, 5, 115, 0, 0, 577, 578, 5, 104, 0, 0, 578, 579, 5, 111, 0, 0, 579, 580, 5, 117, 0, 0, 580, 581, 5, 114, 0, 0, 581, 592, 5, 115, 0, 0, 582, 583, 5, 100, 0, 0, 583, 584, 5, 97, 0, 0, 584, 585, 5, 121, 0, 0, 585, 592, 5, 115, 0, 0, 586, 587, 5, 119, 0, 0, 587, 588, 5, 101, 0, 0, 588, 589, 5, 101, 0, 0, 589, 590, 5, 107, 0, 0, 590, 592, 5, 115, 0, 0, 591, 534, 1, 0, 0, 0, 591, 542, 1, 0, 0, 0, 591, 546, 1, 0, 0, 0, 591, 552, 1, 0, 0, 0, 591, 556, 1, 0, 0, 0, 591, 563, 1, 0, 0, 0, 591, 570, 1, 0, 0, 0, 591, 577, 1, 0, 0, 0, 591, 582, 1, 0, 0, 0, 591, 586, 1, 0, 0, 0, 592, 120, 1, 0, 0, 0, 593, 595, 7, 1, 0, 0, 594, 593, 1, 0, 0, 0, 594, 595, 1, 0, 0, 0, 595, 597, 1, 0, 0, 0, 596, 598, 7, 0, 0, 0, 597, 596, 1, 0, 0, 0, 598, 599, 1, 0, 0, 0, 599, 597, 1, 0, 0, 0, 599, 600, 1, 0, 0, 0, 600, 607, 1, 0, 0, 0, 601, 603, 7, 2, 0, 0, 602, 604, 7, 0, 0, 0, 603, 602, 1, 0, 0, 0, 604, 605, 1, 0, 0, 0, 605, 603, 1, 0, 0, 0, 605, 606, 1, 0, 0, 0, 606, 608, 1, 0, 0, 0, 607, 601, 1, 0, 0, 0, 607, 608, 1, 0, 0, 0, 608, 122, 1, 0, 0, 0, 609, 610, 5, 98, 0, 0, 610, 611, 5, 121, 0, 0, 611, 612, 5, 116, 0, 0, 612, 613, 5, 101, 0, 0, 613, 614, 5, 115, 0, 0, 614, 616, 1, 0, 0, 0, 615, 617, 3, 125, 62, 0, 616, 615, 1, 0, 0, 0, 616, 617, 1, 0, 0, 0, 617, 623, 1, 0, 0, 0, 618, 619, 5, 98, 0, 0, 619, 620, 5, 121, 0, 0, 620, 621, 5, 116, 0, 0, 621, 623, 5, 101, 0, 0, 622, 609, 1, 0, 0, 0, 622, 618, 1, 0, 0, 0, 623, 124, 1, 0, 0, 0, 624, 628, 7, 3, 0, 0, 625, 627, 7, 0, 0, 0, 626, 625, 1, 0, 0, 0, 627, 630, 1, 0, 0, 0, 628, 626, 1, 0, 0, 0, 628, 629, 1, 0, 0, 0, 629, 126, 1, 0, 0, 0, 630, 628, 1, 0, 0, 0, 631, 637, 5, 34, 0, 0, 632, 633, 5, 92, 0, 0, 633, 636, 5, 34, 0, 0, 634, 636, 8, 4, 0, 0, 635, 632, 1, 0, 0, 0, 635, 634, 1, 0, 0, 0, 636, 639, 1, 0, 0, 0, 637, 638, 1, 0, 0, 0, 637, 635, 1, 0, 0, 0, 638, 640, 1, 0, 0, 0, 639, 637, 1, 0, 0, 0, 640, 652, 5, 34, 0, 0, 641, 647, 5, 39, 0, 0, 642, 643, 5, 92, 0, 0, 643, 646, 5, 39, 0, 0, 644, 646, 8, 5, 0, 0, 645, 642, 1, 0, 0, 0, 645, 644, 1, 0, 0, 0, 646, 649, 1, 0, 0, 0, 647, 648, 1, 0, 0, 0, 647, 645, 1, 0, 0, 0, 648, 650, 1, 0, 0, 0, 649, 647, 1, 0, 0, 0, 650, 652, 5, 39, 0, 0, 651, 631, 1, 0, 0, 0, 651, 641, 1, 0, 0, 0, 652, 128, 1, 0, 0, 0, 653, 654, 5, 100, 0, 0, 654, 655, 5, 97, 0, 0, 655, 656, 5, 116, 0, 0, 656, 657, 5, 101, 0, 0, 657, 658, 5, 40, 0, 0, 658, 659, 1, 0, 0, 0, 659, 660, 3, 127, 63, 0, 660, 661, 5, 41, 0, 0, 661, 130, 1, 0, 0, 0, 662, 663, 5, 48, 0, 0, 663, 667, 7, 6, 0, 0, 664, 666, 7, 7, 0, 0, 665, 664, 1, 0, 0, 0, 666, 669, 1, 0, 0, 0, 667, 665, 1, 0, 0, 0, 667, 668, 1, 0, 0, 0, 668, 132, 1, 0, 0, 0, 669, 667, 1, 0, 0, 0, 670, 671, 5, 116, 0, 0, 671, 672, 5, 120, 0, 0, 672, 673, 5, 46, 0, 0, 673, 674, 5, 97, 0, 0, 674, 675, 5, 103, 0, 0, 675, 684, 5, 101, 0, 0, 676, 677, 5, 116, 0, 0, 677, 678, 5, 120, 0, 0, 678, 679, 5, 46, 0, 0, 679, 680, 5, 116, 0, 0, 680, 681, 5, 105, 0, 0, 681, 682, 5, 109, 0, 0, 682, 684, 5, 101, 0, 0, 683, 670, 1, 0, 0, 0, 683, 676, 1, 0, 0, 0, 684, 134, 1, 0, 0, 0, 685, 686, 5, 116, 0, 0, 686, 687, 5, 104, 0, 0, 687, 688, 5, 105, 0, 0, 688, 689, 5, 115, 0, 0, 689, 690, 5, 46, 0, 0, 690, 691, 5, 97, 0, 0, 691, 692, 5, 99, 0, 0, 692, 693, 5, 116, 0, 0, 693, 694, 5, 105, 0, 0, 694, 695, 5, 118, 0, 0, 695, 696, 5, 101, 0, 0, 696, 697, 5, 73, 0, 0, 697, 698, 5, 110, 0, 0, 698, 699, 5, 112, 0, 0, 699, 700, 5, 117, 0, 0, 700, 701, 5, 116, 0, 0, 701, 702, 5, 73, 0, 0, 702, 703, 5, 110, 0, 0, 703, 704, 5, 100, 0, 0, 704, 705, 5, 101, 0, 0, 705, 780, 5, 120, 0, 0, 706, 707, 5, 116, 0, 0, 707, 708, 5, 104, 0, 0, 708, 709, 5, 105, 0, 0, 709, 710, 5, 115, 0, 0, 710, 711, 5, 46, 0, 0, 711, 712, 5, 97, 0, 0, 712, 713, 5, 99, 0, 0, 713, 714, 5, 116, 0, 0, 714, 715, 5, 105, 0, 0, 715, 716, 5, 118, 0, 0, 716, 717, 5, 101, 0, 0, 717, 718, 5, 66, 0, 0, 718, 719, 5, 121, 0, 0, 719, 720, 5, 116, 0, 0, 720, 721, 5, 101, 0, 0, 721, 722, 5, 99, 0, 0, 722, 723, 5, 111, 0, 0, 723, 724, 5, 100, 0, 0, 724, 780, 5, 101, 0, 0, 725, 726, 5, 116, 0, 0, 726, 727, 5, 120, 0, 0, 727, 728, 5, 46, 0, 0, 728, 729, 5, 105, 0, 0, 729, 730, 5, 110, 0, 0, 730, 731, 5, 112, 0, 0, 731, 732, 5, 117, 0, 0, 732, 733, 5, 116, 0, 0, 733, 734, 5, 115, 0, 0, 734, 735, 5, 46, 0, 0, 735, 736, 5, 108, 0, 0, 736, 737, 5, 101, 0, 0, 737, 738, 5, 110, 0, 0, 738, 739, 5, 103, 0, 0, 739, 740, 5, 116, 0, 0, 740, 780, 5, 104, 0, 0, 741, 742, 5, 116, 0, 0, 742, 743, 5, 120, 0, 0, 743, 744, 5, 46, 0, 0, 744, 745, 5, 111, 0, 0, 745, 746, 5, 117, 0, 0, 746, 747, 5, 116, 0, 0, 747, 748, 5, 112, 0, 0, 748, 749, 5, 117, 0, 0, 749, 750, 5, 116, 0, 0, 750, 751, 5, 115, 0, 0, 751, 752, 5, 46, 0, 0, 752, 753, 5, 108, 0, 0, 753, 754, 5, 101, 0, 0, 754, 755, 5, 110, 0, 0, 755, 756, 5, 103, 0, 0, 756, 757, 5, 116, 0, 0, 757, 780, 5, 104, 0, 0, 758, 759, 5, 116, 0, 0, 759, 760, 5, 120, 0, 0, 760, 761, 5, 46, 0, 0, 761, 762, 5, 118, 0, 0, 762, 763, 5, 101, 0, 0, 763, 764, 5, 114, 0, 0, 764, 765, 5, 115, 0, 0, 765, 766, 5, 105, 0, 0, 766, 767, 5, 111, 0, 0, 767, 780, 5, 110, 0, 0, 768, 769, 5, 116, 0, 0, 769, 770, 5, 120, 0, 0, 770, 771, 5, 46, 0, 0, 771, 772, 5, 108, 0, 0, 772, 773, 5, 111, 0, 0, 773, 774, 5, 99, 0, 0, 774, 775, 5, 107, 0, 0, 775, 776, 5, 116, 0, 0, 776, 777, 5, 105, 0, 0, 777, 778, 5, 109, 0, 0, 778, 780, 5, 101, 0, 0, 779, 685, 1, 0, 0, 0, 779, 706, 1, 0, 0, 0, 779, 725, 1, 0, 0, 0, 779, 741, 1, 0, 0, 0, 779, 758, 1, 0, 0, 0, 779, 768, 1, 0, 0, 0, 780, 136, 1, 0, 0, 0, 781, 785, 7, 8, 0, 0, 782, 784, 7, 9, 0, 0, 783, 782, 1, 0, 0, 0, 784, 787, 1, 0, 0, 0, 785, 783, 1, 0, 0, 0, 785, 786, 1, 0, 0, 0, 786, 138, 1, 0, 0, 0, 787, 785, 1, 0, 0, 0, 788, 790, 7, 10, 0, 0, 789, 788, 1, 0, 0, 0, 790, 791, 1, 0, 0, 0, 791, 789, 1, 0, 0, 0, 791, 792, 1, 0, 0, 0, 792, 793, 1, 0, 0, 0, 793, 794, 6, 69, 0, 0, 794, 140, 1, 0, 0, 0, 795, 796, 5, 47, 0, 0, 796, 797, 5, 42, 0, 0, 797, 801, 1, 0, 0, 0, 798, 800, 9, 0, 0, 0, 799, 798, 1, 0, 0, 0, 800, 803, 1, 0, 0, 0, 801, 802, 1, 0, 0, 0, 801, 799, 1, 0, 0, 0, 802, 804, 1, 0, 0, 0, 803, 801, 1, 0, 0, 0, 804, 805, 5, 42, 0, 0, 805, 806, 5, 47, 0, 0, 806, 807, 1, 0, 0, 0, 807, 808, 6, 70, 1, 0, 808, 142, 1, 0, 0, 0, 809, 810, 5, 47, 0, 0, 810, 811, 5, 47, 0, 0, 811, 815, 1, 0, 0, 0, 812, 814, 8, 11, 0, 0, 813, 812, 1, 0, 0, 0, 814, 817, 1, 0, 0, 0, 815, 813, 1, 0, 0, 0, 815, 816, 1, 0, 0, 0, 816, 818, 1, 0, 0, 0, 817, 815, 1, 0, 0, 0, 818, 819, 6, 71, 1, 0, 819, 144, 1, 0, 0, 0, 25, 0, 509, 515, 521, 532, 591, 594, 599, 605, 607, 616, 622, 628, 635, 637, 645, 647, 651, 667, 683, 779, 785, 791, 801, 815, 2, 6, 0, 0, 0, 1, 0]
\ No newline at end of file
+[4, 0, 74, 834, 6, -1, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 2, 25, 7, 25, 2, 26, 7, 26, 2, 27, 7, 27, 2, 28, 7, 28, 2, 29, 7, 29, 2, 30, 7, 30, 2, 31, 7, 31, 2, 32, 7, 32, 2, 33, 7, 33, 2, 34, 7, 34, 2, 35, 7, 35, 2, 36, 7, 36, 2, 37, 7, 37, 2, 38, 7, 38, 2, 39, 7, 39, 2, 40, 7, 40, 2, 41, 7, 41, 2, 42, 7, 42, 2, 43, 7, 43, 2, 44, 7, 44, 2, 45, 7, 45, 2, 46, 7, 46, 2, 47, 7, 47, 2, 48, 7, 48, 2, 49, 7, 49, 2, 50, 7, 50, 2, 51, 7, 51, 2, 52, 7, 52, 2, 53, 7, 53, 2, 54, 7, 54, 2, 55, 7, 55, 2, 56, 7, 56, 2, 57, 7, 57, 2, 58, 7, 58, 2, 59, 7, 59, 2, 60, 7, 60, 2, 61, 7, 61, 2, 62, 7, 62, 2, 63, 7, 63, 2, 64, 7, 64, 2, 65, 7, 65, 2, 66, 7, 66, 2, 67, 7, 67, 2, 68, 7, 68, 2, 69, 7, 69, 2, 70, 7, 70, 2, 71, 7, 71, 2, 72, 7, 72, 2, 73, 7, 73, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 3, 1, 3, 1, 4, 1, 4, 1, 5, 1, 5, 1, 5, 1, 6, 1, 6, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 11, 1, 11, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 15, 1, 15, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 19, 1, 19, 1, 19, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 21, 1, 21, 1, 21, 1, 21, 1, 22, 1, 22, 1, 23, 1, 23, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 38, 1, 38, 1, 39, 1, 39, 1, 40, 1, 40, 1, 41, 1, 41, 1, 42, 1, 42, 1, 43, 1, 43, 1, 44, 1, 44, 1, 44, 1, 45, 1, 45, 1, 45, 1, 46, 1, 46, 1, 47, 1, 47, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49, 1, 49, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 51, 1, 51, 1, 51, 1, 51, 1, 52, 1, 52, 1, 52, 1, 52, 1, 52, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 55, 1, 55, 1, 55, 1, 55, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 57, 4, 57, 512, 8, 57, 11, 57, 12, 57, 513, 1, 57, 1, 57, 4, 57, 518, 8, 57, 11, 57, 12, 57, 519, 1, 57, 1, 57, 4, 57, 524, 8, 57, 11, 57, 12, 57, 525, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 3, 58, 537, 8, 58, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 3, 59, 596, 8, 59, 1, 60, 3, 60, 599, 8, 60, 1, 60, 1, 60, 3, 60, 603, 8, 60, 1, 61, 4, 61, 606, 8, 61, 11, 61, 12, 61, 607, 1, 61, 1, 61, 4, 61, 612, 8, 61, 11, 61, 12, 61, 613, 5, 61, 616, 8, 61, 10, 61, 12, 61, 619, 9, 61, 1, 62, 1, 62, 1, 62, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 3, 63, 631, 8, 63, 1, 63, 1, 63, 1, 63, 1, 63, 3, 63, 637, 8, 63, 1, 64, 1, 64, 5, 64, 641, 8, 64, 10, 64, 12, 64, 644, 9, 64, 1, 65, 1, 65, 1, 65, 1, 65, 5, 65, 650, 8, 65, 10, 65, 12, 65, 653, 9, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 5, 65, 660, 8, 65, 10, 65, 12, 65, 663, 9, 65, 1, 65, 3, 65, 666, 8, 65, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 67, 1, 67, 1, 67, 5, 67, 680, 8, 67, 10, 67, 12, 67, 683, 9, 67, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 3, 68, 698, 8, 68, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 3, 69, 794, 8, 69, 1, 70, 1, 70, 5, 70, 798, 8, 70, 10, 70, 12, 70, 801, 9, 70, 1, 71, 4, 71, 804, 8, 71, 11, 71, 12, 71, 805, 1, 71, 1, 71, 1, 72, 1, 72, 1, 72, 1, 72, 5, 72, 814, 8, 72, 10, 72, 12, 72, 817, 9, 72, 1, 72, 1, 72, 1, 72, 1, 72, 1, 72, 1, 73, 1, 73, 1, 73, 1, 73, 5, 73, 828, 8, 73, 10, 73, 12, 73, 831, 9, 73, 1, 73, 1, 73, 3, 651, 661, 815, 0, 74, 1, 1, 3, 2, 5, 3, 7, 4, 9, 5, 11, 6, 13, 7, 15, 8, 17, 9, 19, 10, 21, 11, 23, 12, 25, 13, 27, 14, 29, 15, 31, 16, 33, 17, 35, 18, 37, 19, 39, 20, 41, 21, 43, 22, 45, 23, 47, 24, 49, 25, 51, 26, 53, 27, 55, 28, 57, 29, 59, 30, 61, 31, 63, 32, 65, 33, 67, 34, 69, 35, 71, 36, 73, 37, 75, 38, 77, 39, 79, 40, 81, 41, 83, 42, 85, 43, 87, 44, 89, 45, 91, 46, 93, 47, 95, 48, 97, 49, 99, 50, 101, 51, 103, 52, 105, 53, 107, 54, 109, 55, 111, 56, 113, 57, 115, 58, 117, 59, 119, 60, 121, 61, 123, 62, 125, 63, 127, 64, 129, 65, 131, 66, 133, 67, 135, 68, 137, 69, 139, 70, 141, 71, 143, 72, 145, 73, 147, 74, 1, 0, 11, 1, 0, 48, 57, 2, 0, 69, 69, 101, 101, 1, 0, 49, 57, 3, 0, 10, 10, 13, 13, 34, 34, 3, 0, 10, 10, 13, 13, 39, 39, 2, 0, 88, 88, 120, 120, 3, 0, 48, 57, 65, 70, 97, 102, 2, 0, 65, 90, 97, 122, 4, 0, 48, 57, 65, 90, 95, 95, 97, 122, 3, 0, 9, 10, 12, 13, 32, 32, 2, 0, 10, 10, 13, 13, 870, 0, 1, 1, 0, 0, 0, 0, 3, 1, 0, 0, 0, 0, 5, 1, 0, 0, 0, 0, 7, 1, 0, 0, 0, 0, 9, 1, 0, 0, 0, 0, 11, 1, 0, 0, 0, 0, 13, 1, 0, 0, 0, 0, 15, 1, 0, 0, 0, 0, 17, 1, 0, 0, 0, 0, 19, 1, 0, 0, 0, 0, 21, 1, 0, 0, 0, 0, 23, 1, 0, 0, 0, 0, 25, 1, 0, 0, 0, 0, 27, 1, 0, 0, 0, 0, 29, 1, 0, 0, 0, 0, 31, 1, 0, 0, 0, 0, 33, 1, 0, 0, 0, 0, 35, 1, 0, 0, 0, 0, 37, 1, 0, 0, 0, 0, 39, 1, 0, 0, 0, 0, 41, 1, 0, 0, 0, 0, 43, 1, 0, 0, 0, 0, 45, 1, 0, 0, 0, 0, 47, 1, 0, 0, 0, 0, 49, 1, 0, 0, 0, 0, 51, 1, 0, 0, 0, 0, 53, 1, 0, 0, 0, 0, 55, 1, 0, 0, 0, 0, 57, 1, 0, 0, 0, 0, 59, 1, 0, 0, 0, 0, 61, 1, 0, 0, 0, 0, 63, 1, 0, 0, 0, 0, 65, 1, 0, 0, 0, 0, 67, 1, 0, 0, 0, 0, 69, 1, 0, 0, 0, 0, 71, 1, 0, 0, 0, 0, 73, 1, 0, 0, 0, 0, 75, 1, 0, 0, 0, 0, 77, 1, 0, 0, 0, 0, 79, 1, 0, 0, 0, 0, 81, 1, 0, 0, 0, 0, 83, 1, 0, 0, 0, 0, 85, 1, 0, 0, 0, 0, 87, 1, 0, 0, 0, 0, 89, 1, 0, 0, 0, 0, 91, 1, 0, 0, 0, 0, 93, 1, 0, 0, 0, 0, 95, 1, 0, 0, 0, 0, 97, 1, 0, 0, 0, 0, 99, 1, 0, 0, 0, 0, 101, 1, 0, 0, 0, 0, 103, 1, 0, 0, 0, 0, 105, 1, 0, 0, 0, 0, 107, 1, 0, 0, 0, 0, 109, 1, 0, 0, 0, 0, 111, 1, 0, 0, 0, 0, 113, 1, 0, 0, 0, 0, 115, 1, 0, 0, 0, 0, 117, 1, 0, 0, 0, 0, 119, 1, 0, 0, 0, 0, 121, 1, 0, 0, 0, 0, 123, 1, 0, 0, 0, 0, 125, 1, 0, 0, 0, 0, 127, 1, 0, 0, 0, 0, 129, 1, 0, 0, 0, 0, 131, 1, 0, 0, 0, 0, 133, 1, 0, 0, 0, 0, 135, 1, 0, 0, 0, 0, 137, 1, 0, 0, 0, 0, 139, 1, 0, 0, 0, 0, 141, 1, 0, 0, 0, 0, 143, 1, 0, 0, 0, 0, 145, 1, 0, 0, 0, 0, 147, 1, 0, 0, 0, 1, 149, 1, 0, 0, 0, 3, 156, 1, 0, 0, 0, 5, 158, 1, 0, 0, 0, 7, 169, 1, 0, 0, 0, 9, 171, 1, 0, 0, 0, 11, 173, 1, 0, 0, 0, 13, 176, 1, 0, 0, 0, 15, 178, 1, 0, 0, 0, 17, 180, 1, 0, 0, 0, 19, 183, 1, 0, 0, 0, 21, 185, 1, 0, 0, 0, 23, 194, 1, 0, 0, 0, 25, 196, 1, 0, 0, 0, 27, 198, 1, 0, 0, 0, 29, 207, 1, 0, 0, 0, 31, 209, 1, 0, 0, 0, 33, 211, 1, 0, 0, 0, 35, 213, 1, 0, 0, 0, 37, 221, 1, 0, 0, 0, 39, 224, 1, 0, 0, 0, 41, 229, 1, 0, 0, 0, 43, 241, 1, 0, 0, 0, 45, 245, 1, 0, 0, 0, 47, 247, 1, 0, 0, 0, 49, 249, 1, 0, 0, 0, 51, 260, 1, 0, 0, 0, 53, 267, 1, 0, 0, 0, 55, 284, 1, 0, 0, 0, 57, 299, 1, 0, 0, 0, 59, 314, 1, 0, 0, 0, 61, 327, 1, 0, 0, 0, 63, 337, 1, 0, 0, 0, 65, 362, 1, 0, 0, 0, 67, 377, 1, 0, 0, 0, 69, 396, 1, 0, 0, 0, 71, 412, 1, 0, 0, 0, 73, 423, 1, 0, 0, 0, 75, 431, 1, 0, 0, 0, 77, 438, 1, 0, 0, 0, 79, 440, 1, 0, 0, 0, 81, 442, 1, 0, 0, 0, 83, 444, 1, 0, 0, 0, 85, 446, 1, 0, 0, 0, 87, 448, 1, 0, 0, 0, 89, 450, 1, 0, 0, 0, 91, 453, 1, 0, 0, 0, 93, 456, 1, 0, 0, 0, 95, 458, 1, 0, 0, 0, 97, 460, 1, 0, 0, 0, 99, 463, 1, 0, 0, 0, 101, 466, 1, 0, 0, 0, 103, 475, 1, 0, 0, 0, 105, 479, 1, 0, 0, 0, 107, 484, 1, 0, 0, 0, 109, 491, 1, 0, 0, 0, 111, 498, 1, 0, 0, 0, 113, 502, 1, 0, 0, 0, 115, 511, 1, 0, 0, 0, 117, 536, 1, 0, 0, 0, 119, 595, 1, 0, 0, 0, 121, 598, 1, 0, 0, 0, 123, 605, 1, 0, 0, 0, 125, 620, 1, 0, 0, 0, 127, 636, 1, 0, 0, 0, 129, 638, 1, 0, 0, 0, 131, 665, 1, 0, 0, 0, 133, 667, 1, 0, 0, 0, 135, 676, 1, 0, 0, 0, 137, 697, 1, 0, 0, 0, 139, 793, 1, 0, 0, 0, 141, 795, 1, 0, 0, 0, 143, 803, 1, 0, 0, 0, 145, 809, 1, 0, 0, 0, 147, 823, 1, 0, 0, 0, 149, 150, 5, 112, 0, 0, 150, 151, 5, 114, 0, 0, 151, 152, 5, 97, 0, 0, 152, 153, 5, 103, 0, 0, 153, 154, 5, 109, 0, 0, 154, 155, 5, 97, 0, 0, 155, 2, 1, 0, 0, 0, 156, 157, 5, 59, 0, 0, 157, 4, 1, 0, 0, 0, 158, 159, 5, 99, 0, 0, 159, 160, 5, 97, 0, 0, 160, 161, 5, 115, 0, 0, 161, 162, 5, 104, 0, 0, 162, 163, 5, 115, 0, 0, 163, 164, 5, 99, 0, 0, 164, 165, 5, 114, 0, 0, 165, 166, 5, 105, 0, 0, 166, 167, 5, 112, 0, 0, 167, 168, 5, 116, 0, 0, 168, 6, 1, 0, 0, 0, 169, 170, 5, 94, 0, 0, 170, 8, 1, 0, 0, 0, 171, 172, 5, 126, 0, 0, 172, 10, 1, 0, 0, 0, 173, 174, 5, 62, 0, 0, 174, 175, 5, 61, 0, 0, 175, 12, 1, 0, 0, 0, 176, 177, 5, 62, 0, 0, 177, 14, 1, 0, 0, 0, 178, 179, 5, 60, 0, 0, 179, 16, 1, 0, 0, 0, 180, 181, 5, 60, 0, 0, 181, 182, 5, 61, 0, 0, 182, 18, 1, 0, 0, 0, 183, 184, 5, 61, 0, 0, 184, 20, 1, 0, 0, 0, 185, 186, 5, 99, 0, 0, 186, 187, 5, 111, 0, 0, 187, 188, 5, 110, 0, 0, 188, 189, 5, 116, 0, 0, 189, 190, 5, 114, 0, 0, 190, 191, 5, 97, 0, 0, 191, 192, 5, 99, 0, 0, 192, 193, 5, 116, 0, 0, 193, 22, 1, 0, 0, 0, 194, 195, 5, 123, 0, 0, 195, 24, 1, 0, 0, 0, 196, 197, 5, 125, 0, 0, 197, 26, 1, 0, 0, 0, 198, 199, 5, 102, 0, 0, 199, 200, 5, 117, 0, 0, 200, 201, 5, 110, 0, 0, 201, 202, 5, 99, 0, 0, 202, 203, 5, 116, 0, 0, 203, 204, 5, 105, 0, 0, 204, 205, 5, 111, 0, 0, 205, 206, 5, 110, 0, 0, 206, 28, 1, 0, 0, 0, 207, 208, 5, 40, 0, 0, 208, 30, 1, 0, 0, 0, 209, 210, 5, 44, 0, 0, 210, 32, 1, 0, 0, 0, 211, 212, 5, 41, 0, 0, 212, 34, 1, 0, 0, 0, 213, 214, 5, 114, 0, 0, 214, 215, 5, 101, 0, 0, 215, 216, 5, 113, 0, 0, 216, 217, 5, 117, 0, 0, 217, 218, 5, 105, 0, 0, 218, 219, 5, 114, 0, 0, 219, 220, 5, 101, 0, 0, 220, 36, 1, 0, 0, 0, 221, 222, 5, 105, 0, 0, 222, 223, 5, 102, 0, 0, 223, 38, 1, 0, 0, 0, 224, 225, 5, 101, 0, 0, 225, 226, 5, 108, 0, 0, 226, 227, 5, 115, 0, 0, 227, 228, 5, 101, 0, 0, 228, 40, 1, 0, 0, 0, 229, 230, 5, 99, 0, 0, 230, 231, 5, 111, 0, 0, 231, 232, 5, 110, 0, 0, 232, 233, 5, 115, 0, 0, 233, 234, 5, 111, 0, 0, 234, 235, 5, 108, 0, 0, 235, 236, 5, 101, 0, 0, 236, 237, 5, 46, 0, 0, 237, 238, 5, 108, 0, 0, 238, 239, 5, 111, 0, 0, 239, 240, 5, 103, 0, 0, 240, 42, 1, 0, 0, 0, 241, 242, 5, 110, 0, 0, 242, 243, 5, 101, 0, 0, 243, 244, 5, 119, 0, 0, 244, 44, 1, 0, 0, 0, 245, 246, 5, 91, 0, 0, 246, 46, 1, 0, 0, 0, 247, 248, 5, 93, 0, 0, 248, 48, 1, 0, 0, 0, 249, 250, 5, 116, 0, 0, 250, 251, 5, 120, 0, 0, 251, 252, 5, 46, 0, 0, 252, 253, 5, 111, 0, 0, 253, 254, 5, 117, 0, 0, 254, 255, 5, 116, 0, 0, 255, 256, 5, 112, 0, 0, 256, 257, 5, 117, 0, 0, 257, 258, 5, 116, 0, 0, 258, 259, 5, 115, 0, 0, 259, 50, 1, 0, 0, 0, 260, 261, 5, 46, 0, 0, 261, 262, 5, 118, 0, 0, 262, 263, 5, 97, 0, 0, 263, 264, 5, 108, 0, 0, 264, 265, 5, 117, 0, 0, 265, 266, 5, 101, 0, 0, 266, 52, 1, 0, 0, 0, 267, 268, 5, 46, 0, 0, 268, 269, 5, 108, 0, 0, 269, 270, 5, 111, 0, 0, 270, 271, 5, 99, 0, 0, 271, 272, 5, 107, 0, 0, 272, 273, 5, 105, 0, 0, 273, 274, 5, 110, 0, 0, 274, 275, 5, 103, 0, 0, 275, 276, 5, 66, 0, 0, 276, 277, 5, 121, 0, 0, 277, 278, 5, 116, 0, 0, 278, 279, 5, 101, 0, 0, 279, 280, 5, 99, 0, 0, 280, 281, 5, 111, 0, 0, 281, 282, 5, 100, 0, 0, 282, 283, 5, 101, 0, 0, 283, 54, 1, 0, 0, 0, 284, 285, 5, 46, 0, 0, 285, 286, 5, 116, 0, 0, 286, 287, 5, 111, 0, 0, 287, 288, 5, 107, 0, 0, 288, 289, 5, 101, 0, 0, 289, 290, 5, 110, 0, 0, 290, 291, 5, 67, 0, 0, 291, 292, 5, 97, 0, 0, 292, 293, 5, 116, 0, 0, 293, 294, 5, 101, 0, 0, 294, 295, 5, 103, 0, 0, 295, 296, 5, 111, 0, 0, 296, 297, 5, 114, 0, 0, 297, 298, 5, 121, 0, 0, 298, 56, 1, 0, 0, 0, 299, 300, 5, 46, 0, 0, 300, 301, 5, 110, 0, 0, 301, 302, 5, 102, 0, 0, 302, 303, 5, 116, 0, 0, 303, 304, 5, 67, 0, 0, 304, 305, 5, 111, 0, 0, 305, 306, 5, 109, 0, 0, 306, 307, 5, 109, 0, 0, 307, 308, 5, 105, 0, 0, 308, 309, 5, 116, 0, 0, 309, 310, 5, 109, 0, 0, 310, 311, 5, 101, 0, 0, 311, 312, 5, 110, 0, 0, 312, 313, 5, 116, 0, 0, 313, 58, 1, 0, 0, 0, 314, 315, 5, 46, 0, 0, 315, 316, 5, 116, 0, 0, 316, 317, 5, 111, 0, 0, 317, 318, 5, 107, 0, 0, 318, 319, 5, 101, 0, 0, 319, 320, 5, 110, 0, 0, 320, 321, 5, 65, 0, 0, 321, 322, 5, 109, 0, 0, 322, 323, 5, 111, 0, 0, 323, 324, 5, 117, 0, 0, 324, 325, 5, 110, 0, 0, 325, 326, 5, 116, 0, 0, 326, 60, 1, 0, 0, 0, 327, 328, 5, 116, 0, 0, 328, 329, 5, 120, 0, 0, 329, 330, 5, 46, 0, 0, 330, 331, 5, 105, 0, 0, 331, 332, 5, 110, 0, 0, 332, 333, 5, 112, 0, 0, 333, 334, 5, 117, 0, 0, 334, 335, 5, 116, 0, 0, 335, 336, 5, 115, 0, 0, 336, 62, 1, 0, 0, 0, 337, 338, 5, 46, 0, 0, 338, 339, 5, 111, 0, 0, 339, 340, 5, 117, 0, 0, 340, 341, 5, 116, 0, 0, 341, 342, 5, 112, 0, 0, 342, 343, 5, 111, 0, 0, 343, 344, 5, 105, 0, 0, 344, 345, 5, 110, 0, 0, 345, 346, 5, 116, 0, 0, 346, 347, 5, 84, 0, 0, 347, 348, 5, 114, 0, 0, 348, 349, 5, 97, 0, 0, 349, 350, 5, 110, 0, 0, 350, 351, 5, 115, 0, 0, 351, 352, 5, 97, 0, 0, 352, 353, 5, 99, 0, 0, 353, 354, 5, 116, 0, 0, 354, 355, 5, 105, 0, 0, 355, 356, 5, 111, 0, 0, 356, 357, 5, 110, 0, 0, 357, 358, 5, 72, 0, 0, 358, 359, 5, 97, 0, 0, 359, 360, 5, 115, 0, 0, 360, 361, 5, 104, 0, 0, 361, 64, 1, 0, 0, 0, 362, 363, 5, 46, 0, 0, 363, 364, 5, 111, 0, 0, 364, 365, 5, 117, 0, 0, 365, 366, 5, 116, 0, 0, 366, 367, 5, 112, 0, 0, 367, 368, 5, 111, 0, 0, 368, 369, 5, 105, 0, 0, 369, 370, 5, 110, 0, 0, 370, 371, 5, 116, 0, 0, 371, 372, 5, 73, 0, 0, 372, 373, 5, 110, 0, 0, 373, 374, 5, 100, 0, 0, 374, 375, 5, 101, 0, 0, 375, 376, 5, 120, 0, 0, 376, 66, 1, 0, 0, 0, 377, 378, 5, 46, 0, 0, 378, 379, 5, 117, 0, 0, 379, 380, 5, 110, 0, 0, 380, 381, 5, 108, 0, 0, 381, 382, 5, 111, 0, 0, 382, 383, 5, 99, 0, 0, 383, 384, 5, 107, 0, 0, 384, 385, 5, 105, 0, 0, 385, 386, 5, 110, 0, 0, 386, 387, 5, 103, 0, 0, 387, 388, 5, 66, 0, 0, 388, 389, 5, 121, 0, 0, 389, 390, 5, 116, 0, 0, 390, 391, 5, 101, 0, 0, 391, 392, 5, 99, 0, 0, 392, 393, 5, 111, 0, 0, 393, 394, 5, 100, 0, 0, 394, 395, 5, 101, 0, 0, 395, 68, 1, 0, 0, 0, 396, 397, 5, 46, 0, 0, 397, 398, 5, 115, 0, 0, 398, 399, 5, 101, 0, 0, 399, 400, 5, 113, 0, 0, 400, 401, 5, 117, 0, 0, 401, 402, 5, 101, 0, 0, 402, 403, 5, 110, 0, 0, 403, 404, 5, 99, 0, 0, 404, 405, 5, 101, 0, 0, 405, 406, 5, 78, 0, 0, 406, 407, 5, 117, 0, 0, 407, 408, 5, 109, 0, 0, 408, 409, 5, 98, 0, 0, 409, 410, 5, 101, 0, 0, 410, 411, 5, 114, 0, 0, 411, 70, 1, 0, 0, 0, 412, 413, 5, 46, 0, 0, 413, 414, 5, 114, 0, 0, 414, 415, 5, 101, 0, 0, 415, 416, 5, 118, 0, 0, 416, 417, 5, 101, 0, 0, 417, 418, 5, 114, 0, 0, 418, 419, 5, 115, 0, 0, 419, 420, 5, 101, 0, 0, 420, 421, 5, 40, 0, 0, 421, 422, 5, 41, 0, 0, 422, 72, 1, 0, 0, 0, 423, 424, 5, 46, 0, 0, 424, 425, 5, 108, 0, 0, 425, 426, 5, 101, 0, 0, 426, 427, 5, 110, 0, 0, 427, 428, 5, 103, 0, 0, 428, 429, 5, 116, 0, 0, 429, 430, 5, 104, 0, 0, 430, 74, 1, 0, 0, 0, 431, 432, 5, 46, 0, 0, 432, 433, 5, 115, 0, 0, 433, 434, 5, 112, 0, 0, 434, 435, 5, 108, 0, 0, 435, 436, 5, 105, 0, 0, 436, 437, 5, 116, 0, 0, 437, 76, 1, 0, 0, 0, 438, 439, 5, 33, 0, 0, 439, 78, 1, 0, 0, 0, 440, 441, 5, 45, 0, 0, 441, 80, 1, 0, 0, 0, 442, 443, 5, 42, 0, 0, 443, 82, 1, 0, 0, 0, 444, 445, 5, 47, 0, 0, 445, 84, 1, 0, 0, 0, 446, 447, 5, 37, 0, 0, 447, 86, 1, 0, 0, 0, 448, 449, 5, 43, 0, 0, 449, 88, 1, 0, 0, 0, 450, 451, 5, 61, 0, 0, 451, 452, 5, 61, 0, 0, 452, 90, 1, 0, 0, 0, 453, 454, 5, 33, 0, 0, 454, 455, 5, 61, 0, 0, 455, 92, 1, 0, 0, 0, 456, 457, 5, 38, 0, 0, 457, 94, 1, 0, 0, 0, 458, 459, 5, 124, 0, 0, 459, 96, 1, 0, 0, 0, 460, 461, 5, 38, 0, 0, 461, 462, 5, 38, 0, 0, 462, 98, 1, 0, 0, 0, 463, 464, 5, 124, 0, 0, 464, 465, 5, 124, 0, 0, 465, 100, 1, 0, 0, 0, 466, 467, 5, 99, 0, 0, 467, 468, 5, 111, 0, 0, 468, 469, 5, 110, 0, 0, 469, 470, 5, 115, 0, 0, 470, 471, 5, 116, 0, 0, 471, 472, 5, 97, 0, 0, 472, 473, 5, 110, 0, 0, 473, 474, 5, 116, 0, 0, 474, 102, 1, 0, 0, 0, 475, 476, 5, 105, 0, 0, 476, 477, 5, 110, 0, 0, 477, 478, 5, 116, 0, 0, 478, 104, 1, 0, 0, 0, 479, 480, 5, 98, 0, 0, 480, 481, 5, 111, 0, 0, 481, 482, 5, 111, 0, 0, 482, 483, 5, 108, 0, 0, 483, 106, 1, 0, 0, 0, 484, 485, 5, 115, 0, 0, 485, 486, 5, 116, 0, 0, 486, 487, 5, 114, 0, 0, 487, 488, 5, 105, 0, 0, 488, 489, 5, 110, 0, 0, 489, 490, 5, 103, 0, 0, 490, 108, 1, 0, 0, 0, 491, 492, 5, 112, 0, 0, 492, 493, 5, 117, 0, 0, 493, 494, 5, 98, 0, 0, 494, 495, 5, 107, 0, 0, 495, 496, 5, 101, 0, 0, 496, 497, 5, 121, 0, 0, 497, 110, 1, 0, 0, 0, 498, 499, 5, 115, 0, 0, 499, 500, 5, 105, 0, 0, 500, 501, 5, 103, 0, 0, 501, 112, 1, 0, 0, 0, 502, 503, 5, 100, 0, 0, 503, 504, 5, 97, 0, 0, 504, 505, 5, 116, 0, 0, 505, 506, 5, 97, 0, 0, 506, 507, 5, 115, 0, 0, 507, 508, 5, 105, 0, 0, 508, 509, 5, 103, 0, 0, 509, 114, 1, 0, 0, 0, 510, 512, 7, 0, 0, 0, 511, 510, 1, 0, 0, 0, 512, 513, 1, 0, 0, 0, 513, 511, 1, 0, 0, 0, 513, 514, 1, 0, 0, 0, 514, 515, 1, 0, 0, 0, 515, 517, 5, 46, 0, 0, 516, 518, 7, 0, 0, 0, 517, 516, 1, 0, 0, 0, 518, 519, 1, 0, 0, 0, 519, 517, 1, 0, 0, 0, 519, 520, 1, 0, 0, 0, 520, 521, 1, 0, 0, 0, 521, 523, 5, 46, 0, 0, 522, 524, 7, 0, 0, 0, 523, 522, 1, 0, 0, 0, 524, 525, 1, 0, 0, 0, 525, 523, 1, 0, 0, 0, 525, 526, 1, 0, 0, 0, 526, 116, 1, 0, 0, 0, 527, 528, 5, 116, 0, 0, 528, 529, 5, 114, 0, 0, 529, 530, 5, 117, 0, 0, 530, 537, 5, 101, 0, 0, 531, 532, 5, 102, 0, 0, 532, 533, 5, 97, 0, 0, 533, 534, 5, 108, 0, 0, 534, 535, 5, 115, 0, 0, 535, 537, 5, 101, 0, 0, 536, 527, 1, 0, 0, 0, 536, 531, 1, 0, 0, 0, 537, 118, 1, 0, 0, 0, 538, 539, 5, 115, 0, 0, 539, 540, 5, 97, 0, 0, 540, 541, 5, 116, 0, 0, 541, 542, 5, 111, 0, 0, 542, 543, 5, 115, 0, 0, 543, 544, 5, 104, 0, 0, 544, 545, 5, 105, 0, 0, 545, 596, 5, 115, 0, 0, 546, 547, 5, 115, 0, 0, 547, 548, 5, 97, 0, 0, 548, 549, 5, 116, 0, 0, 549, 596, 5, 115, 0, 0, 550, 551, 5, 102, 0, 0, 551, 552, 5, 105, 0, 0, 552, 553, 5, 110, 0, 0, 553, 554, 5, 110, 0, 0, 554, 555, 5, 101, 0, 0, 555, 596, 5, 121, 0, 0, 556, 557, 5, 98, 0, 0, 557, 558, 5, 105, 0, 0, 558, 559, 5, 116, 0, 0, 559, 596, 5, 115, 0, 0, 560, 561, 5, 98, 0, 0, 561, 562, 5, 105, 0, 0, 562, 563, 5, 116, 0, 0, 563, 564, 5, 99, 0, 0, 564, 565, 5, 111, 0, 0, 565, 566, 5, 105, 0, 0, 566, 596, 5, 110, 0, 0, 567, 568, 5, 115, 0, 0, 568, 569, 5, 101, 0, 0, 569, 570, 5, 99, 0, 0, 570, 571, 5, 111, 0, 0, 571, 572, 5, 110, 0, 0, 572, 573, 5, 100, 0, 0, 573, 596, 5, 115, 0, 0, 574, 575, 5, 109, 0, 0, 575, 576, 5, 105, 0, 0, 576, 577, 5, 110, 0, 0, 577, 578, 5, 117, 0, 0, 578, 579, 5, 116, 0, 0, 579, 580, 5, 101, 0, 0, 580, 596, 5, 115, 0, 0, 581, 582, 5, 104, 0, 0, 582, 583, 5, 111, 0, 0, 583, 584, 5, 117, 0, 0, 584, 585, 5, 114, 0, 0, 585, 596, 5, 115, 0, 0, 586, 587, 5, 100, 0, 0, 587, 588, 5, 97, 0, 0, 588, 589, 5, 121, 0, 0, 589, 596, 5, 115, 0, 0, 590, 591, 5, 119, 0, 0, 591, 592, 5, 101, 0, 0, 592, 593, 5, 101, 0, 0, 593, 594, 5, 107, 0, 0, 594, 596, 5, 115, 0, 0, 595, 538, 1, 0, 0, 0, 595, 546, 1, 0, 0, 0, 595, 550, 1, 0, 0, 0, 595, 556, 1, 0, 0, 0, 595, 560, 1, 0, 0, 0, 595, 567, 1, 0, 0, 0, 595, 574, 1, 0, 0, 0, 595, 581, 1, 0, 0, 0, 595, 586, 1, 0, 0, 0, 595, 590, 1, 0, 0, 0, 596, 120, 1, 0, 0, 0, 597, 599, 5, 45, 0, 0, 598, 597, 1, 0, 0, 0, 598, 599, 1, 0, 0, 0, 599, 600, 1, 0, 0, 0, 600, 602, 3, 123, 61, 0, 601, 603, 3, 125, 62, 0, 602, 601, 1, 0, 0, 0, 602, 603, 1, 0, 0, 0, 603, 122, 1, 0, 0, 0, 604, 606, 7, 0, 0, 0, 605, 604, 1, 0, 0, 0, 606, 607, 1, 0, 0, 0, 607, 605, 1, 0, 0, 0, 607, 608, 1, 0, 0, 0, 608, 617, 1, 0, 0, 0, 609, 611, 5, 95, 0, 0, 610, 612, 7, 0, 0, 0, 611, 610, 1, 0, 0, 0, 612, 613, 1, 0, 0, 0, 613, 611, 1, 0, 0, 0, 613, 614, 1, 0, 0, 0, 614, 616, 1, 0, 0, 0, 615, 609, 1, 0, 0, 0, 616, 619, 1, 0, 0, 0, 617, 615, 1, 0, 0, 0, 617, 618, 1, 0, 0, 0, 618, 124, 1, 0, 0, 0, 619, 617, 1, 0, 0, 0, 620, 621, 7, 1, 0, 0, 621, 622, 3, 123, 61, 0, 622, 126, 1, 0, 0, 0, 623, 624, 5, 98, 0, 0, 624, 625, 5, 121, 0, 0, 625, 626, 5, 116, 0, 0, 626, 627, 5, 101, 0, 0, 627, 628, 5, 115, 0, 0, 628, 630, 1, 0, 0, 0, 629, 631, 3, 129, 64, 0, 630, 629, 1, 0, 0, 0, 630, 631, 1, 0, 0, 0, 631, 637, 1, 0, 0, 0, 632, 633, 5, 98, 0, 0, 633, 634, 5, 121, 0, 0, 634, 635, 5, 116, 0, 0, 635, 637, 5, 101, 0, 0, 636, 623, 1, 0, 0, 0, 636, 632, 1, 0, 0, 0, 637, 128, 1, 0, 0, 0, 638, 642, 7, 2, 0, 0, 639, 641, 7, 0, 0, 0, 640, 639, 1, 0, 0, 0, 641, 644, 1, 0, 0, 0, 642, 640, 1, 0, 0, 0, 642, 643, 1, 0, 0, 0, 643, 130, 1, 0, 0, 0, 644, 642, 1, 0, 0, 0, 645, 651, 5, 34, 0, 0, 646, 647, 5, 92, 0, 0, 647, 650, 5, 34, 0, 0, 648, 650, 8, 3, 0, 0, 649, 646, 1, 0, 0, 0, 649, 648, 1, 0, 0, 0, 650, 653, 1, 0, 0, 0, 651, 652, 1, 0, 0, 0, 651, 649, 1, 0, 0, 0, 652, 654, 1, 0, 0, 0, 653, 651, 1, 0, 0, 0, 654, 666, 5, 34, 0, 0, 655, 661, 5, 39, 0, 0, 656, 657, 5, 92, 0, 0, 657, 660, 5, 39, 0, 0, 658, 660, 8, 4, 0, 0, 659, 656, 1, 0, 0, 0, 659, 658, 1, 0, 0, 0, 660, 663, 1, 0, 0, 0, 661, 662, 1, 0, 0, 0, 661, 659, 1, 0, 0, 0, 662, 664, 1, 0, 0, 0, 663, 661, 1, 0, 0, 0, 664, 666, 5, 39, 0, 0, 665, 645, 1, 0, 0, 0, 665, 655, 1, 0, 0, 0, 666, 132, 1, 0, 0, 0, 667, 668, 5, 100, 0, 0, 668, 669, 5, 97, 0, 0, 669, 670, 5, 116, 0, 0, 670, 671, 5, 101, 0, 0, 671, 672, 5, 40, 0, 0, 672, 673, 1, 0, 0, 0, 673, 674, 3, 131, 65, 0, 674, 675, 5, 41, 0, 0, 675, 134, 1, 0, 0, 0, 676, 677, 5, 48, 0, 0, 677, 681, 7, 5, 0, 0, 678, 680, 7, 6, 0, 0, 679, 678, 1, 0, 0, 0, 680, 683, 1, 0, 0, 0, 681, 679, 1, 0, 0, 0, 681, 682, 1, 0, 0, 0, 682, 136, 1, 0, 0, 0, 683, 681, 1, 0, 0, 0, 684, 685, 5, 116, 0, 0, 685, 686, 5, 120, 0, 0, 686, 687, 5, 46, 0, 0, 687, 688, 5, 97, 0, 0, 688, 689, 5, 103, 0, 0, 689, 698, 5, 101, 0, 0, 690, 691, 5, 116, 0, 0, 691, 692, 5, 120, 0, 0, 692, 693, 5, 46, 0, 0, 693, 694, 5, 116, 0, 0, 694, 695, 5, 105, 0, 0, 695, 696, 5, 109, 0, 0, 696, 698, 5, 101, 0, 0, 697, 684, 1, 0, 0, 0, 697, 690, 1, 0, 0, 0, 698, 138, 1, 0, 0, 0, 699, 700, 5, 116, 0, 0, 700, 701, 5, 104, 0, 0, 701, 702, 5, 105, 0, 0, 702, 703, 5, 115, 0, 0, 703, 704, 5, 46, 0, 0, 704, 705, 5, 97, 0, 0, 705, 706, 5, 99, 0, 0, 706, 707, 5, 116, 0, 0, 707, 708, 5, 105, 0, 0, 708, 709, 5, 118, 0, 0, 709, 710, 5, 101, 0, 0, 710, 711, 5, 73, 0, 0, 711, 712, 5, 110, 0, 0, 712, 713, 5, 112, 0, 0, 713, 714, 5, 117, 0, 0, 714, 715, 5, 116, 0, 0, 715, 716, 5, 73, 0, 0, 716, 717, 5, 110, 0, 0, 717, 718, 5, 100, 0, 0, 718, 719, 5, 101, 0, 0, 719, 794, 5, 120, 0, 0, 720, 721, 5, 116, 0, 0, 721, 722, 5, 104, 0, 0, 722, 723, 5, 105, 0, 0, 723, 724, 5, 115, 0, 0, 724, 725, 5, 46, 0, 0, 725, 726, 5, 97, 0, 0, 726, 727, 5, 99, 0, 0, 727, 728, 5, 116, 0, 0, 728, 729, 5, 105, 0, 0, 729, 730, 5, 118, 0, 0, 730, 731, 5, 101, 0, 0, 731, 732, 5, 66, 0, 0, 732, 733, 5, 121, 0, 0, 733, 734, 5, 116, 0, 0, 734, 735, 5, 101, 0, 0, 735, 736, 5, 99, 0, 0, 736, 737, 5, 111, 0, 0, 737, 738, 5, 100, 0, 0, 738, 794, 5, 101, 0, 0, 739, 740, 5, 116, 0, 0, 740, 741, 5, 120, 0, 0, 741, 742, 5, 46, 0, 0, 742, 743, 5, 105, 0, 0, 743, 744, 5, 110, 0, 0, 744, 745, 5, 112, 0, 0, 745, 746, 5, 117, 0, 0, 746, 747, 5, 116, 0, 0, 747, 748, 5, 115, 0, 0, 748, 749, 5, 46, 0, 0, 749, 750, 5, 108, 0, 0, 750, 751, 5, 101, 0, 0, 751, 752, 5, 110, 0, 0, 752, 753, 5, 103, 0, 0, 753, 754, 5, 116, 0, 0, 754, 794, 5, 104, 0, 0, 755, 756, 5, 116, 0, 0, 756, 757, 5, 120, 0, 0, 757, 758, 5, 46, 0, 0, 758, 759, 5, 111, 0, 0, 759, 760, 5, 117, 0, 0, 760, 761, 5, 116, 0, 0, 761, 762, 5, 112, 0, 0, 762, 763, 5, 117, 0, 0, 763, 764, 5, 116, 0, 0, 764, 765, 5, 115, 0, 0, 765, 766, 5, 46, 0, 0, 766, 767, 5, 108, 0, 0, 767, 768, 5, 101, 0, 0, 768, 769, 5, 110, 0, 0, 769, 770, 5, 103, 0, 0, 770, 771, 5, 116, 0, 0, 771, 794, 5, 104, 0, 0, 772, 773, 5, 116, 0, 0, 773, 774, 5, 120, 0, 0, 774, 775, 5, 46, 0, 0, 775, 776, 5, 118, 0, 0, 776, 777, 5, 101, 0, 0, 777, 778, 5, 114, 0, 0, 778, 779, 5, 115, 0, 0, 779, 780, 5, 105, 0, 0, 780, 781, 5, 111, 0, 0, 781, 794, 5, 110, 0, 0, 782, 783, 5, 116, 0, 0, 783, 784, 5, 120, 0, 0, 784, 785, 5, 46, 0, 0, 785, 786, 5, 108, 0, 0, 786, 787, 5, 111, 0, 0, 787, 788, 5, 99, 0, 0, 788, 789, 5, 107, 0, 0, 789, 790, 5, 116, 0, 0, 790, 791, 5, 105, 0, 0, 791, 792, 5, 109, 0, 0, 792, 794, 5, 101, 0, 0, 793, 699, 1, 0, 0, 0, 793, 720, 1, 0, 0, 0, 793, 739, 1, 0, 0, 0, 793, 755, 1, 0, 0, 0, 793, 772, 1, 0, 0, 0, 793, 782, 1, 0, 0, 0, 794, 140, 1, 0, 0, 0, 795, 799, 7, 7, 0, 0, 796, 798, 7, 8, 0, 0, 797, 796, 1, 0, 0, 0, 798, 801, 1, 0, 0, 0, 799, 797, 1, 0, 0, 0, 799, 800, 1, 0, 0, 0, 800, 142, 1, 0, 0, 0, 801, 799, 1, 0, 0, 0, 802, 804, 7, 9, 0, 0, 803, 802, 1, 0, 0, 0, 804, 805, 1, 0, 0, 0, 805, 803, 1, 0, 0, 0, 805, 806, 1, 0, 0, 0, 806, 807, 1, 0, 0, 0, 807, 808, 6, 71, 0, 0, 808, 144, 1, 0, 0, 0, 809, 810, 5, 47, 0, 0, 810, 811, 5, 42, 0, 0, 811, 815, 1, 0, 0, 0, 812, 814, 9, 0, 0, 0, 813, 812, 1, 0, 0, 0, 814, 817, 1, 0, 0, 0, 815, 816, 1, 0, 0, 0, 815, 813, 1, 0, 0, 0, 816, 818, 1, 0, 0, 0, 817, 815, 1, 0, 0, 0, 818, 819, 5, 42, 0, 0, 819, 820, 5, 47, 0, 0, 820, 821, 1, 0, 0, 0, 821, 822, 6, 72, 1, 0, 822, 146, 1, 0, 0, 0, 823, 824, 5, 47, 0, 0, 824, 825, 5, 47, 0, 0, 825, 829, 1, 0, 0, 0, 826, 828, 8, 10, 0, 0, 827, 826, 1, 0, 0, 0, 828, 831, 1, 0, 0, 0, 829, 827, 1, 0, 0, 0, 829, 830, 1, 0, 0, 0, 830, 832, 1, 0, 0, 0, 831, 829, 1, 0, 0, 0, 832, 833, 6, 73, 1, 0, 833, 148, 1, 0, 0, 0, 26, 0, 513, 519, 525, 536, 595, 598, 602, 607, 613, 617, 630, 636, 642, 649, 651, 659, 661, 665, 681, 697, 793, 799, 805, 815, 829, 2, 6, 0, 0, 0, 1, 0]
\ No newline at end of file
diff --git a/packages/cashc/src/grammar/CashScriptLexer.tokens b/packages/cashc/src/grammar/CashScriptLexer.tokens
index c7289b6a..c4593418 100644
--- a/packages/cashc/src/grammar/CashScriptLexer.tokens
+++ b/packages/cashc/src/grammar/CashScriptLexer.tokens
@@ -59,17 +59,19 @@ VersionLiteral=58
 BooleanLiteral=59
 NumberUnit=60
 NumberLiteral=61
-Bytes=62
-Bound=63
-StringLiteral=64
-DateLiteral=65
-HexLiteral=66
-TxVar=67
-NullaryOp=68
-Identifier=69
-WHITESPACE=70
-COMMENT=71
-LINE_COMMENT=72
+NumberPart=62
+ExponentPart=63
+Bytes=64
+Bound=65
+StringLiteral=66
+DateLiteral=67
+HexLiteral=68
+TxVar=69
+NullaryOp=70
+Identifier=71
+WHITESPACE=72
+COMMENT=73
+LINE_COMMENT=74
 'pragma'=1
 ';'=2
 'cashscript'=3
diff --git a/packages/cashc/src/grammar/CashScriptLexer.ts b/packages/cashc/src/grammar/CashScriptLexer.ts
index 2d3a6ba5..3310a249 100644
--- a/packages/cashc/src/grammar/CashScriptLexer.ts
+++ b/packages/cashc/src/grammar/CashScriptLexer.ts
@@ -73,17 +73,19 @@ export default class CashScriptLexer extends Lexer {
 	public static readonly BooleanLiteral = 59;
 	public static readonly NumberUnit = 60;
 	public static readonly NumberLiteral = 61;
-	public static readonly Bytes = 62;
-	public static readonly Bound = 63;
-	public static readonly StringLiteral = 64;
-	public static readonly DateLiteral = 65;
-	public static readonly HexLiteral = 66;
-	public static readonly TxVar = 67;
-	public static readonly NullaryOp = 68;
-	public static readonly Identifier = 69;
-	public static readonly WHITESPACE = 70;
-	public static readonly COMMENT = 71;
-	public static readonly LINE_COMMENT = 72;
+	public static readonly NumberPart = 62;
+	public static readonly ExponentPart = 63;
+	public static readonly Bytes = 64;
+	public static readonly Bound = 65;
+	public static readonly StringLiteral = 66;
+	public static readonly DateLiteral = 67;
+	public static readonly HexLiteral = 68;
+	public static readonly TxVar = 69;
+	public static readonly NullaryOp = 70;
+	public static readonly Identifier = 71;
+	public static readonly WHITESPACE = 72;
+	public static readonly COMMENT = 73;
+	public static readonly LINE_COMMENT = 74;
 	public static readonly EOF = Token.EOF;
 
 	public static readonly channelNames: string[] = [ "DEFAULT_TOKEN_CHANNEL", "HIDDEN" ];
@@ -158,6 +160,8 @@ export default class CashScriptLexer extends Lexer {
                                                              "BooleanLiteral", 
                                                              "NumberUnit", 
                                                              "NumberLiteral", 
+                                                             "NumberPart", 
+                                                             "ExponentPart", 
                                                              "Bytes", "Bound", 
                                                              "StringLiteral", 
                                                              "DateLiteral", 
@@ -177,9 +181,9 @@ export default class CashScriptLexer extends Lexer {
 		"T__33", "T__34", "T__35", "T__36", "T__37", "T__38", "T__39", "T__40", 
 		"T__41", "T__42", "T__43", "T__44", "T__45", "T__46", "T__47", "T__48", 
 		"T__49", "T__50", "T__51", "T__52", "T__53", "T__54", "T__55", "T__56", 
-		"VersionLiteral", "BooleanLiteral", "NumberUnit", "NumberLiteral", "Bytes", 
-		"Bound", "StringLiteral", "DateLiteral", "HexLiteral", "TxVar", "NullaryOp", 
-		"Identifier", "WHITESPACE", "COMMENT", "LINE_COMMENT",
+		"VersionLiteral", "BooleanLiteral", "NumberUnit", "NumberLiteral", "NumberPart", 
+		"ExponentPart", "Bytes", "Bound", "StringLiteral", "DateLiteral", "HexLiteral", 
+		"TxVar", "NullaryOp", "Identifier", "WHITESPACE", "COMMENT", "LINE_COMMENT",
 	];
 
 
@@ -200,7 +204,7 @@ export default class CashScriptLexer extends Lexer {
 
 	public get modeNames(): string[] { return CashScriptLexer.modeNames; }
 
-	public static readonly _serializedATN: number[] = [4,0,72,820,6,-1,2,0,
+	public static readonly _serializedATN: number[] = [4,0,74,834,6,-1,2,0,
 	7,0,2,1,7,1,2,2,7,2,2,3,7,3,2,4,7,4,2,5,7,5,2,6,7,6,2,7,7,7,2,8,7,8,2,9,
 	7,9,2,10,7,10,2,11,7,11,2,12,7,12,2,13,7,13,2,14,7,14,2,15,7,15,2,16,7,
 	16,2,17,7,17,2,18,7,18,2,19,7,19,2,20,7,20,2,21,7,21,2,22,7,22,2,23,7,23,
@@ -210,265 +214,270 @@ export default class CashScriptLexer extends Lexer {
 	45,2,46,7,46,2,47,7,47,2,48,7,48,2,49,7,49,2,50,7,50,2,51,7,51,2,52,7,52,
 	2,53,7,53,2,54,7,54,2,55,7,55,2,56,7,56,2,57,7,57,2,58,7,58,2,59,7,59,2,
 	60,7,60,2,61,7,61,2,62,7,62,2,63,7,63,2,64,7,64,2,65,7,65,2,66,7,66,2,67,
-	7,67,2,68,7,68,2,69,7,69,2,70,7,70,2,71,7,71,1,0,1,0,1,0,1,0,1,0,1,0,1,
-	0,1,1,1,1,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,3,1,3,1,4,1,4,1,
-	5,1,5,1,5,1,6,1,6,1,7,1,7,1,8,1,8,1,8,1,9,1,9,1,10,1,10,1,10,1,10,1,10,
-	1,10,1,10,1,10,1,10,1,11,1,11,1,12,1,12,1,13,1,13,1,13,1,13,1,13,1,13,1,
-	13,1,13,1,13,1,14,1,14,1,15,1,15,1,16,1,16,1,17,1,17,1,17,1,17,1,17,1,17,
-	1,17,1,17,1,18,1,18,1,18,1,19,1,19,1,19,1,19,1,19,1,20,1,20,1,20,1,20,1,
-	20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,21,1,21,1,21,1,21,1,22,1,22,1,23,
-	1,23,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,25,1,25,1,
-	25,1,25,1,25,1,25,1,25,1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,26,
-	1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,27,1,27,1,27,1,27,1,27,1,27,1,27,1,
-	27,1,27,1,27,1,27,1,27,1,27,1,27,1,27,1,28,1,28,1,28,1,28,1,28,1,28,1,28,
-	1,28,1,28,1,28,1,28,1,28,1,28,1,28,1,28,1,29,1,29,1,29,1,29,1,29,1,29,1,
-	29,1,29,1,29,1,29,1,29,1,29,1,29,1,30,1,30,1,30,1,30,1,30,1,30,1,30,1,30,
-	1,30,1,30,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,
-	31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,32,1,32,
-	1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,33,1,
-	33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,
-	1,33,1,33,1,33,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,
-	34,1,34,1,34,1,34,1,34,1,35,1,35,1,35,1,35,1,35,1,35,1,35,1,35,1,35,1,35,
-	1,35,1,36,1,36,1,36,1,36,1,36,1,36,1,36,1,36,1,37,1,37,1,37,1,37,1,37,1,
-	37,1,37,1,38,1,38,1,39,1,39,1,40,1,40,1,41,1,41,1,42,1,42,1,43,1,43,1,44,
-	1,44,1,44,1,45,1,45,1,45,1,46,1,46,1,47,1,47,1,48,1,48,1,48,1,49,1,49,1,
-	49,1,50,1,50,1,50,1,50,1,50,1,50,1,50,1,50,1,50,1,51,1,51,1,51,1,51,1,52,
-	1,52,1,52,1,52,1,52,1,53,1,53,1,53,1,53,1,53,1,53,1,53,1,54,1,54,1,54,1,
-	54,1,54,1,54,1,54,1,55,1,55,1,55,1,55,1,56,1,56,1,56,1,56,1,56,1,56,1,56,
-	1,56,1,57,4,57,508,8,57,11,57,12,57,509,1,57,1,57,4,57,514,8,57,11,57,12,
-	57,515,1,57,1,57,4,57,520,8,57,11,57,12,57,521,1,58,1,58,1,58,1,58,1,58,
-	1,58,1,58,1,58,1,58,3,58,533,8,58,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,
+	7,67,2,68,7,68,2,69,7,69,2,70,7,70,2,71,7,71,2,72,7,72,2,73,7,73,1,0,1,
+	0,1,0,1,0,1,0,1,0,1,0,1,1,1,1,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,2,1,
+	2,1,3,1,3,1,4,1,4,1,5,1,5,1,5,1,6,1,6,1,7,1,7,1,8,1,8,1,8,1,9,1,9,1,10,
+	1,10,1,10,1,10,1,10,1,10,1,10,1,10,1,10,1,11,1,11,1,12,1,12,1,13,1,13,1,
+	13,1,13,1,13,1,13,1,13,1,13,1,13,1,14,1,14,1,15,1,15,1,16,1,16,1,17,1,17,
+	1,17,1,17,1,17,1,17,1,17,1,17,1,18,1,18,1,18,1,19,1,19,1,19,1,19,1,19,1,
+	20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,20,1,21,1,21,1,21,
+	1,21,1,22,1,22,1,23,1,23,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,24,1,
+	24,1,24,1,25,1,25,1,25,1,25,1,25,1,25,1,25,1,26,1,26,1,26,1,26,1,26,1,26,
+	1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,26,1,27,1,27,1,27,1,
+	27,1,27,1,27,1,27,1,27,1,27,1,27,1,27,1,27,1,27,1,27,1,27,1,28,1,28,1,28,
+	1,28,1,28,1,28,1,28,1,28,1,28,1,28,1,28,1,28,1,28,1,28,1,28,1,29,1,29,1,
+	29,1,29,1,29,1,29,1,29,1,29,1,29,1,29,1,29,1,29,1,29,1,30,1,30,1,30,1,30,
+	1,30,1,30,1,30,1,30,1,30,1,30,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,
+	31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,1,31,
+	1,31,1,31,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,32,1,
+	32,1,32,1,32,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,33,
+	1,33,1,33,1,33,1,33,1,33,1,33,1,33,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,
+	34,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,34,1,35,1,35,1,35,1,35,1,35,1,35,
+	1,35,1,35,1,35,1,35,1,35,1,36,1,36,1,36,1,36,1,36,1,36,1,36,1,36,1,37,1,
+	37,1,37,1,37,1,37,1,37,1,37,1,38,1,38,1,39,1,39,1,40,1,40,1,41,1,41,1,42,
+	1,42,1,43,1,43,1,44,1,44,1,44,1,45,1,45,1,45,1,46,1,46,1,47,1,47,1,48,1,
+	48,1,48,1,49,1,49,1,49,1,50,1,50,1,50,1,50,1,50,1,50,1,50,1,50,1,50,1,51,
+	1,51,1,51,1,51,1,52,1,52,1,52,1,52,1,52,1,53,1,53,1,53,1,53,1,53,1,53,1,
+	53,1,54,1,54,1,54,1,54,1,54,1,54,1,54,1,55,1,55,1,55,1,55,1,56,1,56,1,56,
+	1,56,1,56,1,56,1,56,1,56,1,57,4,57,512,8,57,11,57,12,57,513,1,57,1,57,4,
+	57,518,8,57,11,57,12,57,519,1,57,1,57,4,57,524,8,57,11,57,12,57,525,1,58,
+	1,58,1,58,1,58,1,58,1,58,1,58,1,58,1,58,3,58,537,8,58,1,59,1,59,1,59,1,
 	59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,
 	1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,
 	59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,
-	1,59,1,59,1,59,1,59,1,59,1,59,3,59,592,8,59,1,60,3,60,595,8,60,1,60,4,60,
-	598,8,60,11,60,12,60,599,1,60,1,60,4,60,604,8,60,11,60,12,60,605,3,60,608,
-	8,60,1,61,1,61,1,61,1,61,1,61,1,61,1,61,3,61,617,8,61,1,61,1,61,1,61,1,
-	61,3,61,623,8,61,1,62,1,62,5,62,627,8,62,10,62,12,62,630,9,62,1,63,1,63,
-	1,63,1,63,5,63,636,8,63,10,63,12,63,639,9,63,1,63,1,63,1,63,1,63,1,63,5,
-	63,646,8,63,10,63,12,63,649,9,63,1,63,3,63,652,8,63,1,64,1,64,1,64,1,64,
-	1,64,1,64,1,64,1,64,1,64,1,65,1,65,1,65,5,65,666,8,65,10,65,12,65,669,9,
-	65,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,3,66,
-	684,8,66,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,
-	67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,
-	1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,
-	67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,
-	1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,
-	67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,
-	1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,1,67,3,67,780,8,67,1,68,1,68,5,
-	68,784,8,68,10,68,12,68,787,9,68,1,69,4,69,790,8,69,11,69,12,69,791,1,69,
-	1,69,1,70,1,70,1,70,1,70,5,70,800,8,70,10,70,12,70,803,9,70,1,70,1,70,1,
-	70,1,70,1,70,1,71,1,71,1,71,1,71,5,71,814,8,71,10,71,12,71,817,9,71,1,71,
-	1,71,3,637,647,801,0,72,1,1,3,2,5,3,7,4,9,5,11,6,13,7,15,8,17,9,19,10,21,
-	11,23,12,25,13,27,14,29,15,31,16,33,17,35,18,37,19,39,20,41,21,43,22,45,
-	23,47,24,49,25,51,26,53,27,55,28,57,29,59,30,61,31,63,32,65,33,67,34,69,
-	35,71,36,73,37,75,38,77,39,79,40,81,41,83,42,85,43,87,44,89,45,91,46,93,
-	47,95,48,97,49,99,50,101,51,103,52,105,53,107,54,109,55,111,56,113,57,115,
-	58,117,59,119,60,121,61,123,62,125,63,127,64,129,65,131,66,133,67,135,68,
-	137,69,139,70,141,71,143,72,1,0,12,1,0,48,57,1,0,45,45,2,0,69,69,101,101,
-	1,0,49,57,3,0,10,10,13,13,34,34,3,0,10,10,13,13,39,39,2,0,88,88,120,120,
-	3,0,48,57,65,70,97,102,2,0,65,90,97,122,4,0,48,57,65,90,95,95,97,122,3,
-	0,9,10,12,13,32,32,2,0,10,10,13,13,855,0,1,1,0,0,0,0,3,1,0,0,0,0,5,1,0,
-	0,0,0,7,1,0,0,0,0,9,1,0,0,0,0,11,1,0,0,0,0,13,1,0,0,0,0,15,1,0,0,0,0,17,
-	1,0,0,0,0,19,1,0,0,0,0,21,1,0,0,0,0,23,1,0,0,0,0,25,1,0,0,0,0,27,1,0,0,
-	0,0,29,1,0,0,0,0,31,1,0,0,0,0,33,1,0,0,0,0,35,1,0,0,0,0,37,1,0,0,0,0,39,
-	1,0,0,0,0,41,1,0,0,0,0,43,1,0,0,0,0,45,1,0,0,0,0,47,1,0,0,0,0,49,1,0,0,
-	0,0,51,1,0,0,0,0,53,1,0,0,0,0,55,1,0,0,0,0,57,1,0,0,0,0,59,1,0,0,0,0,61,
-	1,0,0,0,0,63,1,0,0,0,0,65,1,0,0,0,0,67,1,0,0,0,0,69,1,0,0,0,0,71,1,0,0,
-	0,0,73,1,0,0,0,0,75,1,0,0,0,0,77,1,0,0,0,0,79,1,0,0,0,0,81,1,0,0,0,0,83,
-	1,0,0,0,0,85,1,0,0,0,0,87,1,0,0,0,0,89,1,0,0,0,0,91,1,0,0,0,0,93,1,0,0,
-	0,0,95,1,0,0,0,0,97,1,0,0,0,0,99,1,0,0,0,0,101,1,0,0,0,0,103,1,0,0,0,0,
-	105,1,0,0,0,0,107,1,0,0,0,0,109,1,0,0,0,0,111,1,0,0,0,0,113,1,0,0,0,0,115,
-	1,0,0,0,0,117,1,0,0,0,0,119,1,0,0,0,0,121,1,0,0,0,0,123,1,0,0,0,0,125,1,
-	0,0,0,0,127,1,0,0,0,0,129,1,0,0,0,0,131,1,0,0,0,0,133,1,0,0,0,0,135,1,0,
-	0,0,0,137,1,0,0,0,0,139,1,0,0,0,0,141,1,0,0,0,0,143,1,0,0,0,1,145,1,0,0,
-	0,3,152,1,0,0,0,5,154,1,0,0,0,7,165,1,0,0,0,9,167,1,0,0,0,11,169,1,0,0,
-	0,13,172,1,0,0,0,15,174,1,0,0,0,17,176,1,0,0,0,19,179,1,0,0,0,21,181,1,
-	0,0,0,23,190,1,0,0,0,25,192,1,0,0,0,27,194,1,0,0,0,29,203,1,0,0,0,31,205,
-	1,0,0,0,33,207,1,0,0,0,35,209,1,0,0,0,37,217,1,0,0,0,39,220,1,0,0,0,41,
-	225,1,0,0,0,43,237,1,0,0,0,45,241,1,0,0,0,47,243,1,0,0,0,49,245,1,0,0,0,
-	51,256,1,0,0,0,53,263,1,0,0,0,55,280,1,0,0,0,57,295,1,0,0,0,59,310,1,0,
-	0,0,61,323,1,0,0,0,63,333,1,0,0,0,65,358,1,0,0,0,67,373,1,0,0,0,69,392,
-	1,0,0,0,71,408,1,0,0,0,73,419,1,0,0,0,75,427,1,0,0,0,77,434,1,0,0,0,79,
-	436,1,0,0,0,81,438,1,0,0,0,83,440,1,0,0,0,85,442,1,0,0,0,87,444,1,0,0,0,
-	89,446,1,0,0,0,91,449,1,0,0,0,93,452,1,0,0,0,95,454,1,0,0,0,97,456,1,0,
-	0,0,99,459,1,0,0,0,101,462,1,0,0,0,103,471,1,0,0,0,105,475,1,0,0,0,107,
-	480,1,0,0,0,109,487,1,0,0,0,111,494,1,0,0,0,113,498,1,0,0,0,115,507,1,0,
-	0,0,117,532,1,0,0,0,119,591,1,0,0,0,121,594,1,0,0,0,123,622,1,0,0,0,125,
-	624,1,0,0,0,127,651,1,0,0,0,129,653,1,0,0,0,131,662,1,0,0,0,133,683,1,0,
-	0,0,135,779,1,0,0,0,137,781,1,0,0,0,139,789,1,0,0,0,141,795,1,0,0,0,143,
-	809,1,0,0,0,145,146,5,112,0,0,146,147,5,114,0,0,147,148,5,97,0,0,148,149,
-	5,103,0,0,149,150,5,109,0,0,150,151,5,97,0,0,151,2,1,0,0,0,152,153,5,59,
-	0,0,153,4,1,0,0,0,154,155,5,99,0,0,155,156,5,97,0,0,156,157,5,115,0,0,157,
-	158,5,104,0,0,158,159,5,115,0,0,159,160,5,99,0,0,160,161,5,114,0,0,161,
-	162,5,105,0,0,162,163,5,112,0,0,163,164,5,116,0,0,164,6,1,0,0,0,165,166,
-	5,94,0,0,166,8,1,0,0,0,167,168,5,126,0,0,168,10,1,0,0,0,169,170,5,62,0,
-	0,170,171,5,61,0,0,171,12,1,0,0,0,172,173,5,62,0,0,173,14,1,0,0,0,174,175,
-	5,60,0,0,175,16,1,0,0,0,176,177,5,60,0,0,177,178,5,61,0,0,178,18,1,0,0,
-	0,179,180,5,61,0,0,180,20,1,0,0,0,181,182,5,99,0,0,182,183,5,111,0,0,183,
-	184,5,110,0,0,184,185,5,116,0,0,185,186,5,114,0,0,186,187,5,97,0,0,187,
-	188,5,99,0,0,188,189,5,116,0,0,189,22,1,0,0,0,190,191,5,123,0,0,191,24,
-	1,0,0,0,192,193,5,125,0,0,193,26,1,0,0,0,194,195,5,102,0,0,195,196,5,117,
-	0,0,196,197,5,110,0,0,197,198,5,99,0,0,198,199,5,116,0,0,199,200,5,105,
-	0,0,200,201,5,111,0,0,201,202,5,110,0,0,202,28,1,0,0,0,203,204,5,40,0,0,
-	204,30,1,0,0,0,205,206,5,44,0,0,206,32,1,0,0,0,207,208,5,41,0,0,208,34,
-	1,0,0,0,209,210,5,114,0,0,210,211,5,101,0,0,211,212,5,113,0,0,212,213,5,
-	117,0,0,213,214,5,105,0,0,214,215,5,114,0,0,215,216,5,101,0,0,216,36,1,
-	0,0,0,217,218,5,105,0,0,218,219,5,102,0,0,219,38,1,0,0,0,220,221,5,101,
-	0,0,221,222,5,108,0,0,222,223,5,115,0,0,223,224,5,101,0,0,224,40,1,0,0,
-	0,225,226,5,99,0,0,226,227,5,111,0,0,227,228,5,110,0,0,228,229,5,115,0,
-	0,229,230,5,111,0,0,230,231,5,108,0,0,231,232,5,101,0,0,232,233,5,46,0,
-	0,233,234,5,108,0,0,234,235,5,111,0,0,235,236,5,103,0,0,236,42,1,0,0,0,
-	237,238,5,110,0,0,238,239,5,101,0,0,239,240,5,119,0,0,240,44,1,0,0,0,241,
-	242,5,91,0,0,242,46,1,0,0,0,243,244,5,93,0,0,244,48,1,0,0,0,245,246,5,116,
-	0,0,246,247,5,120,0,0,247,248,5,46,0,0,248,249,5,111,0,0,249,250,5,117,
-	0,0,250,251,5,116,0,0,251,252,5,112,0,0,252,253,5,117,0,0,253,254,5,116,
-	0,0,254,255,5,115,0,0,255,50,1,0,0,0,256,257,5,46,0,0,257,258,5,118,0,0,
-	258,259,5,97,0,0,259,260,5,108,0,0,260,261,5,117,0,0,261,262,5,101,0,0,
-	262,52,1,0,0,0,263,264,5,46,0,0,264,265,5,108,0,0,265,266,5,111,0,0,266,
-	267,5,99,0,0,267,268,5,107,0,0,268,269,5,105,0,0,269,270,5,110,0,0,270,
-	271,5,103,0,0,271,272,5,66,0,0,272,273,5,121,0,0,273,274,5,116,0,0,274,
-	275,5,101,0,0,275,276,5,99,0,0,276,277,5,111,0,0,277,278,5,100,0,0,278,
-	279,5,101,0,0,279,54,1,0,0,0,280,281,5,46,0,0,281,282,5,116,0,0,282,283,
-	5,111,0,0,283,284,5,107,0,0,284,285,5,101,0,0,285,286,5,110,0,0,286,287,
-	5,67,0,0,287,288,5,97,0,0,288,289,5,116,0,0,289,290,5,101,0,0,290,291,5,
-	103,0,0,291,292,5,111,0,0,292,293,5,114,0,0,293,294,5,121,0,0,294,56,1,
-	0,0,0,295,296,5,46,0,0,296,297,5,110,0,0,297,298,5,102,0,0,298,299,5,116,
-	0,0,299,300,5,67,0,0,300,301,5,111,0,0,301,302,5,109,0,0,302,303,5,109,
-	0,0,303,304,5,105,0,0,304,305,5,116,0,0,305,306,5,109,0,0,306,307,5,101,
-	0,0,307,308,5,110,0,0,308,309,5,116,0,0,309,58,1,0,0,0,310,311,5,46,0,0,
-	311,312,5,116,0,0,312,313,5,111,0,0,313,314,5,107,0,0,314,315,5,101,0,0,
-	315,316,5,110,0,0,316,317,5,65,0,0,317,318,5,109,0,0,318,319,5,111,0,0,
-	319,320,5,117,0,0,320,321,5,110,0,0,321,322,5,116,0,0,322,60,1,0,0,0,323,
-	324,5,116,0,0,324,325,5,120,0,0,325,326,5,46,0,0,326,327,5,105,0,0,327,
-	328,5,110,0,0,328,329,5,112,0,0,329,330,5,117,0,0,330,331,5,116,0,0,331,
-	332,5,115,0,0,332,62,1,0,0,0,333,334,5,46,0,0,334,335,5,111,0,0,335,336,
-	5,117,0,0,336,337,5,116,0,0,337,338,5,112,0,0,338,339,5,111,0,0,339,340,
-	5,105,0,0,340,341,5,110,0,0,341,342,5,116,0,0,342,343,5,84,0,0,343,344,
-	5,114,0,0,344,345,5,97,0,0,345,346,5,110,0,0,346,347,5,115,0,0,347,348,
-	5,97,0,0,348,349,5,99,0,0,349,350,5,116,0,0,350,351,5,105,0,0,351,352,5,
-	111,0,0,352,353,5,110,0,0,353,354,5,72,0,0,354,355,5,97,0,0,355,356,5,115,
-	0,0,356,357,5,104,0,0,357,64,1,0,0,0,358,359,5,46,0,0,359,360,5,111,0,0,
-	360,361,5,117,0,0,361,362,5,116,0,0,362,363,5,112,0,0,363,364,5,111,0,0,
-	364,365,5,105,0,0,365,366,5,110,0,0,366,367,5,116,0,0,367,368,5,73,0,0,
-	368,369,5,110,0,0,369,370,5,100,0,0,370,371,5,101,0,0,371,372,5,120,0,0,
-	372,66,1,0,0,0,373,374,5,46,0,0,374,375,5,117,0,0,375,376,5,110,0,0,376,
-	377,5,108,0,0,377,378,5,111,0,0,378,379,5,99,0,0,379,380,5,107,0,0,380,
-	381,5,105,0,0,381,382,5,110,0,0,382,383,5,103,0,0,383,384,5,66,0,0,384,
-	385,5,121,0,0,385,386,5,116,0,0,386,387,5,101,0,0,387,388,5,99,0,0,388,
-	389,5,111,0,0,389,390,5,100,0,0,390,391,5,101,0,0,391,68,1,0,0,0,392,393,
-	5,46,0,0,393,394,5,115,0,0,394,395,5,101,0,0,395,396,5,113,0,0,396,397,
-	5,117,0,0,397,398,5,101,0,0,398,399,5,110,0,0,399,400,5,99,0,0,400,401,
-	5,101,0,0,401,402,5,78,0,0,402,403,5,117,0,0,403,404,5,109,0,0,404,405,
-	5,98,0,0,405,406,5,101,0,0,406,407,5,114,0,0,407,70,1,0,0,0,408,409,5,46,
-	0,0,409,410,5,114,0,0,410,411,5,101,0,0,411,412,5,118,0,0,412,413,5,101,
-	0,0,413,414,5,114,0,0,414,415,5,115,0,0,415,416,5,101,0,0,416,417,5,40,
-	0,0,417,418,5,41,0,0,418,72,1,0,0,0,419,420,5,46,0,0,420,421,5,108,0,0,
-	421,422,5,101,0,0,422,423,5,110,0,0,423,424,5,103,0,0,424,425,5,116,0,0,
-	425,426,5,104,0,0,426,74,1,0,0,0,427,428,5,46,0,0,428,429,5,115,0,0,429,
-	430,5,112,0,0,430,431,5,108,0,0,431,432,5,105,0,0,432,433,5,116,0,0,433,
-	76,1,0,0,0,434,435,5,33,0,0,435,78,1,0,0,0,436,437,5,45,0,0,437,80,1,0,
-	0,0,438,439,5,42,0,0,439,82,1,0,0,0,440,441,5,47,0,0,441,84,1,0,0,0,442,
-	443,5,37,0,0,443,86,1,0,0,0,444,445,5,43,0,0,445,88,1,0,0,0,446,447,5,61,
-	0,0,447,448,5,61,0,0,448,90,1,0,0,0,449,450,5,33,0,0,450,451,5,61,0,0,451,
-	92,1,0,0,0,452,453,5,38,0,0,453,94,1,0,0,0,454,455,5,124,0,0,455,96,1,0,
-	0,0,456,457,5,38,0,0,457,458,5,38,0,0,458,98,1,0,0,0,459,460,5,124,0,0,
-	460,461,5,124,0,0,461,100,1,0,0,0,462,463,5,99,0,0,463,464,5,111,0,0,464,
-	465,5,110,0,0,465,466,5,115,0,0,466,467,5,116,0,0,467,468,5,97,0,0,468,
-	469,5,110,0,0,469,470,5,116,0,0,470,102,1,0,0,0,471,472,5,105,0,0,472,473,
-	5,110,0,0,473,474,5,116,0,0,474,104,1,0,0,0,475,476,5,98,0,0,476,477,5,
-	111,0,0,477,478,5,111,0,0,478,479,5,108,0,0,479,106,1,0,0,0,480,481,5,115,
-	0,0,481,482,5,116,0,0,482,483,5,114,0,0,483,484,5,105,0,0,484,485,5,110,
-	0,0,485,486,5,103,0,0,486,108,1,0,0,0,487,488,5,112,0,0,488,489,5,117,0,
-	0,489,490,5,98,0,0,490,491,5,107,0,0,491,492,5,101,0,0,492,493,5,121,0,
-	0,493,110,1,0,0,0,494,495,5,115,0,0,495,496,5,105,0,0,496,497,5,103,0,0,
-	497,112,1,0,0,0,498,499,5,100,0,0,499,500,5,97,0,0,500,501,5,116,0,0,501,
-	502,5,97,0,0,502,503,5,115,0,0,503,504,5,105,0,0,504,505,5,103,0,0,505,
-	114,1,0,0,0,506,508,7,0,0,0,507,506,1,0,0,0,508,509,1,0,0,0,509,507,1,0,
-	0,0,509,510,1,0,0,0,510,511,1,0,0,0,511,513,5,46,0,0,512,514,7,0,0,0,513,
-	512,1,0,0,0,514,515,1,0,0,0,515,513,1,0,0,0,515,516,1,0,0,0,516,517,1,0,
-	0,0,517,519,5,46,0,0,518,520,7,0,0,0,519,518,1,0,0,0,520,521,1,0,0,0,521,
-	519,1,0,0,0,521,522,1,0,0,0,522,116,1,0,0,0,523,524,5,116,0,0,524,525,5,
-	114,0,0,525,526,5,117,0,0,526,533,5,101,0,0,527,528,5,102,0,0,528,529,5,
-	97,0,0,529,530,5,108,0,0,530,531,5,115,0,0,531,533,5,101,0,0,532,523,1,
-	0,0,0,532,527,1,0,0,0,533,118,1,0,0,0,534,535,5,115,0,0,535,536,5,97,0,
-	0,536,537,5,116,0,0,537,538,5,111,0,0,538,539,5,115,0,0,539,540,5,104,0,
-	0,540,541,5,105,0,0,541,592,5,115,0,0,542,543,5,115,0,0,543,544,5,97,0,
-	0,544,545,5,116,0,0,545,592,5,115,0,0,546,547,5,102,0,0,547,548,5,105,0,
-	0,548,549,5,110,0,0,549,550,5,110,0,0,550,551,5,101,0,0,551,592,5,121,0,
-	0,552,553,5,98,0,0,553,554,5,105,0,0,554,555,5,116,0,0,555,592,5,115,0,
-	0,556,557,5,98,0,0,557,558,5,105,0,0,558,559,5,116,0,0,559,560,5,99,0,0,
-	560,561,5,111,0,0,561,562,5,105,0,0,562,592,5,110,0,0,563,564,5,115,0,0,
-	564,565,5,101,0,0,565,566,5,99,0,0,566,567,5,111,0,0,567,568,5,110,0,0,
-	568,569,5,100,0,0,569,592,5,115,0,0,570,571,5,109,0,0,571,572,5,105,0,0,
-	572,573,5,110,0,0,573,574,5,117,0,0,574,575,5,116,0,0,575,576,5,101,0,0,
-	576,592,5,115,0,0,577,578,5,104,0,0,578,579,5,111,0,0,579,580,5,117,0,0,
-	580,581,5,114,0,0,581,592,5,115,0,0,582,583,5,100,0,0,583,584,5,97,0,0,
-	584,585,5,121,0,0,585,592,5,115,0,0,586,587,5,119,0,0,587,588,5,101,0,0,
-	588,589,5,101,0,0,589,590,5,107,0,0,590,592,5,115,0,0,591,534,1,0,0,0,591,
-	542,1,0,0,0,591,546,1,0,0,0,591,552,1,0,0,0,591,556,1,0,0,0,591,563,1,0,
-	0,0,591,570,1,0,0,0,591,577,1,0,0,0,591,582,1,0,0,0,591,586,1,0,0,0,592,
-	120,1,0,0,0,593,595,7,1,0,0,594,593,1,0,0,0,594,595,1,0,0,0,595,597,1,0,
-	0,0,596,598,7,0,0,0,597,596,1,0,0,0,598,599,1,0,0,0,599,597,1,0,0,0,599,
-	600,1,0,0,0,600,607,1,0,0,0,601,603,7,2,0,0,602,604,7,0,0,0,603,602,1,0,
-	0,0,604,605,1,0,0,0,605,603,1,0,0,0,605,606,1,0,0,0,606,608,1,0,0,0,607,
-	601,1,0,0,0,607,608,1,0,0,0,608,122,1,0,0,0,609,610,5,98,0,0,610,611,5,
-	121,0,0,611,612,5,116,0,0,612,613,5,101,0,0,613,614,5,115,0,0,614,616,1,
-	0,0,0,615,617,3,125,62,0,616,615,1,0,0,0,616,617,1,0,0,0,617,623,1,0,0,
-	0,618,619,5,98,0,0,619,620,5,121,0,0,620,621,5,116,0,0,621,623,5,101,0,
-	0,622,609,1,0,0,0,622,618,1,0,0,0,623,124,1,0,0,0,624,628,7,3,0,0,625,627,
-	7,0,0,0,626,625,1,0,0,0,627,630,1,0,0,0,628,626,1,0,0,0,628,629,1,0,0,0,
-	629,126,1,0,0,0,630,628,1,0,0,0,631,637,5,34,0,0,632,633,5,92,0,0,633,636,
-	5,34,0,0,634,636,8,4,0,0,635,632,1,0,0,0,635,634,1,0,0,0,636,639,1,0,0,
-	0,637,638,1,0,0,0,637,635,1,0,0,0,638,640,1,0,0,0,639,637,1,0,0,0,640,652,
-	5,34,0,0,641,647,5,39,0,0,642,643,5,92,0,0,643,646,5,39,0,0,644,646,8,5,
-	0,0,645,642,1,0,0,0,645,644,1,0,0,0,646,649,1,0,0,0,647,648,1,0,0,0,647,
-	645,1,0,0,0,648,650,1,0,0,0,649,647,1,0,0,0,650,652,5,39,0,0,651,631,1,
-	0,0,0,651,641,1,0,0,0,652,128,1,0,0,0,653,654,5,100,0,0,654,655,5,97,0,
-	0,655,656,5,116,0,0,656,657,5,101,0,0,657,658,5,40,0,0,658,659,1,0,0,0,
-	659,660,3,127,63,0,660,661,5,41,0,0,661,130,1,0,0,0,662,663,5,48,0,0,663,
-	667,7,6,0,0,664,666,7,7,0,0,665,664,1,0,0,0,666,669,1,0,0,0,667,665,1,0,
-	0,0,667,668,1,0,0,0,668,132,1,0,0,0,669,667,1,0,0,0,670,671,5,116,0,0,671,
-	672,5,120,0,0,672,673,5,46,0,0,673,674,5,97,0,0,674,675,5,103,0,0,675,684,
-	5,101,0,0,676,677,5,116,0,0,677,678,5,120,0,0,678,679,5,46,0,0,679,680,
-	5,116,0,0,680,681,5,105,0,0,681,682,5,109,0,0,682,684,5,101,0,0,683,670,
-	1,0,0,0,683,676,1,0,0,0,684,134,1,0,0,0,685,686,5,116,0,0,686,687,5,104,
-	0,0,687,688,5,105,0,0,688,689,5,115,0,0,689,690,5,46,0,0,690,691,5,97,0,
-	0,691,692,5,99,0,0,692,693,5,116,0,0,693,694,5,105,0,0,694,695,5,118,0,
-	0,695,696,5,101,0,0,696,697,5,73,0,0,697,698,5,110,0,0,698,699,5,112,0,
-	0,699,700,5,117,0,0,700,701,5,116,0,0,701,702,5,73,0,0,702,703,5,110,0,
-	0,703,704,5,100,0,0,704,705,5,101,0,0,705,780,5,120,0,0,706,707,5,116,0,
-	0,707,708,5,104,0,0,708,709,5,105,0,0,709,710,5,115,0,0,710,711,5,46,0,
-	0,711,712,5,97,0,0,712,713,5,99,0,0,713,714,5,116,0,0,714,715,5,105,0,0,
-	715,716,5,118,0,0,716,717,5,101,0,0,717,718,5,66,0,0,718,719,5,121,0,0,
-	719,720,5,116,0,0,720,721,5,101,0,0,721,722,5,99,0,0,722,723,5,111,0,0,
-	723,724,5,100,0,0,724,780,5,101,0,0,725,726,5,116,0,0,726,727,5,120,0,0,
-	727,728,5,46,0,0,728,729,5,105,0,0,729,730,5,110,0,0,730,731,5,112,0,0,
-	731,732,5,117,0,0,732,733,5,116,0,0,733,734,5,115,0,0,734,735,5,46,0,0,
-	735,736,5,108,0,0,736,737,5,101,0,0,737,738,5,110,0,0,738,739,5,103,0,0,
-	739,740,5,116,0,0,740,780,5,104,0,0,741,742,5,116,0,0,742,743,5,120,0,0,
-	743,744,5,46,0,0,744,745,5,111,0,0,745,746,5,117,0,0,746,747,5,116,0,0,
-	747,748,5,112,0,0,748,749,5,117,0,0,749,750,5,116,0,0,750,751,5,115,0,0,
-	751,752,5,46,0,0,752,753,5,108,0,0,753,754,5,101,0,0,754,755,5,110,0,0,
-	755,756,5,103,0,0,756,757,5,116,0,0,757,780,5,104,0,0,758,759,5,116,0,0,
-	759,760,5,120,0,0,760,761,5,46,0,0,761,762,5,118,0,0,762,763,5,101,0,0,
-	763,764,5,114,0,0,764,765,5,115,0,0,765,766,5,105,0,0,766,767,5,111,0,0,
-	767,780,5,110,0,0,768,769,5,116,0,0,769,770,5,120,0,0,770,771,5,46,0,0,
-	771,772,5,108,0,0,772,773,5,111,0,0,773,774,5,99,0,0,774,775,5,107,0,0,
-	775,776,5,116,0,0,776,777,5,105,0,0,777,778,5,109,0,0,778,780,5,101,0,0,
-	779,685,1,0,0,0,779,706,1,0,0,0,779,725,1,0,0,0,779,741,1,0,0,0,779,758,
-	1,0,0,0,779,768,1,0,0,0,780,136,1,0,0,0,781,785,7,8,0,0,782,784,7,9,0,0,
-	783,782,1,0,0,0,784,787,1,0,0,0,785,783,1,0,0,0,785,786,1,0,0,0,786,138,
-	1,0,0,0,787,785,1,0,0,0,788,790,7,10,0,0,789,788,1,0,0,0,790,791,1,0,0,
-	0,791,789,1,0,0,0,791,792,1,0,0,0,792,793,1,0,0,0,793,794,6,69,0,0,794,
-	140,1,0,0,0,795,796,5,47,0,0,796,797,5,42,0,0,797,801,1,0,0,0,798,800,9,
-	0,0,0,799,798,1,0,0,0,800,803,1,0,0,0,801,802,1,0,0,0,801,799,1,0,0,0,802,
-	804,1,0,0,0,803,801,1,0,0,0,804,805,5,42,0,0,805,806,5,47,0,0,806,807,1,
-	0,0,0,807,808,6,70,1,0,808,142,1,0,0,0,809,810,5,47,0,0,810,811,5,47,0,
-	0,811,815,1,0,0,0,812,814,8,11,0,0,813,812,1,0,0,0,814,817,1,0,0,0,815,
-	813,1,0,0,0,815,816,1,0,0,0,816,818,1,0,0,0,817,815,1,0,0,0,818,819,6,71,
-	1,0,819,144,1,0,0,0,25,0,509,515,521,532,591,594,599,605,607,616,622,628,
-	635,637,645,647,651,667,683,779,785,791,801,815,2,6,0,0,0,1,0];
+	1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,1,59,3,59,596,8,59,1,60,3,
+	60,599,8,60,1,60,1,60,3,60,603,8,60,1,61,4,61,606,8,61,11,61,12,61,607,
+	1,61,1,61,4,61,612,8,61,11,61,12,61,613,5,61,616,8,61,10,61,12,61,619,9,
+	61,1,62,1,62,1,62,1,63,1,63,1,63,1,63,1,63,1,63,1,63,3,63,631,8,63,1,63,
+	1,63,1,63,1,63,3,63,637,8,63,1,64,1,64,5,64,641,8,64,10,64,12,64,644,9,
+	64,1,65,1,65,1,65,1,65,5,65,650,8,65,10,65,12,65,653,9,65,1,65,1,65,1,65,
+	1,65,1,65,5,65,660,8,65,10,65,12,65,663,9,65,1,65,3,65,666,8,65,1,66,1,
+	66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,67,1,67,1,67,5,67,680,8,67,10,67,
+	12,67,683,9,67,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,
+	68,1,68,3,68,698,8,68,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,
+	1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,
+	69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,
+	1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,
+	69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,
+	1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,
+	69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,3,69,794,8,69,
+	1,70,1,70,5,70,798,8,70,10,70,12,70,801,9,70,1,71,4,71,804,8,71,11,71,12,
+	71,805,1,71,1,71,1,72,1,72,1,72,1,72,5,72,814,8,72,10,72,12,72,817,9,72,
+	1,72,1,72,1,72,1,72,1,72,1,73,1,73,1,73,1,73,5,73,828,8,73,10,73,12,73,
+	831,9,73,1,73,1,73,3,651,661,815,0,74,1,1,3,2,5,3,7,4,9,5,11,6,13,7,15,
+	8,17,9,19,10,21,11,23,12,25,13,27,14,29,15,31,16,33,17,35,18,37,19,39,20,
+	41,21,43,22,45,23,47,24,49,25,51,26,53,27,55,28,57,29,59,30,61,31,63,32,
+	65,33,67,34,69,35,71,36,73,37,75,38,77,39,79,40,81,41,83,42,85,43,87,44,
+	89,45,91,46,93,47,95,48,97,49,99,50,101,51,103,52,105,53,107,54,109,55,
+	111,56,113,57,115,58,117,59,119,60,121,61,123,62,125,63,127,64,129,65,131,
+	66,133,67,135,68,137,69,139,70,141,71,143,72,145,73,147,74,1,0,11,1,0,48,
+	57,2,0,69,69,101,101,1,0,49,57,3,0,10,10,13,13,34,34,3,0,10,10,13,13,39,
+	39,2,0,88,88,120,120,3,0,48,57,65,70,97,102,2,0,65,90,97,122,4,0,48,57,
+	65,90,95,95,97,122,3,0,9,10,12,13,32,32,2,0,10,10,13,13,870,0,1,1,0,0,0,
+	0,3,1,0,0,0,0,5,1,0,0,0,0,7,1,0,0,0,0,9,1,0,0,0,0,11,1,0,0,0,0,13,1,0,0,
+	0,0,15,1,0,0,0,0,17,1,0,0,0,0,19,1,0,0,0,0,21,1,0,0,0,0,23,1,0,0,0,0,25,
+	1,0,0,0,0,27,1,0,0,0,0,29,1,0,0,0,0,31,1,0,0,0,0,33,1,0,0,0,0,35,1,0,0,
+	0,0,37,1,0,0,0,0,39,1,0,0,0,0,41,1,0,0,0,0,43,1,0,0,0,0,45,1,0,0,0,0,47,
+	1,0,0,0,0,49,1,0,0,0,0,51,1,0,0,0,0,53,1,0,0,0,0,55,1,0,0,0,0,57,1,0,0,
+	0,0,59,1,0,0,0,0,61,1,0,0,0,0,63,1,0,0,0,0,65,1,0,0,0,0,67,1,0,0,0,0,69,
+	1,0,0,0,0,71,1,0,0,0,0,73,1,0,0,0,0,75,1,0,0,0,0,77,1,0,0,0,0,79,1,0,0,
+	0,0,81,1,0,0,0,0,83,1,0,0,0,0,85,1,0,0,0,0,87,1,0,0,0,0,89,1,0,0,0,0,91,
+	1,0,0,0,0,93,1,0,0,0,0,95,1,0,0,0,0,97,1,0,0,0,0,99,1,0,0,0,0,101,1,0,0,
+	0,0,103,1,0,0,0,0,105,1,0,0,0,0,107,1,0,0,0,0,109,1,0,0,0,0,111,1,0,0,0,
+	0,113,1,0,0,0,0,115,1,0,0,0,0,117,1,0,0,0,0,119,1,0,0,0,0,121,1,0,0,0,0,
+	123,1,0,0,0,0,125,1,0,0,0,0,127,1,0,0,0,0,129,1,0,0,0,0,131,1,0,0,0,0,133,
+	1,0,0,0,0,135,1,0,0,0,0,137,1,0,0,0,0,139,1,0,0,0,0,141,1,0,0,0,0,143,1,
+	0,0,0,0,145,1,0,0,0,0,147,1,0,0,0,1,149,1,0,0,0,3,156,1,0,0,0,5,158,1,0,
+	0,0,7,169,1,0,0,0,9,171,1,0,0,0,11,173,1,0,0,0,13,176,1,0,0,0,15,178,1,
+	0,0,0,17,180,1,0,0,0,19,183,1,0,0,0,21,185,1,0,0,0,23,194,1,0,0,0,25,196,
+	1,0,0,0,27,198,1,0,0,0,29,207,1,0,0,0,31,209,1,0,0,0,33,211,1,0,0,0,35,
+	213,1,0,0,0,37,221,1,0,0,0,39,224,1,0,0,0,41,229,1,0,0,0,43,241,1,0,0,0,
+	45,245,1,0,0,0,47,247,1,0,0,0,49,249,1,0,0,0,51,260,1,0,0,0,53,267,1,0,
+	0,0,55,284,1,0,0,0,57,299,1,0,0,0,59,314,1,0,0,0,61,327,1,0,0,0,63,337,
+	1,0,0,0,65,362,1,0,0,0,67,377,1,0,0,0,69,396,1,0,0,0,71,412,1,0,0,0,73,
+	423,1,0,0,0,75,431,1,0,0,0,77,438,1,0,0,0,79,440,1,0,0,0,81,442,1,0,0,0,
+	83,444,1,0,0,0,85,446,1,0,0,0,87,448,1,0,0,0,89,450,1,0,0,0,91,453,1,0,
+	0,0,93,456,1,0,0,0,95,458,1,0,0,0,97,460,1,0,0,0,99,463,1,0,0,0,101,466,
+	1,0,0,0,103,475,1,0,0,0,105,479,1,0,0,0,107,484,1,0,0,0,109,491,1,0,0,0,
+	111,498,1,0,0,0,113,502,1,0,0,0,115,511,1,0,0,0,117,536,1,0,0,0,119,595,
+	1,0,0,0,121,598,1,0,0,0,123,605,1,0,0,0,125,620,1,0,0,0,127,636,1,0,0,0,
+	129,638,1,0,0,0,131,665,1,0,0,0,133,667,1,0,0,0,135,676,1,0,0,0,137,697,
+	1,0,0,0,139,793,1,0,0,0,141,795,1,0,0,0,143,803,1,0,0,0,145,809,1,0,0,0,
+	147,823,1,0,0,0,149,150,5,112,0,0,150,151,5,114,0,0,151,152,5,97,0,0,152,
+	153,5,103,0,0,153,154,5,109,0,0,154,155,5,97,0,0,155,2,1,0,0,0,156,157,
+	5,59,0,0,157,4,1,0,0,0,158,159,5,99,0,0,159,160,5,97,0,0,160,161,5,115,
+	0,0,161,162,5,104,0,0,162,163,5,115,0,0,163,164,5,99,0,0,164,165,5,114,
+	0,0,165,166,5,105,0,0,166,167,5,112,0,0,167,168,5,116,0,0,168,6,1,0,0,0,
+	169,170,5,94,0,0,170,8,1,0,0,0,171,172,5,126,0,0,172,10,1,0,0,0,173,174,
+	5,62,0,0,174,175,5,61,0,0,175,12,1,0,0,0,176,177,5,62,0,0,177,14,1,0,0,
+	0,178,179,5,60,0,0,179,16,1,0,0,0,180,181,5,60,0,0,181,182,5,61,0,0,182,
+	18,1,0,0,0,183,184,5,61,0,0,184,20,1,0,0,0,185,186,5,99,0,0,186,187,5,111,
+	0,0,187,188,5,110,0,0,188,189,5,116,0,0,189,190,5,114,0,0,190,191,5,97,
+	0,0,191,192,5,99,0,0,192,193,5,116,0,0,193,22,1,0,0,0,194,195,5,123,0,0,
+	195,24,1,0,0,0,196,197,5,125,0,0,197,26,1,0,0,0,198,199,5,102,0,0,199,200,
+	5,117,0,0,200,201,5,110,0,0,201,202,5,99,0,0,202,203,5,116,0,0,203,204,
+	5,105,0,0,204,205,5,111,0,0,205,206,5,110,0,0,206,28,1,0,0,0,207,208,5,
+	40,0,0,208,30,1,0,0,0,209,210,5,44,0,0,210,32,1,0,0,0,211,212,5,41,0,0,
+	212,34,1,0,0,0,213,214,5,114,0,0,214,215,5,101,0,0,215,216,5,113,0,0,216,
+	217,5,117,0,0,217,218,5,105,0,0,218,219,5,114,0,0,219,220,5,101,0,0,220,
+	36,1,0,0,0,221,222,5,105,0,0,222,223,5,102,0,0,223,38,1,0,0,0,224,225,5,
+	101,0,0,225,226,5,108,0,0,226,227,5,115,0,0,227,228,5,101,0,0,228,40,1,
+	0,0,0,229,230,5,99,0,0,230,231,5,111,0,0,231,232,5,110,0,0,232,233,5,115,
+	0,0,233,234,5,111,0,0,234,235,5,108,0,0,235,236,5,101,0,0,236,237,5,46,
+	0,0,237,238,5,108,0,0,238,239,5,111,0,0,239,240,5,103,0,0,240,42,1,0,0,
+	0,241,242,5,110,0,0,242,243,5,101,0,0,243,244,5,119,0,0,244,44,1,0,0,0,
+	245,246,5,91,0,0,246,46,1,0,0,0,247,248,5,93,0,0,248,48,1,0,0,0,249,250,
+	5,116,0,0,250,251,5,120,0,0,251,252,5,46,0,0,252,253,5,111,0,0,253,254,
+	5,117,0,0,254,255,5,116,0,0,255,256,5,112,0,0,256,257,5,117,0,0,257,258,
+	5,116,0,0,258,259,5,115,0,0,259,50,1,0,0,0,260,261,5,46,0,0,261,262,5,118,
+	0,0,262,263,5,97,0,0,263,264,5,108,0,0,264,265,5,117,0,0,265,266,5,101,
+	0,0,266,52,1,0,0,0,267,268,5,46,0,0,268,269,5,108,0,0,269,270,5,111,0,0,
+	270,271,5,99,0,0,271,272,5,107,0,0,272,273,5,105,0,0,273,274,5,110,0,0,
+	274,275,5,103,0,0,275,276,5,66,0,0,276,277,5,121,0,0,277,278,5,116,0,0,
+	278,279,5,101,0,0,279,280,5,99,0,0,280,281,5,111,0,0,281,282,5,100,0,0,
+	282,283,5,101,0,0,283,54,1,0,0,0,284,285,5,46,0,0,285,286,5,116,0,0,286,
+	287,5,111,0,0,287,288,5,107,0,0,288,289,5,101,0,0,289,290,5,110,0,0,290,
+	291,5,67,0,0,291,292,5,97,0,0,292,293,5,116,0,0,293,294,5,101,0,0,294,295,
+	5,103,0,0,295,296,5,111,0,0,296,297,5,114,0,0,297,298,5,121,0,0,298,56,
+	1,0,0,0,299,300,5,46,0,0,300,301,5,110,0,0,301,302,5,102,0,0,302,303,5,
+	116,0,0,303,304,5,67,0,0,304,305,5,111,0,0,305,306,5,109,0,0,306,307,5,
+	109,0,0,307,308,5,105,0,0,308,309,5,116,0,0,309,310,5,109,0,0,310,311,5,
+	101,0,0,311,312,5,110,0,0,312,313,5,116,0,0,313,58,1,0,0,0,314,315,5,46,
+	0,0,315,316,5,116,0,0,316,317,5,111,0,0,317,318,5,107,0,0,318,319,5,101,
+	0,0,319,320,5,110,0,0,320,321,5,65,0,0,321,322,5,109,0,0,322,323,5,111,
+	0,0,323,324,5,117,0,0,324,325,5,110,0,0,325,326,5,116,0,0,326,60,1,0,0,
+	0,327,328,5,116,0,0,328,329,5,120,0,0,329,330,5,46,0,0,330,331,5,105,0,
+	0,331,332,5,110,0,0,332,333,5,112,0,0,333,334,5,117,0,0,334,335,5,116,0,
+	0,335,336,5,115,0,0,336,62,1,0,0,0,337,338,5,46,0,0,338,339,5,111,0,0,339,
+	340,5,117,0,0,340,341,5,116,0,0,341,342,5,112,0,0,342,343,5,111,0,0,343,
+	344,5,105,0,0,344,345,5,110,0,0,345,346,5,116,0,0,346,347,5,84,0,0,347,
+	348,5,114,0,0,348,349,5,97,0,0,349,350,5,110,0,0,350,351,5,115,0,0,351,
+	352,5,97,0,0,352,353,5,99,0,0,353,354,5,116,0,0,354,355,5,105,0,0,355,356,
+	5,111,0,0,356,357,5,110,0,0,357,358,5,72,0,0,358,359,5,97,0,0,359,360,5,
+	115,0,0,360,361,5,104,0,0,361,64,1,0,0,0,362,363,5,46,0,0,363,364,5,111,
+	0,0,364,365,5,117,0,0,365,366,5,116,0,0,366,367,5,112,0,0,367,368,5,111,
+	0,0,368,369,5,105,0,0,369,370,5,110,0,0,370,371,5,116,0,0,371,372,5,73,
+	0,0,372,373,5,110,0,0,373,374,5,100,0,0,374,375,5,101,0,0,375,376,5,120,
+	0,0,376,66,1,0,0,0,377,378,5,46,0,0,378,379,5,117,0,0,379,380,5,110,0,0,
+	380,381,5,108,0,0,381,382,5,111,0,0,382,383,5,99,0,0,383,384,5,107,0,0,
+	384,385,5,105,0,0,385,386,5,110,0,0,386,387,5,103,0,0,387,388,5,66,0,0,
+	388,389,5,121,0,0,389,390,5,116,0,0,390,391,5,101,0,0,391,392,5,99,0,0,
+	392,393,5,111,0,0,393,394,5,100,0,0,394,395,5,101,0,0,395,68,1,0,0,0,396,
+	397,5,46,0,0,397,398,5,115,0,0,398,399,5,101,0,0,399,400,5,113,0,0,400,
+	401,5,117,0,0,401,402,5,101,0,0,402,403,5,110,0,0,403,404,5,99,0,0,404,
+	405,5,101,0,0,405,406,5,78,0,0,406,407,5,117,0,0,407,408,5,109,0,0,408,
+	409,5,98,0,0,409,410,5,101,0,0,410,411,5,114,0,0,411,70,1,0,0,0,412,413,
+	5,46,0,0,413,414,5,114,0,0,414,415,5,101,0,0,415,416,5,118,0,0,416,417,
+	5,101,0,0,417,418,5,114,0,0,418,419,5,115,0,0,419,420,5,101,0,0,420,421,
+	5,40,0,0,421,422,5,41,0,0,422,72,1,0,0,0,423,424,5,46,0,0,424,425,5,108,
+	0,0,425,426,5,101,0,0,426,427,5,110,0,0,427,428,5,103,0,0,428,429,5,116,
+	0,0,429,430,5,104,0,0,430,74,1,0,0,0,431,432,5,46,0,0,432,433,5,115,0,0,
+	433,434,5,112,0,0,434,435,5,108,0,0,435,436,5,105,0,0,436,437,5,116,0,0,
+	437,76,1,0,0,0,438,439,5,33,0,0,439,78,1,0,0,0,440,441,5,45,0,0,441,80,
+	1,0,0,0,442,443,5,42,0,0,443,82,1,0,0,0,444,445,5,47,0,0,445,84,1,0,0,0,
+	446,447,5,37,0,0,447,86,1,0,0,0,448,449,5,43,0,0,449,88,1,0,0,0,450,451,
+	5,61,0,0,451,452,5,61,0,0,452,90,1,0,0,0,453,454,5,33,0,0,454,455,5,61,
+	0,0,455,92,1,0,0,0,456,457,5,38,0,0,457,94,1,0,0,0,458,459,5,124,0,0,459,
+	96,1,0,0,0,460,461,5,38,0,0,461,462,5,38,0,0,462,98,1,0,0,0,463,464,5,124,
+	0,0,464,465,5,124,0,0,465,100,1,0,0,0,466,467,5,99,0,0,467,468,5,111,0,
+	0,468,469,5,110,0,0,469,470,5,115,0,0,470,471,5,116,0,0,471,472,5,97,0,
+	0,472,473,5,110,0,0,473,474,5,116,0,0,474,102,1,0,0,0,475,476,5,105,0,0,
+	476,477,5,110,0,0,477,478,5,116,0,0,478,104,1,0,0,0,479,480,5,98,0,0,480,
+	481,5,111,0,0,481,482,5,111,0,0,482,483,5,108,0,0,483,106,1,0,0,0,484,485,
+	5,115,0,0,485,486,5,116,0,0,486,487,5,114,0,0,487,488,5,105,0,0,488,489,
+	5,110,0,0,489,490,5,103,0,0,490,108,1,0,0,0,491,492,5,112,0,0,492,493,5,
+	117,0,0,493,494,5,98,0,0,494,495,5,107,0,0,495,496,5,101,0,0,496,497,5,
+	121,0,0,497,110,1,0,0,0,498,499,5,115,0,0,499,500,5,105,0,0,500,501,5,103,
+	0,0,501,112,1,0,0,0,502,503,5,100,0,0,503,504,5,97,0,0,504,505,5,116,0,
+	0,505,506,5,97,0,0,506,507,5,115,0,0,507,508,5,105,0,0,508,509,5,103,0,
+	0,509,114,1,0,0,0,510,512,7,0,0,0,511,510,1,0,0,0,512,513,1,0,0,0,513,511,
+	1,0,0,0,513,514,1,0,0,0,514,515,1,0,0,0,515,517,5,46,0,0,516,518,7,0,0,
+	0,517,516,1,0,0,0,518,519,1,0,0,0,519,517,1,0,0,0,519,520,1,0,0,0,520,521,
+	1,0,0,0,521,523,5,46,0,0,522,524,7,0,0,0,523,522,1,0,0,0,524,525,1,0,0,
+	0,525,523,1,0,0,0,525,526,1,0,0,0,526,116,1,0,0,0,527,528,5,116,0,0,528,
+	529,5,114,0,0,529,530,5,117,0,0,530,537,5,101,0,0,531,532,5,102,0,0,532,
+	533,5,97,0,0,533,534,5,108,0,0,534,535,5,115,0,0,535,537,5,101,0,0,536,
+	527,1,0,0,0,536,531,1,0,0,0,537,118,1,0,0,0,538,539,5,115,0,0,539,540,5,
+	97,0,0,540,541,5,116,0,0,541,542,5,111,0,0,542,543,5,115,0,0,543,544,5,
+	104,0,0,544,545,5,105,0,0,545,596,5,115,0,0,546,547,5,115,0,0,547,548,5,
+	97,0,0,548,549,5,116,0,0,549,596,5,115,0,0,550,551,5,102,0,0,551,552,5,
+	105,0,0,552,553,5,110,0,0,553,554,5,110,0,0,554,555,5,101,0,0,555,596,5,
+	121,0,0,556,557,5,98,0,0,557,558,5,105,0,0,558,559,5,116,0,0,559,596,5,
+	115,0,0,560,561,5,98,0,0,561,562,5,105,0,0,562,563,5,116,0,0,563,564,5,
+	99,0,0,564,565,5,111,0,0,565,566,5,105,0,0,566,596,5,110,0,0,567,568,5,
+	115,0,0,568,569,5,101,0,0,569,570,5,99,0,0,570,571,5,111,0,0,571,572,5,
+	110,0,0,572,573,5,100,0,0,573,596,5,115,0,0,574,575,5,109,0,0,575,576,5,
+	105,0,0,576,577,5,110,0,0,577,578,5,117,0,0,578,579,5,116,0,0,579,580,5,
+	101,0,0,580,596,5,115,0,0,581,582,5,104,0,0,582,583,5,111,0,0,583,584,5,
+	117,0,0,584,585,5,114,0,0,585,596,5,115,0,0,586,587,5,100,0,0,587,588,5,
+	97,0,0,588,589,5,121,0,0,589,596,5,115,0,0,590,591,5,119,0,0,591,592,5,
+	101,0,0,592,593,5,101,0,0,593,594,5,107,0,0,594,596,5,115,0,0,595,538,1,
+	0,0,0,595,546,1,0,0,0,595,550,1,0,0,0,595,556,1,0,0,0,595,560,1,0,0,0,595,
+	567,1,0,0,0,595,574,1,0,0,0,595,581,1,0,0,0,595,586,1,0,0,0,595,590,1,0,
+	0,0,596,120,1,0,0,0,597,599,5,45,0,0,598,597,1,0,0,0,598,599,1,0,0,0,599,
+	600,1,0,0,0,600,602,3,123,61,0,601,603,3,125,62,0,602,601,1,0,0,0,602,603,
+	1,0,0,0,603,122,1,0,0,0,604,606,7,0,0,0,605,604,1,0,0,0,606,607,1,0,0,0,
+	607,605,1,0,0,0,607,608,1,0,0,0,608,617,1,0,0,0,609,611,5,95,0,0,610,612,
+	7,0,0,0,611,610,1,0,0,0,612,613,1,0,0,0,613,611,1,0,0,0,613,614,1,0,0,0,
+	614,616,1,0,0,0,615,609,1,0,0,0,616,619,1,0,0,0,617,615,1,0,0,0,617,618,
+	1,0,0,0,618,124,1,0,0,0,619,617,1,0,0,0,620,621,7,1,0,0,621,622,3,123,61,
+	0,622,126,1,0,0,0,623,624,5,98,0,0,624,625,5,121,0,0,625,626,5,116,0,0,
+	626,627,5,101,0,0,627,628,5,115,0,0,628,630,1,0,0,0,629,631,3,129,64,0,
+	630,629,1,0,0,0,630,631,1,0,0,0,631,637,1,0,0,0,632,633,5,98,0,0,633,634,
+	5,121,0,0,634,635,5,116,0,0,635,637,5,101,0,0,636,623,1,0,0,0,636,632,1,
+	0,0,0,637,128,1,0,0,0,638,642,7,2,0,0,639,641,7,0,0,0,640,639,1,0,0,0,641,
+	644,1,0,0,0,642,640,1,0,0,0,642,643,1,0,0,0,643,130,1,0,0,0,644,642,1,0,
+	0,0,645,651,5,34,0,0,646,647,5,92,0,0,647,650,5,34,0,0,648,650,8,3,0,0,
+	649,646,1,0,0,0,649,648,1,0,0,0,650,653,1,0,0,0,651,652,1,0,0,0,651,649,
+	1,0,0,0,652,654,1,0,0,0,653,651,1,0,0,0,654,666,5,34,0,0,655,661,5,39,0,
+	0,656,657,5,92,0,0,657,660,5,39,0,0,658,660,8,4,0,0,659,656,1,0,0,0,659,
+	658,1,0,0,0,660,663,1,0,0,0,661,662,1,0,0,0,661,659,1,0,0,0,662,664,1,0,
+	0,0,663,661,1,0,0,0,664,666,5,39,0,0,665,645,1,0,0,0,665,655,1,0,0,0,666,
+	132,1,0,0,0,667,668,5,100,0,0,668,669,5,97,0,0,669,670,5,116,0,0,670,671,
+	5,101,0,0,671,672,5,40,0,0,672,673,1,0,0,0,673,674,3,131,65,0,674,675,5,
+	41,0,0,675,134,1,0,0,0,676,677,5,48,0,0,677,681,7,5,0,0,678,680,7,6,0,0,
+	679,678,1,0,0,0,680,683,1,0,0,0,681,679,1,0,0,0,681,682,1,0,0,0,682,136,
+	1,0,0,0,683,681,1,0,0,0,684,685,5,116,0,0,685,686,5,120,0,0,686,687,5,46,
+	0,0,687,688,5,97,0,0,688,689,5,103,0,0,689,698,5,101,0,0,690,691,5,116,
+	0,0,691,692,5,120,0,0,692,693,5,46,0,0,693,694,5,116,0,0,694,695,5,105,
+	0,0,695,696,5,109,0,0,696,698,5,101,0,0,697,684,1,0,0,0,697,690,1,0,0,0,
+	698,138,1,0,0,0,699,700,5,116,0,0,700,701,5,104,0,0,701,702,5,105,0,0,702,
+	703,5,115,0,0,703,704,5,46,0,0,704,705,5,97,0,0,705,706,5,99,0,0,706,707,
+	5,116,0,0,707,708,5,105,0,0,708,709,5,118,0,0,709,710,5,101,0,0,710,711,
+	5,73,0,0,711,712,5,110,0,0,712,713,5,112,0,0,713,714,5,117,0,0,714,715,
+	5,116,0,0,715,716,5,73,0,0,716,717,5,110,0,0,717,718,5,100,0,0,718,719,
+	5,101,0,0,719,794,5,120,0,0,720,721,5,116,0,0,721,722,5,104,0,0,722,723,
+	5,105,0,0,723,724,5,115,0,0,724,725,5,46,0,0,725,726,5,97,0,0,726,727,5,
+	99,0,0,727,728,5,116,0,0,728,729,5,105,0,0,729,730,5,118,0,0,730,731,5,
+	101,0,0,731,732,5,66,0,0,732,733,5,121,0,0,733,734,5,116,0,0,734,735,5,
+	101,0,0,735,736,5,99,0,0,736,737,5,111,0,0,737,738,5,100,0,0,738,794,5,
+	101,0,0,739,740,5,116,0,0,740,741,5,120,0,0,741,742,5,46,0,0,742,743,5,
+	105,0,0,743,744,5,110,0,0,744,745,5,112,0,0,745,746,5,117,0,0,746,747,5,
+	116,0,0,747,748,5,115,0,0,748,749,5,46,0,0,749,750,5,108,0,0,750,751,5,
+	101,0,0,751,752,5,110,0,0,752,753,5,103,0,0,753,754,5,116,0,0,754,794,5,
+	104,0,0,755,756,5,116,0,0,756,757,5,120,0,0,757,758,5,46,0,0,758,759,5,
+	111,0,0,759,760,5,117,0,0,760,761,5,116,0,0,761,762,5,112,0,0,762,763,5,
+	117,0,0,763,764,5,116,0,0,764,765,5,115,0,0,765,766,5,46,0,0,766,767,5,
+	108,0,0,767,768,5,101,0,0,768,769,5,110,0,0,769,770,5,103,0,0,770,771,5,
+	116,0,0,771,794,5,104,0,0,772,773,5,116,0,0,773,774,5,120,0,0,774,775,5,
+	46,0,0,775,776,5,118,0,0,776,777,5,101,0,0,777,778,5,114,0,0,778,779,5,
+	115,0,0,779,780,5,105,0,0,780,781,5,111,0,0,781,794,5,110,0,0,782,783,5,
+	116,0,0,783,784,5,120,0,0,784,785,5,46,0,0,785,786,5,108,0,0,786,787,5,
+	111,0,0,787,788,5,99,0,0,788,789,5,107,0,0,789,790,5,116,0,0,790,791,5,
+	105,0,0,791,792,5,109,0,0,792,794,5,101,0,0,793,699,1,0,0,0,793,720,1,0,
+	0,0,793,739,1,0,0,0,793,755,1,0,0,0,793,772,1,0,0,0,793,782,1,0,0,0,794,
+	140,1,0,0,0,795,799,7,7,0,0,796,798,7,8,0,0,797,796,1,0,0,0,798,801,1,0,
+	0,0,799,797,1,0,0,0,799,800,1,0,0,0,800,142,1,0,0,0,801,799,1,0,0,0,802,
+	804,7,9,0,0,803,802,1,0,0,0,804,805,1,0,0,0,805,803,1,0,0,0,805,806,1,0,
+	0,0,806,807,1,0,0,0,807,808,6,71,0,0,808,144,1,0,0,0,809,810,5,47,0,0,810,
+	811,5,42,0,0,811,815,1,0,0,0,812,814,9,0,0,0,813,812,1,0,0,0,814,817,1,
+	0,0,0,815,816,1,0,0,0,815,813,1,0,0,0,816,818,1,0,0,0,817,815,1,0,0,0,818,
+	819,5,42,0,0,819,820,5,47,0,0,820,821,1,0,0,0,821,822,6,72,1,0,822,146,
+	1,0,0,0,823,824,5,47,0,0,824,825,5,47,0,0,825,829,1,0,0,0,826,828,8,10,
+	0,0,827,826,1,0,0,0,828,831,1,0,0,0,829,827,1,0,0,0,829,830,1,0,0,0,830,
+	832,1,0,0,0,831,829,1,0,0,0,832,833,6,73,1,0,833,148,1,0,0,0,26,0,513,519,
+	525,536,595,598,602,607,613,617,630,636,642,649,651,659,661,665,681,697,
+	793,799,805,815,829,2,6,0,0,0,1,0];
 
 	private static __ATN: ATN;
 	public static get _ATN(): ATN {
diff --git a/packages/cashc/src/grammar/CashScriptParser.ts b/packages/cashc/src/grammar/CashScriptParser.ts
index 834c589b..1d1a622c 100644
--- a/packages/cashc/src/grammar/CashScriptParser.ts
+++ b/packages/cashc/src/grammar/CashScriptParser.ts
@@ -79,17 +79,19 @@ export default class CashScriptParser extends Parser {
 	public static readonly BooleanLiteral = 59;
 	public static readonly NumberUnit = 60;
 	public static readonly NumberLiteral = 61;
-	public static readonly Bytes = 62;
-	public static readonly Bound = 63;
-	public static readonly StringLiteral = 64;
-	public static readonly DateLiteral = 65;
-	public static readonly HexLiteral = 66;
-	public static readonly TxVar = 67;
-	public static readonly NullaryOp = 68;
-	public static readonly Identifier = 69;
-	public static readonly WHITESPACE = 70;
-	public static readonly COMMENT = 71;
-	public static readonly LINE_COMMENT = 72;
+	public static readonly NumberPart = 62;
+	public static readonly ExponentPart = 63;
+	public static readonly Bytes = 64;
+	public static readonly Bound = 65;
+	public static readonly StringLiteral = 66;
+	public static readonly DateLiteral = 67;
+	public static readonly HexLiteral = 68;
+	public static readonly TxVar = 69;
+	public static readonly NullaryOp = 70;
+	public static readonly Identifier = 71;
+	public static readonly WHITESPACE = 72;
+	public static readonly COMMENT = 73;
+	public static readonly LINE_COMMENT = 74;
 	public static readonly EOF = Token.EOF;
 	public static readonly RULE_sourceFile = 0;
 	public static readonly RULE_pragmaDirective = 1;
@@ -191,6 +193,8 @@ export default class CashScriptParser extends Parser {
                                                              "BooleanLiteral", 
                                                              "NumberUnit", 
                                                              "NumberLiteral", 
+                                                             "NumberPart", 
+                                                             "ExponentPart", 
                                                              "Bytes", "Bound", 
                                                              "StringLiteral", 
                                                              "DateLiteral", 
@@ -494,7 +498,7 @@ export default class CashScriptParser extends Parser {
 			this.state = 104;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			while ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2883584) !== 0) || ((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 132159) !== 0)) {
+			while ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2883584) !== 0) || ((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 528447) !== 0)) {
 				{
 				{
 				this.state = 101;
@@ -537,7 +541,7 @@ export default class CashScriptParser extends Parser {
 			this.state = 121;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			if (((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 1087) !== 0)) {
+			if (((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 4159) !== 0)) {
 				{
 				this.state = 110;
 				this.parameter();
@@ -634,7 +638,7 @@ export default class CashScriptParser extends Parser {
 				this.state = 132;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
-				while ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2883584) !== 0) || ((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 132159) !== 0)) {
+				while ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2883584) !== 0) || ((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 528447) !== 0)) {
 					{
 					{
 					this.state = 129;
@@ -658,8 +662,8 @@ export default class CashScriptParser extends Parser {
 			case 55:
 			case 56:
 			case 57:
-			case 62:
-			case 69:
+			case 64:
+			case 71:
 				this.enterOuterAlt(localctx, 2);
 				{
 				this.state = 136;
@@ -1078,7 +1082,7 @@ export default class CashScriptParser extends Parser {
 			this.state = 213;
 			this._errHandler.sync(this);
 			switch (this._input.LA(1)) {
-			case 69:
+			case 71:
 				this.enterOuterAlt(localctx, 1);
 				{
 				this.state = 211;
@@ -1087,9 +1091,9 @@ export default class CashScriptParser extends Parser {
 				break;
 			case 59:
 			case 61:
-			case 64:
-			case 65:
 			case 66:
+			case 67:
+			case 68:
 				this.enterOuterAlt(localctx, 2);
 				{
 				this.state = 212;
@@ -1128,7 +1132,7 @@ export default class CashScriptParser extends Parser {
 			this.state = 227;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			if (((((_la - 59)) & ~0x1F) === 0 && ((1 << (_la - 59)) & 1253) !== 0)) {
+			if (((((_la - 59)) & ~0x1F) === 0 && ((1 << (_la - 59)) & 4997) !== 0)) {
 				{
 				this.state = 216;
 				this.consoleParameter();
@@ -1222,7 +1226,7 @@ export default class CashScriptParser extends Parser {
 			this.state = 246;
 			this._errHandler.sync(this);
 			_la = this._input.LA(1);
-			if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2193653760) !== 0) || ((((_la - 39)) & ~0x1F) === 0 && ((1 << (_la - 39)) & 1859641347) !== 0)) {
+			if (((((_la - 15)) & ~0x1F) === 0 && ((1 << (_la - 15)) & 50398593) !== 0) || ((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 905919) !== 0)) {
 				{
 				this.state = 235;
 				this.expression(0);
@@ -1450,7 +1454,7 @@ export default class CashScriptParser extends Parser {
 				this.state = 297;
 				this._errHandler.sync(this);
 				_la = this._input.LA(1);
-				if ((((_la) & ~0x1F) === 0 && ((1 << _la) & 2193653760) !== 0) || ((((_la - 39)) & ~0x1F) === 0 && ((1 << (_la - 39)) & 1859641347) !== 0)) {
+				if (((((_la - 15)) & ~0x1F) === 0 && ((1 << (_la - 15)) & 50398593) !== 0) || ((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 905919) !== 0)) {
 					{
 					this.state = 286;
 					this.expression(0);
@@ -1823,21 +1827,21 @@ export default class CashScriptParser extends Parser {
 				this.numberLiteral();
 				}
 				break;
-			case 64:
+			case 66:
 				this.enterOuterAlt(localctx, 3);
 				{
 				this.state = 353;
 				this.match(CashScriptParser.StringLiteral);
 				}
 				break;
-			case 65:
+			case 67:
 				this.enterOuterAlt(localctx, 4);
 				{
 				this.state = 354;
 				this.match(CashScriptParser.DateLiteral);
 				}
 				break;
-			case 66:
+			case 68:
 				this.enterOuterAlt(localctx, 5);
 				{
 				this.state = 355;
@@ -1907,7 +1911,7 @@ export default class CashScriptParser extends Parser {
 			{
 			this.state = 362;
 			_la = this._input.LA(1);
-			if(!(((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 1087) !== 0))) {
+			if(!(((((_la - 52)) & ~0x1F) === 0 && ((1 << (_la - 52)) & 4159) !== 0))) {
 			this._errHandler.recoverInline(this);
 			}
 			else {
@@ -1968,7 +1972,7 @@ export default class CashScriptParser extends Parser {
 		return true;
 	}
 
-	public static readonly _serializedATN: number[] = [4,1,72,365,2,0,7,0,2,
+	public static readonly _serializedATN: number[] = [4,1,74,365,2,0,7,0,2,
 	1,7,1,2,2,7,2,2,3,7,3,2,4,7,4,2,5,7,5,2,6,7,6,2,7,7,7,2,8,7,8,2,9,7,9,2,
 	10,7,10,2,11,7,11,2,12,7,12,2,13,7,13,2,14,7,14,2,15,7,15,2,16,7,16,2,17,
 	7,17,2,18,7,18,2,19,7,19,2,20,7,20,2,21,7,21,2,22,7,22,2,23,7,23,2,24,7,
@@ -1998,7 +2002,7 @@ export default class CashScriptParser extends Parser {
 	3,27,361,8,27,1,28,1,28,1,28,0,1,48,29,0,2,4,6,8,10,12,14,16,18,20,22,24,
 	26,28,30,32,34,36,38,40,42,44,46,48,50,52,54,56,0,10,1,0,4,10,1,0,26,30,
 	2,0,26,30,32,35,1,0,39,40,1,0,41,43,2,0,40,40,44,44,1,0,6,9,1,0,45,46,1,
-	0,36,37,2,0,52,57,62,62,394,0,61,1,0,0,0,2,67,1,0,0,0,4,72,1,0,0,0,6,74,
+	0,36,37,2,0,52,57,64,64,394,0,61,1,0,0,0,2,67,1,0,0,0,4,72,1,0,0,0,6,74,
 	1,0,0,0,8,79,1,0,0,0,10,83,1,0,0,0,12,85,1,0,0,0,14,97,1,0,0,0,16,109,1,
 	0,0,0,18,125,1,0,0,0,20,137,1,0,0,0,22,146,1,0,0,0,24,148,1,0,0,0,26,160,
 	1,0,0,0,28,169,1,0,0,0,30,174,1,0,0,0,32,186,1,0,0,0,34,196,1,0,0,0,36,
@@ -2010,17 +2014,17 @@ export default class CashScriptParser extends Parser {
 	0,71,3,1,0,0,0,72,73,5,3,0,0,73,5,1,0,0,0,74,76,3,8,4,0,75,77,3,8,4,0,76,
 	75,1,0,0,0,76,77,1,0,0,0,77,7,1,0,0,0,78,80,3,10,5,0,79,78,1,0,0,0,79,80,
 	1,0,0,0,80,81,1,0,0,0,81,82,5,58,0,0,82,9,1,0,0,0,83,84,7,0,0,0,84,11,1,
-	0,0,0,85,86,5,11,0,0,86,87,5,69,0,0,87,88,3,16,8,0,88,92,5,12,0,0,89,91,
+	0,0,0,85,86,5,11,0,0,86,87,5,71,0,0,87,88,3,16,8,0,88,92,5,12,0,0,89,91,
 	3,14,7,0,90,89,1,0,0,0,91,94,1,0,0,0,92,90,1,0,0,0,92,93,1,0,0,0,93,95,
 	1,0,0,0,94,92,1,0,0,0,95,96,5,13,0,0,96,13,1,0,0,0,97,98,5,14,0,0,98,99,
-	5,69,0,0,99,100,3,16,8,0,100,104,5,12,0,0,101,103,3,22,11,0,102,101,1,0,
+	5,71,0,0,99,100,3,16,8,0,100,104,5,12,0,0,101,103,3,22,11,0,102,101,1,0,
 	0,0,103,106,1,0,0,0,104,102,1,0,0,0,104,105,1,0,0,0,105,107,1,0,0,0,106,
 	104,1,0,0,0,107,108,5,13,0,0,108,15,1,0,0,0,109,121,5,15,0,0,110,115,3,
 	18,9,0,111,112,5,16,0,0,112,114,3,18,9,0,113,111,1,0,0,0,114,117,1,0,0,
 	0,115,113,1,0,0,0,115,116,1,0,0,0,116,119,1,0,0,0,117,115,1,0,0,0,118,120,
 	5,16,0,0,119,118,1,0,0,0,119,120,1,0,0,0,120,122,1,0,0,0,121,110,1,0,0,
 	0,121,122,1,0,0,0,122,123,1,0,0,0,123,124,5,17,0,0,124,17,1,0,0,0,125,126,
-	3,56,28,0,126,127,5,69,0,0,127,19,1,0,0,0,128,132,5,12,0,0,129,131,3,22,
+	3,56,28,0,126,127,5,71,0,0,127,19,1,0,0,0,128,132,5,12,0,0,129,131,3,22,
 	11,0,130,129,1,0,0,0,131,134,1,0,0,0,132,130,1,0,0,0,132,133,1,0,0,0,133,
 	135,1,0,0,0,134,132,1,0,0,0,135,138,5,13,0,0,136,138,3,22,11,0,137,128,
 	1,0,0,0,137,136,1,0,0,0,138,21,1,0,0,0,139,147,3,24,12,0,140,147,3,26,13,
@@ -2029,11 +2033,11 @@ export default class CashScriptParser extends Parser {
 	142,1,0,0,0,146,143,1,0,0,0,146,144,1,0,0,0,146,145,1,0,0,0,147,23,1,0,
 	0,0,148,152,3,56,28,0,149,151,3,50,25,0,150,149,1,0,0,0,151,154,1,0,0,0,
 	152,150,1,0,0,0,152,153,1,0,0,0,153,155,1,0,0,0,154,152,1,0,0,0,155,156,
-	5,69,0,0,156,157,5,10,0,0,157,158,3,48,24,0,158,159,5,2,0,0,159,25,1,0,
-	0,0,160,161,3,56,28,0,161,162,5,69,0,0,162,163,5,16,0,0,163,164,3,56,28,
-	0,164,165,5,69,0,0,165,166,5,10,0,0,166,167,3,48,24,0,167,168,5,2,0,0,168,
-	27,1,0,0,0,169,170,5,69,0,0,170,171,5,10,0,0,171,172,3,48,24,0,172,173,
-	5,2,0,0,173,29,1,0,0,0,174,175,5,18,0,0,175,176,5,15,0,0,176,177,5,67,0,
+	5,71,0,0,156,157,5,10,0,0,157,158,3,48,24,0,158,159,5,2,0,0,159,25,1,0,
+	0,0,160,161,3,56,28,0,161,162,5,71,0,0,162,163,5,16,0,0,163,164,3,56,28,
+	0,164,165,5,71,0,0,165,166,5,10,0,0,166,167,3,48,24,0,167,168,5,2,0,0,168,
+	27,1,0,0,0,169,170,5,71,0,0,170,171,5,10,0,0,171,172,3,48,24,0,172,173,
+	5,2,0,0,173,29,1,0,0,0,174,175,5,18,0,0,175,176,5,15,0,0,176,177,5,69,0,
 	0,177,178,5,6,0,0,178,181,3,48,24,0,179,180,5,16,0,0,180,182,3,38,19,0,
 	181,179,1,0,0,0,181,182,1,0,0,0,182,183,1,0,0,0,183,184,5,17,0,0,184,185,
 	5,2,0,0,185,31,1,0,0,0,186,187,5,18,0,0,187,188,5,15,0,0,188,191,3,48,24,
@@ -2042,13 +2046,13 @@ export default class CashScriptParser extends Parser {
 	0,0,197,198,5,15,0,0,198,199,3,48,24,0,199,200,5,17,0,0,200,203,3,20,10,
 	0,201,202,5,20,0,0,202,204,3,20,10,0,203,201,1,0,0,0,203,204,1,0,0,0,204,
 	35,1,0,0,0,205,206,5,21,0,0,206,207,3,42,21,0,207,208,5,2,0,0,208,37,1,
-	0,0,0,209,210,5,64,0,0,210,39,1,0,0,0,211,214,5,69,0,0,212,214,3,52,26,
+	0,0,0,209,210,5,66,0,0,210,39,1,0,0,0,211,214,5,71,0,0,212,214,3,52,26,
 	0,213,211,1,0,0,0,213,212,1,0,0,0,214,41,1,0,0,0,215,227,5,15,0,0,216,221,
 	3,40,20,0,217,218,5,16,0,0,218,220,3,40,20,0,219,217,1,0,0,0,220,223,1,
 	0,0,0,221,219,1,0,0,0,221,222,1,0,0,0,222,225,1,0,0,0,223,221,1,0,0,0,224,
 	226,5,16,0,0,225,224,1,0,0,0,225,226,1,0,0,0,226,228,1,0,0,0,227,216,1,
 	0,0,0,227,228,1,0,0,0,228,229,1,0,0,0,229,230,5,17,0,0,230,43,1,0,0,0,231,
-	232,5,69,0,0,232,233,3,46,23,0,233,45,1,0,0,0,234,246,5,15,0,0,235,240,
+	232,5,71,0,0,232,233,3,46,23,0,233,45,1,0,0,0,234,246,5,15,0,0,235,240,
 	3,48,24,0,236,237,5,16,0,0,237,239,3,48,24,0,238,236,1,0,0,0,239,242,1,
 	0,0,0,240,238,1,0,0,0,240,241,1,0,0,0,241,244,1,0,0,0,242,240,1,0,0,0,243,
 	245,5,16,0,0,244,243,1,0,0,0,244,245,1,0,0,0,245,247,1,0,0,0,246,235,1,
@@ -2058,15 +2062,15 @@ export default class CashScriptParser extends Parser {
 	16,0,0,259,261,3,48,24,0,260,258,1,0,0,0,260,261,1,0,0,0,261,263,1,0,0,
 	0,262,264,5,16,0,0,263,262,1,0,0,0,263,264,1,0,0,0,264,265,1,0,0,0,265,
 	266,5,17,0,0,266,304,1,0,0,0,267,304,3,44,22,0,268,269,5,22,0,0,269,270,
-	5,69,0,0,270,304,3,46,23,0,271,272,5,25,0,0,272,273,5,23,0,0,273,274,3,
+	5,71,0,0,270,304,3,46,23,0,271,272,5,25,0,0,272,273,5,23,0,0,273,274,3,
 	48,24,0,274,275,5,24,0,0,275,276,7,1,0,0,276,304,1,0,0,0,277,278,5,31,0,
 	0,278,279,5,23,0,0,279,280,3,48,24,0,280,281,5,24,0,0,281,282,7,2,0,0,282,
 	304,1,0,0,0,283,284,7,3,0,0,284,304,3,48,24,14,285,297,5,23,0,0,286,291,
 	3,48,24,0,287,288,5,16,0,0,288,290,3,48,24,0,289,287,1,0,0,0,290,293,1,
 	0,0,0,291,289,1,0,0,0,291,292,1,0,0,0,292,295,1,0,0,0,293,291,1,0,0,0,294,
 	296,5,16,0,0,295,294,1,0,0,0,295,296,1,0,0,0,296,298,1,0,0,0,297,286,1,
-	0,0,0,297,298,1,0,0,0,298,299,1,0,0,0,299,304,5,24,0,0,300,304,5,68,0,0,
-	301,304,5,69,0,0,302,304,3,52,26,0,303,250,1,0,0,0,303,255,1,0,0,0,303,
+	0,0,0,297,298,1,0,0,0,298,299,1,0,0,0,299,304,5,24,0,0,300,304,5,70,0,0,
+	301,304,5,71,0,0,302,304,3,52,26,0,303,250,1,0,0,0,303,255,1,0,0,0,303,
 	267,1,0,0,0,303,268,1,0,0,0,303,271,1,0,0,0,303,277,1,0,0,0,303,283,1,0,
 	0,0,303,285,1,0,0,0,303,300,1,0,0,0,303,301,1,0,0,0,303,302,1,0,0,0,304,
 	346,1,0,0,0,305,306,10,13,0,0,306,307,7,4,0,0,307,345,3,48,24,14,308,309,
@@ -2083,7 +2087,7 @@ export default class CashScriptParser extends Parser {
 	0,0,344,326,1,0,0,0,344,329,1,0,0,0,344,332,1,0,0,0,344,336,1,0,0,0,344,
 	338,1,0,0,0,345,348,1,0,0,0,346,344,1,0,0,0,346,347,1,0,0,0,347,49,1,0,
 	0,0,348,346,1,0,0,0,349,350,5,51,0,0,350,51,1,0,0,0,351,357,5,59,0,0,352,
-	357,3,54,27,0,353,357,5,64,0,0,354,357,5,65,0,0,355,357,5,66,0,0,356,351,
+	357,3,54,27,0,353,357,5,66,0,0,354,357,5,67,0,0,355,357,5,68,0,0,356,351,
 	1,0,0,0,356,352,1,0,0,0,356,353,1,0,0,0,356,354,1,0,0,0,356,355,1,0,0,0,
 	357,53,1,0,0,0,358,360,5,61,0,0,359,361,5,60,0,0,360,359,1,0,0,0,360,361,
 	1,0,0,0,361,55,1,0,0,0,362,363,7,9,0,0,363,57,1,0,0,0,32,61,76,79,92,104,
diff --git a/packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_1.cash b/packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_1.cash
new file mode 100644
index 00000000..dc7fd793
--- /dev/null
+++ b/packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_1.cash
@@ -0,0 +1,5 @@
+contract Test() {
+    function hello() {
+        require(1000 == 1__000);
+    }
+}
diff --git a/packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_2.cash b/packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_2.cash
new file mode 100644
index 00000000..c38aa394
--- /dev/null
+++ b/packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_2.cash
@@ -0,0 +1,5 @@
+contract Test() {
+    function hello() {
+        require(1000 == _1000);
+    }
+}
diff --git a/packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_3.cash b/packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_3.cash
new file mode 100644
index 00000000..a10e81ee
--- /dev/null
+++ b/packages/cashc/test/compiler/ParseError/incorrect_underscore_in_number_3.cash
@@ -0,0 +1,5 @@
+contract Test() {
+    function hello() {
+        require(1000 == 1000_);
+    }
+}
diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index 882c095f..5735b517 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -745,12 +745,12 @@ export const fixtures: Fixture[] = [
       abi: [
         { name: 'test', inputs: [] },
       ],
-      bytecode: '00ca9a3b 00ca9a3b 00ca9a3b OP_ROT OP_OVER OP_NUMEQUALVERIFY OP_NUMEQUAL',
+      bytecode: '0010a5d4e800 0010a5d4e800 0010a5d4e800 0010a5d4e800 0010a5d4e800 OP_4 OP_ROLL OP_OVER OP_NUMEQUALVERIFY OP_3 OP_ROLL OP_OVER OP_NUMEQUALVERIFY OP_ROT OP_OVER OP_NUMEQUALVERIFY OP_NUMEQUAL',
       debug: {
-        bytecode: '0400ca9a3b0400ca9a3b0400ca9a3b527a51799c69517a517a9c',
+        bytecode: '060010a5d4e800060010a5d4e800060010a5d4e800060010a5d4e800060010a5d4e800547a51799c69537a51799c69527a51799c69517a517a9c',
         logs: [],
-        requires: [{ ip: 8, line: 8 }, { ip: 14, line: 9 }],
-        sourceMap: '3:26:3:29;4::4;6:22:6:32;8:16:8:27;;:31::38;;:16:::1;:8::40;9:16:9:27:0;;:31::38;;:16:::1',
+        requires: [{ ip: 10, line: 10 }, { ip: 16, line: 11 }, { ip: 22, line: 12 }, { ip: 28, line: 13 }],
+        sourceMap: '3:26:3:30;4::4;5::5:43;6:23:6:30;8:22:8:35;10:16:10:27;;:31::38;;:16:::1;:8::40;11:16:11:27:0;;:31::38;;:16:::1;:8::40;12:16:12:27:0;;:31::38;;:16:::1;:8::40;13:16:13:24:0;;:28::35;;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/integer_formatting.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
diff --git a/packages/cashc/test/valid-contract-files/integer_formatting.cash b/packages/cashc/test/valid-contract-files/integer_formatting.cash
index 1ad05cc6..c1d98d91 100644
--- a/packages/cashc/test/valid-contract-files/integer_formatting.cash
+++ b/packages/cashc/test/valid-contract-files/integer_formatting.cash
@@ -1,12 +1,15 @@
 contract IntegerFormatting() {
     function test() {
-        int scientific1 = 1e9;
-        int scientific2 = 1E9;
-        // int underscores = 1_000_000_000;
-        int regular = 1000000000;
+        int scientific1 = 1e12;
+        int scientific2 = 1E12;
+        int underscores = 1_000_000_000_000;
+        int combined = 1_0e1_1;
+
+        int regular = 1000000000000;
 
         require(scientific1 == regular);
         require(scientific2 == regular);
-        // require()
+        require(underscores == regular);
+        require(combined == regular);
     }
 }
diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index ca548665..ba661d5c 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -29,6 +29,10 @@ Operators:
 
 Note the lack of the `**` (exponentiation) operator as well as any bitwise operators.
 
+#### Number Formatting
+
+Underscores can be used to separate the digits of a numeric literal to aid readability, e.g. `1_000_000`. Numbers can also be formatted in scientific notation, e.g. `1e6` or `1E6`. These can also be combined, e.g. `1_000e6`.
+
 #### Over- & Underflows
 
 The maximum range for 64-bit integers is `-9223372036854775807` to `9223372036854775807`, operations exceeding these limits will fail the transaction. So operations like summation, subtraction and multiplication should take into account these boundary cases with over- or underflows.

From 2b72ff23858a8f504536161047169548f61fc954 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 4 Nov 2024 09:33:07 +0100
Subject: [PATCH 149/267] Bump version to 0.10.2 and add release notes for it

---
 examples/package.json                  |  6 +++---
 examples/testing-suite/package.json    |  6 +++---
 packages/cashc/package.json            |  4 ++--
 packages/cashc/src/index.ts            |  2 +-
 packages/cashscript/package.json       |  4 ++--
 packages/utils/package.json            |  2 +-
 website/docs/releases/release-notes.md | 10 ++++++++++
 7 files changed, 22 insertions(+), 12 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index 49248b1c..f3c9c7d6 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
     "@types/node": "^12.7.8",
-    "cashc": "^0.10.1",
-    "cashscript": "^0.10.1",
+    "cashc": "^0.10.2",
+    "cashscript": "^0.10.2",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 683610a6..e1a41d13 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -25,8 +25,8 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "cashc": "^0.10.1",
-    "cashscript": "^0.10.1",
+    "cashc": "^0.10.2",
+    "cashscript": "^0.10.2",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 42282d96..a12434df 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.1",
+    "@cashscript/utils": "^0.10.2",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index e405f28e..e62cf342 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.1';
+export const version = '0.10.2';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 219b0e89..16e38966 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.1",
+    "@cashscript/utils": "^0.10.2",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "delay": "^5.0.0",
     "electrum-cash": "^2.0.10",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 969aa2a8..ea0efcef 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 0d9242e6..da27834f 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,6 +2,16 @@
 title: Release Notes
 ---
 
+## v0.10.2
+
+#### cashc compiler
+- :sparkles: Add support for using underscores in numeric literals to improve readability, e.g. `1_000_000`.
+- :sparkles: Add support for using scientific notation in numeric literals, e.g. `1e6` or `1E6`.
+
+#### CashScript SDK
+- :bug: Fix fee calculation when using `SignatureAlgorithm.ECDSA`.
+- :hammer_and_wrench: Clean up dependencies.
+
 ## v0.10.1
 
 #### CashScript SDK

From a7c4f652462ddfccd54fc929f06cb16022769df9 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 4 Nov 2024 09:35:06 +0100
Subject: [PATCH 150/267] Fix failing test suite

---
 packages/cashscript/test/e2e/network/FullStack.test.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/cashscript/test/e2e/network/FullStack.test.ts b/packages/cashscript/test/e2e/network/FullStack.test.ts
index d231ef50..221c0c4a 100644
--- a/packages/cashscript/test/e2e/network/FullStack.test.ts
+++ b/packages/cashscript/test/e2e/network/FullStack.test.ts
@@ -73,4 +73,6 @@ if (!process.env.TESTS_USE_MOCKNET) {
       });
     });
   });
+} else {
+  test.skip('skip', () => {});
 }

From 202b649fc8aeeca1c21acbd175d549cf705e68c0 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Tue, 19 Nov 2024 10:15:43 +0100
Subject: [PATCH 151/267] fix json imports in docs (#242)

---
 website/docs/basics/getting-started.md | 2 +-
 website/docs/sdk/instantiation.md      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index a3d6f351..7c14079d 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -108,7 +108,7 @@ Now to initialise a contract we will import the `ElectrumNetworkProvider` and `C
 
 ```javascript
 import { ElectrumNetworkProvider, Contract } from 'cashscript';
-import artifact from './TransferWithTimeout.json';
+import artifact from './TransferWithTimeout.json' with { type: 'json' };
 import { alicePub, bobPub } from './keys.js';
 
 // Initialise a network provider for network operations
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 4d7a3980..29bdb91c 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -42,7 +42,7 @@ import { Contract, ElectrumNetworkProvider } from 'cashscript';
 import { compileFile } from 'cashc';
 
 // Import the artifact JSON
-import P2PKH from './p2pkh.json';
+import P2PKH from './p2pkh.json' with { type: 'json' };
 
 // Or compile a contract file
 const P2PKH = compileFile(new URL('p2pkh.cash', import.meta.url));

From 1dec0f61444fde33839e3e583e3cb43052af224c Mon Sep 17 00:00:00 2001
From: PHCitizen <75726261+PHCitizen@users.noreply.github.com>
Date: Tue, 3 Dec 2024 19:07:40 +0800
Subject: [PATCH 152/267] Add generics for contract type-safety (#192)

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
---
 README.md                                     |  19 +-
 packages/cashc/README.md                      |  17 +-
 packages/cashc/src/cashc-cli.ts               |  12 +-
 packages/cashscript/README.md                 |   2 +-
 packages/cashscript/src/Contract.ts           |  39 ++-
 packages/cashscript/src/LibauthTemplate.ts    |  10 +-
 .../cashscript/src/types/type-inference.ts    |  79 ++++++
 packages/cashscript/src/utils.ts              |  14 +-
 .../test/fixture/announcement.artifact.ts     |  17 ++
 .../test/fixture/hodl_vault.artifact.ts       |  47 ++++
 .../cashscript/test/fixture/p2pkh.artifact.ts |  31 +++
 .../fixture/transfer_with_timeout.artifact.ts |  44 ++++
 .../test/types/Contract.types.test.ts         | 240 ++++++++++++++++++
 packages/utils/src/artifact.ts                |  53 +++-
 website/docs/compiler/artifacts.md            |   2 +-
 website/docs/compiler/compiler.md             |  25 +-
 website/docs/releases/release-notes.md        |   8 +
 website/docs/sdk/instantiation.md             |   8 +-
 18 files changed, 607 insertions(+), 60 deletions(-)
 create mode 100644 packages/cashscript/src/types/type-inference.ts
 create mode 100644 packages/cashscript/test/fixture/announcement.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/hodl_vault.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/p2pkh.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
 create mode 100644 packages/cashscript/test/types/Contract.types.test.ts

diff --git a/README.md b/README.md
index 03114fda..f10c6c51 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@ CashScript is a high-level language that allows you to write Bitcoin Cash smart
 
 ## The CashScript Compiler
 
-CashScript features a compiler as a standalone command line tool, called `cashc`. It can be installed through npm and used to compile `.cash` files into `.json` artifact files. These artifact files can be imported into the CashScript TypeScript SDK (or other SDKs in the future). The `cashc` NPM package can also be imported inside JavaScript files to compile `.cash` files without using the command line tool.
+CashScript features a compiler as a standalone command line tool, called `cashc`. It can be installed through npm and used to compile `.cash` files into `.json` (or `.ts`) artifact files. These artifact files can be imported into the CashScript TypeScript SDK (or other SDKs in the future). The `cashc` NPM package can also be imported inside JavaScript files to compile `.cash` files without using the command line tool.
 
 ### Installation
 
@@ -30,18 +30,19 @@ npm install -g cashc
 Usage: cashc [options] [source_file]
 
 Options:
-  -V, --version        Output the version number.
-  -o, --output <path>  Specify a file to output the generated artifact.
-  -h, --hex            Compile the contract to hex format rather than a full artifact.
-  -A, --asm            Compile the contract to ASM format rather than a full artifact.
-  -c, --opcount        Display the number of opcodes in the compiled bytecode.
-  -s, --size           Display the size in bytes of the compiled bytecode.
-  -?, --help           Display help
+  -V, --version          Output the version number.
+  -o, --output <path>    Specify a file to output the generated artifact.
+  -h, --hex              Compile the contract to hex format rather than a full artifact.
+  -A, --asm              Compile the contract to ASM format rather than a full artifact.
+  -c, --opcount          Display the number of opcodes in the compiled bytecode.
+  -s, --size             Display the size in bytes of the compiled bytecode.
+  -f, --format <format>  Specify the format of the output. (choices: "json", "ts", default: "json")
+  -?, --help             Display help
 ```
 
 ## The CashScript SDK
 
-The main way to interact with CashScript contracts and integrate them into applications is using the CashScript SDK. This SDK allows you to import `.json` artifact files that were compiled using the `cashc` compiler and convert them to `Contract` objects. These objects are used to create new contract instances. These instances are used to interact with the contracts using the functions that were implemented in the `.cash` file. For more information on the CashScript SDK, refer to the [SDK documentation](https://cashscript.org/docs/sdk/).
+The main way to interact with CashScript contracts and integrate them into applications is using the CashScript SDK. This SDK allows you to import `.json` (or `.ts`) artifact files that were compiled using the `cashc` compiler and convert them to `Contract` objects. These objects are used to create new contract instances. These instances are used to interact with the contracts using the functions that were implemented in the `.cash` file. For more information on the CashScript SDK, refer to the [SDK documentation](https://cashscript.org/docs/sdk/).
 
 ### Installation
 
diff --git a/packages/cashc/README.md b/packages/cashc/README.md
index dd1e0ada..674ef4ba 100644
--- a/packages/cashc/README.md
+++ b/packages/cashc/README.md
@@ -14,7 +14,7 @@ See the [GitHub repository](https://github.com/CashScript/cashscript) and the [C
 CashScript is a high-level language that allows you to write Bitcoin Cash smart contracts in a straightforward and familiar way. Its syntax is inspired by Ethereum's Solidity language, but its functionality is different since the underlying systems have very different fundamentals. See the [language documentation](https://cashscript.org/docs/language/) for a full reference of the language.
 
 ## The CashScript Compiler
-CashScript features a compiler as a standalone command line tool, called `cashc`. It can be installed through npm and used to compile `.cash` files into `.json` artifact files. These artifact files can be imported into the CashScript TypeScript SDK (or other SDKs in the future). The `cashc` NPM package can also be imported inside JavaScript files to compile `.cash` files without using the command line tool.
+CashScript features a compiler as a standalone command line tool, called `cashc`. It can be installed through npm and used to compile `.cash` files into `.json` (or `.ts`)artifact files. These artifact files can be imported into the CashScript TypeScript SDK (or other SDKs in the future). The `cashc` NPM package can also be imported inside JavaScript files to compile `.cash` files without using the command line tool.
 
 ### Installation
 ```bash
@@ -26,11 +26,12 @@ npm install -g cashc
 Usage: cashc [options] [source_file]
 
 Options:
-  -V, --version        Output the version number.
-  -o, --output <path>  Specify a file to output the generated artifact.
-  -h, --hex            Compile the contract to hex format rather than a full artifact.
-  -A, --asm            Compile the contract to ASM format rather than a full artifact.
-  -c, --opcount        Display the number of opcodes in the compiled bytecode.
-  -s, --size           Display the size in bytes of the compiled bytecode.
-  -?, --help           Display help
+  -V, --version          Output the version number.
+  -o, --output <path>    Specify a file to output the generated artifact.
+  -h, --hex              Compile the contract to hex format rather than a full artifact.
+  -A, --asm              Compile the contract to ASM format rather than a full artifact.
+  -c, --opcount          Display the number of opcodes in the compiled bytecode.
+  -s, --size             Display the size in bytes of the compiled bytecode.
+  -f, --format <format>  Specify the format of the output. (choices: "json", "ts", default: "json")
+  -?, --help             Display help
 ```
diff --git a/packages/cashc/src/cashc-cli.ts b/packages/cashc/src/cashc-cli.ts
index 5ba31a45..7b353790 100644
--- a/packages/cashc/src/cashc-cli.ts
+++ b/packages/cashc/src/cashc-cli.ts
@@ -5,10 +5,11 @@ import {
   calculateBytesize,
   countOpcodes,
   exportArtifact,
+  formatArtifact,
   scriptToAsm,
   scriptToBytecode,
 } from '@cashscript/utils';
-import { program } from 'commander';
+import { program, Option } from 'commander';
 import fs from 'fs';
 import path from 'path';
 import { compileFile, version } from './index.js';
@@ -23,6 +24,11 @@ program
   .option('-A, --asm', 'Compile the contract to ASM format rather than a full artifact.')
   .option('-c, --opcount', 'Display the number of opcodes in the compiled bytecode.')
   .option('-s, --size', 'Display the size in bytes of the compiled bytecode.')
+  .addOption(
+    new Option('-f, --format <format>', 'Specify the format of the output.')
+      .choices(['json', 'ts'])
+      .default('json'),
+  )
   .helpOption('-?, --help', 'Display help')
   .parse();
 
@@ -82,10 +88,10 @@ function run(): void {
       if (!fs.existsSync(outputDir)) {
         fs.mkdirSync(outputDir, { recursive: true });
       }
-      exportArtifact(artifact, outputFile);
+      exportArtifact(artifact, outputFile, opts.format);
     } else {
       // Output artifact to STDOUT
-      console.log(JSON.stringify(artifact, null, 2));
+      console.log(formatArtifact(artifact, opts.format));
     }
   } catch (e: any) {
     abort(e.message);
diff --git a/packages/cashscript/README.md b/packages/cashscript/README.md
index bd8bdf1f..472c5f70 100644
--- a/packages/cashscript/README.md
+++ b/packages/cashscript/README.md
@@ -14,7 +14,7 @@ See the [GitHub repository](https://github.com/CashScript/cashscript) and the [C
 CashScript is a high-level language that allows you to write Bitcoin Cash smart contracts in a straightforward and familiar way. Its syntax is inspired by Ethereum's Solidity language, but its functionality is different since the underlying systems have very different fundamentals. See the [language documentation](https://cashscript.org/docs/language/) for a full reference of the language.
 
 ## The CashScript SDK
-The main way to interact with CashScript contracts and integrate them into applications is using the CashScript SDK. This SDK allows you to import `.json` artifact files that were compiled using the `cashc` compiler and convert them to `Contract` objects. These objects are used to create new contract instances. These instances are used to interact with the contracts using the functions that were implemented in the `.cash` file. For more information on the CashScript SDK, refer to the [SDK documentation](https://cashscript.org/docs/sdk/).
+The main way to interact with CashScript contracts and integrate them into applications is using the CashScript SDK. This SDK allows you to import `.json` (or `.ts`) artifact files that were compiled using the `cashc` compiler and convert them to `Contract` objects. These objects are used to create new contract instances. These instances are used to interact with the contracts using the functions that were implemented in the `.cash` file. For more information on the CashScript SDK, refer to the [SDK documentation](https://cashscript.org/docs/sdk/).
 
 ### Installation
 ```bash
diff --git a/packages/cashscript/src/Contract.ts b/packages/cashscript/src/Contract.ts
index b6334963..dfe428fd 100644
--- a/packages/cashscript/src/Contract.ts
+++ b/packages/cashscript/src/Contract.ts
@@ -11,7 +11,9 @@ import {
   scriptToBytecode,
 } from '@cashscript/utils';
 import { Transaction } from './Transaction.js';
-import { ConstructorArgument, encodeFunctionArgument, encodeConstructorArguments, encodeFunctionArguments, FunctionArgument } from './Argument.js';
+import {
+  ConstructorArgument, encodeFunctionArgument, encodeConstructorArguments, encodeFunctionArguments, FunctionArgument,
+} from './Argument.js';
 import {
   Unlocker, ContractOptions, GenerateUnlockingBytecodeOptions, Utxo,
   AddressType,
@@ -22,8 +24,21 @@ import {
 } from './utils.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { ElectrumNetworkProvider } from './network/index.js';
-
-export class Contract {
+import { ParamsToTuple, AbiToFunctionMap } from './types/type-inference.js';
+
+export class Contract<
+  TArtifact extends Artifact = Artifact,
+  TResolved extends {
+    constructorInputs: ConstructorArgument[];
+    functions: Record<string, any>;
+    unlock: Record<string, any>;
+  }
+  = {
+    constructorInputs: ParamsToTuple<TArtifact['constructorInputs']>;
+    functions: AbiToFunctionMap<TArtifact['abi'], Transaction>;
+    unlock: AbiToFunctionMap<TArtifact['abi'], Unlocker>;
+  },
+> {
   name: string;
   address: string;
   tokenAddress: string;
@@ -31,8 +46,8 @@ export class Contract {
   bytesize: number;
   opcount: number;
 
-  functions: Record<string, ContractFunction>;
-  unlock: Record<string, ContractUnlocker>;
+  functions: TResolved['functions'];
+  unlock: TResolved['unlock'];
 
   redeemScript: Script;
   public provider: NetworkProvider;
@@ -40,8 +55,8 @@ export class Contract {
   public encodedConstructorArgs: Uint8Array[];
 
   constructor(
-    public artifact: Artifact,
-    constructorArgs: ConstructorArgument[],
+    public artifact: TArtifact,
+    constructorArgs: TResolved['constructorInputs'],
     private options?: ContractOptions,
   ) {
     this.provider = this.options?.provider ?? new ElectrumNetworkProvider();
@@ -53,7 +68,7 @@ export class Contract {
     }
 
     if (artifact.constructorInputs.length !== constructorArgs.length) {
-      throw new Error(`Incorrect number of arguments passed to ${artifact.contractName} constructor. Expected ${artifact.constructorInputs.length} arguments (${artifact.constructorInputs.map(input => input.type)}) but got ${constructorArgs.length}`);
+      throw new Error(`Incorrect number of arguments passed to ${artifact.contractName} constructor. Expected ${artifact.constructorInputs.length} arguments (${artifact.constructorInputs.map((input) => input.type)}) but got ${constructorArgs.length}`);
     }
 
     // Encode arguments (this also performs type checking)
@@ -66,9 +81,11 @@ export class Contract {
     this.functions = {};
     if (artifact.abi.length === 1) {
       const f = artifact.abi[0];
+      // @ts-ignore TODO: see if we can use generics to make TypeScript happy
       this.functions[f.name] = this.createFunction(f);
     } else {
       artifact.abi.forEach((f, i) => {
+        // @ts-ignore TODO: see if we can use generics to make TypeScript happy
         this.functions[f.name] = this.createFunction(f, i);
       });
     }
@@ -78,9 +95,11 @@ export class Contract {
     this.unlock = {};
     if (artifact.abi.length === 1) {
       const f = artifact.abi[0];
+      // @ts-ignore TODO: see if we can use generics to make TypeScript happy
       this.unlock[f.name] = this.createUnlocker(f);
     } else {
       artifact.abi.forEach((f, i) => {
+        // @ts-ignore TODO: see if we can use generics to make TypeScript happy
         this.unlock[f.name] = this.createUnlocker(f, i);
       });
     }
@@ -105,7 +124,7 @@ export class Contract {
   private createFunction(abiFunction: AbiFunction, selector?: number): ContractFunction {
     return (...args: FunctionArgument[]) => {
       if (abiFunction.inputs.length !== args.length) {
-        throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}. Expected ${abiFunction.inputs.length} arguments (${abiFunction.inputs.map(input => input.type)}) but got ${args.length}`);
+        throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}. Expected ${abiFunction.inputs.length} arguments (${abiFunction.inputs.map((input) => input.type)}) but got ${args.length}`);
       }
 
       // Encode passed args (this also performs type checking)
@@ -126,7 +145,7 @@ export class Contract {
   private createUnlocker(abiFunction: AbiFunction, selector?: number): ContractUnlocker {
     return (...args: FunctionArgument[]) => {
       if (abiFunction.inputs.length !== args.length) {
-        throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}. Expected ${abiFunction.inputs.length} arguments (${abiFunction.inputs.map(input => input.type)}) but got ${args.length}`);
+        throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}. Expected ${abiFunction.inputs.length} arguments (${abiFunction.inputs.map((input) => input.type)}) but got ${args.length}`);
       }
 
       const bytecode = scriptToBytecode(this.redeemScript);
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index e07faa14..b931c50d 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -105,14 +105,14 @@ export const buildTemplate = async ({
       template.scripts[unlockScriptName] = {
         name: unlockScriptName,
         script:
-            `<${signatureString}>\n<${placeholderKeyName}.public_key>`,
+          `<${signatureString}>\n<${placeholderKeyName}.public_key>`,
         unlocks: lockScriptName,
       };
       template.scripts[lockScriptName] = {
         lockingType: 'standard',
         name: lockScriptName,
         script:
-            `OP_DUP\nOP_HASH160 <$(<${placeholderKeyName}.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG`,
+          `OP_DUP\nOP_HASH160 <$(<${placeholderKeyName}.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG`,
       };
     });
 
@@ -358,7 +358,7 @@ const generateTemplateScenarioBytecode = (
 };
 
 const generateTemplateScenarioParametersValues = (
-  types: AbiInput[],
+  types: readonly AbiInput[],
   encodedArgs: EncodedFunctionArgument[],
 ): Record<string, string> => {
   const typesAndArguments = zip(types, encodedArgs);
@@ -376,7 +376,7 @@ const generateTemplateScenarioParametersValues = (
 };
 
 const generateTemplateScenarioKeys = (
-  types: AbiInput[],
+  types: readonly AbiInput[],
   encodedArgs: EncodedFunctionArgument[],
 ): Record<string, string> => {
   const typesAndArguments = zip(types, encodedArgs);
@@ -388,7 +388,7 @@ const generateTemplateScenarioKeys = (
   return Object.fromEntries(entries);
 };
 
-const formatParametersForDebugging = (types: AbiInput[], args: EncodedFunctionArgument[]): string => {
+const formatParametersForDebugging = (types: readonly AbiInput[], args: EncodedFunctionArgument[]): string => {
   if (types.length === 0) return '// none';
 
   // We reverse the arguments because the order of the arguments in the bytecode is reversed
diff --git a/packages/cashscript/src/types/type-inference.ts b/packages/cashscript/src/types/type-inference.ts
new file mode 100644
index 00000000..bef3df50
--- /dev/null
+++ b/packages/cashscript/src/types/type-inference.ts
@@ -0,0 +1,79 @@
+import type SignatureTemplate from '../SignatureTemplate.js';
+
+type TypeMap = {
+  [k: `bytes${number}`]: Uint8Array | string; // Matches any "bytes<number>" pattern
+} & {
+  byte: Uint8Array | string;
+  bytes: Uint8Array | string;
+  bool: boolean;
+  int: bigint;
+  string: string;
+  pubkey: Uint8Array | string;
+  sig: SignatureTemplate | Uint8Array | string;
+  datasig: Uint8Array | string;
+};
+
+// Helper type to process a single parameter by mapping its `type` to a value in `TypeMap`.
+// Example: { type: "pubkey" } -> Uint8Array
+// Branches:
+// - If `Param` is a known type, it maps the `type` to `TypeMap[Type]`.
+// - If `Param` has an unknown `type`, it defaults to `any`.
+// - If `Param` is not an object with `type`, it defaults to `any`.
+type ProcessParam<Param> = Param extends { type: infer Type }
+  ? Type extends keyof TypeMap
+    ? TypeMap[Type]
+    : any
+  : any;
+
+// Main type to recursively convert an array of parameter definitions into a tuple.
+// Example: [{ type: "pubkey" }, { type: "int" }] -> [Uint8Array, bigint]
+// Branches:
+// - If `Params` is a tuple with a `Head` that matches `ProcessParam`, it processes the head and recurses on the `Tail`.
+// - If `Params` is an empty tuple, it returns [].
+// - If `Params` is not an array or tuple, it defaults to any[].
+export type ParamsToTuple<Params> = Params extends readonly [infer Head, ...infer Tail]
+  ? [ProcessParam<Head>, ...ParamsToTuple<Tail>]
+  : Params extends readonly []
+    ? []
+    : any[];
+
+// Processes a single function definition into a function mapping with parameters and return type.
+// Example: { name: "transfer", inputs: [{ type: "int" }] } -> { transfer: (arg0: bigint) => ReturnType }
+// Branches:
+// - Branch 1: If `Function` is an object with `name` and `inputs`, it creates a function mapping.
+// - Branch 2: If `Function` does not match the expected shape, it returns an empty object.
+type ProcessFunction<Function, ReturnType> = Function extends { name: string; inputs: readonly any[] }
+  ? {
+    [functionName in Function['name']]: (...functionParameters: ParamsToTuple<Function['inputs']>) => ReturnType;
+  }
+  : {};
+
+// Recursively converts an ABI into a function map with parameter typings and return type.
+// Example:
+// [
+//   { name: "transfer", inputs: [{ type: "int" }] },
+//   { name: "approve", inputs: [{ type: "address" }, { type: "int" }] }
+// ] ->
+// { transfer: (arg0: bigint) => ReturnType; approve: (arg0: string, arg1: bigint) => ReturnType }
+// Branches:
+// - Branch 1: If `Abi` is `unknown` or `any`, return a default function map with generic parameters and return type.
+// - Branch 2: If `Abi` is a tuple with a `Head`, process `Head` using `ProcessFunction` and recurse on the `Tail`.
+// - Branch 3: If `Abi` is an empty tuple, return an empty object.
+// - Branch 4: If `Abi` is not an array or tuple, return a generic function map.
+type InternalAbiToFunctionMap<Abi, ReturnType> =
+  // Check if Abi is typed as `any`, in which case we return a default function map
+  unknown extends Abi
+    ? GenericFunctionMap<ReturnType>
+    : Abi extends readonly [infer Head, ...infer Tail]
+      ? ProcessFunction<Head, ReturnType> & InternalAbiToFunctionMap<Tail, ReturnType>
+      : Abi extends readonly []
+        ? {}
+        : GenericFunctionMap<ReturnType>;
+
+type GenericFunctionMap<ReturnType> = { [functionName: string]: (...functionParameters: any[]) => ReturnType };
+
+// Merge intersection type
+// Example: {foo: "foo"} & {bar: "bar"} -> {foo: "foo", bar: "bar"}
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
+
+export type AbiToFunctionMap<T, ReturnType> = Prettify<InternalAbiToFunctionMap<T, ReturnType>>;
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index b9dca04b..0cbddf65 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -345,12 +345,12 @@ export function findLastIndex<T>(array: Array<T>, predicate: (value: T, index: n
 
 export const snakeCase = (str: string): string => (
   str
-    && str
-      .match(
-        /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g,
-      )!
-      .map((s) => s.toLowerCase())
-      .join('_')
+  && str
+    .match(
+      /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g,
+    )!
+    .map((s) => s.toLowerCase())
+    .join('_')
 );
 
 // JSON.stringify version that can serialize otherwise unsupported types (bigint and Uint8Array)
@@ -368,6 +368,6 @@ export const extendedStringify = (obj: any, spaces?: number): string => JSON.str
   spaces,
 );
 
-export const zip = <T, U>(a: T[], b: U[]): [T, U][] => (
+export const zip = <T, U>(a: readonly T[], b: readonly U[]): [T, U][] => (
   Array.from(Array(Math.max(b.length, a.length)), (_, i) => [a[i], b[i]])
 );
diff --git a/packages/cashscript/test/fixture/announcement.artifact.ts b/packages/cashscript/test/fixture/announcement.artifact.ts
new file mode 100644
index 00000000..1e148582
--- /dev/null
+++ b/packages/cashscript/test/fixture/announcement.artifact.ts
@@ -0,0 +1,17 @@
+export default {
+  contractName: 'Announcement',
+  constructorInputs: [],
+  abi: [
+    {
+      name: 'announce',
+      inputs: [],
+    },
+  ],
+  bytecode: '6a 6d02 OP_SIZE OP_SWAP OP_CAT OP_CAT 4120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e OP_SIZE OP_DUP 4b OP_GREATERTHAN OP_IF 4c OP_SWAP OP_CAT OP_ENDIF OP_SWAP OP_CAT OP_CAT OP_0 OP_OUTPUTVALUE OP_0 OP_NUMEQUALVERIFY OP_0 OP_OUTPUTBYTECODE OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_OVER OP_SUB OP_DUP OP_ROT OP_GREATERTHANOREQUAL OP_IF OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_DROP OP_1',
+  source: 'pragma cashscript ^0.9.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an "announcement" on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes(\'A contract may not injure a human being or, through inaction, allow a human being to come to harm.\')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there\'s enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n',
+  compiler: {
+    name: 'cashc',
+    version: '0.8.0-next.0',
+  },
+  updatedAt: '2023-02-10T15:22:49.703Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/hodl_vault.artifact.ts b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
new file mode 100644
index 00000000..91d90149
--- /dev/null
+++ b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
@@ -0,0 +1,47 @@
+export default {
+  contractName: 'HodlVault',
+  constructorInputs: [
+    {
+      name: 'ownerPk',
+      type: 'pubkey',
+    },
+    {
+      name: 'oraclePk',
+      type: 'pubkey',
+    },
+    {
+      name: 'minBlock',
+      type: 'int',
+    },
+    {
+      name: 'priceTarget',
+      type: 'int',
+    },
+  ],
+  abi: [
+    {
+      name: 'spend',
+      inputs: [
+        {
+          name: 'ownerSig',
+          type: 'sig',
+        },
+        {
+          name: 'oracleSig',
+          type: 'datasig',
+        },
+        {
+          name: 'oracleMessage',
+          type: 'bytes8',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_6 OP_PICK OP_4 OP_SPLIT OP_SWAP OP_BIN2NUM OP_SWAP OP_BIN2NUM OP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY OP_CHECKSIG',
+  source: '// This contract forces HODLing until a certain price target has been reached\n// A minimum block is provided to ensure that oracle price entries from before this block are disregarded\n// i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used.\n// Instead, a message with a block number and price from after the minBlock needs to be passed.\n// This contract serves as a simple example for checkDataSig-based contracts.\ncontract HodlVault(\n    pubkey ownerPk,\n    pubkey oraclePk,\n    int minBlock,\n    int priceTarget\n) {\n    function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {\n        // message: { blockHeight, price }\n        bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);\n        int blockHeight = int(blockHeightBin);\n        int price = int(priceBin);\n\n        // Check that blockHeight is after minBlock and not in the future\n        require(blockHeight >= minBlock);\n        require(tx.time >= blockHeight);\n\n        // Check that current price is at least priceTarget\n        require(price >= priceTarget);\n\n        // Handle necessary signature checks\n        require(checkDataSig(oracleSig, oracleMessage, oraclePk));\n        require(checkSig(ownerSig, ownerPk));\n    }\n}\n',
+  compiler: {
+    name: 'cashc',
+    version: '0.8.0-next.0',
+  },
+  updatedAt: '2023-02-10T15:22:49.985Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/p2pkh.artifact.ts b/packages/cashscript/test/fixture/p2pkh.artifact.ts
new file mode 100644
index 00000000..d679d513
--- /dev/null
+++ b/packages/cashscript/test/fixture/p2pkh.artifact.ts
@@ -0,0 +1,31 @@
+export default {
+  contractName: 'P2PKH',
+  constructorInputs: [
+    {
+      name: 'pkh',
+      type: 'bytes20',
+    },
+  ],
+  abi: [
+    {
+      name: 'spend',
+      inputs: [
+        {
+          name: 'pk',
+          type: 'pubkey',
+        },
+        {
+          name: 's',
+          type: 'sig',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG',
+  source: 'contract P2PKH(bytes20 pkh) {\n    // Require pk to match stored pkh and signature to match\n    function spend(pubkey pk, sig s) {\n        require(hash160(pk) == pkh);\n        require(checkSig(s, pk));\n    }\n}\n',
+  compiler: {
+    name: 'cashc',
+    version: '0.8.0-next.0',
+  },
+  updatedAt: '2023-02-10T15:22:51.429Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
new file mode 100644
index 00000000..8a16ce38
--- /dev/null
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
@@ -0,0 +1,44 @@
+export default {
+  contractName: 'TransferWithTimeout',
+  constructorInputs: [
+    {
+      name: 'sender',
+      type: 'pubkey',
+    },
+    {
+      name: 'recipient',
+      type: 'pubkey',
+    },
+    {
+      name: 'timeout',
+      type: 'int',
+    },
+  ],
+  abi: [
+    {
+      name: 'transfer',
+      inputs: [
+        {
+          name: 'recipientSig',
+          type: 'sig',
+        },
+      ],
+    },
+    {
+      name: 'timeout',
+      inputs: [
+        {
+          name: 'senderSig',
+          type: 'sig',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_ROLL OP_ROT OP_CHECKSIG OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_2DROP OP_1 OP_ENDIF',
+  source: "contract TransferWithTimeout(\n    pubkey sender,\n    pubkey recipient,\n    int timeout\n) {\n    // Require recipient's signature to match\n    function transfer(sig recipientSig) {\n        require(checkSig(recipientSig, recipient));\n    }\n\n    // Require timeout time to be reached and sender's signature to match\n    function timeout(sig senderSig) {\n        require(checkSig(senderSig, sender));\n        require(tx.time >= timeout);\n    }\n}\n",
+  compiler: {
+    name: 'cashc',
+    version: '0.8.0-next.0',
+  },
+  updatedAt: '2023-02-10T15:22:51.144Z',
+} as const;
diff --git a/packages/cashscript/test/types/Contract.types.test.ts b/packages/cashscript/test/types/Contract.types.test.ts
new file mode 100644
index 00000000..ea1cc81c
--- /dev/null
+++ b/packages/cashscript/test/types/Contract.types.test.ts
@@ -0,0 +1,240 @@
+/* eslint-disable */
+import { Artifact, Contract, SignatureTemplate, Transaction, Unlocker } from 'cashscript';
+import p2pkhArtifact from '../fixture/p2pkh.artifact';
+import p2pkhArtifactJsonNotConst from '../fixture/p2pkh.json';
+import announcementArtifact from '../fixture/announcement.artifact';
+import hodlVaultArtifact from '../fixture/hodl_vault.artifact';
+import transferWithTimeoutArtifact from '../fixture/transfer_with_timeout.artifact';
+import { alicePkh, alicePriv, alicePub, bobPub, oraclePub } from '../fixture/vars';
+import { binToHex } from '@bitauth/libauth';
+
+interface ManualArtifactType extends Artifact {
+  constructorInputs: [
+    {
+      name: 'pkh',
+      type: 'bytes20',
+    },
+  ],
+  abi: [
+    {
+      name: 'spend',
+      inputs: [
+        {
+          name: 'pk',
+          type: 'pubkey',
+        },
+        {
+          name: 's',
+          type: 'sig',
+        },
+      ],
+    },
+  ]
+}
+
+// describe('P2PKH contract | single constructor input | single function (2 args)')
+{
+  // describe('Contructor arguments')
+  {
+    // it('should not give type errors when using correct constructor inputs')
+    new Contract(p2pkhArtifact, [alicePkh]);
+    new Contract(p2pkhArtifact, [binToHex(alicePkh)]);
+
+    // it('should give type errors when using empty constructor inputs')
+    // @ts-expect-error
+    new Contract(p2pkhArtifact, []);
+
+    // it('should give type errors when using incorrect constructor input type')
+    // @ts-expect-error
+    new Contract(p2pkhArtifact, [1000n]);
+
+    // it('should give type errors when using incorrect constructor input length')
+    // @ts-expect-error
+    new Contract(p2pkhArtifact, [alicePkh, 1000n]);
+
+    // it('should not perform type checking when cast to any')
+    new Contract(p2pkhArtifact as any, [alicePkh, 1000n]);
+
+    // it('should not perform type checking when cannot infer type')
+    // Note: would be very nice if it *could* infer the type from static json
+    new Contract(p2pkhArtifactJsonNotConst, [alicePkh, 1000n]);
+
+    // it('should perform type checking when manually specifying a type
+    // @ts-expect-error
+    new Contract<ManualArtifactType>(p2pkhArtifactJsonNotConst as any, [alicePkh, 1000n]);
+  }
+
+  // describe('Contract functions')
+  {
+    const contract = new Contract(p2pkhArtifact, [alicePkh]);
+
+    // it('should not give type errors when using correct function inputs')
+    contract.functions.spend(alicePub, new SignatureTemplate(alicePriv)).build();
+
+    // it('should give type errors when calling a function that does not exist')
+    // @ts-expect-error
+    contract.functions.notAFunction();
+
+    // it('should give type errors when using incorrect function input types')
+    // @ts-expect-error
+    contract.functions.spend(1000n, true);
+
+    // it('should give type errors when using incorrect function input length')
+    // @ts-expect-error
+    contract.functions.spend(alicePub, new SignatureTemplate(alicePriv), 100n);
+    // @ts-expect-error
+    contract.functions.spend(alicePub);
+
+    // it('should not perform type checking when cast to any')
+    const contractAsAny = new Contract(p2pkhArtifact as any, [alicePkh, 1000n]);
+    contractAsAny.functions.notAFunction().build();
+    contractAsAny.functions.spend();
+    contractAsAny.functions.spend(1000n, true);
+
+    // it('should not perform type checking when cannot infer type')
+    // Note: would be very nice if it *could* infer the type from static json
+    const contractFromUnknown = new Contract(p2pkhArtifactJsonNotConst, [alicePkh, 1000n]);
+    contractFromUnknown.functions.notAFunction().build();
+    contractFromUnknown.functions.spend();
+    contractFromUnknown.functions.spend(1000n, true);
+
+    // it('should give type errors when calling methods that do not exist on the returned object')
+    // @ts-expect-error
+    contract.functions.spend().notAFunction();
+    // @ts-expect-error
+    contractAsAny.functions.spend().notAFunction();
+    // @ts-expect-error
+    contractFromUnknown.functions.spend().notAFunction();
+  }
+
+  // describe('Contract unlockers')
+  {
+    const contract = new Contract(p2pkhArtifact, [alicePkh]);
+
+    // it('should not give type errors when using correct function inputs')
+    contract.unlock.spend(alicePub, new SignatureTemplate(alicePriv)).generateLockingBytecode();
+
+    // it('should give type errors when calling a function that does not exist')
+    // @ts-expect-error
+    contract.unlock.notAFunction();
+
+    // it('should give type errors when using incorrect function input types')
+    // @ts-expect-error
+    contract.unlock.spend(1000n, true);
+
+    // it('should give type errors when using incorrect function input length')
+    // @ts-expect-error
+    contract.unlock.spend(alicePub, new SignatureTemplate(alicePriv), 100n);
+    // @ts-expect-error
+    contract.unlock.spend(alicePub);
+
+    // it('should not perform type checking when cast to any')
+    const contractAsAny = new Contract(p2pkhArtifact as any, [alicePkh, 1000n]);
+    contractAsAny.unlock.notAFunction().generateLockingBytecode();
+    contractAsAny.unlock.spend();
+    contractAsAny.unlock.spend(1000n, true);
+
+    // it('should not perform type checking when cannot infer type')
+    // Note: would be very nice if it *could* infer the type from static json
+    const contractFromUnknown = new Contract(p2pkhArtifactJsonNotConst, [alicePkh, 1000n]);
+    contractFromUnknown.unlock.notAFunction().generateLockingBytecode();
+    contractFromUnknown.unlock.spend();
+    contractFromUnknown.unlock.spend(1000n, true);
+
+    // it('should give type errors when calling methods that do not exist on the returned object')
+    // @ts-expect-error
+    contract.unlock.spend().notAFunction();
+    // @ts-expect-error
+    contractAsAny.unlock.spend().notAFunction();
+    // @ts-expect-error
+    contractFromUnknown.unlock.spend().notAFunction();
+  }
+}
+
+// describe('Announcement contract | no constructor inputs | single function (no args)')
+{
+  // describe('Constructor arguments')
+  {
+    // it('should not give type errors when using correct constructor inputs')
+    new Contract(announcementArtifact, []);
+
+    // it('should give type errors when using incorrect constructor input length')
+    // @ts-expect-error
+    new Contract(announcementArtifact, [1000n]);
+
+    // it('should give type errors when passing in completely incorrect type')
+    // @ts-expect-error
+    new Contract(announcementArtifact, 'hello');
+  }
+
+  // describe('Contract functions')
+  {
+    // it('should not give type errors when using correct function inputs')
+    const contract = new Contract(announcementArtifact, []);
+
+    // it('should not give type errors when using correct function inputs')
+    contract.functions.announce();
+
+    // it('should give type errors when calling a function that does not exist')
+    // @ts-expect-error
+    contract.functions.notAFunction();
+
+    // it('should give type errors when using incorrect function input length')
+    // @ts-expect-error
+    contract.functions.announce('hello world');
+  }
+}
+
+// describe('HodlVault contract | 4 constructor inputs | single function (3 args)')
+{
+  // describe('Constructor arguments')
+  {
+    // it('should not give type errors when using correct constructor inputs')
+    new Contract(hodlVaultArtifact, [alicePub, binToHex(oraclePub), 1000n, 1000n]);
+
+    // it('should give type errors when using too few constructor inputs')
+    // @ts-expect-error
+    new Contract(hodlVaultArtifact, [alicePub, binToHex(oraclePub)]);
+
+    // it('should give type errors when using incorrect constructor input type')
+    // @ts-expect-error
+    new Contract(hodlVaultArtifact, [alicePub, binToHex(oraclePub), 1000n, 'hello']);
+    // @ts-expect-error
+    new Contract(hodlVaultArtifact, [alicePub, binToHex(oraclePub), true, 1000n]);
+  }
+}
+
+
+// describe('TransferWithTimeout contract | 3 constructor inputs | two functions (1 arg each)')
+{
+  // describe('Constructor arguments')
+  {
+    // it('should not give type errors when using correct constructor inputs')
+    new Contract(transferWithTimeoutArtifact, [alicePub, bobPub, 100_000n]);
+  }
+
+  // describe('Contract functions')
+  {
+    const contract = new Contract(transferWithTimeoutArtifact, [alicePub, bobPub, 100_000n]);
+
+    // it('should not give type errors when using correct function inputs')
+    contract.functions.transfer(new SignatureTemplate(alicePriv));
+    contract.functions.timeout(new SignatureTemplate(alicePriv));
+
+    // it('should give type errors when calling a function that does not exist')
+    // @ts-expect-error
+    contract.functions.notAFunction();
+
+    // it('should give type errors when using incorrect function input types')
+    // @ts-expect-error
+    contract.functions.transfer(1000n);
+    // @ts-expect-error
+    contract.functions.timeout(true);
+
+    // it('should give type errors when using incorrect function input length')
+    // @ts-expect-error
+    contract.functions.transfer(new SignatureTemplate(alicePub), 100n);
+    // @ts-expect-error
+    contract.functions.timeout();
+  }
+}
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index 0c5814ac..14707807 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -8,7 +8,7 @@ export interface AbiInput {
 export interface AbiFunction {
   name: string;
   covenant?: boolean;
-  inputs: AbiInput[];
+  inputs: readonly AbiInput[];
 }
 
 export interface DebugInformation {
@@ -40,8 +40,8 @@ export interface RequireStatement {
 
 export interface Artifact {
   contractName: string;
-  constructorInputs: AbiInput[];
-  abi: AbiFunction[];
+  constructorInputs: readonly AbiInput[];
+  abi: readonly AbiFunction[];
   bytecode: string;
   source: string;
   debug?: DebugInformation;
@@ -56,7 +56,50 @@ export function importArtifact(artifactFile: PathLike): Artifact {
   return JSON.parse(fs.readFileSync(artifactFile, { encoding: 'utf-8' }));
 }
 
-export function exportArtifact(artifact: Artifact, targetFile: string): void {
-  const jsonString = JSON.stringify(artifact, null, 2);
+export function exportArtifact(artifact: Artifact, targetFile: string, format: 'json' | 'ts'): void {
+  const jsonString = formatArtifact(artifact, format);
   fs.writeFileSync(targetFile, jsonString);
 }
+
+export function formatArtifact(artifact: Artifact, format: 'json' | 'ts'): string {
+  if (format === 'ts') {
+    return `export default ${stringifyAsTs(artifact)} as const;\n`;
+  }
+
+  return JSON.stringify(artifact, null, 2);
+}
+
+const indent = (level: number): string => '  '.repeat(level);
+
+function stringifyAsTs(obj: any, indentationLevel: number = 1): string {
+  // For strings, we use JSON.stringify, but we convert double quotes to single quotes
+  if (typeof obj === 'string') {
+    return JSON.stringify(obj).replace(/'/g, "\\'").replace(/"/g, "'");
+  }
+
+  // Numbers and booleans are just converted to strings
+  if (typeof obj === 'number' || typeof obj === 'boolean') {
+    return JSON.stringify(obj);
+  }
+
+  // Arrays are recursively formatted with indentation
+  if (Array.isArray(obj)) {
+    if (obj.length === 0) return '[]';
+    const formattedItems = obj.map((item) => `${indent(indentationLevel)}${stringifyAsTs(item, indentationLevel + 1)}`);
+    return `[\n${formattedItems.join(',\n')},\n${indent(indentationLevel - 1)}]`;
+  }
+
+  // Objects are recursively formatted with indentation
+  if (typeof obj === 'object') {
+    const entries = Object.entries(obj);
+
+    if (entries.length === 0) return '{}';
+
+    const formattedEntries = entries.map(([key, value]) => (
+      `${indent(indentationLevel)}${key}: ${stringifyAsTs(value, indentationLevel + 1)}`
+    ));
+    return `{\n${formattedEntries.join(',\n')},\n${indent(indentationLevel - 1)}}`;
+  }
+
+  throw new Error(`Unsupported type: ${typeof obj}`);
+}
diff --git a/website/docs/compiler/artifacts.md b/website/docs/compiler/artifacts.md
index fcc144f0..3db42ff4 100644
--- a/website/docs/compiler/artifacts.md
+++ b/website/docs/compiler/artifacts.md
@@ -2,7 +2,7 @@
 title: Artifacts
 ---
 
-Compiled contracts can be represented by so-called artifacts. These artifacts contain all information that is needed to interact with the smart contracts on-chain. Artifacts are stored in `.json` files so they can be shared and stored for later usage without having to recompile the contract.
+Compiled contracts can be represented by so-called artifacts. These artifacts contain all information that is needed to interact with the smart contracts on-chain. Artifacts are stored in `.json` (or `.ts`) files so they can be shared and stored for later usage without having to recompile the contract.
 
 :::tip Did you know?
 Artifacts allow any third-party SDKs to be developed, since these SDKs only need to import and use an artifact file, while the compilation of the contract is left to the official `cashc` compiler.
diff --git a/website/docs/compiler/compiler.md b/website/docs/compiler/compiler.md
index 493900f0..510ea0ba 100644
--- a/website/docs/compiler/compiler.md
+++ b/website/docs/compiler/compiler.md
@@ -2,12 +2,12 @@
 title: Compiler
 ---
 
-The CashScript compiler is called `cashc` and is used to compile CashScript `.cash` contract files into `.json` artifact files.
+The CashScript compiler is called `cashc` and is used to compile CashScript `.cash` contract files into `.json` (or `.ts`) artifact files.
 These artifact files can be used to instantiate a CashScript contract with the help of the CashScript SDK. For more information on this artifact format refer to [Artifacts](/docs/compiler/artifacts).
 
 ## Command Line Interface
 
-The `cashc` command line interface is used to compile CashScript `.cash` files into `.json` artifact files.
+The `cashc` command line interface is used to compile CashScript `.cash` files into `.json` (or `.ts`) artifact files.
 
 ### Installation
 You can use `npm` to install the `cashc` command line tool globally.
@@ -17,21 +17,26 @@ npm install -g cashc
 ```
 
 ### CLI Usage
-The `cashc` CLI tool can be used to compile `.cash` files to JSON artifact files.
+The `cashc` CLI tool can be used to compile `.cash` files to JSON (or `.ts`) artifact files.
 
 ```bash
 Usage: cashc [options] [source_file]
 
 Options:
-  -V, --version        Output the version number.
-  -o, --output <path>  Specify a file to output the generated artifact.
-  -h, --hex            Compile the contract to hex format rather than a full artifact.
-  -A, --asm            Compile the contract to ASM format rather than a full artifact.
-  -c, --opcount        Display the number of opcodes in the compiled bytecode.
-  -s, --size           Display the size in bytes of the compiled bytecode.
-  -?, --help           Display help
+  -V, --version          Output the version number.
+  -o, --output <path>    Specify a file to output the generated artifact.
+  -h, --hex              Compile the contract to hex format rather than a full artifact.
+  -A, --asm              Compile the contract to ASM format rather than a full artifact.
+  -c, --opcount          Display the number of opcodes in the compiled bytecode.
+  -s, --size             Display the size in bytes of the compiled bytecode.
+  -f, --format <format>  Specify the format of the output. (choices: "json", "ts", default: "json")
+  -?, --help             Display help
 ```
 
+:::tip
+To have the best TypeScript integration, we recommend generating the artifact in the `.ts` format and importing it into your TypeScript project from that `.ts` file.
+:::
+
 ## JavaScript Compilation
 Generally CashScript contracts are compiled to an Artifact JSON file using the CLI compiler. As an alternative to this, CashScript contracts can be compiled from within JavaScript apps using the `cashc` package. This package exports two compilation functions.
 
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index da27834f..5a9fb560 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,6 +2,14 @@
 title: Release Notes
 ---
 
+## v0.10.3
+
+#### cashc compiler
+- :sparkles: Add `--format ts` option to `cashc` CLI to generate TypeScript typings for the artifact.
+
+#### CashScript SDK
+- :sparkles: Add automatic TypeScript typings for `Contract` class when artifact is generated using the `cashc` CLI with the `--format ts` option.
+
 ## v0.10.2
 
 #### cashc compiler
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 29bdb91c..ff34a33c 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -26,7 +26,7 @@ new Contract(
 
 A CashScript contract can be instantiated by providing an `Artifact` object, a list of constructor arguments, and optionally an options object configuring `NetworkProvider` and `addressType`.
 
-An `Artifact` object is the result of compiling a CashScript contract. See the [Language Documentation](/docs/compiler/artifacts) for more information on Artifacts. Compilation can be done using the standalone [`cashc` CLI](/docs/compiler) or programmatically with the `cashc` NPM package (see [CashScript Compiler](/docs/compiler#javascript-compilation)).
+An `Artifact` object is the result of compiling a CashScript contract. Compilation can be done using the standalone [`cashc` CLI](/docs/compiler) or programmatically with the `cashc` NPM package (see [CashScript Compiler](/docs/compiler#javascript-compilation)). If compilation is done using the `cashc` CLI with the <span style={{ display: 'inline-block' }}>`--format ts`</span> option, you will get explicit types and type checking for the constructor arguments and function arguments.
 
 The `NetworkProvider` option is used to manage network operations for the CashScript contract. By default, a mainnet `ElectrumNetworkProvider` is used, but the network providers can be configured. See the docs on [NetworkProvider](/docs/sdk/network-provider).
 
@@ -54,6 +54,8 @@ const options = { provider, addressType}
 const contract = new Contract(P2PKH, contractArguments, options);
 ```
 
+### TypeScript Typings
+
 ## Contract Properties
 
 ### address
@@ -175,6 +177,10 @@ const tx = await contract.functions
   .send()
 ```
 
+:::tip
+If the contract artifact is generated using the `cashc` CLI with the `--format ts` option, you will get explicit types and type checking for the function name and arguments.
+:::
+
 ### Contract unlockers
 
 ```ts

From c8987bae61ddca002265144660d415fb72c4f444 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 3 Dec 2024 12:08:35 +0100
Subject: [PATCH 153/267] Bump version to 0.10.3

---
 examples/package.json               | 6 +++---
 examples/testing-suite/package.json | 6 +++---
 packages/cashc/package.json         | 4 ++--
 packages/cashc/src/index.ts         | 2 +-
 packages/cashscript/package.json    | 4 ++--
 packages/utils/package.json         | 2 +-
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index f3c9c7d6..e33fd1fb 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
     "@types/node": "^12.7.8",
-    "cashc": "^0.10.2",
-    "cashscript": "^0.10.2",
+    "cashc": "^0.10.3",
+    "cashscript": "^0.10.3",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index e1a41d13..332a4b61 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -25,8 +25,8 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "cashc": "^0.10.2",
-    "cashscript": "^0.10.2",
+    "cashc": "^0.10.3",
+    "cashscript": "^0.10.3",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index a12434df..48e8a368 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.2",
+    "@cashscript/utils": "^0.10.3",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index e62cf342..2539208b 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.2';
+export const version = '0.10.3';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 16e38966..70d760c0 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.2",
+    "@cashscript/utils": "^0.10.3",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "delay": "^5.0.0",
     "electrum-cash": "^2.0.10",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index ea0efcef..3aadd077 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From aa2d029db047d4880d976d2e77a992e10ac7dde2 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 3 Dec 2024 12:10:32 +0100
Subject: [PATCH 154/267] Small typescript fix in tests

---
 packages/cashscript/test/types/Contract.types.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/cashscript/test/types/Contract.types.test.ts b/packages/cashscript/test/types/Contract.types.test.ts
index ea1cc81c..5b39a396 100644
--- a/packages/cashscript/test/types/Contract.types.test.ts
+++ b/packages/cashscript/test/types/Contract.types.test.ts
@@ -1,7 +1,7 @@
 /* eslint-disable */
 import { Artifact, Contract, SignatureTemplate, Transaction, Unlocker } from 'cashscript';
 import p2pkhArtifact from '../fixture/p2pkh.artifact';
-import p2pkhArtifactJsonNotConst from '../fixture/p2pkh.json';
+import p2pkhArtifactJsonNotConst from '../fixture/p2pkh.json' with { type: 'json' };
 import announcementArtifact from '../fixture/announcement.artifact';
 import hodlVaultArtifact from '../fixture/hodl_vault.artifact';
 import transferWithTimeoutArtifact from '../fixture/transfer_with_timeout.artifact';

From 1aa7c6b26ee8add3ff8cf42227141d9bea8aba66 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 3 Dec 2024 12:16:56 +0100
Subject: [PATCH 155/267] Do not execute types tests with Jest

---
 packages/cashscript/jest.config.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/cashscript/jest.config.js b/packages/cashscript/jest.config.js
index bee4a70f..92221ec2 100644
--- a/packages/cashscript/jest.config.js
+++ b/packages/cashscript/jest.config.js
@@ -7,4 +7,5 @@ export default {
   ],
   testEnvironment: 'jest-environment-node',
   setupFilesAfterEnv: ['./jest.setup.js'],
+  modulePathIgnorePatterns: ['<rootDir>/.*/types/.*'],
 };

From f117a36a6c57c16f112e53c88a79911795d71b49 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 3 Dec 2024 14:09:53 +0100
Subject: [PATCH 156/267] Fix bug in new --format ts flag

---
 packages/utils/src/artifact.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index 14707807..ac2c4aeb 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -63,7 +63,9 @@ export function exportArtifact(artifact: Artifact, targetFile: string, format: '
 
 export function formatArtifact(artifact: Artifact, format: 'json' | 'ts'): string {
   if (format === 'ts') {
-    return `export default ${stringifyAsTs(artifact)} as const;\n`;
+    // We remove any undefined values to make the artifact serializable using stringifyAsTs
+    const normalisedArtifact = JSON.parse(JSON.stringify(artifact));
+    return `export default ${stringifyAsTs(normalisedArtifact)} as const;\n`;
   }
 
   return JSON.stringify(artifact, null, 2);

From d8993655ca9b0074d6d22c1680fcd01b23a62054 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 3 Dec 2024 14:13:35 +0100
Subject: [PATCH 157/267] Bump version to 0.10.4

---
 examples/bug.cash                      | 49 ++++++++++++++++++++++++++
 examples/package.json                  |  6 ++--
 examples/testing-suite/package.json    |  6 ++--
 packages/cashc/package.json            |  4 +--
 packages/cashc/src/index.ts            |  2 +-
 packages/cashscript/package.json       |  4 +--
 packages/utils/package.json            |  2 +-
 website/docs/releases/release-notes.md |  5 +++
 8 files changed, 66 insertions(+), 12 deletions(-)
 create mode 100644 examples/bug.cash

diff --git a/examples/bug.cash b/examples/bug.cash
new file mode 100644
index 00000000..3d5958e4
--- /dev/null
+++ b/examples/bug.cash
@@ -0,0 +1,49 @@
+pragma cashscript ^0.10.0;
+
+contract PriceContract(
+  bytes tokenIdOracleContract
+  ) {
+    // function updatePrice
+    // Trigger oracle sequence update to avoid letting borrowers spawn coins using old price data
+    //
+    // Inputs: 00-pricecontract, 01-oraclecontract, ?02-feeBCH
+    // Outputs: 00-pricecontract, ?01-changeBCH
+
+  function updatePrice() {
+    require(this.activeInputIndex == 0, "Parity contract must always be at input index 0");
+
+    require(tx.outputs[0].lockingBytecode == tx.inputs[0].lockingBytecode, "Recreate contract at output0 - invalid lockingBytecode");
+    require(tx.outputs[0].tokenCategory == tx.inputs[0].tokenCategory, "Recreate contract at output0 - invalid tokenCategory");
+    require(tx.outputs[0].value == 1000, "Recreate contract at output0 - needs to hold exactly 1000 sats");
+    require(tx.outputs[0].tokenAmount == tx.inputs[0].tokenAmount, "Invalid tokenAmount, needs to maintain atleast current tokenAmount");
+
+    bytes contractSeq = tx.inputs[0].nftCommitment.split(1)[1].split(6)[0];
+
+    require(tokenIdOracleContract == tx.inputs[1].tokenCategory);
+
+    // Parse oracle data (Oracle price is denominated in USD cents/BCH)
+    bytes oracleSeqBytes = tx.inputs[1].nftCommitment.split(6)[0];
+    int oracleSeq = int(oracleSeqBytes);
+
+    // Verify oracle sequence
+    require(oracleSeq > int(contractSeq), "Invalid oracle sequence, should be more recent than current contract sequence");
+
+    require(tx.outputs[0].nftCommitment == 0x00 + tx.inputs[1].nftCommitment, "Invalid nftCommitment, commitment should be the oracle sequence");
+  }
+
+    // function sharePrice
+    // Provides latest oracle price to various other contracts
+    //
+    // Inputs: 00-parity, ...
+    // Outputs: 00-parity, ...
+
+  function sharePrice() {
+    require(tx.outputs[this.activeInputIndex].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode, "Recreate contract at output0 - invalid lockingBytecode");
+    require(tx.outputs[this.activeInputIndex].tokenCategory == tx.inputs[this.activeInputIndex].tokenCategory, "Recreate contract at output0 - invalid tokenCategory");
+    require(tx.outputs[this.activeInputIndex].value == 1000, "Recreate contract at output0 - needs to hold exactly 1000 sats");
+    // Allow giving the contract more tokens
+    require(tx.outputs[this.activeInputIndex].tokenAmount >= tx.inputs[this.activeInputIndex].tokenAmount, "Invalid tokenAmount, needs to maintain atleast current tokenAmount");
+    // keep same contract state
+    require(tx.outputs[this.activeInputIndex].nftCommitment == tx.inputs[this.activeInputIndex].nftCommitment, "Invalid nftCommitment, commitment should be replicated");
+  }
+}
diff --git a/examples/package.json b/examples/package.json
index e33fd1fb..914e476c 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
     "@types/node": "^12.7.8",
-    "cashc": "^0.10.3",
-    "cashscript": "^0.10.3",
+    "cashc": "^0.10.4",
+    "cashscript": "^0.10.4",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 332a4b61..662204a4 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -25,8 +25,8 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "cashc": "^0.10.3",
-    "cashscript": "^0.10.3",
+    "cashc": "^0.10.4",
+    "cashscript": "^0.10.4",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 48e8a368..117c8829 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.3",
+    "@cashscript/utils": "^0.10.4",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 2539208b..afb70ba0 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.3';
+export const version = '0.10.4';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 70d760c0..58eecbe7 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.3",
+    "@cashscript/utils": "^0.10.4",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "delay": "^5.0.0",
     "electrum-cash": "^2.0.10",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 3aadd077..81a90662 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 5a9fb560..40760e93 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,6 +2,11 @@
 title: Release Notes
 ---
 
+## v0.10.4
+
+#### cashc compiler
+- :bug: Fix bug in new `--format ts` option.
+
 ## v0.10.3
 
 #### cashc compiler

From 38193ac4df3030313b298ef9a91818ac3ad0286d Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 3 Dec 2024 14:58:04 +0100
Subject: [PATCH 158/267] Fix typings and update .artifact.ts fixtures

---
 .../test/fixture/announcement.artifact.ts     | 29 ++++++-
 .../cashscript/test/fixture/announcement.json |  4 +-
 .../test/fixture/bigint.artifact.ts           | 41 ++++++++++
 packages/cashscript/test/fixture/bigint.json  |  4 +-
 .../test/fixture/bounded_bytes.artifact.ts    | 37 +++++++++
 .../test/fixture/bounded_bytes.json           |  4 +-
 .../test/fixture/hodl_vault.artifact.ts       | 31 +++++++-
 .../cashscript/test/fixture/hodl_vault.json   |  4 +-
 .../test/fixture/mecenas.artifact.ts          | 78 +++++++++++++++++++
 packages/cashscript/test/fixture/mecenas.json |  4 +-
 .../test/fixture/p2palindrome.artifact.ts     | 33 ++++++++
 .../cashscript/test/fixture/p2palindrome.json |  4 +-
 .../cashscript/test/fixture/p2pkh.artifact.ts | 19 ++++-
 packages/cashscript/test/fixture/p2pkh.json   |  4 +-
 .../test/fixture/simple_covenant.artifact.ts  | 48 ++++++++++++
 .../test/fixture/simple_covenant.json         |  4 +-
 .../token_category_comparison.artifact.ts     | 28 +++++++
 .../fixture/token_category_comparison.json    |  4 +-
 .../fixture/transfer_with_timeout.artifact.ts | 25 +++++-
 .../test/fixture/transfer_with_timeout.json   |  4 +-
 .../test/fixture/update_fixtures.sh           |  6 +-
 packages/utils/src/artifact.ts                |  6 +-
 22 files changed, 386 insertions(+), 35 deletions(-)
 create mode 100644 packages/cashscript/test/fixture/bigint.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/bounded_bytes.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/mecenas.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/p2palindrome.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/simple_covenant.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/token_category_comparison.artifact.ts

diff --git a/packages/cashscript/test/fixture/announcement.artifact.ts b/packages/cashscript/test/fixture/announcement.artifact.ts
index 1e148582..2c9548ce 100644
--- a/packages/cashscript/test/fixture/announcement.artifact.ts
+++ b/packages/cashscript/test/fixture/announcement.artifact.ts
@@ -8,10 +8,33 @@ export default {
     },
   ],
   bytecode: '6a 6d02 OP_SIZE OP_SWAP OP_CAT OP_CAT 4120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e OP_SIZE OP_DUP 4b OP_GREATERTHAN OP_IF 4c OP_SWAP OP_CAT OP_ENDIF OP_SWAP OP_CAT OP_CAT OP_0 OP_OUTPUTVALUE OP_0 OP_NUMEQUALVERIFY OP_0 OP_OUTPUTBYTECODE OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_OVER OP_SUB OP_DUP OP_ROT OP_GREATERTHANOREQUAL OP_IF OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_DROP OP_1',
-  source: 'pragma cashscript ^0.9.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an "announcement" on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes(\'A contract may not injure a human being or, through inaction, allow a human being to come to harm.\')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there\'s enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n',
+  source: 'pragma cashscript >=0.8.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an \'announcement\' on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes(\'A contract may not injure a human being or, through inaction, allow a human being to come to harm.\')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there\'s enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n',
+  debug: {
+    bytecode: '016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009c6900cd517a876902e803c0c65179940079527aa26351cdc0c7876951cc51799c69685177',
+    sourceMap: '10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:16:::1;:8::42;17:27:17:28:0;:16::45:1;:49::61:0;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;;:20:::1;:12::57;23:38:26:9;8:4:27:5;',
+    logs: [],
+    requires: [
+      {
+        ip: 23,
+        line: 16,
+      },
+      {
+        ip: 29,
+        line: 17,
+      },
+      {
+        ip: 47,
+        line: 24,
+      },
+      {
+        ip: 53,
+        line: 25,
+      },
+    ],
+  },
   compiler: {
     name: 'cashc',
-    version: '0.8.0-next.0',
+    version: '0.10.4',
   },
-  updatedAt: '2023-02-10T15:22:49.703Z',
+  updatedAt: '2024-12-03T13:57:07.764Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/announcement.json b/packages/cashscript/test/fixture/announcement.json
index 0b1d40dc..55d6005d 100644
--- a/packages/cashscript/test/fixture/announcement.json
+++ b/packages/cashscript/test/fixture/announcement.json
@@ -34,7 +34,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:01.248Z"
+  "updatedAt": "2024-12-03T13:57:07.512Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.artifact.ts b/packages/cashscript/test/fixture/bigint.artifact.ts
new file mode 100644
index 00000000..f60e5d43
--- /dev/null
+++ b/packages/cashscript/test/fixture/bigint.artifact.ts
@@ -0,0 +1,41 @@
+export default {
+  contractName: 'BigInt',
+  constructorInputs: [],
+  abi: [
+    {
+      name: 'proofOfBigInt',
+      inputs: [
+        {
+          name: 'x',
+          type: 'int',
+        },
+        {
+          name: 'y',
+          type: 'int',
+        },
+      ],
+    },
+  ],
+  bytecode: '0000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL',
+  source: 'contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt32PlusOne = 2147483648;\n        require(x >= maxInt32PlusOne);\n        require(x * y >= maxInt32PlusOne);\n    }\n}\n',
+  debug: {
+    bytecode: '05000000800051795179a269517a527a95517aa2',
+    sourceMap: '3:30:3:40;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1',
+    logs: [],
+    requires: [
+      {
+        ip: 6,
+        line: 4,
+      },
+      {
+        ip: 15,
+        line: 5,
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.10.4',
+  },
+  updatedAt: '2024-12-03T13:57:07.265Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index ae33572a..7bb4ec7b 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -35,7 +35,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:00.989Z"
+  "updatedAt": "2024-12-03T13:57:06.999Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bounded_bytes.artifact.ts b/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
new file mode 100644
index 00000000..7a9015c7
--- /dev/null
+++ b/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
@@ -0,0 +1,37 @@
+export default {
+  contractName: 'BoundedBytes',
+  constructorInputs: [],
+  abi: [
+    {
+      name: 'spend',
+      inputs: [
+        {
+          name: 'b',
+          type: 'bytes4',
+        },
+        {
+          name: 'i',
+          type: 'int',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_SWAP OP_4 OP_NUM2BIN OP_EQUAL',
+  source: 'contract BoundedBytes() {\n    function spend(bytes4 b, int i) {\n        require(b == bytes4(i));\n    }\n}\n',
+  debug: {
+    bytecode: '007a517a548087',
+    sourceMap: '3:16:3:17;;:28::29;;:21::30:1;;:16',
+    logs: [],
+    requires: [
+      {
+        ip: 7,
+        line: 3,
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.10.4',
+  },
+  updatedAt: '2024-12-03T13:57:09.177Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index dadf6205..fa55c742 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -31,7 +31,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:01.995Z"
+  "updatedAt": "2024-12-03T13:57:08.944Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/hodl_vault.artifact.ts b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
index 91d90149..39a46307 100644
--- a/packages/cashscript/test/fixture/hodl_vault.artifact.ts
+++ b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
@@ -39,9 +39,36 @@ export default {
   ],
   bytecode: 'OP_6 OP_PICK OP_4 OP_SPLIT OP_SWAP OP_BIN2NUM OP_SWAP OP_BIN2NUM OP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY OP_CHECKSIG',
   source: '// This contract forces HODLing until a certain price target has been reached\n// A minimum block is provided to ensure that oracle price entries from before this block are disregarded\n// i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used.\n// Instead, a message with a block number and price from after the minBlock needs to be passed.\n// This contract serves as a simple example for checkDataSig-based contracts.\ncontract HodlVault(\n    pubkey ownerPk,\n    pubkey oraclePk,\n    int minBlock,\n    int priceTarget\n) {\n    function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {\n        // message: { blockHeight, price }\n        bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);\n        int blockHeight = int(blockHeightBin);\n        int price = int(priceBin);\n\n        // Check that blockHeight is after minBlock and not in the future\n        require(blockHeight >= minBlock);\n        require(tx.time >= blockHeight);\n\n        // Check that current price is at least priceTarget\n        require(price >= priceTarget);\n\n        // Handle necessary signature checks\n        require(checkDataSig(oracleSig, oracleMessage, oraclePk));\n        require(checkSig(ownerSig, ownerPk));\n    }\n}\n',
+  debug: {
+    bytecode: '5679547f517a81517a815179557aa269517ab175007a537aa269537a547a537aba69517a517aac',
+    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;;:26::45:1;16:24:16:32:0;;:20::33:1;19:16:19:27:0;;:31::39;;:16:::1;:8::41;20:27:20:38:0;;:8::40:1;;23:16:23:21:0;;:25::36;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:16::64:1;:8::66;27:25:27:33:0;;:35::42;;:16::43:1',
+    logs: [],
+    requires: [
+      {
+        ip: 19,
+        line: 19,
+      },
+      {
+        ip: 22,
+        line: 20,
+      },
+      {
+        ip: 29,
+        line: 23,
+      },
+      {
+        ip: 37,
+        line: 26,
+      },
+      {
+        ip: 43,
+        line: 27,
+      },
+    ],
+  },
   compiler: {
     name: 'cashc',
-    version: '0.8.0-next.0',
+    version: '0.10.4',
   },
-  updatedAt: '2023-02-10T15:22:49.985Z',
+  updatedAt: '2024-12-03T13:57:08.243Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index d5a511cd..36ba6880 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -68,7 +68,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:01.493Z"
+  "updatedAt": "2024-12-03T13:57:07.996Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/mecenas.artifact.ts b/packages/cashscript/test/fixture/mecenas.artifact.ts
new file mode 100644
index 00000000..3f27d191
--- /dev/null
+++ b/packages/cashscript/test/fixture/mecenas.artifact.ts
@@ -0,0 +1,78 @@
+export default {
+  contractName: 'Mecenas',
+  constructorInputs: [
+    {
+      name: 'recipient',
+      type: 'bytes20',
+    },
+    {
+      name: 'funder',
+      type: 'bytes20',
+    },
+    {
+      name: 'pledge',
+      type: 'int',
+    },
+  ],
+  abi: [
+    {
+      name: 'receive',
+      inputs: [],
+    },
+    {
+      name: 'reclaim',
+      inputs: [
+        {
+          name: 'pk',
+          type: 'pubkey',
+        },
+        {
+          name: 's',
+          type: 'sig',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
+  source: 'pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho\'s Mecenas contract. It is\n * not compatible with Licho\'s EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(tx.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n',
+  debug: {
+    bytecode: '5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768',
+    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
+    logs: [],
+    requires: [
+      {
+        ip: 17,
+        line: 13,
+      },
+      {
+        ip: 46,
+        line: 22,
+      },
+      {
+        ip: 53,
+        line: 24,
+      },
+      {
+        ip: 59,
+        line: 25,
+      },
+      {
+        ip: 65,
+        line: 26,
+      },
+      {
+        ip: 86,
+        line: 31,
+      },
+      {
+        ip: 92,
+        line: 32,
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.10.4',
+  },
+  updatedAt: '2024-12-03T13:57:11.555Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index 484b62c0..f809fbf2 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -72,7 +72,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:03.279Z"
+  "updatedAt": "2024-12-03T13:57:11.304Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2palindrome.artifact.ts b/packages/cashscript/test/fixture/p2palindrome.artifact.ts
new file mode 100644
index 00000000..e80b5ea5
--- /dev/null
+++ b/packages/cashscript/test/fixture/p2palindrome.artifact.ts
@@ -0,0 +1,33 @@
+export default {
+  contractName: 'P2Palindrome',
+  constructorInputs: [],
+  abi: [
+    {
+      name: 'spend',
+      inputs: [
+        {
+          name: 'palindrome',
+          type: 'string',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_DUP OP_REVERSEBYTES OP_EQUAL',
+  source: 'contract P2Palindrome() {\n    function spend(string palindrome) {\n        require(palindrome.reverse() == palindrome);\n    }\n}\n',
+  debug: {
+    bytecode: '0079bc517a87',
+    sourceMap: '3:16:3:26;;:::36:1;:40::50:0;;:16:::1',
+    logs: [],
+    requires: [
+      {
+        ip: 6,
+        line: 3,
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.10.4',
+  },
+  updatedAt: '2024-12-03T13:57:08.710Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index 9fbf038d..0c389308 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -27,7 +27,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:01.764Z"
+  "updatedAt": "2024-12-03T13:57:08.472Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2pkh.artifact.ts b/packages/cashscript/test/fixture/p2pkh.artifact.ts
index d679d513..b45bc7c2 100644
--- a/packages/cashscript/test/fixture/p2pkh.artifact.ts
+++ b/packages/cashscript/test/fixture/p2pkh.artifact.ts
@@ -23,9 +23,24 @@ export default {
   ],
   bytecode: 'OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG',
   source: 'contract P2PKH(bytes20 pkh) {\n    // Require pk to match stored pkh and signature to match\n    function spend(pubkey pk, sig s) {\n        require(hash160(pk) == pkh);\n        require(checkSig(s, pk));\n    }\n}\n',
+  debug: {
+    bytecode: '5179a9517a8769517a517aac',
+    sourceMap: '4:24:4:26;;:16::27:1;:31::34:0;;:16:::1;:8::36;5:25:5:26:0;;:28::30;;:16::31:1',
+    logs: [],
+    requires: [
+      {
+        ip: 7,
+        line: 4,
+      },
+      {
+        ip: 13,
+        line: 5,
+      },
+    ],
+  },
   compiler: {
     name: 'cashc',
-    version: '0.8.0-next.0',
+    version: '0.10.4',
   },
-  updatedAt: '2023-02-10T15:22:51.429Z',
+  updatedAt: '2024-12-03T13:57:11.056Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index b17bf5fc..c39a82cb 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -40,7 +40,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:03.012Z"
+  "updatedAt": "2024-12-03T13:57:10.827Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/simple_covenant.artifact.ts b/packages/cashscript/test/fixture/simple_covenant.artifact.ts
new file mode 100644
index 00000000..e2f83179
--- /dev/null
+++ b/packages/cashscript/test/fixture/simple_covenant.artifact.ts
@@ -0,0 +1,48 @@
+export default {
+  contractName: 'Covenant',
+  constructorInputs: [],
+  abi: [
+    {
+      name: 'spend',
+      inputs: [],
+    },
+  ],
+  bytecode: 'OP_TXVERSION OP_2 OP_GREATERTHANOREQUAL OP_VERIFY OP_TXINPUTCOUNT OP_1 OP_GREATERTHANOREQUAL OP_VERIFY OP_TXOUTPUTCOUNT OP_1 OP_GREATERTHANOREQUAL OP_VERIFY OP_ACTIVEBYTECODE OP_SIZE OP_NIP 0802 OP_LESSTHAN OP_VERIFY OP_0 OP_UTXOVALUE 2202 OP_GREATERTHANOREQUAL OP_VERIFY OP_0 OP_OUTPUTVALUE 2202 OP_GREATERTHANOREQUAL',
+  source: 'contract Covenant() {\n    function spend() {\n        require(tx.version >= 2);\n        require(tx.inputs.length >= 1);\n        require(tx.outputs.length >= 1);\n        require(this.activeBytecode.length < 520);\n        require(tx.inputs[0].value >= 546);\n        require(tx.outputs[0].value >= 546);\n    }\n}\n',
+  debug: {
+    bytecode: 'c252a269c351a269c451a269c182770208029f6900c6022202a26900cc022202a2',
+    sourceMap: '3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:32:0;:36::37;:16:::1;:8::39;5:16:5:33:0;:37::38;:16:::1;:8::40;6:16:6:35:0;:::42:1;;:45::48:0;:16:::1;:8::50;7:26:7:27:0;:16::34:1;:38::41:0;:16:::1;:8::43;8:27:8:28:0;:16::35:1;:39::42:0;:16:::1',
+    logs: [],
+    requires: [
+      {
+        ip: 3,
+        line: 3,
+      },
+      {
+        ip: 7,
+        line: 4,
+      },
+      {
+        ip: 11,
+        line: 5,
+      },
+      {
+        ip: 17,
+        line: 6,
+      },
+      {
+        ip: 22,
+        line: 7,
+      },
+      {
+        ip: 27,
+        line: 8,
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.10.4',
+  },
+  updatedAt: '2024-12-03T13:57:09.639Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/simple_covenant.json b/packages/cashscript/test/fixture/simple_covenant.json
index 614c0fbd..65241c57 100644
--- a/packages/cashscript/test/fixture/simple_covenant.json
+++ b/packages/cashscript/test/fixture/simple_covenant.json
@@ -42,7 +42,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:02.299Z"
+  "updatedAt": "2024-12-03T13:57:09.409Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/token_category_comparison.artifact.ts b/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
new file mode 100644
index 00000000..043b507f
--- /dev/null
+++ b/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
@@ -0,0 +1,28 @@
+export default {
+  contractName: 'Test',
+  constructorInputs: [],
+  abi: [
+    {
+      name: 'send',
+      inputs: [],
+    },
+  ],
+  bytecode: 'OP_1 OP_UTXOTOKENCATEGORY OP_0 OP_EQUAL',
+  source: 'contract Test() {\n    function send() {\n        require(tx.inputs[1].tokenCategory == 0x);\n    }\n}\n',
+  debug: {
+    bytecode: '51ce0087',
+    sourceMap: '3:26:3:27;:16::42:1;:46::48:0;:16:::1',
+    logs: [],
+    requires: [
+      {
+        ip: 4,
+        line: 3,
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.10.4',
+  },
+  updatedAt: '2024-12-03T13:57:10.582Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/token_category_comparison.json b/packages/cashscript/test/fixture/token_category_comparison.json
index 657da061..0d1ed087 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.json
+++ b/packages/cashscript/test/fixture/token_category_comparison.json
@@ -22,7 +22,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:02.765Z"
+  "updatedAt": "2024-12-03T13:57:10.355Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
index 8a16ce38..4c738201 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
@@ -35,10 +35,29 @@ export default {
     },
   ],
   bytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_ROLL OP_ROT OP_CHECKSIG OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_2DROP OP_1 OP_ENDIF',
-  source: "contract TransferWithTimeout(\n    pubkey sender,\n    pubkey recipient,\n    int timeout\n) {\n    // Require recipient's signature to match\n    function transfer(sig recipientSig) {\n        require(checkSig(recipientSig, recipient));\n    }\n\n    // Require timeout time to be reached and sender's signature to match\n    function timeout(sig senderSig) {\n        require(checkSig(senderSig, sender));\n        require(tx.time >= timeout);\n    }\n}\n",
+  source: 'contract TransferWithTimeout(\n    pubkey sender,\n    pubkey recipient,\n    int timeout\n) {\n    // Require recipient\'s signature to match\n    function transfer(sig recipientSig) {\n        require(checkSig(recipientSig, recipient));\n    }\n\n    // Require timeout time to be reached and sender\'s signature to match\n    function timeout(sig senderSig) {\n        require(checkSig(senderSig, sender));\n        require(tx.time >= timeout);\n    }\n}\n',
+  debug: {
+    bytecode: '5379009c63547a527aac77777767537a519c69537a517aac69517ab175517768',
+    sourceMap: '7:4:9:5;;;;;8:25:8:37;;:39::48;;:16::49:1;7:4:9:5;;;;12::15::0;;;;;13:25:13:34;;:36::42;;:16::43:1;:8::45;14:27:14:34:0;;:8::36:1;;12:4:15:5;;1:0:16:1',
+    logs: [],
+    requires: [
+      {
+        ip: 13,
+        line: 8,
+      },
+      {
+        ip: 27,
+        line: 13,
+      },
+      {
+        ip: 30,
+        line: 14,
+      },
+    ],
+  },
   compiler: {
     name: 'cashc',
-    version: '0.8.0-next.0',
+    version: '0.10.4',
   },
-  updatedAt: '2023-02-10T15:22:51.144Z',
+  updatedAt: '2024-12-03T13:57:10.112Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index 1e94abcc..82ff4488 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -57,7 +57,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.0"
+    "version": "0.10.4"
   },
-  "updatedAt": "2024-09-10T09:54:02.536Z"
+  "updatedAt": "2024-12-03T13:57:09.878Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/update_fixtures.sh b/packages/cashscript/test/fixture/update_fixtures.sh
index b0bf63e1..8d191646 100755
--- a/packages/cashscript/test/fixture/update_fixtures.sh
+++ b/packages/cashscript/test/fixture/update_fixtures.sh
@@ -6,6 +6,8 @@ cd $DIR
 CASHC="../../../cashc/dist/cashc-cli.js"
 
 find . -maxdepth 1 -name "*.cash" | while read fn; do
-    echo node "$CASHC" -o "$(basename "$fn" .cash).json" "$fn"
-    node "$CASHC" -o "$(basename "$fn" .cash).json" "$fn"
+    echo node "$CASHC" "$fn" -o "$(basename "$fn" .cash).json"
+    node "$CASHC" "$fn" -o "$(basename "$fn" .cash).json"
+    echo node "$CASHC" "$fn" -o "$(basename "$fn" .cash).artifact.ts" -f ts
+    node "$CASHC" "$fn" -o "$(basename "$fn" .cash).artifact.ts" -f ts
 done
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index ac2c4aeb..5ab0f86f 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -14,14 +14,14 @@ export interface AbiFunction {
 export interface DebugInformation {
   bytecode: string; // unlike `bytecode` property above, this is a hex-encoded binary string
   sourceMap: string; // see documentation for `generateSourceMap`
-  logs: LogEntry[]; // log entries generated from `console.log` statements
-  requires: RequireStatement[]; // messages for failing `require` statements
+  logs: readonly LogEntry[]; // log entries generated from `console.log` statements
+  requires: readonly RequireStatement[]; // messages for failing `require` statements
 }
 
 export interface LogEntry {
   ip: number; // instruction pointer
   line: number; // line in the source code
-  data: Array<LogData>; // data to be logged
+  data: readonly LogData[]; // data to be logged
 }
 
 export interface StackItem {

From 08b93f1457b8b2c54169cfd9ba72004124a65b8e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 3 Dec 2024 14:59:43 +0100
Subject: [PATCH 159/267] Bump version to 0.10.5

---
 examples/bug.cash                      | 49 --------------------------
 examples/package.json                  |  6 ++--
 examples/testing-suite/package.json    |  6 ++--
 packages/cashc/package.json            |  4 +--
 packages/cashc/src/index.ts            |  2 +-
 packages/cashscript/package.json       |  4 +--
 packages/utils/package.json            |  2 +-
 website/docs/releases/release-notes.md |  5 +++
 8 files changed, 17 insertions(+), 61 deletions(-)
 delete mode 100644 examples/bug.cash

diff --git a/examples/bug.cash b/examples/bug.cash
deleted file mode 100644
index 3d5958e4..00000000
--- a/examples/bug.cash
+++ /dev/null
@@ -1,49 +0,0 @@
-pragma cashscript ^0.10.0;
-
-contract PriceContract(
-  bytes tokenIdOracleContract
-  ) {
-    // function updatePrice
-    // Trigger oracle sequence update to avoid letting borrowers spawn coins using old price data
-    //
-    // Inputs: 00-pricecontract, 01-oraclecontract, ?02-feeBCH
-    // Outputs: 00-pricecontract, ?01-changeBCH
-
-  function updatePrice() {
-    require(this.activeInputIndex == 0, "Parity contract must always be at input index 0");
-
-    require(tx.outputs[0].lockingBytecode == tx.inputs[0].lockingBytecode, "Recreate contract at output0 - invalid lockingBytecode");
-    require(tx.outputs[0].tokenCategory == tx.inputs[0].tokenCategory, "Recreate contract at output0 - invalid tokenCategory");
-    require(tx.outputs[0].value == 1000, "Recreate contract at output0 - needs to hold exactly 1000 sats");
-    require(tx.outputs[0].tokenAmount == tx.inputs[0].tokenAmount, "Invalid tokenAmount, needs to maintain atleast current tokenAmount");
-
-    bytes contractSeq = tx.inputs[0].nftCommitment.split(1)[1].split(6)[0];
-
-    require(tokenIdOracleContract == tx.inputs[1].tokenCategory);
-
-    // Parse oracle data (Oracle price is denominated in USD cents/BCH)
-    bytes oracleSeqBytes = tx.inputs[1].nftCommitment.split(6)[0];
-    int oracleSeq = int(oracleSeqBytes);
-
-    // Verify oracle sequence
-    require(oracleSeq > int(contractSeq), "Invalid oracle sequence, should be more recent than current contract sequence");
-
-    require(tx.outputs[0].nftCommitment == 0x00 + tx.inputs[1].nftCommitment, "Invalid nftCommitment, commitment should be the oracle sequence");
-  }
-
-    // function sharePrice
-    // Provides latest oracle price to various other contracts
-    //
-    // Inputs: 00-parity, ...
-    // Outputs: 00-parity, ...
-
-  function sharePrice() {
-    require(tx.outputs[this.activeInputIndex].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode, "Recreate contract at output0 - invalid lockingBytecode");
-    require(tx.outputs[this.activeInputIndex].tokenCategory == tx.inputs[this.activeInputIndex].tokenCategory, "Recreate contract at output0 - invalid tokenCategory");
-    require(tx.outputs[this.activeInputIndex].value == 1000, "Recreate contract at output0 - needs to hold exactly 1000 sats");
-    // Allow giving the contract more tokens
-    require(tx.outputs[this.activeInputIndex].tokenAmount >= tx.inputs[this.activeInputIndex].tokenAmount, "Invalid tokenAmount, needs to maintain atleast current tokenAmount");
-    // keep same contract state
-    require(tx.outputs[this.activeInputIndex].nftCommitment == tx.inputs[this.activeInputIndex].nftCommitment, "Invalid nftCommitment, commitment should be replicated");
-  }
-}
diff --git a/examples/package.json b/examples/package.json
index 914e476c..3f99f7fd 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.4",
+  "version": "0.10.5",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
     "@types/node": "^12.7.8",
-    "cashc": "^0.10.4",
-    "cashscript": "^0.10.4",
+    "cashc": "^0.10.5",
+    "cashscript": "^0.10.5",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 662204a4..9097f8c7 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.4",
+  "version": "0.10.5",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -25,8 +25,8 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "cashc": "^0.10.4",
-    "cashscript": "^0.10.4",
+    "cashc": "^0.10.5",
+    "cashscript": "^0.10.5",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 117c8829..c32a5438 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.4",
+  "version": "0.10.5",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.4",
+    "@cashscript/utils": "^0.10.5",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index afb70ba0..08d9dc48 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.4';
+export const version = '0.10.5';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 58eecbe7..e2a653e7 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.4",
+  "version": "0.10.5",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.0.0",
-    "@cashscript/utils": "^0.10.4",
+    "@cashscript/utils": "^0.10.5",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "delay": "^5.0.0",
     "electrum-cash": "^2.0.10",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 81a90662..b60df22c 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.4",
+  "version": "0.10.5",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 40760e93..4146a3f8 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,6 +2,11 @@
 title: Release Notes
 ---
 
+## v0.10.5
+
+#### cashc compiler
+- :bug: Fix bug in new TypeScript typings for artifact.
+
 ## v0.10.4
 
 #### cashc compiler

From e41dcac042c2591715300a554bfc8ea5ddefd0ee Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Tue, 10 Dec 2024 10:06:35 +0100
Subject: [PATCH 160/267] add moria to website showcase (#244)

---
 website/docs/showcase.md     |  12 ++++++++++--
 website/static/img/moria.png | Bin 0 -> 48024 bytes
 2 files changed, 10 insertions(+), 2 deletions(-)
 create mode 100644 website/static/img/moria.png

diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index 4ea23280..a9b96c32 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -18,7 +18,15 @@ AnyHedge is the first DeFi project built on top of Bitcoin Cash in the form of a
     <a href="https://tapswap.cash/" target="_blank"><img src="/img/tapswap.png" /></a>
 </div>
 
-Tapswap is the first non-custodial marketplace to trade CashTokens, both fungible token & NFTs, on Bitcoin Cash. Tapswap uses CashScript for its non-custodial token-sale offer contracts. It uses web3 wallet connect feature to allow users to list tokens for sale right from their own wallet.
+Tapswap is the first non-custodial marketplace to trade CashTokens, both fungible token & NFTs, on Bitcoin Cash. Tapswap uses CashScript for its non-custodial token-sale offer contracts. It uses BCH WalletConnect to allow users to list tokens for sale right from their own wallet.
+
+## Moria
+
+<div style={{textAlign: 'center', width: '40%', margin: 'auto', marginBottom: '20px'}}>
+    <a href="https://moria.money/" target="_blank"><img src="/img/moria.png" /></a>
+</div>
+
+Moria is a decentralized stablecoin and borrowing protocol on Bitcoin Cash using CashTokens. The Moria protocol works with collateralized-debt-positions (CDPs) where stablecoins are issued by creating over-collateralized loans. The Moria protocol uses multiple smart contracts, all written in CashScript.
 
 ## Bitcats Heroes
 
@@ -26,7 +34,7 @@ Tapswap is the first non-custodial marketplace to trade CashTokens, both fungibl
     <a href="https://bitcatsheroes.club/" target="_blank"><img src="/img/bitcats.png" /></a>
 </div>
 
-Bitcats Heroes is the first collectible NFT series on Bitcoin Cash. The project uses CashScript for its non-custodial minting contract. This way the NFT minting guarantees fair access and a transparent NFT launch. The minting page uses a web3 wallet connect feature to allow minting directly from the user's smart contract wallet.
+Bitcats Heroes is the first collectible NFT series on Bitcoin Cash. The project uses CashScript for its non-custodial minting contract. This way the NFT minting guarantees fair access and a transparent NFT launch. The minting page uses BCH WalletConnect to allow minting directly from the user's smart contract wallet.
 
 ## Cash-Ninjas
 
diff --git a/website/static/img/moria.png b/website/static/img/moria.png
new file mode 100644
index 0000000000000000000000000000000000000000..8b0bc4a949b846ae09954801e80d224140bad4e3
GIT binary patch
literal 48024
zcmd41V{~QFwgz}kY^!41ww;PqamBWMqKaLylZsWb&8muR+cr9N-+TAHdtZ0|=<XkV
z#@OTRHP>9<o?3G(%y1<IDMUD2H~;{EC?hSd0ssJS{ys2JACy0H>k%J+uny8%&Hw;X
z|KA6gM2Cb206;uhs(o?!BLA7!*xr`W(8S)zl+nZ1;e#6h;P>GDc(pZkF(me|wXt*N
z^$?)?2M6!R`(H8>l^`7PfByKLOw4#y#3lce^`j*~W#QuDz{|ws?(WX$&c<l(WX{CG
z!^6YG%*w>d%J9L#;OuGVV(7tO=S=p2^si9jrq0GrmJTkK_IAX7p$(1fU0npIsQ$_I
zA0n9;|MN2ru1+@p_=t%ylc|lVt*M=hGZPCV%fCozV$ADe>0)F0Z-R^1xcnQ%#`3Qw
zyf%h*<^oh63?`;#hORa)RDv${)~0sEmc}1qxtQ8I*ciH)5)(5Jv+*<imD0xYf57~M
z@~_BD|0m!72iyNp_y3_KL|j~)ERFtY4LfH>!+%g*|C*5T!@Ep|CV%b0{4e(Sk5RlL
zCeHsu@V}a<nmYa)<-;O>I~)w1oK4j{9ZUtNR7{=iU7d_g|7RHdC!m;<>4#-Z1X-C`
z*%?@v8JOAmnf|TopPuCZ&khL>7a0>l9y3#8LpEb$1~wLE4hHs*fMMX_GUj36WM<(u
zGUVo9V>My^C)R%q`CmwqMjt>NtQ@SI96T)SEL=Ps-2Xl1AD#beh?>2tvBh7t1X=%y
z{@=9!X8*r%^S_$wzf}EKv;KeNXovqXwf=hfA9MDve?K}t{LA(){{5iwinzL1*gFYI
z8``+pI}wW-T3eg)|7HHKj(=0`|9vQaWQ~7`!+%QXVd(I`BJhKm_aD(>@1$mLZzCvX
zXy;}~Os!&SXJYDP>O{lO^zR)1ck=#MI{G)BkHqvpqM7NRiA_*hRqYl4XcU(b7g6)b
zJjrs;)YbHS%h?yWS6Hsnw^?+mUigZKfMbl0fRqL5368OiDCOi}j}|>2$oqyRD(WTr
zNI?<|fzU5(0bFi2{8dZ-r}n6k=05xS?XCHKY@}+3RA;KnZT);`J1r~g(`uIYndjJZ
zb`#1sL!57h_*V`^$lc5ceaunNF|e(FNh83|6Nr7x2*yZX1MNQAIL-icmydQ|DtKxx
z-bZ^7zZ+up?~pwJ<-uPR7HDP>uD=jGp#R@NY%57(4p(n)+ks_Y&p*GRR>EDpHGTF@
zn1S}O`A}aiKTQzO$6OR2d4ov=9x7Q^{D#_XF9bV)1XvKW;S;(B(NAJFLtG8^1*Dt3
z4{~LLz0L;ly_bY{8IFLBh;l`NN7Eiz*IA$Ptq15kBf`P%;Rzz#C<2b>!3`eaZuW)V
z`QKmXrdO(JNVq2BoC*fM=wU#!Ud4SOp}2J9Nl?m{rT_W^fr7S-FbSxx!5++-E1v5C
z5#~Vxt|kM3Lj;--_a}~lOG8#we$_d|g-D;N@7d59txt$ZoPpK((FlHS5ss%QTSMO0
zAn9!y{nq^Ex|tuD4dUvoslKL~pWi{2hQuIqz4%q0XW%Qc{}^<8iZ|HaQ$^dikW;cX
zs~I512XY4&&f=Aya2(~BVDddppRzSBv9n_Ql4@lu{Rz=C8M`bJ`vGKFf<#6h8E7O;
zaRg5~3(ydm36zyrH>M`dbB2>t>z8E!9%0A^6o}@PK{(Td?hSSYVo<=8QLCv32v5-U
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%0AO>KL#`+(OCRg!$!#s7njd~Qd)t28re<VXl1)`
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
T3rT&Q%nFc`R{T^h`8D8w8ADjN

literal 0
HcmV?d00001


From 5c82a5f60fd99a8747c101c61382542b0b970028 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Tue, 17 Dec 2024 10:29:00 +0100
Subject: [PATCH 161/267] Improve docs (#245)

---
 website/docs/guides/infrastructure.md      | 51 ++++++++++++++++++++++
 website/docs/guides/syntax-highlighting.md |  7 +--
 website/docs/language/globals.md           |  2 +-
 website/sidebars.js                        |  1 +
 4 files changed, 57 insertions(+), 4 deletions(-)
 create mode 100644 website/docs/guides/infrastructure.md

diff --git a/website/docs/guides/infrastructure.md b/website/docs/guides/infrastructure.md
new file mode 100644
index 00000000..849a7190
--- /dev/null
+++ b/website/docs/guides/infrastructure.md
@@ -0,0 +1,51 @@
+---
+title: Contract Infrastructure
+---
+
+When creating a smart contract application on Bitcoin Cash you'll need to investigate whether you need surrounding contract infrastructure.
+Below we'll discuss the 2 main types of contract infrastructure you might run into: the need to store contract details and the need for a transaction server. 
+
+## Storing Contract Details
+
+Because of the `pay-to-scripthash` (`P2SH`) standard for smart contracts on BCH, the details of the script are hidden after creating a contract UTXO. This means you need to store the full contract script to ensure you can spend from your smart contract later.
+
+:::caution
+It is the responsibility of smart contract services/apps to keep track of the contract details making up the `P2SH` contract, as user-wallets are currently not smart enough to do this automatically.
+:::
+
+When users are allowed to provide their own `constructor` arguments when creating a BCH smart contract, each contract creation will have a unique smart contract address. Only the constructor arguments in the contract bytecode are variable, the rest of the bytecode for a contract is static. This static part is derived from the CashScript source file, so storing the contract source file or artifact both has the same effect. 
+
+:::note
+To construct the full contract script you need both the `constructor` arguments and static contract bytecode (either the contract source file or the `Artifact`) to be available.
+:::
+
+
+### Off-chain storage
+
+To store the contract details off-chain, you will need to run a database server which stores the specific constructor arguments for each contract, this will translate into their respective smart contract addresses. Additionally, you should ensure that the CashScript source file or the contract artifact (which contains the static bytecode) is also stored for future reference.
+
+### On-chain storage
+
+Different applications like Tapswap and Cauldron have also started posting the `constructor` arguments with a contract-identifier to an `OP_RETURN` output during the contract creation. This way the contract details are available on-chain in a decentralized and recoverable way.
+
+:::tip
+To store contract details on-chain, start the `OP_RETURN` data with an easily recognizable identifier, this way you can find all your smart contract UTXOs by checking the transactions including that identifier in the `OP_RETURN`.
+:::
+
+## Transaction server
+
+When your smart contracts depend on "automatic settlement" or any events where transactions are invoked without the user being involved, you will need a transaction server to create and broadcast those transactions. Smart contracts on BCH are never self-executing, someone is always needed to invoke functionality on a smart contract by creating a transaction.
+
+There are 2 main types of events which might need a transaction server to trigger a smart contract transaction, namely time-related events and oracle-related events.
+
+### Time-related events
+
+Time-related events are when your smart contract uses absolute or relative locktimes, which require a waiting period before certain transactions can happen. However, if you want those transactions to 'automatically' happen when this locktime is reached, then you will need to create a transaction server to monitor the blockheight on an ongoing basis.
+
+:::tip
+Both the `Electrum` and `Chaingraph` indexers allow you to create websocket subscriptions to listen for blockheight updates.
+:::
+
+### Oracle-related events
+
+Oracle-related events are when your smart contract uses an oracle to listen for outside information, where some transactions can only happen if the oracle publishes certain information. However, if you want those transactions to 'automatically' happen when the oracle triggers this condition, then you will need to create a transaction server to monitor the oracle for triggers on an ongoing basis.
diff --git a/website/docs/guides/syntax-highlighting.md b/website/docs/guides/syntax-highlighting.md
index 2c69a56f..1e3e0c75 100644
--- a/website/docs/guides/syntax-highlighting.md
+++ b/website/docs/guides/syntax-highlighting.md
@@ -36,13 +36,14 @@ au BufRead,BufNewFile *.cash setfiletype solidity
 
 This associates `.cash` files with Solidity, and enables syntax highlighting for your CashScript files.
 
-## GitHub & GitLab
-GitHub and GitLab have syntax highlighting for Solidity built in. To associate `.cash` files with Solidity highlighting, add a `.gitattributes` file to your repository with the following contents:
+## GitHub
+GitHub has highlighting for Solidity built in. To associate `.cash` files with Solidity highlighting, add a `.gitattributes` file to your repository with the following contents:
 
 ```python title=".gitattributes"
 *.cash linguist-language=Solidity # GitHub
-*.cash gitlab-language=solidity # GitLab
 ```
 
+Unfortunately Gitlab does not have properly working Soldidity highlighting through the `gitattributes` for now...
+
 ## Others
 If your editor is not mentioned above, the steps are likely very similar. Try to find a Solidity syntax highlighting plugin for your editor of choice and find a method to associate `.cash` files with this Solidity highlighting.
diff --git a/website/docs/language/globals.md b/website/docs/language/globals.md
index 8b40a77f..a5473ccf 100644
--- a/website/docs/language/globals.md
+++ b/website/docs/language/globals.md
@@ -255,7 +255,7 @@ The units `sats`, `finney`, `bits` and `bitcoin` can be used to denominate Bitco
 ```solidity
 require(1 sats == 1);
 require(1 finney == 10);
-require(1 bit == 100);
+require(1 bits == 100);
 require(1 bitcoin == 1e8);
 ```
 
diff --git a/website/sidebars.js b/website/sidebars.js
index d7f98d05..08afe66e 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -48,6 +48,7 @@ module.exports = {
       items: [
         'guides/syntax-highlighting',
         'guides/covenants',
+        'guides/infrastructure',
         'guides/walletconnect',
         'guides/debugging',
         'guides/optimization'

From 46fd2711dce76fa8f7507c63a7a3b48320a0c2fc Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Tue, 17 Dec 2024 10:30:33 +0100
Subject: [PATCH 162/267] enable fullstackNetworkProvider p2sh32 test (#247)

---
 packages/cashscript/test/e2e/network/FullStack.test.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/cashscript/test/e2e/network/FullStack.test.ts b/packages/cashscript/test/e2e/network/FullStack.test.ts
index 221c0c4a..67f9d249 100644
--- a/packages/cashscript/test/e2e/network/FullStack.test.ts
+++ b/packages/cashscript/test/e2e/network/FullStack.test.ts
@@ -23,8 +23,7 @@ if (!process.env.TESTS_USE_MOCKNET) {
         const utxos = await p2pkhInstance.getUtxos();
         expect(Array.isArray(utxos)).toBe(true);
       });
-      // Note: does not currently support p2sh32
-      it.skip('should get the utxos for a p2sh32 contract', async () => {
+      it('should get the utxos for a p2sh32 contract', async () => {
         // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
         const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh32' });
         console.log(p2pkhInstance.address);
@@ -36,6 +35,7 @@ if (!process.env.TESTS_USE_MOCKNET) {
 
     describe('send using FullStackNetworkProvider', () => {
       // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
+      // Using p2sh20 address becuase it is funded on mainnet
       const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh20' });
       console.log(p2pkhInstance.address);
 

From 513cc8f6245f9165eb3b77206133af75551b5a80 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 17 Dec 2024 11:53:02 +0100
Subject: [PATCH 163/267] Fix spellcheck

---
 .cspell.json                                           | 5 +++++
 packages/cashscript/test/e2e/network/FullStack.test.ts | 4 ++--
 packages/cashscript/test/types/Contract.types.test.ts  | 2 +-
 website/docs/guides/infrastructure.md                  | 8 ++++----
 website/docs/guides/syntax-highlighting.md             | 2 +-
 website/docs/showcase.md                               | 2 +-
 6 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/.cspell.json b/.cspell.json
index 0eb10029..fe34cbe0 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -46,6 +46,7 @@
         "chipnet",
         "cleanstack",
         "cryptocurrency",
+        "collateralized",
         "datasig",
         "deserialisation",
         "docblock",
@@ -94,6 +95,7 @@
         "linebreak",
         "listunspent",
         "locktime",
+        "locktimes",
         "lokad",
         "lshift",
         "mecenas",
@@ -159,6 +161,7 @@
         "signable",
         "sigs",
         "spedn",
+        "stablecoins",
         "startup",
         "standardness",
         "tagline",
@@ -203,6 +206,7 @@
         "bchn",
         "cashcompiler",
         "cashninjas",
+        "chaingraph",
         "cherian",
         "CSCriptNum",
         "docu",
@@ -216,6 +220,7 @@
         "lichos",
         "mainnetjs",
         "maxdepth",
+        "moria",
         "networkprovider",
         "outputnulldata",
         "outputp",
diff --git a/packages/cashscript/test/e2e/network/FullStack.test.ts b/packages/cashscript/test/e2e/network/FullStack.test.ts
index 67f9d249..86cc88f1 100644
--- a/packages/cashscript/test/e2e/network/FullStack.test.ts
+++ b/packages/cashscript/test/e2e/network/FullStack.test.ts
@@ -35,7 +35,7 @@ if (!process.env.TESTS_USE_MOCKNET) {
 
     describe('send using FullStackNetworkProvider', () => {
       // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
-      // Using p2sh20 address becuase it is funded on mainnet
+      // Using p2sh20 address because it is funded on mainnet
       const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh20' });
       console.log(p2pkhInstance.address);
 
@@ -74,5 +74,5 @@ if (!process.env.TESTS_USE_MOCKNET) {
     });
   });
 } else {
-  test.skip('skip', () => {});
+  test.skip('skip', () => { });
 }
diff --git a/packages/cashscript/test/types/Contract.types.test.ts b/packages/cashscript/test/types/Contract.types.test.ts
index 5b39a396..9c944b23 100644
--- a/packages/cashscript/test/types/Contract.types.test.ts
+++ b/packages/cashscript/test/types/Contract.types.test.ts
@@ -34,7 +34,7 @@ interface ManualArtifactType extends Artifact {
 
 // describe('P2PKH contract | single constructor input | single function (2 args)')
 {
-  // describe('Contructor arguments')
+  // describe('Constructor arguments')
   {
     // it('should not give type errors when using correct constructor inputs')
     new Contract(p2pkhArtifact, [alicePkh]);
diff --git a/website/docs/guides/infrastructure.md b/website/docs/guides/infrastructure.md
index 849a7190..16da93f4 100644
--- a/website/docs/guides/infrastructure.md
+++ b/website/docs/guides/infrastructure.md
@@ -3,7 +3,7 @@ title: Contract Infrastructure
 ---
 
 When creating a smart contract application on Bitcoin Cash you'll need to investigate whether you need surrounding contract infrastructure.
-Below we'll discuss the 2 main types of contract infrastructure you might run into: the need to store contract details and the need for a transaction server. 
+Below we'll discuss the 2 main types of contract infrastructure you might run into: the need to store contract details and the need for a transaction server.
 
 ## Storing Contract Details
 
@@ -13,7 +13,7 @@ Because of the `pay-to-scripthash` (`P2SH`) standard for smart contracts on BCH,
 It is the responsibility of smart contract services/apps to keep track of the contract details making up the `P2SH` contract, as user-wallets are currently not smart enough to do this automatically.
 :::
 
-When users are allowed to provide their own `constructor` arguments when creating a BCH smart contract, each contract creation will have a unique smart contract address. Only the constructor arguments in the contract bytecode are variable, the rest of the bytecode for a contract is static. This static part is derived from the CashScript source file, so storing the contract source file or artifact both has the same effect. 
+When users are allowed to provide their own `constructor` arguments when creating a BCH smart contract, each contract creation will have a unique smart contract address. Only the constructor arguments in the contract bytecode are variable, the rest of the bytecode for a contract is static. This static part is derived from the CashScript source file, so storing the contract source file or artifact both has the same effect.
 
 :::note
 To construct the full contract script you need both the `constructor` arguments and static contract bytecode (either the contract source file or the `Artifact`) to be available.
@@ -40,10 +40,10 @@ There are 2 main types of events which might need a transaction server to trigge
 
 ### Time-related events
 
-Time-related events are when your smart contract uses absolute or relative locktimes, which require a waiting period before certain transactions can happen. However, if you want those transactions to 'automatically' happen when this locktime is reached, then you will need to create a transaction server to monitor the blockheight on an ongoing basis.
+Time-related events are when your smart contract uses absolute or relative locktimes, which require a waiting period before certain transactions can happen. However, if you want those transactions to 'automatically' happen when this locktime is reached, then you will need to create a transaction server to monitor the block height on an ongoing basis.
 
 :::tip
-Both the `Electrum` and `Chaingraph` indexers allow you to create websocket subscriptions to listen for blockheight updates.
+Both the `Electrum` and `Chaingraph` indexers allow you to create websocket subscriptions to listen for block height updates.
 :::
 
 ### Oracle-related events
diff --git a/website/docs/guides/syntax-highlighting.md b/website/docs/guides/syntax-highlighting.md
index 1e3e0c75..c260631d 100644
--- a/website/docs/guides/syntax-highlighting.md
+++ b/website/docs/guides/syntax-highlighting.md
@@ -43,7 +43,7 @@ GitHub has highlighting for Solidity built in. To associate `.cash` files with S
 *.cash linguist-language=Solidity # GitHub
 ```
 
-Unfortunately Gitlab does not have properly working Soldidity highlighting through the `gitattributes` for now...
+Unfortunately Gitlab does not have properly working Solidity highlighting through the `gitattributes` for now...
 
 ## Others
 If your editor is not mentioned above, the steps are likely very similar. Try to find a Solidity syntax highlighting plugin for your editor of choice and find a method to associate `.cash` files with this Solidity highlighting.
diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index a9b96c32..45eeb6b8 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -26,7 +26,7 @@ Tapswap is the first non-custodial marketplace to trade CashTokens, both fungibl
     <a href="https://moria.money/" target="_blank"><img src="/img/moria.png" /></a>
 </div>
 
-Moria is a decentralized stablecoin and borrowing protocol on Bitcoin Cash using CashTokens. The Moria protocol works with collateralized-debt-positions (CDPs) where stablecoins are issued by creating over-collateralized loans. The Moria protocol uses multiple smart contracts, all written in CashScript.
+Moria is a decentralized stablecoin and borrowing protocol on Bitcoin Cash using CashTokens. The Moria protocol works with collateralized debt positions (CDPs) where stablecoins are issued by creating over-collateralized loans. The Moria protocol uses multiple smart contracts, all written in CashScript.
 
 ## Bitcats Heroes
 

From 411175adfda9767f19ab3b401bdf839337a6b82a Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 17 Dec 2024 11:54:12 +0100
Subject: [PATCH 164/267] Replace Travis badge with GitHub Actions badge in
 READMEs

---
 README.md                     | 2 +-
 packages/cashc/README.md      | 2 +-
 packages/cashscript/README.md | 2 +-
 packages/utils/README.md      | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index f10c6c51..2cc8cb2e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # CashScript
 
-[![Build Status](https://travis-ci.org/CashScript/cashscript.svg)](https://travis-ci.org/CashScript/cashscript)
+[![Build Status](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml/badge.svg)](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml)
 [![Coverage Status](https://img.shields.io/codecov/c/github/CashScript/cashscript.svg)](https://codecov.io/gh/CashScript/cashscript/)
 [![NPM Version](https://img.shields.io/npm/v/cashscript.svg)](https://www.npmjs.com/package/cashscript)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/cashscript.svg)](https://www.npmjs.com/package/cashscript)
diff --git a/packages/cashc/README.md b/packages/cashc/README.md
index 674ef4ba..d39c8b50 100644
--- a/packages/cashc/README.md
+++ b/packages/cashc/README.md
@@ -1,6 +1,6 @@
 # CashScript
 
-[![Build Status](https://travis-ci.org/CashScript/cashscript.svg)](https://travis-ci.org/CashScript/cashscript)
+[![Build Status](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml/badge.svg)](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml)
 [![Coverage Status](https://img.shields.io/codecov/c/github/CashScript/cashscript.svg)](https://codecov.io/gh/CashScript/cashscript/)
 [![NPM Version](https://img.shields.io/npm/v/cashscript.svg)](https://www.npmjs.com/package/cashscript)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/cashscript.svg)](https://www.npmjs.com/package/cashscript)
diff --git a/packages/cashscript/README.md b/packages/cashscript/README.md
index 472c5f70..7fd1f807 100644
--- a/packages/cashscript/README.md
+++ b/packages/cashscript/README.md
@@ -1,6 +1,6 @@
 # CashScript
 
-![Build Status](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml/badge.svg)
+[![Build Status](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml/badge.svg)](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml)
 [![Coverage Status](https://img.shields.io/codecov/c/github/CashScript/cashscript.svg)](https://codecov.io/gh/CashScript/cashscript/)
 [![NPM Version](https://img.shields.io/npm/v/cashscript.svg)](https://www.npmjs.com/package/cashscript)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/cashscript.svg)](https://www.npmjs.com/package/cashscript)
diff --git a/packages/utils/README.md b/packages/utils/README.md
index 09dfc906..2991669d 100644
--- a/packages/utils/README.md
+++ b/packages/utils/README.md
@@ -1,6 +1,6 @@
 # @cashscript/utils
 
-[![Build Status](https://travis-ci.org/CashScript/cashscript.svg)](https://travis-ci.org/CashScript/cashscript)
+[![Build Status](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml/badge.svg)](https://github.com/CashScript/cashscript/actions/workflows/github-actions.yml)
 [![Coverage Status](https://img.shields.io/codecov/c/github/CashScript/cashscript.svg)](https://codecov.io/gh/CashScript/cashscript)
 [![NPM Version](https://img.shields.io/npm/v/@cashscript/utils.svg)](https://www.npmjs.com/package/@cashscript/utils)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/@cashscript/utils.svg)](hhttps://www.npmjs.com/package/@cashscript/utils)

From 08790b6503177fff6529cec43ee19e4a1aeb21be Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 17 Dec 2024 11:59:08 +0100
Subject: [PATCH 165/267] Add codecov upload to GitHub actions

---
 .github/workflows/github-actions.yml | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/github-actions.yml b/.github/workflows/github-actions.yml
index eba0753a..59d0aa3e 100644
--- a/.github/workflows/github-actions.yml
+++ b/.github/workflows/github-actions.yml
@@ -22,11 +22,26 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v3
+
       - name: Setup node
         uses: actions/setup-node@v3
         with:
           node-version: 20
-      - run: yarn
-      - run: TESTS_USE_MOCKNET=true yarn test -- -- --coverage --coverageProvider=v8
-      - run: yarn lint
-      - run: yarn spellcheck
+
+      - name: Install dependencies
+        run: yarn
+
+      - name: Run tests
+        run: TESTS_USE_MOCKNET=true yarn test -- -- --coverage --coverageProvider=v8
+
+      - name: Run linter
+        run: yarn lint
+
+      - name: Run spellchecker
+        run: yarn spellcheck
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: CashScript/cashscript

From 78100b2db243e498b5ff172c778222715a378860 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 14 Jan 2025 10:17:23 +0100
Subject: [PATCH 166/267] Update highlighting guide to link to our new
 extension

---
 website/docs/guides/syntax-highlighting.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/website/docs/guides/syntax-highlighting.md b/website/docs/guides/syntax-highlighting.md
index c260631d..d841cc4a 100644
--- a/website/docs/guides/syntax-highlighting.md
+++ b/website/docs/guides/syntax-highlighting.md
@@ -5,9 +5,9 @@ title: Syntax Highlighting
 When developing smart contracts for CashScript it is useful to have the proper syntax highlighting in your code editor / IDE. If you use Visual Studio Code, there is a dedicated CashScript extension. For other editors it is recommended to install a Solidity highlighting plugin and associate it with `.cash` files in your editor, since the syntaxes of the two languages are very similar.
 
 ## Visual Studio Code (Recommended)
-For Visual Studio Code a dedicated [CashScript extension](https://marketplace.visualstudio.com/items?itemName=nathanielcherian.cashscript) was developed by community contributor [Nathaniel Cherian](https://twitter.com/nathanielCheria). This plugin works with `.cash` files and supports syntax highlighting, autocompletion, snippets, linting and even integrated compilation.
+For Visual Studio Code (and derived editors like Cursor) we have an official [CashScript extension](https://marketplace.visualstudio.com/items?itemName=CashScript.cashscript-vscode). This extension works with `.cash` files and supports syntax highlighting, autocompletion, snippets and linting.
 
-Because of the first-class CashScript support, Visual Studio Code together with this CashScript extension is the recommended way to develop CashScript contracts.
+Because of the first-class CashScript support, Visual Studio Code with this CashScript extension is the recommended way to develop CashScript contracts.
 
 ## Sublime Text
 The most popular Solidity plugin for Sublime Text 2/3 is [Ethereum](https://packagecontrol.io/packages/Ethereum). Install this plugin with [Package Control](https://packagecontrol.io/), open a `.cash` file and set Solidity as the syntax language in the Sublime menu bar:

From e8b72872c2a243763da9a9acf705ab43d52305cc Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 4 Nov 2024 14:30:02 +0100
Subject: [PATCH 167/267] update docs for VM Limits & BigInts

---
 website/docs/compiler/vmlimits.md   | 42 +++++++++++++++++++++++++++++
 website/docs/guides/optimization.md |  4 +--
 website/docs/language/types.md      | 10 +------
 website/docs/sdk/instantiation.md   | 12 ++++++---
 website/sidebars.js                 |  1 +
 5 files changed, 54 insertions(+), 15 deletions(-)
 create mode 100644 website/docs/compiler/vmlimits.md

diff --git a/website/docs/compiler/vmlimits.md b/website/docs/compiler/vmlimits.md
new file mode 100644
index 00000000..da7daf3d
--- /dev/null
+++ b/website/docs/compiler/vmlimits.md
@@ -0,0 +1,42 @@
+---
+title: Bitcoin Cash VM Limits
+sidebar_label: VM Limits
+---
+
+Bitcoin Cash enforces VM limits to ensure secure and efficient contract execution. When developing with CashScript, keep these limits in mind to ensure your contracts run smoothly without encountering transaction errors due to size or computational constraints.
+
+## Maximum Contract Size
+
+The Bitcoin Cash VM has a **maximum size for smart contracts** which limits the length of input bytecode to **1,650 bytes**. While typical contracts stay well below this, complex contracts with extensive logic might require adjustments to fit within this constraint.
+
+### Modular Contract Design
+
+If your contract includes multiple functions, consider a modular design. Separating contract logic into independent components allows each function to be deployed as a smaller contract, reducing the overall transaction size. This approach can naturally divide complex contracts without impacting functionality. For more on this, see the guide on [Contract Optimization](/docs/guides/optimization).
+
+## Operation Cost Limit
+
+Bitcoin Cash also enforces an **operation cost limit** (op-cost) on each transaction input. The op-cost limit controls the computational budget available for operations in a contract and is calculated based on the input length, with each byte allowing for a higher maximum opereraction cost.
+
+```ts
+function maxOperationCost(unlockingBytecodeLength) {
+  return (41n + unlockingBytecodeLength) * 800n;
+}
+```
+
+With this formula, increasing your input length allows for a larger compute budget. You can view specific op-costs for each operation in the [op-cost-table][op-cost-table], which outlines the compute cost of operation.
+
+### Buying Compute Budget
+
+To increase your contract's compute budget for resource-intensive operations (e.g., cryptographic hashing or large number calculations), you can use zero-padding to extend the input length. By adding non-essential, zero-value bytes, you effectively buy more computation power for your contract without adding functional complexity. This technique could be useful for contracts requiring a higher operation budget, allowing them to meet the contract's computational demands without exceeding the op-cost limit.
+
+## Other Limits
+
+For completeness, here are additional Bitcoin Cash VM limits relevant to CashScript development:
+
+- **Signature Operation Count** (SigChecks) Limits the number of signature verifications (e.g. `OP_CHECKSIG`, `OP_CHECKDATASIG`) per transaction to ensure efficient validation. 
+
+- **Hashing Limit**: Limits the number of hashing operations (e.g. `OP_SHA256`, `OP_HASH160`) allowed per transaction to prevent excessive resource usage.
+
+- **Stack Element Byte Length**: Each stack element has a maximum length of 10,000 bytes. This limit also affects the size of Pay-to-Script-Hash (P2SH) contracts which are pushed as an element to the stack on spending.
+
+[op-cost-table]: https://github.com/bitjson/bch-vm-limits/blob/master/operation-costs.md
diff --git a/website/docs/guides/optimization.md b/website/docs/guides/optimization.md
index 6d188039..9186fab6 100644
--- a/website/docs/guides/optimization.md
+++ b/website/docs/guides/optimization.md
@@ -13,7 +13,7 @@ When optimizing your contract, you will need to compare the contract size to see
 With the compiler CLI, you can easily check the opcode count and bytesize directly from the generated contract artifact.
 
 ```bash
-cashc ./contract.cash --opcount --size
+cashc ./contract.cash --size --opcount
 ```
 
 The size outputs of the `cashc` compiler are based on the bytecode without constructor arguments. This means they will always be an underestimate, as the contract hasn't been initialized with contract arguments.
@@ -23,7 +23,7 @@ The compiler opcount and bytesize outputs are still helpful to compare the effec
 :::
 
 :::tip
-To get the exact contract opcount and bytesize including constructor parameters, initialise the contract with the TypScript SDK and check the values of `contract.opcount` and `contract.bytesize`.
+To get the exact contract bytesize including constructor parameters, initialise the contract with the TypScript SDK and check the value of `contract.bytesize`.
 :::
 
 ## Optimization Tips & Tricks
diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index ba661d5c..7c307a9f 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -20,7 +20,7 @@ The operators `||` and `&&` don't apply common short-circuiting rules. This mean
 :::
 
 ## Integer
-`int`: Signed integer of 64 bit size.
+`int`: Signed integer of arbitrary size (BigInt).
 
 Operators:
 
@@ -33,14 +33,6 @@ Note the lack of the `**` (exponentiation) operator as well as any bitwise opera
 
 Underscores can be used to separate the digits of a numeric literal to aid readability, e.g. `1_000_000`. Numbers can also be formatted in scientific notation, e.g. `1e6` or `1E6`. These can also be combined, e.g. `1_000e6`.
 
-#### Over- & Underflows
-
-The maximum range for 64-bit integers is `-9223372036854775807` to `9223372036854775807`, operations exceeding these limits will fail the transaction. So operations like summation, subtraction and multiplication should take into account these boundary cases with over- or underflows.
-
-:::caution
-Contract authors should always consider whether `+`, `-` and `*` operations can cause under- or overflows and how this would impact contract security.
-:::
-
 #### Division by Zero
 
 The script will fail when the right hand side of division or modulo operations is zero.
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index ff34a33c..1917d4f7 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -91,11 +91,11 @@ console.log(contract.tokenAddress)
 contract.opcount: number
 ```
 
-The number of opcodes in the contract's bytecode can be retrieved through the `opcount` member field. This is useful to ensure that the contract is not too big, since Bitcoin Cash smart contracts can contain a maximum of 201 opcodes.
+The number of opcodes in the contract's bytecode can be retrieved through the `opcount` member field.
 
 #### Example
 ```ts
-assert(contract.opcount <= 201)
+console.log(contract.opcount)
 ```
 
 ### bytesize
@@ -103,11 +103,15 @@ assert(contract.opcount <= 201)
 contract.bytesize: number
 ```
 
-The size of the contract's bytecode in bytes can be retrieved through the `bytesize` member field. This is useful to ensure that the contract is not too big, since Bitcoin Cash smart contracts can be 520 bytes at most.
+The size of the contract's bytecode in bytes can be retrieved through the `bytesize` member field. This is useful to ensure that the contract is not too big, since Bitcoin Cash smart contracts can be 1,650 bytes at most.
+
+:::info
+The size outputs of the `cashc` compiler are based on the bytecode without constructor arguments. This means they will always be an underestimate, as the contract hasn't been initialized with contract arguments.
+:::
 
 #### Example
 ```ts
-console.log(contract.bytesize)
+assert(contract.bytesize <= 1650)
 ```
 
 ### bytecode
diff --git a/website/sidebars.js b/website/sidebars.js
index 08afe66e..bc8aa1ee 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -25,6 +25,7 @@ module.exports = {
       label: 'Compiler',
       items: [
         'compiler/compiler',
+        'compiler/vmlimits',
         'compiler/artifacts',
         'compiler/grammar',
       ],

From e464c4dac7c667691681dbe728aca983bc2fee0e Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 8 Nov 2024 10:00:15 +0100
Subject: [PATCH 168/267] remove warning integer casting, add docs about
 Semantic Byte Casting

---
 website/docs/language/types.md | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index 7c307a9f..11edc4e9 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -178,10 +178,15 @@ When casting integer types to bytes of a certain size, the integer value is padd
 VM numbers follow Script Number format (A.K.A. CSCriptNum), to convert VM number to bytes or the reverse, it's recommended to use helper functions for these conversions from libraries like Libauth.
 :::
 
+### Semantic Byte Casting
 
-:::caution
-When casting bytes types to integer, you should be sure that the bytes value fits inside a 64-bit signed integer, or the script will fail.
-:::
+Bytes to bytes casting is just semantic and can be helpful for working with `LockingBytecode` global functions which expect a specific length input. To utilize byte-padding, convert to `int` and utilize the integer padding.
+
+#### Example
+```solidity
+bytes pkh = nftcommitment.split(20)[0];
+bytes25 lockingBytecode = new LockingBytecodeP2PKH(bytes20(pkh)):
+```
 
 ## Operators
 An overview of all supported operators and their precedence is included below. Notable is a lack of exponentiation, since these operations are not supported by the underlying Bitcoin Script.

From 0cbcb8d23e997e949e6f9e6ae702b03c54868066 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 19 Nov 2024 10:58:07 +0100
Subject: [PATCH 169/267] Add support for BCH_2025_05

- Update libauth to latest @next release and adapt to changes
- Remove opcount checks & update bytesize checks to new limit
- Update VM used for debugging to BCH_2025_05
- Update bigint tests to check that ints bigger than 64 bits no longer
  fail
---
 examples/package.json                       |  2 +-
 examples/testing-suite/package.json         |  1 +
 packages/cashc/package.json                 |  2 +-
 packages/cashc/src/cashc-cli.ts             |  8 +++-----
 packages/cashc/src/constants.ts             |  1 +
 packages/cashscript/package.json            |  2 +-
 packages/cashscript/src/debugging.ts        | 13 +++++++------
 packages/cashscript/test/e2e/BigInt.test.ts | 14 +++++---------
 packages/utils/package.json                 |  2 +-
 packages/utils/src/script.ts                | 10 +++++-----
 yarn.lock                                   |  8 ++++----
 11 files changed, 30 insertions(+), 33 deletions(-)
 create mode 100644 packages/cashc/src/constants.ts

diff --git a/examples/package.json b/examples/package.json
index 3f99f7fd..dc618dd1 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -11,7 +11,7 @@
     "lint": "eslint . --ext .ts --ignore-path ../.eslintignore"
   },
   "dependencies": {
-    "@bitauth/libauth": "^3.0.0",
+    "@bitauth/libauth": "^3.1.0-next.2",
     "@types/node": "^12.7.8",
     "cashc": "^0.10.5",
     "cashscript": "^0.10.5",
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 9097f8c7..d81226e1 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -25,6 +25,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
+    "@bitauth/libauth": "^3.1.0-next.2",
     "cashc": "^0.10.5",
     "cashscript": "^0.10.5",
     "url-join": "^5.0.0"
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index c32a5438..f23f0745 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -49,7 +49,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^3.0.0",
+    "@bitauth/libauth": "^3.1.0-next.2",
     "@cashscript/utils": "^0.10.5",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
diff --git a/packages/cashc/src/cashc-cli.ts b/packages/cashc/src/cashc-cli.ts
index 7b353790..e28b25a3 100644
--- a/packages/cashc/src/cashc-cli.ts
+++ b/packages/cashc/src/cashc-cli.ts
@@ -13,6 +13,7 @@ import { program, Option } from 'commander';
 import fs from 'fs';
 import path from 'path';
 import { compileFile, version } from './index.js';
+import { MAX_INPUT_BYTESIZE } from './constants.js';
 
 program
   .storeOptionsAsProperties(false)
@@ -54,11 +55,8 @@ function run(): void {
     const opcount = countOpcodes(script);
     const bytesize = calculateBytesize(script);
 
-    if (opcount > 201) {
-      console.warn('Warning: Your contract\'s opcount is over the limit of 201 and will not be accepted by the BCH network');
-    }
-    if (bytesize > 520) {
-      console.warn('Warning: Your contract\'s bytesize is over the limit of 520 and will not be accepted by the BCH network');
+    if (bytesize > MAX_INPUT_BYTESIZE) {
+      console.warn(`Warning: Your contract is ${bytesize} bytes, which is over the limit of ${MAX_INPUT_BYTESIZE} bytes and will not be accepted by the BCH network`);
     }
 
     if (opts.asm) {
diff --git a/packages/cashc/src/constants.ts b/packages/cashc/src/constants.ts
new file mode 100644
index 00000000..097767c3
--- /dev/null
+++ b/packages/cashc/src/constants.ts
@@ -0,0 +1 @@
+export const MAX_INPUT_BYTESIZE = 1650;
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index e2a653e7..6cd02545 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -43,7 +43,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^3.0.0",
+    "@bitauth/libauth": "^3.1.0-next.2",
     "@cashscript/utils": "^0.10.5",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "delay": "^5.0.0",
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 6e3e69fd..ffd31bb2 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -1,4 +1,4 @@
-import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateBCH, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBCH2023, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
+import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBch2025, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
 import { Artifact, LogEntry, Op, PrimitiveType, StackItem, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
 import { findLastIndex, toRegExp } from './utils.js';
 import { FailedRequireError, FailedTransactionError, FailedTransactionEvaluationError } from './Errors.js';
@@ -53,7 +53,7 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
     // preceding OP_CHECKSIG opcode. The error message is registered in the next instruction, so we need to increment
     // the instruction pointer to get the correct error message from the require messages in the artifact.
     // Note that we do NOT use this adjusted IP when passing the failing IP into the FailedRequireError
-    const isNullFail = lastExecutedDebugStep.error === AuthenticationErrorCommon.nonNullSignatureFailure;
+    const isNullFail = lastExecutedDebugStep.error.includes(AuthenticationErrorCommon.nonNullSignatureFailure);
     const requireStatementIp = failingIp + (isNullFail ? 1 : 0);
 
     const requireStatement = (artifact.debug?.requires ?? [])
@@ -110,7 +110,7 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
 type VM = AuthenticationVirtualMachine<
 ResolvedTransactionCommon,
 AuthenticationProgramCommon,
-AuthenticationProgramStateBCH
+AuthenticationProgramStateCommon
 >;
 type Program = AuthenticationProgramCommon;
 type CreateProgramResult = { vm: VM, program: Program };
@@ -118,7 +118,7 @@ type CreateProgramResult = { vm: VM, program: Program };
 // internal util. instantiates the virtual machine and compiles the template into a program
 const createProgram = (template: WalletTemplate): CreateProgramResult => {
   const configuration = walletTemplateToCompilerConfiguration(template);
-  const vm = createVirtualMachineBCH2023();
+  const vm = createVirtualMachineBch2025();
   const compiler = createCompiler(configuration);
 
   const scenarioGeneration = compiler.generateScenario({
@@ -176,8 +176,9 @@ const failedFinalVerify = (evaluationResult: string | true): evaluationResult is
   // If any of the following errors occurred, then the final verify failed - any other messages
   // indicate other kinds of failures
   return toRegExp([
-    AuthenticationErrorCommon.requiresCleanStack,
-    AuthenticationErrorCommon.nonEmptyControlStack,
+    // TODO: Ask Jason to put these back into an enum and replace with the enum value
+    'The CashAssembly internal evaluation completed with an unexpected number of items on the stack (must be exactly 1).', // AuthenticationErrorCommon.requiresCleanStack,
+    'The CashAssembly internal evaluation completed with a non-empty control stack.', // AuthenticationErrorCommon.nonEmptyControlStack,
     AuthenticationErrorCommon.unsuccessfulEvaluation,
   ]).test(evaluationResult);
 };
diff --git a/packages/cashscript/test/e2e/BigInt.test.ts b/packages/cashscript/test/e2e/BigInt.test.ts
index bc811561..dcd5cd9a 100644
--- a/packages/cashscript/test/e2e/BigInt.test.ts
+++ b/packages/cashscript/test/e2e/BigInt.test.ts
@@ -1,9 +1,7 @@
-import { AuthenticationErrorCommon } from '@bitauth/libauth';
 import {
   Contract,
   MockNetworkProvider,
   FailedRequireError,
-  FailedTransactionError,
   ElectrumNetworkProvider,
   Network,
 } from '../../src/index.js';
@@ -26,7 +24,7 @@ describe('BigInt', () => {
   });
 
   describe('proofOfBigInt', () => {
-    it('should fail when providing a number that fits within 32 bits', async () => {
+    it('should fail require statement when providing a number that fits within 32 bits', async () => {
       // given
       const to = bigintContract.address;
       const amount = 1000n;
@@ -43,7 +41,7 @@ describe('BigInt', () => {
       await expect(txPromise).rejects.toThrow('Failing statement: require(x >= maxInt32PlusOne)');
     });
 
-    it('should fail when providing numbers that overflow 64 bits when multiplied', async () => {
+    it('should succeed when providing numbers that are larger than 64 bits when multiplied', async () => {
       // given
       const to = bigintContract.address;
       const amount = 1000n;
@@ -55,11 +53,10 @@ describe('BigInt', () => {
         .send();
 
       // then
-      await expect(txPromise).rejects.toThrow(FailedTransactionError);
-      await expect(txPromise).rejects.toThrow(AuthenticationErrorCommon.overflowsVmNumberRange);
+      await expect(txPromise).resolves.not.toThrow();
     });
 
-    it('should fail when providing a number that does not fit within 64 bits', async () => {
+    it('should succeed when providing a number that does not fit within 64 bits', async () => {
       // given
       const to = bigintContract.address;
       const amount = 1000n;
@@ -71,8 +68,7 @@ describe('BigInt', () => {
         .send();
 
       // then
-      await expect(txPromise).rejects.toThrow(FailedTransactionError);
-      await expect(txPromise).rejects.toThrow(AuthenticationErrorCommon.invalidVmNumber);
+      await expect(txPromise).resolves.not.toThrow();
     });
 
     it('should succeed when providing a number within 32b < x < 64b', async () => {
diff --git a/packages/utils/package.json b/packages/utils/package.json
index b60df22c..6f51aa23 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -40,7 +40,7 @@
     "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest"
   },
   "dependencies": {
-    "@bitauth/libauth": "^3.0.0"
+    "@bitauth/libauth": "^3.1.0-next.2"
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index a0b8fa32..111a723c 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -1,8 +1,8 @@
 import {
-  OpcodesBCH,
+  OpcodesBch2023,
   encodeDataPush,
   hexToBin,
-  disassembleBytecodeBCH,
+  disassembleBytecodeBch,
   flattenBinArray,
   encodeAuthenticationInstructions,
   decodeAuthenticationInstructions,
@@ -10,7 +10,7 @@ import {
 import { decodeInt, encodeInt } from './data.js';
 import OptimisationsEquivFile from './cashproof-optimisations.js';
 
-export const Op = OpcodesBCH;
+export const Op = OpcodesBch2023;
 export type Op = number;
 export type OpOrData = Op | Uint8Array;
 export type Script = OpOrData[];
@@ -79,7 +79,7 @@ export function asmToBytecode(asm: string): Uint8Array {
 
 export function bytecodeToAsm(bytecode: Uint8Array): string {
   // Convert the bytecode to libauth's ASM format
-  let asm = disassembleBytecodeBCH(bytecode);
+  let asm = disassembleBytecodeBch(bytecode);
 
   // COnvert libauth's ASM format to BITBOX's
   asm = asm.replace(/OP_PUSHBYTES_[^\s]+/g, '');
@@ -95,7 +95,7 @@ export function bytecodeToAsm(bytecode: Uint8Array): string {
 // TODO: If we decide to change the ASM / artifact format, we can remove this function and merge it with bytecodeToAsm
 export function bytecodeToBitAuthAsm(bytecode: Uint8Array): string {
   // Convert the bytecode to libauth's ASM format
-  let asm = disassembleBytecodeBCH(bytecode);
+  let asm = disassembleBytecodeBch(bytecode);
 
   // COnvert libauth's ASM format to BitAuth Script ASM
   asm = asm.replace(/OP_PUSHBYTES_[^\s]+/g, '');
diff --git a/yarn.lock b/yarn.lock
index 6836e89e..841a8ad8 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -496,10 +496,10 @@
   resolved "https://registry.yarnpkg.com/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz#75a2e8b51cb758a7553d6804a5932d7aace75c39"
   integrity sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==
 
-"@bitauth/libauth@^3.0.0":
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-3.0.0.tgz#d88535fc5353d5ecd11db96d9a229e11c06a43d2"
-  integrity sha512-3yoL31XpnhAnf5nDVMFk4xPqebxDwXrgYAwpa31ARJnV5A/eXWlpNYvCd6FTZPFM4VvKfjCBi+jRCrw1hOZ0Jg==
+"@bitauth/libauth@^3.1.0-next.2":
+  version "3.1.0-next.2"
+  resolved "https://registry.yarnpkg.com/@bitauth/libauth/-/libauth-3.1.0-next.2.tgz#121782b38774d9fba8226406db9b9af0c8d8e464"
+  integrity sha512-XRtk9p8UHvtjSPS38rsfHXzaPHG5j9FpN4qHqqGLoAuZYy675PBiOy9zP6ah8lTnnIVaCFl2ekct8w0Hy1oefw==
 
 "@chris.troutner/bip32-utils@1.0.5":
   version "1.0.5"

From 9afa27167abe88e6a022bd0a1bcd3f086cb3b58b Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 19 Nov 2024 11:30:42 +0100
Subject: [PATCH 170/267] Bump version to 0.11.0-next.0 and add release notes
 for it + update docs

---
 examples/package.json                            |  6 +++---
 examples/testing-suite/package.json              |  6 +++---
 packages/cashc/package.json                      |  4 ++--
 packages/cashc/src/index.ts                      |  2 +-
 packages/cashscript/package.json                 |  4 ++--
 packages/utils/package.json                      |  2 +-
 .../docs/compiler/{vmlimits.md => vm-limits.md}  |  4 ++--
 website/docs/language/types.md                   | 16 +++++++++++++---
 website/docs/releases/release-notes.md           | 10 ++++++++++
 website/sidebars.js                              |  2 +-
 10 files changed, 38 insertions(+), 18 deletions(-)
 rename website/docs/compiler/{vmlimits.md => vm-limits.md} (97%)

diff --git a/examples/package.json b/examples/package.json
index dc618dd1..db1eb81b 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.10.5",
+  "version": "0.11.0-next.0",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
     "@types/node": "^12.7.8",
-    "cashc": "^0.10.5",
-    "cashscript": "^0.10.5",
+    "cashc": "^0.11.0-next.0",
+    "cashscript": "^0.11.0-next.0",
     "eslint": "^8.56.0",
     "typescript": "^4.9.5"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index d81226e1..df6f195c 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.10.5",
+  "version": "0.11.0-next.0",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -26,8 +26,8 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "cashc": "^0.10.5",
-    "cashscript": "^0.10.5",
+    "cashc": "^0.11.0-next.0",
+    "cashscript": "^0.11.0-next.0",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index f23f0745..5648a24e 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.10.5",
+  "version": "0.11.0-next.0",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.10.5",
+    "@cashscript/utils": "^0.11.0-next.0",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
     "semver": "^7.5.4"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 08d9dc48..dcf7c2f4 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.10.5';
+export const version = '0.11.0-next.0';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 6cd02545..623e664a 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.10.5",
+  "version": "0.11.0-next.0",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.10.5",
+    "@cashscript/utils": "^0.11.0-next.0",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "delay": "^5.0.0",
     "electrum-cash": "^2.0.10",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 6f51aa23..1b93cbff 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.10.5",
+  "version": "0.11.0-next.0",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",
diff --git a/website/docs/compiler/vmlimits.md b/website/docs/compiler/vm-limits.md
similarity index 97%
rename from website/docs/compiler/vmlimits.md
rename to website/docs/compiler/vm-limits.md
index da7daf3d..a25c8cde 100644
--- a/website/docs/compiler/vmlimits.md
+++ b/website/docs/compiler/vm-limits.md
@@ -15,7 +15,7 @@ If your contract includes multiple functions, consider a modular design. Separat
 
 ## Operation Cost Limit
 
-Bitcoin Cash also enforces an **operation cost limit** (op-cost) on each transaction input. The op-cost limit controls the computational budget available for operations in a contract and is calculated based on the input length, with each byte allowing for a higher maximum opereraction cost.
+Bitcoin Cash also enforces an **operation cost limit** (op-cost) on each transaction input. The op-cost limit controls the computational budget available for operations in a contract and is calculated based on the input length, with each byte allowing for a higher maximum operation cost.
 
 ```ts
 function maxOperationCost(unlockingBytecodeLength) {
@@ -33,7 +33,7 @@ To increase your contract's compute budget for resource-intensive operations (e.
 
 For completeness, here are additional Bitcoin Cash VM limits relevant to CashScript development:
 
-- **Signature Operation Count** (SigChecks) Limits the number of signature verifications (e.g. `OP_CHECKSIG`, `OP_CHECKDATASIG`) per transaction to ensure efficient validation. 
+- **Signature Operation Count** (SigChecks) Limits the number of signature verifications (e.g. `OP_CHECKSIG`, `OP_CHECKDATASIG`) per transaction to ensure efficient validation.
 
 - **Hashing Limit**: Limits the number of hashing operations (e.g. `OP_SHA256`, `OP_HASH160`) allowed per transaction to prevent excessive resource usage.
 
diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index 11edc4e9..f55968fa 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -180,12 +180,22 @@ VM numbers follow Script Number format (A.K.A. CSCriptNum), to convert VM number
 
 ### Semantic Byte Casting
 
-Bytes to bytes casting is just semantic and can be helpful for working with `LockingBytecode` global functions which expect a specific length input. To utilize byte-padding, convert to `int` and utilize the integer padding.
+When casting unbounded `bytes` types to bounded `bytes` types (such as `bytes20` or `bytes32`), this is a purely semantic cast. The bytes are not padded with zeros, and no checks are performed to ensure the cast bytes are of the correct length. This can be helpful in certain cases, such as `LockingBytecode`, which expects a specific length input.
 
 #### Example
 ```solidity
-bytes pkh = nftcommitment.split(20)[0];
-bytes25 lockingBytecode = new LockingBytecodeP2PKH(bytes20(pkh)):
+bytes pkh = nftCommitment.split(20)[0]; // (type = bytes, content = 20 bytes)
+bytes20 bytes20Pkh = bytes20(pkh); // (type = bytes20, content = 20 bytes)
+bytes25 lockingBytecode = new LockingBytecodeP2PKH(bytes20Pkh);
+```
+
+If you do need to pad bytes to a specific length, you can convert the bytes to `int` first, and then cast to the bounded `bytes` type. This will pad the bytes with zeros to the specified length, like specified in the *Int to Byte Casting* section above.
+
+#### Example
+```solidity
+bytes data = nftCommitment.split(10)[0]; // (type = bytes, content = 10 bytes)
+bytes20 paddedData = bytes20(int(data)); // (type = bytes20, content = 20 bytes)
+require(storedContractState == paddedData);
 ```
 
 ## Operators
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 4146a3f8..1b95d271 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,6 +2,16 @@
 title: Release Notes
 ---
 
+## v0.11.0-next.0
+
+This update adds CashScript support for the new BCH 2025 network upgrade. To read more about the upgrade, see [this blog post](https://blog.bitjson.com/2025-chips/).
+
+#### cashc compiler
+- :hammer_and_wrench: Remove warning for opcount and update warning for byte size to match new limits.
+
+#### CashScript SDK
+- :hammer_and_wrench: Update debug tooling to work with the new `BCH_2025_05` instruction set.
+
 ## v0.10.5
 
 #### cashc compiler
diff --git a/website/sidebars.js b/website/sidebars.js
index bc8aa1ee..e27144ce 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -25,7 +25,7 @@ module.exports = {
       label: 'Compiler',
       items: [
         'compiler/compiler',
-        'compiler/vmlimits',
+        'compiler/vm-limits',
         'compiler/artifacts',
         'compiler/grammar',
       ],

From a7c929d28768ca899db9873b84c3bed9e2d5ba1e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 14 Jan 2025 10:25:01 +0100
Subject: [PATCH 171/267] Add link to v0.10.0 release notes

---
 website/docs/releases/release-notes.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 1b95d271..b0f1b996 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -80,6 +80,10 @@ Thanks [mainnet_pat](https://x.com/mainnet_pat) for the initiative and significa
 - :boom: **BREAKING**: Remove all deprecated references to `meep` including `meep` strings from errors and `transaction.meep()`.
 - :boom: **BREAKING**: Separate the `Argument` type into `FunctionArgument` and `ConstructorArgument` and rename `encodeArgument` to `encodeFunctionArgument`.
 
+---
+
+https://x.com/CashScriptBCH/status/1833454128426615174
+
 ## v0.9.3
 
 #### cashc compiler

From 38d9927eab13b24b0fe5d95eb9c3cf693cfcf5cd Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 14 Jan 2025 11:02:12 +0100
Subject: [PATCH 172/267] Small refactor with mocknet test skipping

---
 .../test/e2e/network/FullStack.test.ts        | 102 +++++++------
 .../cashscript/test/e2e/old/Mecenas.test.ts   | 135 +++++++++---------
 packages/cashscript/test/e2e/old/misc.test.ts |  92 ++++++------
 3 files changed, 161 insertions(+), 168 deletions(-)

diff --git a/packages/cashscript/test/e2e/network/FullStack.test.ts b/packages/cashscript/test/e2e/network/FullStack.test.ts
index 86cc88f1..b0e6f48f 100644
--- a/packages/cashscript/test/e2e/network/FullStack.test.ts
+++ b/packages/cashscript/test/e2e/network/FullStack.test.ts
@@ -10,69 +10,67 @@ import { getTxOutputs } from '../../test-util.js';
 import { FailedRequireError } from '../../../src/Errors.js';
 import artifact from '../../fixture/p2pkh.json' with { type: 'json' };
 
-if (!process.env.TESTS_USE_MOCKNET) {
-  describe('test FullStackNetworkProvider', () => {
-    const provider = new FullStackNetworkProvider('mainnet', new BCHJS({ restURL: 'https://api.fullstack.cash/v5/' }));
+const describeOrSkip = process.env.TESTS_USE_MOCKNET ? describe.skip : describe;
 
-    describe('get utxos using FullStackNetworkProvider', () => {
-      it('should get the utxos for a p2sh20 contract', async () => {
-        // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
-        const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh20' });
-        console.log(p2pkhInstance.address);
+describeOrSkip('test FullStackNetworkProvider', () => {
+  const provider = new FullStackNetworkProvider('mainnet', new BCHJS({ restURL: 'https://api.fullstack.cash/v5/' }));
 
-        const utxos = await p2pkhInstance.getUtxos();
-        expect(Array.isArray(utxos)).toBe(true);
-      });
-      it('should get the utxos for a p2sh32 contract', async () => {
-        // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
-        const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh32' });
-        console.log(p2pkhInstance.address);
+  describe('get utxos using FullStackNetworkProvider', () => {
+    it('should get the utxos for a p2sh20 contract', async () => {
+      // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
+      const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh20' });
+      console.log(p2pkhInstance.address);
 
-        const utxos = await p2pkhInstance.getUtxos();
-        expect(Array.isArray(utxos)).toBe(true);
-      });
+      const utxos = await p2pkhInstance.getUtxos();
+      expect(Array.isArray(utxos)).toBe(true);
     });
-
-    describe('send using FullStackNetworkProvider', () => {
+    it('should get the utxos for a p2sh32 contract', async () => {
       // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
-      // Using p2sh20 address because it is funded on mainnet
-      const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh20' });
+      const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh32' });
       console.log(p2pkhInstance.address);
 
-      it('should fail when using incorrect function arguments', async () => {
-        // given
-        const to = p2pkhInstance.address;
-        const amount = 10000n;
+      const utxos = await p2pkhInstance.getUtxos();
+      expect(Array.isArray(utxos)).toBe(true);
+    });
+  });
+
+  describe('send using FullStackNetworkProvider', () => {
+    // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other tests
+    // Using p2sh20 address because it is funded on mainnet
+    const p2pkhInstance = new Contract(artifact, [bobPkh], { provider, addressType: 'p2sh20' });
+    console.log(p2pkhInstance.address);
 
-        // when
-        const txPromise = p2pkhInstance.functions
-          .spend(bobPub, new SignatureTemplate(alicePriv))
-          .to(to, amount)
-          .send();
+    it('should fail when using incorrect function arguments', async () => {
+      // given
+      const to = p2pkhInstance.address;
+      const amount = 10000n;
 
-        // then
-        await expect(txPromise).rejects.toThrow(FailedRequireError);
-        await expect(txPromise).rejects.toThrow('P2PKH.cash:5 Require statement failed at input 0 in contract P2PKH.cash at line 5.');
-      });
+      // when
+      const txPromise = p2pkhInstance.functions
+        .spend(bobPub, new SignatureTemplate(alicePriv))
+        .to(to, amount)
+        .send();
+
+      // then
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('P2PKH.cash:5 Require statement failed at input 0 in contract P2PKH.cash at line 5.');
+    });
 
-      it('should succeed when using correct function arguments', async () => {
-        // given
-        const to = p2pkhInstance.address;
-        const amount = 10000n;
+    it('should succeed when using correct function arguments', async () => {
+      // given
+      const to = p2pkhInstance.address;
+      const amount = 10000n;
 
-        // when
-        const tx = await p2pkhInstance.functions
-          .spend(bobPub, new SignatureTemplate(bobPriv))
-          .to(to, amount)
-          .send();
+      // when
+      const tx = await p2pkhInstance.functions
+        .spend(bobPub, new SignatureTemplate(bobPriv))
+        .to(to, amount)
+        .send();
 
-        // then
-        const txOutputs = getTxOutputs(tx, 'mainnet');
-        expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-        expect(tx.txid).toBeDefined();
-      });
+      // then
+      const txOutputs = getTxOutputs(tx, 'mainnet');
+      expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
+      expect(tx.txid).toBeDefined();
     });
   });
-} else {
-  test.skip('skip', () => { });
-}
+});
diff --git a/packages/cashscript/test/e2e/old/Mecenas.test.ts b/packages/cashscript/test/e2e/old/Mecenas.test.ts
index 143f76d2..9451d24c 100644
--- a/packages/cashscript/test/e2e/old/Mecenas.test.ts
+++ b/packages/cashscript/test/e2e/old/Mecenas.test.ts
@@ -17,91 +17,88 @@ import { getTxOutputs } from '../../test-util.js';
 import { FailedTransactionError } from '../../../src/Errors.js';
 import artifact from '../../fixture/old/mecenas.json' with { type: 'json' };
 
-if (!process.env.TESTS_USE_MOCKNET) {
-// Mecenas has tx.age check omitted for testing
-  describe('v0.6.0 - Mecenas', () => {
-    let mecenas: Contract;
-    const pledge = 10000n;
-    const minerFee = 1000n;
+const describeOrSkip = process.env.TESTS_USE_MOCKNET ? describe.skip : describe;
 
-    beforeAll(() => {
-      const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-      const addressType = 'p2sh20';
-      mecenas = new Contract(artifact, [alicePkh, bobPkh, pledge], { provider, addressType });
-      console.log(mecenas.address);
-    });
+describeOrSkip('v0.6.0 - Mecenas', () => {
+  let mecenas: Contract;
+  const pledge = 10000n;
+  const minerFee = 1000n;
+
+  beforeAll(() => {
+    const provider = new ElectrumNetworkProvider(Network.CHIPNET);
+    const addressType = 'p2sh20';
+    mecenas = new Contract(artifact, [alicePkh, bobPkh, pledge], { provider, addressType });
+    console.log(mecenas.address);
+  });
 
-    describe('send', () => {
-      it('should fail when trying to send more than pledge', async () => {
+  describe('send', () => {
+    it('should fail when trying to send more than pledge', async () => {
       // given
-        const to = aliceAddress;
-        const amount = pledge + 10n;
+      const to = aliceAddress;
+      const amount = pledge + 10n;
 
-        // when
-        const txPromise = mecenas.functions
-          .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-          .to(to, amount)
-          .withHardcodedFee(minerFee)
-          .send();
+      // when
+      const txPromise = mecenas.functions
+        .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
+        .to(to, amount)
+        .withHardcodedFee(minerFee)
+        .send();
 
-        // then
-        await expect(txPromise).rejects.toThrow(FailedTransactionError);
-        await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
-      });
+      // then
+      await expect(txPromise).rejects.toThrow(FailedTransactionError);
+      await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
+    });
 
-      it('should fail when trying to send to wrong person', async () => {
+    it('should fail when trying to send to wrong person', async () => {
       // given
-        const to = bobAddress;
-        const amount = pledge;
+      const to = bobAddress;
+      const amount = pledge;
 
-        // when
-        const txPromise = mecenas.functions
-          .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-          .to(to, amount)
-          .withHardcodedFee(minerFee)
-          .send();
+      // when
+      const txPromise = mecenas.functions
+        .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
+        .to(to, amount)
+        .withHardcodedFee(minerFee)
+        .send();
 
-        // then
-        await expect(txPromise).rejects.toThrow(FailedTransactionError);
-        await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
-      });
+      // then
+      await expect(txPromise).rejects.toThrow(FailedTransactionError);
+      await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
+    });
 
-      it('should fail when trying to send to multiple people', async () => {
+    it('should fail when trying to send to multiple people', async () => {
       // given
-        const to = aliceAddress;
-        const amount = pledge;
+      const to = aliceAddress;
+      const amount = pledge;
 
-        // when
-        const txPromise = mecenas.functions
-          .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-          .to(to, amount)
-          .to(to, amount)
-          .withHardcodedFee(minerFee)
-          .send();
+      // when
+      const txPromise = mecenas.functions
+        .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
+        .to(to, amount)
+        .to(to, amount)
+        .withHardcodedFee(minerFee)
+        .send();
 
-        // then
-        await expect(txPromise).rejects.toThrow(FailedTransactionError);
-        await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
-      });
+      // then
+      await expect(txPromise).rejects.toThrow(FailedTransactionError);
+      await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
+    });
 
-      it('should succeed when sending pledge to receiver', async () => {
+    it('should succeed when sending pledge to receiver', async () => {
       // given
-        const to = aliceAddress;
-        const amount = pledge;
+      const to = aliceAddress;
+      const amount = pledge;
 
-        // when
-        const tx = await mecenas.functions
-          .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-          .to(to, amount)
-          .withHardcodedFee(minerFee)
-          .send();
+      // when
+      const tx = await mecenas.functions
+        .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
+        .to(to, amount)
+        .withHardcodedFee(minerFee)
+        .send();
 
-        // then
-        const txOutputs = getTxOutputs(tx);
-        expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-      });
+      // then
+      const txOutputs = getTxOutputs(tx);
+      expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
     });
   });
-} else {
-  test.skip('skip', () => {});
-}
+});
diff --git a/packages/cashscript/test/e2e/old/misc.test.ts b/packages/cashscript/test/e2e/old/misc.test.ts
index 31f0b84d..b455d51a 100644
--- a/packages/cashscript/test/e2e/old/misc.test.ts
+++ b/packages/cashscript/test/e2e/old/misc.test.ts
@@ -16,57 +16,28 @@ import { getTxOutputs } from '../../test-util.js';
 import simpleCovenantArtifact from '../../fixture/old/simple_covenant.json' with { type: 'json' };
 import mecenasBorderArtifact from '../../fixture/old/mecenas_border.json' with { type: 'json' };
 
-if (!process.env.TESTS_USE_MOCKNET) {
-  describe('v0.6.0 - Simple Covenant', () => {
-    let covenant: Contract;
+const describeOrSkip = process.env.TESTS_USE_MOCKNET ? describe.skip : describe;
 
-    beforeAll(() => {
-      const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-      const addressType = 'p2sh20';
-      covenant = new Contract(simpleCovenantArtifact, [], { provider, addressType });
-      console.log(covenant.address);
-    });
-
-    describe('send', () => {
-      it('should succeed', async () => {
-      // given
-        const to = covenant.address;
-        const amount = 1000n;
+describeOrSkip('v0.6.0 - Simple Covenant', () => {
+  let covenant: Contract;
 
-        // when
-        const tx = await covenant.functions
-          .spend(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-          .to(to, amount)
-          .send();
-
-        // then
-        const txOutputs = getTxOutputs(tx);
-        expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-      });
-    });
+  beforeAll(() => {
+    const provider = new ElectrumNetworkProvider(Network.CHIPNET);
+    const addressType = 'p2sh20';
+    covenant = new Contract(simpleCovenantArtifact, [], { provider, addressType });
+    console.log(covenant.address);
   });
 
-  describe('v0.6.0 - Bytecode VarInt Border Mecenas', () => {
-    let mecenas: Contract;
-    const pledge = 10000n;
-
-    beforeAll(() => {
-      const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-      const addressType = 'p2sh20';
-      mecenas = new Contract(mecenasBorderArtifact, [alicePkh, bobPkh, pledge], { provider, addressType });
-      console.log(mecenas.address);
-    });
-
-    it('should succeed when sending pledge to receiver', async () => {
-    // given
-      const to = aliceAddress;
-      const amount = pledge;
+  describe('send', () => {
+    it('should succeed', async () => {
+      // given
+      const to = covenant.address;
+      const amount = 1000n;
 
       // when
-      const tx = await mecenas.functions
-        .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
+      const tx = await covenant.functions
+        .spend(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
         .to(to, amount)
-        .withHardcodedFee(1000n)
         .send();
 
       // then
@@ -74,6 +45,33 @@ if (!process.env.TESTS_USE_MOCKNET) {
       expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
     });
   });
-} else {
-  test.skip('skip', () => {});
-}
+});
+
+describe('v0.6.0 - Bytecode VarInt Border Mecenas', () => {
+  let mecenas: Contract;
+  const pledge = 10000n;
+
+  beforeAll(() => {
+    const provider = new ElectrumNetworkProvider(Network.CHIPNET);
+    const addressType = 'p2sh20';
+    mecenas = new Contract(mecenasBorderArtifact, [alicePkh, bobPkh, pledge], { provider, addressType });
+    console.log(mecenas.address);
+  });
+
+  it('should succeed when sending pledge to receiver', async () => {
+    // given
+    const to = aliceAddress;
+    const amount = pledge;
+
+    // when
+    const tx = await mecenas.functions
+      .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
+      .to(to, amount)
+      .withHardcodedFee(1000n)
+      .send();
+
+    // then
+    const txOutputs = getTxOutputs(tx);
+    expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
+  });
+});

From 4f47ba5c250e5f025fd18b17cd53fdf1ae9cb7db Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Tue, 21 Jan 2025 11:15:13 +0100
Subject: [PATCH 173/267] Remove old-style covenants from SDK (#259)

- Remove all old-style covenant functionality and tests
- Add semver check with minimum supported cashc version
---
 packages/cashc/package.json                   |   4 +-
 packages/cashscript/package.json              |   4 +-
 packages/cashscript/src/Contract.ts           |  23 ++--
 packages/cashscript/src/Transaction.ts        |  18 +--
 packages/cashscript/src/utils.ts              |  14 +--
 packages/cashscript/test/Contract.test.ts     |   9 ++
 .../cashscript/test/e2e/old/Mecenas.test.ts   | 104 ------------------
 packages/cashscript/test/e2e/old/misc.test.ts |  77 -------------
 .../mecenas-v0.6.0.cash}                      |   0
 .../fixture/deprecated/mecenas-v0.6.0.json    |  54 +++++++++
 .../cashscript/test/fixture/old/mecenas.json  |  54 ---------
 .../test/fixture/old/mecenas_border.cash      |  57 ----------
 .../test/fixture/old/mecenas_border.json      |  54 ---------
 .../test/fixture/old/simple_covenant.cash     |   6 -
 .../test/fixture/old/simple_covenant.json     |  27 -----
 packages/cashscript/test/util.test.ts         |  30 +----
 packages/utils/src/artifact.ts                |   1 -
 packages/utils/src/script.ts                  |  44 +-------
 packages/utils/test/script.fixture.ts         |  45 --------
 packages/utils/test/script.test.ts            |   3 -
 website/docs/releases/release-notes.md        |   3 +-
 website/docs/sdk/signature-templates.md       |   4 -
 yarn.lock                                     |   4 +-
 23 files changed, 91 insertions(+), 548 deletions(-)
 delete mode 100644 packages/cashscript/test/e2e/old/Mecenas.test.ts
 delete mode 100644 packages/cashscript/test/e2e/old/misc.test.ts
 rename packages/cashscript/test/fixture/{old/mecenas.cash => deprecated/mecenas-v0.6.0.cash} (100%)
 create mode 100644 packages/cashscript/test/fixture/deprecated/mecenas-v0.6.0.json
 delete mode 100644 packages/cashscript/test/fixture/old/mecenas.json
 delete mode 100644 packages/cashscript/test/fixture/old/mecenas_border.cash
 delete mode 100644 packages/cashscript/test/fixture/old/mecenas_border.json
 delete mode 100644 packages/cashscript/test/fixture/old/simple_covenant.cash
 delete mode 100644 packages/cashscript/test/fixture/old/simple_covenant.json

diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 5648a24e..61834bb7 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -53,12 +53,12 @@
     "@cashscript/utils": "^0.11.0-next.0",
     "antlr4": "^4.13.1-patch-1",
     "commander": "^7.1.0",
-    "semver": "^7.5.4"
+    "semver": "^7.6.3"
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
     "@types/node": "^18.11.18",
-    "@types/semver": "^7.3.4",
+    "@types/semver": "^7.5.8",
     "cpy-cli": "^4.2.0",
     "eslint": "^8.54.0",
     "jest": "^29.4.1",
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 623e664a..36240975 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -49,12 +49,14 @@
     "delay": "^5.0.0",
     "electrum-cash": "^2.0.10",
     "fast-deep-equal": "^3.1.3",
-    "pako": "^2.1.0"
+    "pako": "^2.1.0",
+    "semver": "^7.6.3"
   },
   "devDependencies": {
     "@jest/globals": "^29.4.1",
     "@psf/bch-js": "^6.8.0",
     "@types/pako": "^2.0.3",
+    "@types/semver": "^7.5.8",
     "eslint": "^8.54.0",
     "jest": "^29.4.1",
     "typescript": "^5.5.4"
diff --git a/packages/cashscript/src/Contract.ts b/packages/cashscript/src/Contract.ts
index dfe428fd..4874a329 100644
--- a/packages/cashscript/src/Contract.ts
+++ b/packages/cashscript/src/Contract.ts
@@ -25,6 +25,7 @@ import {
 import SignatureTemplate from './SignatureTemplate.js';
 import { ElectrumNetworkProvider } from './network/index.js';
 import { ParamsToTuple, AbiToFunctionMap } from './types/type-inference.js';
+import semver from 'semver';
 
 export class Contract<
   TArtifact extends Artifact = Artifact,
@@ -62,11 +63,15 @@ export class Contract<
     this.provider = this.options?.provider ?? new ElectrumNetworkProvider();
     this.addressType = this.options?.addressType ?? 'p2sh32';
 
-    const expectedProperties = ['abi', 'bytecode', 'constructorInputs', 'contractName'];
+    const expectedProperties = ['abi', 'bytecode', 'constructorInputs', 'contractName', 'compiler'];
     if (!expectedProperties.every((property) => property in artifact)) {
       throw new Error('Invalid or incomplete artifact provided');
     }
 
+    if (!semver.satisfies(artifact.compiler.version, '>=0.7.0', { includePrerelease: true })) {
+      throw new Error(`Artifact compiled with unsupported compiler version: ${artifact.compiler.version}, required >=0.7.0`);
+    }
+
     if (artifact.constructorInputs.length !== constructorArgs.length) {
       throw new Error(`Incorrect number of arguments passed to ${artifact.contractName} constructor. Expected ${artifact.constructorInputs.length} arguments (${artifact.constructorInputs.map((input) => input.type)}) but got ${constructorArgs.length}`);
     }
@@ -156,28 +161,16 @@ export class Contract<
       const generateUnlockingBytecode = (
         { transaction, sourceOutputs, inputIndex }: GenerateUnlockingBytecodeOptions,
       ): Uint8Array => {
-        // TODO: Remove old-style covenant code for v1.0 release
-        let covenantHashType = -1;
         const completeArgs = encodedArgs.map((arg) => {
           if (!(arg instanceof SignatureTemplate)) return arg;
 
-          // First signature is used for sighash preimage (maybe not the best way)
-          if (covenantHashType < 0) covenantHashType = arg.getHashType();
-
+          // Generate transaction signature from SignatureTemplate
           const preimage = createSighashPreimage(transaction, sourceOutputs, inputIndex, bytecode, arg.getHashType());
           const sighash = hash256(preimage);
-
           return arg.generateSignature(sighash);
         });
 
-        const preimage = abiFunction.covenant
-          ? createSighashPreimage(transaction, sourceOutputs, inputIndex, bytecode, covenantHashType)
-          : undefined;
-
-        const unlockingBytecode = createInputScript(
-          this.redeemScript, completeArgs, selector, preimage,
-        );
-
+        const unlockingBytecode = createInputScript(this.redeemScript, completeArgs, selector);
         return unlockingBytecode;
       };
 
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index f5c78fec..5db4850a 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -9,7 +9,6 @@ import {
   AbiFunction,
   encodeBip68,
   placeholder,
-  scriptToBytecode,
 } from '@cashscript/utils';
 import deepEqual from 'fast-deep-equal';
 import {
@@ -28,7 +27,6 @@ import {
   getInputSize,
   createOpReturnOutput,
   getTxSizeWithoutInputs,
-  getPreimageSize,
   validateOutput,
   utxoComparator,
   calculateDust,
@@ -61,7 +59,7 @@ export class Transaction {
     public abiFunction: AbiFunction,
     public encodedFunctionArgs: EncodedFunctionArgument[],
     private selector?: number,
-  ) {}
+  ) { }
 
   from(input: Utxo): this;
   from(inputs: Utxo[]): this;
@@ -175,10 +173,7 @@ export class Transaction {
     const tx = await this.build();
 
     // Debug the transaction locally before sending so any errors are caught early
-    // Libauth debugging does not work with old-style covenants
-    if (!this.abiFunction.covenant) {
-      await this.debug();
-    }
+    await this.debug();
 
     try {
       const txid = await this.contract.provider.sendRawTransaction(tx);
@@ -350,18 +345,11 @@ export class Transaction {
       return placeholder(73);
     });
 
-    // Create a placeholder preimage of the correct size
-    const placeholderPreimage = this.abiFunction.covenant
-      ? placeholder(getPreimageSize(scriptToBytecode(this.contract.redeemScript)))
-      : undefined;
-
-    // Create a placeholder input script for size calculation using the placeholder
-    // arguments and correctly sized placeholder preimage
+    // Create a placeholder input script for size calculation using the placeholder arguments
     const placeholderScript = createInputScript(
       this.contract.redeemScript,
       placeholderArgs,
       this.selector,
-      placeholderPreimage,
     );
 
     // Add one extra byte per input to over-estimate tx-in count
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index 0cbddf65..8cdd0ea5 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -5,7 +5,7 @@ import {
   lockingBytecodeToCashAddress,
   binToHex,
   Transaction,
-  generateSigningSerializationBCH,
+  generateSigningSerializationBch,
   utf8ToBin,
   hexToBin,
   flattenBinArray,
@@ -125,12 +125,6 @@ export function getInputSize(inputScript: Uint8Array): number {
   return 32 + 4 + varIntSize + scriptSize + 4;
 }
 
-export function getPreimageSize(script: Uint8Array): number {
-  const scriptSize = script.byteLength;
-  const varIntSize = scriptSize > 252 ? 3 : 1;
-  return 4 + 32 + 32 + 36 + varIntSize + scriptSize + 8 + 4 + 32 + 4 + 4;
-}
-
 export function getTxSizeWithoutInputs(outputs: Output[]): number {
   // Transaction format:
   // Version (4 Bytes)
@@ -160,11 +154,9 @@ export function createInputScript(
   redeemScript: Script,
   encodedArgs: Uint8Array[],
   selector?: number,
-  preimage?: Uint8Array,
 ): Uint8Array {
-  // Create unlock script / redeemScriptSig (add potential preimage and selector)
+  // Create unlock script / redeemScriptSig (add potential selector)
   const unlockScript = [...encodedArgs].reverse();
-  if (preimage !== undefined) unlockScript.push(preimage);
   if (selector !== undefined) unlockScript.push(encodeInt(BigInt(selector)));
 
   // Create input script and compile it to bytecode
@@ -199,7 +191,7 @@ export function createSighashPreimage(
   const context = { inputIndex, sourceOutputs, transaction };
   const signingSerializationType = new Uint8Array([hashtype]);
 
-  const sighashPreimage = generateSigningSerializationBCH(context, { coveredBytecode, signingSerializationType });
+  const sighashPreimage = generateSigningSerializationBch(context, { coveredBytecode, signingSerializationType });
 
   return sighashPreimage;
 }
diff --git a/packages/cashscript/test/Contract.test.ts b/packages/cashscript/test/Contract.test.ts
index 142fec38..14e595b6 100644
--- a/packages/cashscript/test/Contract.test.ts
+++ b/packages/cashscript/test/Contract.test.ts
@@ -15,6 +15,7 @@ import p2pkhArtifact from './fixture/p2pkh.json' with { type: 'json' };
 import twtArtifact from './fixture/transfer_with_timeout.json' with { type: 'json' };
 import hodlVaultArtifact from './fixture/hodl_vault.json' with { type: 'json' };
 import mecenasArtifact from './fixture/mecenas.json' with { type: 'json' };
+import deprecatedMecenasArtifact from './fixture/deprecated/mecenas-v0.6.0.json' with { type: 'json' };
 import boundedBytesArtifact from './fixture/bounded_bytes.json' with { type: 'json' };
 
 describe('Contract', () => {
@@ -31,6 +32,14 @@ describe('Contract', () => {
       expect(() => new Contract(p2pkhArtifact, [placeholder(21)], { provider })).toThrow();
     });
 
+    it('should fail with artifact compiled with unsupported compiler version', async () => {
+      const provider = new ElectrumNetworkProvider(Network.CHIPNET);
+      const constructorArgs = [placeholder(20), placeholder(20), 1000000n];
+
+      expect(() => new Contract(deprecatedMecenasArtifact, constructorArgs, { provider }))
+        .toThrow(/unsupported compiler version/);
+    });
+
     it('should fail with incomplete artifact', () => {
       const provider = new ElectrumNetworkProvider(Network.CHIPNET);
 
diff --git a/packages/cashscript/test/e2e/old/Mecenas.test.ts b/packages/cashscript/test/e2e/old/Mecenas.test.ts
deleted file mode 100644
index 9451d24c..00000000
--- a/packages/cashscript/test/e2e/old/Mecenas.test.ts
+++ /dev/null
@@ -1,104 +0,0 @@
-import {
-  Contract,
-  SignatureTemplate,
-  ElectrumNetworkProvider,
-  Network,
-  HashType,
-} from '../../../src/index.js';
-import {
-  alicePkh,
-  bobPkh,
-  aliceAddress,
-  bobAddress,
-  alicePub,
-  alicePriv,
-} from '../../fixture/vars.js';
-import { getTxOutputs } from '../../test-util.js';
-import { FailedTransactionError } from '../../../src/Errors.js';
-import artifact from '../../fixture/old/mecenas.json' with { type: 'json' };
-
-const describeOrSkip = process.env.TESTS_USE_MOCKNET ? describe.skip : describe;
-
-describeOrSkip('v0.6.0 - Mecenas', () => {
-  let mecenas: Contract;
-  const pledge = 10000n;
-  const minerFee = 1000n;
-
-  beforeAll(() => {
-    const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-    const addressType = 'p2sh20';
-    mecenas = new Contract(artifact, [alicePkh, bobPkh, pledge], { provider, addressType });
-    console.log(mecenas.address);
-  });
-
-  describe('send', () => {
-    it('should fail when trying to send more than pledge', async () => {
-      // given
-      const to = aliceAddress;
-      const amount = pledge + 10n;
-
-      // when
-      const txPromise = mecenas.functions
-        .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-        .to(to, amount)
-        .withHardcodedFee(minerFee)
-        .send();
-
-      // then
-      await expect(txPromise).rejects.toThrow(FailedTransactionError);
-      await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
-    });
-
-    it('should fail when trying to send to wrong person', async () => {
-      // given
-      const to = bobAddress;
-      const amount = pledge;
-
-      // when
-      const txPromise = mecenas.functions
-        .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-        .to(to, amount)
-        .withHardcodedFee(minerFee)
-        .send();
-
-      // then
-      await expect(txPromise).rejects.toThrow(FailedTransactionError);
-      await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
-    });
-
-    it('should fail when trying to send to multiple people', async () => {
-      // given
-      const to = aliceAddress;
-      const amount = pledge;
-
-      // when
-      const txPromise = mecenas.functions
-        .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-        .to(to, amount)
-        .to(to, amount)
-        .withHardcodedFee(minerFee)
-        .send();
-
-      // then
-      await expect(txPromise).rejects.toThrow(FailedTransactionError);
-      await expect(txPromise).rejects.toThrow('Script failed an OP_EQUALVERIFY operation');
-    });
-
-    it('should succeed when sending pledge to receiver', async () => {
-      // given
-      const to = aliceAddress;
-      const amount = pledge;
-
-      // when
-      const tx = await mecenas.functions
-        .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-        .to(to, amount)
-        .withHardcodedFee(minerFee)
-        .send();
-
-      // then
-      const txOutputs = getTxOutputs(tx);
-      expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-    });
-  });
-});
diff --git a/packages/cashscript/test/e2e/old/misc.test.ts b/packages/cashscript/test/e2e/old/misc.test.ts
deleted file mode 100644
index b455d51a..00000000
--- a/packages/cashscript/test/e2e/old/misc.test.ts
+++ /dev/null
@@ -1,77 +0,0 @@
-import {
-  Contract,
-  SignatureTemplate,
-  ElectrumNetworkProvider,
-  Network,
-  HashType,
-} from '../../../src/index.js';
-import {
-  alicePkh,
-  bobPkh,
-  aliceAddress,
-  alicePub,
-  alicePriv,
-} from '../../fixture/vars.js';
-import { getTxOutputs } from '../../test-util.js';
-import simpleCovenantArtifact from '../../fixture/old/simple_covenant.json' with { type: 'json' };
-import mecenasBorderArtifact from '../../fixture/old/mecenas_border.json' with { type: 'json' };
-
-const describeOrSkip = process.env.TESTS_USE_MOCKNET ? describe.skip : describe;
-
-describeOrSkip('v0.6.0 - Simple Covenant', () => {
-  let covenant: Contract;
-
-  beforeAll(() => {
-    const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-    const addressType = 'p2sh20';
-    covenant = new Contract(simpleCovenantArtifact, [], { provider, addressType });
-    console.log(covenant.address);
-  });
-
-  describe('send', () => {
-    it('should succeed', async () => {
-      // given
-      const to = covenant.address;
-      const amount = 1000n;
-
-      // when
-      const tx = await covenant.functions
-        .spend(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-        .to(to, amount)
-        .send();
-
-      // then
-      const txOutputs = getTxOutputs(tx);
-      expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-    });
-  });
-});
-
-describe('v0.6.0 - Bytecode VarInt Border Mecenas', () => {
-  let mecenas: Contract;
-  const pledge = 10000n;
-
-  beforeAll(() => {
-    const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-    const addressType = 'p2sh20';
-    mecenas = new Contract(mecenasBorderArtifact, [alicePkh, bobPkh, pledge], { provider, addressType });
-    console.log(mecenas.address);
-  });
-
-  it('should succeed when sending pledge to receiver', async () => {
-    // given
-    const to = aliceAddress;
-    const amount = pledge;
-
-    // when
-    const tx = await mecenas.functions
-      .receive(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_ALL))
-      .to(to, amount)
-      .withHardcodedFee(1000n)
-      .send();
-
-    // then
-    const txOutputs = getTxOutputs(tx);
-    expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-  });
-});
diff --git a/packages/cashscript/test/fixture/old/mecenas.cash b/packages/cashscript/test/fixture/deprecated/mecenas-v0.6.0.cash
similarity index 100%
rename from packages/cashscript/test/fixture/old/mecenas.cash
rename to packages/cashscript/test/fixture/deprecated/mecenas-v0.6.0.cash
diff --git a/packages/cashscript/test/fixture/deprecated/mecenas-v0.6.0.json b/packages/cashscript/test/fixture/deprecated/mecenas-v0.6.0.json
new file mode 100644
index 00000000..d6ebc22d
--- /dev/null
+++ b/packages/cashscript/test/fixture/deprecated/mecenas-v0.6.0.json
@@ -0,0 +1,54 @@
+{
+    "contractName": "Mecenas",
+    "constructorInputs": [
+        {
+            "name": "recipient",
+            "type": "bytes20"
+        },
+        {
+            "name": "funder",
+            "type": "bytes20"
+        },
+        {
+            "name": "pledge",
+            "type": "int"
+        }
+    ],
+    "abi": [
+        {
+            "name": "receive",
+            "covenant": true,
+            "inputs": [
+                {
+                    "name": "pk",
+                    "type": "pubkey"
+                },
+                {
+                    "name": "s",
+                    "type": "sig"
+                }
+            ]
+        },
+        {
+            "name": "reclaim",
+            "covenant": false,
+            "inputs": [
+                {
+                    "name": "pk",
+                    "type": "pubkey"
+                },
+                {
+                    "name": "s",
+                    "type": "sig"
+                }
+            ]
+        }
+    ],
+    "bytecode": "OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_PICK OP_NOP 68 OP_SPLIT OP_NIP OP_SIZE 34 OP_SUB OP_SPLIT OP_8 OP_SPLIT OP_4 OP_SPLIT OP_NIP 20 OP_SPLIT OP_DROP OP_9 OP_ROLL OP_9 OP_ROLL OP_2DUP OP_SWAP OP_SIZE OP_1SUB OP_SPLIT OP_DROP OP_11 OP_ROLL OP_SHA256 OP_ROT OP_CHECKDATASIGVERIFY OP_CHECKSIGVERIFY e803 OP_ROT OP_BIN2NUM OP_DUP OP_7 OP_PICK OP_3 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_2DUP OP_SWAP OP_SUB OP_8 OP_NUM2BIN OP_DUP 1976a914 OP_CAT OP_6 OP_PICK OP_CAT 88ac OP_CAT OP_DUP OP_HASH256 OP_5 OP_PICK OP_EQUALVERIFY OP_2DROP OP_ELSE OP_6 OP_PICK OP_8 OP_NUM2BIN OP_OVER OP_8 OP_PICK OP_SUB OP_3 OP_PICK OP_SUB OP_8 OP_NUM2BIN OP_OVER 1976a914 OP_CAT OP_7 OP_PICK OP_CAT 88ac OP_CAT OP_OVER 17a914 OP_CAT OP_7 OP_PICK OP_HASH160 OP_CAT 87 OP_CAT OP_2DUP OP_CAT OP_HASH256 OP_7 OP_PICK OP_EQUALVERIFY OP_2DROP OP_2DROP OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF",
+    "source": "/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period*/) {\n    function receive(pubkey pk, sig s) {\n        require(checkSig(s, pk));\n\n        // require(tx.age >= period);\n\n        int minerFee = 1000;\n        int intValue = int(bytes(tx.value));\n\n        if (intValue <= pledge + minerFee) {\n            bytes8 amount1 = bytes8(intValue - minerFee);\n            bytes34 out1 = new OutputP2PKH(amount1, recipient);\n            require(hash256(out1) == tx.hashOutputs);\n        } else {\n            bytes8 amount1 = bytes8(pledge);\n            bytes8 amount2 = bytes8(intValue - pledge - minerFee);\n            bytes34 out1 = new OutputP2PKH(amount1, recipient);\n            bytes32 out2 = new OutputP2SH(amount2, hash160(tx.bytecode));\n            require(hash256(out1 + out2) == tx.hashOutputs);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
+    "compiler": {
+        "name": "cashc",
+        "version": "0.6.5"
+    },
+    "updatedAt": "2021-10-12T16:23:17.026Z"
+}
diff --git a/packages/cashscript/test/fixture/old/mecenas.json b/packages/cashscript/test/fixture/old/mecenas.json
deleted file mode 100644
index e201a05d..00000000
--- a/packages/cashscript/test/fixture/old/mecenas.json
+++ /dev/null
@@ -1,54 +0,0 @@
-{
-  "contractName": "Mecenas",
-  "constructorInputs": [
-    {
-      "name": "recipient",
-      "type": "bytes20"
-    },
-    {
-      "name": "funder",
-      "type": "bytes20"
-    },
-    {
-      "name": "pledge",
-      "type": "int"
-    }
-  ],
-  "abi": [
-    {
-      "name": "receive",
-      "covenant": true,
-      "inputs": [
-        {
-          "name": "pk",
-          "type": "pubkey"
-        },
-        {
-          "name": "s",
-          "type": "sig"
-        }
-      ]
-    },
-    {
-      "name": "reclaim",
-      "covenant": false,
-      "inputs": [
-        {
-          "name": "pk",
-          "type": "pubkey"
-        },
-        {
-          "name": "s",
-          "type": "sig"
-        }
-      ]
-    }
-  ],
-  "bytecode": "OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_PICK OP_NOP 68 OP_SPLIT OP_NIP OP_SIZE 34 OP_SUB OP_SPLIT OP_8 OP_SPLIT OP_4 OP_SPLIT OP_NIP 20 OP_SPLIT OP_DROP OP_9 OP_ROLL OP_9 OP_ROLL OP_2DUP OP_SWAP OP_SIZE OP_1SUB OP_SPLIT OP_DROP OP_11 OP_ROLL OP_SHA256 OP_ROT OP_CHECKDATASIGVERIFY OP_CHECKSIGVERIFY e803 OP_ROT OP_BIN2NUM OP_DUP OP_7 OP_PICK OP_3 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_2DUP OP_SWAP OP_SUB OP_8 OP_NUM2BIN OP_DUP 1976a914 OP_CAT OP_6 OP_PICK OP_CAT 88ac OP_CAT OP_DUP OP_HASH256 OP_5 OP_PICK OP_EQUALVERIFY OP_2DROP OP_ELSE OP_6 OP_PICK OP_8 OP_NUM2BIN OP_OVER OP_8 OP_PICK OP_SUB OP_3 OP_PICK OP_SUB OP_8 OP_NUM2BIN OP_OVER 1976a914 OP_CAT OP_7 OP_PICK OP_CAT 88ac OP_CAT OP_OVER 17a914 OP_CAT OP_7 OP_PICK OP_HASH160 OP_CAT 87 OP_CAT OP_2DUP OP_CAT OP_HASH256 OP_7 OP_PICK OP_EQUALVERIFY OP_2DROP OP_2DROP OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF",
-  "source": "/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period*/) {\n    function receive(pubkey pk, sig s) {\n        require(checkSig(s, pk));\n\n        // require(tx.age >= period);\n\n        int minerFee = 1000;\n        int intValue = int(bytes(tx.value));\n\n        if (intValue <= pledge + minerFee) {\n            bytes8 amount1 = bytes8(intValue - minerFee);\n            bytes34 out1 = new OutputP2PKH(amount1, recipient);\n            require(hash256(out1) == tx.hashOutputs);\n        } else {\n            bytes8 amount1 = bytes8(pledge);\n            bytes8 amount2 = bytes8(intValue - pledge - minerFee);\n            bytes34 out1 = new OutputP2PKH(amount1, recipient);\n            bytes32 out2 = new OutputP2SH(amount2, hash160(tx.bytecode));\n            require(hash256(out1 + out2) == tx.hashOutputs);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
-  "compiler": {
-    "name": "cashc",
-    "version": "0.6.5"
-  },
-  "updatedAt": "2021-10-12T16:23:17.026Z"
-}
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/old/mecenas_border.cash b/packages/cashscript/test/fixture/old/mecenas_border.cash
deleted file mode 100644
index aeb02409..00000000
--- a/packages/cashscript/test/fixture/old/mecenas_border.cash
+++ /dev/null
@@ -1,57 +0,0 @@
-/* This is an unofficial CashScript port of Licho's Mecenas contract. It is
- * not compatible with Licho's EC plugin, but rather meant as a demonstration
- * of covenants in CashScript.
- * The time checking has been removed so it can be tested without time requirements.
- */
-contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period*/) {
-    function receive(pubkey pk, sig s) {
-        require(checkSig(s, pk));
-
-        // require(tx.age >= period);
-
-        int minerFee = 1000;
-        int intValue = int(bytes(tx.value));
-
-        if (intValue <= pledge + minerFee) {
-            /* The contract has less value than the pledge, or equal.
-             * The recipient must claim all of of it. */
-
-            bytes8 amount1 = bytes8(intValue - minerFee);
-            bytes34 out1 = new OutputP2PKH(amount1, recipient);
-            require(hash256(out1) == tx.hashOutputs);
-        } else {
-            /* The contract has more value than the pledge. The recipient must
-             * also add one change output sending the remaining coins back
-             * to the contract.
-             */
-
-            bytes8 amount1 = bytes8(pledge);
-            bytes8 amount2 = bytes8(intValue - pledge - minerFee);
-            bytes34 out1 = new OutputP2PKH(amount1, recipient);
-            bytes32 out2 = new OutputP2SH(amount2, hash160(tx.bytecode));
-            require(hash256(out1 + out2) == tx.hashOutputs);
-        }
-    }
-
-    function reclaim(pubkey pk, sig s) {
-        // This is a bunch of useless statements to fill up space so that we can
-        // test the border between a 1byte and 3byte bytecode VarInt
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-        require(1 == 1);
-
-        require(hash160(pk) == funder);
-        require(checkSig(s, pk));
-    }
-}
diff --git a/packages/cashscript/test/fixture/old/mecenas_border.json b/packages/cashscript/test/fixture/old/mecenas_border.json
deleted file mode 100644
index b42bea79..00000000
--- a/packages/cashscript/test/fixture/old/mecenas_border.json
+++ /dev/null
@@ -1,54 +0,0 @@
-{
-  "contractName": "Mecenas",
-  "constructorInputs": [
-    {
-      "name": "recipient",
-      "type": "bytes20"
-    },
-    {
-      "name": "funder",
-      "type": "bytes20"
-    },
-    {
-      "name": "pledge",
-      "type": "int"
-    }
-  ],
-  "abi": [
-    {
-      "name": "receive",
-      "covenant": true,
-      "inputs": [
-        {
-          "name": "pk",
-          "type": "pubkey"
-        },
-        {
-          "name": "s",
-          "type": "sig"
-        }
-      ]
-    },
-    {
-      "name": "reclaim",
-      "covenant": false,
-      "inputs": [
-        {
-          "name": "pk",
-          "type": "pubkey"
-        },
-        {
-          "name": "s",
-          "type": "sig"
-        }
-      ]
-    }
-  ],
-  "bytecode": "OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_PICK OP_NOP 68 OP_SPLIT OP_NIP OP_SIZE 34 OP_SUB OP_SPLIT OP_8 OP_SPLIT OP_4 OP_SPLIT OP_NIP 20 OP_SPLIT OP_DROP OP_9 OP_ROLL OP_9 OP_ROLL OP_2DUP OP_SWAP OP_SIZE OP_1SUB OP_SPLIT OP_DROP OP_11 OP_ROLL OP_SHA256 OP_ROT OP_CHECKDATASIGVERIFY OP_CHECKSIGVERIFY e803 OP_ROT OP_BIN2NUM OP_DUP OP_7 OP_PICK OP_3 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_2DUP OP_SWAP OP_SUB OP_8 OP_NUM2BIN OP_DUP 1976a914 OP_CAT OP_6 OP_PICK OP_CAT 88ac OP_CAT OP_DUP OP_HASH256 OP_5 OP_PICK OP_EQUALVERIFY OP_2DROP OP_ELSE OP_6 OP_PICK OP_8 OP_NUM2BIN OP_OVER OP_8 OP_PICK OP_SUB OP_3 OP_PICK OP_SUB OP_8 OP_NUM2BIN OP_OVER 1976a914 OP_CAT OP_7 OP_PICK OP_CAT 88ac OP_CAT OP_OVER 17a914 OP_CAT OP_7 OP_PICK OP_HASH160 OP_CAT 87 OP_CAT OP_2DUP OP_CAT OP_HASH256 OP_7 OP_PICK OP_EQUALVERIFY OP_2DROP OP_2DROP OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_1 OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF",
-  "source": "/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period*/) {\n    function receive(pubkey pk, sig s) {\n        require(checkSig(s, pk));\n\n        // require(tx.age >= period);\n\n        int minerFee = 1000;\n        int intValue = int(bytes(tx.value));\n\n        if (intValue <= pledge + minerFee) {\n            /* The contract has less value than the pledge, or equal.\n             * The recipient must claim all of of it. */\n\n            bytes8 amount1 = bytes8(intValue - minerFee);\n            bytes34 out1 = new OutputP2PKH(amount1, recipient);\n            require(hash256(out1) == tx.hashOutputs);\n        } else {\n            /* The contract has more value than the pledge. The recipient must\n             * also add one change output sending the remaining coins back\n             * to the contract.\n             */\n\n            bytes8 amount1 = bytes8(pledge);\n            bytes8 amount2 = bytes8(intValue - pledge - minerFee);\n            bytes34 out1 = new OutputP2PKH(amount1, recipient);\n            bytes32 out2 = new OutputP2SH(amount2, hash160(tx.bytecode));\n            require(hash256(out1 + out2) == tx.hashOutputs);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        // This is a bunch of useless statements to fill up space so that we can\n        // test the border between a 1byte and 3byte bytecode VarInt\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n        require(1 == 1);\n\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
-  "compiler": {
-    "name": "cashc",
-    "version": "0.6.5"
-  },
-  "updatedAt": "2021-10-12T16:23:15.174Z"
-}
diff --git a/packages/cashscript/test/fixture/old/simple_covenant.cash b/packages/cashscript/test/fixture/old/simple_covenant.cash
deleted file mode 100644
index 732e21f3..00000000
--- a/packages/cashscript/test/fixture/old/simple_covenant.cash
+++ /dev/null
@@ -1,6 +0,0 @@
-contract Covenant() {
-    function spend(pubkey pk, sig s) {
-        require(checkSig(s, pk));
-        require(int(tx.version) >= 2);
-    }
-}
diff --git a/packages/cashscript/test/fixture/old/simple_covenant.json b/packages/cashscript/test/fixture/old/simple_covenant.json
deleted file mode 100644
index 3fd3a775..00000000
--- a/packages/cashscript/test/fixture/old/simple_covenant.json
+++ /dev/null
@@ -1,27 +0,0 @@
-{
-  "contractName": "Covenant",
-  "constructorInputs": [],
-  "abi": [
-    {
-      "name": "spend",
-      "covenant": true,
-      "inputs": [
-        {
-          "name": "pk",
-          "type": "pubkey"
-        },
-        {
-          "name": "s",
-          "type": "sig"
-        }
-      ]
-    }
-  ],
-  "bytecode": "OP_DUP OP_4 OP_SPLIT OP_DROP OP_2SWAP OP_2DUP OP_SWAP OP_SIZE OP_1SUB OP_SPLIT OP_DROP OP_5 OP_ROLL OP_SHA256 OP_ROT OP_CHECKDATASIGVERIFY OP_CHECKSIGVERIFY OP_BIN2NUM OP_2 OP_GREATERTHANOREQUAL",
-  "source": "contract Covenant() {\n    function spend(pubkey pk, sig s) {\n        require(checkSig(s, pk));\n        require(int(tx.version) >= 2);\n    }\n}\n",
-  "compiler": {
-    "name": "cashc",
-    "version": "0.6.5"
-  },
-  "updatedAt": "2021-10-12T16:23:16.046Z"
-}
\ No newline at end of file
diff --git a/packages/cashscript/test/util.test.ts b/packages/cashscript/test/util.test.ts
index de4f7611..88d88196 100644
--- a/packages/cashscript/test/util.test.ts
+++ b/packages/cashscript/test/util.test.ts
@@ -9,7 +9,6 @@ import {
   scriptToAddress,
   createInputScript,
   getInputSize,
-  getPreimageSize,
 } from '../src/utils.js';
 import { Network } from '../src/interfaces.js';
 import { alicePkh, alicePub } from './fixture/vars.js';
@@ -35,28 +34,8 @@ describe('utils', () => {
     });
   });
 
-  describe('getPreimageSize', () => {
-    it('should calculate preimage size for small script', () => {
-      const inputScript = new Uint8Array(100).fill(0);
-
-      const size = getPreimageSize(inputScript);
-
-      const expectedSize = 100 + 156 + 1;
-      expect(size).toEqual(expectedSize);
-    });
-
-    it('should calculate preimage size for large script', () => {
-      const inputScript = new Uint8Array(255).fill(0);
-
-      const size = getPreimageSize(inputScript);
-
-      const expectedSize = 255 + 156 + 3;
-      expect(size).toEqual(expectedSize);
-    });
-  });
-
   describe('createInputScript', () => {
-    it('should create an input script without selector or preimage', () => {
+    it('should create an input script without selector', () => {
       const asm = `${binToHex(alicePkh)} OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG`;
       const redeemScript = asmToScript(asm);
       const args = [alicePub, placeholder(1)];
@@ -67,16 +46,15 @@ describe('utils', () => {
       expect(bytecodeToAsm(inputScript)).toEqual(expectedInputScriptAsm);
     });
 
-    it('should create an input script with selector and preimage', () => {
+    it('should create an input script with selector', () => {
       const asm = `${binToHex(alicePkh)} OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG`;
       const redeemScript = asmToScript(asm);
       const args = [alicePub, placeholder(1)];
       const selector = 1;
-      const preimage = placeholder(1);
 
-      const inputScript = createInputScript(redeemScript, args, selector, preimage);
+      const inputScript = createInputScript(redeemScript, args, selector);
 
-      const expectedInputScriptAsm = `00 ${binToHex(alicePub)} 00 OP_1 ${binToHex(asmToBytecode(asm))}`;
+      const expectedInputScriptAsm = `00 ${binToHex(alicePub)} OP_1 ${binToHex(asmToBytecode(asm))}`;
       expect(bytecodeToAsm(inputScript)).toEqual(expectedInputScriptAsm);
     });
   });
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index 5ab0f86f..ab3b99ac 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -7,7 +7,6 @@ export interface AbiInput {
 
 export interface AbiFunction {
   name: string;
-  covenant?: boolean;
   inputs: readonly AbiInput[];
 }
 
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index 111a723c..5204a528 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -7,7 +7,6 @@ import {
   encodeAuthenticationInstructions,
   decodeAuthenticationInstructions,
 } from '@bitauth/libauth';
-import { decodeInt, encodeInt } from './data.js';
 import OptimisationsEquivFile from './cashproof-optimisations.js';
 
 export const Op = OpcodesBch2023;
@@ -142,49 +141,8 @@ function getPushDataOpcode(data: Uint8Array): Uint8Array {
   throw Error('Pushdata too large');
 }
 
-/**
- * When cutting out the tx.bytecode preimage variable, the compiler does not know
- * the size of the final redeem scrip yet, because the constructor parameters still
- * need to get added. Because of this it does not know whether the VarInt is 1 or 3
- * bytes. During compilation, an OP_NOP is added at the spot where the bytecode is
- * cut out. This function replaces that OP_NOP and adds either 1 or 3 to the cut to
- * additionally cut off the VarInt.
- *
- * @param script incomplete redeem script
- * @returns completed redeem script
- */
-export function replaceBytecodeNop(script: Script): Script {
-  const index = script.findIndex((op) => op === Op.OP_NOP);
-  if (index < 0) return script;
-
-  // Remove the OP_NOP
-  script.splice(index, 1);
-
-  // Retrieve size of current OP_SPLIT
-  let oldCut = script[index];
-  if (oldCut instanceof Uint8Array) {
-    oldCut = Number(decodeInt(oldCut));
-  } else if (oldCut === Op.OP_0) {
-    oldCut = 0;
-  } else if (oldCut >= Op.OP_1 && oldCut <= Op.OP_16) {
-    oldCut -= 80;
-  } else {
-    return script;
-  }
-
-  // Update the old OP_SPLIT by adding either 1 or 3 to it
-  script[index] = encodeInt(BigInt(oldCut + 1));
-  const bytecodeSize = calculateBytesize(script);
-  if (bytecodeSize > 252) {
-    script[index] = encodeInt(BigInt(oldCut + 3));
-  }
-
-  // Minimally encode
-  return asmToScript(scriptToAsm(script));
-}
-
 export function generateRedeemScript(baseScript: Script, encodedConstructorArgs: Script): Script {
-  return replaceBytecodeNop([...encodedConstructorArgs.slice().reverse(), ...baseScript]);
+  return [...encodedConstructorArgs.slice().reverse(), ...baseScript];
 }
 
 export function optimiseBytecode(script: Script, runs: number = 1000): Script {
diff --git a/packages/utils/test/script.fixture.ts b/packages/utils/test/script.fixture.ts
index 889e14e1..0e3b9b6d 100644
--- a/packages/utils/test/script.fixture.ts
+++ b/packages/utils/test/script.fixture.ts
@@ -35,49 +35,4 @@ export const fixtures: Fixture[] = [
     bytesize: 6,
     opcount: 4,
   },
-  {
-    name: 'Mecenas (2021-03-12)',
-    script: [
-      Op.OP_4, Op.OP_PICK, hexToBin(''), Op.OP_NUMEQUAL, Op.OP_IF, Op.OP_5, Op.OP_PICK,
-      Op.OP_NOP, hexToBin('68'), Op.OP_SPLIT, Op.OP_NIP, Op.OP_SIZE, hexToBin('34'),
-      Op.OP_SUB, Op.OP_SPLIT, Op.OP_8, Op.OP_SPLIT, Op.OP_4, Op.OP_SPLIT, Op.OP_NIP,
-      hexToBin('20'), Op.OP_SPLIT, Op.OP_DROP, Op.OP_10, Op.OP_ROLL, Op.OP_10, Op.OP_ROLL,
-      Op.OP_2DUP, Op.OP_SWAP, Op.OP_SIZE, Op.OP_1SUB, Op.OP_SPLIT, Op.OP_DROP, Op.OP_12,
-      Op.OP_ROLL, Op.OP_SHA256, Op.OP_ROT, Op.OP_CHECKDATASIGVERIFY, Op.OP_CHECKSIGVERIFY,
-      Op.OP_6, Op.OP_ROLL, Op.OP_CHECKSEQUENCEVERIFY, Op.OP_DROP, hexToBin('e803'),
-      Op.OP_ROT, Op.OP_BIN2NUM, Op.OP_DUP, Op.OP_7, Op.OP_PICK, Op.OP_3, Op.OP_PICK,
-      Op.OP_ADD, Op.OP_LESSTHANOREQUAL, Op.OP_IF, Op.OP_2DUP, Op.OP_SWAP, Op.OP_SUB,
-      Op.OP_8, Op.OP_NUM2BIN, Op.OP_DUP, hexToBin('1976a914'), Op.OP_CAT, Op.OP_6,
-      Op.OP_PICK, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_DUP, Op.OP_HASH256,
-      Op.OP_5, Op.OP_PICK, Op.OP_EQUALVERIFY, Op.OP_2DROP, Op.OP_ELSE, Op.OP_6, Op.OP_PICK,
-      Op.OP_8, Op.OP_NUM2BIN, Op.OP_OVER, Op.OP_8, Op.OP_PICK, Op.OP_SUB, Op.OP_3,
-      Op.OP_PICK, Op.OP_SUB, Op.OP_8, Op.OP_NUM2BIN, Op.OP_OVER, hexToBin('1976a914'),
-      Op.OP_CAT, Op.OP_7, Op.OP_PICK, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_OVER,
-      hexToBin('17a914'), Op.OP_CAT, Op.OP_7, Op.OP_PICK, Op.OP_HASH160, Op.OP_CAT,
-      hexToBin('87'), Op.OP_CAT, Op.OP_2DUP, Op.OP_CAT, Op.OP_HASH256, Op.OP_7, Op.OP_PICK,
-      Op.OP_EQUALVERIFY, Op.OP_2DROP, Op.OP_2DROP, Op.OP_ENDIF, Op.OP_2DROP, Op.OP_2DROP,
-      Op.OP_2DROP, Op.OP_2DROP, Op.OP_1, Op.OP_ELSE, Op.OP_4, Op.OP_ROLL, Op.OP_1,
-      Op.OP_NUMEQUALVERIFY, Op.OP_4, Op.OP_PICK, Op.OP_HASH160, Op.OP_ROT, Op.OP_EQUALVERIFY,
-      Op.OP_4, Op.OP_ROLL, Op.OP_4, Op.OP_ROLL, Op.OP_CHECKSIG, Op.OP_NIP, Op.OP_NIP,
-      Op.OP_NIP, Op.OP_ENDIF,
-    ],
-    asm:
-      'OP_4 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_5 OP_PICK OP_NOP 68 OP_SPLIT OP_NIP '
-      + 'OP_SIZE 34 OP_SUB OP_SPLIT OP_8 OP_SPLIT OP_4 OP_SPLIT OP_NIP 20 OP_SPLIT '
-      + 'OP_DROP OP_10 OP_ROLL OP_10 OP_ROLL OP_2DUP OP_SWAP OP_SIZE OP_1SUB OP_SPLIT '
-      + 'OP_DROP OP_12 OP_ROLL OP_SHA256 OP_ROT OP_CHECKDATASIGVERIFY OP_CHECKSIGVERIFY '
-      + 'OP_6 OP_ROLL OP_CHECKSEQUENCEVERIFY OP_DROP e803 OP_ROT OP_BIN2NUM OP_DUP OP_7 '
-      + 'OP_PICK OP_3 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_2DUP OP_SWAP OP_SUB OP_8 '
-      + 'OP_NUM2BIN OP_DUP 1976a914 OP_CAT OP_6 OP_PICK OP_CAT 88ac OP_CAT OP_DUP '
-      + 'OP_HASH256 OP_5 OP_PICK OP_EQUALVERIFY OP_2DROP OP_ELSE OP_6 OP_PICK OP_8 '
-      + 'OP_NUM2BIN OP_OVER OP_8 OP_PICK OP_SUB OP_3 OP_PICK OP_SUB OP_8 OP_NUM2BIN '
-      + 'OP_OVER 1976a914 OP_CAT OP_7 OP_PICK OP_CAT 88ac OP_CAT OP_OVER 17a914 OP_CAT '
-      + 'OP_7 OP_PICK OP_HASH160 OP_CAT 87 OP_CAT OP_2DUP OP_CAT OP_HASH256 OP_7 OP_PICK '
-      + 'OP_EQUALVERIFY OP_2DROP OP_2DROP OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_2DROP '
-      + 'OP_1 OP_ELSE OP_4 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_4 OP_PICK OP_HASH160 OP_ROT '
-      + 'OP_EQUALVERIFY OP_4 OP_ROLL OP_4 OP_ROLL OP_CHECKSIG OP_NIP OP_NIP OP_NIP OP_ENDIF',
-    bytecode: hexToBin('5479009c6355796101687f77820134947f587f547f7701207f755a7a5a7a6e7c828c7f755c7aa87bbbad567ab27502e8037b81765779537993a1636e7c94588076041976a9147e56797e0288ac7e76aa5579886d675679588078587994537994588078041976a9147e57797e0288ac7e780317a9147e5779a97e01877e6e7eaa5779886d6d686d6d6d6d5167547a519d5479a97b88547a547aac77777768'),
-    bytesize: 158,
-    opcount: 99,
-  },
 ];
diff --git a/packages/utils/test/script.test.ts b/packages/utils/test/script.test.ts
index ae73b24d..306ae3b9 100644
--- a/packages/utils/test/script.test.ts
+++ b/packages/utils/test/script.test.ts
@@ -98,9 +98,6 @@ describe('script utils', () => {
     });
   });
 
-  describe.skip('TODO: replaceBytecodeNop()', () => {
-  });
-
   describe.skip('TODO: generateRedeemScript()', () => {
   });
 
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index b0f1b996..09b45eab 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -11,6 +11,7 @@ This update adds CashScript support for the new BCH 2025 network upgrade. To rea
 
 #### CashScript SDK
 - :hammer_and_wrench: Update debug tooling to work with the new `BCH_2025_05` instruction set.
+- :boom: **BREAKING**: Remove support for old contracts compiled with CashScript v0.6.x or earlier.
 
 ## v0.10.5
 
@@ -238,7 +239,7 @@ https://x.com/RoscoKalis/status/1529072055756414976
 * :bug: The final statement in a contract now MUST be a require statement (in all branches)
 * :bug: Empty contracts and functions are now considered invalid
 * :bug: Fix bug where certain covenants could become unspendable due to incorrect bytesize calculation
-  * :boom: **BREAKING**: Covenants using `tx.bytecode` now include a placeholder `OP_NOP` that gets replaced when constructor arguments are provided in the CashScript SDK. If you're not using the CashScript SDK, refer to the [`replaceBytecodeNop()` function](https://github.com/CashScript/cashscript/blob/master/packages/utils/src/script.ts#L130) to see the steps required to do so manually.
+  * :boom: **BREAKING**: Covenants using `tx.bytecode` now include a placeholder `OP_NOP` that gets replaced when constructor arguments are provided in the CashScript SDK. If you're not using the CashScript SDK, refer to the [`replaceBytecodeNop()` function](https://github.com/CashScript/cashscript/blob/v0.6.0/packages/utils/src/script.ts#L130) to see the steps required to do so manually.
 * :boom: **BREAKING**: Remove `--args` parameter from the CLI, since this is too error prone with the recent changes in mind
 * :boom: **BREAKING**: Restructure exports
 
diff --git a/website/docs/sdk/signature-templates.md b/website/docs/sdk/signature-templates.md
index 172756ac..bd3a2106 100644
--- a/website/docs/sdk/signature-templates.md
+++ b/website/docs/sdk/signature-templates.md
@@ -48,10 +48,6 @@ export enum HashType {
 }
 ```
 
-:::note
-If you're using "old-style" covenants (using CashScript v0.6.0 or lower), you need to configure `HashType.SIGHASH_ALL` as the `hashtype` parameter for the SignatureTemplate.
-:::
-
 #### Example
 ```ts
 const wif = 'L4vmKsStbQaCvaKPnCzdRArZgdAxTqVx8vjMGLW5nHtWdRguiRi1';
diff --git a/yarn.lock b/yarn.lock
index 841a8ad8..b8249324 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2457,7 +2457,7 @@
   resolved "https://registry.yarnpkg.com/@types/prettier/-/prettier-2.7.2.tgz#6c2324641cc4ba050a8c710b2b251b377581fbf0"
   integrity sha512-KufADq8uQqo1pYKVIYzfKbJfBAc0sOeXqGbFaSpv8MRmC/zXgowNZmFcbngndGk922QDmOASEXUZCaY48gs4cg==
 
-"@types/semver@^7.3.4":
+"@types/semver@^7.5.8":
   version "7.5.8"
   resolved "https://registry.yarnpkg.com/@types/semver/-/semver-7.5.8.tgz#8268a8c57a3e4abd25c165ecd36237db7948a55e"
   integrity sha512-I8EUhyrgfLrcTkzV3TSsGyl1tSuPrEDzr0yd5m90UgNxQkyDXULk3b6MlQqTCpZpNtWe1K0hzclnZkTcLBe2UQ==
@@ -9368,7 +9368,7 @@ semver@^7.3.5:
   dependencies:
     lru-cache "^6.0.0"
 
-semver@^7.5.4, semver@^7.6.0:
+semver@^7.6.0, semver@^7.6.3:
   version "7.6.3"
   resolved "https://registry.yarnpkg.com/semver/-/semver-7.6.3.tgz#980f7b5550bc175fb4dc09403085627f9eb33143"
   integrity sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==

From c94658cc4490bde4e4fc06772f8fc83eb5cd943e Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 21 Jan 2025 12:01:34 +0100
Subject: [PATCH 174/267] Update most dependencies

---
 .cspell.json                        |    6 +
 examples/package.json               |    4 +-
 examples/testing-suite/package.json |   10 +-
 package.json                        |   15 +-
 packages/cashc/package.json         |   17 +-
 packages/cashc/src/cashc-cli.ts     |    2 +-
 packages/cashc/x.json               |   78 +
 packages/cashscript/package.json    |    8 +-
 packages/utils/package.json         |    6 +-
 yarn.lock                           | 3762 +++++++++++++++------------
 10 files changed, 2187 insertions(+), 1721 deletions(-)
 create mode 100644 packages/cashc/x.json

diff --git a/.cspell.json b/.cspell.json
index fe34cbe0..233e798a 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -204,6 +204,7 @@
         "branchup",
         "bchguru",
         "bchn",
+        "c0ffee",
         "cashcompiler",
         "cashninjas",
         "chaingraph",
@@ -271,5 +272,10 @@
         "**/grammar/**",
         // Do not spellcheck vendor code
         "**/node_modules/**",
+    ],
+    "ignoreRegExpList": [
+        "bitcoincash:.*",
+        "bchreg:.*",
+        "bchtest:.*"
     ]
 }
diff --git a/examples/package.json b/examples/package.json
index db1eb81b..49128af2 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -12,10 +12,10 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@types/node": "^12.7.8",
+    "@types/node": "^22.10.7",
     "cashc": "^0.11.0-next.0",
     "cashscript": "^0.11.0-next.0",
     "eslint": "^8.56.0",
-    "typescript": "^4.9.5"
+    "typescript": "^5.7.3"
   }
 }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index df6f195c..ab41724d 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -31,10 +31,10 @@
     "url-join": "^5.0.0"
   },
   "devDependencies": {
-    "@jest/globals": "^29.4.1",
-    "@types/jest": "^29.4.1",
-    "jest": "^29.4.1",
-    "tsx": "^4.7.2",
-    "typescript": "^4.9.5"
+    "@jest/globals": "^29.7.0",
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
   }
 }
diff --git a/package.json b/package.json
index 20554e15..a9c4e6d3 100644
--- a/package.json
+++ b/package.json
@@ -9,25 +9,22 @@
   ],
   "devDependencies": {
     "@jest/reporters": "^26.6.2",
-    "@types/jest": "^29.4.0",
-    "@types/node": "^14.14.28",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.7",
     "@typescript-eslint/eslint-plugin": "^7.0.0",
     "@typescript-eslint/parser": "^7.0.0",
-    "chalk": "^4.1.0",
-    "codecov": "^3.8.1",
-    "cspell": "^5.2.4",
+    "cspell": "^8.17.2",
     "eslint": "^8.54.0",
     "eslint-config-airbnb-typescript": "^18.0.0",
-    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-import": "^2.31.0",
     "lerna": "^3.22.1",
-    "tsx": "^4.7.2",
-    "typescript": "^5.5.4"
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
   },
   "scripts": {
     "test": "lerna run test --ignore cashscript-examples --ignore testing-suite",
     "lint": "lerna run lint --ignore cashscript-examples --ignore testing-suite",
     "examples": "tsx examples/p2pkh.ts && tsx examples/transfer_with_timeout.ts && tsx examples/hodl_vault.ts",
-    "coverage": "codecov",
     "postinstall": "lerna bootstrap && yarn build",
     "spellcheck": "cspell lint '**' --no-progress --must-find-files",
     "update-version": "tsx update-version.ts",
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 61834bb7..11a6659f 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -51,18 +51,21 @@
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
     "@cashscript/utils": "^0.11.0-next.0",
-    "antlr4": "^4.13.1-patch-1",
-    "commander": "^7.1.0",
+    "antlr4": "^4.13.2",
+    "commander": "^13.1.0",
     "semver": "^7.6.3"
   },
   "devDependencies": {
-    "@jest/globals": "^29.4.1",
-    "@types/node": "^18.11.18",
+    "@jest/globals": "^29.7.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.7",
     "@types/semver": "^7.5.8",
-    "cpy-cli": "^4.2.0",
+    "cpy-cli": "^5.0.0",
     "eslint": "^8.54.0",
-    "jest": "^29.4.1",
-    "typescript": "^5.5.4",
+    "eslint-plugin-import": "^2.31.0",
+    "jest": "^29.7.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
     "url-join": "^5.0.0"
   },
   "gitHead": "bf02a4b641d5d03c035d052247a545109c17b708"
diff --git a/packages/cashc/src/cashc-cli.ts b/packages/cashc/src/cashc-cli.ts
index e28b25a3..594e3e6c 100644
--- a/packages/cashc/src/cashc-cli.ts
+++ b/packages/cashc/src/cashc-cli.ts
@@ -19,7 +19,7 @@ program
   .storeOptionsAsProperties(false)
   .name('cashc')
   .version(version, '-V, --version', 'Output the version number.')
-  .usage('[options] [source_file]')
+  .argument('<source_file>', 'The source file to compile.')
   .option('-o, --output <path>', 'Specify a file to output the generated artifact.')
   .option('-h, --hex', 'Compile the contract to hex format rather than a full artifact.')
   .option('-A, --asm', 'Compile the contract to ASM format rather than a full artifact.')
diff --git a/packages/cashc/x.json b/packages/cashc/x.json
new file mode 100644
index 00000000..4c95ed84
--- /dev/null
+++ b/packages/cashc/x.json
@@ -0,0 +1,78 @@
+export default {
+  contractName: 'Mecenas',
+  constructorInputs: [
+    {
+      name: 'recipient',
+      type: 'bytes20',
+    },
+    {
+      name: 'funder',
+      type: 'bytes20',
+    },
+    {
+      name: 'pledge',
+      type: 'int',
+    },
+  ],
+  abi: [
+    {
+      name: 'receive',
+      inputs: [],
+    },
+    {
+      name: 'reclaim',
+      inputs: [
+        {
+          name: 'pk',
+          type: 'pubkey',
+        },
+        {
+          name: 's',
+          type: 'sig',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
+  source: 'pragma cashscript >=0.10.0;\n\n/* This is an unofficial CashScript port of Licho\'s Mecenas contract. It is\n * not compatible with Licho\'s EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(tx.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n',
+  debug: {
+    bytecode: '5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768',
+    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
+    logs: [],
+    requires: [
+      {
+        ip: 17,
+        line: 13,
+      },
+      {
+        ip: 46,
+        line: 22,
+      },
+      {
+        ip: 53,
+        line: 24,
+      },
+      {
+        ip: 59,
+        line: 25,
+      },
+      {
+        ip: 65,
+        line: 26,
+      },
+      {
+        ip: 86,
+        line: 31,
+      },
+      {
+        ip: 92,
+        line: 32,
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.11.0-next.0',
+  },
+  updatedAt: '2025-01-21T10:30:20.052Z',
+} as const;
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 36240975..b725ea8b 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -46,20 +46,20 @@
     "@bitauth/libauth": "^3.1.0-next.2",
     "@cashscript/utils": "^0.11.0-next.0",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
-    "delay": "^5.0.0",
+    "delay": "^6.0.0",
     "electrum-cash": "^2.0.10",
     "fast-deep-equal": "^3.1.3",
     "pako": "^2.1.0",
     "semver": "^7.6.3"
   },
   "devDependencies": {
-    "@jest/globals": "^29.4.1",
+    "@jest/globals": "^29.7.0",
     "@psf/bch-js": "^6.8.0",
     "@types/pako": "^2.0.3",
     "@types/semver": "^7.5.8",
     "eslint": "^8.54.0",
-    "jest": "^29.4.1",
-    "typescript": "^5.5.4"
+    "jest": "^29.7.0",
+    "typescript": "^5.7.3"
   },
   "gitHead": "bf02a4b641d5d03c035d052247a545109c17b708"
 }
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 1b93cbff..5f2a4cc8 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -43,10 +43,10 @@
     "@bitauth/libauth": "^3.1.0-next.2"
   },
   "devDependencies": {
-    "@jest/globals": "^29.4.1",
+    "@jest/globals": "^29.7.0",
     "eslint": "^8.54.0",
-    "jest": "^29.4.1",
-    "typescript": "^5.5.4"
+    "jest": "^29.7.0",
+    "typescript": "^5.7.3"
   },
   "gitHead": "bf02a4b641d5d03c035d052247a545109c17b708"
 }
diff --git a/yarn.lock b/yarn.lock
index b8249324..15fa8ffb 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -10,6 +10,14 @@
     "@jridgewell/gen-mapping" "^0.1.0"
     "@jridgewell/trace-mapping" "^0.3.9"
 
+"@ampproject/remapping@^2.2.0":
+  version "2.3.0"
+  resolved "https://registry.yarnpkg.com/@ampproject/remapping/-/remapping-2.3.0.tgz#ed441b6fa600072520ce18b43d2c8cc8caecc7f4"
+  integrity sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==
+  dependencies:
+    "@jridgewell/gen-mapping" "^0.3.5"
+    "@jridgewell/trace-mapping" "^0.3.24"
+
 "@babel/code-frame@^7.0.0", "@babel/code-frame@^7.10.4":
   version "7.10.4"
   resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.10.4.tgz#168da1a36e90da68ae8d49c0f1b48c7c6249213a"
@@ -17,12 +25,13 @@
   dependencies:
     "@babel/highlight" "^7.10.4"
 
-"@babel/code-frame@^7.12.13":
-  version "7.24.7"
-  resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.24.7.tgz#882fd9e09e8ee324e496bd040401c6f046ef4465"
-  integrity sha512-BcYH1CVJBO9tvyIZ2jVeXgSIMvGZ2FDRvDdOIVQyuklNKSsx+eppDEBq/g47Ayw+RqNFE+URvOShmf+f/qwAlA==
+"@babel/code-frame@^7.12.13", "@babel/code-frame@^7.25.9", "@babel/code-frame@^7.26.0", "@babel/code-frame@^7.26.2":
+  version "7.26.2"
+  resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.26.2.tgz#4b5fab97d33338eff916235055f0ebc21e573a85"
+  integrity sha512-RJlIHRueQgwWitWgF8OdFYGZX328Ax5BCemNGlqHfplnRT9ESi8JkFlvaVYbS+UubVY6dpv87Fs2u5M29iNFVQ==
   dependencies:
-    "@babel/highlight" "^7.24.7"
+    "@babel/helper-validator-identifier" "^7.25.9"
+    js-tokens "^4.0.0"
     picocolors "^1.0.0"
 
 "@babel/code-frame@^7.18.6":
@@ -37,6 +46,11 @@
   resolved "https://registry.yarnpkg.com/@babel/compat-data/-/compat-data-7.20.14.tgz#4106fc8b755f3e3ee0a0a7c27dde5de1d2b2baf8"
   integrity sha512-0YpKHD6ImkWMEINCyDAD0HLLUH/lPCefG8ld9it8DJB2wnApraKuhgYTvTY1z7UFIfBTGy5LwncZ+5HWWGbhFw==
 
+"@babel/compat-data@^7.26.5":
+  version "7.26.5"
+  resolved "https://registry.yarnpkg.com/@babel/compat-data/-/compat-data-7.26.5.tgz#df93ac37f4417854130e21d72c66ff3d4b897fc7"
+  integrity sha512-XvcZi1KWf88RVbF9wn8MN6tYFloU5qX8KjuF3E1PVBmJ9eypXfs4GRiJwLuTZL0iSnJUKn1BFPa5BPZZJyFzPg==
+
 "@babel/core@^7.1.0", "@babel/core@^7.11.6", "@babel/core@^7.12.3":
   version "7.20.12"
   resolved "https://registry.yarnpkg.com/@babel/core/-/core-7.20.12.tgz#7930db57443c6714ad216953d1356dac0eb8496d"
@@ -58,6 +72,27 @@
     json5 "^2.2.2"
     semver "^6.3.0"
 
+"@babel/core@^7.23.9":
+  version "7.26.0"
+  resolved "https://registry.yarnpkg.com/@babel/core/-/core-7.26.0.tgz#d78b6023cc8f3114ccf049eb219613f74a747b40"
+  integrity sha512-i1SLeK+DzNnQ3LL/CswPCa/E5u4lh1k6IAEphON8F+cXt0t9euTshDru0q7/IqMa1PMPz5RnHuHscF8/ZJsStg==
+  dependencies:
+    "@ampproject/remapping" "^2.2.0"
+    "@babel/code-frame" "^7.26.0"
+    "@babel/generator" "^7.26.0"
+    "@babel/helper-compilation-targets" "^7.25.9"
+    "@babel/helper-module-transforms" "^7.26.0"
+    "@babel/helpers" "^7.26.0"
+    "@babel/parser" "^7.26.0"
+    "@babel/template" "^7.25.9"
+    "@babel/traverse" "^7.25.9"
+    "@babel/types" "^7.26.0"
+    convert-source-map "^2.0.0"
+    debug "^4.1.0"
+    gensync "^1.0.0-beta.2"
+    json5 "^2.2.3"
+    semver "^6.3.1"
+
 "@babel/core@^7.7.5":
   version "7.11.4"
   resolved "https://registry.yarnpkg.com/@babel/core/-/core-7.11.4.tgz#4301dfdfafa01eeb97f1896c5501a3f0655d4229"
@@ -98,6 +133,17 @@
     "@jridgewell/gen-mapping" "^0.3.2"
     jsesc "^2.5.1"
 
+"@babel/generator@^7.26.0", "@babel/generator@^7.26.5":
+  version "7.26.5"
+  resolved "https://registry.yarnpkg.com/@babel/generator/-/generator-7.26.5.tgz#e44d4ab3176bbcaf78a5725da5f1dc28802a9458"
+  integrity sha512-2caSP6fN9I7HOe6nqhtft7V4g7/V/gfDsC3Ag4W7kEzzvRGKqiv0pu0HogPiZ3KaVSoNDhUws6IJjDjpfmYIXw==
+  dependencies:
+    "@babel/parser" "^7.26.5"
+    "@babel/types" "^7.26.5"
+    "@jridgewell/gen-mapping" "^0.3.5"
+    "@jridgewell/trace-mapping" "^0.3.25"
+    jsesc "^3.0.2"
+
 "@babel/helper-compilation-targets@^7.20.7":
   version "7.20.7"
   resolved "https://registry.yarnpkg.com/@babel/helper-compilation-targets/-/helper-compilation-targets-7.20.7.tgz#a6cd33e93629f5eb473b021aac05df62c4cd09bb"
@@ -109,6 +155,17 @@
     lru-cache "^5.1.1"
     semver "^6.3.0"
 
+"@babel/helper-compilation-targets@^7.25.9":
+  version "7.26.5"
+  resolved "https://registry.yarnpkg.com/@babel/helper-compilation-targets/-/helper-compilation-targets-7.26.5.tgz#75d92bb8d8d51301c0d49e52a65c9a7fe94514d8"
+  integrity sha512-IXuyn5EkouFJscIDuFF5EsiSolseme1s0CZB+QxVugqJLYmKdxI1VfIBOst0SUu4rnk2Z7kqTwmoO1lp3HIfnA==
+  dependencies:
+    "@babel/compat-data" "^7.26.5"
+    "@babel/helper-validator-option" "^7.25.9"
+    browserslist "^4.24.0"
+    lru-cache "^5.1.1"
+    semver "^6.3.1"
+
 "@babel/helper-environment-visitor@^7.18.9":
   version "7.18.9"
   resolved "https://registry.yarnpkg.com/@babel/helper-environment-visitor/-/helper-environment-visitor-7.18.9.tgz#0c0cee9b35d2ca190478756865bb3528422f51be"
@@ -166,6 +223,14 @@
   dependencies:
     "@babel/types" "^7.18.6"
 
+"@babel/helper-module-imports@^7.25.9":
+  version "7.25.9"
+  resolved "https://registry.yarnpkg.com/@babel/helper-module-imports/-/helper-module-imports-7.25.9.tgz#e7f8d20602ebdbf9ebbea0a0751fb0f2a4141715"
+  integrity sha512-tnUA4RsrmflIM6W6RFTLFSXITtl0wKjgpnLgXyowocVPrbYrLUXSBXDgTs8BlbmIzIdlBySRQjINYs2BAkiLtw==
+  dependencies:
+    "@babel/traverse" "^7.25.9"
+    "@babel/types" "^7.25.9"
+
 "@babel/helper-module-transforms@^7.11.0":
   version "7.11.0"
   resolved "https://registry.yarnpkg.com/@babel/helper-module-transforms/-/helper-module-transforms-7.11.0.tgz#b16f250229e47211abdd84b34b64737c2ab2d359"
@@ -193,6 +258,15 @@
     "@babel/traverse" "^7.20.10"
     "@babel/types" "^7.20.7"
 
+"@babel/helper-module-transforms@^7.26.0":
+  version "7.26.0"
+  resolved "https://registry.yarnpkg.com/@babel/helper-module-transforms/-/helper-module-transforms-7.26.0.tgz#8ce54ec9d592695e58d84cd884b7b5c6a2fdeeae"
+  integrity sha512-xO+xu6B5K2czEnQye6BHA7DolFFmS3LB7stHZFaOLb1pAwO1HWLS8fXA+eh0A2yIvltPVmx3eNNDBJA2SLHXFw==
+  dependencies:
+    "@babel/helper-module-imports" "^7.25.9"
+    "@babel/helper-validator-identifier" "^7.25.9"
+    "@babel/traverse" "^7.25.9"
+
 "@babel/helper-optimise-call-expression@^7.10.4":
   version "7.10.4"
   resolved "https://registry.yarnpkg.com/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.10.4.tgz#50dc96413d594f995a77905905b05893cd779673"
@@ -259,6 +333,11 @@
   resolved "https://registry.yarnpkg.com/@babel/helper-string-parser/-/helper-string-parser-7.19.4.tgz#38d3acb654b4701a9b77fb0615a96f775c3a9e63"
   integrity sha512-nHtDoQcuqFmwYNYPz3Rah5ph2p8PFeFCsZk9A/48dPc/rGocJ5J3hAAZ7pb76VWX3fZKu+uEr/FhH5jLx7umrw==
 
+"@babel/helper-string-parser@^7.25.9":
+  version "7.25.9"
+  resolved "https://registry.yarnpkg.com/@babel/helper-string-parser/-/helper-string-parser-7.25.9.tgz#1aabb72ee72ed35789b4bbcad3ca2862ce614e8c"
+  integrity sha512-4A/SCr/2KLd5jrtOMFzaKjVtAei3+2r/NChoBNoZ3EyP/+GlhoaEGoWOZUmFmoITP7zOJyHIMm+DYRd8o3PvHA==
+
 "@babel/helper-validator-identifier@^7.10.4":
   version "7.10.4"
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.10.4.tgz#a78c7a7251e01f616512d31b10adcf52ada5e0d2"
@@ -269,16 +348,21 @@
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.19.1.tgz#7eea834cf32901ffdc1a7ee555e2f9c27e249ca2"
   integrity sha512-awrNfaMtnHUr653GgGEs++LlAvW6w+DcPrOliSMXWCKo597CwL5Acf/wWdNkf/tfEQE3mjkeD1YOVZOUV/od1w==
 
-"@babel/helper-validator-identifier@^7.24.7":
-  version "7.24.7"
-  resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.24.7.tgz#75b889cfaf9e35c2aaf42cf0d72c8e91719251db"
-  integrity sha512-rR+PBcQ1SMQDDyF6X0wxtG8QyLCgUB0eRAGguqRLfkCA87l7yAP7ehq8SNj96OOGTO8OBV70KhuFYcIkHXOg0w==
+"@babel/helper-validator-identifier@^7.24.7", "@babel/helper-validator-identifier@^7.25.9":
+  version "7.25.9"
+  resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.25.9.tgz#24b64e2c3ec7cd3b3c547729b8d16871f22cbdc7"
+  integrity sha512-Ed61U6XJc3CVRfkERJWDz4dJwKe7iLmmJsbOGu9wSloNSFttHV0I8g6UAgb7qnK5ly5bGLPd4oXZlxCdANBOWQ==
 
 "@babel/helper-validator-option@^7.18.6":
   version "7.18.6"
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-option/-/helper-validator-option-7.18.6.tgz#bf0d2b5a509b1f336099e4ff36e1a63aa5db4db8"
   integrity sha512-XO7gESt5ouv/LRJdrVjkShckw6STTaB7l9BrpBaAHDeF5YZT+01PCwmR0SJHnkW6i8OwW/EVWRShfi4j2x+KQw==
 
+"@babel/helper-validator-option@^7.25.9":
+  version "7.25.9"
+  resolved "https://registry.yarnpkg.com/@babel/helper-validator-option/-/helper-validator-option-7.25.9.tgz#86e45bd8a49ab7e03f276577f96179653d41da72"
+  integrity sha512-e/zv1co8pp55dNdEcCynfj9X7nyUKUXoUEwfXqaZt0omVOmDe9oOTdKStH4GmAw6zxMFs50ZayuMfHDKlO7Tfw==
+
 "@babel/helpers@^7.10.4":
   version "7.10.4"
   resolved "https://registry.yarnpkg.com/@babel/helpers/-/helpers-7.10.4.tgz#2abeb0d721aff7c0a97376b9e1f6f65d7a475044"
@@ -297,6 +381,14 @@
     "@babel/traverse" "^7.20.13"
     "@babel/types" "^7.20.7"
 
+"@babel/helpers@^7.26.0":
+  version "7.26.0"
+  resolved "https://registry.yarnpkg.com/@babel/helpers/-/helpers-7.26.0.tgz#30e621f1eba5aa45fe6f4868d2e9154d884119a4"
+  integrity sha512-tbhNuIxNcVb21pInl3ZSjksLCvgdZy9KwJ8brv993QtIVKJBBkYXz4q4ZbAv31GdnC+R90np23L5FbEBlthAEw==
+  dependencies:
+    "@babel/template" "^7.25.9"
+    "@babel/types" "^7.26.0"
+
 "@babel/highlight@^7.10.4":
   version "7.10.4"
   resolved "https://registry.yarnpkg.com/@babel/highlight/-/highlight-7.10.4.tgz#7d1bdfd65753538fabe6c38596cdb76d9ac60143"
@@ -306,7 +398,7 @@
     chalk "^2.0.0"
     js-tokens "^4.0.0"
 
-"@babel/highlight@^7.18.6", "@babel/highlight@^7.24.7":
+"@babel/highlight@^7.18.6":
   version "7.24.7"
   resolved "https://registry.yarnpkg.com/@babel/highlight/-/highlight-7.24.7.tgz#a05ab1df134b286558aae0ed41e6c5f731bf409d"
   integrity sha512-EStJpq4OuY8xYfhGVXngigBJRWxftKX9ksiGDnmlY3o7B/V7KIAc9X4oiK87uPJSc/vs5L869bem5fhZa8caZw==
@@ -326,6 +418,13 @@
   resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.20.15.tgz#eec9f36d8eaf0948bb88c87a46784b5ee9fd0c89"
   integrity sha512-DI4a1oZuf8wC+oAJA9RW6ga3Zbe8RZFt7kD9i4qAspz3I/yHet1VvC3DiSy/fsUvv5pvJuNPh0LPOdCcqinDPg==
 
+"@babel/parser@^7.23.9", "@babel/parser@^7.25.9", "@babel/parser@^7.26.0", "@babel/parser@^7.26.5":
+  version "7.26.5"
+  resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.26.5.tgz#6fec9aebddef25ca57a935c86dbb915ae2da3e1f"
+  integrity sha512-SRJ4jYmXRqV1/Xc+TIVG84WjHBXKlxO9sHQnA2Pf12QQEAp1LOh6kDzNHXcUnbH1QI0FDoPPVOt+vyUDucxpaw==
+  dependencies:
+    "@babel/types" "^7.26.5"
+
 "@babel/plugin-syntax-async-generators@^7.8.4":
   version "7.8.4"
   resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz#a983fb1aeb2ec3f6ed042a210f640e90e786fe0d"
@@ -442,6 +541,15 @@
     "@babel/parser" "^7.20.7"
     "@babel/types" "^7.20.7"
 
+"@babel/template@^7.25.9":
+  version "7.25.9"
+  resolved "https://registry.yarnpkg.com/@babel/template/-/template-7.25.9.tgz#ecb62d81a8a6f5dc5fe8abfc3901fc52ddf15016"
+  integrity sha512-9DGttpmPvIxBb/2uwpVo3dqJ+O6RooAFOS+lB+xDqoE2PVCE8nfoHMdZLpfCQRLwvohzXISPZcgxt80xLfsuwg==
+  dependencies:
+    "@babel/code-frame" "^7.25.9"
+    "@babel/parser" "^7.25.9"
+    "@babel/types" "^7.25.9"
+
 "@babel/traverse@^7.10.4", "@babel/traverse@^7.11.0":
   version "7.11.0"
   resolved "https://registry.yarnpkg.com/@babel/traverse/-/traverse-7.11.0.tgz#9b996ce1b98f53f7c3e4175115605d56ed07dd24"
@@ -457,7 +565,7 @@
     globals "^11.1.0"
     lodash "^4.17.19"
 
-"@babel/traverse@^7.20.10", "@babel/traverse@^7.20.12", "@babel/traverse@^7.20.13", "@babel/traverse@^7.7.2":
+"@babel/traverse@^7.20.10", "@babel/traverse@^7.20.12", "@babel/traverse@^7.20.13":
   version "7.20.13"
   resolved "https://registry.yarnpkg.com/@babel/traverse/-/traverse-7.20.13.tgz#817c1ba13d11accca89478bd5481b2d168d07473"
   integrity sha512-kMJXfF0T6DIS9E8cgdLCSAL+cuCK+YEZHWiLK0SXpTo8YRj5lpJu3CDNKiIBCne4m9hhTIqUg6SYTAI39tAiVQ==
@@ -473,6 +581,19 @@
     debug "^4.1.0"
     globals "^11.1.0"
 
+"@babel/traverse@^7.25.9":
+  version "7.26.5"
+  resolved "https://registry.yarnpkg.com/@babel/traverse/-/traverse-7.26.5.tgz#6d0be3e772ff786456c1a37538208286f6e79021"
+  integrity sha512-rkOSPOw+AXbgtwUga3U4u8RpoK9FEFWBNAlTpcnkLFjL5CT+oyHNuUUC/xx6XefEJ16r38r8Bc/lfp6rYuHeJQ==
+  dependencies:
+    "@babel/code-frame" "^7.26.2"
+    "@babel/generator" "^7.26.5"
+    "@babel/parser" "^7.26.5"
+    "@babel/template" "^7.25.9"
+    "@babel/types" "^7.26.5"
+    debug "^4.3.1"
+    globals "^11.1.0"
+
 "@babel/types@^7.0.0", "@babel/types@^7.10.4", "@babel/types@^7.11.0", "@babel/types@^7.3.0", "@babel/types@^7.3.3":
   version "7.11.0"
   resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.11.0.tgz#2ae6bf1ba9ae8c3c43824e5861269871b206e90d"
@@ -491,6 +612,14 @@
     "@babel/helper-validator-identifier" "^7.19.1"
     to-fast-properties "^2.0.0"
 
+"@babel/types@^7.25.9", "@babel/types@^7.26.0", "@babel/types@^7.26.5":
+  version "7.26.5"
+  resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.26.5.tgz#7a1e1c01d28e26d1fe7f8ec9567b3b92b9d07747"
+  integrity sha512-L6mZmwFDK6Cjh1nRCLXpa6no13ZIioJDz7mdkzHv399pThrTa/k0nUlNaenOeh2kWu/iaOQYElEpKPUswUa9Vg==
+  dependencies:
+    "@babel/helper-string-parser" "^7.25.9"
+    "@babel/helper-validator-identifier" "^7.25.9"
+
 "@bcoe/v8-coverage@^0.2.3":
   version "0.2.3"
   resolved "https://registry.yarnpkg.com/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz#75a2e8b51cb758a7553d6804a5932d7aace75c39"
@@ -517,334 +646,535 @@
     exec-sh "^0.3.2"
     minimist "^1.2.0"
 
-"@cspell/cspell-bundled-dicts@^5.2.4":
-  version "5.2.4"
-  resolved "https://registry.yarnpkg.com/@cspell/cspell-bundled-dicts/-/cspell-bundled-dicts-5.2.4.tgz#dd0e161bb2203f19a2dd9358c3eb9daaffb7a336"
-  integrity sha512-IVoTVdFIWnWmJYBwjbsYtFyH6fD8bClDZrFpUa/a84vXVopcH1ZjpwotDsHO+P3O1GCFTacT1Z2Lyh56xowmxw==
-  dependencies:
-    "@cspell/dict-aws" "^1.0.13"
-    "@cspell/dict-bash" "^1.0.11"
-    "@cspell/dict-companies" "^1.0.35"
-    "@cspell/dict-cpp" "^1.1.37"
-    "@cspell/dict-cryptocurrencies" "^1.0.10"
-    "@cspell/dict-csharp" "^1.0.10"
-    "@cspell/dict-css" "^1.0.10"
-    "@cspell/dict-django" "^1.0.25"
-    "@cspell/dict-dotnet" "^1.0.24"
-    "@cspell/dict-elixir" "^1.0.23"
-    "@cspell/dict-en-gb" "^1.1.27"
-    "@cspell/dict-en_us" "^1.2.39"
-    "@cspell/dict-filetypes" "^1.1.5"
-    "@cspell/dict-fonts" "^1.0.14"
-    "@cspell/dict-fullstack" "^1.0.36"
-    "@cspell/dict-golang" "^1.1.24"
-    "@cspell/dict-haskell" "^1.0.12"
-    "@cspell/dict-html" "^1.1.5"
-    "@cspell/dict-html-symbol-entities" "^1.0.23"
-    "@cspell/dict-java" "^1.0.22"
-    "@cspell/dict-latex" "^1.0.23"
-    "@cspell/dict-lorem-ipsum" "^1.0.22"
-    "@cspell/dict-lua" "^1.0.16"
-    "@cspell/dict-node" "^1.0.10"
-    "@cspell/dict-npm" "^1.0.10"
-    "@cspell/dict-php" "^1.0.23"
-    "@cspell/dict-powershell" "^1.0.14"
-    "@cspell/dict-python" "^1.0.33"
-    "@cspell/dict-ruby" "^1.0.12"
-    "@cspell/dict-rust" "^1.0.22"
-    "@cspell/dict-scala" "^1.0.21"
-    "@cspell/dict-software-terms" "^1.0.25"
-    "@cspell/dict-typescript" "^1.0.16"
-
-"@cspell/cspell-types@^5.2.4":
-  version "5.2.4"
-  resolved "https://registry.yarnpkg.com/@cspell/cspell-types/-/cspell-types-5.2.4.tgz#361fdc6c008b82a5c0dfd6c1fd2bee2cb7255b4b"
-  integrity sha512-luv2hzoKdDrNs2LPDHuS+r9hOniZlYiJJU8og8ftGyuwjytnSaTUvtY8SzFqquKQJ4+rty6AF2RS/foQ69s/2Q==
-
-"@cspell/dict-aws@^1.0.13":
-  version "1.0.13"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-aws/-/dict-aws-1.0.13.tgz#5961c9764a2f731e488debee1c70fd488ee59727"
-  integrity sha512-9rq8BS5p418THq12PIkLQmGhg4kQ8tMH8vyB7gTF2lOrA+xMwV5HjZAepoYiJCxDQI5GAQJZlAaBi5DRG3AN2A==
-
-"@cspell/dict-bash@^1.0.11":
-  version "1.0.11"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-bash/-/dict-bash-1.0.11.tgz#5ba56250e467d2c2ed3f2795081f4934af0c9afc"
-  integrity sha512-DTOugbPacEFIav5s+VniByouu4apD1SKS5inwiBndw0TH3Pkm4MFTPUwfT1y7Ki4HEIyfRI2ughig2045SBqRw==
-
-"@cspell/dict-companies@^1.0.35":
-  version "1.0.35"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-companies/-/dict-companies-1.0.35.tgz#3f244e005afa533cdec8896ceaf866c82d77251a"
-  integrity sha512-lFoXFqXgAUjj14t7VJm+D/j9jU9kn4Eud+Q2gVQTKs6+oMivJ0hROpqZv/CEYHlm/4MpP5Livp0z0E6ARCE0kQ==
-
-"@cspell/dict-cpp@^1.1.37":
-  version "1.1.37"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-cpp/-/dict-cpp-1.1.37.tgz#79b33a42ebc0d7bed19bd8d07559e95c8668a70a"
-  integrity sha512-1X48pxiOdAw5Q7zj0k8/L5B1YY2W0k4go4CB5rcsuGRzsWXsdnKXHQTeMTAw7epIe4lj+Ef9oWaU+ODQpDZOCQ==
-
-"@cspell/dict-cryptocurrencies@^1.0.10":
-  version "1.0.10"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-cryptocurrencies/-/dict-cryptocurrencies-1.0.10.tgz#04426fdfee8752818b375686d34a154b2fb40c7d"
-  integrity sha512-47ABvDJOkaST/rXipNMfNvneHUzASvmL6K/CbOFpYKfsd0x23Jc9k1yaOC7JAm82XSC/8a7+3Yu+Fk2jVJNnsA==
+"@cspell/cspell-bundled-dicts@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/cspell-bundled-dicts/-/cspell-bundled-dicts-8.17.2.tgz#f4e4bd8a26c1be15946a8125789de52ca78e4494"
+  integrity sha512-t+DQtruJF2cYfXF5GC4F0O/PQR04hL5WH55R9oOaor5i7K8ejbw6+jex2LB0XbZFf3qBhXNSnMPuM3b/113LnA==
+  dependencies:
+    "@cspell/dict-ada" "^4.1.0"
+    "@cspell/dict-al" "^1.1.0"
+    "@cspell/dict-aws" "^4.0.9"
+    "@cspell/dict-bash" "^4.2.0"
+    "@cspell/dict-companies" "^3.1.12"
+    "@cspell/dict-cpp" "^6.0.3"
+    "@cspell/dict-cryptocurrencies" "^5.0.4"
+    "@cspell/dict-csharp" "^4.0.6"
+    "@cspell/dict-css" "^4.0.17"
+    "@cspell/dict-dart" "^2.3.0"
+    "@cspell/dict-data-science" "^2.0.6"
+    "@cspell/dict-django" "^4.1.4"
+    "@cspell/dict-docker" "^1.1.12"
+    "@cspell/dict-dotnet" "^5.0.9"
+    "@cspell/dict-elixir" "^4.0.7"
+    "@cspell/dict-en-common-misspellings" "^2.0.8"
+    "@cspell/dict-en-gb" "1.1.33"
+    "@cspell/dict-en_us" "^4.3.29"
+    "@cspell/dict-filetypes" "^3.0.10"
+    "@cspell/dict-flutter" "^1.1.0"
+    "@cspell/dict-fonts" "^4.0.4"
+    "@cspell/dict-fsharp" "^1.1.0"
+    "@cspell/dict-fullstack" "^3.2.3"
+    "@cspell/dict-gaming-terms" "^1.1.0"
+    "@cspell/dict-git" "^3.0.4"
+    "@cspell/dict-golang" "^6.0.18"
+    "@cspell/dict-google" "^1.0.5"
+    "@cspell/dict-haskell" "^4.0.5"
+    "@cspell/dict-html" "^4.0.11"
+    "@cspell/dict-html-symbol-entities" "^4.0.3"
+    "@cspell/dict-java" "^5.0.11"
+    "@cspell/dict-julia" "^1.1.0"
+    "@cspell/dict-k8s" "^1.0.10"
+    "@cspell/dict-kotlin" "^1.1.0"
+    "@cspell/dict-latex" "^4.0.3"
+    "@cspell/dict-lorem-ipsum" "^4.0.4"
+    "@cspell/dict-lua" "^4.0.7"
+    "@cspell/dict-makefile" "^1.0.4"
+    "@cspell/dict-markdown" "^2.0.9"
+    "@cspell/dict-monkeyc" "^1.0.10"
+    "@cspell/dict-node" "^5.0.6"
+    "@cspell/dict-npm" "^5.1.22"
+    "@cspell/dict-php" "^4.0.14"
+    "@cspell/dict-powershell" "^5.0.14"
+    "@cspell/dict-public-licenses" "^2.0.12"
+    "@cspell/dict-python" "^4.2.14"
+    "@cspell/dict-r" "^2.1.0"
+    "@cspell/dict-ruby" "^5.0.7"
+    "@cspell/dict-rust" "^4.0.11"
+    "@cspell/dict-scala" "^5.0.7"
+    "@cspell/dict-shell" "^1.1.0"
+    "@cspell/dict-software-terms" "^4.2.2"
+    "@cspell/dict-sql" "^2.2.0"
+    "@cspell/dict-svelte" "^1.0.6"
+    "@cspell/dict-swift" "^2.0.5"
+    "@cspell/dict-terraform" "^1.1.0"
+    "@cspell/dict-typescript" "^3.2.0"
+    "@cspell/dict-vue" "^3.0.4"
+
+"@cspell/cspell-json-reporter@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/cspell-json-reporter/-/cspell-json-reporter-8.17.2.tgz#4e1b173bcc5558d79f0784bdc0704a297ec026b8"
+  integrity sha512-9QFzuSApaK7SYB50iCTRIUDjFZf6DXTFj8+qTR2cky+/YmEcHDpJieJVCd3STONO4m2JyqIsV7faEuA6M0YcHg==
+  dependencies:
+    "@cspell/cspell-types" "8.17.2"
+
+"@cspell/cspell-pipe@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/cspell-pipe/-/cspell-pipe-8.17.2.tgz#ae96a3611939758e9c0004cbf410b21d3253e87e"
+  integrity sha512-LOTKK+hZSUc7vaN8SBEOcv+9dMYbo84awbsjjdI+HkKVBfTt3Lzlu6IJImw39L6pTDAJ1ZxOUdWO89jcxpyihg==
+
+"@cspell/cspell-resolver@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/cspell-resolver/-/cspell-resolver-8.17.2.tgz#fc8c4820509964df65911c23b104c31e872697f8"
+  integrity sha512-Z2ndlzVIiXOCBnQby9q+OXcxeddiuCi//pnhO9Jf6Ixgthn+Yg7bwzAnHu+CM1SJaQnZCntGyimdxfojm+WDdA==
+  dependencies:
+    global-directory "^4.0.1"
+
+"@cspell/cspell-service-bus@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/cspell-service-bus/-/cspell-service-bus-8.17.2.tgz#3a6d2662bf8037690038aaefc127fe5db9531291"
+  integrity sha512-Cp4kVxJRyyDRd5RVTASlu+ygWG+dgy6GyH7lzb6P8SOXt1mxzCBK6Q5Dc1XHAsvhRaLrnMziCO/5Pj9/0DKs6w==
+
+"@cspell/cspell-types@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/cspell-types/-/cspell-types-8.17.2.tgz#ba609e82fdfa08967b3045c9315ecb87a796549b"
+  integrity sha512-4kMBhX92p0pchEzYTpyLCoe/bUJ29YYvMINTeHTd//hLQh0ZAyMGY1opDm1tqaXX0qpYmWG60KcvN4fCR0i6lw==
+
+"@cspell/dict-ada@^4.1.0":
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-ada/-/dict-ada-4.1.0.tgz#60d4ca3c47262d91ecb008330f31a3066f3161f9"
+  integrity sha512-7SvmhmX170gyPd+uHXrfmqJBY5qLcCX8kTGURPVeGxmt8XNXT75uu9rnZO+jwrfuU2EimNoArdVy5GZRGljGNg==
 
-"@cspell/dict-csharp@^1.0.10":
-  version "1.0.10"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-csharp/-/dict-csharp-1.0.10.tgz#3806ff6646764f720ac02a0eb65d6b97b99811fe"
-  integrity sha512-jAl4HeRTwbN2+tEqL8cjM7GLXSJr9Jde3k8CqfxKME7qwVRCoBW6RkhyDHfEyaQ1LomDhnr35uiHEVrw7xCHMw==
+"@cspell/dict-al@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-al/-/dict-al-1.1.0.tgz#8091d046b6fe74004f3f1df8d1403a280818537f"
+  integrity sha512-PtNI1KLmYkELYltbzuoztBxfi11jcE9HXBHCpID2lou/J4VMYKJPNqe4ZjVzSI9NYbMnMnyG3gkbhIdx66VSXg==
 
-"@cspell/dict-css@^1.0.10":
-  version "1.0.10"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-css/-/dict-css-1.0.10.tgz#80ef4e89ec83a8386a69d9770b76184a2c26370e"
-  integrity sha512-QQbh+GBAyTVU8Wlf1xZPxZQQ3uRzb1lYE5RjE7hnRTSc4HtWYcb2+6XpO51QDl/dRhCmP3vEHzFF/swzHRa5hw==
-
-"@cspell/dict-django@^1.0.25":
-  version "1.0.25"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-django/-/dict-django-1.0.25.tgz#7f821e781b2ae35bc12491a663ca506185f6d008"
-  integrity sha512-kQfZhvjAodb5CNgryYoEKlUaHA+IVGhZIpON5ZJBuxrPUZ4SyklACPXKxDyXnKAibrERoi4zNL6pBbsljEL03w==
-
-"@cspell/dict-dotnet@^1.0.24":
-  version "1.0.24"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-dotnet/-/dict-dotnet-1.0.24.tgz#432a1f3bf6920860de86a6e7101639c1b4e348be"
-  integrity sha512-TxmMSh2T7C+DzF0rGTwVWFGCwqiwqLpyKar37kJt62bhadbxFKv+XxkLjOLVmgoqhA17BXM813hIjjZrICj4jg==
-
-"@cspell/dict-elixir@^1.0.23":
-  version "1.0.23"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-elixir/-/dict-elixir-1.0.23.tgz#1d341626467a2ca109b72c5368645af1f12417a4"
-  integrity sha512-UKDgNSZ36o31IX4NjCF/lCuOAoLEEsjSB2KwMD2ucT66MSFEPLk1womGY+iWblISeeBmB9EehfL1hjgoRwGlUw==
-
-"@cspell/dict-en-gb@^1.1.27":
-  version "1.1.27"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-en-gb/-/dict-en-gb-1.1.27.tgz#5c567fcc0f737e9ac8dc8fa76eb39928a6a2b35b"
-  integrity sha512-0tY939q0vzmsUotKQe/i8mDGqiiw4V3Kv/nkTvxFfVQAd6JRfpWBKlMbVV5Oy37nQkQiwkDLY4v90AbyqOvG8Q==
-
-"@cspell/dict-en_us@^1.2.39":
-  version "1.2.39"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-en_us/-/dict-en_us-1.2.39.tgz#44e30abee9a20ec3cbddd2c91f21de7e3b4ca4ea"
-  integrity sha512-rMn5pIm3bl+t3Qxdf3WMkLZ2kzs/FDHSCDR9ha+JOtCJ1yrJTLdlZvokGDLwMScztbgooEvabsN8AUqPutOSog==
-
-"@cspell/dict-filetypes@^1.1.5":
-  version "1.1.5"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-filetypes/-/dict-filetypes-1.1.5.tgz#d1024eb0ae3b316e3e9411e2f36e624844345563"
-  integrity sha512-yfkB37J+hL6W8qa4AknFp7u6CGECrw2ql2/y0lUKruLQYid0ApK+bH+ll+Sqgl2YS5QAOhclskc72aQHAcRJIQ==
+"@cspell/dict-aws@^4.0.9":
+  version "4.0.9"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-aws/-/dict-aws-4.0.9.tgz#10c1dc6431e05f02809367b70942189acb35d720"
+  integrity sha512-bDYdnnJGwSkIZ4gzrauu7qzOs/ZAY/FnU4k11LgdMI8BhwMfsbsy2EI1iS+sD/BI5ZnNT9kU5YR3WADeNOmhRg==
 
-"@cspell/dict-fonts@^1.0.14":
-  version "1.0.14"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-fonts/-/dict-fonts-1.0.14.tgz#7b18129910d30bd23cd9187d0c0009dfc3fef4ba"
-  integrity sha512-VhIX+FVYAnqQrOuoFEtya6+H72J82cIicz9QddgknsTqZQ3dvgp6lmVnsQXPM3EnzA8n1peTGpLDwHzT7ociLA==
+"@cspell/dict-bash@^4.2.0":
+  version "4.2.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-bash/-/dict-bash-4.2.0.tgz#d1f7c6d2afdf849a3d418de6c2e9b776e7bd532a"
+  integrity sha512-HOyOS+4AbCArZHs/wMxX/apRkjxg6NDWdt0jF9i9XkvJQUltMwEhyA2TWYjQ0kssBsnof+9amax2lhiZnh3kCg==
+  dependencies:
+    "@cspell/dict-shell" "1.1.0"
 
-"@cspell/dict-fullstack@^1.0.36":
-  version "1.0.36"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-fullstack/-/dict-fullstack-1.0.36.tgz#47c9d1b515405751be40cc177608e1ea6d121c02"
-  integrity sha512-npScBMAoZsjVE5uC1I72vmM1FCYnqzHH1ujgiBkbKd6Dp73VZ1f6OtpSQgqq9/onb0mSmMVF2kw4gPj8BlwGHg==
+"@cspell/dict-companies@^3.1.12":
+  version "3.1.13"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-companies/-/dict-companies-3.1.13.tgz#dd99c462076cdad9a62918a9c4a53865a32f2c6f"
+  integrity sha512-EAaFMxnSG4eQKup9D81EnWAYIzorLWG7b7Zzf+Suu0bVeFBpCYESss/EWtnmb5ZZNfKAGxtoMqfL3vRfyJERIQ==
 
-"@cspell/dict-golang@^1.1.24":
-  version "1.1.24"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-golang/-/dict-golang-1.1.24.tgz#3830812aec816eca46a6d793fcc7710c09d4f5b9"
-  integrity sha512-qq3Cjnx2U1jpeWAGJL1GL0ylEhUMqyaR36Xij6Y6Aq4bViCRp+HRRqk0x5/IHHbOrti45h3yy7ii1itRFo+Xkg==
+"@cspell/dict-cpp@^6.0.3":
+  version "6.0.3"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-cpp/-/dict-cpp-6.0.3.tgz#e1c8d699fa0b28abd23ad5c1e1082070c918d746"
+  integrity sha512-OFrVXdxCeGKnon36Pe3yFjBuY4kzzEwWFf3vDz+cJTodZDkjFkBifQeTtt5YfimgF8cfAJZXkBCsxjipAgmAiw==
 
-"@cspell/dict-haskell@^1.0.12":
-  version "1.0.12"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-haskell/-/dict-haskell-1.0.12.tgz#cc6ec4d0466b029683e9f861dea3d0e95c514606"
-  integrity sha512-JrSSuV2oY8Z1/qYi8j1w5M3eokiFkcpRtCrxpKlHYFXFEvmqTH9D8qvzVbAkrQpefMppy8uIUzknSzhwAc/MQA==
+"@cspell/dict-cryptocurrencies@^5.0.4":
+  version "5.0.4"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-cryptocurrencies/-/dict-cryptocurrencies-5.0.4.tgz#f0008e7aec9856373d03d728dd5990a94ff76c31"
+  integrity sha512-6iFu7Abu+4Mgqq08YhTKHfH59mpMpGTwdzDB2Y8bbgiwnGFCeoiSkVkgLn1Kel2++hYcZ8vsAW/MJS9oXxuMag==
 
-"@cspell/dict-html-symbol-entities@^1.0.23":
-  version "1.0.23"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-html-symbol-entities/-/dict-html-symbol-entities-1.0.23.tgz#0efbdbc7712c9fbe545e14acac637226ac948f2d"
-  integrity sha512-PV0UBgcBFbBLf/m1wfkVMM8w96kvfHoiCGLWO6BR3Q9v70IXoE4ae0+T+f0CkxcEkacMqEQk/I7vuE9MzrjaNw==
+"@cspell/dict-csharp@^4.0.6":
+  version "4.0.6"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-csharp/-/dict-csharp-4.0.6.tgz#a40dc2cc12689356f986fda83c8d72cc3443d588"
+  integrity sha512-w/+YsqOknjQXmIlWDRmkW+BHBPJZ/XDrfJhZRQnp0wzpPOGml7W0q1iae65P2AFRtTdPKYmvSz7AL5ZRkCnSIw==
 
-"@cspell/dict-html@^1.1.5":
-  version "1.1.6"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-html/-/dict-html-1.1.6.tgz#29c40c0ebc51de4cfe2d6041206ba39d74b28b67"
-  integrity sha512-RsZXIrmsnLcUpXfyZdNg7OtO2+e4p7m/qILg03kM6vhSUMY6ryCQNPWKrHqsl8+LBKd54EgFM+O5zcgq6IIsCw==
-
-"@cspell/dict-java@^1.0.22":
-  version "1.0.22"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-java/-/dict-java-1.0.22.tgz#30e660803922755c314fb61e9c8cd58a1f4bd47e"
-  integrity sha512-CVAJ29dx1XwwutgsMgaj5eCl1Nc7X7qFhWL2KkAdu78A/NUIaS+1I9KS0hHhdZx/wLke9dH8TR7NyPQGpGxeAw==
-
-"@cspell/dict-latex@^1.0.23":
-  version "1.0.23"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-latex/-/dict-latex-1.0.23.tgz#bb216e676c66b931bdfd1c8cb93e9625b5b66d45"
-  integrity sha512-xn9VvX5+q9xxELiOl5o8W/0nKympOc9i6Bq6PqX3fxhVWV4xURT18sp14OI9dNXxOSm5TRzL96vgLYvK/FYQVw==
-
-"@cspell/dict-lorem-ipsum@^1.0.22":
-  version "1.0.22"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-lorem-ipsum/-/dict-lorem-ipsum-1.0.22.tgz#a89f53dadda7d5bfdb978ab61f19d74d2fb69eab"
-  integrity sha512-yqzspR+2ADeAGUxLTfZ4pXvPl7FmkENMRcGDECmddkOiuEwBCWMZdMP5fng9B0Q6j91hQ8w9CLvJKBz10TqNYg==
-
-"@cspell/dict-lua@^1.0.16":
-  version "1.0.16"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-lua/-/dict-lua-1.0.16.tgz#c0ca43628f8927fc10731fd27cd9ee0af651bf6a"
-  integrity sha512-YiHDt8kmHJ8nSBy0tHzaxiuitYp+oJ66ffCYuFWTNB3//Y0SI4OGHU3omLsQVeXIfCeVrO4DrVvRDoCls9B5zQ==
-
-"@cspell/dict-node@^1.0.10":
+"@cspell/dict-css@^4.0.17":
+  version "4.0.17"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-css/-/dict-css-4.0.17.tgz#e84d568d19abbcbf9d9abe6936dc2fd225a0b6d6"
+  integrity sha512-2EisRLHk6X/PdicybwlajLGKF5aJf4xnX2uuG5lexuYKt05xV/J/OiBADmi8q9obhxf1nesrMQbqAt+6CsHo/w==
+
+"@cspell/dict-dart@^2.3.0":
+  version "2.3.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-dart/-/dict-dart-2.3.0.tgz#2bc39f965712c798dce143cafa656125ea30c0d8"
+  integrity sha512-1aY90lAicek8vYczGPDKr70pQSTQHwMFLbmWKTAI6iavmb1fisJBS1oTmMOKE4ximDf86MvVN6Ucwx3u/8HqLg==
+
+"@cspell/dict-data-science@^2.0.6", "@cspell/dict-data-science@^2.0.7":
+  version "2.0.7"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-data-science/-/dict-data-science-2.0.7.tgz#3939bd105ef9ee487272e8b25e3433e7f03a6b91"
+  integrity sha512-XhAkK+nSW6zmrnWzusmZ1BpYLc62AWYHZc2p17u4nE2Z9XG5DleG55PCZxXQTKz90pmwlhFM9AfpkJsYaBWATA==
+
+"@cspell/dict-django@^4.1.4":
+  version "4.1.4"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-django/-/dict-django-4.1.4.tgz#69298021c60b9b39d491c1a9caa2b33346311a2f"
+  integrity sha512-fX38eUoPvytZ/2GA+g4bbdUtCMGNFSLbdJJPKX2vbewIQGfgSFJKY56vvcHJKAvw7FopjvgyS/98Ta9WN1gckg==
+
+"@cspell/dict-docker@^1.1.12":
+  version "1.1.12"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-docker/-/dict-docker-1.1.12.tgz#aa18dbfe8d5b0df7118cdee9f2f7f44ea4b45621"
+  integrity sha512-6d25ZPBnYZaT9D9An/x6g/4mk542R8bR3ipnby3QFCxnfdd6xaWiTcwDPsCgwN2aQZIQ1jX/fil9KmBEqIK/qA==
+
+"@cspell/dict-dotnet@^5.0.9":
+  version "5.0.9"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-dotnet/-/dict-dotnet-5.0.9.tgz#c615eb213d5ff3015aa43a1f2e67b2393346e774"
+  integrity sha512-JGD6RJW5sHtO5lfiJl11a5DpPN6eKSz5M1YBa1I76j4dDOIqgZB6rQexlDlK1DH9B06X4GdDQwdBfnpAB0r2uQ==
+
+"@cspell/dict-elixir@^4.0.7":
+  version "4.0.7"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-elixir/-/dict-elixir-4.0.7.tgz#fd6136db9acb7912e495e02777e2141ef16822f4"
+  integrity sha512-MAUqlMw73mgtSdxvbAvyRlvc3bYnrDqXQrx5K9SwW8F7fRYf9V4vWYFULh+UWwwkqkhX9w03ZqFYRTdkFku6uA==
+
+"@cspell/dict-en-common-misspellings@^2.0.8":
+  version "2.0.9"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-en-common-misspellings/-/dict-en-common-misspellings-2.0.9.tgz#0b123d2e46a16ef4cd3838c2ef3e9a50d8d6433e"
+  integrity sha512-O/jAr1VNtuyCFckbTmpeEf43ZFWVD9cJFvWaA6rO2IVmLirJViHWJUyBZOuQcesSplzEIw80MAYmnK06/MDWXQ==
+
+"@cspell/dict-en-gb@1.1.33":
+  version "1.1.33"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-en-gb/-/dict-en-gb-1.1.33.tgz#7f1fd90fc364a5cb77111b5438fc9fcf9cc6da0e"
+  integrity sha512-tKSSUf9BJEV+GJQAYGw5e+ouhEe2ZXE620S7BLKe3ZmpnjlNG9JqlnaBhkIMxKnNFkLY2BP/EARzw31AZnOv4g==
+
+"@cspell/dict-en_us@^4.3.29":
+  version "4.3.30"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-en_us/-/dict-en_us-4.3.30.tgz#6256eb7835369a295d2f7ac96867a18db5c17d72"
+  integrity sha512-p0G5fByj5fUnMyFUlkN3kaqE3nuQkqpYV47Gn9n8k2TszsdLY55xj9UoFE4YIcjOiyU1bR/YDJ5daiPMYXTJ/A==
+
+"@cspell/dict-filetypes@^3.0.10":
+  version "3.0.10"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-filetypes/-/dict-filetypes-3.0.10.tgz#1d8a22da3320e507d2c33496e5194b090320f89b"
+  integrity sha512-JEN3627joBVtpa1yfkdN9vz1Z129PoKGHBKjXCEziJvf2Zt1LeULWYYYg/O6pzRR4yzRa5YbXDTuyrN7vX7DFg==
+
+"@cspell/dict-flutter@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-flutter/-/dict-flutter-1.1.0.tgz#66ecc468024aa9b1c7fa57698801642b979cf05e"
+  integrity sha512-3zDeS7zc2p8tr9YH9tfbOEYfopKY/srNsAa+kE3rfBTtQERAZeOhe5yxrnTPoufctXLyuUtcGMUTpxr3dO0iaA==
+
+"@cspell/dict-fonts@^4.0.4":
+  version "4.0.4"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-fonts/-/dict-fonts-4.0.4.tgz#4d853cb147363d8a0d8ad8d8d212b950a58eb6f4"
+  integrity sha512-cHFho4hjojBcHl6qxidl9CvUb492IuSk7xIf2G2wJzcHwGaCFa2o3gRcxmIg1j62guetAeDDFELizDaJlVRIOg==
+
+"@cspell/dict-fsharp@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-fsharp/-/dict-fsharp-1.1.0.tgz#b14f6fff20486c45651303323e467534afdc6727"
+  integrity sha512-oguWmHhGzgbgbEIBKtgKPrFSVAFtvGHaQS0oj+vacZqMObwkapcTGu7iwf4V3Bc2T3caf0QE6f6rQfIJFIAVsw==
+
+"@cspell/dict-fullstack@^3.2.3":
+  version "3.2.3"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-fullstack/-/dict-fullstack-3.2.3.tgz#f6fff74eff00c6759cba510168acada0619004cc"
+  integrity sha512-62PbndIyQPH11mAv0PyiyT0vbwD0AXEocPpHlCHzfb5v9SspzCCbzQ/LIBiFmyRa+q5LMW35CnSVu6OXdT+LKg==
+
+"@cspell/dict-gaming-terms@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-gaming-terms/-/dict-gaming-terms-1.1.0.tgz#89b8b73796368a03ea6e0e4f04c6105110c66df9"
+  integrity sha512-46AnDs9XkgJ2f1Sqol1WgfJ8gOqp60fojpc9Wxch7x+BA63g4JfMV5/M5x0sI0TLlLY8EBSglcr8wQF/7C80AQ==
+
+"@cspell/dict-git@^3.0.4":
+  version "3.0.4"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-git/-/dict-git-3.0.4.tgz#3753f17a2a122f4dc734a51820fac7b6ffc594f1"
+  integrity sha512-C44M+m56rYn6QCsLbiKiedyPTMZxlDdEYAsPwwlL5bhMDDzXZ3Ic8OCQIhMbiunhCOJJT+er4URmOmM+sllnjg==
+
+"@cspell/dict-golang@^6.0.18":
+  version "6.0.18"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-golang/-/dict-golang-6.0.18.tgz#44e144409c3141ee58d854e49e118f7d264c9d43"
+  integrity sha512-Mt+7NwfodDwUk7423DdaQa0YaA+4UoV3XSxQwZioqjpFBCuxfvvv4l80MxCTAAbK6duGj0uHbGTwpv8fyKYPKg==
+
+"@cspell/dict-google@^1.0.5":
+  version "1.0.7"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-google/-/dict-google-1.0.7.tgz#cfd97dda4b410588ddf9de80f483e14b9b3c16ef"
+  integrity sha512-2ArNqLFUbjhzpPEMLiUUZKDpM4kBd3iWem6OPAp9PKIPhPsEQkkWJFLE5e0X68TdUUPH+ISM9BVmsB9GyRQBng==
+
+"@cspell/dict-haskell@^4.0.5":
+  version "4.0.5"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-haskell/-/dict-haskell-4.0.5.tgz#260f5412cfe5ef3ca7cd3604ecd93142e63c2a3a"
+  integrity sha512-s4BG/4tlj2pPM9Ha7IZYMhUujXDnI0Eq1+38UTTCpatYLbQqDwRFf2KNPLRqkroU+a44yTUAe0rkkKbwy4yRtQ==
+
+"@cspell/dict-html-symbol-entities@^4.0.3":
+  version "4.0.3"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-html-symbol-entities/-/dict-html-symbol-entities-4.0.3.tgz#bf2887020ca4774413d8b1f27c9b6824ba89e9ef"
+  integrity sha512-aABXX7dMLNFdSE8aY844X4+hvfK7977sOWgZXo4MTGAmOzR8524fjbJPswIBK7GaD3+SgFZ2yP2o0CFvXDGF+A==
+
+"@cspell/dict-html@^4.0.11":
+  version "4.0.11"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-html/-/dict-html-4.0.11.tgz#410db0e062620841342f596b9187776091f81d44"
+  integrity sha512-QR3b/PB972SRQ2xICR1Nw/M44IJ6rjypwzA4jn+GH8ydjAX9acFNfc+hLZVyNe0FqsE90Gw3evLCOIF0vy1vQw==
+
+"@cspell/dict-java@^5.0.11":
+  version "5.0.11"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-java/-/dict-java-5.0.11.tgz#3cb0c7e8cf18d1da206fab3b5dbb64bd693a51f5"
+  integrity sha512-T4t/1JqeH33Raa/QK/eQe26FE17eUCtWu+JsYcTLkQTci2dk1DfcIKo8YVHvZXBnuM43ATns9Xs0s+AlqDeH7w==
+
+"@cspell/dict-julia@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-julia/-/dict-julia-1.1.0.tgz#06302765dbdb13023be506c27c26b2f3e475d1cc"
+  integrity sha512-CPUiesiXwy3HRoBR3joUseTZ9giFPCydSKu2rkh6I2nVjXnl5vFHzOMLXpbF4HQ1tH2CNfnDbUndxD+I+7eL9w==
+
+"@cspell/dict-k8s@^1.0.10":
   version "1.0.10"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-node/-/dict-node-1.0.10.tgz#ed78fd80cb99087a817bc7773e64f1e8431171b5"
-  integrity sha512-MnLy0pOcd+Zo8+M8VmumrIQN5SuAduZZrYKHhvXfxdVfX5vl5BfD6Gl25hzH0DrlAVlJOWAnkMZZFMYh4nGWRA==
+  resolved "https://registry.yarnpkg.com/@cspell/dict-k8s/-/dict-k8s-1.0.10.tgz#3f4f77a47d6062d66e85651a05482ad62dd65180"
+  integrity sha512-313haTrX9prep1yWO7N6Xw4D6tvUJ0Xsx+YhCP+5YrrcIKoEw5Rtlg8R4PPzLqe6zibw6aJ+Eqq+y76Vx5BZkw==
+
+"@cspell/dict-kotlin@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-kotlin/-/dict-kotlin-1.1.0.tgz#67daf596e14b03a88152b2d124bc2bfa05c49717"
+  integrity sha512-vySaVw6atY7LdwvstQowSbdxjXG6jDhjkWVWSjg1XsUckyzH1JRHXe9VahZz1i7dpoFEUOWQrhIe5B9482UyJQ==
+
+"@cspell/dict-latex@^4.0.3":
+  version "4.0.3"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-latex/-/dict-latex-4.0.3.tgz#a1254c7d9c3a2d70cd6391a9f2f7694431b1b2cb"
+  integrity sha512-2KXBt9fSpymYHxHfvhUpjUFyzrmN4c4P8mwIzweLyvqntBT3k0YGZJSriOdjfUjwSygrfEwiuPI1EMrvgrOMJw==
+
+"@cspell/dict-lorem-ipsum@^4.0.4":
+  version "4.0.4"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-lorem-ipsum/-/dict-lorem-ipsum-4.0.4.tgz#8f83771617109b060c7d7713cb090ca43f64c97c"
+  integrity sha512-+4f7vtY4dp2b9N5fn0za/UR0kwFq2zDtA62JCbWHbpjvO9wukkbl4rZg4YudHbBgkl73HRnXFgCiwNhdIA1JPw==
+
+"@cspell/dict-lua@^4.0.7":
+  version "4.0.7"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-lua/-/dict-lua-4.0.7.tgz#36559f77d8e036d058a29ab69da839bcb00d5918"
+  integrity sha512-Wbr7YSQw+cLHhTYTKV6cAljgMgcY+EUAxVIZW3ljKswEe4OLxnVJ7lPqZF5JKjlXdgCjbPSimsHqyAbC5pQN/Q==
+
+"@cspell/dict-makefile@^1.0.4":
+  version "1.0.4"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-makefile/-/dict-makefile-1.0.4.tgz#52ea60fbf30a9814229c222788813bf93cbf1f3e"
+  integrity sha512-E4hG/c0ekPqUBvlkrVvzSoAA+SsDA9bLi4xSV3AXHTVru7Y2bVVGMPtpfF+fI3zTkww/jwinprcU1LSohI3ylw==
 
-"@cspell/dict-npm@^1.0.10":
+"@cspell/dict-markdown@^2.0.9":
+  version "2.0.9"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-markdown/-/dict-markdown-2.0.9.tgz#0ecf2703fb69b47494bac81557d539cb4a541939"
+  integrity sha512-j2e6Eg18BlTb1mMP1DkyRFMM/FLS7qiZjltpURzDckB57zDZbUyskOFdl4VX7jItZZEeY0fe22bSPOycgS1Z5A==
+
+"@cspell/dict-monkeyc@^1.0.10":
   version "1.0.10"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-npm/-/dict-npm-1.0.10.tgz#327ad3855effcfbf6d2dbb6f655ed29e729dd7a8"
-  integrity sha512-LxLjMOyELWtVBHpive60G3MJseid30M9GR5Vodo9cT6lqT1CkbdsNP9j3oTwVXHTMKB3I+IOHNapuFG1ILcEew==
+  resolved "https://registry.yarnpkg.com/@cspell/dict-monkeyc/-/dict-monkeyc-1.0.10.tgz#21955a891b27270424c6e1edaaa4b444fb077c4f"
+  integrity sha512-7RTGyKsTIIVqzbvOtAu6Z/lwwxjGRtY5RkKPlXKHEoEAgIXwfDxb5EkVwzGQwQr8hF/D3HrdYbRT8MFBfsueZw==
+
+"@cspell/dict-node@^5.0.6":
+  version "5.0.6"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-node/-/dict-node-5.0.6.tgz#80f156f79f15d58c5d4df89358314e128070ad98"
+  integrity sha512-CEbhPCpxGvRNByGolSBTrXXW2rJA4bGqZuTx1KKO85mwR6aadeOmUE7xf/8jiCkXSy+qvr9aJeh+jlfXcsrziQ==
+
+"@cspell/dict-npm@^5.1.22":
+  version "5.1.23"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-npm/-/dict-npm-5.1.23.tgz#fdf2a1231dd4aa04672286c3c3bf6160aa80c730"
+  integrity sha512-/xK7G1/H5M73J3CAb3WmVXlMbK6zjZrfwmOOBiB7SSbK6h7/WmwRBuLC0UwO50x07NJUuVmJek5ELaNa81guVw==
+
+"@cspell/dict-php@^4.0.14":
+  version "4.0.14"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-php/-/dict-php-4.0.14.tgz#96d2b99816312bf6f52bc099af9dfea7994ff15e"
+  integrity sha512-7zur8pyncYZglxNmqsRycOZ6inpDoVd4yFfz1pQRe5xaRWMiK3Km4n0/X/1YMWhh3e3Sl/fQg5Axb2hlN68t1g==
+
+"@cspell/dict-powershell@^5.0.14":
+  version "5.0.14"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-powershell/-/dict-powershell-5.0.14.tgz#c8d676e1548c45069dc211e8427335e421ab1cd7"
+  integrity sha512-ktjjvtkIUIYmj/SoGBYbr3/+CsRGNXGpvVANrY0wlm/IoGlGywhoTUDYN0IsGwI2b8Vktx3DZmQkfb3Wo38jBA==
+
+"@cspell/dict-public-licenses@^2.0.12":
+  version "2.0.13"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-public-licenses/-/dict-public-licenses-2.0.13.tgz#904c8b97ffb60691d28cce0fb5186a8dd473587d"
+  integrity sha512-1Wdp/XH1ieim7CadXYE7YLnUlW0pULEjVl9WEeziZw3EKCAw8ZI8Ih44m4bEa5VNBLnuP5TfqC4iDautAleQzQ==
+
+"@cspell/dict-python@^4.2.14":
+  version "4.2.15"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-python/-/dict-python-4.2.15.tgz#97c2d3ce3becc4dcb061f444232e903f9723cd16"
+  integrity sha512-VNXhj0Eh+hdHN89MgyaoSAexBQKmYtJaMhucbMI7XmBs4pf8fuFFN3xugk51/A4TZJr8+RImdFFsGMOw+I4bDA==
+  dependencies:
+    "@cspell/dict-data-science" "^2.0.7"
+
+"@cspell/dict-r@^2.1.0":
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-r/-/dict-r-2.1.0.tgz#147a01b36fc4ae2381c88a00b1f8ba7fad77a4f1"
+  integrity sha512-k2512wgGG0lTpTYH9w5Wwco+lAMf3Vz7mhqV8+OnalIE7muA0RSuD9tWBjiqLcX8zPvEJr4LdgxVju8Gk3OKyA==
 
-"@cspell/dict-php@^1.0.23":
-  version "1.0.23"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-php/-/dict-php-1.0.23.tgz#8ee85fec8416a88b71edb2a53e26a79f280c9fa7"
-  integrity sha512-rRLf/09rXDrzs0DJuNXNmFVTw2b2zLmZKNF4LIPrFHYHvdfsMvwVqxkr/SAyhF8C6zi5sW0XYC/J0S/3IE927w==
+"@cspell/dict-ruby@^5.0.7":
+  version "5.0.7"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-ruby/-/dict-ruby-5.0.7.tgz#3593a955baaffe3c5d28fb178b72fdf93c7eec71"
+  integrity sha512-4/d0hcoPzi5Alk0FmcyqlzFW9lQnZh9j07MJzPcyVO62nYJJAGKaPZL2o4qHeCS/od/ctJC5AHRdoUm0ktsw6Q==
 
-"@cspell/dict-powershell@^1.0.14":
-  version "1.0.14"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-powershell/-/dict-powershell-1.0.14.tgz#f8998f2f413b3b94e69a512117de89552cfa1834"
-  integrity sha512-hisOXXi5PBXB5YKtrJQIis2FIRHgSW1U0/sd4yI36lzb3ZMEvGJwdAdyhXN3IGiqRUNxMzJiXAeXfhnia4xPtQ==
+"@cspell/dict-rust@^4.0.11":
+  version "4.0.11"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-rust/-/dict-rust-4.0.11.tgz#4b6d1839dbcca7e50e2e4e2b1c45d785d2634b14"
+  integrity sha512-OGWDEEzm8HlkSmtD8fV3pEcO2XBpzG2XYjgMCJCRwb2gRKvR+XIm6Dlhs04N/K2kU+iH8bvrqNpM8fS/BFl0uw==
 
-"@cspell/dict-python@^1.0.33":
-  version "1.0.33"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-python/-/dict-python-1.0.33.tgz#39ddf401f63ee9b0f95e606d70693e61976a073b"
-  integrity sha512-tRmE4TzHDFPs7sJ1a3XbfyFrvRHwefVz+z1wkm6tkXK9TPrCbIS+rV/T8xhj205q4lpZQ/TkNB3lT40eLB9O8A==
+"@cspell/dict-scala@^5.0.7":
+  version "5.0.7"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-scala/-/dict-scala-5.0.7.tgz#831516fb1434b0fc867254cfb4a343eb0aaadeab"
+  integrity sha512-yatpSDW/GwulzO3t7hB5peoWwzo+Y3qTc0pO24Jf6f88jsEeKmDeKkfgPbYuCgbE4jisGR4vs4+jfQZDIYmXPA==
 
-"@cspell/dict-ruby@^1.0.12":
-  version "1.0.12"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-ruby/-/dict-ruby-1.0.12.tgz#85af4c0c7e0d03c39115d4a2d1944befe31e04f8"
-  integrity sha512-1qGZpVbfWfGLujKFyt2Nd9bc7rNXdkjYIRfpGmn/fwVDhWz/D4Q8GLMQPB2ixocSuF3pjfsRTh1D+rKK17WFjg==
-
-"@cspell/dict-rust@^1.0.22":
-  version "1.0.22"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-rust/-/dict-rust-1.0.22.tgz#4558e528c1e1aa2b0f1677d5918fa822106013e5"
-  integrity sha512-7WOIzv0BPiU+MssZbbMk8K+HR/g9Bcvd0+jXJC3/AKT8L6l0Mx0Tr/oF7cJ4xvCYgA84nBz3PhMZkabGSz/Nkg==
-
-"@cspell/dict-scala@^1.0.21":
-  version "1.0.21"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-scala/-/dict-scala-1.0.21.tgz#bfda392329061e2352fbcd33d228617742c93831"
-  integrity sha512-5V/R7PRbbminTpPS3ywgdAalI9BHzcEjEj9ug4kWYvBIGwSnS7T6QCFCiu+e9LvEGUqQC+NHgLY4zs1NaBj2vA==
-
-"@cspell/dict-software-terms@^1.0.25":
-  version "1.0.26"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-software-terms/-/dict-software-terms-1.0.26.tgz#ce504130dfa3c6ebef58c5c5e41d30484ab5f7e8"
-  integrity sha512-NN+mv6VnCwxEWzGxOgFG4akDIRvY0j8slHmgxtoPGKDm+K22zvZITxFwF3/NHGOSxQ4n2hW6sYjqMpxAPGhjCQ==
-
-"@cspell/dict-typescript@^1.0.16":
-  version "1.0.16"
-  resolved "https://registry.yarnpkg.com/@cspell/dict-typescript/-/dict-typescript-1.0.16.tgz#18d20a91c4caf52540c795921a50b0e4ce3bc50c"
-  integrity sha512-DEKi6vD605ebDhCC4Hrtz29k59TcijPVsmVKheTpMrL1MD/S96Ftb19gW0pEIVK9vwYZIljmGwgz4qYyuM5Liw==
-
-"@esbuild/aix-ppc64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/aix-ppc64/-/aix-ppc64-0.23.0.tgz#145b74d5e4a5223489cabdc238d8dad902df5259"
-  integrity sha512-3sG8Zwa5fMcA9bgqB8AfWPQ+HFke6uD3h1s3RIwUNK8EG7a4buxvuFTs3j1IMs2NXAk9F30C/FF4vxRgQCcmoQ==
-
-"@esbuild/android-arm64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/android-arm64/-/android-arm64-0.23.0.tgz#453bbe079fc8d364d4c5545069e8260228559832"
-  integrity sha512-EuHFUYkAVfU4qBdyivULuu03FhJO4IJN9PGuABGrFy4vUuzk91P2d+npxHcFdpUnfYKy0PuV+n6bKIpHOB3prQ==
-
-"@esbuild/android-arm@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/android-arm/-/android-arm-0.23.0.tgz#26c806853aa4a4f7e683e519cd9d68e201ebcf99"
-  integrity sha512-+KuOHTKKyIKgEEqKbGTK8W7mPp+hKinbMBeEnNzjJGyFcWsfrXjSTNluJHCY1RqhxFurdD8uNXQDei7qDlR6+g==
-
-"@esbuild/android-x64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/android-x64/-/android-x64-0.23.0.tgz#1e51af9a6ac1f7143769f7ee58df5b274ed202e6"
-  integrity sha512-WRrmKidLoKDl56LsbBMhzTTBxrsVwTKdNbKDalbEZr0tcsBgCLbEtoNthOW6PX942YiYq8HzEnb4yWQMLQuipQ==
-
-"@esbuild/darwin-arm64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/darwin-arm64/-/darwin-arm64-0.23.0.tgz#d996187a606c9534173ebd78c58098a44dd7ef9e"
-  integrity sha512-YLntie/IdS31H54Ogdn+v50NuoWF5BDkEUFpiOChVa9UnKpftgwzZRrI4J132ETIi+D8n6xh9IviFV3eXdxfow==
-
-"@esbuild/darwin-x64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/darwin-x64/-/darwin-x64-0.23.0.tgz#30c8f28a7ef4e32fe46501434ebe6b0912e9e86c"
-  integrity sha512-IMQ6eme4AfznElesHUPDZ+teuGwoRmVuuixu7sv92ZkdQcPbsNHzutd+rAfaBKo8YK3IrBEi9SLLKWJdEvJniQ==
-
-"@esbuild/freebsd-arm64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.23.0.tgz#30f4fcec8167c08a6e8af9fc14b66152232e7fb4"
-  integrity sha512-0muYWCng5vqaxobq6LB3YNtevDFSAZGlgtLoAc81PjUfiFz36n4KMpwhtAd4he8ToSI3TGyuhyx5xmiWNYZFyw==
-
-"@esbuild/freebsd-x64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-x64/-/freebsd-x64-0.23.0.tgz#1003a6668fe1f5d4439e6813e5b09a92981bc79d"
-  integrity sha512-XKDVu8IsD0/q3foBzsXGt/KjD/yTKBCIwOHE1XwiXmrRwrX6Hbnd5Eqn/WvDekddK21tfszBSrE/WMaZh+1buQ==
-
-"@esbuild/linux-arm64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm64/-/linux-arm64-0.23.0.tgz#3b9a56abfb1410bb6c9138790f062587df3e6e3a"
-  integrity sha512-j1t5iG8jE7BhonbsEg5d9qOYcVZv/Rv6tghaXM/Ug9xahM0nX/H2gfu6X6z11QRTMT6+aywOMA8TDkhPo8aCGw==
-
-"@esbuild/linux-arm@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm/-/linux-arm-0.23.0.tgz#237a8548e3da2c48cd79ae339a588f03d1889aad"
-  integrity sha512-SEELSTEtOFu5LPykzA395Mc+54RMg1EUgXP+iw2SJ72+ooMwVsgfuwXo5Fn0wXNgWZsTVHwY2cg4Vi/bOD88qw==
-
-"@esbuild/linux-ia32@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-ia32/-/linux-ia32-0.23.0.tgz#4269cd19cb2de5de03a7ccfc8855dde3d284a238"
-  integrity sha512-P7O5Tkh2NbgIm2R6x1zGJJsnacDzTFcRWZyTTMgFdVit6E98LTxO+v8LCCLWRvPrjdzXHx9FEOA8oAZPyApWUA==
-
-"@esbuild/linux-loong64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-loong64/-/linux-loong64-0.23.0.tgz#82b568f5658a52580827cc891cb69d2cb4f86280"
-  integrity sha512-InQwepswq6urikQiIC/kkx412fqUZudBO4SYKu0N+tGhXRWUqAx+Q+341tFV6QdBifpjYgUndV1hhMq3WeJi7A==
-
-"@esbuild/linux-mips64el@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-mips64el/-/linux-mips64el-0.23.0.tgz#9a57386c926262ae9861c929a6023ed9d43f73e5"
-  integrity sha512-J9rflLtqdYrxHv2FqXE2i1ELgNjT+JFURt/uDMoPQLcjWQA5wDKgQA4t/dTqGa88ZVECKaD0TctwsUfHbVoi4w==
-
-"@esbuild/linux-ppc64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-ppc64/-/linux-ppc64-0.23.0.tgz#f3a79fd636ba0c82285d227eb20ed8e31b4444f6"
-  integrity sha512-cShCXtEOVc5GxU0fM+dsFD10qZ5UpcQ8AM22bYj0u/yaAykWnqXJDpd77ublcX6vdDsWLuweeuSNZk4yUxZwtw==
-
-"@esbuild/linux-riscv64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-riscv64/-/linux-riscv64-0.23.0.tgz#f9d2ef8356ce6ce140f76029680558126b74c780"
-  integrity sha512-HEtaN7Y5UB4tZPeQmgz/UhzoEyYftbMXrBCUjINGjh3uil+rB/QzzpMshz3cNUxqXN7Vr93zzVtpIDL99t9aRw==
-
-"@esbuild/linux-s390x@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-s390x/-/linux-s390x-0.23.0.tgz#45390f12e802201f38a0229e216a6aed4351dfe8"
-  integrity sha512-WDi3+NVAuyjg/Wxi+o5KPqRbZY0QhI9TjrEEm+8dmpY9Xir8+HE/HNx2JoLckhKbFopW0RdO2D72w8trZOV+Wg==
-
-"@esbuild/linux-x64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/linux-x64/-/linux-x64-0.23.0.tgz#c8409761996e3f6db29abcf9b05bee8d7d80e910"
-  integrity sha512-a3pMQhUEJkITgAw6e0bWA+F+vFtCciMjW/LPtoj99MhVt+Mfb6bbL9hu2wmTZgNd994qTAEw+U/r6k3qHWWaOQ==
-
-"@esbuild/netbsd-x64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/netbsd-x64/-/netbsd-x64-0.23.0.tgz#ba70db0114380d5f6cfb9003f1d378ce989cd65c"
-  integrity sha512-cRK+YDem7lFTs2Q5nEv/HHc4LnrfBCbH5+JHu6wm2eP+d8OZNoSMYgPZJq78vqQ9g+9+nMuIsAO7skzphRXHyw==
-
-"@esbuild/openbsd-arm64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/openbsd-arm64/-/openbsd-arm64-0.23.0.tgz#72fc55f0b189f7a882e3cf23f332370d69dfd5db"
-  integrity sha512-suXjq53gERueVWu0OKxzWqk7NxiUWSUlrxoZK7usiF50C6ipColGR5qie2496iKGYNLhDZkPxBI3erbnYkU0rQ==
-
-"@esbuild/openbsd-x64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/openbsd-x64/-/openbsd-x64-0.23.0.tgz#b6ae7a0911c18fe30da3db1d6d17a497a550e5d8"
-  integrity sha512-6p3nHpby0DM/v15IFKMjAaayFhqnXV52aEmv1whZHX56pdkK+MEaLoQWj+H42ssFarP1PcomVhbsR4pkz09qBg==
-
-"@esbuild/sunos-x64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/sunos-x64/-/sunos-x64-0.23.0.tgz#58f0d5e55b9b21a086bfafaa29f62a3eb3470ad8"
-  integrity sha512-BFelBGfrBwk6LVrmFzCq1u1dZbG4zy/Kp93w2+y83Q5UGYF1d8sCzeLI9NXjKyujjBBniQa8R8PzLFAUrSM9OA==
-
-"@esbuild/win32-arm64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/win32-arm64/-/win32-arm64-0.23.0.tgz#b858b2432edfad62e945d5c7c9e5ddd0f528ca6d"
-  integrity sha512-lY6AC8p4Cnb7xYHuIxQ6iYPe6MfO2CC43XXKo9nBXDb35krYt7KGhQnOkRGar5psxYkircpCqfbNDB4uJbS2jQ==
-
-"@esbuild/win32-ia32@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/win32-ia32/-/win32-ia32-0.23.0.tgz#167ef6ca22a476c6c0c014a58b4f43ae4b80dec7"
-  integrity sha512-7L1bHlOTcO4ByvI7OXVI5pNN6HSu6pUQq9yodga8izeuB1KcT2UkHaH6118QJwopExPn0rMHIseCTx1CRo/uNA==
-
-"@esbuild/win32-x64@0.23.0":
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/@esbuild/win32-x64/-/win32-x64-0.23.0.tgz#db44a6a08520b5f25bbe409f34a59f2d4bcc7ced"
-  integrity sha512-Arm+WgUFLUATuoxCJcahGuk6Yj9Pzxd6l11Zb/2aAuv5kWWvvfhLFo2fni4uSK5vzlUdCGZ/BdV5tH8klj8p8g==
+"@cspell/dict-shell@1.1.0", "@cspell/dict-shell@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-shell/-/dict-shell-1.1.0.tgz#3110d5c81cb5bd7f6c0cc88e6e8ac7ccf6fa65b5"
+  integrity sha512-D/xHXX7T37BJxNRf5JJHsvziFDvh23IF/KvkZXNSh8VqcRdod3BAz9VGHZf6VDqcZXr1VRqIYR3mQ8DSvs3AVQ==
+
+"@cspell/dict-software-terms@^4.2.2":
+  version "4.2.4"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-software-terms/-/dict-software-terms-4.2.4.tgz#3bc651f2fc49bb2d2ffe5b2ec762d67d3565e342"
+  integrity sha512-GRkuaFfjFHPYynyRMuisKyE3gRiVK0REClRWfnH9+5iCs5TKDURsMpWJGNsgQ6N5jAKKrtWXVKjepkDHjMldjQ==
+
+"@cspell/dict-sql@^2.2.0":
+  version "2.2.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-sql/-/dict-sql-2.2.0.tgz#850fc6eaa38e11e413712f332ab03bee4bd652ce"
+  integrity sha512-MUop+d1AHSzXpBvQgQkCiok8Ejzb+nrzyG16E8TvKL2MQeDwnIvMe3bv90eukP6E1HWb+V/MA/4pnq0pcJWKqQ==
+
+"@cspell/dict-svelte@^1.0.6":
+  version "1.0.6"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-svelte/-/dict-svelte-1.0.6.tgz#367b3e743475e7641caa8b750b222374be2c4d38"
+  integrity sha512-8LAJHSBdwHCoKCSy72PXXzz7ulGROD0rP1CQ0StOqXOOlTUeSFaJJlxNYjlONgd2c62XBQiN2wgLhtPN+1Zv7Q==
+
+"@cspell/dict-swift@^2.0.5":
+  version "2.0.5"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-swift/-/dict-swift-2.0.5.tgz#72d37a3ea53d6a9ec1f4b553959268ce58acff28"
+  integrity sha512-3lGzDCwUmnrfckv3Q4eVSW3sK3cHqqHlPprFJZD4nAqt23ot7fic5ALR7J4joHpvDz36nHX34TgcbZNNZOC/JA==
+
+"@cspell/dict-terraform@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-terraform/-/dict-terraform-1.1.0.tgz#2775b588607ec879fdbad91bef6f0994d7b4653d"
+  integrity sha512-G55pcUUxeXAhejstmD35B47SkFd4uqCQimc+CMgq8Nx0dr03guL2iMsz8faRWQGkCnGimX8S91rbOhDv9p/heg==
+
+"@cspell/dict-typescript@^3.2.0":
+  version "3.2.0"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-typescript/-/dict-typescript-3.2.0.tgz#6133c086cf11c3823450860e6221fe256c48434d"
+  integrity sha512-Pk3zNePLT8qg51l0M4g1ISowYAEGxTuNfZlgkU5SvHa9Cu7x/BWoyYq9Fvc3kAyoisCjRPyvWF4uRYrPitPDFw==
+
+"@cspell/dict-vue@^3.0.4":
+  version "3.0.4"
+  resolved "https://registry.yarnpkg.com/@cspell/dict-vue/-/dict-vue-3.0.4.tgz#0f1cb65e2f640925de72acbc1cae9e87f7727c05"
+  integrity sha512-0dPtI0lwHcAgSiQFx8CzvqjdoXROcH+1LyqgROCpBgppommWpVhbQ0eubnKotFEXgpUCONVkeZJ6Ql8NbTEu+w==
+
+"@cspell/dynamic-import@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/dynamic-import/-/dynamic-import-8.17.2.tgz#31103d736a3bd308866b3ec584541a8d0f711725"
+  integrity sha512-n3AVbyBlTn/pLtYK62mqgDfJIuQHUTY/k8SMUCjyjfgoqd3LcKhS1PmbLfDWPMTODK30cSMMTLejjy2bL6ksEw==
+  dependencies:
+    "@cspell/url" "8.17.2"
+    import-meta-resolve "^4.1.0"
+
+"@cspell/filetypes@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/filetypes/-/filetypes-8.17.2.tgz#3c1620fbcc7e87f5476b7c6afb565beea541624d"
+  integrity sha512-2B+dB4Ls2xiOjg+vEEbAuJTHtMfXSihVzfLGnj9+qUfq47iqrz4ZBvCOfZhYdiVaaZJoZUgIw8ljrUfqFzYDAg==
+
+"@cspell/strong-weak-map@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/strong-weak-map/-/strong-weak-map-8.17.2.tgz#22303034d969e36adc5a8eca363379d9b05ddbee"
+  integrity sha512-LbbhdVwtqyJ71X+O7e2PqpDp7zLiY8jmW2CJFLjZYWTUawgav2bpwECGq6O9Gnwqe+fj7yWxGJFDSpXQcCJQAw==
+
+"@cspell/url@8.17.2":
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/@cspell/url/-/url-8.17.2.tgz#81f8cd7d31b7d160971a207da5b6486eebc5aecb"
+  integrity sha512-yy4eYWNX2iutXmy4Igbn/hL/NYaNt94DylohPtgVr0Zxnn/AAArt9Bv1KXPpjB8VFy2wzzPzWmZ+MWDUVpHCbg==
+
+"@esbuild/aix-ppc64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/aix-ppc64/-/aix-ppc64-0.23.1.tgz#51299374de171dbd80bb7d838e1cfce9af36f353"
+  integrity sha512-6VhYk1diRqrhBAqpJEdjASR/+WVRtfjpqKuNw11cLiaWpAT/Uu+nokB+UJnevzy/P9C/ty6AOe0dwueMrGh/iQ==
+
+"@esbuild/android-arm64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-arm64/-/android-arm64-0.23.1.tgz#58565291a1fe548638adb9c584237449e5e14018"
+  integrity sha512-xw50ipykXcLstLeWH7WRdQuysJqejuAGPd30vd1i5zSyKK3WE+ijzHmLKxdiCMtH1pHz78rOg0BKSYOSB/2Khw==
+
+"@esbuild/android-arm@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-arm/-/android-arm-0.23.1.tgz#5eb8c652d4c82a2421e3395b808e6d9c42c862ee"
+  integrity sha512-uz6/tEy2IFm9RYOyvKl88zdzZfwEfKZmnX9Cj1BHjeSGNuGLuMD1kR8y5bteYmwqKm1tj8m4cb/aKEorr6fHWQ==
+
+"@esbuild/android-x64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/android-x64/-/android-x64-0.23.1.tgz#ae19d665d2f06f0f48a6ac9a224b3f672e65d517"
+  integrity sha512-nlN9B69St9BwUoB+jkyU090bru8L0NA3yFvAd7k8dNsVH8bi9a8cUAUSEcEEgTp2z3dbEDGJGfP6VUnkQnlReg==
+
+"@esbuild/darwin-arm64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/darwin-arm64/-/darwin-arm64-0.23.1.tgz#05b17f91a87e557b468a9c75e9d85ab10c121b16"
+  integrity sha512-YsS2e3Wtgnw7Wq53XXBLcV6JhRsEq8hkfg91ESVadIrzr9wO6jJDMZnCQbHm1Guc5t/CdDiFSSfWP58FNuvT3Q==
+
+"@esbuild/darwin-x64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/darwin-x64/-/darwin-x64-0.23.1.tgz#c58353b982f4e04f0d022284b8ba2733f5ff0931"
+  integrity sha512-aClqdgTDVPSEGgoCS8QDG37Gu8yc9lTHNAQlsztQ6ENetKEO//b8y31MMu2ZaPbn4kVsIABzVLXYLhCGekGDqw==
+
+"@esbuild/freebsd-arm64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.23.1.tgz#f9220dc65f80f03635e1ef96cfad5da1f446f3bc"
+  integrity sha512-h1k6yS8/pN/NHlMl5+v4XPfikhJulk4G+tKGFIOwURBSFzE8bixw1ebjluLOjfwtLqY0kewfjLSrO6tN2MgIhA==
+
+"@esbuild/freebsd-x64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/freebsd-x64/-/freebsd-x64-0.23.1.tgz#69bd8511fa013b59f0226d1609ac43f7ce489730"
+  integrity sha512-lK1eJeyk1ZX8UklqFd/3A60UuZ/6UVfGT2LuGo3Wp4/z7eRTRYY+0xOu2kpClP+vMTi9wKOfXi2vjUpO1Ro76g==
+
+"@esbuild/linux-arm64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm64/-/linux-arm64-0.23.1.tgz#8050af6d51ddb388c75653ef9871f5ccd8f12383"
+  integrity sha512-/93bf2yxencYDnItMYV/v116zff6UyTjo4EtEQjUBeGiVpMmffDNUyD9UN2zV+V3LRV3/on4xdZ26NKzn6754g==
+
+"@esbuild/linux-arm@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-arm/-/linux-arm-0.23.1.tgz#ecaabd1c23b701070484990db9a82f382f99e771"
+  integrity sha512-CXXkzgn+dXAPs3WBwE+Kvnrf4WECwBdfjfeYHpMeVxWE0EceB6vhWGShs6wi0IYEqMSIzdOF1XjQ/Mkm5d7ZdQ==
+
+"@esbuild/linux-ia32@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-ia32/-/linux-ia32-0.23.1.tgz#3ed2273214178109741c09bd0687098a0243b333"
+  integrity sha512-VTN4EuOHwXEkXzX5nTvVY4s7E/Krz7COC8xkftbbKRYAl96vPiUssGkeMELQMOnLOJ8k3BY1+ZY52tttZnHcXQ==
+
+"@esbuild/linux-loong64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-loong64/-/linux-loong64-0.23.1.tgz#a0fdf440b5485c81b0fbb316b08933d217f5d3ac"
+  integrity sha512-Vx09LzEoBa5zDnieH8LSMRToj7ir/Jeq0Gu6qJ/1GcBq9GkfoEAoXvLiW1U9J1qE/Y/Oyaq33w5p2ZWrNNHNEw==
+
+"@esbuild/linux-mips64el@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-mips64el/-/linux-mips64el-0.23.1.tgz#e11a2806346db8375b18f5e104c5a9d4e81807f6"
+  integrity sha512-nrFzzMQ7W4WRLNUOU5dlWAqa6yVeI0P78WKGUo7lg2HShq/yx+UYkeNSE0SSfSure0SqgnsxPvmAUu/vu0E+3Q==
+
+"@esbuild/linux-ppc64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-ppc64/-/linux-ppc64-0.23.1.tgz#06a2744c5eaf562b1a90937855b4d6cf7c75ec96"
+  integrity sha512-dKN8fgVqd0vUIjxuJI6P/9SSSe/mB9rvA98CSH2sJnlZ/OCZWO1DJvxj8jvKTfYUdGfcq2dDxoKaC6bHuTlgcw==
+
+"@esbuild/linux-riscv64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-riscv64/-/linux-riscv64-0.23.1.tgz#65b46a2892fc0d1af4ba342af3fe0fa4a8fe08e7"
+  integrity sha512-5AV4Pzp80fhHL83JM6LoA6pTQVWgB1HovMBsLQ9OZWLDqVY8MVobBXNSmAJi//Csh6tcY7e7Lny2Hg1tElMjIA==
+
+"@esbuild/linux-s390x@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-s390x/-/linux-s390x-0.23.1.tgz#e71ea18c70c3f604e241d16e4e5ab193a9785d6f"
+  integrity sha512-9ygs73tuFCe6f6m/Tb+9LtYxWR4c9yg7zjt2cYkjDbDpV/xVn+68cQxMXCjUpYwEkze2RcU/rMnfIXNRFmSoDw==
+
+"@esbuild/linux-x64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/linux-x64/-/linux-x64-0.23.1.tgz#d47f97391e80690d4dfe811a2e7d6927ad9eed24"
+  integrity sha512-EV6+ovTsEXCPAp58g2dD68LxoP/wK5pRvgy0J/HxPGB009omFPv3Yet0HiaqvrIrgPTBuC6wCH1LTOY91EO5hQ==
+
+"@esbuild/netbsd-x64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/netbsd-x64/-/netbsd-x64-0.23.1.tgz#44e743c9778d57a8ace4b72f3c6b839a3b74a653"
+  integrity sha512-aevEkCNu7KlPRpYLjwmdcuNz6bDFiE7Z8XC4CPqExjTvrHugh28QzUXVOZtiYghciKUacNktqxdpymplil1beA==
+
+"@esbuild/openbsd-arm64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/openbsd-arm64/-/openbsd-arm64-0.23.1.tgz#05c5a1faf67b9881834758c69f3e51b7dee015d7"
+  integrity sha512-3x37szhLexNA4bXhLrCC/LImN/YtWis6WXr1VESlfVtVeoFJBRINPJ3f0a/6LV8zpikqoUg4hyXw0sFBt5Cr+Q==
+
+"@esbuild/openbsd-x64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/openbsd-x64/-/openbsd-x64-0.23.1.tgz#2e58ae511bacf67d19f9f2dcd9e8c5a93f00c273"
+  integrity sha512-aY2gMmKmPhxfU+0EdnN+XNtGbjfQgwZj43k8G3fyrDM/UdZww6xrWxmDkuz2eCZchqVeABjV5BpildOrUbBTqA==
+
+"@esbuild/sunos-x64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/sunos-x64/-/sunos-x64-0.23.1.tgz#adb022b959d18d3389ac70769cef5a03d3abd403"
+  integrity sha512-RBRT2gqEl0IKQABT4XTj78tpk9v7ehp+mazn2HbUeZl1YMdaGAQqhapjGTCe7uw7y0frDi4gS0uHzhvpFuI1sA==
+
+"@esbuild/win32-arm64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-arm64/-/win32-arm64-0.23.1.tgz#84906f50c212b72ec360f48461d43202f4c8b9a2"
+  integrity sha512-4O+gPR5rEBe2FpKOVyiJ7wNDPA8nGzDuJ6gN4okSA1gEOYZ67N8JPk58tkWtdtPeLz7lBnY6I5L3jdsr3S+A6A==
+
+"@esbuild/win32-ia32@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-ia32/-/win32-ia32-0.23.1.tgz#5e3eacc515820ff729e90d0cb463183128e82fac"
+  integrity sha512-BcaL0Vn6QwCwre3Y717nVHZbAa4UBEigzFm6VdsVdT/MbZ38xoj1X9HPkZhbmaBGUD1W8vxAfffbDe8bA6AKnQ==
+
+"@esbuild/win32-x64@0.23.1":
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/@esbuild/win32-x64/-/win32-x64-0.23.1.tgz#81fd50d11e2c32b2d6241470e3185b70c7b30699"
+  integrity sha512-BHpFFeslkWrXWyUPnbKm+xYYVYruCinGcftSBaa8zoF9hZO4BcSCFUvHVTtzpIY6YzUnYtuEhZ+C9iEXjxnasg==
 
 "@eslint-community/eslint-utils@^4.2.0", "@eslint-community/eslint-utils@^4.4.0":
   version "4.4.0"
@@ -992,6 +1322,11 @@
   resolved "https://registry.yarnpkg.com/@istanbuljs/schema/-/schema-0.1.2.tgz#26520bf09abe4a5644cd5414e37125a8954241dd"
   integrity sha512-tsAQNx32a8CoFhjhijUIhI4kccIAgmGhy8LZMZgGfmXcpMbPRUqn5LWmgRttILi6yeGmBJd2xsPkFMs0PzgPCw==
 
+"@istanbuljs/schema@^0.1.3":
+  version "0.1.3"
+  resolved "https://registry.yarnpkg.com/@istanbuljs/schema/-/schema-0.1.3.tgz#e45e384e4b8ec16bce2fd903af78450f6bf7ec98"
+  integrity sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==
+
 "@jest/console@^26.6.2":
   version "26.6.2"
   resolved "https://registry.yarnpkg.com/@jest/console/-/console-26.6.2.tgz#4e04bc464014358b03ab4937805ee36a0aeb98f2"
@@ -1004,68 +1339,61 @@
     jest-util "^26.6.2"
     slash "^3.0.0"
 
-"@jest/console@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/console/-/console-29.4.1.tgz#cbc31d73f6329f693b3d34b365124de797704fff"
-  integrity sha512-m+XpwKSi3PPM9znm5NGS8bBReeAJJpSkL1OuFCqaMaJL2YX9YXLkkI+MBchMPwu+ZuM2rynL51sgfkQteQ1CKQ==
+"@jest/console@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/console/-/console-29.7.0.tgz#cd4822dbdb84529265c5a2bdb529a3c9cc950ffc"
+  integrity sha512-5Ni4CU7XHQi32IJ398EEP4RrB8eV09sXP2ROqD4bksHrnTree52PsxvX8tpL8LvTZ3pFzXyPbNQReSN41CAhOg==
   dependencies:
-    "@jest/types" "^29.4.1"
+    "@jest/types" "^29.6.3"
     "@types/node" "*"
     chalk "^4.0.0"
-    jest-message-util "^29.4.1"
-    jest-util "^29.4.1"
+    jest-message-util "^29.7.0"
+    jest-util "^29.7.0"
     slash "^3.0.0"
 
-"@jest/core@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/core/-/core-29.4.1.tgz#91371179b5959951e211dfaeea4277a01dcca14f"
-  integrity sha512-RXFTohpBqpaTebNdg5l3I5yadnKo9zLBajMT0I38D0tDhreVBYv3fA8kywthI00sWxPztWLD3yjiUkewwu/wKA==
+"@jest/core@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/core/-/core-29.7.0.tgz#b6cccc239f30ff36609658c5a5e2291757ce448f"
+  integrity sha512-n7aeXWKMnGtDA48y8TLWJPJmLmmZ642Ceo78cYWEpiD7FzDgmNDV/GCVRorPABdXLJZ/9wzzgZAlHjXjxDHGsg==
   dependencies:
-    "@jest/console" "^29.4.1"
-    "@jest/reporters" "^29.4.1"
-    "@jest/test-result" "^29.4.1"
-    "@jest/transform" "^29.4.1"
-    "@jest/types" "^29.4.1"
+    "@jest/console" "^29.7.0"
+    "@jest/reporters" "^29.7.0"
+    "@jest/test-result" "^29.7.0"
+    "@jest/transform" "^29.7.0"
+    "@jest/types" "^29.6.3"
     "@types/node" "*"
     ansi-escapes "^4.2.1"
     chalk "^4.0.0"
     ci-info "^3.2.0"
     exit "^0.1.2"
     graceful-fs "^4.2.9"
-    jest-changed-files "^29.4.0"
-    jest-config "^29.4.1"
-    jest-haste-map "^29.4.1"
-    jest-message-util "^29.4.1"
-    jest-regex-util "^29.2.0"
-    jest-resolve "^29.4.1"
-    jest-resolve-dependencies "^29.4.1"
-    jest-runner "^29.4.1"
-    jest-runtime "^29.4.1"
-    jest-snapshot "^29.4.1"
-    jest-util "^29.4.1"
-    jest-validate "^29.4.1"
-    jest-watcher "^29.4.1"
+    jest-changed-files "^29.7.0"
+    jest-config "^29.7.0"
+    jest-haste-map "^29.7.0"
+    jest-message-util "^29.7.0"
+    jest-regex-util "^29.6.3"
+    jest-resolve "^29.7.0"
+    jest-resolve-dependencies "^29.7.0"
+    jest-runner "^29.7.0"
+    jest-runtime "^29.7.0"
+    jest-snapshot "^29.7.0"
+    jest-util "^29.7.0"
+    jest-validate "^29.7.0"
+    jest-watcher "^29.7.0"
     micromatch "^4.0.4"
-    pretty-format "^29.4.1"
+    pretty-format "^29.7.0"
     slash "^3.0.0"
     strip-ansi "^6.0.0"
 
-"@jest/environment@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/environment/-/environment-29.4.1.tgz#52d232a85cdc995b407a940c89c86568f5a88ffe"
-  integrity sha512-pJ14dHGSQke7Q3mkL/UZR9ZtTOxqskZaC91NzamEH4dlKRt42W+maRBXiw/LWkdJe+P0f/zDR37+SPMplMRlPg==
+"@jest/environment@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/environment/-/environment-29.7.0.tgz#24d61f54ff1f786f3cd4073b4b94416383baf2a7"
+  integrity sha512-aQIfHDq33ExsN4jP1NWGXhxgQ/wixs60gDiKO+XVMd8Mn0NWPWgc34ZQDTb2jKaUWQ7MuwoitXAsN2XVXNMpAw==
   dependencies:
-    "@jest/fake-timers" "^29.4.1"
-    "@jest/types" "^29.4.1"
+    "@jest/fake-timers" "^29.7.0"
+    "@jest/types" "^29.6.3"
     "@types/node" "*"
-    jest-mock "^29.4.1"
-
-"@jest/expect-utils@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/expect-utils/-/expect-utils-29.4.1.tgz#105b9f3e2c48101f09cae2f0a4d79a1b3a419cbb"
-  integrity sha512-w6YJMn5DlzmxjO00i9wu2YSozUYRBhIoJ6nQwpMYcBMtiqMGJm1QBzOf6DDgRao8dbtpDoaqLg6iiQTvv0UHhQ==
-  dependencies:
-    jest-get-type "^29.2.0"
+    jest-mock "^29.7.0"
 
 "@jest/expect-utils@^29.7.0":
   version "29.7.0"
@@ -1074,35 +1402,35 @@
   dependencies:
     jest-get-type "^29.6.3"
 
-"@jest/expect@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/expect/-/expect-29.4.1.tgz#3338fa20f547bb6e550c4be37d6f82711cc13c38"
-  integrity sha512-ZxKJP5DTUNF2XkpJeZIzvnzF1KkfrhEF6Rz0HGG69fHl6Bgx5/GoU3XyaeFYEjuuKSOOsbqD/k72wFvFxc3iTw==
+"@jest/expect@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/expect/-/expect-29.7.0.tgz#76a3edb0cb753b70dfbfe23283510d3d45432bf2"
+  integrity sha512-8uMeAMycttpva3P1lBHB8VciS9V0XAr3GymPpipdyQXbBcuhkLQOSe8E/p92RyAdToS6ZD1tFkX+CkhoECE0dQ==
   dependencies:
-    expect "^29.4.1"
-    jest-snapshot "^29.4.1"
+    expect "^29.7.0"
+    jest-snapshot "^29.7.0"
 
-"@jest/fake-timers@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/fake-timers/-/fake-timers-29.4.1.tgz#7b673131e8ea2a2045858f08241cace5d518b42b"
-  integrity sha512-/1joI6rfHFmmm39JxNfmNAO3Nwm6Y0VoL5fJDy7H1AtWrD1CgRtqJbN9Ld6rhAkGO76qqp4cwhhxJ9o9kYjQMw==
+"@jest/fake-timers@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/fake-timers/-/fake-timers-29.7.0.tgz#fd91bf1fffb16d7d0d24a426ab1a47a49881a565"
+  integrity sha512-q4DH1Ha4TTFPdxLsqDXK1d3+ioSL7yL5oCMJZgDYm6i+6CygW5E5xVr/D1HdsGxjt1ZWSfUAs9OxSB/BNelWrQ==
   dependencies:
-    "@jest/types" "^29.4.1"
+    "@jest/types" "^29.6.3"
     "@sinonjs/fake-timers" "^10.0.2"
     "@types/node" "*"
-    jest-message-util "^29.4.1"
-    jest-mock "^29.4.1"
-    jest-util "^29.4.1"
+    jest-message-util "^29.7.0"
+    jest-mock "^29.7.0"
+    jest-util "^29.7.0"
 
-"@jest/globals@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/globals/-/globals-29.4.1.tgz#3cd78c5567ab0249f09fbd81bf9f37a7328f4713"
-  integrity sha512-znoK2EuFytbHH0ZSf2mQK2K1xtIgmaw4Da21R2C/NE/+NnItm5mPEFQmn8gmF3f0rfOlmZ3Y3bIf7bFj7DHxAA==
+"@jest/globals@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/globals/-/globals-29.7.0.tgz#8d9290f9ec47ff772607fa864ca1d5a2efae1d4d"
+  integrity sha512-mpiz3dutLbkW2MNFubUGUEVLkTGiqW6yLVTA+JbP6fI6J5iL9Y0Nlg8k95pcF8ctKwCS7WVxteBs29hhfAotzQ==
   dependencies:
-    "@jest/environment" "^29.4.1"
-    "@jest/expect" "^29.4.1"
-    "@jest/types" "^29.4.1"
-    jest-mock "^29.4.1"
+    "@jest/environment" "^29.7.0"
+    "@jest/expect" "^29.7.0"
+    "@jest/types" "^29.6.3"
+    jest-mock "^29.7.0"
 
 "@jest/reporters@^26.6.2":
   version "26.6.2"
@@ -1136,17 +1464,17 @@
   optionalDependencies:
     node-notifier "^8.0.0"
 
-"@jest/reporters@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/reporters/-/reporters-29.4.1.tgz#50d509c08575c75e3cd2176d72ec3786419d5e04"
-  integrity sha512-AISY5xpt2Xpxj9R6y0RF1+O6GRy9JsGa8+vK23Lmzdy1AYcpQn5ItX79wJSsTmfzPKSAcsY1LNt/8Y5Xe5LOSg==
+"@jest/reporters@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/reporters/-/reporters-29.7.0.tgz#04b262ecb3b8faa83b0b3d321623972393e8f4c7"
+  integrity sha512-DApq0KJbJOEzAFYjHADNNxAE3KbhxQB1y5Kplb5Waqw6zVbuWatSnMjE5gs8FUgEPmNsnZA3NCWl9NG0ia04Pg==
   dependencies:
     "@bcoe/v8-coverage" "^0.2.3"
-    "@jest/console" "^29.4.1"
-    "@jest/test-result" "^29.4.1"
-    "@jest/transform" "^29.4.1"
-    "@jest/types" "^29.4.1"
-    "@jridgewell/trace-mapping" "^0.3.15"
+    "@jest/console" "^29.7.0"
+    "@jest/test-result" "^29.7.0"
+    "@jest/transform" "^29.7.0"
+    "@jest/types" "^29.6.3"
+    "@jridgewell/trace-mapping" "^0.3.18"
     "@types/node" "*"
     chalk "^4.0.0"
     collect-v8-coverage "^1.0.0"
@@ -1154,25 +1482,18 @@
     glob "^7.1.3"
     graceful-fs "^4.2.9"
     istanbul-lib-coverage "^3.0.0"
-    istanbul-lib-instrument "^5.1.0"
+    istanbul-lib-instrument "^6.0.0"
     istanbul-lib-report "^3.0.0"
     istanbul-lib-source-maps "^4.0.0"
     istanbul-reports "^3.1.3"
-    jest-message-util "^29.4.1"
-    jest-util "^29.4.1"
-    jest-worker "^29.4.1"
+    jest-message-util "^29.7.0"
+    jest-util "^29.7.0"
+    jest-worker "^29.7.0"
     slash "^3.0.0"
     string-length "^4.0.1"
     strip-ansi "^6.0.0"
     v8-to-istanbul "^9.0.1"
 
-"@jest/schemas@^29.4.0":
-  version "29.4.0"
-  resolved "https://registry.yarnpkg.com/@jest/schemas/-/schemas-29.4.0.tgz#0d6ad358f295cc1deca0b643e6b4c86ebd539f17"
-  integrity sha512-0E01f/gOZeNTG76i5eWWSupvSHaIINrTie7vCyjiYFKgzNdyEGd12BUv4oNBFHOqlHDbtoJi3HrQ38KCC90NsQ==
-  dependencies:
-    "@sinclair/typebox" "^0.25.16"
-
 "@jest/schemas@^29.6.3":
   version "29.6.3"
   resolved "https://registry.yarnpkg.com/@jest/schemas/-/schemas-29.6.3.tgz#430b5ce8a4e0044a7e3819663305a7b3091c8e03"
@@ -1180,12 +1501,12 @@
   dependencies:
     "@sinclair/typebox" "^0.27.8"
 
-"@jest/source-map@^29.2.0":
-  version "29.2.0"
-  resolved "https://registry.yarnpkg.com/@jest/source-map/-/source-map-29.2.0.tgz#ab3420c46d42508dcc3dc1c6deee0b613c235744"
-  integrity sha512-1NX9/7zzI0nqa6+kgpSdKPK+WU1p+SJk3TloWZf5MzPbxri9UEeXX5bWZAPCzbQcyuAzubcdUHA7hcNznmRqWQ==
+"@jest/source-map@^29.6.3":
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/@jest/source-map/-/source-map-29.6.3.tgz#d90ba772095cf37a34a5eb9413f1b562a08554c4"
+  integrity sha512-MHjT95QuipcPrpLM+8JMSzFx6eHp5Bm+4XeFDJlwsvVBjmKNiIAvasGK2fxz2WbGRlnvqehFbh07MMa7n3YJnw==
   dependencies:
-    "@jridgewell/trace-mapping" "^0.3.15"
+    "@jridgewell/trace-mapping" "^0.3.18"
     callsites "^3.0.0"
     graceful-fs "^4.2.9"
 
@@ -1199,24 +1520,24 @@
     "@types/istanbul-lib-coverage" "^2.0.0"
     collect-v8-coverage "^1.0.0"
 
-"@jest/test-result@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/test-result/-/test-result-29.4.1.tgz#997f19695e13b34779ceb3c288a416bd26c3238d"
-  integrity sha512-WRt29Lwt+hEgfN8QDrXqXGgCTidq1rLyFqmZ4lmJOpVArC8daXrZWkWjiaijQvgd3aOUj2fM8INclKHsQW9YyQ==
+"@jest/test-result@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/test-result/-/test-result-29.7.0.tgz#8db9a80aa1a097bb2262572686734baed9b1657c"
+  integrity sha512-Fdx+tv6x1zlkJPcWXmMDAG2HBnaR9XPSd5aDWQVsfrZmLVT3lU1cwyxLgRmXR9yrq4NBoEm9BMsfgFzTQAbJYA==
   dependencies:
-    "@jest/console" "^29.4.1"
-    "@jest/types" "^29.4.1"
+    "@jest/console" "^29.7.0"
+    "@jest/types" "^29.6.3"
     "@types/istanbul-lib-coverage" "^2.0.0"
     collect-v8-coverage "^1.0.0"
 
-"@jest/test-sequencer@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/test-sequencer/-/test-sequencer-29.4.1.tgz#f7a006ec7058b194a10cf833c88282ef86d578fd"
-  integrity sha512-v5qLBNSsM0eHzWLXsQ5fiB65xi49A3ILPSFQKPXzGL4Vyux0DPZAIN7NAFJa9b4BiTDP9MBF/Zqc/QA1vuiJ0w==
+"@jest/test-sequencer@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/test-sequencer/-/test-sequencer-29.7.0.tgz#6cef977ce1d39834a3aea887a1726628a6f072ce"
+  integrity sha512-GQwJ5WZVrKnOJuiYiAF52UNUJXgTZx1NHjFSEB0qEMmSZKAkdMoIzw/Cj6x6NF4AvV23AUqDpFzQkN/eYCYTxw==
   dependencies:
-    "@jest/test-result" "^29.4.1"
+    "@jest/test-result" "^29.7.0"
     graceful-fs "^4.2.9"
-    jest-haste-map "^29.4.1"
+    jest-haste-map "^29.7.0"
     slash "^3.0.0"
 
 "@jest/transform@^26.6.2":
@@ -1240,26 +1561,26 @@
     source-map "^0.6.1"
     write-file-atomic "^3.0.0"
 
-"@jest/transform@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/transform/-/transform-29.4.1.tgz#e4f517841bb795c7dcdee1ba896275e2c2d26d4a"
-  integrity sha512-5w6YJrVAtiAgr0phzKjYd83UPbCXsBRTeYI4BXokv9Er9CcrH9hfXL/crCvP2d2nGOcovPUnlYiLPFLZrkG5Hg==
+"@jest/transform@^29.7.0":
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/@jest/transform/-/transform-29.7.0.tgz#df2dd9c346c7d7768b8a06639994640c642e284c"
+  integrity sha512-ok/BTPFzFKVMwO5eOHRrvnBVHdRy9IrsrW1GpMaQ9MCnilNLXQKmAX8s1YXDFaai9xJpac2ySzV0YeRRECr2Vw==
   dependencies:
     "@babel/core" "^7.11.6"
-    "@jest/types" "^29.4.1"
-    "@jridgewell/trace-mapping" "^0.3.15"
+    "@jest/types" "^29.6.3"
+    "@jridgewell/trace-mapping" "^0.3.18"
     babel-plugin-istanbul "^6.1.1"
     chalk "^4.0.0"
     convert-source-map "^2.0.0"
     fast-json-stable-stringify "^2.1.0"
     graceful-fs "^4.2.9"
-    jest-haste-map "^29.4.1"
-    jest-regex-util "^29.2.0"
-    jest-util "^29.4.1"
+    jest-haste-map "^29.7.0"
+    jest-regex-util "^29.6.3"
+    jest-util "^29.7.0"
     micromatch "^4.0.4"
     pirates "^4.0.4"
     slash "^3.0.0"
-    write-file-atomic "^5.0.0"
+    write-file-atomic "^4.0.2"
 
 "@jest/types@^26.6.2":
   version "26.6.2"
@@ -1272,18 +1593,6 @@
     "@types/yargs" "^15.0.0"
     chalk "^4.0.0"
 
-"@jest/types@^29.4.1":
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/@jest/types/-/types-29.4.1.tgz#f9f83d0916f50696661da72766132729dcb82ecb"
-  integrity sha512-zbrAXDUOnpJ+FMST2rV7QZOgec8rskg2zv8g2ajeqitp4tvZiyqTCYXANrKsM+ryj5o+LI+ZN2EgU9drrkiwSA==
-  dependencies:
-    "@jest/schemas" "^29.4.0"
-    "@types/istanbul-lib-coverage" "^2.0.0"
-    "@types/istanbul-reports" "^3.0.0"
-    "@types/node" "*"
-    "@types/yargs" "^17.0.8"
-    chalk "^4.0.0"
-
 "@jest/types@^29.6.3":
   version "29.6.3"
   resolved "https://registry.yarnpkg.com/@jest/types/-/types-29.6.3.tgz#1131f8cf634e7e84c5e77bab12f052af585fba59"
@@ -1313,6 +1622,15 @@
     "@jridgewell/sourcemap-codec" "^1.4.10"
     "@jridgewell/trace-mapping" "^0.3.9"
 
+"@jridgewell/gen-mapping@^0.3.5":
+  version "0.3.8"
+  resolved "https://registry.yarnpkg.com/@jridgewell/gen-mapping/-/gen-mapping-0.3.8.tgz#4f0e06362e01362f823d348f1872b08f666d8142"
+  integrity sha512-imAbBGkb+ebQyxKgzv5Hu2nmROxoDOXHh80evxdoXNOrvAnVx7zimzc1Oo5h9RlfV4vPXaE2iM5pOFbvOCClWA==
+  dependencies:
+    "@jridgewell/set-array" "^1.2.1"
+    "@jridgewell/sourcemap-codec" "^1.4.10"
+    "@jridgewell/trace-mapping" "^0.3.24"
+
 "@jridgewell/resolve-uri@3.1.0":
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.0.tgz#2203b118c157721addfe69d47b70465463066d78"
@@ -1323,6 +1641,11 @@
   resolved "https://registry.yarnpkg.com/@jridgewell/resolve-uri/-/resolve-uri-3.0.7.tgz#30cd49820a962aff48c8fffc5cd760151fca61fe"
   integrity sha512-8cXDaBBHOr2pQ7j77Y6Vp5VDT2sIqWyWQ56TjEq4ih/a4iST3dItRe8Q9fp0rrIl9DoKhWQtUQz/YpOxLkXbNA==
 
+"@jridgewell/resolve-uri@^3.1.0":
+  version "3.1.2"
+  resolved "https://registry.yarnpkg.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz#7a0ee601f60f99a20c7c7c5ff0c80388c1189bd6"
+  integrity sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==
+
 "@jridgewell/set-array@^1.0.0":
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/@jridgewell/set-array/-/set-array-1.1.1.tgz#36a6acc93987adcf0ba50c66908bd0b70de8afea"
@@ -1333,6 +1656,11 @@
   resolved "https://registry.yarnpkg.com/@jridgewell/set-array/-/set-array-1.1.2.tgz#7c6cf998d6d20b914c0a55a91ae928ff25965e72"
   integrity sha512-xnkseuNADM0gt2bs+BvhO0p78Mk762YnZdsuzFV018NoG1Sj1SCQvpSqa7XUaTam5vAGasABV9qXASMKnFMwMw==
 
+"@jridgewell/set-array@^1.2.1":
+  version "1.2.1"
+  resolved "https://registry.yarnpkg.com/@jridgewell/set-array/-/set-array-1.2.1.tgz#558fb6472ed16a4c850b889530e6b36438c49280"
+  integrity sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==
+
 "@jridgewell/sourcemap-codec@1.4.14":
   version "1.4.14"
   resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.14.tgz#add4c98d341472a289190b424efbdb096991bb24"
@@ -1343,7 +1671,12 @@
   resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.13.tgz#b6461fb0c2964356c469e115f504c95ad97ab88c"
   integrity sha512-GryiOJmNcWbovBxTfZSF71V/mXbgcV3MewDe3kIMCLyIh5e7SKAeUZs+rMnJ8jkMolZ/4/VsdBmMrw3l+VdZ3w==
 
-"@jridgewell/trace-mapping@^0.3.12", "@jridgewell/trace-mapping@^0.3.15":
+"@jridgewell/sourcemap-codec@^1.4.14":
+  version "1.5.0"
+  resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz#3188bcb273a414b0d215fd22a58540b989b9409a"
+  integrity sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==
+
+"@jridgewell/trace-mapping@^0.3.12":
   version "0.3.17"
   resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.17.tgz#793041277af9073b0951a7fe0f0d8c4c98c36985"
   integrity sha512-MCNzAp77qzKca9+W/+I0+sEpaUnZoeasnghNeVc41VZCEKaCH73Vq3BZZ/SzWIgrqE4H4ceI+p+b6C0mHf9T4g==
@@ -1351,6 +1684,14 @@
     "@jridgewell/resolve-uri" "3.1.0"
     "@jridgewell/sourcemap-codec" "1.4.14"
 
+"@jridgewell/trace-mapping@^0.3.18", "@jridgewell/trace-mapping@^0.3.24", "@jridgewell/trace-mapping@^0.3.25":
+  version "0.3.25"
+  resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz#15f190e98895f3fc23276ee14bc76b675c2e50f0"
+  integrity sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==
+  dependencies:
+    "@jridgewell/resolve-uri" "^3.1.0"
+    "@jridgewell/sourcemap-codec" "^1.4.14"
+
 "@jridgewell/trace-mapping@^0.3.9":
   version "0.3.13"
   resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.13.tgz#dcfe3e95f224c8fe97a87a5235defec999aa92ea"
@@ -2269,10 +2610,10 @@
   dependencies:
     "@psf/bitcoincash-ops" "^2.0.0"
 
-"@sinclair/typebox@^0.25.16":
-  version "0.25.24"
-  resolved "https://registry.yarnpkg.com/@sinclair/typebox/-/typebox-0.25.24.tgz#8c7688559979f7079aacaf31aa881c3aa410b718"
-  integrity sha512-XJfwUVUKDHF5ugKwIcxEgc9k8b7HbznCp6eUfWgu710hMPNIO4aw4/zB5RogDQz8nd6gyCDpU9O/m6qYEWY6yQ==
+"@rtsao/scc@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@rtsao/scc/-/scc-1.1.0.tgz#927dd2fae9bc3361403ac2c7a00c32ddce9ad7e8"
+  integrity sha512-zt6OdqaDoOnJ1ZYsCYGt9YmWzDXl4vQdKTyJev62gFhRGKdx7mcT54V9KIjg+d2wi9EXsPvAPKe7i7WjfVWB8g==
 
 "@sinclair/typebox@^0.27.8":
   version "0.27.8"
@@ -2293,11 +2634,6 @@
   dependencies:
     "@sinonjs/commons" "^2.0.0"
 
-"@tootallnate/once@1":
-  version "1.1.2"
-  resolved "https://registry.yarnpkg.com/@tootallnate/once/-/once-1.1.2.tgz#ccb91445360179a04e7fe6aff78c00ffc1eeaf82"
-  integrity sha512-RbzJvlNzmRq5c3O09UipeuXno4tA1FE6ikOjxZK0tuxVv3412l64l5t1W5pj4+rJq9vpkm/kwiR07aZXnsKPxw==
-
 "@types/babel__core@^7.1.14":
   version "7.20.0"
   resolved "https://registry.yarnpkg.com/@types/babel__core/-/babel__core-7.20.0.tgz#61bc5a4cae505ce98e1e36c5445e4bee060d8891"
@@ -2375,10 +2711,10 @@
   dependencies:
     "@types/istanbul-lib-report" "*"
 
-"@types/jest@^29.4.0", "@types/jest@^29.4.1":
-  version "29.5.12"
-  resolved "https://registry.yarnpkg.com/@types/jest/-/jest-29.5.12.tgz#7f7dc6eb4cf246d2474ed78744b05d06ce025544"
-  integrity sha512-eDC8bTvT/QhYdxJAulQikueigY5AsdBRH2yDKW3yveW7svY3+DzN84/2NUgkw10RTiJbWqZrTtoGVdYlvFJdLw==
+"@types/jest@^29.5.14":
+  version "29.5.14"
+  resolved "https://registry.yarnpkg.com/@types/jest/-/jest-29.5.14.tgz#2b910912fa1d6856cadcd0c1f95af7df1d6049e5"
+  integrity sha512-ZN+4sdnLUbo8EVvVc2ao0GFW6oVrQRPn4K2lglySj7APvSrgzxHiNNK99us4WDMi57xxA2yggblIAMNhXOotLQ==
   dependencies:
     expect "^29.0.0"
     pretty-format "^29.0.0"
@@ -2398,17 +2734,12 @@
   resolved "https://registry.yarnpkg.com/@types/minimist/-/minimist-1.2.0.tgz#69a23a3ad29caf0097f06eda59b361ee2f0639f6"
   integrity sha1-aaI6OtKcrwCX8G7aWbNh7i8GOfY=
 
-"@types/minimist@^1.2.2":
-  version "1.2.2"
-  resolved "https://registry.yarnpkg.com/@types/minimist/-/minimist-1.2.2.tgz#ee771e2ba4b3dc5b372935d549fd9617bf345b8c"
-  integrity sha512-jhuKLIRrhvCPLqwPcx6INqmKeiA5EWrsCOPhrlFSrbrmU4ZMPjj5Ul/oLCMDO98XRUIwVm78xICz4EPCektzeQ==
-
-"@types/node@*":
-  version "22.2.0"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-22.2.0.tgz#7cf046a99f0ba4d628ad3088cb21f790df9b0c5b"
-  integrity sha512-bm6EG6/pCpkxDf/0gDNDdtDILMOHgaQBVOJGdwsqClnxA3xL6jtMv76rLBc006RVMWbmaf0xbmom4Z/5o2nRkQ==
+"@types/node@*", "@types/node@^22.10.7":
+  version "22.10.7"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-22.10.7.tgz#14a1ca33fd0ebdd9d63593ed8d3fbc882a6d28d7"
+  integrity sha512-V09KvXxFiutGp6B7XkpaDXlNadZxrzajcY50EuoLIpQ6WWYCSvf19lVIazzfIzQvhUN2HjX12spLojTnhuKlGg==
   dependencies:
-    undici-types "~6.13.0"
+    undici-types "~6.20.0"
 
 "@types/node@11.11.6":
   version "11.11.6"
@@ -2420,23 +2751,6 @@
   resolved "https://registry.yarnpkg.com/@types/node/-/node-14.6.0.tgz#7d4411bf5157339337d7cff864d9ff45f177b499"
   integrity sha512-mikldZQitV94akrc4sCcSjtJfsTKt4p+e/s0AGscVA6XArQ9kFclP+ZiYUMnq987rc6QlYxXv/EivqlfSLxpKA==
 
-"@types/node@^12.7.8":
-  version "12.20.55"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-12.20.55.tgz#c329cbd434c42164f846b909bd6f85b5537f6240"
-  integrity sha512-J8xLz7q2OFulZ2cyGTLE1TbbZcjpno7FaN6zdJNrgAdrJ+DZzh/uFR6YrTb4C+nXakvud8Q4+rbhoIWlYQbUFQ==
-
-"@types/node@^14.14.28":
-  version "14.18.63"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-14.18.63.tgz#1788fa8da838dbb5f9ea994b834278205db6ca2b"
-  integrity sha512-fAtCfv4jJg+ExtXhvCkCqUKZ+4ok/JQk01qDKhL5BDDoS3AxKXhV5/MAVUZyQnSEd2GT92fkgZl0pz0Q0AzcIQ==
-
-"@types/node@^18.11.18":
-  version "18.19.44"
-  resolved "https://registry.yarnpkg.com/@types/node/-/node-18.19.44.tgz#875a8322d17ff12bf82b3af8c07b9310a00e72f8"
-  integrity sha512-ZsbGerYg72WMXUIE9fYxtvfzLEuq6q8mKERdWFnqTmOvudMxnz+CBNRoOwJ2kNpFOncrKjT1hZwxjlFgQ9qvQA==
-  dependencies:
-    undici-types "~5.26.4"
-
 "@types/normalize-package-data@^2.4.0":
   version "2.4.0"
   resolved "https://registry.yarnpkg.com/@types/normalize-package-data/-/normalize-package-data-2.4.0.tgz#e486d0d97396d79beedd0a6e33f4534ff6b4973e"
@@ -2447,16 +2761,6 @@
   resolved "https://registry.yarnpkg.com/@types/pako/-/pako-2.0.3.tgz#b6993334f3af27c158f3fe0dfeeba987c578afb1"
   integrity sha512-bq0hMV9opAcrmE0Byyo0fY3Ew4tgOevJmQ9grUhpXQhYfyLJ1Kqg3P33JT5fdbT2AjeAjR51zqqVjAL/HMkx7Q==
 
-"@types/parse-json@^4.0.0":
-  version "4.0.0"
-  resolved "https://registry.yarnpkg.com/@types/parse-json/-/parse-json-4.0.0.tgz#2f8bb441434d163b35fb8ffdccd7138927ffb8c0"
-  integrity sha512-//oorEZjL6sbPcKUaCdIGlIUeH26mgzimjBB77G6XRgnDl/L5wOnpyBGRe/Mmf5CVW3PwEBE1NjiMZ/ssFh4wA==
-
-"@types/prettier@^2.1.5":
-  version "2.7.2"
-  resolved "https://registry.yarnpkg.com/@types/prettier/-/prettier-2.7.2.tgz#6c2324641cc4ba050a8c710b2b251b377581fbf0"
-  integrity sha512-KufADq8uQqo1pYKVIYzfKbJfBAc0sOeXqGbFaSpv8MRmC/zXgowNZmFcbngndGk922QDmOASEXUZCaY48gs4cg==
-
 "@types/semver@^7.5.8":
   version "7.5.8"
   resolved "https://registry.yarnpkg.com/@types/semver/-/semver-7.5.8.tgz#8268a8c57a3e4abd25c165ecd36237db7948a55e"
@@ -2618,18 +2922,6 @@ agent-base@4, agent-base@^4.3.0:
   dependencies:
     es6-promisify "^5.0.0"
 
-agent-base@5:
-  version "5.1.1"
-  resolved "https://registry.yarnpkg.com/agent-base/-/agent-base-5.1.1.tgz#e8fb3f242959db44d63be665db7a8e739537a32c"
-  integrity sha512-TMeqbNl2fMW0nMjTEPOwe3J/PRFP4vqeoNuQMG0HlMrtm5QxKqdvAkZ1pRBQ/ulIyDD5Yq0nJ7YbdD8ey0TO3g==
-
-agent-base@6:
-  version "6.0.1"
-  resolved "https://registry.yarnpkg.com/agent-base/-/agent-base-6.0.1.tgz#808007e4e5867decb0ab6ab2f928fbdb5a596db4"
-  integrity sha512-01q25QQDwLSsyfhrKbn8yuur+JNw0H+0Y4JiGIKd3z9aYk/w/2kxD/Upc+t2ZBBSUNff50VjPsSW2YxM8QYKVg==
-  dependencies:
-    debug "4"
-
 agent-base@~4.2.1:
   version "4.2.1"
   resolved "https://registry.yarnpkg.com/agent-base/-/agent-base-4.2.1.tgz#d89e5999f797875674c07d87f260fc41e83e8ca9"
@@ -2736,10 +3028,10 @@ ansi-styles@^5.0.0:
   resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-5.2.0.tgz#07449690ad45777d1924ac2abb2fc8895dba836b"
   integrity sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==
 
-antlr4@^4.13.1-patch-1:
-  version "4.13.1-patch-1"
-  resolved "https://registry.yarnpkg.com/antlr4/-/antlr4-4.13.1-patch-1.tgz#946176f863f890964a050c4f18c47fd6f7e57602"
-  integrity sha512-OjFLWWLzDMV9rdFhpvroCWR4ooktNg9/nvVYSA5z28wuVpU36QUNuioR1XLnQtcjVlf8npjyz593PxnU/f/Cow==
+antlr4@^4.13.2:
+  version "4.13.2"
+  resolved "https://registry.yarnpkg.com/antlr4/-/antlr4-4.13.2.tgz#0d084ad0e32620482a9c3a0e2470c02e72e4006d"
+  integrity sha512-QiVbZhyy4xAZ17UPEuG3YTOt8ZaoeOR1CvEAqrEsDBsOqINslaB147i9xqljZqoyf5S+EUlGStaj+t22LT9MOg==
 
 any-promise@^1.0.0:
   version "1.3.0"
@@ -2792,11 +3084,6 @@ argparse@^2.0.1:
   resolved "https://registry.yarnpkg.com/argparse/-/argparse-2.0.1.tgz#246f50f3ca78a3240f6c997e8a9bd1eac49e4b38"
   integrity sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==
 
-argv@0.0.2:
-  version "0.0.2"
-  resolved "https://registry.yarnpkg.com/argv/-/argv-0.0.2.tgz#ecbd16f8949b157183711b1bda334f37840185ab"
-  integrity sha1-7L0W+JSbFXGDcRsb2jNPN4QBhas=
-
 arr-diff@^4.0.0:
   version "4.0.0"
   resolved "https://registry.yarnpkg.com/arr-diff/-/arr-diff-4.0.0.tgz#d6461074febfec71e7e15235761a329a5dc7c520"
@@ -2812,13 +3099,13 @@ arr-union@^3.1.0:
   resolved "https://registry.yarnpkg.com/arr-union/-/arr-union-3.1.0.tgz#e39b09aea9def866a8f206e288af63919bae39c4"
   integrity sha1-45sJrqne+Gao8gbiiK9jkZuuOcQ=
 
-array-buffer-byte-length@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/array-buffer-byte-length/-/array-buffer-byte-length-1.0.1.tgz#1e5583ec16763540a27ae52eed99ff899223568f"
-  integrity sha512-ahC5W1xgou+KTXix4sAO8Ki12Q+jf4i0+tmk3sC+zgcynshkHxzpXdImBehiUYKKKDwvfFiJl1tZt6ewscS1Mg==
+array-buffer-byte-length@^1.0.1, array-buffer-byte-length@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/array-buffer-byte-length/-/array-buffer-byte-length-1.0.2.tgz#384d12a37295aec3769ab022ad323a18a51ccf8b"
+  integrity sha512-LHE+8BuR7RYGDKvnrmcuSq3tDcKv9OFEXQt/HpbZhY7V6h0zlUXutnAD82GiFx9rdieCMjkvtcsPqBwgUl1Iiw==
   dependencies:
-    call-bind "^1.0.5"
-    is-array-buffer "^3.0.4"
+    call-bound "^1.0.3"
+    is-array-buffer "^3.0.5"
 
 array-differ@^2.0.3:
   version "2.1.0"
@@ -2840,7 +3127,7 @@ array-ify@^1.0.0:
   resolved "https://registry.yarnpkg.com/array-ify/-/array-ify-1.0.0.tgz#9e528762b4a9066ad163a6962a364418e9626ece"
   integrity sha1-nlKHYrSpBmrRY6aWKjZEGOlibs4=
 
-array-includes@^3.1.7:
+array-includes@^3.1.8:
   version "3.1.8"
   resolved "https://registry.yarnpkg.com/array-includes/-/array-includes-3.1.8.tgz#5e370cbe172fdd5dd6530c1d4aadda25281ba97d"
   integrity sha512-itaWrbYbqpGXkGhZPGUulwnhVf5Hpy1xiCFsGqyIGglbBxmG5vSjxQen3/WGOjPpNEv1RtBLKxbmVXm8HpJStQ==
@@ -2879,7 +3166,7 @@ array-unique@^0.3.2:
   resolved "https://registry.yarnpkg.com/array-unique/-/array-unique-0.3.2.tgz#a894b75d4bc4f6cd679ef3244a9fd8f46ae2d428"
   integrity sha1-qJS3XUvE9s1nnvMkSp/Y9Gri1Cg=
 
-array.prototype.findlastindex@^1.2.3:
+array.prototype.findlastindex@^1.2.5:
   version "1.2.5"
   resolved "https://registry.yarnpkg.com/array.prototype.findlastindex/-/array.prototype.findlastindex-1.2.5.tgz#8c35a755c72908719453f87145ca011e39334d0d"
   integrity sha512-zfETvRFA8o7EiNn++N5f/kaCw221hrpGsDmcpndVupkPzEc1Wuf3VgC0qby1BbHs7f5DVYjgtEU2LLh5bqeGfQ==
@@ -2892,38 +3179,37 @@ array.prototype.findlastindex@^1.2.3:
     es-shim-unscopables "^1.0.2"
 
 array.prototype.flat@^1.3.2:
-  version "1.3.2"
-  resolved "https://registry.yarnpkg.com/array.prototype.flat/-/array.prototype.flat-1.3.2.tgz#1476217df8cff17d72ee8f3ba06738db5b387d18"
-  integrity sha512-djYB+Zx2vLewY8RWlNCUdHjDXs2XOgm602S9E7P/UpHgfeHL00cRiIF+IN/G/aUJ7kGPb6yO/ErDI5V2s8iycA==
+  version "1.3.3"
+  resolved "https://registry.yarnpkg.com/array.prototype.flat/-/array.prototype.flat-1.3.3.tgz#534aaf9e6e8dd79fb6b9a9917f839ef1ec63afe5"
+  integrity sha512-rwG/ja1neyLqCuGZ5YYrznA62D4mZXg0i1cIskIUKSiqF3Cje9/wXAls9B9s1Wa2fomMsIv8czB8jZcPmxCXFg==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
-    es-shim-unscopables "^1.0.0"
+    call-bind "^1.0.8"
+    define-properties "^1.2.1"
+    es-abstract "^1.23.5"
+    es-shim-unscopables "^1.0.2"
 
 array.prototype.flatmap@^1.3.2:
-  version "1.3.2"
-  resolved "https://registry.yarnpkg.com/array.prototype.flatmap/-/array.prototype.flatmap-1.3.2.tgz#c9a7c6831db8e719d6ce639190146c24bbd3e527"
-  integrity sha512-Ewyx0c9PmpcsByhSW4r+9zDU7sGjFc86qf/kKtuSCRdhfbk0SNLLkaT5qvcHnRGgc5NP/ly/y+qkXkqONX54CQ==
+  version "1.3.3"
+  resolved "https://registry.yarnpkg.com/array.prototype.flatmap/-/array.prototype.flatmap-1.3.3.tgz#712cc792ae70370ae40586264629e33aab5dd38b"
+  integrity sha512-Y7Wt51eKJSyi80hFrJCePGGNo5ktJCslFuboqJsbf57CCPcm5zztluPlc4/aD8sWsKvlwatezpV4U1efk8kpjg==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
-    es-shim-unscopables "^1.0.0"
+    call-bind "^1.0.8"
+    define-properties "^1.2.1"
+    es-abstract "^1.23.5"
+    es-shim-unscopables "^1.0.2"
 
-arraybuffer.prototype.slice@^1.0.3:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.3.tgz#097972f4255e41bc3425e37dc3f6421cf9aefde6"
-  integrity sha512-bMxMKAjg13EBSVscxTaYA4mRc5t1UAXa2kXiGTNfZ079HIWXEkKmkgFrh/nJqamaLSrXO5H4WFFkPEaLJWbs3A==
+arraybuffer.prototype.slice@^1.0.4:
+  version "1.0.4"
+  resolved "https://registry.yarnpkg.com/arraybuffer.prototype.slice/-/arraybuffer.prototype.slice-1.0.4.tgz#9d760d84dbdd06d0cbf92c8849615a1a7ab3183c"
+  integrity sha512-BNoCY6SXXPQ7gF2opIP4GBE+Xw7U+pHMYKuzjgCN3GwiaIR09UUeKfheyIry77QtrCBlC0KK0q5/TER/tYh3PQ==
   dependencies:
     array-buffer-byte-length "^1.0.1"
-    call-bind "^1.0.5"
+    call-bind "^1.0.8"
     define-properties "^1.2.1"
-    es-abstract "^1.22.3"
-    es-errors "^1.2.1"
-    get-intrinsic "^1.2.3"
+    es-abstract "^1.23.5"
+    es-errors "^1.3.0"
+    get-intrinsic "^1.2.6"
     is-array-buffer "^3.0.4"
-    is-shared-array-buffer "^1.0.2"
 
 arrify@^1.0.1:
   version "1.0.1"
@@ -2969,11 +3255,6 @@ asynckit@^0.4.0:
   resolved "https://registry.yarnpkg.com/asynckit/-/asynckit-0.4.0.tgz#c79ed97f7f34cb8f2ba1bc9790bcc366474b4b79"
   integrity sha1-x57Zf380y48robyXkLzDZkdLS3k=
 
-at-least-node@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/at-least-node/-/at-least-node-1.0.0.tgz#602cd4b46e844ad4effc92a8011a3c46e0238dc2"
-  integrity sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==
-
 atob-lite@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/atob-lite/-/atob-lite-2.0.0.tgz#0fef5ad46f1bd7a8502c65727f0367d5ee43d696"
@@ -3015,15 +3296,15 @@ axios@0.26.1:
   dependencies:
     follow-redirects "^1.14.8"
 
-babel-jest@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/babel-jest/-/babel-jest-29.4.1.tgz#01fa167e27470b35c2d4a1b841d9586b1764da19"
-  integrity sha512-xBZa/pLSsF/1sNpkgsiT3CmY7zV1kAsZ9OxxtrFqYucnOuRftXAfcJqcDVyOPeN4lttWTwhLdu0T9f8uvoPEUg==
+babel-jest@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/babel-jest/-/babel-jest-29.7.0.tgz#f4369919225b684c56085998ac63dbd05be020d5"
+  integrity sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==
   dependencies:
-    "@jest/transform" "^29.4.1"
+    "@jest/transform" "^29.7.0"
     "@types/babel__core" "^7.1.14"
     babel-plugin-istanbul "^6.1.1"
-    babel-preset-jest "^29.4.0"
+    babel-preset-jest "^29.6.3"
     chalk "^4.0.0"
     graceful-fs "^4.2.9"
     slash "^3.0.0"
@@ -3039,10 +3320,10 @@ babel-plugin-istanbul@^6.0.0, babel-plugin-istanbul@^6.1.1:
     istanbul-lib-instrument "^5.0.4"
     test-exclude "^6.0.0"
 
-babel-plugin-jest-hoist@^29.4.0:
-  version "29.4.0"
-  resolved "https://registry.yarnpkg.com/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-29.4.0.tgz#3fd3dfcedf645932df6d0c9fc3d9a704dd860248"
-  integrity sha512-a/sZRLQJEmsmejQ2rPEUe35nO1+C9dc9O1gplH1SXmJxveQSRUYdBk8yGZG/VOUuZs1u2aHZJusEGoRMbhhwCg==
+babel-plugin-jest-hoist@^29.6.3:
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-29.6.3.tgz#aadbe943464182a8922c3c927c3067ff40d24626"
+  integrity sha512-ESAc/RJvGTFEzRwOTT4+lNDk/GNHMkKbNzsvT0qKRfDyyYTskxB5rnU2njIDYVxXCBHHEI1c0YwHob3WaYujOg==
   dependencies:
     "@babel/template" "^7.3.3"
     "@babel/types" "^7.3.3"
@@ -3067,12 +3348,12 @@ babel-preset-current-node-syntax@^1.0.0:
     "@babel/plugin-syntax-optional-chaining" "^7.8.3"
     "@babel/plugin-syntax-top-level-await" "^7.8.3"
 
-babel-preset-jest@^29.4.0:
-  version "29.4.0"
-  resolved "https://registry.yarnpkg.com/babel-preset-jest/-/babel-preset-jest-29.4.0.tgz#c2b03c548b02dea0a18ae21d5759c136f9251ee4"
-  integrity sha512-fUB9vZflUSM3dO/6M2TCAepTzvA4VkOvl67PjErcrQMGt9Eve7uazaeyCZ2th3UtI7ljpiBJES0F7A1vBRsLZA==
+babel-preset-jest@^29.6.3:
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/babel-preset-jest/-/babel-preset-jest-29.6.3.tgz#fa05fa510e7d493896d7b0dd2033601c840f171c"
+  integrity sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==
   dependencies:
-    babel-plugin-jest-hoist "^29.4.0"
+    babel-plugin-jest-hoist "^29.6.3"
     babel-preset-current-node-syntax "^1.0.0"
 
 balanced-match@^1.0.0:
@@ -3295,6 +3576,16 @@ browserslist@^4.21.3:
     node-releases "^2.0.8"
     update-browserslist-db "^1.0.10"
 
+browserslist@^4.24.0:
+  version "4.24.4"
+  resolved "https://registry.yarnpkg.com/browserslist/-/browserslist-4.24.4.tgz#c6b2865a3f08bcb860a0e827389003b9fe686e4b"
+  integrity sha512-KDi1Ny1gSePi1vm0q4oxSF8b4DR44GF4BbmS2YdhPLOEqd8pDviZOGH/GsmRwoWJ2+5Lr085X7naowMwKHDG1A==
+  dependencies:
+    caniuse-lite "^1.0.30001688"
+    electron-to-chromium "^1.5.73"
+    node-releases "^2.0.19"
+    update-browserslist-db "^1.1.1"
+
 bs58@4.0.1, bs58@^4.0.0:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/bs58/-/bs58-4.0.1.tgz#be161e76c354f6f788ae4071f63f34e8c4f0a42a"
@@ -3389,7 +3680,15 @@ cache-base@^1.0.1:
     union-value "^1.0.0"
     unset-value "^1.0.0"
 
-call-bind@^1.0.0, call-bind@^1.0.2, call-bind@^1.0.5, call-bind@^1.0.6, call-bind@^1.0.7:
+call-bind-apply-helpers@^1.0.0, call-bind-apply-helpers@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.1.tgz#32e5892e6361b29b0b545ba6f7763378daca2840"
+  integrity sha512-BhYE+WDaywFg2TBWYNXAE+8B1ATnThNBqXHP5nQu0jWJdVvY2hvkpyB3qOmtmDePiS5/BDQ8wASEWGMWRG148g==
+  dependencies:
+    es-errors "^1.3.0"
+    function-bind "^1.1.2"
+
+call-bind@^1.0.0:
   version "1.0.7"
   resolved "https://registry.yarnpkg.com/call-bind/-/call-bind-1.0.7.tgz#06016599c40c56498c18769d2730be242b6fa3b9"
   integrity sha512-GHTSNSYICQ7scH7sZ+M2rFopRoLh8t2bLSW6BbgrtLsahOIB5iyAVJf9GjWK3cYTDaMj4XdBpM1cA6pIS0Kv2w==
@@ -3400,6 +3699,24 @@ call-bind@^1.0.0, call-bind@^1.0.2, call-bind@^1.0.5, call-bind@^1.0.6, call-bin
     get-intrinsic "^1.2.4"
     set-function-length "^1.2.1"
 
+call-bind@^1.0.2, call-bind@^1.0.7, call-bind@^1.0.8:
+  version "1.0.8"
+  resolved "https://registry.yarnpkg.com/call-bind/-/call-bind-1.0.8.tgz#0736a9660f537e3388826f440d5ec45f744eaa4c"
+  integrity sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==
+  dependencies:
+    call-bind-apply-helpers "^1.0.0"
+    es-define-property "^1.0.0"
+    get-intrinsic "^1.2.4"
+    set-function-length "^1.2.2"
+
+call-bound@^1.0.2, call-bound@^1.0.3:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/call-bound/-/call-bound-1.0.3.tgz#41cfd032b593e39176a71533ab4f384aa04fd681"
+  integrity sha512-YTd+6wGlNlPxSuri7Y6X8tY2dmm12UMH66RpKMhiX6rsk5wXXnYgbUcOt8kiS31/AjfoTOvCsE+w8nZQLQnzHA==
+  dependencies:
+    call-bind-apply-helpers "^1.0.1"
+    get-intrinsic "^1.2.6"
+
 call-me-maybe@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/call-me-maybe/-/call-me-maybe-1.0.1.tgz#26d208ea89e37b5cbde60250a15f031c16a4d66b"
@@ -3424,7 +3741,7 @@ callsites@^2.0.0:
   resolved "https://registry.yarnpkg.com/callsites/-/callsites-2.0.0.tgz#06eb84f00eea413da86affefacbffb36093b3c50"
   integrity sha1-BuuE8A7qQT2oav/vrL/7Ngk7PFA=
 
-callsites@^3.0.0:
+callsites@^3.0.0, callsites@^3.1.0:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/callsites/-/callsites-3.1.0.tgz#b3630abd8943432f54b3f0519238e33cd7df2f73"
   integrity sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==
@@ -3455,16 +3772,6 @@ camelcase-keys@^6.2.2:
     map-obj "^4.0.0"
     quick-lru "^4.0.1"
 
-camelcase-keys@^7.0.0:
-  version "7.0.2"
-  resolved "https://registry.yarnpkg.com/camelcase-keys/-/camelcase-keys-7.0.2.tgz#d048d8c69448745bb0de6fc4c1c52a30dfbe7252"
-  integrity sha512-Rjs1H+A9R+Ig+4E/9oyB66UC5Mj9Xq3N//vcLf2WzgdTi/3gUu3Z9KoqmlrEG4VuuLK8wJHofxzdQXz/knhiYg==
-  dependencies:
-    camelcase "^6.3.0"
-    map-obj "^4.1.0"
-    quick-lru "^5.1.1"
-    type-fest "^1.2.1"
-
 camelcase@^2.0.0:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-2.1.1.tgz#7c1d16d679a1bbe59ca02cacecfb011e201f5a1f"
@@ -3480,7 +3787,7 @@ camelcase@^5.0.0, camelcase@^5.3.1:
   resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-5.3.1.tgz#e3c9b31569e106811df242f715725a1f4c494320"
   integrity sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==
 
-camelcase@^6.2.0, camelcase@^6.3.0:
+camelcase@^6.2.0:
   version "6.3.0"
   resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-6.3.0.tgz#5685b95eb209ac9c0c177467778c9c84df58ba9a"
   integrity sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==
@@ -3490,6 +3797,11 @@ caniuse-lite@^1.0.30001449:
   resolved "https://registry.yarnpkg.com/caniuse-lite/-/caniuse-lite-1.0.30001450.tgz#022225b91200589196b814b51b1bbe45144cf74f"
   integrity sha512-qMBmvmQmFXaSxexkjjfMvD5rnDL0+m+dUMZKoDYsGG8iZN29RuYh9eRoMvKsT6uMAWlyUUGDEQGJJYjzCIO9ew==
 
+caniuse-lite@^1.0.30001688:
+  version "1.0.30001695"
+  resolved "https://registry.yarnpkg.com/caniuse-lite/-/caniuse-lite-1.0.30001695.tgz#39dfedd8f94851132795fdf9b79d29659ad9c4d4"
+  integrity sha512-vHyLade6wTgI2u1ec3WQBxv+2BrTERV28UXQu9LO6lZ9pYeMk34vjXFLOxo1A4UBA8XTL4njRQZdno/yYaSmWw==
+
 capture-exit@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/capture-exit/-/capture-exit-2.0.0.tgz#fb953bfaebeb781f62898239dabb426d08a509a4"
@@ -3509,6 +3821,13 @@ cashaddrjs-slp@^0.2.11:
   dependencies:
     big-integer "^1.6.34"
 
+chalk-template@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/chalk-template/-/chalk-template-1.1.0.tgz#ffc55db6dd745e9394b85327c8ac8466edb7a7b1"
+  integrity sha512-T2VJbcDuZQ0Tb2EWwSotMPJjgpy1/tGee1BTpUNsGZ/qgNjV2t7Mvu+d4600U564nbLesN1x2dPL+xii174Ekg==
+  dependencies:
+    chalk "^5.2.0"
+
 chalk@^2.0.0, chalk@^2.3.1, chalk@^2.4.2:
   version "2.4.2"
   resolved "https://registry.yarnpkg.com/chalk/-/chalk-2.4.2.tgz#cd42541677a54333cf541a49108c1432b44c9424"
@@ -3526,13 +3845,10 @@ chalk@^4.0.0:
     ansi-styles "^4.1.0"
     supports-color "^7.1.0"
 
-chalk@^4.1.0:
-  version "4.1.0"
-  resolved "https://registry.yarnpkg.com/chalk/-/chalk-4.1.0.tgz#4e14870a618d9e2edd97dd8345fd9d9dc315646a"
-  integrity sha512-qwx12AxXe2Q5xQ43Ac//I6v5aXTipYrSESdOgzrN+9XjgEpyjpKuvSGaN4qE93f7TQTlerQQ8S+EQ0EyDoVL1A==
-  dependencies:
-    ansi-styles "^4.1.0"
-    supports-color "^7.1.0"
+chalk@^5.2.0, chalk@^5.4.1:
+  version "5.4.1"
+  resolved "https://registry.yarnpkg.com/chalk/-/chalk-5.4.1.tgz#1b48bf0963ec158dce2aacf69c093ae2dd2092d8"
+  integrity sha512-zgVZuo2WcZgfUEmsn6eO3kINexW8RAE4maiQ8QNs8CtpPCSyMiYsULR3HQYkm3w8FIA3SberyMJMSldGsW+U3w==
 
 char-regex@^1.0.2:
   version "1.0.2"
@@ -3589,6 +3905,14 @@ clean-stack@^4.0.0:
   dependencies:
     escape-string-regexp "5.0.0"
 
+clear-module@^4.1.2:
+  version "4.1.2"
+  resolved "https://registry.yarnpkg.com/clear-module/-/clear-module-4.1.2.tgz#5a58a5c9f8dccf363545ad7284cad3c887352a80"
+  integrity sha512-LWAxzHqdHsAZlPlEyJ2Poz6AIs384mPeqLVCru2p0BrP9G/kVGuhNyZYClLO6cXlnuJjzC8xtsJIuMjKqLXoAw==
+  dependencies:
+    parent-module "^2.0.0"
+    resolve-from "^5.0.0"
+
 cli-cursor@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/cli-cursor/-/cli-cursor-2.1.0.tgz#b35dac376479facc3e94747d41d0d0f5238ffcb5"
@@ -3643,17 +3967,6 @@ code-point-at@^1.0.0:
   resolved "https://registry.yarnpkg.com/code-point-at/-/code-point-at-1.1.0.tgz#0d070b4d043a5bea33a2f1a40e2edb3d9a4ccf77"
   integrity sha1-DQcLTQQ6W+ozovGkDi7bPZpMz3c=
 
-codecov@^3.8.1:
-  version "3.8.1"
-  resolved "https://registry.yarnpkg.com/codecov/-/codecov-3.8.1.tgz#06fe026b75525ed1ce864d4a34f1010c52c51546"
-  integrity sha512-Qm7ltx1pzLPsliZY81jyaQ80dcNR4/JpcX0IHCIWrHBXgseySqbdbYfkdiXd7o/xmzQpGRVCKGYeTrHUpn6Dcw==
-  dependencies:
-    argv "0.0.2"
-    ignore-walk "3.0.3"
-    js-yaml "3.14.0"
-    teeny-request "6.0.1"
-    urlgrey "0.4.4"
-
 collect-v8-coverage@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/collect-v8-coverage/-/collect-v8-coverage-1.0.1.tgz#cc2c8e94fc18bbdffe64d6534570c8a673b27f59"
@@ -3706,18 +4019,18 @@ combined-stream@^1.0.6, combined-stream@~1.0.6:
   dependencies:
     delayed-stream "~1.0.0"
 
-commander@^7.0.0, commander@^7.1.0:
-  version "7.1.0"
-  resolved "https://registry.yarnpkg.com/commander/-/commander-7.1.0.tgz#f2eaecf131f10e36e07d894698226e36ae0eb5ff"
-  integrity sha512-pRxBna3MJe6HKnBGsDyMv8ETbptw3axEdYHoqNh7gu5oDcew8fs0xnivZGm06Ogk8zGAJ9VX+OPEr2GXEQK4dg==
+commander@^13.0.0, commander@^13.1.0:
+  version "13.1.0"
+  resolved "https://registry.yarnpkg.com/commander/-/commander-13.1.0.tgz#776167db68c78f38dcce1f9b8d7b8b9a488abf46"
+  integrity sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw==
 
-comment-json@^4.1.0:
-  version "4.1.0"
-  resolved "https://registry.yarnpkg.com/comment-json/-/comment-json-4.1.0.tgz#09d08f0fbc4ad5eeccbac20f469adbb967dcbd2c"
-  integrity sha512-WEghmVYaNq9NlWbrkzQTSsya9ycLyxJxpTQfZEan6a5Jomnjw18zS3Podf8q1Zf9BvonvQd/+Z7Z39L7KKzzdQ==
+comment-json@^4.2.5:
+  version "4.2.5"
+  resolved "https://registry.yarnpkg.com/comment-json/-/comment-json-4.2.5.tgz#482e085f759c2704b60bc6f97f55b8c01bc41e70"
+  integrity sha512-bKw/r35jR3HGt5PEPm1ljsQQGyCrR8sFGNiN5L+ykDHdpO8Smxkrkla9Yi6NkQyUrb8V54PGhfMs6NrIwtxtdw==
   dependencies:
     array-timsort "^1.0.3"
-    core-util-is "^1.0.2"
+    core-util-is "^1.0.3"
     esprima "^4.0.1"
     has-own-prop "^2.0.0"
     repeat-string "^1.6.1"
@@ -3768,18 +4081,6 @@ config-chain@^1.1.11:
     ini "^1.3.4"
     proto-list "~1.2.1"
 
-configstore@^5.0.1:
-  version "5.0.1"
-  resolved "https://registry.yarnpkg.com/configstore/-/configstore-5.0.1.tgz#d365021b5df4b98cdd187d6a3b0e3f6a7cc5ed96"
-  integrity sha512-aMKprgk5YhBNyH25hj8wGt2+D52Sw1DRRIzqBwLp2Ya9mFmY8KPvvtvmna8SxVR9JMZ4kzMD68N22vlaRpkeFA==
-  dependencies:
-    dot-prop "^5.2.0"
-    graceful-fs "^4.1.2"
-    make-dir "^3.0.0"
-    unique-string "^2.0.0"
-    write-file-atomic "^3.0.0"
-    xdg-basedir "^4.0.0"
-
 confusing-browser-globals@^1.0.10:
   version "1.0.10"
   resolved "https://registry.yarnpkg.com/confusing-browser-globals/-/confusing-browser-globals-1.0.10.tgz#30d1e7f3d1b882b25ec4933d1d1adac353d20a59"
@@ -3907,11 +4208,16 @@ copy-descriptor@^0.1.0:
   resolved "https://registry.yarnpkg.com/copy-descriptor/-/copy-descriptor-0.1.1.tgz#676f6eb3c39997c2ee1ac3a924fd6124748f578d"
   integrity sha1-Z29us8OZl8LuGsOpJP1hJHSPV40=
 
-core-util-is@1.0.2, core-util-is@^1.0.2, core-util-is@~1.0.0:
+core-util-is@1.0.2, core-util-is@~1.0.0:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/core-util-is/-/core-util-is-1.0.2.tgz#b5fd54220aa2bc5ab57aab7140c940754503c1a7"
   integrity sha1-tf1UIgqivFq1eqtxQMlAdUUDwac=
 
+core-util-is@^1.0.3:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/core-util-is/-/core-util-is-1.0.3.tgz#a6042d3634c2b27e9328f837b965fac83808db85"
+  integrity sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==
+
 cosmiconfig@^5.1.0:
   version "5.2.1"
   resolved "https://registry.yarnpkg.com/cosmiconfig/-/cosmiconfig-5.2.1.tgz#040f726809c591e77a17c0a3626ca45b4f168b1a"
@@ -3922,48 +4228,36 @@ cosmiconfig@^5.1.0:
     js-yaml "^3.13.1"
     parse-json "^4.0.0"
 
-cosmiconfig@^7.0.0:
-  version "7.0.0"
-  resolved "https://registry.yarnpkg.com/cosmiconfig/-/cosmiconfig-7.0.0.tgz#ef9b44d773959cae63ddecd122de23853b60f8d3"
-  integrity sha512-pondGvTuVYDk++upghXJabWzL6Kxu6f26ljFw64Swq9v6sQPUL3EUlVDV56diOjpCayKihL6hVe8exIACU4XcA==
+cp-file@^10.0.0:
+  version "10.0.0"
+  resolved "https://registry.yarnpkg.com/cp-file/-/cp-file-10.0.0.tgz#bbae9ecb9f505951b862880d2901e1f56de7a4dc"
+  integrity sha512-vy2Vi1r2epK5WqxOLnskeKeZkdZvTKfFZQCplE3XWsP+SUJyd5XAUFC9lFgTjjXJF2GMne/UML14iEmkAaDfFg==
   dependencies:
-    "@types/parse-json" "^4.0.0"
-    import-fresh "^3.2.1"
-    parse-json "^5.0.0"
-    path-type "^4.0.0"
-    yaml "^1.10.0"
-
-cp-file@^9.1.0:
-  version "9.1.0"
-  resolved "https://registry.yarnpkg.com/cp-file/-/cp-file-9.1.0.tgz#e98e30db72d57d47b5b1d444deb70d05e5684921"
-  integrity sha512-3scnzFj/94eb7y4wyXRWwvzLFaQp87yyfTnChIjlfYrVqp5lVO3E2hIJMeQIltUT0K2ZAB3An1qXcBmwGyvuwA==
-  dependencies:
-    graceful-fs "^4.1.2"
-    make-dir "^3.0.0"
-    nested-error-stacks "^2.0.0"
-    p-event "^4.1.0"
+    graceful-fs "^4.2.10"
+    nested-error-stacks "^2.1.1"
+    p-event "^5.0.1"
 
-cpy-cli@^4.2.0:
-  version "4.2.0"
-  resolved "https://registry.yarnpkg.com/cpy-cli/-/cpy-cli-4.2.0.tgz#d60bf9ac776486af20aac2fa4fb95f8f10b35ce8"
-  integrity sha512-b04b+cbdr29CdpREPKw/itrfjO43Ty0Aj7wRM6M6LoE4GJxZJCk9Xp+Eu1IqztkKh3LxIBt1tDplENsa6KYprg==
+cpy-cli@^5.0.0:
+  version "5.0.0"
+  resolved "https://registry.yarnpkg.com/cpy-cli/-/cpy-cli-5.0.0.tgz#facd60da2e98d9a830f93162f9769d2a86667a16"
+  integrity sha512-fb+DZYbL9KHc0BC4NYqGRrDIJZPXUmjjtqdw4XRRg8iV8dIfghUX/WiL+q4/B/KFTy3sK6jsbUhBaz0/Hxg7IQ==
   dependencies:
-    cpy "^9.0.0"
-    meow "^10.1.2"
+    cpy "^10.1.0"
+    meow "^12.0.1"
 
-cpy@^9.0.0:
-  version "9.0.1"
-  resolved "https://registry.yarnpkg.com/cpy/-/cpy-9.0.1.tgz#7f3ad0ad5bafe0bc70645c4bb567969927cadb9f"
-  integrity sha512-D9U0DR5FjTCN3oMTcFGktanHnAG5l020yvOCR1zKILmAyPP7I/9pl6NFgRbDcmSENtbK1sQLBz1p9HIOlroiNg==
+cpy@^10.1.0:
+  version "10.1.0"
+  resolved "https://registry.yarnpkg.com/cpy/-/cpy-10.1.0.tgz#85517387036b9be480f6424e54089261fc6f4bab"
+  integrity sha512-VC2Gs20JcTyeQob6UViBLnyP0bYHkBh6EiKzot9vi2DmeGlFT9Wd7VG3NBrkNx/jYvFBeyDOMMHdHQhbtKLgHQ==
   dependencies:
     arrify "^3.0.0"
-    cp-file "^9.1.0"
-    globby "^13.1.1"
-    junk "^4.0.0"
-    micromatch "^4.0.4"
-    nested-error-stacks "^2.1.0"
+    cp-file "^10.0.0"
+    globby "^13.1.4"
+    junk "^4.0.1"
+    micromatch "^4.0.5"
+    nested-error-stacks "^2.1.1"
     p-filter "^3.0.0"
-    p-map "^5.3.0"
+    p-map "^6.0.0"
 
 create-hash@^1.1.0, create-hash@^1.1.1, create-hash@^1.1.2, create-hash@^1.2.0:
   version "1.2.0"
@@ -3988,6 +4282,19 @@ create-hmac@^1.1.3, create-hmac@^1.1.4:
     safe-buffer "^5.0.1"
     sha.js "^2.4.8"
 
+create-jest@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/create-jest/-/create-jest-29.7.0.tgz#a355c5b3cb1e1af02ba177fe7afd7feee49a5320"
+  integrity sha512-Adz2bdH0Vq3F53KEMJOoftQFutWCukm6J24wbPWRO4k1kMY7gS7ds/uoJkNuV8wDCtWWnuwGcJwpWcih+zEW1Q==
+  dependencies:
+    "@jest/types" "^29.6.3"
+    chalk "^4.0.0"
+    exit "^0.1.2"
+    graceful-fs "^4.2.9"
+    jest-config "^29.7.0"
+    jest-util "^29.7.0"
+    prompts "^2.0.1"
+
 cross-spawn@^6.0.0:
   version "6.0.5"
   resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-6.0.5.tgz#4a5ec7c64dfae22c3a14124dbacdee846d80cbc4"
@@ -4008,68 +4315,121 @@ cross-spawn@^7.0.2, cross-spawn@^7.0.3:
     shebang-command "^2.0.0"
     which "^2.0.1"
 
-crypto-random-string@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/crypto-random-string/-/crypto-random-string-2.0.0.tgz#ef2a7a966ec11083388369baa02ebead229b30d5"
-  integrity sha512-v1plID3y9r/lPhviJ1wrXpLeyUIGAZ2SHNYTEapm7/8A9nLPoyvVp3RK/EPFqn5kEznyWgYZNsRtYYIWbuG8KA==
-
-cspell-glob@^5.2.0:
-  version "5.2.0"
-  resolved "https://registry.yarnpkg.com/cspell-glob/-/cspell-glob-5.2.0.tgz#19bf774562254d5bccd5491d2a904357c6f4a683"
-  integrity sha512-Zc80PsQ86Sfsl04+PjoImfrUnFcPJh78Beg/gFjeJ9+7oUk3oBlAcAczat0ZdfOAdQ3x/rWCH30SoefuaEfsiw==
-  dependencies:
-    micromatch "^4.0.2"
-
-cspell-io@^5.2.0:
-  version "5.2.0"
-  resolved "https://registry.yarnpkg.com/cspell-io/-/cspell-io-5.2.0.tgz#a482cdaa165872445fdb0a68b973ff6dbe09efb0"
-  integrity sha512-8GFIa31vFtFleJ2ZC4Nb3QmG426aEglKu9OD3lcufNWSnFL1A6tbJJ0zGhuiYDpnyVRMKVkur/vh1FVNNvR83w==
-  dependencies:
-    iconv-lite "^0.6.2"
-    iterable-to-stream "^1.0.1"
-
-cspell-lib@^5.2.4:
-  version "5.2.4"
-  resolved "https://registry.yarnpkg.com/cspell-lib/-/cspell-lib-5.2.4.tgz#8296c5045fa7c4072dcd8b8995e1ae83949c5873"
-  integrity sha512-DR0ZSNCwurHCobO5QDYyEuCCmkXRutQvfoK18wICuiUElD4WkgksuWPItRr2s5901t/QvImh349U+2UuO9qwCA==
-  dependencies:
-    "@cspell/cspell-bundled-dicts" "^5.2.4"
-    "@cspell/cspell-types" "^5.2.4"
-    comment-json "^4.1.0"
-    configstore "^5.0.1"
-    cosmiconfig "^7.0.0"
-    cspell-io "^5.2.0"
-    cspell-trie-lib "^5.2.2"
-    fs-extra "^9.1.0"
-    gensequence "^3.1.1"
-    minimatch "^3.0.4"
+cspell-config-lib@8.17.2:
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/cspell-config-lib/-/cspell-config-lib-8.17.2.tgz#81f5c341df27917ac505f36dbac2c0b4a883e1e7"
+  integrity sha512-g08lRd/smLk2je0j7HlCjdDa0dSTyI2oRP3gScWlsyXjb4NSr9qO0Wzyn5BfPgrqFdS/z4dXbHe+tnLQZCt9iQ==
+  dependencies:
+    "@cspell/cspell-types" "8.17.2"
+    comment-json "^4.2.5"
+    yaml "^2.7.0"
+
+cspell-dictionary@8.17.2:
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/cspell-dictionary/-/cspell-dictionary-8.17.2.tgz#a930cff2bea8dd35c5f5b0a383385b463eeee407"
+  integrity sha512-2JC9RRsZruCs3AHId/8X63fSxDoF94dleRp8y/dXS9LIX7NruofohUJwzc/3tlgzCWWdaek1RXhO5xaYX74QtA==
+  dependencies:
+    "@cspell/cspell-pipe" "8.17.2"
+    "@cspell/cspell-types" "8.17.2"
+    cspell-trie-lib "8.17.2"
+    fast-equals "^5.2.2"
+
+cspell-gitignore@8.17.2:
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/cspell-gitignore/-/cspell-gitignore-8.17.2.tgz#87b2709cd86b5ab7b10ba777ced5ef372b8da49f"
+  integrity sha512-zCTTN30zV96LkZmUDrLamEHpLLUGohKglKJ4iXoHQC8pDU3xTsV2qzeCQjM9SEmU3VbE1TzWq+vj0fslasv6pA==
+  dependencies:
+    "@cspell/url" "8.17.2"
+    cspell-glob "8.17.2"
+    cspell-io "8.17.2"
+    find-up-simple "^1.0.0"
+
+cspell-glob@8.17.2:
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/cspell-glob/-/cspell-glob-8.17.2.tgz#c81c874f0970ccd885a78bddac318037fec73389"
+  integrity sha512-MTgrWX12oY8Pq/M3PEYCTHwD6w6l+DPtBWm958nhR4dboUbwi/3KfqCtdorkhnuClqLDQuuZHp0uGBXB4cdQrw==
+  dependencies:
+    "@cspell/url" "8.17.2"
+    micromatch "^4.0.8"
+
+cspell-grammar@8.17.2:
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/cspell-grammar/-/cspell-grammar-8.17.2.tgz#a6cea2500db2a308e17d2c0c80fd57113e0bc70d"
+  integrity sha512-Asg5XRvrg2yHCvBwzARBPSwI4P5/unN+bKBlxqFazHgR72WJE+ASeobfUNfGi/RxJA2+m0hO91oYtvq6LfK52w==
+  dependencies:
+    "@cspell/cspell-pipe" "8.17.2"
+    "@cspell/cspell-types" "8.17.2"
+
+cspell-io@8.17.2:
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/cspell-io/-/cspell-io-8.17.2.tgz#cf1b9bef164461f407f8c8c4731999fbe8a02019"
+  integrity sha512-IUdhbO6gsWYiM2dgudFJQTfnFCDYjLOqal3SxH5o8oOWeu5iIZ+s3N8E1odz0L5zF2Go7zDQSKvPr7Y9OOoRfw==
+  dependencies:
+    "@cspell/cspell-service-bus" "8.17.2"
+    "@cspell/url" "8.17.2"
+
+cspell-lib@8.17.2:
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/cspell-lib/-/cspell-lib-8.17.2.tgz#c14f4a5eec3d0fa828a21cfe1e15f4c13eccb903"
+  integrity sha512-ZgkTvGh9FO+R3v5TaTqlrJEylWyZhNOzbtrQ5W35Hb3tZ9IJJklxjlcGe+gbFsjGi56kLj6c5L2NR7YX/Fdu5Q==
+  dependencies:
+    "@cspell/cspell-bundled-dicts" "8.17.2"
+    "@cspell/cspell-pipe" "8.17.2"
+    "@cspell/cspell-resolver" "8.17.2"
+    "@cspell/cspell-types" "8.17.2"
+    "@cspell/dynamic-import" "8.17.2"
+    "@cspell/filetypes" "8.17.2"
+    "@cspell/strong-weak-map" "8.17.2"
+    "@cspell/url" "8.17.2"
+    clear-module "^4.1.2"
+    comment-json "^4.2.5"
+    cspell-config-lib "8.17.2"
+    cspell-dictionary "8.17.2"
+    cspell-glob "8.17.2"
+    cspell-grammar "8.17.2"
+    cspell-io "8.17.2"
+    cspell-trie-lib "8.17.2"
+    env-paths "^3.0.0"
+    fast-equals "^5.2.2"
+    gensequence "^7.0.0"
+    import-fresh "^3.3.0"
     resolve-from "^5.0.0"
-    resolve-global "^1.0.0"
-    vscode-uri "^3.0.2"
-
-cspell-trie-lib@^5.2.2:
-  version "5.2.2"
-  resolved "https://registry.yarnpkg.com/cspell-trie-lib/-/cspell-trie-lib-5.2.2.tgz#5f8878dc09a630ce37a9e6a42f4b5cecaa003ce2"
-  integrity sha512-Zs4POqx8xPuNF8Cex3NnSv0Ti8sS5UiL5ruo6tKwQWJbpWvrBZ/FTlypG4l2y0BMEqd+/CqmjOv3GX8dDE2lBg==
-  dependencies:
-    fs-extra "^9.1.0"
-    gensequence "^3.1.1"
-
-cspell@^5.2.4:
-  version "5.2.4"
-  resolved "https://registry.yarnpkg.com/cspell/-/cspell-5.2.4.tgz#d28b6a6ff93d1824c560a2c6f5e4d9000227a12a"
-  integrity sha512-ONMoI2Yf9of662Ac8Azg+EKXWSDxZIjSWGtkg6FNQOCzD0AgO6ZJv2ti9mHuSZ9rovfaPJUocmiTJSl9TncK6g==
-  dependencies:
-    chalk "^4.1.0"
-    commander "^7.0.0"
-    comment-json "^4.1.0"
-    cspell-glob "^5.2.0"
-    cspell-lib "^5.2.4"
-    fs-extra "^9.1.0"
-    get-stdin "^8.0.0"
-    glob "^7.1.6"
-    minimatch "^3.0.4"
-    strip-ansi "^6.0.0"
+    vscode-languageserver-textdocument "^1.0.12"
+    vscode-uri "^3.0.8"
+    xdg-basedir "^5.1.0"
+
+cspell-trie-lib@8.17.2:
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/cspell-trie-lib/-/cspell-trie-lib-8.17.2.tgz#f6b34192d510028c8a98c0d0f9f62a870afa29f0"
+  integrity sha512-Bw9q8EWFihkQGo8fNdfkUqYOTsC161+wrQxR7m74K4bKEmQgm0mS0sLHKUwxEOZVGGLmIw9dMQl+8WnTgqOaMQ==
+  dependencies:
+    "@cspell/cspell-pipe" "8.17.2"
+    "@cspell/cspell-types" "8.17.2"
+    gensequence "^7.0.0"
+
+cspell@^8.17.2:
+  version "8.17.2"
+  resolved "https://registry.yarnpkg.com/cspell/-/cspell-8.17.2.tgz#fce96c5e4096645b4c97bb528db29fa9e4841332"
+  integrity sha512-y+INkxDa+M9f+gsyyMLjKh1tF20r2g5Gn22peSRJglrNLQtmDuRtDT9vyDHANXZcH5g6pHDnENQu/+P2Tiyu8Q==
+  dependencies:
+    "@cspell/cspell-json-reporter" "8.17.2"
+    "@cspell/cspell-pipe" "8.17.2"
+    "@cspell/cspell-types" "8.17.2"
+    "@cspell/dynamic-import" "8.17.2"
+    "@cspell/url" "8.17.2"
+    chalk "^5.4.1"
+    chalk-template "^1.1.0"
+    commander "^13.0.0"
+    cspell-dictionary "8.17.2"
+    cspell-gitignore "8.17.2"
+    cspell-glob "8.17.2"
+    cspell-io "8.17.2"
+    cspell-lib "8.17.2"
+    fast-json-stable-stringify "^2.1.0"
+    file-entry-cache "^9.1.0"
+    get-stdin "^9.0.0"
+    semver "^7.6.3"
+    tinyglobby "^0.2.10"
 
 currently-unhandled@^0.4.1:
   version "0.4.1"
@@ -4097,30 +4457,30 @@ dashdash@^1.12.0:
   dependencies:
     assert-plus "^1.0.0"
 
-data-view-buffer@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/data-view-buffer/-/data-view-buffer-1.0.1.tgz#8ea6326efec17a2e42620696e671d7d5a8bc66b2"
-  integrity sha512-0lht7OugA5x3iJLOWFhWK/5ehONdprk0ISXqVFn/NFrDu+cuc8iADFrGQz5BnRK7LLU3JmkbXSxaqX+/mXYtUA==
+data-view-buffer@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/data-view-buffer/-/data-view-buffer-1.0.2.tgz#211a03ba95ecaf7798a8c7198d79536211f88570"
+  integrity sha512-EmKO5V3OLXh1rtK2wgXRansaK1/mtVdTUEiEI0W8RkvgT05kfxaH29PliLnpLP73yYO6142Q72QNa8Wx/A5CqQ==
   dependencies:
-    call-bind "^1.0.6"
+    call-bound "^1.0.3"
     es-errors "^1.3.0"
-    is-data-view "^1.0.1"
+    is-data-view "^1.0.2"
 
-data-view-byte-length@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/data-view-byte-length/-/data-view-byte-length-1.0.1.tgz#90721ca95ff280677eb793749fce1011347669e2"
-  integrity sha512-4J7wRJD3ABAzr8wP+OcIcqq2dlUKp4DVflx++hs5h5ZKydWMI6/D/fAot+yh6g2tHh8fLFTvNOaVN357NvSrOQ==
+data-view-byte-length@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/data-view-byte-length/-/data-view-byte-length-1.0.2.tgz#9e80f7ca52453ce3e93d25a35318767ea7704735"
+  integrity sha512-tuhGbE6CfTM9+5ANGf+oQb72Ky/0+s3xKUpHvShfiz2RxMFgFPjsXuRLBVMtvMs15awe45SRb83D6wH4ew6wlQ==
   dependencies:
-    call-bind "^1.0.7"
+    call-bound "^1.0.3"
     es-errors "^1.3.0"
-    is-data-view "^1.0.1"
+    is-data-view "^1.0.2"
 
-data-view-byte-offset@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/data-view-byte-offset/-/data-view-byte-offset-1.0.0.tgz#5e0bbfb4828ed2d1b9b400cd8a7d119bca0ff18a"
-  integrity sha512-t/Ygsytq+R995EJ5PZlD4Cu56sWa8InXySaViRzw9apusqsOO2bQP+SbYzAhR0pFKoB+43lYy8rWban9JSuXnA==
+data-view-byte-offset@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/data-view-byte-offset/-/data-view-byte-offset-1.0.1.tgz#068307f9b71ab76dbbe10291389e020856606191"
+  integrity sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ==
   dependencies:
-    call-bind "^1.0.6"
+    call-bound "^1.0.2"
     es-errors "^1.3.0"
     is-data-view "^1.0.1"
 
@@ -4136,13 +4496,6 @@ debug@3.1.0:
   dependencies:
     ms "2.0.0"
 
-debug@4, debug@^4.1.0:
-  version "4.1.1"
-  resolved "https://registry.yarnpkg.com/debug/-/debug-4.1.1.tgz#3b72260255109c6b589cee050f1d516139664791"
-  integrity sha512-pYAIzeRo8J6KPEaJ0VWOh5Pzkbw/RetuzehGM7QRRX5he4fPHx2rdKMB256ehJCkX+XRQm16eZLqLNS8RSZXZw==
-  dependencies:
-    ms "^2.1.1"
-
 debug@^2.2.0, debug@^2.3.3:
   version "2.6.9"
   resolved "https://registry.yarnpkg.com/debug/-/debug-2.6.9.tgz#5d128515df134ff327e90a4c93f4e077a536341f"
@@ -4164,6 +4517,13 @@ debug@^3.2.7:
   dependencies:
     ms "^2.1.1"
 
+debug@^4.1.0:
+  version "4.1.1"
+  resolved "https://registry.yarnpkg.com/debug/-/debug-4.1.1.tgz#3b72260255109c6b589cee050f1d516139664791"
+  integrity sha512-pYAIzeRo8J6KPEaJ0VWOh5Pzkbw/RetuzehGM7QRRX5he4fPHx2rdKMB256ehJCkX+XRQm16eZLqLNS8RSZXZw==
+  dependencies:
+    ms "^2.1.1"
+
 debug@^4.1.1, debug@^4.3.1, debug@^4.3.2, debug@^4.3.4:
   version "4.3.6"
   resolved "https://registry.yarnpkg.com/debug/-/debug-4.3.6.tgz#2ab2c38fbaffebf8aa95fdfe6d88438c7a13c52b"
@@ -4189,11 +4549,6 @@ decamelize@^1.1.0, decamelize@^1.1.2, decamelize@^1.2.0:
   resolved "https://registry.yarnpkg.com/decamelize/-/decamelize-1.2.0.tgz#f6534d15148269b20352e7bee26f501f9a191290"
   integrity sha1-9lNNFRSCabIDUue+4m9QH5oZEpA=
 
-decamelize@^5.0.0:
-  version "5.0.1"
-  resolved "https://registry.yarnpkg.com/decamelize/-/decamelize-5.0.1.tgz#db11a92e58c741ef339fb0a2868d8a06a9a7b1e9"
-  integrity sha512-VfxadyCECXgQlkoEAjeghAr5gY3Hf+IKjKb+X8tGVDtveCjN+USwprd2q3QXBR9T1+x2DG0XZF5/w+7HAtSaXA==
-
 decode-uri-component@^0.2.0:
   version "0.2.0"
   resolved "https://registry.yarnpkg.com/decode-uri-component/-/decode-uri-component-0.2.0.tgz#eb3913333458775cb84cd1a1fae062106bb87545"
@@ -4204,6 +4559,11 @@ dedent@^0.7.0:
   resolved "https://registry.yarnpkg.com/dedent/-/dedent-0.7.0.tgz#2495ddbaf6eb874abb0e1be9df22d2e5a544326c"
   integrity sha512-Q6fKUPqnAHAyhiUgFU7BUzLiv0kd8saH9al7tnu5Q/okj6dnupxyTgFIBjVzJATdfIAm9NAsvXNzjaKa+bxVyA==
 
+dedent@^1.0.0:
+  version "1.5.3"
+  resolved "https://registry.yarnpkg.com/dedent/-/dedent-1.5.3.tgz#99aee19eb9bae55a67327717b6e848d0bf777e5a"
+  integrity sha512-NHQtfOOW68WD8lgypbLA5oT+Bt0xXJhiYvoR6SmmNXZfpzOGXwdKWmcwG8N7PwVVWV3eF/68nmD9BaJSsTBhyQ==
+
 deep-equal@^2.0.3:
   version "2.0.3"
   resolved "https://registry.yarnpkg.com/deep-equal/-/deep-equal-2.0.3.tgz#cad1c15277ad78a5c01c49c2dee0f54de8a6a7b0"
@@ -4293,10 +4653,10 @@ defined@^1.0.0:
   resolved "https://registry.yarnpkg.com/defined/-/defined-1.0.0.tgz#c98d9bcef75674188e110969151199e39b1fa693"
   integrity sha1-yY2bzvdWdBiOEQlpFRGZ45sfppM=
 
-delay@^5.0.0:
-  version "5.0.0"
-  resolved "https://registry.yarnpkg.com/delay/-/delay-5.0.0.tgz#137045ef1b96e5071060dd5be60bf9334436bd1d"
-  integrity sha512-ReEBKkIfe4ya47wlPYf/gu5ib6yUG0/Aez0JQZQz94kiWtRQvZIQbTiehsnwHvLSWJnQdhVeqYue7Id1dKr0qw==
+delay@^6.0.0:
+  version "6.0.0"
+  resolved "https://registry.yarnpkg.com/delay/-/delay-6.0.0.tgz#43749aefdf6cabd9e17b0d00bd3904525137e607"
+  integrity sha512-2NJozoOHQ4NuZuVIr5CWd0iiLVIRSDepakaovIN+9eIDHEhdCAEvSy2cuf1DCrPPQLvHmbqTHODlhHg8UCy4zw==
 
 delayed-stream@~1.0.0:
   version "1.0.0"
@@ -4331,11 +4691,6 @@ dezalgo@^1.0.0:
     asap "^2.0.0"
     wrappy "1"
 
-diff-sequences@^29.3.1:
-  version "29.3.1"
-  resolved "https://registry.yarnpkg.com/diff-sequences/-/diff-sequences-29.3.1.tgz#104b5b95fe725932421a9c6e5b4bef84c3f2249e"
-  integrity sha512-hlM3QR272NXCi4pq+N4Kok4kOp6EsgOM3ZSpJI7Da3UAs+Ttsi8MRmB6trM/lhyzUxGfOgnpkHtgqm5Q/CTcfQ==
-
 diff-sequences@^29.6.3:
   version "29.6.3"
   resolved "https://registry.yarnpkg.com/diff-sequences/-/diff-sequences-29.6.3.tgz#4deaf894d11407c51efc8418012f9e70b84ea921"
@@ -4383,13 +4738,6 @@ dot-prop@^5.1.0:
   dependencies:
     is-obj "^2.0.0"
 
-dot-prop@^5.2.0:
-  version "5.3.0"
-  resolved "https://registry.yarnpkg.com/dot-prop/-/dot-prop-5.3.0.tgz#90ccce708cd9cd82cc4dc8c3ddd9abdd55b20e88"
-  integrity sha512-QM8q3zDe58hqUqjraQOmzZ1LIH9SWQJTlEKCH4kJ2oQvLZk7RbQXvtDM2XEq3fwkV9CCvvH4LA0AV+ogFsBM2Q==
-  dependencies:
-    is-obj "^2.0.0"
-
 dotignore@^0.1.2:
   version "0.1.2"
   resolved "https://registry.yarnpkg.com/dotignore/-/dotignore-0.1.2.tgz#f942f2200d28c3a76fbdd6f0ee9f3257c8a2e905"
@@ -4406,6 +4754,15 @@ drbg.js@^1.0.1:
     create-hash "^1.1.2"
     create-hmac "^1.1.4"
 
+dunder-proto@^1.0.0, dunder-proto@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/dunder-proto/-/dunder-proto-1.0.1.tgz#d7ae667e1dc83482f8b70fd0f6eefc50da30f58a"
+  integrity sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==
+  dependencies:
+    call-bind-apply-helpers "^1.0.1"
+    es-errors "^1.3.0"
+    gopd "^1.2.0"
+
 duplexer@^0.1.1:
   version "0.1.2"
   resolved "https://registry.yarnpkg.com/duplexer/-/duplexer-0.1.2.tgz#3abe43aef3835f8ae077d136ddce0f276b0400e6"
@@ -4449,6 +4806,11 @@ electron-to-chromium@^1.4.284:
   resolved "https://registry.yarnpkg.com/electron-to-chromium/-/electron-to-chromium-1.4.286.tgz#0e039de59135f44ab9a8ec9025e53a9135eba11f"
   integrity sha512-Vp3CVhmYpgf4iXNKAucoQUDcCrBQX3XLBtwgFqP9BUXuucgvAV9zWp1kYU7LL9j4++s9O+12cb3wMtN4SJy6UQ==
 
+electron-to-chromium@^1.5.73:
+  version "1.5.84"
+  resolved "https://registry.yarnpkg.com/electron-to-chromium/-/electron-to-chromium-1.5.84.tgz#8e334ca206bb293a20b16418bf454783365b0a95"
+  integrity sha512-I+DQ8xgafao9Ha6y0qjHHvpZ9OfyA1qKlkHkjywxzniORU2awxyz7f/iVJcULmrF2yrM3nHQf+iDjJtbbexd/g==
+
 electrum-cash@^2.0.10:
   version "2.0.10"
   resolved "https://registry.yarnpkg.com/electrum-cash/-/electrum-cash-2.0.10.tgz#0b2831d01b214bff1dfee7b90022f36126cb6945"
@@ -4507,6 +4869,11 @@ env-paths@^2.2.0:
   resolved "https://registry.yarnpkg.com/env-paths/-/env-paths-2.2.0.tgz#cdca557dc009152917d6166e2febe1f039685e43"
   integrity sha512-6u0VYSCo/OW6IoD5WCLLy9JUGARbamfSavcNXry/eu8aHVFei6CD3Sw+VGX5alea1i9pgPHW0mbu6Xj0uBh7gA==
 
+env-paths@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.yarnpkg.com/env-paths/-/env-paths-3.0.0.tgz#2f1e89c2f6dbd3408e1b1711dd82d62e317f58da"
+  integrity sha512-dtJUTepzMW3Lm/NPxRf3wP4642UWhjL2sQxc+ym2YMj1m/H2zDNQOlezafzkHwn6sMstjHTwG6iQQsctDW/b1A==
+
 envinfo@^7.3.1:
   version "7.7.3"
   resolved "https://registry.yarnpkg.com/envinfo/-/envinfo-7.7.3.tgz#4b2d8622e3e7366afb8091b23ed95569ea0208cc"
@@ -4559,66 +4926,69 @@ es-abstract@^1.18.0-next.0:
     string.prototype.trimend "^1.0.1"
     string.prototype.trimstart "^1.0.1"
 
-es-abstract@^1.22.1, es-abstract@^1.22.3, es-abstract@^1.23.0, es-abstract@^1.23.2:
-  version "1.23.3"
-  resolved "https://registry.yarnpkg.com/es-abstract/-/es-abstract-1.23.3.tgz#8f0c5a35cd215312573c5a27c87dfd6c881a0aa0"
-  integrity sha512-e+HfNH61Bj1X9/jLc5v1owaLYuHdeHHSQlkhCBiTK8rBvKaULl/beGMxwrMXjpYrv4pz22BlY570vVePA2ho4A==
+es-abstract@^1.22.1, es-abstract@^1.23.2, es-abstract@^1.23.5, es-abstract@^1.23.9:
+  version "1.23.9"
+  resolved "https://registry.yarnpkg.com/es-abstract/-/es-abstract-1.23.9.tgz#5b45994b7de78dada5c1bebf1379646b32b9d606"
+  integrity sha512-py07lI0wjxAC/DcfK1S6G7iANonniZwTISvdPzk9hzeH0IZIshbuuFxLIU96OyF89Yb9hiqWn8M/bY83KY5vzA==
   dependencies:
-    array-buffer-byte-length "^1.0.1"
-    arraybuffer.prototype.slice "^1.0.3"
+    array-buffer-byte-length "^1.0.2"
+    arraybuffer.prototype.slice "^1.0.4"
     available-typed-arrays "^1.0.7"
-    call-bind "^1.0.7"
-    data-view-buffer "^1.0.1"
-    data-view-byte-length "^1.0.1"
-    data-view-byte-offset "^1.0.0"
-    es-define-property "^1.0.0"
+    call-bind "^1.0.8"
+    call-bound "^1.0.3"
+    data-view-buffer "^1.0.2"
+    data-view-byte-length "^1.0.2"
+    data-view-byte-offset "^1.0.1"
+    es-define-property "^1.0.1"
     es-errors "^1.3.0"
     es-object-atoms "^1.0.0"
-    es-set-tostringtag "^2.0.3"
-    es-to-primitive "^1.2.1"
-    function.prototype.name "^1.1.6"
-    get-intrinsic "^1.2.4"
-    get-symbol-description "^1.0.2"
-    globalthis "^1.0.3"
-    gopd "^1.0.1"
+    es-set-tostringtag "^2.1.0"
+    es-to-primitive "^1.3.0"
+    function.prototype.name "^1.1.8"
+    get-intrinsic "^1.2.7"
+    get-proto "^1.0.0"
+    get-symbol-description "^1.1.0"
+    globalthis "^1.0.4"
+    gopd "^1.2.0"
     has-property-descriptors "^1.0.2"
-    has-proto "^1.0.3"
-    has-symbols "^1.0.3"
+    has-proto "^1.2.0"
+    has-symbols "^1.1.0"
     hasown "^2.0.2"
-    internal-slot "^1.0.7"
-    is-array-buffer "^3.0.4"
+    internal-slot "^1.1.0"
+    is-array-buffer "^3.0.5"
     is-callable "^1.2.7"
-    is-data-view "^1.0.1"
-    is-negative-zero "^2.0.3"
-    is-regex "^1.1.4"
-    is-shared-array-buffer "^1.0.3"
-    is-string "^1.0.7"
-    is-typed-array "^1.1.13"
-    is-weakref "^1.0.2"
-    object-inspect "^1.13.1"
+    is-data-view "^1.0.2"
+    is-regex "^1.2.1"
+    is-shared-array-buffer "^1.0.4"
+    is-string "^1.1.1"
+    is-typed-array "^1.1.15"
+    is-weakref "^1.1.0"
+    math-intrinsics "^1.1.0"
+    object-inspect "^1.13.3"
     object-keys "^1.1.1"
-    object.assign "^4.1.5"
-    regexp.prototype.flags "^1.5.2"
-    safe-array-concat "^1.1.2"
-    safe-regex-test "^1.0.3"
-    string.prototype.trim "^1.2.9"
-    string.prototype.trimend "^1.0.8"
+    object.assign "^4.1.7"
+    own-keys "^1.0.1"
+    regexp.prototype.flags "^1.5.3"
+    safe-array-concat "^1.1.3"
+    safe-push-apply "^1.0.0"
+    safe-regex-test "^1.1.0"
+    set-proto "^1.0.0"
+    string.prototype.trim "^1.2.10"
+    string.prototype.trimend "^1.0.9"
     string.prototype.trimstart "^1.0.8"
-    typed-array-buffer "^1.0.2"
-    typed-array-byte-length "^1.0.1"
-    typed-array-byte-offset "^1.0.2"
-    typed-array-length "^1.0.6"
-    unbox-primitive "^1.0.2"
-    which-typed-array "^1.1.15"
-
-es-define-property@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/es-define-property/-/es-define-property-1.0.0.tgz#c7faefbdff8b2696cf5f46921edfb77cc4ba3845"
-  integrity sha512-jxayLKShrEqqzJ0eumQbVhTYQM27CfT1T35+gCgDFoL82JLsXqTJ76zv6A0YLOgEnLUMvLzsDsGIrl8NFpT2gQ==
-  dependencies:
-    get-intrinsic "^1.2.4"
+    typed-array-buffer "^1.0.3"
+    typed-array-byte-length "^1.0.3"
+    typed-array-byte-offset "^1.0.4"
+    typed-array-length "^1.0.7"
+    unbox-primitive "^1.1.0"
+    which-typed-array "^1.1.18"
+
+es-define-property@^1.0.0, es-define-property@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/es-define-property/-/es-define-property-1.0.1.tgz#983eb2f9a6724e9303f61addf011c72e09e0b0fa"
+  integrity sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==
 
-es-errors@^1.2.1, es-errors@^1.3.0:
+es-errors@^1.3.0:
   version "1.3.0"
   resolved "https://registry.yarnpkg.com/es-errors/-/es-errors-1.3.0.tgz#05f75a25dab98e4fb1dcd5e1472c0546d5057c8f"
   integrity sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==
@@ -4637,36 +5007,37 @@ es-get-iterator@^1.1.0:
     isarray "^2.0.5"
 
 es-object-atoms@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/es-object-atoms/-/es-object-atoms-1.0.0.tgz#ddb55cd47ac2e240701260bc2a8e31ecb643d941"
-  integrity sha512-MZ4iQ6JwHOBQjahnjwaC1ZtIBH+2ohjamzAO3oaHcXYup7qxjF2fixyH+Q71voWHeOkI2q/TnJao/KfXYIZWbw==
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/es-object-atoms/-/es-object-atoms-1.1.1.tgz#1c4f2c4837327597ce69d2ca190a7fdd172338c1"
+  integrity sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==
   dependencies:
     es-errors "^1.3.0"
 
-es-set-tostringtag@^2.0.3:
-  version "2.0.3"
-  resolved "https://registry.yarnpkg.com/es-set-tostringtag/-/es-set-tostringtag-2.0.3.tgz#8bb60f0a440c2e4281962428438d58545af39777"
-  integrity sha512-3T8uNMC3OQTHkFUsFq8r/BwAXLHvU/9O9mE0fBc/MY5iq/8H7ncvO947LmYA6ldWw9Uh8Yhf25zu6n7nML5QWQ==
+es-set-tostringtag@^2.1.0:
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz#f31dbbe0c183b00a6d26eb6325c810c0fd18bd4d"
+  integrity sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==
   dependencies:
-    get-intrinsic "^1.2.4"
+    es-errors "^1.3.0"
+    get-intrinsic "^1.2.6"
     has-tostringtag "^1.0.2"
-    hasown "^2.0.1"
+    hasown "^2.0.2"
 
-es-shim-unscopables@^1.0.0, es-shim-unscopables@^1.0.2:
+es-shim-unscopables@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/es-shim-unscopables/-/es-shim-unscopables-1.0.2.tgz#1f6942e71ecc7835ed1c8a83006d8771a63a3763"
   integrity sha512-J3yBRXCzDu4ULnQwxyToo/OjdMx6akgVC7K6few0a7F/0wLtmKKN7I73AH5T2836UuXRqN7Qg+IIUw/+YJksRw==
   dependencies:
     hasown "^2.0.0"
 
-es-to-primitive@^1.2.1:
-  version "1.2.1"
-  resolved "https://registry.yarnpkg.com/es-to-primitive/-/es-to-primitive-1.2.1.tgz#e55cd4c9cdc188bcefb03b366c736323fc5c898a"
-  integrity sha512-QCOllgZJtaUo9miYBcLChTUaHNjJF3PYs1VidD7AwiEj1kYxKeQTctLAezAOH5ZKRH0g2IgPn6KwB4IT8iRpvA==
+es-to-primitive@^1.2.1, es-to-primitive@^1.3.0:
+  version "1.3.0"
+  resolved "https://registry.yarnpkg.com/es-to-primitive/-/es-to-primitive-1.3.0.tgz#96c89c82cc49fd8794a24835ba3e1ff87f214e18"
+  integrity sha512-w+5mJ3GuFL+NjVtJlvydShqE1eN3h3PbI7/5LAsYJP/2qtuMXjfL2LpHSRqo4b4eSF5K/DH1JXKUAHSB2UW50g==
   dependencies:
-    is-callable "^1.1.4"
-    is-date-object "^1.0.1"
-    is-symbol "^1.0.2"
+    is-callable "^1.2.7"
+    is-date-object "^1.0.5"
+    is-symbol "^1.0.4"
 
 es6-promise@^4.0.3:
   version "4.2.8"
@@ -4681,40 +5052,45 @@ es6-promisify@^5.0.0:
     es6-promise "^4.0.3"
 
 esbuild@~0.23.0:
-  version "0.23.0"
-  resolved "https://registry.yarnpkg.com/esbuild/-/esbuild-0.23.0.tgz#de06002d48424d9fdb7eb52dbe8e95927f852599"
-  integrity sha512-1lvV17H2bMYda/WaFb2jLPeHU3zml2k4/yagNMG8Q/YtfMjCwEUZa2eXXMgZTVSL5q1n4H7sQ0X6CdJDqqeCFA==
+  version "0.23.1"
+  resolved "https://registry.yarnpkg.com/esbuild/-/esbuild-0.23.1.tgz#40fdc3f9265ec0beae6f59824ade1bd3d3d2dab8"
+  integrity sha512-VVNz/9Sa0bs5SELtn3f7qhJCDPCF5oMEl5cO9/SSinpE9hbPVvxbd572HH5AKiP7WD8INO53GgfDDhRjkylHEg==
   optionalDependencies:
-    "@esbuild/aix-ppc64" "0.23.0"
-    "@esbuild/android-arm" "0.23.0"
-    "@esbuild/android-arm64" "0.23.0"
-    "@esbuild/android-x64" "0.23.0"
-    "@esbuild/darwin-arm64" "0.23.0"
-    "@esbuild/darwin-x64" "0.23.0"
-    "@esbuild/freebsd-arm64" "0.23.0"
-    "@esbuild/freebsd-x64" "0.23.0"
-    "@esbuild/linux-arm" "0.23.0"
-    "@esbuild/linux-arm64" "0.23.0"
-    "@esbuild/linux-ia32" "0.23.0"
-    "@esbuild/linux-loong64" "0.23.0"
-    "@esbuild/linux-mips64el" "0.23.0"
-    "@esbuild/linux-ppc64" "0.23.0"
-    "@esbuild/linux-riscv64" "0.23.0"
-    "@esbuild/linux-s390x" "0.23.0"
-    "@esbuild/linux-x64" "0.23.0"
-    "@esbuild/netbsd-x64" "0.23.0"
-    "@esbuild/openbsd-arm64" "0.23.0"
-    "@esbuild/openbsd-x64" "0.23.0"
-    "@esbuild/sunos-x64" "0.23.0"
-    "@esbuild/win32-arm64" "0.23.0"
-    "@esbuild/win32-ia32" "0.23.0"
-    "@esbuild/win32-x64" "0.23.0"
+    "@esbuild/aix-ppc64" "0.23.1"
+    "@esbuild/android-arm" "0.23.1"
+    "@esbuild/android-arm64" "0.23.1"
+    "@esbuild/android-x64" "0.23.1"
+    "@esbuild/darwin-arm64" "0.23.1"
+    "@esbuild/darwin-x64" "0.23.1"
+    "@esbuild/freebsd-arm64" "0.23.1"
+    "@esbuild/freebsd-x64" "0.23.1"
+    "@esbuild/linux-arm" "0.23.1"
+    "@esbuild/linux-arm64" "0.23.1"
+    "@esbuild/linux-ia32" "0.23.1"
+    "@esbuild/linux-loong64" "0.23.1"
+    "@esbuild/linux-mips64el" "0.23.1"
+    "@esbuild/linux-ppc64" "0.23.1"
+    "@esbuild/linux-riscv64" "0.23.1"
+    "@esbuild/linux-s390x" "0.23.1"
+    "@esbuild/linux-x64" "0.23.1"
+    "@esbuild/netbsd-x64" "0.23.1"
+    "@esbuild/openbsd-arm64" "0.23.1"
+    "@esbuild/openbsd-x64" "0.23.1"
+    "@esbuild/sunos-x64" "0.23.1"
+    "@esbuild/win32-arm64" "0.23.1"
+    "@esbuild/win32-ia32" "0.23.1"
+    "@esbuild/win32-x64" "0.23.1"
 
 escalade@^3.1.1:
   version "3.1.1"
   resolved "https://registry.yarnpkg.com/escalade/-/escalade-3.1.1.tgz#d8cfdc7000965c5a0174b4a82eaa5c0552742e40"
   integrity sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw==
 
+escalade@^3.2.0:
+  version "3.2.0"
+  resolved "https://registry.yarnpkg.com/escalade/-/escalade-3.2.0.tgz#011a3f69856ba189dffa7dc8fcce99d2a87903e5"
+  integrity sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==
+
 escape-string-regexp@5.0.0:
   version "5.0.0"
   resolved "https://registry.yarnpkg.com/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz#4683126b500b61762f2dbebace1806e8be31b1c8"
@@ -4723,7 +5099,7 @@ escape-string-regexp@5.0.0:
 escape-string-regexp@^1.0.5:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz#1b61c0562190a8dff6ae3bb2cf0200ca130b86d4"
-  integrity sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=
+  integrity sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==
 
 escape-string-regexp@^2.0.0:
   version "2.0.0"
@@ -4761,34 +5137,36 @@ eslint-import-resolver-node@^0.3.9:
     is-core-module "^2.13.0"
     resolve "^1.22.4"
 
-eslint-module-utils@^2.8.0:
-  version "2.8.1"
-  resolved "https://registry.yarnpkg.com/eslint-module-utils/-/eslint-module-utils-2.8.1.tgz#52f2404300c3bd33deece9d7372fb337cc1d7c34"
-  integrity sha512-rXDXR3h7cs7dy9RNpUlQf80nX31XWJEyGq1tRMo+6GsO5VmTe4UTwtmonAD4ZkAsrfMVDA2wlGJ3790Ys+D49Q==
+eslint-module-utils@^2.12.0:
+  version "2.12.0"
+  resolved "https://registry.yarnpkg.com/eslint-module-utils/-/eslint-module-utils-2.12.0.tgz#fe4cfb948d61f49203d7b08871982b65b9af0b0b"
+  integrity sha512-wALZ0HFoytlyh/1+4wuZ9FJCD/leWHQzzrxJ8+rebyReSLk7LApMyd3WJaLVoN+D5+WIdJyDK1c6JnE65V4Zyg==
   dependencies:
     debug "^3.2.7"
 
-eslint-plugin-import@^2.29.1:
-  version "2.29.1"
-  resolved "https://registry.yarnpkg.com/eslint-plugin-import/-/eslint-plugin-import-2.29.1.tgz#d45b37b5ef5901d639c15270d74d46d161150643"
-  integrity sha512-BbPC0cuExzhiMo4Ff1BTVwHpjjv28C5R+btTOGaCRC7UEz801up0JadwkeSk5Ued6TG34uaczuVuH6qyy5YUxw==
+eslint-plugin-import@^2.31.0:
+  version "2.31.0"
+  resolved "https://registry.yarnpkg.com/eslint-plugin-import/-/eslint-plugin-import-2.31.0.tgz#310ce7e720ca1d9c0bb3f69adfd1c6bdd7d9e0e7"
+  integrity sha512-ixmkI62Rbc2/w8Vfxyh1jQRTdRTF52VxwRVHl/ykPAmqG+Nb7/kNn+byLP0LxPgI7zWA16Jt82SybJInmMia3A==
   dependencies:
-    array-includes "^3.1.7"
-    array.prototype.findlastindex "^1.2.3"
+    "@rtsao/scc" "^1.1.0"
+    array-includes "^3.1.8"
+    array.prototype.findlastindex "^1.2.5"
     array.prototype.flat "^1.3.2"
     array.prototype.flatmap "^1.3.2"
     debug "^3.2.7"
     doctrine "^2.1.0"
     eslint-import-resolver-node "^0.3.9"
-    eslint-module-utils "^2.8.0"
-    hasown "^2.0.0"
-    is-core-module "^2.13.1"
+    eslint-module-utils "^2.12.0"
+    hasown "^2.0.2"
+    is-core-module "^2.15.1"
     is-glob "^4.0.3"
     minimatch "^3.1.2"
-    object.fromentries "^2.0.7"
-    object.groupby "^1.0.1"
-    object.values "^1.1.7"
+    object.fromentries "^2.0.8"
+    object.groupby "^1.0.3"
+    object.values "^1.2.0"
     semver "^6.3.1"
+    string.prototype.trimend "^1.0.8"
     tsconfig-paths "^3.15.0"
 
 eslint-scope@^7.2.2:
@@ -4994,7 +5372,7 @@ expand-brackets@^2.1.4:
     snapdragon "^0.8.1"
     to-regex "^3.0.1"
 
-expect@^29.0.0:
+expect@^29.0.0, expect@^29.7.0:
   version "29.7.0"
   resolved "https://registry.yarnpkg.com/expect/-/expect-29.7.0.tgz#578874590dcb3214514084c08115d8aee61e11bc"
   integrity sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==
@@ -5005,17 +5383,6 @@ expect@^29.0.0:
     jest-message-util "^29.7.0"
     jest-util "^29.7.0"
 
-expect@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/expect/-/expect-29.4.1.tgz#58cfeea9cbf479b64ed081fd1e074ac8beb5a1fe"
-  integrity sha512-OKrGESHOaMxK3b6zxIq9SOW8kEXztKff/Dvg88j4xIJxur1hspEbedVkR3GpHe5LO+WB2Qw7OWN0RMTdp6as5A==
-  dependencies:
-    "@jest/expect-utils" "^29.4.1"
-    jest-get-type "^29.2.0"
-    jest-matcher-utils "^29.4.1"
-    jest-message-util "^29.4.1"
-    jest-util "^29.4.1"
-
 extend-shallow@^2.0.1:
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/extend-shallow/-/extend-shallow-2.0.1.tgz#51af7d614ad9a9f610ea1bafbb989d6b1c56890f"
@@ -5074,6 +5441,11 @@ fast-deep-equal@^3.1.1, fast-deep-equal@^3.1.3:
   resolved "https://registry.yarnpkg.com/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz#3a7d56b559d6cbc3eb512325244e619a65c6c525"
   integrity sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==
 
+fast-equals@^5.2.2:
+  version "5.2.2"
+  resolved "https://registry.yarnpkg.com/fast-equals/-/fast-equals-5.2.2.tgz#885d7bfb079fac0ce0e8450374bce29e9b742484"
+  integrity sha512-V7/RktU11J3I36Nwq2JnZEM7tNm17eBJz+u25qdxBZeCKiX6BkVSZQjwWIr+IobgnZy+ag73tTZgZi7tr0LrBw==
+
 fast-glob@^2.2.6:
   version "2.2.7"
   resolved "https://registry.yarnpkg.com/fast-glob/-/fast-glob-2.2.7.tgz#6953857c3afa475fff92ee6015d52da70a4cd39d"
@@ -5086,10 +5458,10 @@ fast-glob@^2.2.6:
     merge2 "^1.2.3"
     micromatch "^3.1.10"
 
-fast-glob@^3.2.11:
-  version "3.2.12"
-  resolved "https://registry.yarnpkg.com/fast-glob/-/fast-glob-3.2.12.tgz#7f39ec99c2e6ab030337142da9e0c18f37afae80"
-  integrity sha512-DVj4CQIYYow0BlaelwK1pHl5n5cRSJfM60UA0zK891sVInoPri2Ekj7+e1CT3/3qxXenpI+nBBmQAcJPJgaj4w==
+fast-glob@^3.2.9:
+  version "3.3.2"
+  resolved "https://registry.yarnpkg.com/fast-glob/-/fast-glob-3.3.2.tgz#a904501e57cfdd2ffcded45e99a54fef55e46129"
+  integrity sha512-oX2ruAFQwf/Orj8m737Y5adxDQO0LAB7/S5MnxCdTNDd4p6BsyIVsv9JQsATbTSq8KHRpLwIHbVlUNatxd+1Ow==
   dependencies:
     "@nodelib/fs.stat" "^2.0.2"
     "@nodelib/fs.walk" "^1.2.3"
@@ -5097,16 +5469,16 @@ fast-glob@^3.2.11:
     merge2 "^1.3.0"
     micromatch "^4.0.4"
 
-fast-glob@^3.2.9:
-  version "3.3.2"
-  resolved "https://registry.yarnpkg.com/fast-glob/-/fast-glob-3.3.2.tgz#a904501e57cfdd2ffcded45e99a54fef55e46129"
-  integrity sha512-oX2ruAFQwf/Orj8m737Y5adxDQO0LAB7/S5MnxCdTNDd4p6BsyIVsv9JQsATbTSq8KHRpLwIHbVlUNatxd+1Ow==
+fast-glob@^3.3.0:
+  version "3.3.3"
+  resolved "https://registry.yarnpkg.com/fast-glob/-/fast-glob-3.3.3.tgz#d06d585ce8dba90a16b0505c543c3ccfb3aeb818"
+  integrity sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==
   dependencies:
     "@nodelib/fs.stat" "^2.0.2"
     "@nodelib/fs.walk" "^1.2.3"
     glob-parent "^5.1.2"
     merge2 "^1.3.0"
-    micromatch "^4.0.4"
+    micromatch "^4.0.8"
 
 fast-json-stable-stringify@^2.0.0, fast-json-stable-stringify@^2.1.0:
   version "2.1.0"
@@ -5132,6 +5504,11 @@ fb-watchman@^2.0.0:
   dependencies:
     bser "2.1.1"
 
+fdir@^6.4.2:
+  version "6.4.3"
+  resolved "https://registry.yarnpkg.com/fdir/-/fdir-6.4.3.tgz#011cdacf837eca9b811c89dbb902df714273db72"
+  integrity sha512-PMXmW2y1hDDfTSRc9gaXIuCCRpuoz3Kaz8cUelp3smouvfT632ozg2vrT6lJsHKKOF59YLbOGfAWGUcKEfRMQw==
+
 figgy-pudding@^3.4.1, figgy-pudding@^3.5.1:
   version "3.5.2"
   resolved "https://registry.yarnpkg.com/figgy-pudding/-/figgy-pudding-3.5.2.tgz#b4eee8148abb01dcf1d1ac34367d59e12fa61d6e"
@@ -5151,6 +5528,13 @@ file-entry-cache@^6.0.1:
   dependencies:
     flat-cache "^3.0.4"
 
+file-entry-cache@^9.1.0:
+  version "9.1.0"
+  resolved "https://registry.yarnpkg.com/file-entry-cache/-/file-entry-cache-9.1.0.tgz#2e66ad98ce93f49aed1b178c57b0b5741591e075"
+  integrity sha512-/pqPFG+FdxWQj+/WSuzXSDaNzxgTLr/OrR1QuqfEZzDakpdYE70PwUxL7BPUa8hpjbvY1+qvCl8k+8Tq34xJgg==
+  dependencies:
+    flat-cache "^5.0.0"
+
 file-uri-to-path@1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz#553a7b8446ff6f684359c445f1e37a05dacc33dd"
@@ -5173,6 +5557,11 @@ fill-range@^7.0.1, fill-range@^7.1.1:
   dependencies:
     to-regex-range "^5.0.1"
 
+find-up-simple@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/find-up-simple/-/find-up-simple-1.0.0.tgz#21d035fde9fdbd56c8f4d2f63f32fd93a1cfc368"
+  integrity sha512-q7Us7kcjj2VMePAa02hDAF6d+MzsdsAWEwYyOpwUtlerRBkOEPBCRZrAV4XfcSN8fHAgaD0hP7miwoay6DCprw==
+
 find-up@^1.0.0:
   version "1.1.2"
   resolved "https://registry.yarnpkg.com/find-up/-/find-up-1.1.2.tgz#6b2e9822b1a2ce0a60ab64d610eccad53cb24d0f"
@@ -5220,11 +5609,24 @@ flat-cache@^3.0.4:
     keyv "^4.5.3"
     rimraf "^3.0.2"
 
+flat-cache@^5.0.0:
+  version "5.0.0"
+  resolved "https://registry.yarnpkg.com/flat-cache/-/flat-cache-5.0.0.tgz#26c4da7b0f288b408bb2b506b2cb66c240ddf062"
+  integrity sha512-JrqFmyUl2PnPi1OvLyTVHnQvwQ0S+e6lGSwu8OkAZlSaNIZciTY2H/cOOROxsBA1m/LZNHDsqAgDZt6akWcjsQ==
+  dependencies:
+    flatted "^3.3.1"
+    keyv "^4.5.4"
+
 flatted@^3.2.9:
   version "3.3.1"
   resolved "https://registry.yarnpkg.com/flatted/-/flatted-3.3.1.tgz#21db470729a6734d4997002f439cb308987f567a"
   integrity sha512-X8cqMLLie7KsNUDSdzeN8FYK9rEt4Dt67OsG/DNGnYTSDBG4uFAJFBnUeiV+zCVAvwFy56IjM9sH51jVaEhNxw==
 
+flatted@^3.3.1:
+  version "3.3.2"
+  resolved "https://registry.yarnpkg.com/flatted/-/flatted-3.3.2.tgz#adba1448a9841bec72b42c532ea23dbbedef1a27"
+  integrity sha512-AiwGJM8YcNOaobumgtng+6NHuOqC3A7MixFeDafM3X9cIUM+xUXoS5Vfgf+OihAYe20fxqNM9yPBXJzRtZ/4eA==
+
 flush-write-stream@^1.0.0:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/flush-write-stream/-/flush-write-stream-1.1.1.tgz#8dd7d873a1babc207d94ead0c2e0e44276ebf2e8"
@@ -5293,16 +5695,6 @@ fs-extra@^8.1.0:
     jsonfile "^4.0.0"
     universalify "^0.1.0"
 
-fs-extra@^9.1.0:
-  version "9.1.0"
-  resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-9.1.0.tgz#5954460c764a8da2094ba3554bf839e6b9a7c86d"
-  integrity sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==
-  dependencies:
-    at-least-node "^1.0.0"
-    graceful-fs "^4.2.0"
-    jsonfile "^6.0.1"
-    universalify "^2.0.0"
-
 fs-minipass@^1.2.5:
   version "1.2.7"
   resolved "https://registry.yarnpkg.com/fs-minipass/-/fs-minipass-1.2.7.tgz#ccff8570841e7fe4265693da88936c55aed7f7c7"
@@ -5340,15 +5732,17 @@ function-bind@^1.1.1, function-bind@^1.1.2:
   resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.2.tgz#2c02d864d97f3ea6c8830c464cbd11ab6eab7a1c"
   integrity sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==
 
-function.prototype.name@^1.1.6:
-  version "1.1.6"
-  resolved "https://registry.yarnpkg.com/function.prototype.name/-/function.prototype.name-1.1.6.tgz#cdf315b7d90ee77a4c6ee216c3c3362da07533fd"
-  integrity sha512-Z5kx79swU5P27WEayXM1tBi5Ze/lbIyiNgU3qyXUOf9b2rgXYyF9Dy9Cx+IQv/Lc8WCG6L82zwUPpSS9hGehIg==
+function.prototype.name@^1.1.6, function.prototype.name@^1.1.8:
+  version "1.1.8"
+  resolved "https://registry.yarnpkg.com/function.prototype.name/-/function.prototype.name-1.1.8.tgz#e68e1df7b259a5c949eeef95cdbde53edffabb78"
+  integrity sha512-e5iwyodOHhbMr/yNrc7fDYG4qlbIvI5gajyzPnb5TCwyhjApznQh1BMFou9b30SevY43gCJKXycoCBjMbsuW0Q==
   dependencies:
-    call-bind "^1.0.2"
-    define-properties "^1.2.0"
-    es-abstract "^1.22.1"
+    call-bind "^1.0.8"
+    call-bound "^1.0.3"
+    define-properties "^1.2.1"
     functions-have-names "^1.2.3"
+    hasown "^2.0.2"
+    is-callable "^1.2.7"
 
 functions-have-names@^1.2.3:
   version "1.2.3"
@@ -5374,10 +5768,10 @@ genfun@^5.0.0:
   resolved "https://registry.yarnpkg.com/genfun/-/genfun-5.0.0.tgz#9dd9710a06900a5c4a5bf57aca5da4e52fe76537"
   integrity sha512-KGDOARWVga7+rnB3z9Sd2Letx515owfk0hSxHGuqjANb1M+x2bGZGqHLiozPsYMdM2OubeMni/Hpwmjq6qIUhA==
 
-gensequence@^3.1.1:
-  version "3.1.1"
-  resolved "https://registry.yarnpkg.com/gensequence/-/gensequence-3.1.1.tgz#95c1afc7c0680f92942c17f2d6f83f3d26ea97af"
-  integrity sha512-ys3h0hiteRwmY6BsvSttPmkhC0vEQHPJduANBRtH/dlDPZ0UBIb/dXy80IcckXyuQ6LKg+PloRqvGER9IS7F7g==
+gensequence@^7.0.0:
+  version "7.0.0"
+  resolved "https://registry.yarnpkg.com/gensequence/-/gensequence-7.0.0.tgz#bb6aedec8ff665e3a6c42f92823121e3a6ea7718"
+  integrity sha512-47Frx13aZh01afHJTB3zTtKIlFI6vWY+MYCN9Qpew6i52rfKjnhCF/l1YlC8UmEMvvntZZ6z4PiCcmyuedR2aQ==
 
 gensync@^1.0.0-beta.1:
   version "1.0.0-beta.1"
@@ -5394,16 +5788,21 @@ get-caller-file@^2.0.1, get-caller-file@^2.0.5:
   resolved "https://registry.yarnpkg.com/get-caller-file/-/get-caller-file-2.0.5.tgz#4f94412a82db32f36e3b0b9741f8a97feb031f7e"
   integrity sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==
 
-get-intrinsic@^1.1.3, get-intrinsic@^1.2.1, get-intrinsic@^1.2.3, get-intrinsic@^1.2.4:
-  version "1.2.4"
-  resolved "https://registry.yarnpkg.com/get-intrinsic/-/get-intrinsic-1.2.4.tgz#e385f5a4b5227d449c3eabbad05494ef0abbeadd"
-  integrity sha512-5uYhsJH8VJBTv7oslg4BznJYhDoRI6waYCxMmCdnTrcCrHA/fCFKoTFz2JKKE0HdDFUF7/oQuhzumXJK7paBRQ==
+get-intrinsic@^1.2.4, get-intrinsic@^1.2.5, get-intrinsic@^1.2.6, get-intrinsic@^1.2.7:
+  version "1.2.7"
+  resolved "https://registry.yarnpkg.com/get-intrinsic/-/get-intrinsic-1.2.7.tgz#dcfcb33d3272e15f445d15124bc0a216189b9044"
+  integrity sha512-VW6Pxhsrk0KAOqs3WEd0klDiF/+V7gQOpAvY1jVU/LHmaD/kQO4523aiJuikX/QAKYiW6x8Jh+RJej1almdtCA==
   dependencies:
+    call-bind-apply-helpers "^1.0.1"
+    es-define-property "^1.0.1"
     es-errors "^1.3.0"
+    es-object-atoms "^1.0.0"
     function-bind "^1.1.2"
-    has-proto "^1.0.1"
-    has-symbols "^1.0.3"
-    hasown "^2.0.0"
+    get-proto "^1.0.0"
+    gopd "^1.2.0"
+    has-symbols "^1.1.0"
+    hasown "^2.0.2"
+    math-intrinsics "^1.1.0"
 
 get-package-type@^0.1.0:
   version "0.1.0"
@@ -5426,15 +5825,23 @@ get-port@^4.2.0:
   resolved "https://registry.yarnpkg.com/get-port/-/get-port-4.2.0.tgz#e37368b1e863b7629c43c5a323625f95cf24b119"
   integrity sha512-/b3jarXkH8KJoOMQc3uVGHASwGLPq3gSFJ7tgJm2diza+bydJPTGOibin2steecKeOylE8oY2JERlVWkAJO6yw==
 
+get-proto@^1.0.0, get-proto@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/get-proto/-/get-proto-1.0.1.tgz#150b3f2743869ef3e851ec0c49d15b1d14d00ee1"
+  integrity sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==
+  dependencies:
+    dunder-proto "^1.0.1"
+    es-object-atoms "^1.0.0"
+
 get-stdin@^4.0.1:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/get-stdin/-/get-stdin-4.0.1.tgz#b968c6b0a04384324902e8bf1a5df32579a450fe"
   integrity sha1-uWjGsKBDhDJJAui/Gl3zJXmkUP4=
 
-get-stdin@^8.0.0:
-  version "8.0.0"
-  resolved "https://registry.yarnpkg.com/get-stdin/-/get-stdin-8.0.0.tgz#cbad6a73feb75f6eeb22ba9e01f89aa28aa97a53"
-  integrity sha512-sY22aA6xchAzprjyqmSEQv4UbAAzRN0L2dQB0NlN5acTTK9Don6nhoc3eAbUnpZiCANAMfd/+40kVdKfFygohg==
+get-stdin@^9.0.0:
+  version "9.0.0"
+  resolved "https://registry.yarnpkg.com/get-stdin/-/get-stdin-9.0.0.tgz#3983ff82e03d56f1b2ea0d3e60325f39d703a575"
+  integrity sha512-dVKBjfWisLAicarI2Sf+JuBE/DghV4UzNAVe9yhEJuzeREd3JhOTE9cUaJTeSa77fsbQUK3pcOpJfM59+VKZaA==
 
 get-stream@^4.0.0, get-stream@^4.1.0:
   version "4.1.0"
@@ -5448,19 +5855,19 @@ get-stream@^6.0.0:
   resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-6.0.1.tgz#a262d8eef67aced57c2852ad6167526a43cbf7b7"
   integrity sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==
 
-get-symbol-description@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/get-symbol-description/-/get-symbol-description-1.0.2.tgz#533744d5aa20aca4e079c8e5daf7fd44202821f5"
-  integrity sha512-g0QYk1dZBxGwk+Ngc+ltRH2IBp2f7zBkBMBJZCDerh6EhlhSR6+9irMCuT/09zD6qkarHUSn529sK/yL4S27mg==
+get-symbol-description@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/get-symbol-description/-/get-symbol-description-1.1.0.tgz#7bdd54e0befe8ffc9f3b4e203220d9f1e881b6ee"
+  integrity sha512-w9UMqWwJxHNOvoNzSJ2oPF5wvYcvP7jUvYzhp67yEhTi17ZDBBC1z9pTdGuzjD+EFIqLSYRweZjqfiPzQ06Ebg==
   dependencies:
-    call-bind "^1.0.5"
+    call-bound "^1.0.3"
     es-errors "^1.3.0"
-    get-intrinsic "^1.2.4"
+    get-intrinsic "^1.2.6"
 
 get-tsconfig@^4.7.5:
-  version "4.7.6"
-  resolved "https://registry.yarnpkg.com/get-tsconfig/-/get-tsconfig-4.7.6.tgz#118fd5b7b9bae234cc7705a00cd771d7eb65d62a"
-  integrity sha512-ZAqrLlu18NbDdRaHq+AKXzAmqIUPswPWKUchfytdAjiRFnCe5ojG2bstg6mRiZabkKfCoL/e98pbBELIV/YCeA==
+  version "4.10.0"
+  resolved "https://registry.yarnpkg.com/get-tsconfig/-/get-tsconfig-4.10.0.tgz#403a682b373a823612475a4c2928c7326fc0f6bb"
+  integrity sha512-kGzZ3LWWQcGIAmg6iWvXn0ei6WDtV26wzHRMwDSzmAbcXrTEXxHy6IehI6/4eT6VRKyMP1eF1VqwrVUmE/LR7A==
   dependencies:
     resolve-pkg-maps "^1.0.0"
 
@@ -5583,12 +5990,12 @@ glob@^7.1.3:
     once "^1.3.0"
     path-is-absolute "^1.0.0"
 
-global-dirs@^0.1.1:
-  version "0.1.1"
-  resolved "https://registry.yarnpkg.com/global-dirs/-/global-dirs-0.1.1.tgz#b319c0dd4607f353f3be9cca4c72fc148c49f445"
-  integrity sha1-sxnA3UYH81PzvpzKTHL8FIxJ9EU=
+global-directory@^4.0.1:
+  version "4.0.1"
+  resolved "https://registry.yarnpkg.com/global-directory/-/global-directory-4.0.1.tgz#4d7ac7cfd2cb73f304c53b8810891748df5e361e"
+  integrity sha512-wHTUcDUoZ1H5/0iVqEudYW4/kAlN5cZ3j/bXn0Dpbizl9iaUVeWSHqiOjsgk6OW2bkLclbBjzewBz6weQ1zA2Q==
   dependencies:
-    ini "^1.3.4"
+    ini "4.1.1"
 
 globals@^11.1.0:
   version "11.12.0"
@@ -5602,7 +6009,7 @@ globals@^13.19.0:
   dependencies:
     type-fest "^0.20.2"
 
-globalthis@^1.0.3:
+globalthis@^1.0.4:
   version "1.0.4"
   resolved "https://registry.yarnpkg.com/globalthis/-/globalthis-1.0.4.tgz#7430ed3a975d97bfb59bcce41f5cabbafa651236"
   integrity sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==
@@ -5622,14 +6029,14 @@ globby@^11.1.0:
     merge2 "^1.4.1"
     slash "^3.0.0"
 
-globby@^13.1.1:
-  version "13.1.3"
-  resolved "https://registry.yarnpkg.com/globby/-/globby-13.1.3.tgz#f62baf5720bcb2c1330c8d4ef222ee12318563ff"
-  integrity sha512-8krCNHXvlCgHDpegPzleMq07yMYTO2sXKASmZmquEYWEmCx6J5UTRbp5RwMJkTJGtcQ44YpiUYUiN0b9mzy8Bw==
+globby@^13.1.4:
+  version "13.2.2"
+  resolved "https://registry.yarnpkg.com/globby/-/globby-13.2.2.tgz#63b90b1bf68619c2135475cbd4e71e66aa090592"
+  integrity sha512-Y1zNGV+pzQdh7H39l9zgB4PJqjRNqydvdYCDG4HFXM4XuvSaQQlEc91IU1yALL8gUTDomgBAfz3XJdmUS+oo0w==
   dependencies:
     dir-glob "^3.0.1"
-    fast-glob "^3.2.11"
-    ignore "^5.2.0"
+    fast-glob "^3.3.0"
+    ignore "^5.2.4"
     merge2 "^1.4.1"
     slash "^4.0.0"
 
@@ -5647,28 +6054,26 @@ globby@^9.2.0:
     pify "^4.0.1"
     slash "^2.0.0"
 
-gopd@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/gopd/-/gopd-1.0.1.tgz#29ff76de69dac7489b7c0918a5788e56477c332c"
-  integrity sha512-d65bNlIadxvpb/A2abVdlqKqV563juRnZ1Wtk6s1sIR8uNsXR70xqIzVqxVf1eTqDunwT2MkczEeaezCKTZhwA==
-  dependencies:
-    get-intrinsic "^1.1.3"
+gopd@^1.0.1, gopd@^1.2.0:
+  version "1.2.0"
+  resolved "https://registry.yarnpkg.com/gopd/-/gopd-1.2.0.tgz#89f56b8217bdbc8802bd299df6d7f1081d7e51a1"
+  integrity sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==
 
 graceful-fs@^4.1.11, graceful-fs@^4.1.15, graceful-fs@^4.1.2, graceful-fs@^4.1.6, graceful-fs@^4.2.0, graceful-fs@^4.2.2:
   version "4.2.4"
   resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.4.tgz#2256bde14d3632958c465ebc96dc467ca07a29fb"
   integrity sha512-WjKPNJF79dtJAVniUlGGWHYGz2jWxT6VhN/4m1NdkbZ2nOsEF+cI1Edgql5zCRhs/VsQYRvrXctxktVXZUkixw==
 
+graceful-fs@^4.2.10, graceful-fs@^4.2.9:
+  version "4.2.11"
+  resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.11.tgz#4183e4e8bf08bb6e05bbb2f7d2e0c8f712ca40e3"
+  integrity sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==
+
 graceful-fs@^4.2.4:
   version "4.2.10"
   resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.10.tgz#147d3a006da4ca3ce14728c7aefc287c367d7a6c"
   integrity sha512-9ByhssR2fPVsNZj478qUUbKfmL0+t5BDVyjShtyZZLiK7ZDAArFFfopyOTj0M05wE2tJPisA4iTnnXl2YoPvOA==
 
-graceful-fs@^4.2.9:
-  version "4.2.11"
-  resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.11.tgz#4183e4e8bf08bb6e05bbb2f7d2e0c8f712ca40e3"
-  integrity sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==
-
 graphemer@^1.4.0:
   version "1.4.0"
   resolved "https://registry.yarnpkg.com/graphemer/-/graphemer-1.4.0.tgz#fb2f1d55e0e3a1849aeffc90c4fa0dd53a0e66c6"
@@ -5709,10 +6114,10 @@ hard-rejection@^2.1.0:
   resolved "https://registry.yarnpkg.com/hard-rejection/-/hard-rejection-2.1.0.tgz#1c6eda5c1685c63942766d79bb40ae773cecd883"
   integrity sha512-VIZB+ibDhx7ObhAe7OVtoEbuP4h/MuOTHJ+J8h/eBXotJYl0fBgR72xDFCKgIh22OJZIOVNxBMWuhAr10r8HdA==
 
-has-bigints@^1.0.1, has-bigints@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/has-bigints/-/has-bigints-1.0.2.tgz#0871bd3e3d51626f6ca0966668ba35d5602d6eaa"
-  integrity sha512-tSvCKtBr9lkF0Ex0aQiP9N+OpV4zi2r/Nee5VkRDbaqv35RLYMzbwQfFSZZH0kR+Rd6302UJZ2p/bJCEoR3VoQ==
+has-bigints@^1.0.2:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/has-bigints/-/has-bigints-1.1.0.tgz#28607e965ac967e03cd2a2c70a2636a1edad49fe"
+  integrity sha512-R3pbpkcIqv2Pm3dUwgjclDRVmWpTJW2DcMzcIhEXEx1oh/CEMObMm3KLmRJOdvhM7o4uQBnwr8pzRK2sJWIqfg==
 
 has-flag@^3.0.0:
   version "3.0.0"
@@ -5736,22 +6141,29 @@ has-property-descriptors@^1.0.0, has-property-descriptors@^1.0.2:
   dependencies:
     es-define-property "^1.0.0"
 
-has-proto@^1.0.1, has-proto@^1.0.3:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/has-proto/-/has-proto-1.0.3.tgz#b31ddfe9b0e6e9914536a6ab286426d0214f77fd"
-  integrity sha512-SJ1amZAJUiZS+PhsVLf5tGydlaVB8EdFpaSO4gmiUKUOxk8qzn5AIy4ZeJUmh22znIdk/uMAUT2pl3FxzVUH+Q==
+has-proto@^1.2.0:
+  version "1.2.0"
+  resolved "https://registry.yarnpkg.com/has-proto/-/has-proto-1.2.0.tgz#5de5a6eabd95fdffd9818b43055e8065e39fe9d5"
+  integrity sha512-KIL7eQPfHQRC8+XluaIw7BHUwwqL19bQn4hzNgdr+1wXoU0KKj6rufu47lhY7KbJR2C6T6+PfyN0Ea7wkSS+qQ==
+  dependencies:
+    dunder-proto "^1.0.0"
 
 has-symbols@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/has-symbols/-/has-symbols-1.0.1.tgz#9f5214758a44196c406d9bd76cebf81ec2dd31e8"
   integrity sha512-PLcsoqu++dmEIZB+6totNFKq/7Do+Z0u4oT0zKOJNl3lYK6vGwwu2hjHs+68OEZbTjiUE9bgOABXbP/GvrS0Kg==
 
-has-symbols@^1.0.1, has-symbols@^1.0.2, has-symbols@^1.0.3:
+has-symbols@^1.0.1:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/has-symbols/-/has-symbols-1.0.3.tgz#bb7b2c4349251dce87b125f7bdf874aa7c8b39f8"
   integrity sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==
 
-has-tostringtag@^1.0.0, has-tostringtag@^1.0.2:
+has-symbols@^1.0.3, has-symbols@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/has-symbols/-/has-symbols-1.1.0.tgz#fc9c6a783a084951d0b971fe1018de813707a338"
+  integrity sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==
+
+has-tostringtag@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/has-tostringtag/-/has-tostringtag-1.0.2.tgz#2cdc42d40bef2e5b4eeab7c01a73c54ce7ab5abc"
   integrity sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==
@@ -5816,7 +6228,7 @@ hash.js@^1.0.0, hash.js@^1.0.3:
     inherits "^2.0.3"
     minimalistic-assert "^1.0.1"
 
-hasown@^2.0.0, hasown@^2.0.1, hasown@^2.0.2:
+hasown@^2.0.0, hasown@^2.0.2:
   version "2.0.2"
   resolved "https://registry.yarnpkg.com/hasown/-/hasown-2.0.2.tgz#003eaf91be7adc372e84ec59dc37252cedb80003"
   integrity sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==
@@ -5837,13 +6249,6 @@ hosted-git-info@^2.1.4, hosted-git-info@^2.7.1:
   resolved "https://registry.yarnpkg.com/hosted-git-info/-/hosted-git-info-2.8.8.tgz#7539bd4bc1e0e0a895815a2e0262420b12858488"
   integrity sha512-f/wzC2QaWBs7t9IYqB4T3sR1xviIViXJRJTWBlx2Gf3g0Xi5vI7Yy4koXQ1c9OYDGHN9sBy1DQ2AB8fqZBWhUg==
 
-hosted-git-info@^4.0.1:
-  version "4.1.0"
-  resolved "https://registry.yarnpkg.com/hosted-git-info/-/hosted-git-info-4.1.0.tgz#827b82867e9ff1c8d0c4d9d53880397d2c86d224"
-  integrity sha512-kyCuEOWjJqZuDbRHzL8V93NzQhwIB71oFWSyzVo+KPZI+pnQPPxucdkrOZvkLRnrf5URsQM+IJ09Dw29cRALIA==
-  dependencies:
-    lru-cache "^6.0.0"
-
 html-escaper@^2.0.0:
   version "2.0.2"
   resolved "https://registry.yarnpkg.com/html-escaper/-/html-escaper-2.0.2.tgz#dfd60027da36a36dfcbe236262c00a5822681453"
@@ -5862,15 +6267,6 @@ http-proxy-agent@^2.1.0:
     agent-base "4"
     debug "3.1.0"
 
-http-proxy-agent@^4.0.0:
-  version "4.0.1"
-  resolved "https://registry.yarnpkg.com/http-proxy-agent/-/http-proxy-agent-4.0.1.tgz#8a8c8ef7f5932ccf953c296ca8291b95aa74aa3a"
-  integrity sha512-k0zdNgqWTGA6aeIRVpvfVob4fL52dTfaehylg0Y4UvSySvOq/Y+BOyPrgpUrA7HylqvU8vIZGsRuXmspskV0Tg==
-  dependencies:
-    "@tootallnate/once" "1"
-    agent-base "6"
-    debug "4"
-
 http-signature@~1.2.0:
   version "1.2.0"
   resolved "https://registry.yarnpkg.com/http-signature/-/http-signature-1.2.0.tgz#9aecd925114772f3d95b65a60abb8f7c18fbace1"
@@ -5888,14 +6284,6 @@ https-proxy-agent@^2.2.3:
     agent-base "^4.3.0"
     debug "^3.1.0"
 
-https-proxy-agent@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.yarnpkg.com/https-proxy-agent/-/https-proxy-agent-4.0.0.tgz#702b71fb5520a132a66de1f67541d9e62154d82b"
-  integrity sha512-zoDhWrkR3of1l9QAL8/scJZyLu8j/gBkcwcaQOZh7Gyh/+uJQzGVETdgT30akuwkpL8HTRfssqI3BZuV18teDg==
-  dependencies:
-    agent-base "5"
-    debug "4"
-
 human-signals@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/human-signals/-/human-signals-2.1.0.tgz#dc91fcba42e4d06e4abaed33b3e7a3c02f514ea0"
@@ -5927,7 +6315,7 @@ iferr@^0.1.5:
   resolved "https://registry.yarnpkg.com/iferr/-/iferr-0.1.5.tgz#c60eed69e6d8fdb6b3104a1fcbca1c192dc5b501"
   integrity sha1-xg7taebY/bazEEofy8ocGS3FtQE=
 
-ignore-walk@3.0.3, ignore-walk@^3.0.1:
+ignore-walk@^3.0.1:
   version "3.0.3"
   resolved "https://registry.yarnpkg.com/ignore-walk/-/ignore-walk-3.0.3.tgz#017e2447184bfeade7c238e4aefdd1e8f95b1e37"
   integrity sha512-m7o6xuOaT1aqheYHKf8W6J5pYH85ZI9w077erOzLje3JsB1gkafkAhHHY19dqjulgIZHFm32Cp5uNZgcQqdJKw==
@@ -5939,7 +6327,7 @@ ignore@^4.0.3:
   resolved "https://registry.yarnpkg.com/ignore/-/ignore-4.0.6.tgz#750e3db5862087b4737ebac8207ffd1ef27b25fc"
   integrity sha512-cyFDKrqc/YdcWFniJhzI42+AzS+gNwmUzOSFcRCQYwySuBBBy/KjuxWLZ/FHEH6Moq1NizMOBWyTcv8O4OZIMg==
 
-ignore@^5.2.0, ignore@^5.3.1:
+ignore@^5.2.0, ignore@^5.2.4, ignore@^5.3.1:
   version "5.3.2"
   resolved "https://registry.yarnpkg.com/ignore/-/ignore-5.3.2.tgz#3cd40e729f3643fd87cb04e50bf0eb722bc596f5"
   integrity sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==
@@ -5952,7 +6340,7 @@ import-fresh@^2.0.0:
     caller-path "^2.0.0"
     resolve-from "^3.0.0"
 
-import-fresh@^3.2.1:
+import-fresh@^3.2.1, import-fresh@^3.3.0:
   version "3.3.0"
   resolved "https://registry.yarnpkg.com/import-fresh/-/import-fresh-3.3.0.tgz#37162c25fcb9ebaa2e6e53d5b4d88ce17d9e0c2b"
   integrity sha512-veYYhQa+D1QBKznvhUHxb8faxlrwUnxseDAbAp457E0wLNio2bOSKnjYDhMj+YiAq61xrMGhQk9iXVk5FzgQMw==
@@ -5976,6 +6364,11 @@ import-local@^3.0.2:
     pkg-dir "^4.2.0"
     resolve-cwd "^3.0.0"
 
+import-meta-resolve@^4.1.0:
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/import-meta-resolve/-/import-meta-resolve-4.1.0.tgz#f9db8bead9fafa61adb811db77a2bf22c5399706"
+  integrity sha512-I6fiaX09Xivtk+THaMfAwnA3MVA5Big1WHF1Dfx9hFuvNIWpXnorlkzhcQf6ehrqQiiZECRt1poOAkPmer3ruw==
+
 imurmurhash@^0.1.4:
   version "0.1.4"
   resolved "https://registry.yarnpkg.com/imurmurhash/-/imurmurhash-0.1.4.tgz#9218b9b2b928a238b13dc4fb6b6d576f231453ea"
@@ -6026,6 +6419,11 @@ ini@1.3.8:
   resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.8.tgz#a29da425b48806f34767a4efce397269af28432c"
   integrity sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==
 
+ini@4.1.1:
+  version "4.1.1"
+  resolved "https://registry.yarnpkg.com/ini/-/ini-4.1.1.tgz#d95b3d843b1e906e56d6747d5447904ff50ce7a1"
+  integrity sha512-QQnnxNyfvmHFIsj7gkPcYymR8Jdw/o7mp5ZFihxn6h8Ci6fh3Dx4E1gPjpQEpIuPo9XVNY/ZUwh4BPMjGyL01g==
+
 ini@^1.3.2, ini@^1.3.4:
   version "1.3.5"
   resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.5.tgz#eee25f56db1c9ec6085e0c22778083f596abf927"
@@ -6064,14 +6462,14 @@ inquirer@^6.2.0:
     strip-ansi "^5.1.0"
     through "^2.3.6"
 
-internal-slot@^1.0.7:
-  version "1.0.7"
-  resolved "https://registry.yarnpkg.com/internal-slot/-/internal-slot-1.0.7.tgz#c06dcca3ed874249881007b0a5523b172a190802"
-  integrity sha512-NGnrKwXzSms2qUUih/ILZ5JBqNTSa1+ZmP6flaIp6KmSElgE9qdndzS3cqjrDovwFdmwsGsLdeFgB6suw+1e9g==
+internal-slot@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/internal-slot/-/internal-slot-1.1.0.tgz#1eac91762947d2f7056bc838d93e13b2e9604961"
+  integrity sha512-4gd7VpWNQNB4UKKCFFVcp1AVv+FMOgs9NKzjHKusc8jTMhd5eL1NqQqOpE0KzMds804/yHlglp3uxgluOqAPLw==
   dependencies:
     es-errors "^1.3.0"
-    hasown "^2.0.0"
-    side-channel "^1.0.4"
+    hasown "^2.0.2"
+    side-channel "^1.1.0"
 
 ip@1.1.5:
   version "1.1.5"
@@ -6097,50 +6495,61 @@ is-arguments@^1.0.4:
   resolved "https://registry.yarnpkg.com/is-arguments/-/is-arguments-1.0.4.tgz#3faf966c7cba0ff437fb31f6250082fcf0448cf3"
   integrity sha512-xPh0Rmt8NE65sNzvyUmWgI1tz3mKq74lGA0mL8LYZcoIzKOzDh6HmrYm3d18k60nHerC8A9Km8kYu87zfSFnLA==
 
-is-array-buffer@^3.0.4:
-  version "3.0.4"
-  resolved "https://registry.yarnpkg.com/is-array-buffer/-/is-array-buffer-3.0.4.tgz#7a1f92b3d61edd2bc65d24f130530ea93d7fae98"
-  integrity sha512-wcjaerHw0ydZwfhiKbXJWLDY8A7yV7KhjQOpb83hGgGfId/aQa4TOvwyzn2PuswW2gPCYEL/nEAiSVpdOj1lXw==
+is-array-buffer@^3.0.4, is-array-buffer@^3.0.5:
+  version "3.0.5"
+  resolved "https://registry.yarnpkg.com/is-array-buffer/-/is-array-buffer-3.0.5.tgz#65742e1e687bd2cc666253068fd8707fe4d44280"
+  integrity sha512-DDfANUiiG2wC1qawP66qlTugJeL5HyzMpfr8lLK+jMQirGzNod0B12cFB/9q838Ru27sBwfw78/rdoU7RERz6A==
   dependencies:
-    call-bind "^1.0.2"
-    get-intrinsic "^1.2.1"
+    call-bind "^1.0.8"
+    call-bound "^1.0.3"
+    get-intrinsic "^1.2.6"
 
 is-arrayish@^0.2.1:
   version "0.2.1"
   resolved "https://registry.yarnpkg.com/is-arrayish/-/is-arrayish-0.2.1.tgz#77c99840527aa8ecb1a8ba697b80645a7a926a9d"
   integrity sha1-d8mYQFJ6qOyxqLppe4BkWnqSap0=
 
+is-async-function@^2.0.0:
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/is-async-function/-/is-async-function-2.1.0.tgz#1d1080612c493608e93168fc4458c245074c06a6"
+  integrity sha512-GExz9MtyhlZyXYLxzlJRj5WUCE661zhDa1Yna52CN57AJsymh+DvXXjyveSioqSRdxvUrdKdvqB1b5cVKsNpWQ==
+  dependencies:
+    call-bound "^1.0.3"
+    get-proto "^1.0.1"
+    has-tostringtag "^1.0.2"
+    safe-regex-test "^1.1.0"
+
 is-bigint@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/is-bigint/-/is-bigint-1.0.0.tgz#73da8c33208d00f130e9b5e15d23eac9215601c4"
   integrity sha512-t5mGUXC/xRheCK431ylNiSkGGpBp8bHENBcENTkDT6ppwPzEVxNGZRvgvmOEfbWkFhA7D2GEuE2mmQTr78sl2g==
 
-is-bigint@^1.0.1:
-  version "1.0.4"
-  resolved "https://registry.yarnpkg.com/is-bigint/-/is-bigint-1.0.4.tgz#08147a1875bc2b32005d41ccd8291dffc6691df3"
-  integrity sha512-zB9CruMamjym81i2JZ3UMn54PKGsQzsJeo6xvN3HJJ4CAsQNB6iRutp2To77OfCNuoxspsIhzaPoO1zyCEhFOg==
+is-bigint@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/is-bigint/-/is-bigint-1.1.0.tgz#dda7a3445df57a42583db4228682eba7c4170672"
+  integrity sha512-n4ZT37wG78iz03xPRKJrHTdZbe3IicyucEtdRsV5yglwc3GyUfbAfpSeD0FJ41NbUNSt5wbhqfp1fS+BgnvDFQ==
   dependencies:
-    has-bigints "^1.0.1"
+    has-bigints "^1.0.2"
 
 is-boolean-object@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/is-boolean-object/-/is-boolean-object-1.0.1.tgz#10edc0900dd127697a92f6f9807c7617d68ac48e"
   integrity sha512-TqZuVwa/sppcrhUCAYkGBk7w0yxfQQnxq28fjkO53tnK9FQXmdwz2JS5+GjsWQ6RByES1K40nI+yDic5c9/aAQ==
 
-is-boolean-object@^1.1.0:
-  version "1.1.2"
-  resolved "https://registry.yarnpkg.com/is-boolean-object/-/is-boolean-object-1.1.2.tgz#5c6dc200246dd9321ae4b885a114bb1f75f63719"
-  integrity sha512-gDYaKHJmnj4aWxyj6YHyXVpdQawtVLHU5cb+eztPGczf6cjuTdwve5ZIEfgXqH4e57An1D1AKf8CZ3kYrQRqYA==
+is-boolean-object@^1.2.1:
+  version "1.2.1"
+  resolved "https://registry.yarnpkg.com/is-boolean-object/-/is-boolean-object-1.2.1.tgz#c20d0c654be05da4fbc23c562635c019e93daf89"
+  integrity sha512-l9qO6eFlUETHtuihLcYOaLKByJ1f+N4kthcU9YjHy3N+B3hWv0y/2Nd0mu/7lTFnRQHTrSdXF50HQ3bl5fEnng==
   dependencies:
-    call-bind "^1.0.2"
-    has-tostringtag "^1.0.0"
+    call-bound "^1.0.2"
+    has-tostringtag "^1.0.2"
 
 is-buffer@^1.1.5:
   version "1.1.6"
   resolved "https://registry.yarnpkg.com/is-buffer/-/is-buffer-1.1.6.tgz#efaa2ea9daa0d7ab2ea13a97b2b8ad51fefbe8be"
   integrity sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==
 
-is-callable@^1.1.3, is-callable@^1.1.4, is-callable@^1.2.7:
+is-callable@^1.1.3, is-callable@^1.2.7:
   version "1.2.7"
   resolved "https://registry.yarnpkg.com/is-callable/-/is-callable-1.2.7.tgz#3bc2a85ea742d9e36205dcacdd72ca1fdc51b055"
   integrity sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==
@@ -6157,14 +6566,14 @@ is-ci@^2.0.0:
   dependencies:
     ci-info "^2.0.0"
 
-is-core-module@^2.13.0, is-core-module@^2.13.1:
-  version "2.15.0"
-  resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.15.0.tgz#71c72ec5442ace7e76b306e9d48db361f22699ea"
-  integrity sha512-Dd+Lb2/zvk9SKy1TGCt1wFJFo/MWBPMX5x7KcvLajWTGuomczdQX61PvY5yK6SVACwpoexWo81IfFyoKY2QnTA==
+is-core-module@^2.13.0, is-core-module@^2.15.1, is-core-module@^2.16.0:
+  version "2.16.1"
+  resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.16.1.tgz#2a98801a849f43e2add644fbb6bc6229b19a4ef4"
+  integrity sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==
   dependencies:
     hasown "^2.0.2"
 
-is-core-module@^2.5.0, is-core-module@^2.9.0:
+is-core-module@^2.9.0:
   version "2.11.0"
   resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.11.0.tgz#ad4cb3e3863e814523c96f3f58d26cc570ff0144"
   integrity sha512-RRjxlvLDkD1YJwDbroBHMb+cukurkDWNyHx7D3oNB5x9rb5ogcksMC5wHCadcXoo67gVr/+3GFySh3134zi6rw==
@@ -6185,25 +6594,28 @@ is-data-descriptor@^1.0.0:
   dependencies:
     kind-of "^6.0.0"
 
-is-data-view@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/is-data-view/-/is-data-view-1.0.1.tgz#4b4d3a511b70f3dc26d42c03ca9ca515d847759f"
-  integrity sha512-AHkaJrsUVW6wq6JS8y3JnM/GJF/9cf+k20+iDzlSaJrinEo5+7vRiteOSwBhHRiAyQATN1AmY4hwzxJKPmYf+w==
+is-data-view@^1.0.1, is-data-view@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/is-data-view/-/is-data-view-1.0.2.tgz#bae0a41b9688986c2188dda6657e56b8f9e63b8e"
+  integrity sha512-RKtWF8pGmS87i2D6gqQu/l7EYRlVdfzemCJN/P3UOs//x1QE7mfhvzHIApBTRf7axvT6DMGwSwBXYCT0nfB9xw==
   dependencies:
+    call-bound "^1.0.2"
+    get-intrinsic "^1.2.6"
     is-typed-array "^1.1.13"
 
-is-date-object@^1.0.1:
-  version "1.0.5"
-  resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.0.5.tgz#0841d5536e724c25597bf6ea62e1bd38298df31f"
-  integrity sha512-9YQaSxsAiSwcvS33MBk3wTCVnWK+HhF8VZR2jRxehM16QcVOdHqPn4VPHmRK4lSr38n9JriurInLcP90xsYNfQ==
-  dependencies:
-    has-tostringtag "^1.0.0"
-
 is-date-object@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.0.2.tgz#bda736f2cd8fd06d32844e7743bfa7494c3bfd7e"
   integrity sha512-USlDT524woQ08aoZFzh3/Z6ch9Y/EWXEHQ/AaRN0SkKq4t2Jw2R2339tSXmwuVoY7LLlBCbOIlx2myP/L5zk0g==
 
+is-date-object@^1.0.5, is-date-object@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.1.0.tgz#ad85541996fc7aa8b2729701d27b7319f95d82f7"
+  integrity sha512-PwwhEakHVKTdRNVOw+/Gyh0+MzlCl4R6qKvkhuvLtPMggI1WAHt9sOwZxQLSGpUaDnrdyDsomoRgNnCfKNSXXg==
+  dependencies:
+    call-bound "^1.0.2"
+    has-tostringtag "^1.0.2"
+
 is-descriptor@^0.1.0:
   version "0.1.6"
   resolved "https://registry.yarnpkg.com/is-descriptor/-/is-descriptor-0.1.6.tgz#366d8240dde487ca51823b1ab9f07a10a78251ca"
@@ -6247,7 +6659,14 @@ is-extendable@^1.0.1:
 is-extglob@^2.1.0, is-extglob@^2.1.1:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/is-extglob/-/is-extglob-2.1.1.tgz#a88c02535791f02ed37c76a1b9ea9773c833f8c2"
-  integrity sha1-qIwCU1eR8C7TfHahueqXc8gz+MI=
+  integrity sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==
+
+is-finalizationregistry@^1.1.0:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/is-finalizationregistry/-/is-finalizationregistry-1.1.1.tgz#eefdcdc6c94ddd0674d9c85887bf93f944a97c90"
+  integrity sha512-1pC6N8qWJbWoPtEjgcL2xyhQOP491EQjeUo3qTKcmV8YSDDJrOepfG8pcC7h/QgnQHYSv0mJ3Z/ZWxmatVrysg==
+  dependencies:
+    call-bound "^1.0.3"
 
 is-finite@^1.0.0:
   version "1.1.0"
@@ -6276,6 +6695,16 @@ is-generator-fn@^2.0.0:
   resolved "https://registry.yarnpkg.com/is-generator-fn/-/is-generator-fn-2.1.0.tgz#7d140adc389aaf3011a8f2a2a4cfa6faadffb118"
   integrity sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==
 
+is-generator-function@^1.0.10:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/is-generator-function/-/is-generator-function-1.1.0.tgz#bf3eeda931201394f57b5dba2800f91a238309ca"
+  integrity sha512-nPUB5km40q9e8UfN/Zc24eLlzdSf9OfKByBw9CIdw4H1giPMeA0OIJvbchsCu4npfI2QcMVBsGEBHKZ7wLTWmQ==
+  dependencies:
+    call-bound "^1.0.3"
+    get-proto "^1.0.0"
+    has-tostringtag "^1.0.2"
+    safe-regex-test "^1.1.0"
+
 is-glob@^3.1.0:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/is-glob/-/is-glob-3.1.0.tgz#7ba5ae24217804ac70707b96922567486cc3e84a"
@@ -6295,27 +6724,28 @@ is-map@^2.0.1:
   resolved "https://registry.yarnpkg.com/is-map/-/is-map-2.0.1.tgz#520dafc4307bb8ebc33b813de5ce7c9400d644a1"
   integrity sha512-T/S49scO8plUiAOA2DBTBG3JHpn1yiw0kRp6dgiZ0v2/6twi5eiB0rHtHFH9ZIrvlWc6+4O+m4zg5+Z833aXgw==
 
+is-map@^2.0.3:
+  version "2.0.3"
+  resolved "https://registry.yarnpkg.com/is-map/-/is-map-2.0.3.tgz#ede96b7fe1e270b3c4465e3a465658764926d62e"
+  integrity sha512-1Qed0/Hr2m+YqxnM09CjA2d/i6YZNfF6R2oRAOj36eUdS6qIV/huPJNSEpKbupewFs+ZsJlxsjjPbc0/afW6Lw==
+
 is-negative-zero@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/is-negative-zero/-/is-negative-zero-2.0.0.tgz#9553b121b0fac28869da9ed459e20c7543788461"
   integrity sha1-lVOxIbD6wohp2p7UWeIMdUN4hGE=
 
-is-negative-zero@^2.0.3:
-  version "2.0.3"
-  resolved "https://registry.yarnpkg.com/is-negative-zero/-/is-negative-zero-2.0.3.tgz#ced903a027aca6381b777a5743069d7376a49747"
-  integrity sha512-5KoIu2Ngpyek75jXodFvnafB6DJgr3u8uuK0LEZJjrU19DrMD3EVERaR8sjz8CCGgpZvxPl9SuE1GMVPFHx1mw==
-
 is-number-object@^1.0.3:
   version "1.0.4"
   resolved "https://registry.yarnpkg.com/is-number-object/-/is-number-object-1.0.4.tgz#36ac95e741cf18b283fc1ddf5e83da798e3ec197"
   integrity sha512-zohwelOAur+5uXtk8O3GPQ1eAcu4ZX3UwxQhUlfFFMNpUd83gXgjbhJh6HmB6LUNV/ieOLQuDwJO3dWJosUeMw==
 
-is-number-object@^1.0.4:
-  version "1.0.7"
-  resolved "https://registry.yarnpkg.com/is-number-object/-/is-number-object-1.0.7.tgz#59d50ada4c45251784e9904f5246c742f07a42fc"
-  integrity sha512-k1U0IRzLMo7ZlYIfzRu23Oh6MiIFasgpb9X76eqfFZAqwH44UI4KTBvBYIZ1dSL9ZzChTB9ShHfLkR4pdW5krQ==
+is-number-object@^1.1.1:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/is-number-object/-/is-number-object-1.1.1.tgz#144b21e95a1bc148205dcc2814a9134ec41b2541"
+  integrity sha512-lZhclumE1G6VYD8VHe35wFaIif+CTy5SJIi5+3y4psDgWu4wPDoBhF8NxUOinEc7pHgiTsT6MaBb92rKhhD+Xw==
   dependencies:
-    has-tostringtag "^1.0.0"
+    call-bound "^1.0.3"
+    has-tostringtag "^1.0.2"
 
 is-number@^3.0.0:
   version "3.0.0"
@@ -6368,25 +6798,32 @@ is-regex@^1.0.5, is-regex@^1.1.0, is-regex@^1.1.1:
   dependencies:
     has-symbols "^1.0.1"
 
-is-regex@^1.1.4:
-  version "1.1.4"
-  resolved "https://registry.yarnpkg.com/is-regex/-/is-regex-1.1.4.tgz#eef5663cd59fa4c0ae339505323df6854bb15958"
-  integrity sha512-kvRdxDsxZjhzUX07ZnLydzS1TU/TJlTUHHY4YLL87e37oUA49DfkLqgy+VjFocowy29cKvcSiu+kIv728jTTVg==
+is-regex@^1.2.1:
+  version "1.2.1"
+  resolved "https://registry.yarnpkg.com/is-regex/-/is-regex-1.2.1.tgz#76d70a3ed10ef9be48eb577887d74205bf0cad22"
+  integrity sha512-MjYsKHO5O7mCsmRGxWcLWheFqN9DJ/2TmngvjKXihe6efViPqc274+Fx/4fYj/r03+ESvBdTXK0V6tA3rgez1g==
   dependencies:
-    call-bind "^1.0.2"
-    has-tostringtag "^1.0.0"
+    call-bound "^1.0.2"
+    gopd "^1.2.0"
+    has-tostringtag "^1.0.2"
+    hasown "^2.0.2"
 
 is-set@^2.0.1:
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/is-set/-/is-set-2.0.1.tgz#d1604afdab1724986d30091575f54945da7e5f43"
   integrity sha512-eJEzOtVyenDs1TMzSQ3kU3K+E0GUS9sno+F0OBT97xsgcJsF9nXMBtkT9/kut5JEpM7oL7X/0qxR17K3mcwIAA==
 
-is-shared-array-buffer@^1.0.2, is-shared-array-buffer@^1.0.3:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/is-shared-array-buffer/-/is-shared-array-buffer-1.0.3.tgz#1237f1cba059cdb62431d378dcc37d9680181688"
-  integrity sha512-nA2hv5XIhLR3uVzDDfCIknerhx8XUKnstuOERPNNIinXG7v9u+ohXF67vxm4TPTEPU6lm61ZkwP3c9PCB97rhg==
+is-set@^2.0.3:
+  version "2.0.3"
+  resolved "https://registry.yarnpkg.com/is-set/-/is-set-2.0.3.tgz#8ab209ea424608141372ded6e0cb200ef1d9d01d"
+  integrity sha512-iPAjerrse27/ygGLxw+EBR9agv9Y6uLeYVJMu+QNCoouJ1/1ri0mGrcWpfCqFZuzzx3WjtwxG098X+n4OuRkPg==
+
+is-shared-array-buffer@^1.0.4:
+  version "1.0.4"
+  resolved "https://registry.yarnpkg.com/is-shared-array-buffer/-/is-shared-array-buffer-1.0.4.tgz#9b67844bd9b7f246ba0708c3a93e34269c774f6f"
+  integrity sha512-ISWac8drv4ZGfwKl5slpHG9OwPNty4jOWPRIhBpxOoD+hqITiwuipOQ2bNthAzwA3B4fIjO4Nln74N0S9byq8A==
   dependencies:
-    call-bind "^1.0.7"
+    call-bound "^1.0.3"
 
 is-ssh@^1.3.0:
   version "1.3.2"
@@ -6410,19 +6847,22 @@ is-string@^1.0.4:
   resolved "https://registry.yarnpkg.com/is-string/-/is-string-1.0.5.tgz#40493ed198ef3ff477b8c7f92f644ec82a5cd3a6"
   integrity sha512-buY6VNRjhQMiF1qWDouloZlQbRhDPCebwxSjxMjxgemYT46YMd2NR0/H+fBhEfWX4A/w9TBJ+ol+okqJKFE6vQ==
 
-is-string@^1.0.5, is-string@^1.0.7:
-  version "1.0.7"
-  resolved "https://registry.yarnpkg.com/is-string/-/is-string-1.0.7.tgz#0dd12bf2006f255bb58f695110eff7491eebc0fd"
-  integrity sha512-tE2UXzivje6ofPW7l23cjDOMa09gb7xlAqG6jG5ej6uPV32TlWP3NKPigtaGeHNu9fohccRYvIiZMfOOnOYUtg==
+is-string@^1.0.5, is-string@^1.0.7, is-string@^1.1.1:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/is-string/-/is-string-1.1.1.tgz#92ea3f3d5c5b6e039ca8677e5ac8d07ea773cbb9"
+  integrity sha512-BtEeSsoaQjlSPBemMQIrY1MY0uM6vnS1g5fmufYOtnxLGUZM2178PKbhsk7Ffv58IX+ZtcvoGwccYsh0PglkAA==
   dependencies:
-    has-tostringtag "^1.0.0"
+    call-bound "^1.0.3"
+    has-tostringtag "^1.0.2"
 
-is-symbol@^1.0.2, is-symbol@^1.0.3:
-  version "1.0.4"
-  resolved "https://registry.yarnpkg.com/is-symbol/-/is-symbol-1.0.4.tgz#a6dac93b635b063ca6872236de88910a57af139c"
-  integrity sha512-C/CPBqKWnvdcxqIARxyOh4v1UUEOCHpgDa0WYgpKDFMszcrPcffg5uhwSgPCLD2WWxmq6isisz87tzT01tuGhg==
+is-symbol@^1.0.2, is-symbol@^1.0.4, is-symbol@^1.1.1:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/is-symbol/-/is-symbol-1.1.1.tgz#f47761279f532e2b05a7024a7506dbbedacd0634"
+  integrity sha512-9gGx6GTtCQM73BgmHQXfDmLtfjjTUDSyoxTCbp5WtoixAhfgsDirWIcVQ/IHpvI5Vgd5i/J5F7B9cN/WlVbC/w==
   dependencies:
-    has-symbols "^1.0.2"
+    call-bound "^1.0.2"
+    has-symbols "^1.1.0"
+    safe-regex-test "^1.1.0"
 
 is-text-path@^1.0.1:
   version "1.0.1"
@@ -6431,12 +6871,12 @@ is-text-path@^1.0.1:
   dependencies:
     text-extensions "^1.0.0"
 
-is-typed-array@^1.1.13:
-  version "1.1.13"
-  resolved "https://registry.yarnpkg.com/is-typed-array/-/is-typed-array-1.1.13.tgz#d6c5ca56df62334959322d7d7dd1cca50debe229"
-  integrity sha512-uZ25/bUAlUY5fR4OKT4rZQEBrzQWYV9ZJYGGsUmEJ6thodVJ1HX64ePQ6Z0qPWP+m+Uq6e9UugrE38jeYsDSMw==
+is-typed-array@^1.1.13, is-typed-array@^1.1.14, is-typed-array@^1.1.15:
+  version "1.1.15"
+  resolved "https://registry.yarnpkg.com/is-typed-array/-/is-typed-array-1.1.15.tgz#4bfb4a45b61cee83a5a46fba778e4e8d59c0ce0b"
+  integrity sha512-p3EcsicXjit7SaskXHs1hA91QxgTw46Fv6EFKKGS5DRFLD8yKnohjF3hxoju94b/OcMZoQukzpPpBE9uLVKzgQ==
   dependencies:
-    which-typed-array "^1.1.14"
+    which-typed-array "^1.1.16"
 
 is-typed-array@^1.1.3:
   version "1.1.3"
@@ -6463,18 +6903,31 @@ is-weakmap@^2.0.1:
   resolved "https://registry.yarnpkg.com/is-weakmap/-/is-weakmap-2.0.1.tgz#5008b59bdc43b698201d18f62b37b2ca243e8cf2"
   integrity sha512-NSBR4kH5oVj1Uwvv970ruUkCV7O1mzgVFO4/rev2cLRda9Tm9HrL70ZPut4rOHgY0FNrUu9BCbXA2sdQ+x0chA==
 
-is-weakref@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/is-weakref/-/is-weakref-1.0.2.tgz#9529f383a9338205e89765e0392efc2f100f06f2"
-  integrity sha512-qctsuLZmIQ0+vSSMfoVvyFe2+GSEvnmZ2ezTup1SBse9+twCCeial6EEi3Nc2KFcf6+qz2FBPnjXsk8xhKSaPQ==
+is-weakmap@^2.0.2:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/is-weakmap/-/is-weakmap-2.0.2.tgz#bf72615d649dfe5f699079c54b83e47d1ae19cfd"
+  integrity sha512-K5pXYOm9wqY1RgjpL3YTkF39tni1XajUIkawTLUo9EZEVUFga5gSQJF8nNS7ZwJQ02y+1YCNYcMh+HIf1ZqE+w==
+
+is-weakref@^1.0.2, is-weakref@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/is-weakref/-/is-weakref-1.1.0.tgz#47e3472ae95a63fa9cf25660bcf0c181c39770ef"
+  integrity sha512-SXM8Nwyys6nT5WP6pltOwKytLV7FqQ4UiibxVmW+EIosHcmCqkkjViTb5SNssDlkCiEYRP1/pdWUKVvZBmsR2Q==
   dependencies:
-    call-bind "^1.0.2"
+    call-bound "^1.0.2"
 
 is-weakset@^2.0.1:
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/is-weakset/-/is-weakset-2.0.1.tgz#e9a0af88dbd751589f5e50d80f4c98b780884f83"
   integrity sha512-pi4vhbhVHGLxohUw7PhGsueT4vRGFoXhP7+RGN0jKIv9+8PWYCQTqtADngrxOm2g46hoH0+g8uZZBzMrvVGDmw==
 
+is-weakset@^2.0.3:
+  version "2.0.4"
+  resolved "https://registry.yarnpkg.com/is-weakset/-/is-weakset-2.0.4.tgz#c9f5deb0bc1906c6d6f1027f284ddf459249daca"
+  integrity sha512-mfcwb6IzQyOKTs84CQMrOwW4gQcaTOAWJ0zzJCl2WSPDrWk/OzDaImWFH3djXhb24g4eudZfLRozAvPGw4d9hQ==
+  dependencies:
+    call-bound "^1.0.3"
+    get-intrinsic "^1.2.6"
+
 is-windows@^1.0.0, is-windows@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/is-windows/-/is-windows-1.0.2.tgz#d1850eb9791ecd18e6182ce12a30f396634bb19d"
@@ -6544,7 +6997,7 @@ istanbul-lib-instrument@^4.0.3:
     istanbul-lib-coverage "^3.0.0"
     semver "^6.3.0"
 
-istanbul-lib-instrument@^5.0.4, istanbul-lib-instrument@^5.1.0:
+istanbul-lib-instrument@^5.0.4:
   version "5.2.1"
   resolved "https://registry.yarnpkg.com/istanbul-lib-instrument/-/istanbul-lib-instrument-5.2.1.tgz#d10c8885c2125574e1c231cacadf955675e1ce3d"
   integrity sha512-pzqtp31nLv/XFOzXGuvhCb8qhjmTVo5vjVk19XE4CRlSWz0KoeJ3bw9XsA7nOp9YBf4qHjwBxkDzKcME/J29Yg==
@@ -6555,6 +7008,17 @@ istanbul-lib-instrument@^5.0.4, istanbul-lib-instrument@^5.1.0:
     istanbul-lib-coverage "^3.2.0"
     semver "^6.3.0"
 
+istanbul-lib-instrument@^6.0.0:
+  version "6.0.3"
+  resolved "https://registry.yarnpkg.com/istanbul-lib-instrument/-/istanbul-lib-instrument-6.0.3.tgz#fa15401df6c15874bcb2105f773325d78c666765"
+  integrity sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==
+  dependencies:
+    "@babel/core" "^7.23.9"
+    "@babel/parser" "^7.23.9"
+    "@istanbuljs/schema" "^0.1.3"
+    istanbul-lib-coverage "^3.2.0"
+    semver "^7.5.4"
+
 istanbul-lib-report@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/istanbul-lib-report/-/istanbul-lib-report-3.0.0.tgz#7518fe52ea44de372f460a76b5ecda9ffb73d8a6"
@@ -6589,100 +7053,86 @@ istanbul-reports@^3.1.3:
     html-escaper "^2.0.0"
     istanbul-lib-report "^3.0.0"
 
-iterable-to-stream@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/iterable-to-stream/-/iterable-to-stream-1.0.1.tgz#37e86baacf6b1a0e9233dad4eb526d0423d08bf3"
-  integrity sha512-O62gD5ADMUGtJoOoM9U6LQ7i4byPXUNoHJ6mqsmkQJcom331ZJGDApWgDESWyBMEHEJRjtHozgIiTzYo9RU4UA==
-
-jest-changed-files@^29.4.0:
-  version "29.4.0"
-  resolved "https://registry.yarnpkg.com/jest-changed-files/-/jest-changed-files-29.4.0.tgz#ac2498bcd394228f7eddcadcf928b3583bf2779d"
-  integrity sha512-rnI1oPxgFghoz32Y8eZsGJMjW54UlqT17ycQeCEktcxxwqqKdlj9afl8LNeO0Pbu+h2JQHThQP0BzS67eTRx4w==
+jest-changed-files@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-changed-files/-/jest-changed-files-29.7.0.tgz#1c06d07e77c78e1585d020424dedc10d6e17ac3a"
+  integrity sha512-fEArFiwf1BpQ+4bXSprcDc3/x4HSzL4al2tozwVpDFpsxALjLYdyiIK4e5Vz66GQJIbXJ82+35PtysofptNX2w==
   dependencies:
     execa "^5.0.0"
+    jest-util "^29.7.0"
     p-limit "^3.1.0"
 
-jest-circus@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-circus/-/jest-circus-29.4.1.tgz#ff1b63eb04c3b111cefea9489e8dbadd23ce49bd"
-  integrity sha512-v02NuL5crMNY4CGPHBEflLzl4v91NFb85a+dH9a1pUNx6Xjggrd8l9pPy4LZ1VYNRXlb+f65+7O/MSIbLir6pA==
+jest-circus@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-circus/-/jest-circus-29.7.0.tgz#b6817a45fcc835d8b16d5962d0c026473ee3668a"
+  integrity sha512-3E1nCMgipcTkCocFwM90XXQab9bS+GMsjdpmPrlelaxwD93Ad8iVEjX/vvHPdLPnFf+L40u+5+iutRdA1N9myw==
   dependencies:
-    "@jest/environment" "^29.4.1"
-    "@jest/expect" "^29.4.1"
-    "@jest/test-result" "^29.4.1"
-    "@jest/types" "^29.4.1"
+    "@jest/environment" "^29.7.0"
+    "@jest/expect" "^29.7.0"
+    "@jest/test-result" "^29.7.0"
+    "@jest/types" "^29.6.3"
     "@types/node" "*"
     chalk "^4.0.0"
     co "^4.6.0"
-    dedent "^0.7.0"
+    dedent "^1.0.0"
     is-generator-fn "^2.0.0"
-    jest-each "^29.4.1"
-    jest-matcher-utils "^29.4.1"
-    jest-message-util "^29.4.1"
-    jest-runtime "^29.4.1"
-    jest-snapshot "^29.4.1"
-    jest-util "^29.4.1"
+    jest-each "^29.7.0"
+    jest-matcher-utils "^29.7.0"
+    jest-message-util "^29.7.0"
+    jest-runtime "^29.7.0"
+    jest-snapshot "^29.7.0"
+    jest-util "^29.7.0"
     p-limit "^3.1.0"
-    pretty-format "^29.4.1"
+    pretty-format "^29.7.0"
+    pure-rand "^6.0.0"
     slash "^3.0.0"
     stack-utils "^2.0.3"
 
-jest-cli@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-cli/-/jest-cli-29.4.1.tgz#7abef96944f300feb9b76f68b1eb2d68774fe553"
-  integrity sha512-jz7GDIhtxQ37M+9dlbv5K+/FVcIo1O/b1sX3cJgzlQUf/3VG25nvuWzlDC4F1FLLzUThJeWLu8I7JF9eWpuURQ==
+jest-cli@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-cli/-/jest-cli-29.7.0.tgz#5592c940798e0cae677eec169264f2d839a37995"
+  integrity sha512-OVVobw2IubN/GSYsxETi+gOe7Ka59EFMR/twOU3Jb2GnKKeMGJB5SGUUrEz3SFVmJASUdZUzy83sLNNQ2gZslg==
   dependencies:
-    "@jest/core" "^29.4.1"
-    "@jest/test-result" "^29.4.1"
-    "@jest/types" "^29.4.1"
+    "@jest/core" "^29.7.0"
+    "@jest/test-result" "^29.7.0"
+    "@jest/types" "^29.6.3"
     chalk "^4.0.0"
+    create-jest "^29.7.0"
     exit "^0.1.2"
-    graceful-fs "^4.2.9"
     import-local "^3.0.2"
-    jest-config "^29.4.1"
-    jest-util "^29.4.1"
-    jest-validate "^29.4.1"
-    prompts "^2.0.1"
+    jest-config "^29.7.0"
+    jest-util "^29.7.0"
+    jest-validate "^29.7.0"
     yargs "^17.3.1"
 
-jest-config@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-config/-/jest-config-29.4.1.tgz#e62670c6c980ec21d75941806ec4d0c0c6402728"
-  integrity sha512-g7p3q4NuXiM4hrS4XFATTkd+2z0Ml2RhFmFPM8c3WyKwVDNszbl4E7cV7WIx1YZeqqCtqbtTtZhGZWJlJqngzg==
+jest-config@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-config/-/jest-config-29.7.0.tgz#bcbda8806dbcc01b1e316a46bb74085a84b0245f"
+  integrity sha512-uXbpfeQ7R6TZBqI3/TxCU4q4ttk3u0PJeC+E0zbfSoSjq6bJ7buBPxzQPL0ifrkY4DNu4JUdk0ImlBUYi840eQ==
   dependencies:
     "@babel/core" "^7.11.6"
-    "@jest/test-sequencer" "^29.4.1"
-    "@jest/types" "^29.4.1"
-    babel-jest "^29.4.1"
+    "@jest/test-sequencer" "^29.7.0"
+    "@jest/types" "^29.6.3"
+    babel-jest "^29.7.0"
     chalk "^4.0.0"
     ci-info "^3.2.0"
     deepmerge "^4.2.2"
     glob "^7.1.3"
     graceful-fs "^4.2.9"
-    jest-circus "^29.4.1"
-    jest-environment-node "^29.4.1"
-    jest-get-type "^29.2.0"
-    jest-regex-util "^29.2.0"
-    jest-resolve "^29.4.1"
-    jest-runner "^29.4.1"
-    jest-util "^29.4.1"
-    jest-validate "^29.4.1"
+    jest-circus "^29.7.0"
+    jest-environment-node "^29.7.0"
+    jest-get-type "^29.6.3"
+    jest-regex-util "^29.6.3"
+    jest-resolve "^29.7.0"
+    jest-runner "^29.7.0"
+    jest-util "^29.7.0"
+    jest-validate "^29.7.0"
     micromatch "^4.0.4"
     parse-json "^5.2.0"
-    pretty-format "^29.4.1"
+    pretty-format "^29.7.0"
     slash "^3.0.0"
     strip-json-comments "^3.1.1"
 
-jest-diff@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-diff/-/jest-diff-29.4.1.tgz#9a6dc715037e1fa7a8a44554e7d272088c4029bd"
-  integrity sha512-uazdl2g331iY56CEyfbNA0Ut7Mn2ulAG5vUaEHXycf1L6IPyuImIxSz4F0VYBKi7LYIuxOwTZzK3wh5jHzASMw==
-  dependencies:
-    chalk "^4.0.0"
-    diff-sequences "^29.3.1"
-    jest-get-type "^29.2.0"
-    pretty-format "^29.4.1"
-
 jest-diff@^29.7.0:
   version "29.7.0"
   resolved "https://registry.yarnpkg.com/jest-diff/-/jest-diff-29.7.0.tgz#017934a66ebb7ecf6f205e84699be10afd70458a"
@@ -6693,40 +7143,35 @@ jest-diff@^29.7.0:
     jest-get-type "^29.6.3"
     pretty-format "^29.7.0"
 
-jest-docblock@^29.2.0:
-  version "29.2.0"
-  resolved "https://registry.yarnpkg.com/jest-docblock/-/jest-docblock-29.2.0.tgz#307203e20b637d97cee04809efc1d43afc641e82"
-  integrity sha512-bkxUsxTgWQGbXV5IENmfiIuqZhJcyvF7tU4zJ/7ioTutdz4ToB5Yx6JOFBpgI+TphRY4lhOyCWGNH/QFQh5T6A==
+jest-docblock@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-docblock/-/jest-docblock-29.7.0.tgz#8fddb6adc3cdc955c93e2a87f61cfd350d5d119a"
+  integrity sha512-q617Auw3A612guyaFgsbFeYpNP5t2aoUNLwBUbc/0kD1R4t9ixDbyFTHd1nok4epoVFpr7PmeWHrhvuV3XaJ4g==
   dependencies:
     detect-newline "^3.0.0"
 
-jest-each@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-each/-/jest-each-29.4.1.tgz#05ce9979e7486dbd0f5d41895f49ccfdd0afce01"
-  integrity sha512-QlYFiX3llJMWUV0BtWht/esGEz9w+0i7BHwODKCze7YzZzizgExB9MOfiivF/vVT0GSQ8wXLhvHXh3x2fVD4QQ==
+jest-each@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-each/-/jest-each-29.7.0.tgz#162a9b3f2328bdd991beaabffbb74745e56577d1"
+  integrity sha512-gns+Er14+ZrEoC5fhOfYCY1LOHHr0TI+rQUHZS8Ttw2l7gl+80eHc/gFf2Ktkw0+SIACDTeWvpFcv3B04VembQ==
   dependencies:
-    "@jest/types" "^29.4.1"
+    "@jest/types" "^29.6.3"
     chalk "^4.0.0"
-    jest-get-type "^29.2.0"
-    jest-util "^29.4.1"
-    pretty-format "^29.4.1"
-
-jest-environment-node@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-environment-node/-/jest-environment-node-29.4.1.tgz#22550b7d0f8f0b16228639c9f88ca04bbf3c1974"
-  integrity sha512-x/H2kdVgxSkxWAIlIh9MfMuBa0hZySmfsC5lCsWmWr6tZySP44ediRKDUiNggX/eHLH7Cd5ZN10Rw+XF5tXsqg==
-  dependencies:
-    "@jest/environment" "^29.4.1"
-    "@jest/fake-timers" "^29.4.1"
-    "@jest/types" "^29.4.1"
-    "@types/node" "*"
-    jest-mock "^29.4.1"
-    jest-util "^29.4.1"
+    jest-get-type "^29.6.3"
+    jest-util "^29.7.0"
+    pretty-format "^29.7.0"
 
-jest-get-type@^29.2.0:
-  version "29.2.0"
-  resolved "https://registry.yarnpkg.com/jest-get-type/-/jest-get-type-29.2.0.tgz#726646f927ef61d583a3b3adb1ab13f3a5036408"
-  integrity sha512-uXNJlg8hKFEnDgFsrCjznB+sTxdkuqiCL6zMgA75qEbAJjJYTs9XPrvDctrEig2GDow22T/LvHgO57iJhXB/UA==
+jest-environment-node@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-environment-node/-/jest-environment-node-29.7.0.tgz#0b93e111dda8ec120bc8300e6d1fb9576e164376"
+  integrity sha512-DOSwCRqXirTOyheM+4d5YZOrWcdu0LNZ87ewUoywbcb2XR4wKgqiG8vNeYwhjFMbEkfju7wx2GYH0P2gevGvFw==
+  dependencies:
+    "@jest/environment" "^29.7.0"
+    "@jest/fake-timers" "^29.7.0"
+    "@jest/types" "^29.6.3"
+    "@types/node" "*"
+    jest-mock "^29.7.0"
+    jest-util "^29.7.0"
 
 jest-get-type@^29.6.3:
   version "29.6.3"
@@ -6754,42 +7199,32 @@ jest-haste-map@^26.6.2:
   optionalDependencies:
     fsevents "^2.1.2"
 
-jest-haste-map@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-haste-map/-/jest-haste-map-29.4.1.tgz#b0579dc82d94b40ed9041af56ad25c2f80bedaeb"
-  integrity sha512-imTjcgfVVTvg02khXL11NNLTx9ZaofbAWhilrMg/G8dIkp+HYCswhxf0xxJwBkfhWb3e8dwbjuWburvxmcr58w==
+jest-haste-map@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-haste-map/-/jest-haste-map-29.7.0.tgz#3c2396524482f5a0506376e6c858c3bbcc17b104"
+  integrity sha512-fP8u2pyfqx0K1rGn1R9pyE0/KTn+G7PxktWidOBTqFPLYX0b9ksaMFkhK5vrS3DVun09pckLdlx90QthlW7AmA==
   dependencies:
-    "@jest/types" "^29.4.1"
+    "@jest/types" "^29.6.3"
     "@types/graceful-fs" "^4.1.3"
     "@types/node" "*"
     anymatch "^3.0.3"
     fb-watchman "^2.0.0"
     graceful-fs "^4.2.9"
-    jest-regex-util "^29.2.0"
-    jest-util "^29.4.1"
-    jest-worker "^29.4.1"
+    jest-regex-util "^29.6.3"
+    jest-util "^29.7.0"
+    jest-worker "^29.7.0"
     micromatch "^4.0.4"
     walker "^1.0.8"
   optionalDependencies:
     fsevents "^2.3.2"
 
-jest-leak-detector@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-leak-detector/-/jest-leak-detector-29.4.1.tgz#632186c546e084da2b490b7496fee1a1c9929637"
-  integrity sha512-akpZv7TPyGMnH2RimOCgy+hPmWZf55EyFUvymQ4LMsQP8xSPlZumCPtXGoDhFNhUE2039RApZkTQDKU79p/FiQ==
-  dependencies:
-    jest-get-type "^29.2.0"
-    pretty-format "^29.4.1"
-
-jest-matcher-utils@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-matcher-utils/-/jest-matcher-utils-29.4.1.tgz#73d834e305909c3b43285fbc76f78bf0ad7e1954"
-  integrity sha512-k5h0u8V4nAEy6lSACepxL/rw78FLDkBnXhZVgFneVpnJONhb2DhZj/Gv4eNe+1XqQ5IhgUcqj745UwH0HJmMnA==
+jest-leak-detector@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-leak-detector/-/jest-leak-detector-29.7.0.tgz#5b7ec0dadfdfec0ca383dc9aa016d36b5ea4c728"
+  integrity sha512-kYA8IJcSYtST2BY9I+SMC32nDpBT3J2NvWJx8+JCuCdl/CR1I4EKUJROiP8XtCcxqgTTBGJNdbB1A8XRKbTetw==
   dependencies:
-    chalk "^4.0.0"
-    jest-diff "^29.4.1"
-    jest-get-type "^29.2.0"
-    pretty-format "^29.4.1"
+    jest-get-type "^29.6.3"
+    pretty-format "^29.7.0"
 
 jest-matcher-utils@^29.7.0:
   version "29.7.0"
@@ -6816,21 +7251,6 @@ jest-message-util@^26.6.2:
     slash "^3.0.0"
     stack-utils "^2.0.2"
 
-jest-message-util@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-message-util/-/jest-message-util-29.4.1.tgz#522623aa1df9a36ebfdffb06495c7d9d19e8a845"
-  integrity sha512-H4/I0cXUaLeCw6FM+i4AwCnOwHRgitdaUFOdm49022YD5nfyr8C/DrbXOBEyJaj+w/y0gGJ57klssOaUiLLQGQ==
-  dependencies:
-    "@babel/code-frame" "^7.12.13"
-    "@jest/types" "^29.4.1"
-    "@types/stack-utils" "^2.0.0"
-    chalk "^4.0.0"
-    graceful-fs "^4.2.9"
-    micromatch "^4.0.4"
-    pretty-format "^29.4.1"
-    slash "^3.0.0"
-    stack-utils "^2.0.3"
-
 jest-message-util@^29.7.0:
   version "29.7.0"
   resolved "https://registry.yarnpkg.com/jest-message-util/-/jest-message-util-29.7.0.tgz#8bc392e204e95dfe7564abbe72a404e28e51f7f3"
@@ -6846,14 +7266,14 @@ jest-message-util@^29.7.0:
     slash "^3.0.0"
     stack-utils "^2.0.3"
 
-jest-mock@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-mock/-/jest-mock-29.4.1.tgz#a218a2abf45c99c501d4665207748a6b9e29afbd"
-  integrity sha512-MwA4hQ7zBOcgVCVnsM8TzaFLVUD/pFWTfbkY953Y81L5ret3GFRZtmPmRFAjKQSdCKoJvvqOu6Bvfpqlwwb0dQ==
+jest-mock@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-mock/-/jest-mock-29.7.0.tgz#4e836cf60e99c6fcfabe9f99d017f3fdd50a6347"
+  integrity sha512-ITOMZn+UkYS4ZFh83xYAOzWStloNzJFO2s8DWrE4lhtGD+AorgnbkiKERe4wQVBydIGPx059g6riW5Btp6Llnw==
   dependencies:
-    "@jest/types" "^29.4.1"
+    "@jest/types" "^29.6.3"
     "@types/node" "*"
-    jest-util "^29.4.1"
+    jest-util "^29.7.0"
 
 jest-pnp-resolver@^1.2.2:
   version "1.2.2"
@@ -6865,18 +7285,18 @@ jest-regex-util@^26.0.0:
   resolved "https://registry.yarnpkg.com/jest-regex-util/-/jest-regex-util-26.0.0.tgz#d25e7184b36e39fd466c3bc41be0971e821fee28"
   integrity sha512-Gv3ZIs/nA48/Zvjrl34bf+oD76JHiGDUxNOVgUjh3j890sblXryjY4rss71fPtD/njchl6PSE2hIhvyWa1eT0A==
 
-jest-regex-util@^29.2.0:
-  version "29.2.0"
-  resolved "https://registry.yarnpkg.com/jest-regex-util/-/jest-regex-util-29.2.0.tgz#82ef3b587e8c303357728d0322d48bbfd2971f7b"
-  integrity sha512-6yXn0kg2JXzH30cr2NlThF+70iuO/3irbaB4mh5WyqNIvLLP+B6sFdluO1/1RJmslyh/f9osnefECflHvTbwVA==
+jest-regex-util@^29.6.3:
+  version "29.6.3"
+  resolved "https://registry.yarnpkg.com/jest-regex-util/-/jest-regex-util-29.6.3.tgz#4a556d9c776af68e1c5f48194f4d0327d24e8a52"
+  integrity sha512-KJJBsRCyyLNWCNBOvZyRDnAIfUiRJ8v+hOBQYGn8gDyF3UegwiP4gwRR3/SDa42g1YbVycTidUF3rKjyLFDWbg==
 
-jest-resolve-dependencies@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-resolve-dependencies/-/jest-resolve-dependencies-29.4.1.tgz#02420a2e055da105e5fca8218c471d8b9553c904"
-  integrity sha512-Y3QG3M1ncAMxfjbYgtqNXC5B595zmB6e//p/qpA/58JkQXu/IpLDoLeOa8YoYfsSglBKQQzNUqtfGJJT/qLmJg==
+jest-resolve-dependencies@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-resolve-dependencies/-/jest-resolve-dependencies-29.7.0.tgz#1b04f2c095f37fc776ff40803dc92921b1e88428"
+  integrity sha512-un0zD/6qxJ+S0et7WxeI3H5XSe9lTBBR7bOHCHXkKR6luG5mwDDlIzVQ0V5cZCuoTgEdcdwzTghYkTWfubi+nA==
   dependencies:
-    jest-regex-util "^29.2.0"
-    jest-snapshot "^29.4.1"
+    jest-regex-util "^29.6.3"
+    jest-snapshot "^29.7.0"
 
 jest-resolve@^26.6.2:
   version "26.6.2"
@@ -6892,74 +7312,73 @@ jest-resolve@^26.6.2:
     resolve "^1.18.1"
     slash "^3.0.0"
 
-jest-resolve@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-resolve/-/jest-resolve-29.4.1.tgz#4c6bf71a07b8f0b79c5fdf4f2a2cf47317694c5e"
-  integrity sha512-j/ZFNV2lm9IJ2wmlq1uYK0Y/1PiyDq9g4HEGsNTNr3viRbJdV+8Lf1SXIiLZXFvyiisu0qUyIXGBnw+OKWkJwQ==
+jest-resolve@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-resolve/-/jest-resolve-29.7.0.tgz#64d6a8992dd26f635ab0c01e5eef4399c6bcbc30"
+  integrity sha512-IOVhZSrg+UvVAshDSDtHyFCCBUl/Q3AAJv8iZ6ZjnZ74xzvwuzLXid9IIIPgTnY62SJjfuupMKZsZQRsCvxEgA==
   dependencies:
     chalk "^4.0.0"
     graceful-fs "^4.2.9"
-    jest-haste-map "^29.4.1"
+    jest-haste-map "^29.7.0"
     jest-pnp-resolver "^1.2.2"
-    jest-util "^29.4.1"
-    jest-validate "^29.4.1"
+    jest-util "^29.7.0"
+    jest-validate "^29.7.0"
     resolve "^1.20.0"
     resolve.exports "^2.0.0"
     slash "^3.0.0"
 
-jest-runner@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-runner/-/jest-runner-29.4.1.tgz#57460d9ebb0eea2e27eeddca1816cf8537469661"
-  integrity sha512-8d6XXXi7GtHmsHrnaqBKWxjKb166Eyj/ksSaUYdcBK09VbjPwIgWov1VwSmtupCIz8q1Xv4Qkzt/BTo3ZqiCeg==
+jest-runner@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-runner/-/jest-runner-29.7.0.tgz#809af072d408a53dcfd2e849a4c976d3132f718e"
+  integrity sha512-fsc4N6cPCAahybGBfTRcq5wFR6fpLznMg47sY5aDpsoejOcVYFb07AHuSnR0liMcPTgBsA3ZJL6kFOjPdoNipQ==
   dependencies:
-    "@jest/console" "^29.4.1"
-    "@jest/environment" "^29.4.1"
-    "@jest/test-result" "^29.4.1"
-    "@jest/transform" "^29.4.1"
-    "@jest/types" "^29.4.1"
+    "@jest/console" "^29.7.0"
+    "@jest/environment" "^29.7.0"
+    "@jest/test-result" "^29.7.0"
+    "@jest/transform" "^29.7.0"
+    "@jest/types" "^29.6.3"
     "@types/node" "*"
     chalk "^4.0.0"
     emittery "^0.13.1"
     graceful-fs "^4.2.9"
-    jest-docblock "^29.2.0"
-    jest-environment-node "^29.4.1"
-    jest-haste-map "^29.4.1"
-    jest-leak-detector "^29.4.1"
-    jest-message-util "^29.4.1"
-    jest-resolve "^29.4.1"
-    jest-runtime "^29.4.1"
-    jest-util "^29.4.1"
-    jest-watcher "^29.4.1"
-    jest-worker "^29.4.1"
+    jest-docblock "^29.7.0"
+    jest-environment-node "^29.7.0"
+    jest-haste-map "^29.7.0"
+    jest-leak-detector "^29.7.0"
+    jest-message-util "^29.7.0"
+    jest-resolve "^29.7.0"
+    jest-runtime "^29.7.0"
+    jest-util "^29.7.0"
+    jest-watcher "^29.7.0"
+    jest-worker "^29.7.0"
     p-limit "^3.1.0"
     source-map-support "0.5.13"
 
-jest-runtime@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-runtime/-/jest-runtime-29.4.1.tgz#9a50f9c69d3a391690897c01b0bfa8dc5dd45808"
-  integrity sha512-UXTMU9uKu2GjYwTtoAw5rn4STxWw/nadOfW7v1sx6LaJYa3V/iymdCLQM6xy3+7C6mY8GfX22vKpgxY171UIoA==
-  dependencies:
-    "@jest/environment" "^29.4.1"
-    "@jest/fake-timers" "^29.4.1"
-    "@jest/globals" "^29.4.1"
-    "@jest/source-map" "^29.2.0"
-    "@jest/test-result" "^29.4.1"
-    "@jest/transform" "^29.4.1"
-    "@jest/types" "^29.4.1"
+jest-runtime@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-runtime/-/jest-runtime-29.7.0.tgz#efecb3141cf7d3767a3a0cc8f7c9990587d3d817"
+  integrity sha512-gUnLjgwdGqW7B4LvOIkbKs9WGbn+QLqRQQ9juC6HndeDiezIwhDP+mhMwHWCEcfQ5RUXa6OPnFF8BJh5xegwwQ==
+  dependencies:
+    "@jest/environment" "^29.7.0"
+    "@jest/fake-timers" "^29.7.0"
+    "@jest/globals" "^29.7.0"
+    "@jest/source-map" "^29.6.3"
+    "@jest/test-result" "^29.7.0"
+    "@jest/transform" "^29.7.0"
+    "@jest/types" "^29.6.3"
     "@types/node" "*"
     chalk "^4.0.0"
     cjs-module-lexer "^1.0.0"
     collect-v8-coverage "^1.0.0"
     glob "^7.1.3"
     graceful-fs "^4.2.9"
-    jest-haste-map "^29.4.1"
-    jest-message-util "^29.4.1"
-    jest-mock "^29.4.1"
-    jest-regex-util "^29.2.0"
-    jest-resolve "^29.4.1"
-    jest-snapshot "^29.4.1"
-    jest-util "^29.4.1"
-    semver "^7.3.5"
+    jest-haste-map "^29.7.0"
+    jest-message-util "^29.7.0"
+    jest-mock "^29.7.0"
+    jest-regex-util "^29.6.3"
+    jest-resolve "^29.7.0"
+    jest-snapshot "^29.7.0"
+    jest-util "^29.7.0"
     slash "^3.0.0"
     strip-bom "^4.0.0"
 
@@ -6971,35 +7390,31 @@ jest-serializer@^26.6.2:
     "@types/node" "*"
     graceful-fs "^4.2.4"
 
-jest-snapshot@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-snapshot/-/jest-snapshot-29.4.1.tgz#5692210b3690c94f19317913d4082b123bd83dd9"
-  integrity sha512-l4iV8EjGgQWVz3ee/LR9sULDk2pCkqb71bjvlqn+qp90lFwpnulHj4ZBT8nm1hA1C5wowXLc7MGnw321u0tsYA==
+jest-snapshot@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-snapshot/-/jest-snapshot-29.7.0.tgz#c2c574c3f51865da1bb329036778a69bf88a6be5"
+  integrity sha512-Rm0BMWtxBcioHr1/OX5YCP8Uov4riHvKPknOGs804Zg9JGZgmIBkbtlxJC/7Z4msKYVbIJtfU+tKb8xlYNfdkw==
   dependencies:
     "@babel/core" "^7.11.6"
     "@babel/generator" "^7.7.2"
     "@babel/plugin-syntax-jsx" "^7.7.2"
     "@babel/plugin-syntax-typescript" "^7.7.2"
-    "@babel/traverse" "^7.7.2"
     "@babel/types" "^7.3.3"
-    "@jest/expect-utils" "^29.4.1"
-    "@jest/transform" "^29.4.1"
-    "@jest/types" "^29.4.1"
-    "@types/babel__traverse" "^7.0.6"
-    "@types/prettier" "^2.1.5"
+    "@jest/expect-utils" "^29.7.0"
+    "@jest/transform" "^29.7.0"
+    "@jest/types" "^29.6.3"
     babel-preset-current-node-syntax "^1.0.0"
     chalk "^4.0.0"
-    expect "^29.4.1"
+    expect "^29.7.0"
     graceful-fs "^4.2.9"
-    jest-diff "^29.4.1"
-    jest-get-type "^29.2.0"
-    jest-haste-map "^29.4.1"
-    jest-matcher-utils "^29.4.1"
-    jest-message-util "^29.4.1"
-    jest-util "^29.4.1"
+    jest-diff "^29.7.0"
+    jest-get-type "^29.6.3"
+    jest-matcher-utils "^29.7.0"
+    jest-message-util "^29.7.0"
+    jest-util "^29.7.0"
     natural-compare "^1.4.0"
-    pretty-format "^29.4.1"
-    semver "^7.3.5"
+    pretty-format "^29.7.0"
+    semver "^7.5.3"
 
 jest-util@^26.6.2:
   version "26.6.2"
@@ -7013,18 +7428,6 @@ jest-util@^26.6.2:
     is-ci "^2.0.0"
     micromatch "^4.0.2"
 
-jest-util@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-util/-/jest-util-29.4.1.tgz#2eeed98ff4563b441b5a656ed1a786e3abc3e4c4"
-  integrity sha512-bQy9FPGxVutgpN4VRc0hk6w7Hx/m6L53QxpDreTZgJd9gfx/AV2MjyPde9tGyZRINAUrSv57p2inGBu2dRLmkQ==
-  dependencies:
-    "@jest/types" "^29.4.1"
-    "@types/node" "*"
-    chalk "^4.0.0"
-    ci-info "^3.2.0"
-    graceful-fs "^4.2.9"
-    picomatch "^2.2.3"
-
 jest-util@^29.7.0:
   version "29.7.0"
   resolved "https://registry.yarnpkg.com/jest-util/-/jest-util-29.7.0.tgz#23c2b62bfb22be82b44de98055802ff3710fc0bc"
@@ -7037,30 +7440,30 @@ jest-util@^29.7.0:
     graceful-fs "^4.2.9"
     picomatch "^2.2.3"
 
-jest-validate@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-validate/-/jest-validate-29.4.1.tgz#0d5174510415083ec329d4f981bf6779211f17e9"
-  integrity sha512-qNZXcZQdIQx4SfUB/atWnI4/I2HUvhz8ajOSYUu40CSmf9U5emil8EDHgE7M+3j9/pavtk3knlZBDsgFvv/SWw==
+jest-validate@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-validate/-/jest-validate-29.7.0.tgz#7bf705511c64da591d46b15fce41400d52147d9c"
+  integrity sha512-ZB7wHqaRGVw/9hST/OuFUReG7M8vKeq0/J2egIGLdvjHCmYqGARhzXmtgi+gVeZ5uXFF219aOc3Ls2yLg27tkw==
   dependencies:
-    "@jest/types" "^29.4.1"
+    "@jest/types" "^29.6.3"
     camelcase "^6.2.0"
     chalk "^4.0.0"
-    jest-get-type "^29.2.0"
+    jest-get-type "^29.6.3"
     leven "^3.1.0"
-    pretty-format "^29.4.1"
+    pretty-format "^29.7.0"
 
-jest-watcher@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-watcher/-/jest-watcher-29.4.1.tgz#6e3e2486918bd778849d4d6e67fd77b814f3e6ed"
-  integrity sha512-vFOzflGFs27nU6h8dpnVRER3O2rFtL+VMEwnG0H3KLHcllLsU8y9DchSh0AL/Rg5nN1/wSiQ+P4ByMGpuybaVw==
+jest-watcher@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-watcher/-/jest-watcher-29.7.0.tgz#7810d30d619c3a62093223ce6bb359ca1b28a2f2"
+  integrity sha512-49Fg7WXkU3Vl2h6LbLtMQ/HyB6rXSIX7SqvBLQmssRBGN9I0PNvPmAmCWSOY6SOvrjhI/F7/bGAv9RtnsPA03g==
   dependencies:
-    "@jest/test-result" "^29.4.1"
-    "@jest/types" "^29.4.1"
+    "@jest/test-result" "^29.7.0"
+    "@jest/types" "^29.6.3"
     "@types/node" "*"
     ansi-escapes "^4.2.1"
     chalk "^4.0.0"
     emittery "^0.13.1"
-    jest-util "^29.4.1"
+    jest-util "^29.7.0"
     string-length "^4.0.1"
 
 jest-worker@^26.6.2:
@@ -7072,25 +7475,25 @@ jest-worker@^26.6.2:
     merge-stream "^2.0.0"
     supports-color "^7.0.0"
 
-jest-worker@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest-worker/-/jest-worker-29.4.1.tgz#7cb4a99a38975679600305650f86f4807460aab1"
-  integrity sha512-O9doU/S1EBe+yp/mstQ0VpPwpv0Clgn68TkNwGxL6/usX/KUW9Arnn4ag8C3jc6qHcXznhsT5Na1liYzAsuAbQ==
+jest-worker@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest-worker/-/jest-worker-29.7.0.tgz#acad073acbbaeb7262bd5389e1bcf43e10058d4a"
+  integrity sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==
   dependencies:
     "@types/node" "*"
-    jest-util "^29.4.1"
+    jest-util "^29.7.0"
     merge-stream "^2.0.0"
     supports-color "^8.0.0"
 
-jest@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/jest/-/jest-29.4.1.tgz#bb34baca8e05901b49c02c62f1183a6182ea1785"
-  integrity sha512-cknimw7gAXPDOmj0QqztlxVtBVCw2lYY9CeIE5N6kD+kET1H4H79HSNISJmijb1HF+qk+G+ploJgiDi5k/fRlg==
+jest@^29.7.0:
+  version "29.7.0"
+  resolved "https://registry.yarnpkg.com/jest/-/jest-29.7.0.tgz#994676fc24177f088f1c5e3737f5697204ff2613"
+  integrity sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==
   dependencies:
-    "@jest/core" "^29.4.1"
-    "@jest/types" "^29.4.1"
+    "@jest/core" "^29.7.0"
+    "@jest/types" "^29.6.3"
     import-local "^3.0.2"
-    jest-cli "^29.4.1"
+    jest-cli "^29.7.0"
 
 js-sha256@^0.9.0:
   version "0.9.0"
@@ -7102,7 +7505,7 @@ js-tokens@^4.0.0:
   resolved "https://registry.yarnpkg.com/js-tokens/-/js-tokens-4.0.0.tgz#19203fb59991df98e3a287050d4647cdeaf32499"
   integrity sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==
 
-js-yaml@3.14.0, js-yaml@^3.13.1:
+js-yaml@^3.13.1:
   version "3.14.0"
   resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-3.14.0.tgz#a7a34170f26a21bb162424d8adacb4113a69e482"
   integrity sha512-/4IbIeHcD9VMHFqDR/gQ7EdZdLimOvW2DdcxFjdyyZ9NsbS+ccrXqVWDtab/lRl5AlUqmpBx8EhPaWR+OtY17A==
@@ -7127,6 +7530,11 @@ jsesc@^2.5.1:
   resolved "https://registry.yarnpkg.com/jsesc/-/jsesc-2.5.2.tgz#80564d2e483dacf6e8ef209650a67df3f0c283a4"
   integrity sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==
 
+jsesc@^3.0.2:
+  version "3.1.0"
+  resolved "https://registry.yarnpkg.com/jsesc/-/jsesc-3.1.0.tgz#74d335a234f67ed19907fdadfac7ccf9d409825d"
+  integrity sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==
+
 json-buffer@3.0.1:
   version "3.0.1"
   resolved "https://registry.yarnpkg.com/json-buffer/-/json-buffer-3.0.1.tgz#9338802a30d3b6605fbe0613e094008ca8c05a13"
@@ -7176,7 +7584,7 @@ json5@^2.1.2:
   dependencies:
     minimist "^1.2.5"
 
-json5@^2.2.2:
+json5@^2.2.2, json5@^2.2.3:
   version "2.2.3"
   resolved "https://registry.yarnpkg.com/json5/-/json5-2.2.3.tgz#78cd6f1a19bdc12b73db5ad0c61efd66c1e29283"
   integrity sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==
@@ -7188,15 +7596,6 @@ jsonfile@^4.0.0:
   optionalDependencies:
     graceful-fs "^4.1.6"
 
-jsonfile@^6.0.1:
-  version "6.1.0"
-  resolved "https://registry.yarnpkg.com/jsonfile/-/jsonfile-6.1.0.tgz#bc55b2634793c679ec6403094eb13698a6ec0aae"
-  integrity sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==
-  dependencies:
-    universalify "^2.0.0"
-  optionalDependencies:
-    graceful-fs "^4.1.6"
-
 jsonparse@^1.2.0:
   version "1.3.1"
   resolved "https://registry.yarnpkg.com/jsonparse/-/jsonparse-1.3.1.tgz#3f4dae4a91fac315f71062f8521cc239f1366280"
@@ -7212,10 +7611,10 @@ jsprim@^1.2.2:
     json-schema "0.2.3"
     verror "1.10.0"
 
-junk@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.yarnpkg.com/junk/-/junk-4.0.0.tgz#9b1104ddf5281cd24ffa3c8a7443d19ce192b37f"
-  integrity sha512-ojtSU++zLJ3jQG9bAYjg94w+/DOJtRyD7nPaerMFrBhmdVmiV5/exYH5t4uHga4G/95nT6hr1OJoKIFbYbrW5w==
+junk@^4.0.1:
+  version "4.0.1"
+  resolved "https://registry.yarnpkg.com/junk/-/junk-4.0.1.tgz#7ee31f876388c05177fe36529ee714b07b50fbed"
+  integrity sha512-Qush0uP+G8ZScpGMZvHUiRfI0YBWuB3gVBYlI0v0vvOJt5FLicco+IkP0a50LqTTQhmts/m6tP5SWE+USyIvcQ==
 
 keccak@^3.0.1:
   version "3.0.4"
@@ -7226,7 +7625,7 @@ keccak@^3.0.1:
     node-gyp-build "^4.2.0"
     readable-stream "^3.6.0"
 
-keyv@^4.5.3:
+keyv@^4.5.3, keyv@^4.5.4:
   version "4.5.4"
   resolved "https://registry.yarnpkg.com/keyv/-/keyv-4.5.4.tgz#a879a99e29452f942439f2a405e3af8b31d4de93"
   integrity sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==
@@ -7441,13 +7840,6 @@ lru-cache@^5.1.1:
   dependencies:
     yallist "^3.0.2"
 
-lru-cache@^6.0.0:
-  version "6.0.0"
-  resolved "https://registry.yarnpkg.com/lru-cache/-/lru-cache-6.0.0.tgz#6d6fe6570ebd96aaf90fcad1dafa3b2566db3a94"
-  integrity sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==
-  dependencies:
-    yallist "^4.0.0"
-
 macos-release@^2.2.0:
   version "2.4.1"
   resolved "https://registry.yarnpkg.com/macos-release/-/macos-release-2.4.1.tgz#64033d0ec6a5e6375155a74b1a1eba8e509820ac"
@@ -7519,11 +7911,6 @@ map-obj@^4.0.0:
   resolved "https://registry.yarnpkg.com/map-obj/-/map-obj-4.1.0.tgz#b91221b542734b9f14256c0132c897c5d7256fd5"
   integrity sha512-glc9y00wgtwcDmp7GaE/0b0OnxpNJsVf3ael/An6Fe2Q51LLwN1er6sdomLRzz5h0+yMpiYLhWYF5R7HeqVd4g==
 
-map-obj@^4.1.0:
-  version "4.3.0"
-  resolved "https://registry.yarnpkg.com/map-obj/-/map-obj-4.3.0.tgz#9304f906e93faae70880da102a9f1df0ea8bb05a"
-  integrity sha512-hdN1wVrZbb29eBGiGjJbeP8JbKjq1urkHJ/LIP/NY48MZ1QVXUsQBV1G1zvYFHn1XE06cwjBsOI2K3Ulnj1YXQ==
-
 map-visit@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/map-visit/-/map-visit-1.0.0.tgz#ecdca8f13144e660f1b5bd41f12f3479d98dfb8f"
@@ -7531,6 +7918,11 @@ map-visit@^1.0.0:
   dependencies:
     object-visit "^1.0.0"
 
+math-intrinsics@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/math-intrinsics/-/math-intrinsics-1.1.0.tgz#a0dd74be81e2aa5c2f27e65ce283605ee4e2b7f9"
+  integrity sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==
+
 md5.js@^1.3.4:
   version "1.3.5"
   resolved "https://registry.yarnpkg.com/md5.js/-/md5.js-1.3.5.tgz#b5d07b8e3216e3e27cd728d72f70d1e6a342005f"
@@ -7540,23 +7932,10 @@ md5.js@^1.3.4:
     inherits "^2.0.1"
     safe-buffer "^5.1.2"
 
-meow@^10.1.2:
-  version "10.1.5"
-  resolved "https://registry.yarnpkg.com/meow/-/meow-10.1.5.tgz#be52a1d87b5f5698602b0f32875ee5940904aa7f"
-  integrity sha512-/d+PQ4GKmGvM9Bee/DPa8z3mXs/pkvJE2KEThngVNOqtmljC6K7NMPxtc2JeZYTmpWb9k/TmxjeL18ez3h7vCw==
-  dependencies:
-    "@types/minimist" "^1.2.2"
-    camelcase-keys "^7.0.0"
-    decamelize "^5.0.0"
-    decamelize-keys "^1.1.0"
-    hard-rejection "^2.1.0"
-    minimist-options "4.1.0"
-    normalize-package-data "^3.0.2"
-    read-pkg-up "^8.0.0"
-    redent "^4.0.0"
-    trim-newlines "^4.0.2"
-    type-fest "^1.2.2"
-    yargs-parser "^20.2.9"
+meow@^12.0.1:
+  version "12.1.1"
+  resolved "https://registry.yarnpkg.com/meow/-/meow-12.1.1.tgz#e558dddbab12477b69b2e9a2728c327f191bace6"
+  integrity sha512-BhXM0Au22RwUneMPwSCnyhTOizdWoIEPU9sp0Aqa1PnDMR5Wv2FGXYDjuzJEIX+Eo2Rb8xuYe5jrnm5QowQFkw==
 
 meow@^3.3.0:
   version "3.7.0"
@@ -7648,10 +8027,10 @@ micromatch@^4.0.2:
     braces "^3.0.1"
     picomatch "^2.0.5"
 
-micromatch@^4.0.4:
-  version "4.0.7"
-  resolved "https://registry.yarnpkg.com/micromatch/-/micromatch-4.0.7.tgz#33e8190d9fe474a9895525f5618eee136d46c2e5"
-  integrity sha512-LPP/3KorzCwBxfeUuZmaR6bG2kdeHSbe0P2tY3FLRU4vYrjYz5hI4QZwV0njUx3jeuKe67YukQ1LSPZBKDqO/Q==
+micromatch@^4.0.4, micromatch@^4.0.5, micromatch@^4.0.8:
+  version "4.0.8"
+  resolved "https://registry.yarnpkg.com/micromatch/-/micromatch-4.0.8.tgz#d66fa18f3a47076789320b9b1af32bd86d9fa202"
+  integrity sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==
   dependencies:
     braces "^3.0.3"
     picomatch "^2.3.1"
@@ -7678,7 +8057,7 @@ mimic-fn@^2.1.0:
   resolved "https://registry.yarnpkg.com/mimic-fn/-/mimic-fn-2.1.0.tgz#7ed2c2ccccaf84d3ffcb7a69b57711fc2083401b"
   integrity sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==
 
-min-indent@^1.0.0, min-indent@^1.0.1:
+min-indent@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/min-indent/-/min-indent-1.0.1.tgz#a63f681673b30571fbe8bc25686ae746eefa9869"
   integrity sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==
@@ -7885,12 +8264,7 @@ neo-async@^2.6.0:
   resolved "https://registry.yarnpkg.com/neo-async/-/neo-async-2.6.2.tgz#b4aafb93e3aeb2d8174ca53cf163ab7d7308305f"
   integrity sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==
 
-nested-error-stacks@^2.0.0:
-  version "2.1.0"
-  resolved "https://registry.yarnpkg.com/nested-error-stacks/-/nested-error-stacks-2.1.0.tgz#0fbdcf3e13fe4994781280524f8b96b0cdff9c61"
-  integrity sha512-AO81vsIO1k1sM4Zrd6Hu7regmJN1NSiAja10gc4bX3F0wd+9rQmcuHQaHVQCYIEC8iFXnE+mavh23GOt7wBgug==
-
-nested-error-stacks@^2.1.0:
+nested-error-stacks@^2.1.1:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/nested-error-stacks/-/nested-error-stacks-2.1.1.tgz#26c8a3cee6cc05fbcf1e333cd2fc3e003326c0b5"
   integrity sha512-9iN1ka/9zmX1ZvLV9ewJYEk9h7RyRRtqdK0woXcqohu8EWIerfPUjYJPg0ULy0UqP7cslmdGc8xKDJcojlKiaw==
@@ -7914,7 +8288,7 @@ node-fetch-npm@^2.0.2:
     json-parse-better-errors "^1.0.0"
     safe-buffer "^5.1.1"
 
-node-fetch@^2.2.0, node-fetch@^2.3.0, node-fetch@^2.5.0:
+node-fetch@^2.3.0, node-fetch@^2.5.0:
   version "2.6.0"
   resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.6.0.tgz#e633456386d4aa55863f676a7ab0daa8fdecb0fd"
   integrity sha512-8dG4H5ujfvFiqDmVu9fQ5bOHUC15JMjMY/Zumv26oOvvVJjM67KF8koCWIabKQ1GJIa9r2mMZscBq/TbdOcmNA==
@@ -7958,6 +8332,11 @@ node-notifier@^8.0.0:
     uuid "^8.3.0"
     which "^2.0.2"
 
+node-releases@^2.0.19:
+  version "2.0.19"
+  resolved "https://registry.yarnpkg.com/node-releases/-/node-releases-2.0.19.tgz#9e445a52950951ec4d177d843af370b411caf314"
+  integrity sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw==
+
 node-releases@^2.0.8:
   version "2.0.9"
   resolved "https://registry.yarnpkg.com/node-releases/-/node-releases-2.0.9.tgz#fe66405285382b0c4ac6bcfbfbe7e8a510650b4d"
@@ -7981,16 +8360,6 @@ normalize-package-data@^2.0.0, normalize-package-data@^2.3.0, normalize-package-
     semver "2 || 3 || 4 || 5"
     validate-npm-package-license "^3.0.1"
 
-normalize-package-data@^3.0.2:
-  version "3.0.3"
-  resolved "https://registry.yarnpkg.com/normalize-package-data/-/normalize-package-data-3.0.3.tgz#dbcc3e2da59509a0983422884cd172eefdfa525e"
-  integrity sha512-p2W1sgqij3zMMyRC067Dg16bfzVH+w7hyegmpIvZ4JNjqtGOVAIvLmjBx3yP7YTe9vKJgkoNOPjwQGogDoMXFA==
-  dependencies:
-    hosted-git-info "^4.0.1"
-    is-core-module "^2.5.0"
-    semver "^7.3.4"
-    validate-npm-package-license "^3.0.1"
-
 normalize-path@^2.1.1:
   version "2.1.1"
   resolved "https://registry.yarnpkg.com/normalize-path/-/normalize-path-2.1.1.tgz#1ab28b556e198363a8c1a6f7e6fa20137fe6aed9"
@@ -8110,10 +8479,10 @@ object-copy@^0.1.0:
     define-property "^0.2.5"
     kind-of "^3.0.3"
 
-object-inspect@^1.13.1:
-  version "1.13.2"
-  resolved "https://registry.yarnpkg.com/object-inspect/-/object-inspect-1.13.2.tgz#dea0088467fb991e67af4058147a24824a3043ff"
-  integrity sha512-IRZSRuzJiynemAXPYtPe5BoI/RESNYR7TYm50MC5Mqbd3Jmw5y790sErYw3V6SryFJD64b74qQQs9wn5Bg/k3g==
+object-inspect@^1.13.3:
+  version "1.13.3"
+  resolved "https://registry.yarnpkg.com/object-inspect/-/object-inspect-1.13.3.tgz#f14c183de51130243d6d18ae149375ff50ea488a"
+  integrity sha512-kDCGIbxkDSXE3euJZZXzc6to7fCrKHNI/hSRQnRuQ+BWjFNzZwiFF8fj/6o2t2G9/jTj8PSIYTfCLelLZEeRpA==
 
 object-inspect@^1.7.0, object-inspect@^1.8.0:
   version "1.8.0"
@@ -8160,14 +8529,16 @@ object.assign@^4.1.2:
     has-symbols "^1.0.1"
     object-keys "^1.1.1"
 
-object.assign@^4.1.5:
-  version "4.1.5"
-  resolved "https://registry.yarnpkg.com/object.assign/-/object.assign-4.1.5.tgz#3a833f9ab7fdb80fc9e8d2300c803d216d8fdbb0"
-  integrity sha512-byy+U7gp+FVwmyzKPYhW2h5l3crpmGsxl7X2s8y43IgxvG4g3QZ6CffDtsNQy1WsmZpQbO+ybo0AlW7TY6DcBQ==
+object.assign@^4.1.7:
+  version "4.1.7"
+  resolved "https://registry.yarnpkg.com/object.assign/-/object.assign-4.1.7.tgz#8c14ca1a424c6a561b0bb2a22f66f5049a945d3d"
+  integrity sha512-nK28WOo+QIjBkDduTINE4JkF/UJJKyf2EJxvJKfblDpyg0Q+pkOHNTL0Qwy6NP6FhE/EnzV73BxxqcJaXY9anw==
   dependencies:
-    call-bind "^1.0.5"
+    call-bind "^1.0.8"
+    call-bound "^1.0.3"
     define-properties "^1.2.1"
-    has-symbols "^1.0.3"
+    es-object-atoms "^1.0.0"
+    has-symbols "^1.1.0"
     object-keys "^1.1.1"
 
 object.entries@^1.1.5:
@@ -8179,7 +8550,7 @@ object.entries@^1.1.5:
     define-properties "^1.2.0"
     es-abstract "^1.22.1"
 
-object.fromentries@^2.0.7:
+object.fromentries@^2.0.8:
   version "2.0.8"
   resolved "https://registry.yarnpkg.com/object.fromentries/-/object.fromentries-2.0.8.tgz#f7195d8a9b97bd95cbc1999ea939ecd1a2b00c65"
   integrity sha512-k6E21FzySsSK5a21KRADBd/NGneRegFO5pLHfdQLpRDETUNJueLXs3WCzyQ3tFRDYgbq3KHGXfTbi2bs8WQ6rQ==
@@ -8197,7 +8568,7 @@ object.getownpropertydescriptors@^2.0.3:
     define-properties "^1.1.3"
     es-abstract "^1.17.0-next.1"
 
-object.groupby@^1.0.1:
+object.groupby@^1.0.3:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/object.groupby/-/object.groupby-1.0.3.tgz#9b125c36238129f6f7b61954a1e7176148d5002e"
   integrity sha512-+Lhy3TQTuzXI5hevh8sBGqbmurHbbIjAi0Z4S63nthVLmLxfbj4T54a4CfZrXIrt9iP4mVAPYMo/v99taj3wjQ==
@@ -8213,12 +8584,13 @@ object.pick@^1.3.0:
   dependencies:
     isobject "^3.0.1"
 
-object.values@^1.1.7:
-  version "1.2.0"
-  resolved "https://registry.yarnpkg.com/object.values/-/object.values-1.2.0.tgz#65405a9d92cee68ac2d303002e0b8470a4d9ab1b"
-  integrity sha512-yBYjY9QX2hnRmZHAjG/f13MzmBzxzYgQhFrke06TTyKY5zSTEqkOeukBzIdVA3j3ulu8Qa3MbVFShV7T2RmGtQ==
+object.values@^1.2.0:
+  version "1.2.1"
+  resolved "https://registry.yarnpkg.com/object.values/-/object.values-1.2.1.tgz#deed520a50809ff7f75a7cfd4bc64c7a038c6216"
+  integrity sha512-gXah6aZrcUxjWg2zR2MwouP2eHlCBzdV4pygudehaKXSGW4v2AsRQUK+lwwXhii6KFZcunEnmSUoYp5CXibxtA==
   dependencies:
-    call-bind "^1.0.7"
+    call-bind "^1.0.8"
+    call-bound "^1.0.3"
     define-properties "^1.2.1"
     es-object-atoms "^1.0.0"
 
@@ -8286,12 +8658,21 @@ osenv@^0.1.4, osenv@^0.1.5:
     os-homedir "^1.0.0"
     os-tmpdir "^1.0.0"
 
-p-event@^4.1.0:
-  version "4.2.0"
-  resolved "https://registry.yarnpkg.com/p-event/-/p-event-4.2.0.tgz#af4b049c8acd91ae81083ebd1e6f5cae2044c1b5"
-  integrity sha512-KXatOjCRXXkSePPb1Nbi0p0m+gQAwdlbhi4wQKJPI1HsMQS9g+Sqp2o+QHziPr7eYJyOZet836KoHEVM1mwOrQ==
+own-keys@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/own-keys/-/own-keys-1.0.1.tgz#e4006910a2bf913585289676eebd6f390cf51358"
+  integrity sha512-qFOyK5PjiWZd+QQIh+1jhdb9LpxTF0qs7Pm8o5QHYZ0M3vKqSqzsZaEB6oWlxZ+q2sJBMI/Ktgd2N5ZwQoRHfg==
+  dependencies:
+    get-intrinsic "^1.2.6"
+    object-keys "^1.1.1"
+    safe-push-apply "^1.0.0"
+
+p-event@^5.0.1:
+  version "5.0.1"
+  resolved "https://registry.yarnpkg.com/p-event/-/p-event-5.0.1.tgz#614624ec02ae7f4f13d09a721c90586184af5b0c"
+  integrity sha512-dd589iCQ7m1L0bmC5NLlVYfy3TbBEsMUfWx9PyAgPeIcFZ/E2yaTZ4Rz4MiBmmJShviiftHVXOqfnfzJ6kyMrQ==
   dependencies:
-    p-timeout "^3.1.0"
+    p-timeout "^5.0.2"
 
 p-filter@^3.0.0:
   version "3.0.0"
@@ -8366,13 +8747,18 @@ p-map@^2.1.0:
   resolved "https://registry.yarnpkg.com/p-map/-/p-map-2.1.0.tgz#310928feef9c9ecc65b68b17693018a665cea175"
   integrity sha512-y3b8Kpd8OAN444hxfBbFfj1FY/RjtTd8tzYwhUqNYXx0fXx2iX4maP4Qr6qhIKbQXI02wTLAda4fYUbDagTUFw==
 
-p-map@^5.1.0, p-map@^5.3.0:
+p-map@^5.1.0:
   version "5.5.0"
   resolved "https://registry.yarnpkg.com/p-map/-/p-map-5.5.0.tgz#054ca8ca778dfa4cf3f8db6638ccb5b937266715"
   integrity sha512-VFqfGDHlx87K66yZrNdI4YGtD70IRyd+zSvgks6mzHPRNkoKy+9EKP4SFC77/vTTQYmRmti7dvqC+m5jBrBAcg==
   dependencies:
     aggregate-error "^4.0.0"
 
+p-map@^6.0.0:
+  version "6.0.0"
+  resolved "https://registry.yarnpkg.com/p-map/-/p-map-6.0.0.tgz#4d9c40d3171632f86c47601b709f4b4acd70fed4"
+  integrity sha512-T8BatKGY+k5rU+Q/GTYgrEf2r4xRMevAN5mtXc2aPc4rS1j3s+vWTaO2Wag94neXuCAUAs8cxBL9EeB5EA6diw==
+
 p-pipe@^1.2.0:
   version "1.2.0"
   resolved "https://registry.yarnpkg.com/p-pipe/-/p-pipe-1.2.0.tgz#4b1a11399a11520a67790ee5a0c1d5881d6befe9"
@@ -8390,12 +8776,10 @@ p-reduce@^1.0.0:
   resolved "https://registry.yarnpkg.com/p-reduce/-/p-reduce-1.0.0.tgz#18c2b0dd936a4690a529f8231f58a0fdb6a47dfa"
   integrity sha1-GMKw3ZNqRpClKfgjH1ig/bakffo=
 
-p-timeout@^3.1.0:
-  version "3.2.0"
-  resolved "https://registry.yarnpkg.com/p-timeout/-/p-timeout-3.2.0.tgz#c7e17abc971d2a7962ef83626b35d635acf23dfe"
-  integrity sha512-rhIwUycgwwKcP9yTOOFK/AKsAopjjCakVqLHePO3CC6Mir1Z99xT+R63jZxAT5lFZLa2inS5h+ZS2GvR99/FBg==
-  dependencies:
-    p-finally "^1.0.0"
+p-timeout@^5.0.2:
+  version "5.1.0"
+  resolved "https://registry.yarnpkg.com/p-timeout/-/p-timeout-5.1.0.tgz#b3c691cf4415138ce2d9cfe071dba11f0fee085b"
+  integrity sha512-auFDyzzzGZZZdHz3BtET9VEz0SE/uMEAx7uWfGPucfzEwwe/xH0iVeZibQmANYE/hp9T2+UUZT5m+BKyrDp3Ew==
 
 p-try@^1.0.0:
   version "1.0.0"
@@ -8435,6 +8819,13 @@ parent-module@^1.0.0:
   dependencies:
     callsites "^3.0.0"
 
+parent-module@^2.0.0:
+  version "2.0.0"
+  resolved "https://registry.yarnpkg.com/parent-module/-/parent-module-2.0.0.tgz#fa71f88ff1a50c27e15d8ff74e0e3a9523bf8708"
+  integrity sha512-uo0Z9JJeWzv8BG+tRcapBKNJ0dro9cLyczGzulS6EfeyAdeC9sbojtW6XwvYxJkEne9En+J2XEl4zyglVeIwFg==
+  dependencies:
+    callsites "^3.1.0"
+
 parse-github-repo-url@^1.3.0:
   version "1.4.1"
   resolved "https://registry.yarnpkg.com/parse-github-repo-url/-/parse-github-repo-url-1.4.1.tgz#9e7d8bb252a6cb6ba42595060b7bf6df3dbc1f50"
@@ -8582,10 +8973,10 @@ performance-now@^2.1.0:
   resolved "https://registry.yarnpkg.com/performance-now/-/performance-now-2.1.0.tgz#6309f4e0e5fa913ec1c69307ae364b4b377c9e7b"
   integrity sha1-Ywn04OX6kT7BxpMHrjZLSzd8nns=
 
-picocolors@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/picocolors/-/picocolors-1.0.0.tgz#cb5bdc74ff3f51892236eaf79d68bc44564ab81c"
-  integrity sha512-1fygroTLlHu66zi26VoTDv8yRgm0Fccecssto+MhsZ0D/DGW2sm8E8AjW7NU5VVTRt5GxbeZ5qBuJr+HyLYkjQ==
+picocolors@^1.0.0, picocolors@^1.1.1:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/picocolors/-/picocolors-1.1.1.tgz#3d321af3eab939b083c8f929a1d12cda81c26b6b"
+  integrity sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==
 
 picomatch@^2.0.4, picomatch@^2.0.5:
   version "2.2.2"
@@ -8597,6 +8988,11 @@ picomatch@^2.2.3, picomatch@^2.3.1:
   resolved "https://registry.yarnpkg.com/picomatch/-/picomatch-2.3.1.tgz#3ba3833733646d9d3e4995946c1365a67fb07a42"
   integrity sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==
 
+picomatch@^4.0.2:
+  version "4.0.2"
+  resolved "https://registry.yarnpkg.com/picomatch/-/picomatch-4.0.2.tgz#77c742931e8f3b8820946c76cd0c1f13730d1dab"
+  integrity sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg==
+
 pify@^2.0.0, pify@^2.3.0:
   version "2.3.0"
   resolved "https://registry.yarnpkg.com/pify/-/pify-2.3.0.tgz#ed141a6ac043a849ea588498e7dca8b15330e90c"
@@ -8677,15 +9073,6 @@ pretty-format@^29.0.0, pretty-format@^29.7.0:
     ansi-styles "^5.0.0"
     react-is "^18.0.0"
 
-pretty-format@^29.4.1:
-  version "29.4.1"
-  resolved "https://registry.yarnpkg.com/pretty-format/-/pretty-format-29.4.1.tgz#0da99b532559097b8254298da7c75a0785b1751c"
-  integrity sha512-dt/Z761JUVsrIKaY215o1xQJBGlSmTx/h4cSqXqjHLnU1+Kt+mavVE7UgqJJO5ukx5HjSswHfmXz4LjS2oIJfg==
-  dependencies:
-    "@jest/schemas" "^29.4.0"
-    ansi-styles "^5.0.0"
-    react-is "^18.0.0"
-
 process-nextick-args@~2.0.0:
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/process-nextick-args/-/process-nextick-args-2.0.1.tgz#7820d9b16120cc55ca9ae7792680ae7dba6d7fe2"
@@ -8776,6 +9163,11 @@ punycode@^2.1.1:
   resolved "https://registry.yarnpkg.com/punycode/-/punycode-2.1.1.tgz#b58b010ac40c22c5657616c8d2c2c02c7bf479ec"
   integrity sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==
 
+pure-rand@^6.0.0:
+  version "6.1.0"
+  resolved "https://registry.yarnpkg.com/pure-rand/-/pure-rand-6.1.0.tgz#d173cf23258231976ccbdb05247c9787957604f2"
+  integrity sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA==
+
 q@^1.5.1:
   version "1.5.1"
   resolved "https://registry.yarnpkg.com/q/-/q-1.5.1.tgz#7e32f75b41381291d04611f1bf14109ac00651d7"
@@ -8806,11 +9198,6 @@ quick-lru@^4.0.1:
   resolved "https://registry.yarnpkg.com/quick-lru/-/quick-lru-4.0.1.tgz#5b8878f113a58217848c6482026c73e1ba57727f"
   integrity sha512-ARhCpm70fzdcvNQfPoy49IaanKkTlRWF2JMzqhcJbhSFRZv7nPTvZJdcY7301IPmvW+/p0RgIWnQDLJxifsQ7g==
 
-quick-lru@^5.1.1:
-  version "5.1.1"
-  resolved "https://registry.yarnpkg.com/quick-lru/-/quick-lru-5.1.1.tgz#366493e6b3e42a3a6885e2e99d18f80fb7a8c932"
-  integrity sha512-WuyALRjWPDGtt/wzJiadO5AXY+8hZ80hVpe6MyivgraREW751X3SbhRvG3eLKOYN+8VEvqLcf3wdnt44Z4S4SA==
-
 random-bytes@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/random-bytes/-/random-bytes-1.0.0.tgz#4f68a1dc0ae58bd3fb95848c30324db75d64360b"
@@ -8891,15 +9278,6 @@ read-pkg-up@^7.0.1:
     read-pkg "^5.2.0"
     type-fest "^0.8.1"
 
-read-pkg-up@^8.0.0:
-  version "8.0.0"
-  resolved "https://registry.yarnpkg.com/read-pkg-up/-/read-pkg-up-8.0.0.tgz#72f595b65e66110f43b052dd9af4de6b10534670"
-  integrity sha512-snVCqPczksT0HS2EC+SxUndvSzn6LRCwpfSvLrIfR5BKDQQZMaI6jPRC9dYvYFDRAuFEAnkwww8kBBNE/3VvzQ==
-  dependencies:
-    find-up "^5.0.0"
-    read-pkg "^6.0.0"
-    type-fest "^1.0.1"
-
 read-pkg@^1.0.0:
   version "1.1.0"
   resolved "https://registry.yarnpkg.com/read-pkg/-/read-pkg-1.1.0.tgz#f5ffaa5ecd29cb31c0474bca7d756b6bb29e3f28"
@@ -8928,16 +9306,6 @@ read-pkg@^5.2.0:
     parse-json "^5.0.0"
     type-fest "^0.6.0"
 
-read-pkg@^6.0.0:
-  version "6.0.0"
-  resolved "https://registry.yarnpkg.com/read-pkg/-/read-pkg-6.0.0.tgz#a67a7d6a1c2b0c3cd6aa2ea521f40c458a4a504c"
-  integrity sha512-X1Fu3dPuk/8ZLsMhEj5f4wFAF0DWoK7qhGJvgaijocXxBmSToKfbFtqbxMO7bVjNA1dmE5huAzjXj/ey86iw9Q==
-  dependencies:
-    "@types/normalize-package-data" "^2.4.0"
-    normalize-package-data "^3.0.2"
-    parse-json "^5.2.0"
-    type-fest "^1.0.1"
-
 read@1, read@~1.0.1:
   version "1.0.7"
   resolved "https://registry.yarnpkg.com/read/-/read-1.0.7.tgz#b3da19bd052431a97671d44a42634adf710b40c4"
@@ -9001,13 +9369,19 @@ redent@^3.0.0:
     indent-string "^4.0.0"
     strip-indent "^3.0.0"
 
-redent@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.yarnpkg.com/redent/-/redent-4.0.0.tgz#0c0ba7caabb24257ab3bb7a4fd95dd1d5c5681f9"
-  integrity sha512-tYkDkVVtYkSVhuQ4zBgfvciymHaeuel+zFKXShfDnFP5SyVEP7qo70Rf1jTOTCx3vGNAbnEi/xFkcfQVMIBWag==
+reflect.getprototypeof@^1.0.6, reflect.getprototypeof@^1.0.9:
+  version "1.0.10"
+  resolved "https://registry.yarnpkg.com/reflect.getprototypeof/-/reflect.getprototypeof-1.0.10.tgz#c629219e78a3316d8b604c765ef68996964e7bf9"
+  integrity sha512-00o4I+DVrefhv+nX0ulyi3biSHCPDe+yLv5o/p6d/UVlirijB8E16FtfwSAi4g3tcqrQ4lRAqQSoFEZJehYEcw==
   dependencies:
-    indent-string "^5.0.0"
-    strip-indent "^4.0.0"
+    call-bind "^1.0.8"
+    define-properties "^1.2.1"
+    es-abstract "^1.23.9"
+    es-errors "^1.3.0"
+    es-object-atoms "^1.0.0"
+    get-intrinsic "^1.2.7"
+    get-proto "^1.0.1"
+    which-builtin-type "^1.2.1"
 
 regex-not@^1.0.0, regex-not@^1.0.2:
   version "1.0.2"
@@ -9025,15 +9399,17 @@ regexp.prototype.flags@^1.3.0:
     define-properties "^1.1.3"
     es-abstract "^1.17.0-next.1"
 
-regexp.prototype.flags@^1.5.2:
-  version "1.5.2"
-  resolved "https://registry.yarnpkg.com/regexp.prototype.flags/-/regexp.prototype.flags-1.5.2.tgz#138f644a3350f981a858c44f6bb1a61ff59be334"
-  integrity sha512-NcDiDkTLuPR+++OCKB0nWafEmhg/Da8aUPLPMQbK+bxKKCm1/S5he+AqYa4PlMCVBalb4/yxIRub6qkEx5yJbw==
+regexp.prototype.flags@^1.5.3:
+  version "1.5.4"
+  resolved "https://registry.yarnpkg.com/regexp.prototype.flags/-/regexp.prototype.flags-1.5.4.tgz#1ad6c62d44a259007e55b3970e00f746efbcaa19"
+  integrity sha512-dYqgNSZbDwkaJ2ceRd9ojCGjBq+mOm9LmtXnAnEGyHhN/5R7iDW2TRw3h+o/jCFxus3P2LfWIIiwowAjANm7IA==
   dependencies:
-    call-bind "^1.0.6"
+    call-bind "^1.0.8"
     define-properties "^1.2.1"
     es-errors "^1.3.0"
-    set-function-name "^2.0.1"
+    get-proto "^1.0.1"
+    gopd "^1.2.0"
+    set-function-name "^2.0.2"
 
 remove-trailing-separator@^1.0.1:
   version "1.1.0"
@@ -9122,13 +9498,6 @@ resolve-from@^5.0.0:
   resolved "https://registry.yarnpkg.com/resolve-from/-/resolve-from-5.0.0.tgz#c35225843df8f776df21c57557bc087e9dfdfc69"
   integrity sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==
 
-resolve-global@^1.0.0:
-  version "1.0.0"
-  resolved "https://registry.yarnpkg.com/resolve-global/-/resolve-global-1.0.0.tgz#a2a79df4af2ca3f49bf77ef9ddacd322dad19255"
-  integrity sha512-zFa12V4OLtT5XUX/Q4VLvTfBf+Ok0SPc1FNGM/z9ctUdiU618qwKpWnd0CHs3+RqROfyEg/DhuHbMWYqcgljEw==
-  dependencies:
-    global-dirs "^0.1.1"
-
 resolve-pkg-maps@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz#616b3dc2c57056b5588c31cdf4b3d64db133720f"
@@ -9161,11 +9530,11 @@ resolve@^1.18.1, resolve@^1.20.0:
     supports-preserve-symlinks-flag "^1.0.0"
 
 resolve@^1.22.4:
-  version "1.22.8"
-  resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.22.8.tgz#b6c87a9f2aa06dfab52e3d70ac8cde321fa5a48d"
-  integrity sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==
+  version "1.22.10"
+  resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.22.10.tgz#b663e83ffb09bbf2386944736baae803029b8b39"
+  integrity sha512-NPRy+/ncIMeDlTAsuqwKIiferiawhefFJtkNSW0qZJEqMEb+qBt/77B/jGeeek+F0uOeN05CDa6HXbbIgtVX4w==
   dependencies:
-    is-core-module "^2.13.0"
+    is-core-module "^2.16.0"
     path-parse "^1.0.7"
     supports-preserve-symlinks-flag "^1.0.0"
 
@@ -9252,14 +9621,15 @@ rxjs@^6.4.0:
   dependencies:
     tslib "^1.9.0"
 
-safe-array-concat@^1.1.2:
-  version "1.1.2"
-  resolved "https://registry.yarnpkg.com/safe-array-concat/-/safe-array-concat-1.1.2.tgz#81d77ee0c4e8b863635227c721278dd524c20edb"
-  integrity sha512-vj6RsCsWBCf19jIeHEfkRMw8DPiBb+DMXklQ/1SGDHOMlHdPUkZXFQ2YdplS23zESTijAcurb1aSgJA3AgMu1Q==
+safe-array-concat@^1.1.3:
+  version "1.1.3"
+  resolved "https://registry.yarnpkg.com/safe-array-concat/-/safe-array-concat-1.1.3.tgz#c9e54ec4f603b0bbb8e7e5007a5ee7aecd1538c3"
+  integrity sha512-AURm5f0jYEOydBj7VQlVvDrjeFgthDdEF5H1dP+6mNpoXOMo1quQqJ4wvJDyRZ9+pO3kGWoOdmV08cSv2aJV6Q==
   dependencies:
-    call-bind "^1.0.7"
-    get-intrinsic "^1.2.4"
-    has-symbols "^1.0.3"
+    call-bind "^1.0.8"
+    call-bound "^1.0.2"
+    get-intrinsic "^1.2.6"
+    has-symbols "^1.1.0"
     isarray "^2.0.5"
 
 safe-buffer@5.1.2, safe-buffer@~5.1.0, safe-buffer@~5.1.1:
@@ -9272,14 +9642,22 @@ safe-buffer@^5.0.1, safe-buffer@^5.1.0, safe-buffer@^5.1.1, safe-buffer@^5.1.2,
   resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.2.1.tgz#1eaf9fa9bdb1fdd4ec75f58f9cdb4e6b7827eec6"
   integrity sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==
 
-safe-regex-test@^1.0.3:
-  version "1.0.3"
-  resolved "https://registry.yarnpkg.com/safe-regex-test/-/safe-regex-test-1.0.3.tgz#a5b4c0f06e0ab50ea2c395c14d8371232924c377"
-  integrity sha512-CdASjNJPvRa7roO6Ra/gLYBTzYzzPyyBXxIMdGW3USQLyjWEls2RgW5UBTXaQVp+OrpeCK3bLem8smtmheoRuw==
+safe-push-apply@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/safe-push-apply/-/safe-push-apply-1.0.0.tgz#01850e981c1602d398c85081f360e4e6d03d27f5"
+  integrity sha512-iKE9w/Z7xCzUMIZqdBsp6pEQvwuEebH4vdpjcDWnyzaI6yl6O9FHvVpmGelvEHNsoY6wGblkxR6Zty/h00WiSA==
+  dependencies:
+    es-errors "^1.3.0"
+    isarray "^2.0.5"
+
+safe-regex-test@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/safe-regex-test/-/safe-regex-test-1.1.0.tgz#7f87dfb67a3150782eaaf18583ff5d1711ac10c1"
+  integrity sha512-x/+Cz4YrimQxQccJf5mKEbIa1NzeCRNI5Ecl/ekmlYaampdNLPalVyIcCZNNH3MvmqBugV5TMYZXv0ljslUlaw==
   dependencies:
-    call-bind "^1.0.6"
+    call-bound "^1.0.2"
     es-errors "^1.3.0"
-    is-regex "^1.1.4"
+    is-regex "^1.2.1"
 
 safe-regex@^1.1.0:
   version "1.1.0"
@@ -9354,21 +9732,7 @@ semver@^7.3.2:
   resolved "https://registry.yarnpkg.com/semver/-/semver-7.3.2.tgz#604962b052b81ed0786aae84389ffba70ffd3938"
   integrity sha512-OrOb32TeeambH6UrhtShmF7CRDqhL6/5XpPNp2DuRH6+9QLw/orhp72j87v8Qa1ScDkvrrBNpZcDejAirJmfXQ==
 
-semver@^7.3.4:
-  version "7.3.4"
-  resolved "https://registry.yarnpkg.com/semver/-/semver-7.3.4.tgz#27aaa7d2e4ca76452f98d3add093a72c943edc97"
-  integrity sha512-tCfb2WLjqFAtXn4KEdxIhalnRtoKFN7nAwj0B3ZXCbQloV2tq5eDbcTmT68JJD3nRJq24/XgxtQKFIpQdtvmVw==
-  dependencies:
-    lru-cache "^6.0.0"
-
-semver@^7.3.5:
-  version "7.3.8"
-  resolved "https://registry.yarnpkg.com/semver/-/semver-7.3.8.tgz#07a78feafb3f7b32347d725e33de7e2a2df67798"
-  integrity sha512-NB1ctGL5rlHrPJtFDVIVzTyQylMLu9N9VICA6HSFJo8MCGVTMW6gfpicwKmmK/dAjTOrqu5l63JJOpDSrAis3A==
-  dependencies:
-    lru-cache "^6.0.0"
-
-semver@^7.6.0, semver@^7.6.3:
+semver@^7.5.3, semver@^7.5.4, semver@^7.6.0, semver@^7.6.3:
   version "7.6.3"
   resolved "https://registry.yarnpkg.com/semver/-/semver-7.6.3.tgz#980f7b5550bc175fb4dc09403085627f9eb33143"
   integrity sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==
@@ -9378,7 +9742,7 @@ set-blocking@^2.0.0, set-blocking@~2.0.0:
   resolved "https://registry.yarnpkg.com/set-blocking/-/set-blocking-2.0.0.tgz#045f9782d011ae9a6803ddd382b24392b3d890f7"
   integrity sha1-BF+XgtARrppoA93TgrJDkrPYkPc=
 
-set-function-length@^1.2.1:
+set-function-length@^1.2.1, set-function-length@^1.2.2:
   version "1.2.2"
   resolved "https://registry.yarnpkg.com/set-function-length/-/set-function-length-1.2.2.tgz#aac72314198eaed975cf77b2c3b6b880695e5449"
   integrity sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==
@@ -9390,7 +9754,7 @@ set-function-length@^1.2.1:
     gopd "^1.0.1"
     has-property-descriptors "^1.0.2"
 
-set-function-name@^2.0.1:
+set-function-name@^2.0.2:
   version "2.0.2"
   resolved "https://registry.yarnpkg.com/set-function-name/-/set-function-name-2.0.2.tgz#16a705c5a0dc2f5e638ca96d8a8cd4e1c2b90985"
   integrity sha512-7PGFlmtwsEADb0WYyvCMa1t+yke6daIG4Wirafur5kcf+MhUnPms1UeR0CKQdTZD81yESwMHbtn+TR+dMviakQ==
@@ -9400,6 +9764,15 @@ set-function-name@^2.0.1:
     functions-have-names "^1.2.3"
     has-property-descriptors "^1.0.2"
 
+set-proto@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/set-proto/-/set-proto-1.0.0.tgz#0760dbcff30b2d7e801fd6e19983e56da337565e"
+  integrity sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw==
+  dependencies:
+    dunder-proto "^1.0.1"
+    es-errors "^1.3.0"
+    es-object-atoms "^1.0.0"
+
 set-value@^2.0.0, set-value@^2.0.1:
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/set-value/-/set-value-2.0.1.tgz#a18d40530e6f07de4228c7defe4227af8cad005b"
@@ -9454,6 +9827,35 @@ shellwords@^0.1.1:
   resolved "https://registry.yarnpkg.com/shellwords/-/shellwords-0.1.1.tgz#d6b9181c1a48d397324c84871efbcfc73fc0654b"
   integrity sha512-vFwSUfQvqybiICwZY5+DAWIPLKsWO31Q91JSKl3UYv+K5c2QRPzn0qzec6QPu1Qc9eHYItiP3NdJqNVqetYAww==
 
+side-channel-list@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/side-channel-list/-/side-channel-list-1.0.0.tgz#10cb5984263115d3b7a0e336591e290a830af8ad"
+  integrity sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==
+  dependencies:
+    es-errors "^1.3.0"
+    object-inspect "^1.13.3"
+
+side-channel-map@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/side-channel-map/-/side-channel-map-1.0.1.tgz#d6bb6b37902c6fef5174e5f533fab4c732a26f42"
+  integrity sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==
+  dependencies:
+    call-bound "^1.0.2"
+    es-errors "^1.3.0"
+    get-intrinsic "^1.2.5"
+    object-inspect "^1.13.3"
+
+side-channel-weakmap@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz#11dda19d5368e40ce9ec2bdc1fb0ecbc0790ecea"
+  integrity sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==
+  dependencies:
+    call-bound "^1.0.2"
+    es-errors "^1.3.0"
+    get-intrinsic "^1.2.5"
+    object-inspect "^1.13.3"
+    side-channel-map "^1.0.1"
+
 side-channel@^1.0.2:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/side-channel/-/side-channel-1.0.3.tgz#cdc46b057550bbab63706210838df5d4c19519c3"
@@ -9462,15 +9864,16 @@ side-channel@^1.0.2:
     es-abstract "^1.18.0-next.0"
     object-inspect "^1.8.0"
 
-side-channel@^1.0.4:
-  version "1.0.6"
-  resolved "https://registry.yarnpkg.com/side-channel/-/side-channel-1.0.6.tgz#abd25fb7cd24baf45466406b1096b7831c9215f2"
-  integrity sha512-fDW/EZ6Q9RiO8eFG8Hj+7u/oW+XrPTIChwCOM2+th2A6OblDtYYIpve9m+KvI9Z4C9qSEXlaGR6bTEYHReuglA==
+side-channel@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/side-channel/-/side-channel-1.1.0.tgz#c3fcff9c4da932784873335ec9765fa94ff66bc9"
+  integrity sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==
   dependencies:
-    call-bind "^1.0.7"
     es-errors "^1.3.0"
-    get-intrinsic "^1.2.4"
-    object-inspect "^1.13.1"
+    object-inspect "^1.13.3"
+    side-channel-list "^1.0.0"
+    side-channel-map "^1.0.1"
+    side-channel-weakmap "^1.0.2"
 
 signal-exit@^3.0.0, signal-exit@^3.0.2:
   version "3.0.3"
@@ -9715,13 +10118,6 @@ stream-each@^1.1.0:
     end-of-stream "^1.1.0"
     stream-shift "^1.0.0"
 
-stream-events@^1.0.5:
-  version "1.0.5"
-  resolved "https://registry.yarnpkg.com/stream-events/-/stream-events-1.0.5.tgz#bbc898ec4df33a4902d892333d47da9bf1c406d5"
-  integrity sha512-E1GUzBSgvct8Jsb3v2X15pjzN1tYebtbLaMg+eBOUOAxgbLoSbT2NS91ckc5lJD1KfLjId+jXJRgo0qnV5Nerg==
-  dependencies:
-    stubs "^3.0.0"
-
 stream-shift@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/stream-shift/-/stream-shift-1.0.1.tgz#d7088281559ab2778424279b0877da3c392d5a3d"
@@ -9788,15 +10184,18 @@ string.prototype.trim@^1.2.1:
     es-abstract "^1.17.0-next.1"
     function-bind "^1.1.1"
 
-string.prototype.trim@^1.2.9:
-  version "1.2.9"
-  resolved "https://registry.yarnpkg.com/string.prototype.trim/-/string.prototype.trim-1.2.9.tgz#b6fa326d72d2c78b6df02f7759c73f8f6274faa4"
-  integrity sha512-klHuCNxiMZ8MlsOihJhJEBJAiMVqU3Z2nEXWfWnIqjN0gEFS9J9+IxKozWWtQGcgoa1WUZzLjKPTr4ZHNFTFxw==
+string.prototype.trim@^1.2.10:
+  version "1.2.10"
+  resolved "https://registry.yarnpkg.com/string.prototype.trim/-/string.prototype.trim-1.2.10.tgz#40b2dd5ee94c959b4dcfb1d65ce72e90da480c81"
+  integrity sha512-Rs66F0P/1kedk5lyYyH9uBzuiI/kNRmwJAR9quK6VOtIpZ2G+hMZd+HQbbv25MgCA6gEffoMZYxlTod4WcdrKA==
   dependencies:
-    call-bind "^1.0.7"
+    call-bind "^1.0.8"
+    call-bound "^1.0.2"
+    define-data-property "^1.1.4"
     define-properties "^1.2.1"
-    es-abstract "^1.23.0"
+    es-abstract "^1.23.5"
     es-object-atoms "^1.0.0"
+    has-property-descriptors "^1.0.2"
 
 string.prototype.trimend@^1.0.1:
   version "1.0.1"
@@ -9806,12 +10205,13 @@ string.prototype.trimend@^1.0.1:
     define-properties "^1.1.3"
     es-abstract "^1.17.5"
 
-string.prototype.trimend@^1.0.8:
-  version "1.0.8"
-  resolved "https://registry.yarnpkg.com/string.prototype.trimend/-/string.prototype.trimend-1.0.8.tgz#3651b8513719e8a9f48de7f2f77640b26652b229"
-  integrity sha512-p73uL5VCHCO2BZZ6krwwQE3kCzM7NKmis8S//xEC6fQonchbum4eP6kR4DLEjQFO3Wnj3Fuo8NM0kOSjVdHjZQ==
+string.prototype.trimend@^1.0.8, string.prototype.trimend@^1.0.9:
+  version "1.0.9"
+  resolved "https://registry.yarnpkg.com/string.prototype.trimend/-/string.prototype.trimend-1.0.9.tgz#62e2731272cd285041b36596054e9f66569b6942"
+  integrity sha512-G7Ok5C6E/j4SGfyLCloXTrngQIQU3PWtXGst3yM7Bea9FRURf1S42ZHlZZtsNque2FN2PoUhfZXYLNWwEr4dLQ==
   dependencies:
-    call-bind "^1.0.7"
+    call-bind "^1.0.8"
+    call-bound "^1.0.2"
     define-properties "^1.2.1"
     es-object-atoms "^1.0.0"
 
@@ -9927,13 +10327,6 @@ strip-indent@^3.0.0:
   dependencies:
     min-indent "^1.0.0"
 
-strip-indent@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.yarnpkg.com/strip-indent/-/strip-indent-4.0.0.tgz#b41379433dd06f5eae805e21d631e07ee670d853"
-  integrity sha512-mnVSV2l+Zv6BLpSD/8V87CW/y9EmmbYzGCIavsnsI6/nwn26DwffM/yztm30Z/I2DY9wdS3vXVCMnHDgZaVNoA==
-  dependencies:
-    min-indent "^1.0.1"
-
 strip-json-comments@^3.1.1:
   version "3.1.1"
   resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-3.1.1.tgz#31f1281b3832630434831c310c01cccda8cbe006"
@@ -9948,11 +10341,6 @@ strong-log-transformer@^2.0.0:
     minimist "^1.2.0"
     through "^2.3.4"
 
-stubs@^3.0.0:
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/stubs/-/stubs-3.0.0.tgz#e8d2ba1fa9c90570303c030b6900f7d5f89abe5b"
-  integrity sha1-6NK6H6nJBXAwPAMLaQD31fiavls=
-
 supports-color@^5.3.0:
   version "5.5.0"
   resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-5.5.0.tgz#e2e69a44ac8772f78a1ec0b35b689df6530efc8f"
@@ -10023,17 +10411,6 @@ tar@^4.4.10, tar@^4.4.12, tar@^4.4.8:
     safe-buffer "^5.1.2"
     yallist "^3.0.3"
 
-teeny-request@6.0.1:
-  version "6.0.1"
-  resolved "https://registry.yarnpkg.com/teeny-request/-/teeny-request-6.0.1.tgz#9b1f512cef152945827ba7e34f62523a4ce2c5b0"
-  integrity sha512-TAK0c9a00ELOqLrZ49cFxvPVogMUFaWY8dUsQc/0CuQPGF+BOxOQzXfE413BAk2kLomwNplvdtMpeaeGWmoc2g==
-  dependencies:
-    http-proxy-agent "^4.0.0"
-    https-proxy-agent "^4.0.0"
-    node-fetch "^2.2.0"
-    stream-events "^1.0.5"
-    uuid "^3.3.2"
-
 temp-dir@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/temp-dir/-/temp-dir-1.0.0.tgz#0a7c0ea26d3a39afa7e0ebea9c1fc0bc4daa011d"
@@ -10113,6 +10490,14 @@ through@2, "through@>=2.2.7 <3", through@^2.3.4, through@^2.3.6, through@^2.3.8,
   resolved "https://registry.yarnpkg.com/through/-/through-2.3.8.tgz#0dd4c9ffaabc357960b1b724115d7e0e86a2e1f5"
   integrity sha1-DdTJ/6q8NXlgsbckEV1+Doai4fU=
 
+tinyglobby@^0.2.10:
+  version "0.2.10"
+  resolved "https://registry.yarnpkg.com/tinyglobby/-/tinyglobby-0.2.10.tgz#e712cf2dc9b95a1f5c5bbd159720e15833977a0f"
+  integrity sha512-Zc+8eJlFMvgatPZTl6A9L/yht8QqdmUNtURHaKZLmKBE12hNPSrqNkUp2cs3M/UKmNVVAMFQYSjYIVHDjW5zew==
+  dependencies:
+    fdir "^6.4.2"
+    picomatch "^4.0.2"
+
 tmp@^0.0.33:
   version "0.0.33"
   resolved "https://registry.yarnpkg.com/tmp/-/tmp-0.0.33.tgz#6d34335889768d21b2bcda0aa277ced3b1bfadf9"
@@ -10192,11 +10577,6 @@ trim-newlines@^3.0.0:
   resolved "https://registry.yarnpkg.com/trim-newlines/-/trim-newlines-3.0.0.tgz#79726304a6a898aa8373427298d54c2ee8b1cb30"
   integrity sha512-C4+gOpvmxaSMKuEf9Qc134F1ZuOHVXKRbtEflf4NTtuuJDEIJ9p5PXsalL8SkeRw+qit1Mo+yuvMPAKwWg/1hA==
 
-trim-newlines@^4.0.2:
-  version "4.0.2"
-  resolved "https://registry.yarnpkg.com/trim-newlines/-/trim-newlines-4.0.2.tgz#d6aaaf6a0df1b4b536d183879a6b939489808c7c"
-  integrity sha512-GJtWyq9InR/2HRiLZgpIKv+ufIKrVrvjQWEj7PxAXNc5dwbNJkqhAUoAGgzRmULAnoOM5EIpveYd3J2VeSAIew==
-
 trim-off-newlines@^1.0.0:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/trim-off-newlines/-/trim-off-newlines-1.0.1.tgz#9f9ba9d9efa8764c387698bcbfeb2c848f11adb3"
@@ -10227,10 +10607,10 @@ tslib@^2.3.1:
   resolved "https://registry.yarnpkg.com/tslib/-/tslib-2.6.2.tgz#703ac29425e7b37cd6fd456e92404d46d1f3e4ae"
   integrity sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q==
 
-tsx@^4.7.2:
-  version "4.17.0"
-  resolved "https://registry.yarnpkg.com/tsx/-/tsx-4.17.0.tgz#6ffd9851a0c7aa4ecacf4dc19f28d82112af25c5"
-  integrity sha512-eN4mnDA5UMKDt4YZixo9tBioibaMBpoxBkD+rIPAjVmYERSG0/dWEY1CEFuV89CgASlKL499q8AhmkMnnjtOJg==
+tsx@^4.19.2:
+  version "4.19.2"
+  resolved "https://registry.yarnpkg.com/tsx/-/tsx-4.19.2.tgz#2d7814783440e0ae42354d0417d9c2989a2ae92c"
+  integrity sha512-pOUl6Vo2LUq/bSa8S5q7b91cgNSjctn9ugq/+Mvow99qW6x/UZYwzxy/3NmqoT66eHYfCVvFvACC58UBPFf28g==
   dependencies:
     esbuild "~0.23.0"
     get-tsconfig "^4.7.5"
@@ -10291,54 +10671,50 @@ type-fest@^0.8.1:
   resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.8.1.tgz#09e249ebde851d3b1e48d27c105444667f17b83d"
   integrity sha512-4dbzIzqvjtgiM5rw1k5rEHtBANKmdudhGyBEajN01fEyhaAIhsoKNy6y7+IN93IfpFtwY9iqi7kD+xwKhQsNJA==
 
-type-fest@^1.0.1, type-fest@^1.2.1, type-fest@^1.2.2:
-  version "1.4.0"
-  resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-1.4.0.tgz#e9fb813fe3bf1744ec359d55d1affefa76f14be1"
-  integrity sha512-yGSza74xk0UG8k+pLh5oeoYirvIiWo5t0/o3zHHAO2tRDiZcxWP7fywNlXhqb6/r6sWvwi+RsyQMWhVLe4BVuA==
-
-typed-array-buffer@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/typed-array-buffer/-/typed-array-buffer-1.0.2.tgz#1867c5d83b20fcb5ccf32649e5e2fc7424474ff3"
-  integrity sha512-gEymJYKZtKXzzBzM4jqa9w6Q1Jjm7x2d+sh19AdsD4wqnMPDYyvwpsIc2Q/835kHuo3BEQ7CjelGhfTsoBb2MQ==
+typed-array-buffer@^1.0.3:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/typed-array-buffer/-/typed-array-buffer-1.0.3.tgz#a72395450a4869ec033fd549371b47af3a2ee536"
+  integrity sha512-nAYYwfY3qnzX30IkA6AQZjVbtK6duGontcQm1WSG1MD94YLqK0515GNApXkoxKOWMusVssAHWLh9SeaoefYFGw==
   dependencies:
-    call-bind "^1.0.7"
+    call-bound "^1.0.3"
     es-errors "^1.3.0"
-    is-typed-array "^1.1.13"
+    is-typed-array "^1.1.14"
 
-typed-array-byte-length@^1.0.1:
-  version "1.0.1"
-  resolved "https://registry.yarnpkg.com/typed-array-byte-length/-/typed-array-byte-length-1.0.1.tgz#d92972d3cff99a3fa2e765a28fcdc0f1d89dec67"
-  integrity sha512-3iMJ9q0ao7WE9tWcaYKIptkNBuOIcZCCT0d4MRvuuH88fEoEH62IuQe0OtraD3ebQEoTRk8XCBoknUNc1Y67pw==
+typed-array-byte-length@^1.0.3:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/typed-array-byte-length/-/typed-array-byte-length-1.0.3.tgz#8407a04f7d78684f3d252aa1a143d2b77b4160ce"
+  integrity sha512-BaXgOuIxz8n8pIq3e7Atg/7s+DpiYrxn4vdot3w9KbnBhcRQq6o3xemQdIfynqSeXeDrF32x+WvfzmOjPiY9lg==
   dependencies:
-    call-bind "^1.0.7"
+    call-bind "^1.0.8"
     for-each "^0.3.3"
-    gopd "^1.0.1"
-    has-proto "^1.0.3"
-    is-typed-array "^1.1.13"
+    gopd "^1.2.0"
+    has-proto "^1.2.0"
+    is-typed-array "^1.1.14"
 
-typed-array-byte-offset@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/typed-array-byte-offset/-/typed-array-byte-offset-1.0.2.tgz#f9ec1acb9259f395093e4567eb3c28a580d02063"
-  integrity sha512-Ous0vodHa56FviZucS2E63zkgtgrACj7omjwd/8lTEMEPFFyjfixMZ1ZXenpgCFBBt4EC1J2XsyVS2gkG0eTFA==
+typed-array-byte-offset@^1.0.4:
+  version "1.0.4"
+  resolved "https://registry.yarnpkg.com/typed-array-byte-offset/-/typed-array-byte-offset-1.0.4.tgz#ae3698b8ec91a8ab945016108aef00d5bff12355"
+  integrity sha512-bTlAFB/FBYMcuX81gbL4OcpH5PmlFHqlCCpAl8AlEzMz5k53oNDvN8p1PNOWLEmI2x4orp3raOFB51tv9X+MFQ==
   dependencies:
     available-typed-arrays "^1.0.7"
-    call-bind "^1.0.7"
+    call-bind "^1.0.8"
     for-each "^0.3.3"
-    gopd "^1.0.1"
-    has-proto "^1.0.3"
-    is-typed-array "^1.1.13"
+    gopd "^1.2.0"
+    has-proto "^1.2.0"
+    is-typed-array "^1.1.15"
+    reflect.getprototypeof "^1.0.9"
 
-typed-array-length@^1.0.6:
-  version "1.0.6"
-  resolved "https://registry.yarnpkg.com/typed-array-length/-/typed-array-length-1.0.6.tgz#57155207c76e64a3457482dfdc1c9d1d3c4c73a3"
-  integrity sha512-/OxDN6OtAk5KBpGb28T+HZc2M+ADtvRxXrKKbUwtsLgdoxgX13hyy7ek6bFRl5+aBs2yZzB0c4CnQfAtVypW/g==
+typed-array-length@^1.0.7:
+  version "1.0.7"
+  resolved "https://registry.yarnpkg.com/typed-array-length/-/typed-array-length-1.0.7.tgz#ee4deff984b64be1e118b0de8c9c877d5ce73d3d"
+  integrity sha512-3KS2b+kL7fsuk/eJZ7EQdnEmQoaho/r6KUef7hxvltNA5DR8NAUM+8wJMbJyZ4G9/7i3v5zPBIMN5aybAh2/Jg==
   dependencies:
     call-bind "^1.0.7"
     for-each "^0.3.3"
     gopd "^1.0.1"
-    has-proto "^1.0.3"
     is-typed-array "^1.1.13"
     possible-typed-array-names "^1.0.0"
+    reflect.getprototypeof "^1.0.6"
 
 typedarray-to-buffer@^3.1.5:
   version "3.1.5"
@@ -10357,15 +10733,10 @@ typeforce@^1.18.0:
   resolved "https://registry.yarnpkg.com/typeforce/-/typeforce-1.18.0.tgz#d7416a2c5845e085034d70fcc5b6cc4a90edbfdc"
   integrity sha512-7uc1O8h1M1g0rArakJdf0uLRSSgFcYexrVoKo+bzJd32gd4gDy2L/Z+8/FjPnU9ydY3pEnVPtr9FyscYY60K1g==
 
-typescript@^4.9.5:
-  version "4.9.5"
-  resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.9.5.tgz#095979f9bcc0d09da324d58d03ce8f8374cbe65a"
-  integrity sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==
-
-typescript@^5.5.4:
-  version "5.5.4"
-  resolved "https://registry.yarnpkg.com/typescript/-/typescript-5.5.4.tgz#d9852d6c82bad2d2eda4fd74a5762a8f5909e9ba"
-  integrity sha512-Mtq29sKDAEYP7aljRgtPOpTvOfbwRWlS6dPRzwjdE+C0R4brX/GUyhHSecbHMFLNBLcJIPt9nl9yG5TZ1weH+Q==
+typescript@^5.7.3:
+  version "5.7.3"
+  resolved "https://registry.yarnpkg.com/typescript/-/typescript-5.7.3.tgz#919b44a7dbb8583a9b856d162be24a54bf80073e"
+  integrity sha512-84MVSjMEHP+FQRPy3pX9sTVV/INIex71s9TL2Gm5FG/WG1SqXeKyZ0k7/blY/4FdOzI12CBy1vGc4og/eus0fw==
 
 uglify-js@^3.1.4:
   version "3.10.2"
@@ -10382,25 +10753,20 @@ umask@^1.1.0:
   resolved "https://registry.yarnpkg.com/umask/-/umask-1.1.0.tgz#f29cebf01df517912bb58ff9c4e50fde8e33320d"
   integrity sha1-8pzr8B31F5ErtY/5xOUP3o4zMg0=
 
-unbox-primitive@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/unbox-primitive/-/unbox-primitive-1.0.2.tgz#29032021057d5e6cdbd08c5129c226dff8ed6f9e"
-  integrity sha512-61pPlCD9h51VoreyJ0BReideM3MDKMKnh6+V9L08331ipq6Q8OFXZYiqP6n/tbHx4s5I9uRhcye6BrbkizkBDw==
+unbox-primitive@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/unbox-primitive/-/unbox-primitive-1.1.0.tgz#8d9d2c9edeea8460c7f35033a88867944934d1e2"
+  integrity sha512-nWJ91DjeOkej/TA8pXQ3myruKpKEYgqvpw9lz4OPHj/NWFNluYrjbz9j01CJ8yKQd2g4jFoOkINCTW2I5LEEyw==
   dependencies:
-    call-bind "^1.0.2"
+    call-bound "^1.0.3"
     has-bigints "^1.0.2"
-    has-symbols "^1.0.3"
-    which-boxed-primitive "^1.0.2"
-
-undici-types@~5.26.4:
-  version "5.26.5"
-  resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-5.26.5.tgz#bcd539893d00b56e964fd2657a4866b221a65617"
-  integrity sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==
+    has-symbols "^1.1.0"
+    which-boxed-primitive "^1.1.1"
 
-undici-types@~6.13.0:
-  version "6.13.0"
-  resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-6.13.0.tgz#e3e79220ab8c81ed1496b5812471afd7cf075ea5"
-  integrity sha512-xtFJHudx8S2DSoujjMd1WeWvn7KKWFRESZTMeL1RptAYERu29D6jphMjjY+vn96jvN3kVPDNxU/E13VTaXj6jg==
+undici-types@~6.20.0:
+  version "6.20.0"
+  resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-6.20.0.tgz#8171bf22c1f588d1554d55bf204bc624af388433"
+  integrity sha512-Ny6QZ2Nju20vw1SRHe3d9jVu6gJ+4e3+MMpqu7pqE5HT6WsTSlce++GQmK5UXS8mzV8DSYHrQH+Xrf2jVcuKNg==
 
 union-value@^1.0.0:
   version "1.0.1"
@@ -10426,13 +10792,6 @@ unique-slug@^2.0.0:
   dependencies:
     imurmurhash "^0.1.4"
 
-unique-string@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/unique-string/-/unique-string-2.0.0.tgz#39c6451f81afb2749de2b233e3f7c5e8843bd89d"
-  integrity sha512-uNaeirEPvpZWSgzwsPGtU2zVSTrn/8L5q/IexZmH0eH6SA73CmAA5U4GwORTxQAZs95TAXLNqeLoPPNO5gZfWg==
-  dependencies:
-    crypto-random-string "^2.0.0"
-
 universal-user-agent@^4.0.0:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/universal-user-agent/-/universal-user-agent-4.0.1.tgz#fd8d6cb773a679a709e967ef8288a31fcc03e557"
@@ -10450,11 +10809,6 @@ universalify@^0.1.0:
   resolved "https://registry.yarnpkg.com/universalify/-/universalify-0.1.2.tgz#b646f69be3942dabcecc9d6639c80dc105efaa66"
   integrity sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==
 
-universalify@^2.0.0:
-  version "2.0.0"
-  resolved "https://registry.yarnpkg.com/universalify/-/universalify-2.0.0.tgz#75a4984efedc4b08975c5aeb73f530d02df25717"
-  integrity sha512-hAZsKq7Yy11Zu1DE0OzWjw7nnLZmJZYTDZZyEFHZdUhV8FkH5MCfoU1XMaxXovpyW5nq5scPqq0ZDP9Zyl04oQ==
-
 unset-value@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/unset-value/-/unset-value-1.0.0.tgz#8376873f7d2335179ffb1e6fc3a8ed0dfc8ab559"
@@ -10476,6 +10830,14 @@ update-browserslist-db@^1.0.10:
     escalade "^3.1.1"
     picocolors "^1.0.0"
 
+update-browserslist-db@^1.1.1:
+  version "1.1.2"
+  resolved "https://registry.yarnpkg.com/update-browserslist-db/-/update-browserslist-db-1.1.2.tgz#97e9c96ab0ae7bcac08e9ae5151d26e6bc6b5580"
+  integrity sha512-PPypAm5qvlD7XMZC3BujecnaOxwhrtoFR+Dqkk5Aa/6DssiH0ibKoketaj9w8LP7Bont1rYeoV5plxD7RTEPRg==
+  dependencies:
+    escalade "^3.2.0"
+    picocolors "^1.1.1"
+
 uri-js@^4.2.2:
   version "4.4.1"
   resolved "https://registry.yarnpkg.com/uri-js/-/uri-js-4.4.1.tgz#9b1a52595225859e55f669d928f88c6c57f2a77e"
@@ -10493,11 +10855,6 @@ url-join@^5.0.0:
   resolved "https://registry.yarnpkg.com/url-join/-/url-join-5.0.0.tgz#c2f1e5cbd95fa91082a93b58a1f42fecb4bdbcf1"
   integrity sha512-n2huDr9h9yzd6exQVnH/jU5mr+Pfx08LRXXZhkLLetAMESRj+anQsTAh940iMrIetKAmry9coFuZQ2jY8/p3WA==
 
-urlgrey@0.4.4:
-  version "0.4.4"
-  resolved "https://registry.yarnpkg.com/urlgrey/-/urlgrey-0.4.4.tgz#892fe95960805e85519f1cd4389f2cb4cbb7652f"
-  integrity sha1-iS/pWWCAXoVRnxzUOJ8stMu3ZS8=
-
 use@^3.1.0:
   version "3.1.1"
   resolved "https://registry.yarnpkg.com/use/-/use-3.1.1.tgz#d50c8cac79a19fbc20f2911f56eb973f4e10070f"
@@ -10574,10 +10931,15 @@ verror@1.10.0:
     core-util-is "1.0.2"
     extsprintf "^1.2.0"
 
-vscode-uri@^3.0.2:
-  version "3.0.2"
-  resolved "https://registry.yarnpkg.com/vscode-uri/-/vscode-uri-3.0.2.tgz#ecfd1d066cb8ef4c3a208decdbab9a8c23d055d0"
-  integrity sha512-jkjy6pjU1fxUvI51P+gCsxg1u2n8LSt0W6KrCNQceaziKzff74GoWmjVG46KieVzybO1sttPQmYfrwSHey7GUA==
+vscode-languageserver-textdocument@^1.0.12:
+  version "1.0.12"
+  resolved "https://registry.yarnpkg.com/vscode-languageserver-textdocument/-/vscode-languageserver-textdocument-1.0.12.tgz#457ee04271ab38998a093c68c2342f53f6e4a631"
+  integrity sha512-cxWNPesCnQCcMPeenjKKsOCKQZ/L6Tv19DTRIGuLWe32lyzWhihGVJ/rcckZXJxfdKCFvRLS3fpBIsV/ZGX4zA==
+
+vscode-uri@^3.0.8:
+  version "3.0.8"
+  resolved "https://registry.yarnpkg.com/vscode-uri/-/vscode-uri-3.0.8.tgz#1770938d3e72588659a172d0fd4642780083ff9f"
+  integrity sha512-AyFQ0EVmsOZOlAnxoFOGOq1SQDWAB7C6aqMGS23svWAllfOaxbuFvcT8D1i8z3Gyn8fraVeZNNmN6e9bxxXkKw==
 
 walker@^1.0.7, walker@^1.0.8, walker@~1.0.5:
   version "1.0.8"
@@ -10618,16 +10980,35 @@ which-boxed-primitive@^1.0.1:
     is-string "^1.0.4"
     is-symbol "^1.0.2"
 
-which-boxed-primitive@^1.0.2:
-  version "1.0.2"
-  resolved "https://registry.yarnpkg.com/which-boxed-primitive/-/which-boxed-primitive-1.0.2.tgz#13757bc89b209b049fe5d86430e21cf40a89a8e6"
-  integrity sha512-bwZdv0AKLpplFY2KZRX6TvyuN7ojjr7lwkg6ml0roIy9YeuSr7JS372qlNW18UQYzgYK9ziGcerWqZOmEn9VNg==
+which-boxed-primitive@^1.1.0, which-boxed-primitive@^1.1.1:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/which-boxed-primitive/-/which-boxed-primitive-1.1.1.tgz#d76ec27df7fa165f18d5808374a5fe23c29b176e"
+  integrity sha512-TbX3mj8n0odCBFVlY8AxkqcHASw3L60jIuF8jFP78az3C2YhmGvqbHBpAjTRH2/xqYunrJ9g1jSyjCjpoWzIAA==
   dependencies:
-    is-bigint "^1.0.1"
-    is-boolean-object "^1.1.0"
-    is-number-object "^1.0.4"
-    is-string "^1.0.5"
-    is-symbol "^1.0.3"
+    is-bigint "^1.1.0"
+    is-boolean-object "^1.2.1"
+    is-number-object "^1.1.1"
+    is-string "^1.1.1"
+    is-symbol "^1.1.1"
+
+which-builtin-type@^1.2.1:
+  version "1.2.1"
+  resolved "https://registry.yarnpkg.com/which-builtin-type/-/which-builtin-type-1.2.1.tgz#89183da1b4907ab089a6b02029cc5d8d6574270e"
+  integrity sha512-6iBczoX+kDQ7a3+YJBnh3T+KZRxM/iYNPXicqk66/Qfm1b93iu+yOImkg0zHbj5LNOcNv1TEADiZ0xa34B4q6Q==
+  dependencies:
+    call-bound "^1.0.2"
+    function.prototype.name "^1.1.6"
+    has-tostringtag "^1.0.2"
+    is-async-function "^2.0.0"
+    is-date-object "^1.1.0"
+    is-finalizationregistry "^1.1.0"
+    is-generator-function "^1.0.10"
+    is-regex "^1.2.1"
+    is-weakref "^1.0.2"
+    isarray "^2.0.5"
+    which-boxed-primitive "^1.1.0"
+    which-collection "^1.0.2"
+    which-typed-array "^1.1.16"
 
 which-collection@^1.0.1:
   version "1.0.1"
@@ -10639,20 +11020,31 @@ which-collection@^1.0.1:
     is-weakmap "^2.0.1"
     is-weakset "^2.0.1"
 
+which-collection@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/which-collection/-/which-collection-1.0.2.tgz#627ef76243920a107e7ce8e96191debe4b16c2a0"
+  integrity sha512-K4jVyjnBdgvc86Y6BkaLZEN933SwYOuBFkdmBu9ZfkcAbdVbpITnDmjvZ/aQjRXQrv5EPkTnD1s39GiiqbngCw==
+  dependencies:
+    is-map "^2.0.3"
+    is-set "^2.0.3"
+    is-weakmap "^2.0.2"
+    is-weakset "^2.0.3"
+
 which-module@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/which-module/-/which-module-2.0.0.tgz#d9ef07dce77b9902b8a3a8fa4b31c3e3f7e6e87a"
   integrity sha1-2e8H3Od7mQK4o6j6SzHD4/fm6Ho=
 
-which-typed-array@^1.1.14, which-typed-array@^1.1.15:
-  version "1.1.15"
-  resolved "https://registry.yarnpkg.com/which-typed-array/-/which-typed-array-1.1.15.tgz#264859e9b11a649b388bfaaf4f767df1f779b38d"
-  integrity sha512-oV0jmFtUky6CXfkqehVvBP/LSWJ2sy4vWMioiENyJLePrBO/yKyV9OyJySfAKosh+RYkIl5zJCNZ8/4JncrpdA==
+which-typed-array@^1.1.16, which-typed-array@^1.1.18:
+  version "1.1.18"
+  resolved "https://registry.yarnpkg.com/which-typed-array/-/which-typed-array-1.1.18.tgz#df2389ebf3fbb246a71390e90730a9edb6ce17ad"
+  integrity sha512-qEcY+KJYlWyLH9vNbsr6/5j59AXk5ni5aakf8ldzBvGde6Iz4sxZGkJyWSAueTG7QhOvNRYb1lDdFmL5Td0QKA==
   dependencies:
     available-typed-arrays "^1.0.7"
-    call-bind "^1.0.7"
+    call-bind "^1.0.8"
+    call-bound "^1.0.3"
     for-each "^0.3.3"
-    gopd "^1.0.1"
+    gopd "^1.2.0"
     has-tostringtag "^1.0.2"
 
 which-typed-array@^1.1.2:
@@ -10754,10 +11146,10 @@ write-file-atomic@^3.0.0:
     signal-exit "^3.0.2"
     typedarray-to-buffer "^3.1.5"
 
-write-file-atomic@^5.0.0:
-  version "5.0.0"
-  resolved "https://registry.yarnpkg.com/write-file-atomic/-/write-file-atomic-5.0.0.tgz#54303f117e109bf3d540261125c8ea5a7320fab0"
-  integrity sha512-R7NYMnHSlV42K54lwY9lvW6MnSm1HSJqZL3xiSgi9E7//FYaI74r2G0rd+/X6VAMkHEdzxQaU5HUOXWUz5kA/w==
+write-file-atomic@^4.0.2:
+  version "4.0.2"
+  resolved "https://registry.yarnpkg.com/write-file-atomic/-/write-file-atomic-4.0.2.tgz#a9df01ae5b77858a027fd2e80768ee433555fcfd"
+  integrity sha512-7KxauUdBmSdWnmpaGFg+ppNjKF8uNLry8LyzjauQDOVONfFLNKrKvQOxZ/VuTIcS/gge/YNahf5RIIQWTSarlg==
   dependencies:
     imurmurhash "^0.1.4"
     signal-exit "^3.0.7"
@@ -10799,10 +11191,10 @@ ws@^7.5.2:
   resolved "https://registry.yarnpkg.com/ws/-/ws-7.5.9.tgz#54fa7db29f4c7cec68b1ddd3a89de099942bb591"
   integrity sha512-F+P9Jil7UiSKSkppIiD94dN07AwvFixvLIj1Og1Rl9GGMuNipJnV9JzjD6XuqmAeiswGvUmNLjr5cFuXwNS77Q==
 
-xdg-basedir@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.yarnpkg.com/xdg-basedir/-/xdg-basedir-4.0.0.tgz#4bc8d9984403696225ef83a1573cbbcb4e79db13"
-  integrity sha512-PSNhEJDejZYV7h50BohL09Er9VaIefr2LMAf3OEmpCkjOi34eYyQYAXUTjEQtZJTKcF0E2UKTh+osDLsgNim9Q==
+xdg-basedir@^5.1.0:
+  version "5.1.0"
+  resolved "https://registry.yarnpkg.com/xdg-basedir/-/xdg-basedir-5.1.0.tgz#1efba19425e73be1bc6f2a6ceb52a3d2c884c0c9"
+  integrity sha512-GCPAHLvrIH13+c0SuacwvRYj2SxJXQ4kaVTT5xgL3kPrz56XxkF21IGhjSE1+W0aw7gpBWRGXLCPnPby6lSpmQ==
 
 xtend@~4.0.1:
   version "4.0.2"
@@ -10824,15 +11216,10 @@ yallist@^3.0.0, yallist@^3.0.2, yallist@^3.0.3:
   resolved "https://registry.yarnpkg.com/yallist/-/yallist-3.1.1.tgz#dbb7daf9bfd8bac9ab45ebf602b8cbad0d5d08fd"
   integrity sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==
 
-yallist@^4.0.0:
-  version "4.0.0"
-  resolved "https://registry.yarnpkg.com/yallist/-/yallist-4.0.0.tgz#9bb92790d9c0effec63be73519e11a35019a3a72"
-  integrity sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==
-
-yaml@^1.10.0:
-  version "1.10.0"
-  resolved "https://registry.yarnpkg.com/yaml/-/yaml-1.10.0.tgz#3b593add944876077d4d683fee01081bd9fff31e"
-  integrity sha512-yr2icI4glYaNG+KWONODapy2/jDdMSDnrONSjblABjD9B4Z5LgiircSt8m8sRZFNi08kG9Sm0uSHtEmP3zaEGg==
+yaml@^2.7.0:
+  version "2.7.0"
+  resolved "https://registry.yarnpkg.com/yaml/-/yaml-2.7.0.tgz#aef9bb617a64c937a9a748803786ad8d3ffe1e98"
+  integrity sha512-+hSoy/QHluxmC9kCIJyL/uyFmLmc+e5CFR5Wa+bpIhIj85LVb9ZH2nVnqrHoSvKogwODv0ClqZkmiSSaIH5LTA==
 
 yargs-parser@^15.0.1:
   version "15.0.1"
@@ -10850,11 +11237,6 @@ yargs-parser@^18.1.3:
     camelcase "^5.0.0"
     decamelize "^1.2.0"
 
-yargs-parser@^20.2.9:
-  version "20.2.9"
-  resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-20.2.9.tgz#2eb7dc3b0289718fc295f362753845c41a0c94ee"
-  integrity sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==
-
 yargs-parser@^21.1.1:
   version "21.1.1"
   resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-21.1.1.tgz#9096bceebf990d21bb31fa9516e0ede294a77d35"

From e8a3ecf1d5c839081b1c4224fe7687f64a8301c0 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 24 Jan 2025 22:16:07 +0100
Subject: [PATCH 175/267] remove empty subtitle

---
 website/docs/sdk/instantiation.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 1917d4f7..9a701218 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -54,8 +54,6 @@ const options = { provider, addressType}
 const contract = new Contract(P2PKH, contractArguments, options);
 ```
 
-### TypeScript Typings
-
 ## Contract Properties
 
 ### address

From 169148520878b2aa5b5e163443c00c5e9325ff59 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Sat, 25 Jan 2025 15:46:14 +0100
Subject: [PATCH 176/267] update telegram link on website

---
 website/docusaurus.config.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
index ffef06c8..a2f73e86 100755
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@@ -54,7 +54,7 @@ module.exports = {
           items: [
             {
               label: 'Telegram',
-              href: 'https://t.me/bch_compilers',
+              href: 'https://t.me/CashScriptBCH',
             },
             {
               label: 'Showcase',

From f19516f5e4cbdf5b7b5cf409a5b48b074e10d622 Mon Sep 17 00:00:00 2001
From: "cypherpunk.bch" <kuldeepbb.grewal@gmail.com>
Date: Thu, 27 Feb 2025 14:20:36 +0530
Subject: [PATCH 177/267] Multi Contract and debugging support for Advanced
 Transaction Builder (#257)

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
Co-authored-by: Mathieu Geukens <mr-zwets@protonmail.com>
---
 examples/common-js.js                         |    1 +
 packages/cashscript/package.json              |    2 +
 packages/cashscript/src/Contract.ts           |    2 +-
 packages/cashscript/src/Errors.ts             |   12 +
 packages/cashscript/src/LibauthTemplate.ts    |   77 +-
 packages/cashscript/src/SignatureTemplate.ts  |    1 +
 packages/cashscript/src/Transaction.ts        |    6 +-
 packages/cashscript/src/TransactionBuilder.ts |  394 ++---
 .../src/advanced/LibauthTemplate.ts           |  575 +++++++
 packages/cashscript/src/debugging.ts          |   66 +-
 packages/cashscript/src/interfaces.ts         |    8 +
 .../src/network/ElectrumNetworkProvider.ts    |    2 +-
 .../cashscript/src/test/JestExtensions.ts     |   18 +-
 packages/cashscript/src/utils.ts              |   43 +-
 .../TransactionBuilder.test.ts                |  189 ++-
 packages/cashscript/test/debugging.test.ts    |  700 +++-----
 .../cashscript/test/e2e/Announcement.test.ts  |   85 +-
 packages/cashscript/test/e2e/BigInt.test.ts   |   66 +-
 .../cashscript/test/e2e/HodlVault.test.ts     |   41 +-
 packages/cashscript/test/e2e/Mecenas.test.ts  |   92 +-
 .../cashscript/test/e2e/MultiContract.test.ts |  184 +++
 packages/cashscript/test/e2e/P2PKH.test.ts    |  176 +-
 .../test/e2e/TokenCategoryCheck.test.ts       |   71 +-
 .../test/e2e/TransferWithTimeout.test.ts      |   67 +-
 packages/cashscript/test/e2e/misc.test.ts     |   65 -
 .../test/e2e/misc/timelocks.test.ts           |   92 ++
 .../test/e2e/network/FullStack.test.ts        |    6 +-
 .../cashscript/test/fixture/Bar.artifact.ts   |   70 +
 packages/cashscript/test/fixture/Bar.cash     |   17 +
 packages/cashscript/test/fixture/Bar.json     |   70 +
 .../cashscript/test/fixture/Foo.artifact.ts   |   54 +
 packages/cashscript/test/fixture/Foo.cash     |   10 +
 packages/cashscript/test/fixture/Foo.json     |   54 +
 .../test/fixture/bigint.artifact.ts           |   12 +-
 packages/cashscript/test/fixture/bigint.cash  |    6 +-
 packages/cashscript/test/fixture/bigint.json  |   12 +-
 .../fixture/debugging/debugging_contracts.ts  |  279 ++++
 .../test/fixture/libauth-template/fixtures.ts |  208 +--
 .../multi-contract-fixtures.ts                | 1426 +++++++++++++++++
 .../test/fixture/simple_covenant.artifact.ts  |   48 -
 .../test/fixture/simple_covenant.cash         |   10 -
 .../test/fixture/simple_covenant.json         |   48 -
 packages/cashscript/test/fixture/vars.ts      |    3 +
 .../LibauthTemplateMultiContract.test.ts      |   13 +
 packages/cashscript/test/test-util.ts         |   39 +
 yarn.lock                                     |   12 +
 46 files changed, 4018 insertions(+), 1414 deletions(-)
 create mode 100644 packages/cashscript/src/advanced/LibauthTemplate.ts
 rename packages/cashscript/test/{e2e/transaction-builder => }/TransactionBuilder.test.ts (50%)
 create mode 100644 packages/cashscript/test/e2e/MultiContract.test.ts
 delete mode 100644 packages/cashscript/test/e2e/misc.test.ts
 create mode 100644 packages/cashscript/test/e2e/misc/timelocks.test.ts
 create mode 100644 packages/cashscript/test/fixture/Bar.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/Bar.cash
 create mode 100644 packages/cashscript/test/fixture/Bar.json
 create mode 100644 packages/cashscript/test/fixture/Foo.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/Foo.cash
 create mode 100644 packages/cashscript/test/fixture/Foo.json
 create mode 100644 packages/cashscript/test/fixture/debugging/debugging_contracts.ts
 create mode 100644 packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
 delete mode 100644 packages/cashscript/test/fixture/simple_covenant.artifact.ts
 delete mode 100644 packages/cashscript/test/fixture/simple_covenant.cash
 delete mode 100644 packages/cashscript/test/fixture/simple_covenant.json
 create mode 100644 packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts

diff --git a/examples/common-js.js b/examples/common-js.js
index 722eebcc..a7913f1b 100644
--- a/examples/common-js.js
+++ b/examples/common-js.js
@@ -21,3 +21,4 @@ export const alicePub = secp256k1.derivePublicKeyCompressed(aliceNode.privateKey
 export const alicePriv = aliceNode.privateKey;
 export const alicePkh = hash160(alicePub);
 export const aliceAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkh', payload: alicePkh, throwErrors: true }).address;
+export const aliceTokenAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkhWithTokens', payload: alicePkh, throwErrors: true }).address;
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index b725ea8b..e94301b4 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -46,6 +46,7 @@
     "@bitauth/libauth": "^3.1.0-next.2",
     "@cashscript/utils": "^0.11.0-next.0",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
+    "change-case": "^5.4.4",
     "delay": "^6.0.0",
     "electrum-cash": "^2.0.10",
     "fast-deep-equal": "^3.1.3",
@@ -55,6 +56,7 @@
   "devDependencies": {
     "@jest/globals": "^29.7.0",
     "@psf/bch-js": "^6.8.0",
+    "@types/change-case": "^2.3.5",
     "@types/pako": "^2.0.3",
     "@types/semver": "^7.5.8",
     "eslint": "^8.54.0",
diff --git a/packages/cashscript/src/Contract.ts b/packages/cashscript/src/Contract.ts
index 4874a329..5b8115ab 100644
--- a/packages/cashscript/src/Contract.ts
+++ b/packages/cashscript/src/Contract.ts
@@ -176,7 +176,7 @@ export class Contract<
 
       const generateLockingBytecode = (): Uint8Array => addressToLockScript(this.address);
 
-      return { generateUnlockingBytecode, generateLockingBytecode };
+      return { generateUnlockingBytecode, generateLockingBytecode, contract: this, params: args, abiFunction };
     };
   }
 }
diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index e2aae1db..744c53e4 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -6,12 +6,24 @@ export class TypeError extends Error {
   }
 }
 
+export class UndefinedInputError extends Error {
+  constructor() {
+    super('Input is undefined');
+  }
+}
+
 export class OutputSatoshisTooSmallError extends Error {
   constructor(satoshis: bigint, minimumAmount: bigint) {
     super(`Tried to add an output with ${satoshis} satoshis, which is less than the required minimum for this output-type (${minimumAmount})`);
   }
 }
 
+export class OutputTokenAmountTooSmallError extends Error {
+  constructor(amount: bigint) {
+    super(`Tried to add an output with ${amount} tokens, which is invalid`);
+  }
+}
+
 export class TokensToNonTokenAddressError extends Error {
   constructor(address: string) {
     super(`Tried to send tokens to an address without token support, ${address}.`);
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index b931c50d..70a04f98 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -55,7 +55,7 @@ export const buildTemplate = async ({
   const template = {
     $schema: 'https://ide.bitauth.com/authentication-template-v0.schema.json',
     description: 'Imported from cashscript',
-    name: contract.artifact.contractName,
+    name: 'CashScript Generated Debugging Template',
     supported: ['BCH_2023_05'],
     version: 0,
     entities: generateTemplateEntities(contract.artifact, transaction.abiFunction, transaction.encodedFunctionArgs),
@@ -77,7 +77,6 @@ export const buildTemplate = async ({
     ),
   } as WalletTemplate;
 
-
   transaction.inputs
     .forEach((input, index) => {
       if (!isUtxoP2PKH(input)) return;
@@ -90,9 +89,9 @@ export const buildTemplate = async ({
       const hashtypeName = getHashTypeName(input.template.getHashType(false));
       const signatureString = `${placeholderKeyName}.${signatureAlgorithmName}.${hashtypeName}`;
 
-      template.entities.parameters.scripts!.push(lockScriptName, unlockScriptName);
-      template.entities.parameters.variables = {
-        ...template.entities.parameters.variables,
+      template.entities[snakeCase(contract.name + 'Parameters')].scripts!.push(lockScriptName, unlockScriptName);
+      template.entities[snakeCase(contract.name + 'Parameters')].variables = {
+        ...template.entities[snakeCase(contract.name + 'Parameters')].variables,
         [placeholderKeyName]: {
           description: placeholderKeyName,
           name: placeholderKeyName,
@@ -154,12 +153,12 @@ const generateTemplateEntities = (
   );
 
   const entities = {
-    parameters: {
+    [snakeCase(artifact.contractName + 'Parameters')]: {
       description: 'Contract creation and function parameters',
-      name: 'parameters',
+      name: snakeCase(artifact.contractName + 'Parameters'),
       scripts: [
-        'lock',
-        'unlock_lock',
+        snakeCase(artifact.contractName + '_lock'),
+        snakeCase(artifact.contractName + '_unlock'),
       ],
       variables: {
         ...functionParameters,
@@ -170,7 +169,7 @@ const generateTemplateEntities = (
 
   // function_index is a special variable that indicates the function to execute
   if (artifact.abi.length > 1) {
-    entities.parameters.variables.function_index = {
+    entities[snakeCase(artifact.contractName + 'Parameters')].variables.function_index = {
       description: 'Script function index to execute',
       name: 'function_index',
       type: 'WalletData',
@@ -189,8 +188,8 @@ const generateTemplateScripts = (
 ): WalletTemplate['scripts'] => {
   // definition of locking scripts and unlocking scripts with their respective bytecode
   return {
-    unlock_lock: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs),
-    lock: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
+    [snakeCase(artifact.contractName + '_unlock')]: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs),
+    [snakeCase(artifact.contractName + '_lock')]: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
   };
 };
 
@@ -201,7 +200,7 @@ const generateTemplateLockScript = (
 ): WalletTemplateScriptLocking => {
   return {
     lockingType: addressType,
-    name: 'lock',
+    name: snakeCase(artifact.contractName + '_lock'),
     script: [
       `// "${artifact.contractName}" contract constructor parameters`,
       formatParametersForDebugging(artifact.constructorInputs, constructorArguments),
@@ -225,15 +224,15 @@ const generateTemplateUnlockScript = (
 
   return {
     // this unlocking script must pass our only scenario
-    passes: ['evaluate_function'],
-    name: 'unlock',
+    passes: [snakeCase(artifact.contractName + 'Evaluate')],
+    name: snakeCase(artifact.contractName + '_unlock'),
     script: [
       `// "${abiFunction.name}" function parameters`,
       formatParametersForDebugging(abiFunction.inputs, encodedFunctionArgs),
       '',
       ...functionIndexString,
     ].join('\n'),
-    unlocks: 'lock',
+    unlocks: snakeCase(artifact.contractName + '_lock'),
   };
 };
 
@@ -251,8 +250,8 @@ const generateTemplateScenarios = (
 
   const scenarios = {
     // single scenario to spend out transaction under test given the CashScript parameters provided
-    evaluate_function: {
-      name: 'Evaluate',
+    [snakeCase(artifact.contractName + 'Evaluate')]: {
+      name: snakeCase(artifact.contractName + 'Evaluate'),
       description: 'An example evaluation where this script execution passes.',
       data: {
         // encode values for the variables defined above in `entities` property
@@ -273,7 +272,7 @@ const generateTemplateScenarios = (
 
   if (artifact.abi.length > 1) {
     const functionIndex = artifact.abi.findIndex((func) => func.name === transaction.abiFunction.name);
-    scenarios!.evaluate_function!.data!.bytecode!.function_index = functionIndex.toString();
+    scenarios![snakeCase(artifact.contractName + 'Evaluate')].data!.bytecode!.function_index = functionIndex.toString();
   }
 
   return scenarios;
@@ -314,7 +313,7 @@ const generateTemplateScenarioTransaction = (
   return { inputs, locktime, outputs, version };
 };
 
-const generateTemplateScenarioTransactionOutputLockingBytecode = (
+export const generateTemplateScenarioTransactionOutputLockingBytecode = (
   csOutput: Output,
   contract: Contract,
 ): string | {} => {
@@ -323,6 +322,20 @@ const generateTemplateScenarioTransactionOutputLockingBytecode = (
   return binToHex(addressToLockScript(csOutput.to));
 };
 
+/**
+ * Generates source outputs for a BitAuth template scenario
+ *
+ * @param csTransaction - The CashScript transaction to generate source outputs for
+ * @returns An array of BitAuth template scenario outputs with locking scripts and values
+ *
+ * For each input in the transaction:
+ * - Generates appropriate locking bytecode (P2PKH or contract)
+ * - Includes the input value in satoshis
+ * - Includes any token details if present
+ *
+ * The slotIndex tracks which input is the contract input vs P2PKH inputs
+ * to properly generate the locking scripts.
+ */
 const generateTemplateScenarioSourceOutputs = (
   csTransaction: Transaction,
 ): Array<WalletTemplateScenarioOutput<true>> => {
@@ -338,7 +351,7 @@ const generateTemplateScenarioSourceOutputs = (
 };
 
 // Used for generating the locking / unlocking bytecode for source outputs and inputs
-const generateTemplateScenarioBytecode = (
+export const generateTemplateScenarioBytecode = (
   input: Utxo, p2pkhScriptName: string, placeholderKeyName: string, insertSlot?: boolean,
 ): WalletTemplateScenarioBytecode | ['slot'] => {
   if (isUtxoP2PKH(input)) {
@@ -357,7 +370,7 @@ const generateTemplateScenarioBytecode = (
   return insertSlot ? ['slot'] : {};
 };
 
-const generateTemplateScenarioParametersValues = (
+export const generateTemplateScenarioParametersValues = (
   types: readonly AbiInput[],
   encodedArgs: EncodedFunctionArgument[],
 ): Record<string, string> => {
@@ -368,14 +381,18 @@ const generateTemplateScenarioParametersValues = (
     .filter(([, arg]) => !(arg instanceof SignatureTemplate))
     .map(([input, arg]) => {
       const encodedArgumentHex = binToHex(arg as Uint8Array);
-      const prefixedEncodedArgument = encodedArgumentHex.length > 0 ? `0x${encodedArgumentHex}` : '';
+      const prefixedEncodedArgument = addHexPrefixExceptEmpty(encodedArgumentHex);
       return [snakeCase(input.name), prefixedEncodedArgument] as const;
     });
 
   return Object.fromEntries(entries);
 };
 
-const generateTemplateScenarioKeys = (
+export const addHexPrefixExceptEmpty = (value: string): string => {
+  return value.length > 0 ? `0x${value}` : '';
+};
+
+export const generateTemplateScenarioKeys = (
   types: readonly AbiInput[],
   encodedArgs: EncodedFunctionArgument[],
 ): Record<string, string> => {
@@ -388,7 +405,7 @@ const generateTemplateScenarioKeys = (
   return Object.fromEntries(entries);
 };
 
-const formatParametersForDebugging = (types: readonly AbiInput[], args: EncodedFunctionArgument[]): string => {
+export const formatParametersForDebugging = (types: readonly AbiInput[], args: EncodedFunctionArgument[]): string => {
   if (types.length === 0) return '// none';
 
   // We reverse the arguments because the order of the arguments in the bytecode is reversed
@@ -409,7 +426,7 @@ const formatParametersForDebugging = (types: readonly AbiInput[], args: EncodedF
   }).join('\n');
 };
 
-const getSignatureAlgorithmName = (signatureAlgorithm: SignatureAlgorithm): string => {
+export const getSignatureAlgorithmName = (signatureAlgorithm: SignatureAlgorithm): string => {
   const signatureAlgorithmNames = {
     [SignatureAlgorithm.SCHNORR]: 'schnorr_signature',
     [SignatureAlgorithm.ECDSA]: 'ecdsa_signature',
@@ -418,7 +435,7 @@ const getSignatureAlgorithmName = (signatureAlgorithm: SignatureAlgorithm): stri
   return signatureAlgorithmNames[signatureAlgorithm];
 };
 
-const getHashTypeName = (hashType: HashType): string => {
+export const getHashTypeName = (hashType: HashType): string => {
   const hashtypeNames = {
     [HashType.SIGHASH_ALL]: 'all_outputs',
     [HashType.SIGHASH_ALL | HashType.SIGHASH_ANYONECANPAY]: 'all_outputs_single_input',
@@ -437,7 +454,7 @@ const getHashTypeName = (hashType: HashType): string => {
   return hashtypeNames[hashType];
 };
 
-const formatBytecodeForDebugging = (artifact: Artifact): string => {
+export const formatBytecodeForDebugging = (artifact: Artifact): string => {
   if (!artifact.debug) {
     return artifact.bytecode
       .split(' ')
@@ -452,7 +469,9 @@ const formatBytecodeForDebugging = (artifact: Artifact): string => {
   );
 };
 
-const serialiseTokenDetails = (token?: TokenDetails | LibauthTokenDetails): LibauthTemplateTokenDetails | undefined => {
+export const serialiseTokenDetails = (
+  token?: TokenDetails | LibauthTokenDetails,
+): LibauthTemplateTokenDetails | undefined => {
   if (!token) return undefined;
 
   return {
diff --git a/packages/cashscript/src/SignatureTemplate.ts b/packages/cashscript/src/SignatureTemplate.ts
index 6535636a..5593d192 100644
--- a/packages/cashscript/src/SignatureTemplate.ts
+++ b/packages/cashscript/src/SignatureTemplate.ts
@@ -61,6 +61,7 @@ export default class SignatureTemplate {
         const unlockingBytecode = scriptToBytecode([signature, publicKey]);
         return unlockingBytecode;
       },
+      template: this,
     };
   }
 }
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 5db4850a..c277a64f 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -38,7 +38,7 @@ import { P2PKH_INPUT_SIZE } from './constants.js';
 import { TransactionBuilder } from './TransactionBuilder.js';
 import { Contract } from './Contract.js';
 import { buildTemplate, getBitauthUri } from './LibauthTemplate.js';
-import { debugTemplate, DebugResult } from './debugging.js';
+import { debugTemplate, DebugResults } from './debugging.js';
 import { EncodedFunctionArgument } from './Argument.js';
 import { FailedTransactionError } from './Errors.js';
 
@@ -185,13 +185,13 @@ export class Transaction {
   }
 
   // method to debug the transaction with libauth VM, throws upon evaluation error
-  async debug(): Promise<DebugResult> {
+  async debug(): Promise<DebugResults> {
     if (!this.contract.artifact.debug) {
       console.warn('No debug information found in artifact. Recompile with cashc version 0.10.0 or newer to get better debugging information.');
     }
 
     const template = await this.getLibauthTemplate();
-    return debugTemplate(template, this.contract.artifact);
+    return debugTemplate(template, [this.contract.artifact]);
   }
 
   async bitauthUri(): Promise<string> {
diff --git a/packages/cashscript/src/TransactionBuilder.ts b/packages/cashscript/src/TransactionBuilder.ts
index 6b2049c1..30c36f01 100644
--- a/packages/cashscript/src/TransactionBuilder.ts
+++ b/packages/cashscript/src/TransactionBuilder.ts
@@ -1,181 +1,213 @@
-import {
-  binToHex, decodeTransaction, encodeTransaction, hexToBin, Transaction as LibauthTransaction,
-} from '@bitauth/libauth';
-import delay from 'delay';
-import {
-  Unlocker,
-  Output,
-  TransactionDetails,
-  UnlockableUtxo,
-  Utxo,
-  InputOptions,
-  isUnlockableUtxo,
-} from './interfaces.js';
-import { NetworkProvider } from './network/index.js';
-import {
-  cashScriptOutputToLibauthOutput,
-  createOpReturnOutput,
-  validateOutput,
-} from './utils.js';
-import { FailedTransactionError } from './Errors.js';
-
-export interface TransactionBuilderOptions {
-  provider: NetworkProvider;
-}
-
-const DEFAULT_SEQUENCE = 0xfffffffe;
-
-export class TransactionBuilder {
-  public provider: NetworkProvider;
-  public inputs: UnlockableUtxo[] = [];
-  public outputs: Output[] = [];
-
-  private locktime: number;
-  private maxFee?: bigint;
-
-  constructor(
-    options: TransactionBuilderOptions,
-  ) {
-    this.provider = options.provider;
-  }
-
-  addInput(utxo: Utxo, unlocker: Unlocker, options?: InputOptions): this {
-    this.inputs.push({ ...utxo, unlocker, options });
-    return this;
-  }
-
-  addInputs(utxos: Utxo[], unlocker: Unlocker, options?: InputOptions): this;
-  addInputs(utxos: UnlockableUtxo[]): this;
-
-  addInputs(utxos: Utxo[] | UnlockableUtxo[], unlocker?: Unlocker, options?: InputOptions): this {
-    if (
-      (!unlocker && utxos.some((utxo) => !isUnlockableUtxo(utxo)))
-      || (unlocker && utxos.some((utxo) => isUnlockableUtxo(utxo)))
-    ) {
-      throw new Error('Either all UTXOs must have an individual unlocker specified, or no UTXOs must have an individual unlocker specified and a shared unlocker must be provided');
-    }
-
-    if (!unlocker) {
-      this.inputs = this.inputs.concat(utxos as UnlockableUtxo[]);
-      return this;
-    }
-
-    this.inputs = this.inputs.concat(utxos.map(((utxo) => ({ ...utxo, unlocker, options }))));
-    return this;
-  }
-
-  addOutput(output: Output): this {
-    return this.addOutputs([output]);
-  }
-
-  addOutputs(outputs: Output[]): this {
-    outputs.forEach(validateOutput);
-    this.outputs = this.outputs.concat(outputs);
-    return this;
-  }
-
-  // TODO: allow uint8array for chunks
-  addOpReturnOutput(chunks: string[]): this {
-    this.outputs.push(createOpReturnOutput(chunks));
-    return this;
-  }
-
-  setLocktime(locktime: number): this {
-    this.locktime = locktime;
-    return this;
-  }
-
-  setMaxFee(maxFee: bigint): this {
-    this.maxFee = maxFee;
-    return this;
-  }
-
-  private checkMaxFee(): void {
-    if (!this.maxFee) return;
-
-    const totalInputAmount = this.inputs.reduce((total, input) => total + input.satoshis, 0n);
-    const totalOutputAmount = this.outputs.reduce((total, output) => total + output.amount, 0n);
-    const fee = totalInputAmount - totalOutputAmount;
-
-    if (fee > this.maxFee) {
-      throw new Error(`Transaction fee of ${fee} is higher than max fee of ${this.maxFee}`);
-    }
-  }
-
-  build(): string {
-    this.checkMaxFee();
-
-    const inputs = this.inputs.map((utxo) => ({
-      outpointIndex: utxo.vout,
-      outpointTransactionHash: hexToBin(utxo.txid),
-      sequenceNumber: utxo.options?.sequence ?? DEFAULT_SEQUENCE,
-      unlockingBytecode: new Uint8Array(),
-    }));
-
-    const outputs = this.outputs.map(cashScriptOutputToLibauthOutput);
-
-    const transaction = {
-      inputs,
-      locktime: this.locktime,
-      outputs,
-      version: 2,
-    };
-
-    // Generate source outputs from inputs (for signing with SIGHASH_UTXOS)
-    const sourceOutputs = this.inputs.map((input) => {
-      const sourceOutput = {
-        amount: input.satoshis,
-        to: input.unlocker.generateLockingBytecode(),
-        token: input.token,
-      };
-
-      return cashScriptOutputToLibauthOutput(sourceOutput);
-    });
-
-    const inputScripts = this.inputs.map((input, inputIndex) => (
-      input.unlocker.generateUnlockingBytecode({ transaction, sourceOutputs, inputIndex })
-    ));
-
-    inputScripts.forEach((script, i) => {
-      transaction.inputs[i].unlockingBytecode = script;
-    });
-
-    return binToHex(encodeTransaction(transaction));
-  }
-
-  // TODO: see if we can merge with Transaction.ts
-  async send(): Promise<TransactionDetails>;
-  async send(raw: true): Promise<string>;
-  async send(raw?: true): Promise<TransactionDetails | string> {
-    const tx = this.build();
-    try {
-      const txid = await this.provider.sendRawTransaction(tx);
-      return raw ? await this.getTxDetails(txid, raw) : await this.getTxDetails(txid);
-    } catch (e: any) {
-      const reason = e.error ?? e.message;
-      throw new FailedTransactionError(reason);
-    }
-  }
-
-  // TODO: see if we can merge with Transaction.ts
-  private async getTxDetails(txid: string): Promise<TransactionDetails>;
-  private async getTxDetails(txid: string, raw: true): Promise<string>;
-  private async getTxDetails(txid: string, raw?: true): Promise<TransactionDetails | string> {
-    for (let retries = 0; retries < 1200; retries += 1) {
-      await delay(500);
-      try {
-        const hex = await this.provider.getRawTransaction(txid);
-
-        if (raw) return hex;
-
-        const libauthTransaction = decodeTransaction(hexToBin(hex)) as LibauthTransaction;
-        return { ...libauthTransaction, txid, hex };
-      } catch (ignored) {
-        // ignored
-      }
-    }
-
-    // Should not happen
-    throw new Error('Could not retrieve transaction details for over 10 minutes');
-  }
-}
+import {
+  binToHex,
+  decodeTransaction,
+  encodeTransaction,
+  hexToBin,
+  Transaction as LibauthTransaction,
+  WalletTemplate,
+} from '@bitauth/libauth';
+import delay from 'delay';
+import {
+  Unlocker,
+  Output,
+  TransactionDetails,
+  UnlockableUtxo,
+  Utxo,
+  InputOptions,
+  isUnlockableUtxo,
+} from './interfaces.js';
+import { NetworkProvider } from './network/index.js';
+import {
+  cashScriptOutputToLibauthOutput,
+  createOpReturnOutput,
+  validateInput,
+  validateOutput,
+} from './utils.js';
+import { FailedTransactionError } from './Errors.js';
+import { DebugResults } from './debugging.js';
+import { getBitauthUri } from './LibauthTemplate.js';
+import { debugLibauthTemplate, getLibauthTemplates } from './advanced/LibauthTemplate.js';
+
+export interface TransactionBuilderOptions {
+  provider: NetworkProvider;
+}
+
+const DEFAULT_SEQUENCE = 0xfffffffe;
+
+export class TransactionBuilder {
+  public provider: NetworkProvider;
+  public inputs: UnlockableUtxo[] = [];
+  public outputs: Output[] = [];
+
+  public locktime: number = 0;
+  public maxFee?: bigint;
+
+  constructor(
+    options: TransactionBuilderOptions,
+  ) {
+    this.provider = options.provider;
+  }
+
+  addInput(utxo: Utxo, unlocker: Unlocker, options?: InputOptions): this {
+    return this.addInputs([utxo], unlocker, options);
+  }
+
+  addInputs(utxos: Utxo[], unlocker: Unlocker, options?: InputOptions): this;
+  addInputs(utxos: UnlockableUtxo[]): this;
+
+  addInputs(utxos: Utxo[] | UnlockableUtxo[], unlocker?: Unlocker, options?: InputOptions): this {
+    utxos.forEach(validateInput);
+    if (
+      (!unlocker && utxos.some((utxo) => !isUnlockableUtxo(utxo)))
+      || (unlocker && utxos.some((utxo) => isUnlockableUtxo(utxo)))
+    ) {
+      throw new Error('Either all UTXOs must have an individual unlocker specified, or no UTXOs must have an individual unlocker specified and a shared unlocker must be provided');
+    }
+
+    if (!unlocker) {
+      this.inputs = this.inputs.concat(utxos as UnlockableUtxo[]);
+      return this;
+    }
+
+    this.inputs = this.inputs.concat(utxos.map(((utxo) => ({ ...utxo, unlocker, options }))));
+    return this;
+  }
+
+  addOutput(output: Output): this {
+    return this.addOutputs([output]);
+  }
+
+  addOutputs(outputs: Output[]): this {
+    outputs.forEach(validateOutput);
+    this.outputs = this.outputs.concat(outputs);
+    return this;
+  }
+
+  // TODO: allow uint8array for chunks
+  addOpReturnOutput(chunks: string[]): this {
+    this.outputs.push(createOpReturnOutput(chunks));
+    return this;
+  }
+
+  setLocktime(locktime: number): this {
+    this.locktime = locktime;
+    return this;
+  }
+
+  setMaxFee(maxFee: bigint): this {
+    this.maxFee = maxFee;
+    return this;
+  }
+
+  private checkMaxFee(): void {
+    if (!this.maxFee) return;
+
+    const totalInputAmount = this.inputs.reduce((total, input) => total + input.satoshis, 0n);
+    const totalOutputAmount = this.outputs.reduce((total, output) => total + output.amount, 0n);
+    const fee = totalInputAmount - totalOutputAmount;
+
+    if (fee > this.maxFee) {
+      throw new Error(`Transaction fee of ${fee} is higher than max fee of ${this.maxFee}`);
+    }
+  }
+
+  buildLibauthTransaction(): LibauthTransaction {
+    this.checkMaxFee();
+
+    const inputs = this.inputs.map((utxo) => ({
+      outpointIndex: utxo.vout,
+      outpointTransactionHash: hexToBin(utxo.txid),
+      sequenceNumber: utxo.options?.sequence ?? DEFAULT_SEQUENCE,
+      unlockingBytecode: new Uint8Array(),
+    }));
+
+    const outputs = this.outputs.map(cashScriptOutputToLibauthOutput);
+
+    const transaction = {
+      inputs,
+      locktime: this.locktime,
+      outputs,
+      version: 2,
+    };
+
+    // Generate source outputs from inputs (for signing with SIGHASH_UTXOS)
+    const sourceOutputs = this.inputs.map((input) => {
+      const sourceOutput = {
+        amount: input.satoshis,
+        to: input.unlocker.generateLockingBytecode(),
+        token: input.token,
+      };
+
+      return cashScriptOutputToLibauthOutput(sourceOutput);
+    });
+
+    const inputScripts = this.inputs.map((input, inputIndex) => (
+      input.unlocker.generateUnlockingBytecode({ transaction, sourceOutputs, inputIndex })
+    ));
+
+    inputScripts.forEach((script, i) => {
+      transaction.inputs[i].unlockingBytecode = script;
+    });
+
+    return transaction;
+  }
+
+  build(): string {
+    const transaction = this.buildLibauthTransaction();
+    return binToHex(encodeTransaction(transaction));
+  }
+
+  // method to debug the transaction with libauth VM, throws upon evaluation error
+  // TODO: Remove the async in the future (this currently breaks our debugging tests)
+  async debug(): Promise<DebugResults> {
+    return debugLibauthTemplate(this.getLibauthTemplate(), this);
+  }
+
+  bitauthUri(): string {
+    return getBitauthUri(this.getLibauthTemplate());
+  }
+
+  getLibauthTemplate(): WalletTemplate {
+    return getLibauthTemplates(this);
+  }
+
+  // TODO: see if we can merge with Transaction.ts
+  async send(): Promise<TransactionDetails>;
+  async send(raw: true): Promise<string>;
+  async send(raw?: true): Promise<TransactionDetails | string> {
+    const tx = this.build();
+
+    // Debug the transaction locally before sending so any errors are caught early
+    await this.debug();
+
+    try {
+      const txid = await this.provider.sendRawTransaction(tx);
+      return raw ? await this.getTxDetails(txid, raw) : await this.getTxDetails(txid);
+    } catch (e: any) {
+      const reason = e.error ?? e.message;
+      throw new FailedTransactionError(reason);
+    }
+  }
+
+  // TODO: see if we can merge with Transaction.ts
+  private async getTxDetails(txid: string): Promise<TransactionDetails>;
+  private async getTxDetails(txid: string, raw: true): Promise<string>;
+  private async getTxDetails(txid: string, raw?: true): Promise<TransactionDetails | string> {
+    for (let retries = 0; retries < 1200; retries += 1) {
+      await delay(500);
+      try {
+        const hex = await this.provider.getRawTransaction(txid);
+
+        if (raw) return hex;
+
+        const libauthTransaction = decodeTransaction(hexToBin(hex)) as LibauthTransaction;
+        return { ...libauthTransaction, txid, hex };
+      } catch (ignored) {
+        // ignored
+      }
+    }
+
+    // Should not happen
+    throw new Error('Could not retrieve transaction details for over 10 minutes');
+  }
+}
diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
new file mode 100644
index 00000000..1cc06444
--- /dev/null
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -0,0 +1,575 @@
+import {
+  binToHex,
+  TransactionBch,
+  WalletTemplate,
+  WalletTemplateEntity,
+  WalletTemplateScenario,
+  WalletTemplateScenarioBytecode,
+  WalletTemplateScenarioInput,
+  WalletTemplateScenarioOutput,
+  WalletTemplateScenarioTransactionOutput,
+  WalletTemplateScript,
+  WalletTemplateScriptLocking,
+  WalletTemplateScriptUnlocking,
+  WalletTemplateVariable,
+} from '@bitauth/libauth';
+import {
+  AbiFunction,
+  Artifact,
+} from '@cashscript/utils';
+import { EncodedConstructorArgument, EncodedFunctionArgument, encodeFunctionArguments } from '../Argument.js';
+import { Contract } from '../Contract.js';
+import { DebugResults, debugTemplate } from '../debugging.js';
+import {
+  AddressType,
+  UnlockableUtxo,
+  Utxo,
+} from '../interfaces.js';
+import {
+  addHexPrefixExceptEmpty,
+  formatBytecodeForDebugging,
+  formatParametersForDebugging,
+  generateTemplateScenarioBytecode,
+  generateTemplateScenarioKeys,
+  generateTemplateScenarioParametersValues,
+  generateTemplateScenarioTransactionOutputLockingBytecode,
+  getHashTypeName,
+  getSignatureAlgorithmName,
+  serialiseTokenDetails,
+} from '../LibauthTemplate.js';
+import SignatureTemplate from '../SignatureTemplate.js';
+import { Transaction } from '../Transaction.js';
+import { addressToLockScript, snakeCase, titleCase } from '../utils.js';
+import { TransactionBuilder } from '../TransactionBuilder.js';
+
+
+/**
+ * Generates template entities for P2PKH (Pay to Public Key Hash) placeholder scripts.
+ *
+ * Follows the WalletTemplateEntity specification from:
+ * https://ide.bitauth.com/authentication-template-v0.schema.json
+ *
+ */
+export const generateTemplateEntitiesP2PKH = (
+  index: number,
+): WalletTemplate['entities'] => {
+  const lockScriptName = `p2pkh_placeholder_lock_${index}`;
+  const unlockScriptName = `p2pkh_placeholder_unlock_${index}`;
+
+  return {
+    [`signer_${index}`]: {
+      scripts: [lockScriptName, unlockScriptName],
+      description: `placeholder_key_${index}`,
+      name: `Signer ${index}`,
+      variables: {
+        [`placeholder_key_${index}`]: {
+          description: '',
+          name: `Placeholder Key ${index}`,
+          type: 'Key',
+        },
+      },
+    },
+  };
+};
+
+/**
+ * Generates template entities for P2SH (Pay to Script Hash) placeholder scripts.
+ *
+ * Follows the WalletTemplateEntity specification from:
+ * https://ide.bitauth.com/authentication-template-v0.schema.json
+ *
+ */
+export const generateTemplateEntitiesP2SH = (
+  artifact: Artifact,
+  abiFunction: AbiFunction,
+  encodedFunctionArgs: EncodedFunctionArgument[],
+): WalletTemplate['entities'] => {
+  const functionParameters = Object.fromEntries<WalletTemplateVariable>(
+    abiFunction.inputs.map((input, index) => ([
+      snakeCase(input.name),
+      {
+        description: `"${input.name}" parameter of function "${abiFunction.name}"`,
+        name: titleCase(input.name),
+        type: encodedFunctionArgs[index] instanceof SignatureTemplate ? 'Key' : 'WalletData',
+      },
+    ])),
+  );
+
+  const constructorParameters = Object.fromEntries<WalletTemplateVariable>(
+    artifact.constructorInputs.map((input) => ([
+      snakeCase(input.name),
+      {
+        description: `"${input.name}" parameter of this contract`,
+        name: titleCase(input.name),
+        type: 'WalletData',
+      },
+    ])),
+  );
+
+  const entities = {
+    [snakeCase(artifact.contractName + 'Parameters')]: {
+      description: 'Contract creation and function parameters',
+      name: titleCase(artifact.contractName),
+      scripts: [
+        snakeCase(artifact.contractName + '_lock'),
+        snakeCase(artifact.contractName + '_' + abiFunction.name + '_unlock'),
+      ],
+      variables: {
+        ...functionParameters,
+        ...constructorParameters,
+      },
+    },
+  };
+
+  // function_index is a special variable that indicates the function to execute
+  if (artifact.abi.length > 1) {
+    entities[snakeCase(artifact.contractName + 'Parameters')].variables.function_index = {
+      description: 'Script function index to execute',
+      name: titleCase('function_index'),
+      type: 'WalletData',
+    };
+  }
+
+  return entities;
+};
+
+/**
+ * Generates template scripts for P2PKH (Pay to Public Key Hash) placeholder scripts.
+ *
+ * Follows the WalletTemplateScript specification from:
+ * https://ide.bitauth.com/authentication-template-v0.schema.json
+ *
+ */
+export const generateTemplateScriptsP2PKH = (
+  template: SignatureTemplate,
+  index: number,
+): WalletTemplate['scripts'] => {
+  const scripts: WalletTemplate['scripts'] = {};
+  const lockScriptName = `p2pkh_placeholder_lock_${index}`;
+  const unlockScriptName = `p2pkh_placeholder_unlock_${index}`;
+  const placeholderKeyName = `placeholder_key_${index}`;
+
+  const signatureAlgorithmName = getSignatureAlgorithmName(template.getSignatureAlgorithm());
+  const hashtypeName = getHashTypeName(template.getHashType(false));
+  const signatureString = `${placeholderKeyName}.${signatureAlgorithmName}.${hashtypeName}`;
+  // add extra unlocking and locking script for P2PKH inputs spent alongside our contract
+  // this is needed for correct cross-references in the template
+  scripts[unlockScriptName] = {
+    name: unlockScriptName,
+    script:
+      `<${signatureString}>\n<${placeholderKeyName}.public_key>`,
+    unlocks: lockScriptName,
+  };
+  scripts[lockScriptName] = {
+    lockingType: 'standard',
+    name: lockScriptName,
+    script:
+      `OP_DUP\nOP_HASH160 <$(<${placeholderKeyName}.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG`,
+  };
+
+  return scripts;
+};
+
+/**
+ * Generates template scripts for P2SH (Pay to Script Hash) placeholder scripts.
+ *
+ * Follows the WalletTemplateScript specification from:
+ * https://ide.bitauth.com/authentication-template-v0.schema.json
+ *
+ */
+export const generateTemplateScriptsP2SH = (
+  artifact: Artifact,
+  addressType: AddressType,
+  abiFunction: AbiFunction,
+  encodedFunctionArgs: EncodedFunctionArgument[],
+  encodedConstructorArgs: EncodedConstructorArgument[],
+  scenarioIds: string[],
+): WalletTemplate['scripts'] => {
+  // definition of locking scripts and unlocking scripts with their respective bytecode
+  return {
+    [snakeCase(artifact.contractName + '_' + abiFunction.name + '_unlock')]: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs, scenarioIds),
+    [snakeCase(artifact.contractName + '_lock')]: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
+  };
+};
+
+/**
+ * Generates a template lock script for a P2SH (Pay to Script Hash) placeholder script.
+ *
+ * Follows the WalletTemplateScriptLocking specification from:
+ * https://ide.bitauth.com/authentication-template-v0.schema.json
+ *
+ */
+const generateTemplateLockScript = (
+  artifact: Artifact,
+  addressType: AddressType,
+  constructorArguments: EncodedFunctionArgument[],
+): WalletTemplateScriptLocking => {
+  return {
+    lockingType: addressType,
+    name: artifact.contractName,
+    script: [
+      `// "${artifact.contractName}" contract constructor parameters`,
+      formatParametersForDebugging(artifact.constructorInputs, constructorArguments),
+      '',
+      '// bytecode',
+      formatBytecodeForDebugging(artifact),
+    ].join('\n'),
+  };
+};
+
+/**
+ * Generates a template unlock script for a P2SH (Pay to Script Hash) placeholder script.
+ *
+ * Follows the WalletTemplateScriptUnlocking specification from:
+ * https://ide.bitauth.com/authentication-template-v0.schema.json
+ *
+ */
+const generateTemplateUnlockScript = (
+  artifact: Artifact,
+  abiFunction: AbiFunction,
+  encodedFunctionArgs: EncodedFunctionArgument[],
+  scenarioIds: string[],
+): WalletTemplateScriptUnlocking => {
+  const functionIndex = artifact.abi.findIndex((func) => func.name === abiFunction.name);
+
+  const functionIndexString = artifact.abi.length > 1
+    ? ['// function index in contract', `<function_index> // int = <${functionIndex}>`, '']
+    : [];
+
+  return {
+    // this unlocking script must pass our only scenario
+    passes: scenarioIds,
+    name: abiFunction.name,
+    script: [
+      `// "${abiFunction.name}" function parameters`,
+      formatParametersForDebugging(abiFunction.inputs, encodedFunctionArgs),
+      '',
+      ...functionIndexString,
+    ].join('\n'),
+    unlocks: snakeCase(artifact.contractName + '_lock'),
+  };
+};
+
+export const generateTemplateScenarios = (
+  scenarioIdentifier: string,
+  contract: Contract,
+  libauthTransaction: TransactionBch,
+  csTransaction: Transaction,
+  abiFunction: AbiFunction,
+  encodedFunctionArgs: EncodedFunctionArgument[],
+  slotIndex: number,
+): WalletTemplate['scenarios'] => {
+  const artifact = contract.artifact;
+  const encodedConstructorArgs = contract.encodedConstructorArgs;
+
+  const scenarios = {
+    // single scenario to spend out transaction under test given the CashScript parameters provided
+    [scenarioIdentifier]: {
+      name: snakeCase(artifact.contractName + '_' + abiFunction.name + 'Evaluate'),
+      description: 'An example evaluation where this script execution passes.',
+      data: {
+        // encode values for the variables defined above in `entities` property
+        bytecode: {
+          ...generateTemplateScenarioParametersValues(abiFunction.inputs, encodedFunctionArgs),
+          ...generateTemplateScenarioParametersValues(artifact.constructorInputs, encodedConstructorArgs),
+        },
+        currentBlockHeight: 2,
+        currentBlockTime: Math.round(+new Date() / 1000),
+        keys: {
+          privateKeys: generateTemplateScenarioKeys(abiFunction.inputs, encodedFunctionArgs),
+        },
+      },
+      transaction: generateTemplateScenarioTransaction(contract, libauthTransaction, csTransaction, slotIndex),
+      sourceOutputs: generateTemplateScenarioSourceOutputs(csTransaction, slotIndex),
+    },
+  };
+
+  if (artifact.abi.length > 1) {
+    const functionIndex = artifact.abi.findIndex((func) => func.name === abiFunction.name);
+    scenarios![scenarioIdentifier].data!.bytecode!.function_index = functionIndex.toString();
+  }
+
+  return scenarios;
+};
+
+const generateTemplateScenarioTransaction = (
+  contract: Contract,
+  libauthTransaction: TransactionBch,
+  csTransaction: Transaction,
+  slotIndex: number,
+): WalletTemplateScenario['transaction'] => {
+  const inputs = libauthTransaction.inputs.map((input, index) => {
+    const csInput = csTransaction.inputs[index] as Utxo;
+
+    return {
+      outpointIndex: input.outpointIndex,
+      outpointTransactionHash: binToHex(input.outpointTransactionHash),
+      sequenceNumber: input.sequenceNumber,
+      unlockingBytecode: generateTemplateScenarioBytecode(csInput, `p2pkh_placeholder_unlock_${index}`, `placeholder_key_${index}`, slotIndex === index),
+    } as WalletTemplateScenarioInput;
+  });
+
+  const locktime = libauthTransaction.locktime;
+
+  const outputs = libauthTransaction.outputs.map((output, index) => {
+    const csOutput = csTransaction.outputs[index];
+
+    return {
+      lockingBytecode: generateTemplateScenarioTransactionOutputLockingBytecode(csOutput, contract),
+      token: serialiseTokenDetails(output.token),
+      valueSatoshis: Number(output.valueSatoshis),
+    } as WalletTemplateScenarioTransactionOutput;
+  });
+
+  const version = libauthTransaction.version;
+
+  return { inputs, locktime, outputs, version };
+};
+
+const generateTemplateScenarioSourceOutputs = (
+  csTransaction: Transaction,
+  slotIndex: number,
+): Array<WalletTemplateScenarioOutput<true>> => {
+
+  return csTransaction.inputs.map((input, index) => {
+    return {
+      lockingBytecode: generateTemplateScenarioBytecode(input, `p2pkh_placeholder_lock_${index}`, `placeholder_key_${index}`, index === slotIndex),
+      valueSatoshis: Number(input.satoshis),
+      token: serialiseTokenDetails(input.token),
+    };
+  });
+};
+
+
+/**
+ * Creates a transaction object from a TransactionBuilder instance
+ *
+ * @param txn - The TransactionBuilder instance to convert
+ * @returns A transaction object containing inputs, outputs, locktime and version
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+const createCSTransaction = (txn: TransactionBuilder) => {
+  const csTransaction = {
+    inputs: txn.inputs,
+    locktime: txn.locktime,
+    outputs: txn.outputs,
+    version: 2,
+  };
+
+  return csTransaction;
+};
+
+export const getLibauthTemplates = (
+  txn: TransactionBuilder,
+): WalletTemplate => {
+  const libauthTransaction = txn.buildLibauthTransaction();
+  const csTransaction = createCSTransaction(txn);
+
+  const baseTemplate: WalletTemplate = {
+    $schema: 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+    description: 'Imported from cashscript',
+    name: 'CashScript Generated Debugging Template',
+    supported: ['BCH_2023_05'],
+    version: 0,
+    entities: {},
+    scripts: {},
+    scenarios: {},
+  };
+
+  // Initialize collections for entities, scripts, and scenarios
+  const entities: Record<string, WalletTemplateEntity> = {};
+  const scripts: Record<string, WalletTemplateScript> = {};
+  const scenarios: Record<string, WalletTemplateScenario> = {};
+
+  // Initialize collections for P2PKH entities and scripts
+  const p2pkhEntities: Record<string, WalletTemplateEntity> = {};
+  const p2pkhScripts: Record<string, WalletTemplateScript> = {};
+
+  // Initialize bytecode mappings, these will be used to map the locking and unlocking scripts and naming the scripts
+  const unlockingBytecodeToLockingBytecodeParams: Record<string, WalletTemplateScenarioBytecode> = {};
+  const lockingBytecodeToLockingBytecodeParams: Record<string, WalletTemplateScenarioBytecode> = {};
+
+  for (const [idx, input] of txn.inputs.entries()) {
+    // If template exists on the input, it indicates this is a P2PKH (Pay to Public Key Hash) input
+    if (input.unlocker?.template) {
+      // @ts-ignore TODO: Remove UtxoP2PKH type and only use UnlockableUtxo in Libaith Template generation
+      input.template = input.unlocker?.template;  // Added to support P2PKH inputs in buildTemplate
+      Object.assign(p2pkhEntities, generateTemplateEntitiesP2PKH(idx));
+      Object.assign(p2pkhScripts, generateTemplateScriptsP2PKH(input.unlocker.template, idx));
+
+      continue;
+    }
+
+    // If contract exists on the input, it indicates this is a contract input
+    if (input.unlocker?.contract) {
+      const contract = input.unlocker?.contract;
+      const abiFunction = input.unlocker?.abiFunction;
+
+      if (!abiFunction) {
+        throw new Error('No ABI function found in unlocker');
+      }
+
+      // Find matching function and index from contract.unlock Object, this uses Function Reference Comparison.
+      // Generate unique scenario identifier by combining contract name, function name and counter
+      const baseIdentifier = `${contract.artifact.contractName}_${abiFunction.name}Evaluate`;
+      let scenarioIdentifier = baseIdentifier;
+      let counter = 0;
+
+      const scenarioIds = [snakeCase(scenarioIdentifier)];
+
+      // Find first available unique identifier by incrementing counter
+      while (scenarios[snakeCase(scenarioIdentifier)]) {
+        counter++;
+        scenarioIdentifier = `${baseIdentifier}${counter}`;
+        scenarioIds.push(snakeCase(scenarioIdentifier));
+      }
+
+      scenarioIdentifier = snakeCase(scenarioIdentifier);
+
+      // Encode the function arguments for this contract input
+      const encodedArgs = encodeFunctionArguments(
+        abiFunction,
+        input.unlocker.params ?? [],
+      );
+
+      // Generate a scenario object for this contract input
+      Object.assign(scenarios,
+        generateTemplateScenarios(
+          scenarioIdentifier,
+          contract,
+          libauthTransaction,
+          csTransaction as any,
+          abiFunction,
+          encodedArgs,
+          idx,
+        ),
+      );
+
+      // Generate entities for this contract input
+      const entity = generateTemplateEntitiesP2SH(
+        contract.artifact,
+        abiFunction,
+        encodedArgs,
+      );
+
+      // Generate scripts for this contract input
+      const script = generateTemplateScriptsP2SH(
+        contract.artifact,
+        contract.addressType,
+        abiFunction,
+        encodedArgs,
+        contract.encodedConstructorArgs,
+        scenarioIds,
+      );
+
+      // Find the lock script name for this contract input
+      const lockScriptName = Object.keys(script).find(scriptName => scriptName.includes('_lock'));
+      if (lockScriptName) {
+        // Generate bytecodes for this contract input
+        const csInput = csTransaction.inputs[idx];
+        const unlockingBytecode = binToHex(libauthTransaction.inputs[idx].unlockingBytecode);
+        const lockingScriptParams = generateLockingScriptParams(csInput.unlocker!.contract!, csInput, lockScriptName);
+
+        // Assign a name to the unlocking bytecode so later it can be used to replace the bytecode/slot in scenarios
+        unlockingBytecodeToLockingBytecodeParams[unlockingBytecode] = lockingScriptParams;
+        // Assign a name to the locking bytecode so later it can be used to replace with bytecode/slot in scenarios
+        lockingBytecodeToLockingBytecodeParams[binToHex(addressToLockScript(contract.address))] = lockingScriptParams;
+      }
+
+      // Add entities and scripts to the base template and repeat the process for the next input
+      Object.assign(entities, entity);
+      Object.assign(scripts, script);
+    }
+  }
+
+  // Merge P2PKH scripts
+  for (const entity of Object.values(p2pkhEntities) as { scripts?: string[] }[]) {
+    if (entity.scripts) { entity.scripts = [...Object.keys(scripts), ...entity.scripts]; }
+  }
+
+  Object.assign(entities, p2pkhEntities);
+  Object.assign(scripts, p2pkhScripts);
+
+  const finalTemplate = { ...baseTemplate, entities, scripts, scenarios };
+
+  // Loop through all scenarios and map the locking and unlocking scripts to the scenarios
+  // Replace the script tag with the identifiers we created earlier
+
+  // For Inputs
+  for (const scenario of Object.values(scenarios)) {
+    for (const [idx, input] of libauthTransaction.inputs.entries()) {
+      const unlockingBytecode = binToHex(input.unlockingBytecode);
+
+      // If false then it stays lockingBytecode: {}
+      if (unlockingBytecodeToLockingBytecodeParams[unlockingBytecode]) {
+        // ['slot'] this identifies the source output in which the locking script under test will be placed
+        if (Array.isArray(scenario?.sourceOutputs?.[idx]?.lockingBytecode)) continue;
+
+        // If true then assign a name to the locking bytecode script.
+        if (scenario.sourceOutputs && scenario.sourceOutputs[idx]) {
+          scenario.sourceOutputs[idx] = {
+            ...scenario.sourceOutputs[idx],
+            lockingBytecode: unlockingBytecodeToLockingBytecodeParams[unlockingBytecode],
+          };
+        }
+      }
+    }
+
+    // For Outputs
+    for (const [idx, output] of libauthTransaction.outputs.entries()) {
+      const lockingBytecode = binToHex(output.lockingBytecode);
+
+      // If false then it stays lockingBytecode: {}
+      if (lockingBytecodeToLockingBytecodeParams[lockingBytecode]) {
+
+        // ['slot'] this identifies the source output in which the locking script under test will be placed
+        if (Array.isArray(scenario?.transaction?.outputs?.[idx]?.lockingBytecode)) continue;
+
+        // If true then assign a name to the locking bytecode script.
+        if (scenario?.transaction && scenario?.transaction?.outputs && scenario?.transaction?.outputs[idx]) {
+          scenario.transaction.outputs[idx] = {
+            ...scenario.transaction.outputs[idx],
+            lockingBytecode: lockingBytecodeToLockingBytecodeParams[lockingBytecode],
+          };
+        }
+      }
+    }
+
+  }
+
+  return finalTemplate;
+};
+
+export const debugLibauthTemplate = (template: WalletTemplate, transaction: TransactionBuilder): DebugResults => {
+  const allArtifacts = transaction.inputs
+    .map(input => input.unlocker?.contract)
+    .filter((contract): contract is Contract => !!contract)
+    .map(contract => contract.artifact);
+
+  return debugTemplate(template, allArtifacts);
+};
+
+const generateLockingScriptParams = (
+  contract: Contract,
+  csInput: UnlockableUtxo,
+  lockScriptName: string,
+): WalletTemplateScenarioBytecode => {
+  if (!csInput.unlocker?.contract) return {
+    script: lockScriptName,
+  };
+
+  const constructorParamsEntries = contract.artifact.constructorInputs
+    .map(({ name }, index) => [
+      name,
+      addHexPrefixExceptEmpty(binToHex(csInput.unlocker!.contract!.encodedConstructorArgs[index])),
+    ]);
+
+  const constructorParams = Object.fromEntries(constructorParamsEntries);
+
+  return {
+    script: lockScriptName,
+    overrides: {
+      bytecode: { ...constructorParams },
+    },
+  };
+};
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index ffd31bb2..b46a6efc 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -1,26 +1,40 @@
-import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, binToHex, createCompiler, createVirtualMachineBch2025, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
+import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, WalletTemplateScriptUnlocking, binToHex, createCompiler, createVirtualMachineBch2025, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
 import { Artifact, LogEntry, Op, PrimitiveType, StackItem, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
-import { findLastIndex, toRegExp } from './utils.js';
+import { findLastIndex, snakeCase, toRegExp } from './utils.js';
 import { FailedRequireError, FailedTransactionError, FailedTransactionEvaluationError } from './Errors.js';
 import { getBitauthUri } from './LibauthTemplate.js';
 
-// evaluates the fully defined template, throws upon error
-export const evaluateTemplate = (template: WalletTemplate): boolean => {
-  const { vm, program } = createProgram(template);
+export type DebugResult = AuthenticationProgramStateCommon[];
+export type DebugResults = Record<string, DebugResult>;
+
+// debugs the template, optionally logging the execution data
+export const debugTemplate = (template: WalletTemplate, artifacts: Artifact[]): DebugResults => {
+  const results: DebugResults = {};
+  const unlockingScriptIds = Object.keys(template.scripts).filter((key) => 'unlocks' in template.scripts[key]);
+
+  for (const unlockingScriptId of unlockingScriptIds) {
+    const scenarioIds = (template.scripts[unlockingScriptId] as WalletTemplateScriptUnlocking).passes ?? [];
+    // There are no scenarios defined for P2PKH placeholder scripts, so we skip them
+    if (scenarioIds.length === 0) continue;
 
-  const verifyResult = vm.verify(program);
-  if (typeof verifyResult === 'string') {
-    throw new FailedTransactionError(verifyResult, getBitauthUri(template));
+    const matchingArtifact = artifacts.find((artifact) => unlockingScriptId.startsWith(snakeCase(artifact.contractName)));
+
+    if (!matchingArtifact) {
+      throw new Error(`No artifact found for unlocking script ${unlockingScriptId}`);
+    }
+
+    for (const scenarioId of scenarioIds) {
+      results[`${unlockingScriptId}.${scenarioId}`] = debugSingleScenario(template, matchingArtifact, unlockingScriptId, scenarioId);
+    }
   }
 
-  return verifyResult;
+  return results;
 };
 
-export type DebugResult = AuthenticationProgramStateCommon[];
-
-// debugs the template, optionally logging the execution data
-export const debugTemplate = (template: WalletTemplate, artifact: Artifact): DebugResult => {
-  const { vm, program } = createProgram(template);
+const debugSingleScenario = (
+  template: WalletTemplate, artifact: Artifact, unlockingScriptId: string, scenarioId: string,
+): DebugResult => {
+  const { vm, program } = createProgram(template, unlockingScriptId, scenarioId);
 
   const fullDebugSteps = vm.debug(program);
 
@@ -107,25 +121,35 @@ export const debugTemplate = (template: WalletTemplate, artifact: Artifact): Deb
   return fullDebugSteps;
 };
 
+/* eslint-disable @typescript-eslint/indent */
 type VM = AuthenticationVirtualMachine<
-ResolvedTransactionCommon,
-AuthenticationProgramCommon,
-AuthenticationProgramStateCommon
+  ResolvedTransactionCommon,
+  AuthenticationProgramCommon,
+  AuthenticationProgramStateCommon
 >;
+/* eslint-enable @typescript-eslint/indent */
+
 type Program = AuthenticationProgramCommon;
 type CreateProgramResult = { vm: VM, program: Program };
 
 // internal util. instantiates the virtual machine and compiles the template into a program
-const createProgram = (template: WalletTemplate): CreateProgramResult => {
+const createProgram = (template: WalletTemplate, unlockingScriptId: string, scenarioId: string): CreateProgramResult => {
   const configuration = walletTemplateToCompilerConfiguration(template);
   const vm = createVirtualMachineBch2025();
   const compiler = createCompiler(configuration);
 
+  if (!template.scripts[unlockingScriptId]) {
+    throw new Error(`No unlock script found in template for ID ${unlockingScriptId}`);
+  }
+
+  if (!template.scenarios?.[scenarioId]) {
+    throw new Error(`No scenario found in template for ID ${scenarioId}`);
+  }
+
   const scenarioGeneration = compiler.generateScenario({
     debug: true,
-    lockingScriptId: undefined,
-    unlockingScriptId: 'unlock_lock',
-    scenarioId: 'evaluate_function',
+    unlockingScriptId,
+    scenarioId,
   });
 
   if (typeof scenarioGeneration === 'string') {
diff --git a/packages/cashscript/src/interfaces.ts b/packages/cashscript/src/interfaces.ts
index 583becfb..72399fab 100644
--- a/packages/cashscript/src/interfaces.ts
+++ b/packages/cashscript/src/interfaces.ts
@@ -1,6 +1,9 @@
 import { type Transaction } from '@bitauth/libauth';
 import type { NetworkProvider } from './network/index.js';
 import type SignatureTemplate from './SignatureTemplate.js';
+import { Contract } from './Contract.js';
+import { AbiFunction } from '@cashscript/utils';
+import { FunctionArgument } from './Argument.js';
 
 export interface Utxo {
   txid: string;
@@ -28,9 +31,14 @@ export interface GenerateUnlockingBytecodeOptions {
   inputIndex: number;
 }
 
+// TODO: Change this type when we understand the requirements better
 export interface Unlocker {
   generateLockingBytecode: () => Uint8Array;
   generateUnlockingBytecode: (options: GenerateUnlockingBytecodeOptions) => Uint8Array;
+  contract?: Contract;
+  params?: FunctionArgument[];
+  abiFunction?: AbiFunction;
+  template?: SignatureTemplate;
 }
 
 export interface UtxoP2PKH extends Utxo {
diff --git a/packages/cashscript/src/network/ElectrumNetworkProvider.ts b/packages/cashscript/src/network/ElectrumNetworkProvider.ts
index 65665192..789b7ef9 100644
--- a/packages/cashscript/src/network/ElectrumNetworkProvider.ts
+++ b/packages/cashscript/src/network/ElectrumNetworkProvider.ts
@@ -47,7 +47,7 @@ export default class ElectrumNetworkProvider implements NetworkProvider {
       this.electrum.addServer('testnet4.imaginary.cash', 50004, ElectrumTransport.WSS.Scheme, false);
     } else if (network === Network.CHIPNET) {
       this.electrum = new ElectrumCluster('CashScript Application', '1.4.1', 1, 1, ClusterOrder.PRIORITY);
-      this.electrum.addServer('chipnet.imaginary.cash', 50004, ElectrumTransport.WSS.Scheme, false);
+      this.electrum.addServer('chipnet.bch.ninja', 50004, ElectrumTransport.WSS.Scheme, false);
     } else {
       throw new Error(`Tried to instantiate an ElectrumNetworkProvider for unsupported network ${network}`);
     }
diff --git a/packages/cashscript/src/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
index 54d61fbb..804e7ca5 100644
--- a/packages/cashscript/src/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -1,8 +1,8 @@
 import { MatcherContext } from '@jest/expect';
 import { SyncExpectationResult } from 'expect';
-import { Transaction } from '../index.js';
+import { DebugResults } from '../debugging.js';
 
-export {};
+export { };
 
 declare global {
   namespace jest {
@@ -15,17 +15,21 @@ declare global {
   }
 }
 
+interface Debuggable {
+  debug(): Promise<DebugResults>;
+}
+
 expect.extend({
   async toLog(
     this: MatcherContext,
-    transaction: Transaction,
+    transaction: Debuggable,
     match?: RegExp | string,
   ): Promise<SyncExpectationResult> {
     const loggerSpy = jest.spyOn(console, 'log');
 
     // silence actual stdout output
-    loggerSpy.mockImplementation(() => {});
-    try { await transaction.debug(); } catch {}
+    loggerSpy.mockImplementation(() => { });
+    try { await transaction.debug(); } catch { }
 
     // We concatenate all the logs into a single string - if no logs are present, we set received to undefined
     const receivedBase = loggerSpy.mock.calls.reduce((acc, [log]) => `${acc}\n${log}`, '').trim();
@@ -51,7 +55,7 @@ expect.extend({
 expect.extend({
   async toFailRequireWith(
     this: MatcherContext,
-    transaction: Transaction,
+    transaction: Debuggable,
     match: RegExp | string,
   ): Promise<SyncExpectationResult> {
     try {
@@ -76,7 +80,7 @@ expect.extend({
   },
   async toFailRequire(
     this: MatcherContext,
-    transaction: Transaction,
+    transaction: Debuggable,
   ): Promise<SyncExpectationResult> {
     try {
       await transaction.debug();
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index 8cdd0ea5..a6a68252 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -36,10 +36,20 @@ import {
 import { VERSION_SIZE, LOCKTIME_SIZE } from './constants.js';
 import {
   OutputSatoshisTooSmallError,
+  OutputTokenAmountTooSmallError,
   TokensToNonTokenAddressError,
+  UndefinedInputError,
 } from './Errors.js';
 
+export { snakeCase } from 'change-case';
+
 // ////////// PARAMETER VALIDATION ////////////////////////////////////////////
+export function validateInput(utxo: Utxo): void {
+  if (!utxo) {
+    throw new UndefinedInputError();
+  }
+}
+
 export function validateOutput(output: Output): void {
   if (typeof output.to !== 'string') return;
 
@@ -52,6 +62,10 @@ export function validateOutput(output: Output): void {
     if (!isTokenAddress(output.to)) {
       throw new TokensToNonTokenAddressError(output.to);
     }
+
+    if (output.token.amount < 0n) {
+      throw new OutputTokenAmountTooSmallError(output.token.amount);
+    }
   }
 }
 
@@ -335,15 +349,26 @@ export function findLastIndex<T>(array: Array<T>, predicate: (value: T, index: n
   return -1;
 }
 
-export const snakeCase = (str: string): string => (
-  str
-  && str
+// TODO: Somehow, this turns P2PKHLock into p2pkh_lock, but P2PKH_Lock into p2_pkh_lock
+// export const snakeCase = (str: string): string => (
+//   str
+//   && str
+//     .match(
+//       /([A-Z]+\d*[A-Z]*(?=[A-Z][a-z])|[A-Z]?[a-z]+\d*[a-z]+|[A-Z]?[a-z]+\d*|[A-Z]+\d*|\d+)/g,
+//     )!
+//     .map((s) => s.toLowerCase())
+//     .join('_')
+// );
+
+export const titleCase = (str: string): string => {
+  if (!str) return '';
+  return str
     .match(
       /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g,
     )!
-    .map((s) => s.toLowerCase())
-    .join('_')
-);
+    .map((s) => s.charAt(0).toUpperCase() + s.slice(1).toLowerCase())
+    .join(' ');
+};
 
 // JSON.stringify version that can serialize otherwise unsupported types (bigint and Uint8Array)
 export const extendedStringify = (obj: any, spaces?: number): string => JSON.stringify(
@@ -363,3 +388,9 @@ export const extendedStringify = (obj: any, spaces?: number): string => JSON.str
 export const zip = <T, U>(a: readonly T[], b: readonly U[]): [T, U][] => (
   Array.from(Array(Math.max(b.length, a.length)), (_, i) => [a[i], b[i]])
 );
+
+export const isFungibleTokenUtxo = (utxo: Utxo): boolean => (
+  utxo.token !== undefined && utxo.token.amount > 0n && utxo.token.nft === undefined
+);
+
+export const isNonTokenUtxo = (utxo: Utxo): boolean => utxo.token === undefined;
diff --git a/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts b/packages/cashscript/test/TransactionBuilder.test.ts
similarity index 50%
rename from packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts
rename to packages/cashscript/test/TransactionBuilder.test.ts
index bd6ce3b2..59e94028 100644
--- a/packages/cashscript/test/e2e/transaction-builder/TransactionBuilder.test.ts
+++ b/packages/cashscript/test/TransactionBuilder.test.ts
@@ -1,5 +1,5 @@
 import { decodeTransactionUnsafe, hexToBin, stringify } from '@bitauth/libauth';
-import { Contract, SignatureTemplate, ElectrumNetworkProvider } from '../../../src/index.js';
+import { Contract, SignatureTemplate, ElectrumNetworkProvider, MockNetworkProvider } from '../src/index.js';
 import {
   bobAddress,
   bobPub,
@@ -8,16 +8,20 @@ import {
   carolPub,
   carolAddress,
   carolPriv,
-} from '../../fixture/vars.js';
-import { Network, Utxo } from '../../../src/interfaces.js';
-import { utxoComparator, calculateDust } from '../../../src/utils.js';
-import p2pkhArtifact from '../../fixture/p2pkh.json' with { type: 'json' };
-import twtArtifact from '../../fixture/transfer_with_timeout.json' with { type: 'json' };
-import { TransactionBuilder } from '../../../src/TransactionBuilder.js';
-import { getTxOutputs } from '../../test-util.js';
+  bobTokenAddress,
+} from './fixture/vars.js';
+import { Network } from '../src/interfaces.js';
+import { utxoComparator, calculateDust, randomUtxo, randomToken, isNonTokenUtxo, isFungibleTokenUtxo } from '../src/utils.js';
+import p2pkhArtifact from './fixture/p2pkh.json' with { type: 'json' };
+import twtArtifact from './fixture/transfer_with_timeout.json' with { type: 'json' };
+import { TransactionBuilder } from '../src/TransactionBuilder.js';
+import { gatherUtxos, getTxOutputs } from './test-util.js';
 
 describe('Transaction Builder', () => {
-  const provider = new ElectrumNetworkProvider(Network.CHIPNET);
+  const provider = process.env.TESTS_USE_MOCKNET
+    ? new MockNetworkProvider()
+    : new ElectrumNetworkProvider(Network.CHIPNET);
+
   let p2pkhInstance: Contract;
   let twtInstance: Contract;
 
@@ -27,6 +31,15 @@ describe('Transaction Builder', () => {
     twtInstance = new Contract(twtArtifact, [bobPub, carolPub, 100000n], { provider });
     console.log(p2pkhInstance.tokenAddress);
     console.log(twtInstance.tokenAddress);
+    (provider as any).addUtxo?.(p2pkhInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(p2pkhInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(p2pkhInstance.address, randomUtxo({ token: randomToken() }));
+    (provider as any).addUtxo?.(twtInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(twtInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(bobAddress, randomUtxo());
+    (provider as any).addUtxo?.(bobAddress, randomUtxo());
+    (provider as any).addUtxo?.(carolAddress, randomUtxo());
+    (provider as any).addUtxo?.(carolAddress, randomUtxo());
   });
 
   describe('should return the same transaction as the simple transaction builder', () => {
@@ -34,10 +47,10 @@ describe('Transaction Builder', () => {
       // given
       const to = p2pkhInstance.address;
       const amount = 1000n;
-      const fee = 1000n;
+      const fee = 2000n;
 
-      const utxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
-      const { utxos: gathered, total } = gatherUtxos(utxos, { amount });
+      const utxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
+      const { utxos: gathered, total } = gatherUtxos(utxos, { amount, fee });
 
       const change = total - amount - fee;
       const dustAmount = calculateDust({ to, amount: change });
@@ -53,10 +66,11 @@ describe('Transaction Builder', () => {
         .to(to, amount)
         .to(change > dustAmount ? [{ to, amount: change }] : [])
         .withoutChange()
+        .withoutTokenChange()
         .withTime(0)
         .build();
 
-      const advancedTransaction = await new TransactionBuilder({ provider })
+      const advancedTransaction = new TransactionBuilder({ provider })
         .addInputs(gathered, p2pkhInstance.unlock.spend(bobPub, new SignatureTemplate(bobPriv)))
         .addOutput({ to, amount })
         .addOutputs(change > dustAmount ? [{ to, amount: change }] : [])
@@ -73,10 +87,10 @@ describe('Transaction Builder', () => {
       // given
       const to = bobAddress;
       const amount = 10000n;
-      const fee = 1000n;
+      const fee = 2000n;
 
-      const contractUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
-      const bobUtxos = await getAddressUtxos(bobAddress);
+      const contractUtxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
+      const bobUtxos = await provider.getUtxos(bobAddress);
       const bobTemplate = new SignatureTemplate(bobPriv);
 
       const totalInputUtxos = [...contractUtxos.slice(0, 2), ...bobUtxos.slice(0, 2)];
@@ -100,10 +114,11 @@ describe('Transaction Builder', () => {
         .to(to, amount)
         .to(change > dustAmount ? [{ to, amount: change }] : [])
         .withoutChange()
+        .withoutTokenChange()
         .withTime(0)
         .build();
 
-      const advancedTransaction = await new TransactionBuilder({ provider })
+      const advancedTransaction = new TransactionBuilder({ provider })
         .addInput(bobUtxos[0], bobTemplate.unlockP2PKH())
         .addInput(contractUtxos[0], p2pkhInstance.unlock.spend(bobPub, bobTemplate))
         .addInput(bobUtxos[1], bobTemplate.unlockP2PKH())
@@ -124,9 +139,9 @@ describe('Transaction Builder', () => {
   it('should build a transaction that can spend from 2 different contracts and P2PKH + OP_RETURN', async () => {
     const fee = 1000n;
 
-    const carolUtxos = (await provider.getUtxos(carolAddress)).sort(utxoComparator).reverse();
-    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
-    const twtUtxos = (await twtInstance.getUtxos()).sort(utxoComparator).reverse();
+    const carolUtxos = (await provider.getUtxos(carolAddress)).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
+    const twtUtxos = (await twtInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
 
     const change = carolUtxos[0].satoshis - fee;
     const dustAmount = calculateDust({ to: carolAddress, amount: change });
@@ -141,22 +156,22 @@ describe('Transaction Builder', () => {
       throw new Error('Not enough funds to send transaction');
     }
 
-    const tx = await new TransactionBuilder({ provider })
+    const tx = new TransactionBuilder({ provider })
       .addInput(p2pkhUtxos[0], p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
       .addInput(twtUtxos[0], twtInstance.unlock.transfer(new SignatureTemplate(carolPriv)))
       .addInput(carolUtxos[0], new SignatureTemplate(carolPriv).unlockP2PKH())
       .addOpReturnOutput(['Hello new transaction builder'])
       .addOutputs(outputs)
-      .send();
+      .build();
 
-    const txOutputs = getTxOutputs(tx);
+    const txOutputs = getTxOutputs(decodeTransactionUnsafe(hexToBin(tx)));
     expect(txOutputs).toEqual(expect.arrayContaining(outputs));
   });
 
   it('should fail when fee is higher than maxFee', async () => {
     const fee = 2000n;
     const maxFee = 1000n;
-    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
 
     const amount = p2pkhUtxos[0].satoshis - fee;
     const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
@@ -165,19 +180,19 @@ describe('Transaction Builder', () => {
       throw new Error('Not enough funds to send transaction');
     }
 
-    const txPromise = new TransactionBuilder({ provider })
-      .addInput(p2pkhUtxos[0], p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
-      .addOutput({ to: p2pkhInstance.address, amount })
-      .setMaxFee(maxFee)
-      .send();
-
-    await expect(txPromise).rejects.toThrow(`Transaction fee of ${fee} is higher than max fee of ${maxFee}`);
+    expect(() => {
+      new TransactionBuilder({ provider })
+        .addInput(p2pkhUtxos[0], p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
+        .addOutput({ to: p2pkhInstance.address, amount })
+        .setMaxFee(maxFee)
+        .build();
+    }).toThrow(`Transaction fee of ${fee} is higher than max fee of ${maxFee}`);
   });
 
   it('should succeed when fee is lower than maxFee', async () => {
     const fee = 1000n;
     const maxFee = 2000n;
-    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
 
     const amount = p2pkhUtxos[0].satoshis - fee;
     const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
@@ -186,86 +201,66 @@ describe('Transaction Builder', () => {
       throw new Error('Not enough funds to send transaction');
     }
 
-    const tx = await new TransactionBuilder({ provider })
+    const tx = new TransactionBuilder({ provider })
       .addInput(p2pkhUtxos[0], p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
       .addOutput({ to: p2pkhInstance.address, amount })
       .setMaxFee(maxFee)
-      .send();
+      .build();
 
-    const txOutputs = getTxOutputs(tx);
-    expect(txOutputs).toEqual(expect.arrayContaining([{ to: p2pkhInstance.address, amount }]));
+    expect(tx).toBeDefined();
   });
 
-  it('should fail when locktime is higher than current block height', async () => {
-    const fee = 1000n;
-    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
+  // TODO: Consider improving error messages checked below to also include the input/output index
 
-    const amount = p2pkhUtxos[0].satoshis - fee;
-    const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
+  it('should fail when trying to send to invalid addres', async () => {
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
 
-    if (amount < dustAmount) {
-      throw new Error('Not enough funds to send transaction');
-    }
-
-    const blockHeight = await provider.getBlockHeight();
+    expect(() => {
+      new TransactionBuilder({ provider })
+        .addInput(p2pkhUtxos[0], p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
+        .addOutput({ to: bobAddress.slice(0, -1), amount: 1000n })
+        .build();
+    }).toThrow('CashAddress decoding error');
+  });
 
-    const txPromise = new TransactionBuilder({ provider })
-      .addInput(p2pkhUtxos[0], p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
-      .addOutput({ to: p2pkhInstance.address, amount })
-      .setLocktime(blockHeight + 100)
-      .send();
+  it('should fail when trying to send tokens to non-token address', async () => {
+    const tokenUtxo = (await p2pkhInstance.getUtxos()).find(isFungibleTokenUtxo)!;
 
-    await expect(txPromise).rejects.toThrow(/non-final transaction/);
+    expect(() => {
+      new TransactionBuilder({ provider })
+        .addInput(tokenUtxo, p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
+        .addOutput({ to: bobAddress, amount: 1000n, token: tokenUtxo.token })
+        .build();
+    }).toThrow('Tried to send tokens to an address without token support');
   });
 
-  it('should succeed when locktime is lower than current block height', async () => {
-    const fee = 1000n;
-    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
-
-    const amount = p2pkhUtxos[0].satoshis - fee;
-    const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
+  it('should fail when trying to send negative BCH amount or token amount', async () => {
+    const tokenUtxo = (await p2pkhInstance.getUtxos()).find(isFungibleTokenUtxo)!;
 
-    if (amount < dustAmount) {
-      throw new Error('Not enough funds to send transaction');
-    }
+    expect(() => {
+      new TransactionBuilder({ provider })
+        .addInput(tokenUtxo, p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
+        .addOutput({ to: bobTokenAddress, amount: -1000n, token: tokenUtxo.token })
+        .build();
+    }).toThrow('Tried to add an output with -1000 satoshis, which is less than the required minimum for this output-type');
 
-    const blockHeight = await provider.getBlockHeight();
+    expect(() => {
+      new TransactionBuilder({ provider })
+        .addInput(tokenUtxo, p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
+        .addOutput({ to: bobTokenAddress, amount: 1000n, token: { amount: -1000n, category: tokenUtxo.token!.category } })
+        .build();
+    }).toThrow('Tried to add an output with -1000 tokens, which is invalid');
+  });
 
-    const tx = await new TransactionBuilder({ provider })
-      .addInput(p2pkhUtxos[0], p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
-      .addOutput({ to: p2pkhInstance.address, amount })
-      .setLocktime(blockHeight - 100)
-      .send();
+  it('should fail when adding undefined input', async () => {
+    const p2pkhUtxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
+    const undefinedUtxo = p2pkhUtxos[1000];
 
-    const txOutputs = getTxOutputs(tx);
-    expect(txOutputs).toEqual(expect.arrayContaining([{ to: p2pkhInstance.address, amount }]));
+    expect(() => {
+      new TransactionBuilder({ provider })
+        .addInput(undefinedUtxo, p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
+        .addOutput({ to: bobAddress, amount: 1000n })
+        .build();
+    }).toThrow('Input is undefined');
   });
-
-  it.todo('test sequence numbers');
 });
-
-async function getAddressUtxos(address: string): Promise<Utxo[]> {
-  return new ElectrumNetworkProvider(Network.CHIPNET).getUtxos(address);
-}
-
-function gatherUtxos(
-  utxos: Utxo[],
-  options?: { amount?: bigint, fees?: bigint },
-): { utxos: Utxo[], total: bigint } {
-  const targetUtxos: Utxo[] = [];
-  let total = 0n;
-
-  // 1000 for fees
-  const { amount = 0n, fees = 1000n } = options ?? {};
-
-  for (const utxo of utxos) {
-    if (total - fees > amount) break;
-    total += utxo.satoshis;
-    targetUtxos.push(utxo);
-  }
-
-  return {
-    utxos: targetUtxos,
-    total,
-  };
-}
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 85d0ac69..88ed600a 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -1,262 +1,29 @@
-import { compileString } from 'cashc';
-import { Contract, MockNetworkProvider, SignatureAlgorithm, SignatureTemplate } from '../src/index.js';
-import {
-  alicePriv, alicePub, bobPriv,
-  bobPub,
-} from './fixture/vars.js';
+import { Contract, MockNetworkProvider, SignatureAlgorithm, SignatureTemplate, TransactionBuilder } from '../src/index.js';
+import { alicePriv, alicePub, bobPriv, bobPub } from './fixture/vars.js';
 import '../src/test/JestExtensions.js';
 import { randomUtxo } from '../src/utils.js';
 import { AuthenticationErrorCommon, binToHex, hexToBin } from '@bitauth/libauth';
-
-const CONTRACT_CODE = `
-contract Test() {
-  function test_logs() {
-    console.log("Hello World");
-    require(1 == 2);
-  }
-
-  function test_no_logs() {
-    require(1 == 2);
-  }
-
-  function test_require() {
-    require(1 == 2, "1 should equal 2");
-  }
-
-  function test_require_no_failure() {
-    require(1 == 1, "1 should equal 1");
-  }
-
-  function test_multiple_require_statements() {
-    require(1 == 2, "1 should equal 2");
-    require(1 == 1, "1 should equal 1");
-  }
-
-  function test_multiple_require_statements_final_fails() {
-    require(1 == 1, "1 should equal 1");
-    require(1 == 2, "1 should equal 2");
-  }
-
-  function test_multiple_require_statements_no_message_final() {
-    require(1 == 1, "1 should equal 1");
-    require(1 == 2);
-  }
-
-  function test_timeops_as_final_require() {
-    require(1 == 1, "1 should equal 1");
-    require(tx.time >= 100000000, "time should be HUGE");
-  }
-
-  function test_final_require_in_if_statement(int switch) {
-    if (switch == 1) {
-      int a = 2;
-      require(1 == a, "1 should equal 2");
-    } else if (switch == 2) {
-      int b = 3;
-      require(1 == b, "1 should equal 3");
-    } else {
-      int c = 4;
-      require(switch == c, "switch should equal 4");
-    }
-  }
-
-  function test_final_require_in_if_statement_with_deep_reassignment() {
-    int a = 0;
-    int b = 1;
-    int c = 2;
-    int d = 3;
-    int e = 4;
-    if (a == 0) {
-      a =
-        10 + 10;
-      require(a + b + c + d + e == 10, "sum should equal 10");
-    }
-  }
-
-  function test_invalid_split_range() {
-    bytes test = 0x1234;
-    bytes test2 = test.split(4)[0];
-    require(test2 == 0x1234);
-  }
-
-  function test_invalid_input_index() {
-    require(tx.inputs[5].value == 1000);
-  }
-
-  function test_fail_checksig(sig s, pubkey pk) {
-    require(checkSig(s, pk), "Signatures do not match");
-    require(1 == 2, "1 should equal 2");
-  }
-
-  function test_fail_checksig_final_verify(sig s, pubkey pk) {
-    require(checkSig(s, pk), "Signatures do not match");
-  }
-
-  function test_fail_checkdatasig(datasig s, bytes message, pubkey pk) {
-    require(checkDataSig(s, message, pk), "Data Signatures do not match");
-  }
-
-  function test_fail_checkmultisig(sig s1, pubkey pk1, sig s2, pubkey pk2) {
-    require(checkMultiSig([s1, s2], [pk1, pk2]), "Multi Signatures do not match");
-  }
-}
-`;
-
-const CONTRACT_CODE2 = `
-contract Test() {
-  function test_require_single_function() {
-    require(tx.outputs.length == 1, "should have 1 output");
-  }
-}`;
-
-const CONTRACT_CODE3 = `
-contract Test() {
-  // We test this because the cleanup looks different and the final OP_VERIFY isn't removed for these kinds of functions
-  function test_fail_large_cleanup() {
-    int a = 1;
-    int b = 2;
-    int c = 3;
-    int d = 4;
-    int e = 5;
-    int f = 6;
-    int g = 7;
-    int h = 8;
-
-    // Use all variables inside this if-statement so they do not get OP_ROLL'ed
-    if (
-    1
-      == 2
-    ) {
-      require(a + b + c + d + e + f + g + h == 1, "sum should equal 36");
-    }
-
-    require(1 == 2, "1 should equal 2");
-  }
-
-  function test_fail_multiline_require() {
-    require(
-      1 == 2,
-      "1 should equal 2"
-    );
-
-    require(1 == 1);
-  }
-
-  function test_fail_multiline_final_require() {
-    require(
-      1 == 2,
-      "1 should equal 2"
-    );
-  }
-
-  function test_multiline_non_require_error() {
-    int x =
-      tx.outputs[
-        5
-      ].value +
-      tx.inputs[5].value;
-    require(x == 1000);
-  }
-
-  function test_multiline_require_with_unary_op() {
-    require(
-      !(
-        0x000000
-        .reverse()
-        .length
-        !=
-        -(
-          30
-            +
-          15
-        )
-      )
-    );
-
-    require(1 == 1);
-  }
-
-  function test_multiline_require_with_instantiation() {
-    require(
-      new LockingBytecodeP2PKH(
-        hash160(0x000000)
-      )
-        ==
-      new LockingBytecodeNullData([
-        0x00,
-        bytes("hello world")
-      ])
-    );
-
-    require(1 == 1);
-  }
-}
-`;
-
-const CONTRACT_CODE_ZERO_HANDLING = `
-contract Test(int a) {
-  function test_zero_handling(int b) {
-    require(a == 0, "a should be 0");
-    require(b == 0, "b should be 0");
-    require(a == b, "a should equal b");
-  }
-}
-`;
+import {
+  artifactTestLogs,
+  artifactTestConsecutiveLogs,
+  artifactTestMultipleLogs,
+  artifactTestRequires,
+  artifactTestSingleFunction,
+  artifactTestMultilineRequires,
+  artifactTestZeroHandling,
+} from './fixture/debugging/debugging_contracts.js';
 
 describe('Debugging tests', () => {
   describe('console.log statements', () => {
-    const BASE_CONTRACT_CODE = `
-      contract Test(pubkey owner) {
-        function transfer(sig ownerSig, int num) {
-          console.log('Hello First Function');
-          require(checkSig(ownerSig, owner));
-
-          bytes2 beef = 0xbeef;
-          require(beef != 0xfeed);
-
-          console.log(ownerSig, owner, num, beef, 1, "test", true);
-
-          require(num == 1000);
-        }
-
-        function secondFunction() {
-          console.log("Hello Second Function");
-          require(1 == 1);
-        }
-
-        function functionWithIfStatement(int a) {
-          int b = 0;
-
-          if (a == 1) {
-            console.log("a is 1");
-            b = a;
-          } else {
-            console.log("a is not 1");
-            b = 2;
-          }
-
-          console.log('a equals', a);
-          console.log('b equals', b);
-
-          require(1 == 1);
-        }
-
-        function noLogs() {
-          require(1 == 1);
-        }
-      }
-    `;
-
-    const artifact = compileString(BASE_CONTRACT_CODE);
     const provider = new MockNetworkProvider();
+    const contractTestLogs = new Contract(artifactTestLogs, [alicePub], { provider });
+    const contractUtxo = randomUtxo();
+    provider.addUtxo(contractTestLogs.address, contractUtxo);
 
     it('should log correct values', async () => {
-      const contract = new Contract(artifact, [alicePub], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions
-        .transfer(new SignatureTemplate(alicePriv), 1000n)
-        .to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contractTestLogs.unlock.transfer(new SignatureTemplate(alicePriv), 1000n))
+        .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
       // console.log(ownerSig, owner, num, beef, 1, "test", true);
       const expectedLog = new RegExp(`^Test.cash:10 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
@@ -264,13 +31,10 @@ describe('Debugging tests', () => {
     });
 
     it('should log when logging happens before a failing require statement', async () => {
-      const contract = new Contract(artifact, [alicePub], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
       const incorrectNum = 100n;
-      const transaction = contract.functions
-        .transfer(new SignatureTemplate(alicePriv), incorrectNum)
-        .to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contractTestLogs.unlock.transfer(new SignatureTemplate(alicePriv), incorrectNum))
+        .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
       // console.log(ownerSig, owner, num, beef, 1, "test", true);
       const expectedLog = new RegExp(`^Test.cash:10 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100 0xbeef 1 test true$`);
@@ -278,46 +42,37 @@ describe('Debugging tests', () => {
     });
 
     it('should not log when logging happens after a failing require statement', async () => {
-      const contract = new Contract(artifact, [alicePub], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
       const incorrectPriv = bobPriv;
-      const transaction = contract.functions
-        .transfer(new SignatureTemplate(incorrectPriv), 1000n)
-        .to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contractTestLogs.unlock.transfer(new SignatureTemplate(incorrectPriv), 1000n))
+        .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
       const expectedLog = new RegExp(`^Test.cash:10 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
       await expect(transaction).not.toLog(expectedLog);
     });
 
     it('should only log console.log statements from the called function', async () => {
-      const contract = new Contract(artifact, [alicePub], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions
-        .secondFunction()
-        .to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contractTestLogs.unlock.secondFunction())
+        .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
       await expect(transaction).toLog(new RegExp('^Test.cash:16 Hello Second Function$'));
       await expect(transaction).not.toLog(/Hello First Function/);
     });
 
     it('should only log console.log statements from the chosen branch in if-statement', async () => {
-      const contract = new Contract(artifact, [alicePub], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction1 = contract.functions
-        .functionWithIfStatement(1n)
-        .to(contract.address, 10000n);
+      const transaction1 = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contractTestLogs.unlock.functionWithIfStatement(1n))
+        .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
       await expect(transaction1).toLog(new RegExp('^Test.cash:24 a is 1$'));
       await expect(transaction1).toLog(new RegExp('^Test.cash:31 a equals 1$'));
       await expect(transaction1).toLog(new RegExp('^Test.cash:32 b equals 1$'));
       await expect(transaction1).not.toLog(/a is not 1/);
 
-      const transaction2 = contract.functions
-        .functionWithIfStatement(2n)
-        .to(contract.address, 10000n);
+      const transaction2 = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contractTestLogs.unlock.functionWithIfStatement(2n))
+        .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
       await expect(transaction2).toLog(new RegExp('^Test.cash:27 a is not 1$'));
       await expect(transaction2).toLog(new RegExp('^Test.cash:31 a equals 2$'));
@@ -326,31 +81,14 @@ describe('Debugging tests', () => {
     });
 
     it('should log multiple consecutive console.log statements on separate lines', async () => {
-      const contractCode = `
-        contract Test(pubkey owner) {
-          function transfer(sig ownerSig, int num) {
-            require(checkSig(ownerSig, owner));
-
-            bytes2 beef = 0xbeef;
-            require(beef != 0xfeed);
-
-            console.log(ownerSig, owner, num);
-            console.log(beef, 1, "test", true);
-
-            require(num == 1000);
-          }
-        }
-      `;
-
-      const artifact2 = compileString(contractCode);
-
-      const contract = new Contract(artifact2, [alicePub], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const contractTestConsecutiveLogs = new Contract(artifactTestConsecutiveLogs, [alicePub], { provider });
+      const utxo = randomUtxo();
+      provider.addUtxo(contractTestConsecutiveLogs.address, utxo);
 
       const incorrectNum = 100n;
-      const transaction = contract.functions
-        .transfer(new SignatureTemplate(alicePriv), incorrectNum)
-        .to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(utxo, contractTestConsecutiveLogs.unlock.transfer(new SignatureTemplate(alicePriv), incorrectNum))
+        .addOutput({ to: contractTestConsecutiveLogs.address, amount: 10000n });
 
       // console.log(ownerSig, owner, num, beef);
       await expect(transaction).toLog(new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100$`));
@@ -359,32 +97,14 @@ describe('Debugging tests', () => {
     });
 
     it('should log multiple console.log statements with other statements in between', async () => {
-      const contractCode = `
-        contract Test(pubkey owner) {
-          function transfer(sig ownerSig, int num) {
-            require(checkSig(ownerSig, owner));
-
-            console.log(ownerSig, owner, num);
-
-            bytes2 beef = 0xbeef;
-            require(beef != 0xfeed);
-
-            console.log(beef, 1, "test", true);
-
-            require(num == 1000);
-          }
-        }
-      `;
-
-      const artifact2 = compileString(contractCode);
-
-      const contract = new Contract(artifact2, [alicePub], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const contractTestMultipleLogs = new Contract(artifactTestMultipleLogs, [alicePub], { provider });
+      const utxo = randomUtxo();
+      provider.addUtxo(contractTestMultipleLogs.address, utxo);
 
       const incorrectNum = 100n;
-      const transaction = contract.functions
-        .transfer(new SignatureTemplate(alicePriv), incorrectNum)
-        .to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(utxo, contractTestMultipleLogs.unlock.transfer(new SignatureTemplate(alicePriv), incorrectNum))
+        .addOutput({ to: contractTestMultipleLogs.address, amount: 10000n });
 
       // console.log(ownerSig, owner, num);
       const expectedFirstLog = new RegExp(`^Test.cash:6 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100$`);
@@ -396,39 +116,46 @@ describe('Debugging tests', () => {
   });
 
   describe('require statements', () => {
-    const artifact = compileString(CONTRACT_CODE);
-    const artifact2 = compileString(CONTRACT_CODE2);
-    const artifact3 = compileString(CONTRACT_CODE3);
     const provider = new MockNetworkProvider();
+    const contractTestRequires = new Contract(artifactTestRequires, [], { provider });
+    const contractTestRequiresUtxo = randomUtxo();
+    provider.addUtxo(contractTestRequires.address, contractTestRequiresUtxo);
+
+    const contractTestMultiLineRequires = new Contract(artifactTestMultilineRequires, [], { provider });
+    const contractTestMultiLineRequiresUtxo = randomUtxo();
+    provider.addUtxo(contractTestMultiLineRequires.address, contractTestMultiLineRequiresUtxo);
 
     // test_require
     it('should fail with error message when require statement fails in a multi-function contract', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_require())
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      const transaction = contract.functions.test_require().to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith('Test.cash:13 Require statement failed at input 0 in contract Test.cash at line 13 with the following message: 1 should equal 2.');
       await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
     });
 
     // test_require_single_function
     it('should fail with error message when require statement fails in single function', async () => {
-      const contract = new Contract(artifact2, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const contractSingleFunction = new Contract(artifactTestSingleFunction, [], { provider });
+      const contractSingleFunctionUtxo = randomUtxo();
+      provider.addUtxo(contractSingleFunction.address, contractSingleFunctionUtxo);
+
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractSingleFunctionUtxo, contractSingleFunction.unlock.test_require_single_function())
+        .addOutput({ to: contractSingleFunction.address, amount: 1000n })
+        .addOutput({ to: contractSingleFunction.address, amount: 1000n });
 
-      const transaction = contract.functions.test_require_single_function()
-        .to(contract.address, 1000n)
-        .to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith('Test.cash:4 Require statement failed at input 0 in contract Test.cash at line 4 with the following message: should have 1 output.');
       await expect(transaction).toFailRequireWith('Failing statement: require(tx.outputs.length == 1, "should have 1 output")');
     });
 
     // test_multiple_require_statements
     it('it should only fail with correct error message when there are multiple require statements', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_multiple_require_statements())
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      const transaction = contract.functions.test_multiple_require_statements().to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith('Test.cash:21 Require statement failed at input 0 in contract Test.cash at line 21 with the following message: 1 should equal 2.');
       await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
       await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
@@ -436,30 +163,28 @@ describe('Debugging tests', () => {
 
     // test_multiple_require_statements_final_fails
     it('it should only fail with correct error message when there are multiple require statements where the final statement fails', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_multiple_require_statements_final_fails())
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      const transaction = contract.functions.test_multiple_require_statements_final_fails().to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith('Test.cash:27 Require statement failed at input 0 in contract Test.cash at line 27 with the following message: 1 should equal 2.');
       await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
       await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
     it('should not fail if no require statements fail', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_require_no_failure())
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      const transaction = contract.functions.test_require_no_failure().to(contract.address, 1000n);
       await expect(transaction).not.toFailRequire();
     });
 
     // test_multiple_require_statements_no_message_final
     it('should fail without custom message if the final require statement does not have a message', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions
-        .test_multiple_require_statements_no_message_final().to(contract.address, 1000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_multiple_require_statements_no_message_final())
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
       await expect(transaction).toFailRequireWith('Test.cash:32 Require statement failed at input 0 in contract Test.cash at line 32.');
       await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2)');
@@ -468,10 +193,9 @@ describe('Debugging tests', () => {
 
     // test_timeops_as_final_require
     it('should fail with correct error message for the final TimeOp require statement', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions.test_timeops_as_final_require().to(contract.address, 1000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_timeops_as_final_require())
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
       await expect(transaction).toFailRequireWith('Test.cash:37 Require statement failed at input 0 in contract Test.cash at line 37 with the following message: time should be HUGE.');
       await expect(transaction).toFailRequireWith('Failing statement: require(tx.time >= 100000000, "time should be HUGE")');
@@ -480,26 +204,23 @@ describe('Debugging tests', () => {
 
     // test_final_require_in_if_statement
     it('should fail with correct error message for the final require statement in an if statement', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transactionIfBranch = contract.functions
-        .test_final_require_in_if_statement(1n)
-        .to(contract.address, 1000n);
+      const transactionIfBranch = new TransactionBuilder({ provider })
+        .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_final_require_in_if_statement(1n))
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
       await expect(transactionIfBranch).toFailRequireWith('Test.cash:43 Require statement failed at input 0 in contract Test.cash at line 43 with the following message: 1 should equal 2.');
       await expect(transactionIfBranch).toFailRequireWith('Failing statement: require(1 == a, "1 should equal 2")');
 
-      const transactionElseIfBranch = contract.functions
-        .test_final_require_in_if_statement(2n)
-        .to(contract.address, 1000n);
+      const transactionElseIfBranch = new TransactionBuilder({ provider })
+        .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_final_require_in_if_statement(2n))
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
       await expect(transactionElseIfBranch).toFailRequireWith('Test.cash:46 Require statement failed at input 0 in contract Test.cash at line 46 with the following message: 1 should equal 3.');
       await expect(transactionElseIfBranch).toFailRequireWith('Failing statement: require(1 == b, "1 should equal 3")');
 
-      const transactionElseBranch = contract.functions
-        .test_final_require_in_if_statement(3n)
-        .to(contract.address, 1000n);
+      const transactionElseBranch = new TransactionBuilder({ provider })
+        .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_final_require_in_if_statement(3n))
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
       await expect(transactionElseBranch).toFailRequireWith('Test.cash:49 Require statement failed at input 0 in contract Test.cash at line 49 with the following message: switch should equal 4.');
       await expect(transactionElseBranch).toFailRequireWith('Failing statement: require(switch == c, "switch should equal 4")');
@@ -507,12 +228,12 @@ describe('Debugging tests', () => {
 
     // test_final_require_in_if_statement_with_deep_reassignment
     it('should fail with correct error message for the final require statement in an if statement with a deep reassignment', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions
-        .test_final_require_in_if_statement_with_deep_reassignment()
-        .to(contract.address, 1000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_final_require_in_if_statement_with_deep_reassignment(),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
       await expect(transaction).toFailRequireWith('Test.cash:62 Require statement failed at input 0 in contract Test.cash at line 62 with the following message: sum should equal 10.');
       await expect(transaction).toFailRequireWith('Failing statement: require(a + b + c + d + e == 10, "sum should equal 10")');
@@ -520,19 +241,22 @@ describe('Debugging tests', () => {
 
     // test_fail_checksig
     it('should fail with correct error message when checkSig fails', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const checkSigTransaction = contract.functions
-        .test_fail_checksig(new SignatureTemplate(alicePriv), bobPub)
-        .to(contract.address, 1000n);
+      const checkSigTransaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_fail_checksig(new SignatureTemplate(alicePriv), bobPub),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
       await expect(checkSigTransaction).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
       await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
 
-      const checkSigTransactionNullSignature = contract.functions
-        .test_fail_checksig(hexToBin(''), bobPub)
-        .to(contract.address, 1000n);
+      const checkSigTransactionNullSignature = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_fail_checksig(hexToBin(''), bobPub),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
       await expect(checkSigTransactionNullSignature).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
       await expect(checkSigTransactionNullSignature).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
@@ -540,66 +264,80 @@ describe('Debugging tests', () => {
 
     // test_fail_checksig_final_verify
     it('should fail with correct error message when checkSig fails as the final verify', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const checkSigTransaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_fail_checksig_final_verify(new SignatureTemplate(alicePriv), bobPub),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      const checkSigTransaction = contract.functions
-        .test_fail_checksig_final_verify(new SignatureTemplate(alicePriv), bobPub).to(contract.address, 1000n);
       await expect(checkSigTransaction).toFailRequireWith('Test.cash:82 Require statement failed at input 0 in contract Test.cash at line 82 with the following message: Signatures do not match.');
       await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
     });
 
     // test_fail_checkdatasig
     it('should fail with correct error message when checkDataSig fails', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const checkDataSigTransaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xbeef')).slice(0, -1), '0xbeef', bobPub),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      const checkDataSigTransaction = contract.functions
-        .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xbeef')).slice(0, -1), '0xbeef', bobPub)
-        .to(contract.address, 1000n);
       await expect(checkDataSigTransaction).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
       await expect(checkDataSigTransaction).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
 
-      const checkDataSigTransactionWrongMessage = contract.functions
-        .test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xc0ffee')).slice(0, -1), '0xbeef', alicePub)
-        .to(contract.address, 1000n);
+      const checkDataSigTransactionWrongMessage = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_fail_checkdatasig(new SignatureTemplate(alicePriv).generateSignature(hexToBin('0xc0ffee')).slice(0, -1), '0xbeef', alicePub),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
+
       await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
       await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
     });
 
     // test_fail_checkmultisig
     it('should fail with correct error message when checkMultiSig fails', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const checkmultiSigTransaction = contract.functions
-        .test_fail_checkmultisig(
-          new SignatureTemplate(alicePriv, undefined, SignatureAlgorithm.ECDSA),
-          bobPub,
-          new SignatureTemplate(bobPriv, undefined, SignatureAlgorithm.ECDSA),
-          alicePub,
+      const checkmultiSigTransaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_fail_checkmultisig(
+            new SignatureTemplate(alicePriv, undefined, SignatureAlgorithm.ECDSA),
+            bobPub,
+            new SignatureTemplate(bobPriv, undefined, SignatureAlgorithm.ECDSA),
+            alicePub,
+          ),
         )
-        .to(contract.address, 1000n);
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
+
       await expect(checkmultiSigTransaction).toFailRequireWith('Test.cash:90 Require statement failed at input 0 in contract Test.cash at line 90 with the following message: Multi Signatures do not match.');
       await expect(checkmultiSigTransaction).toFailRequireWith('Failing statement: require(checkMultiSig([s1, s2], [pk1, pk2]), "Multi Signatures do not match")');
     });
 
     // test_fail_large_cleanup
     it('should fail with correct error message when a require statement fails in a function with a large cleanup', async () => {
-      const contract = new Contract(artifact3, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestMultiLineRequiresUtxo,
+          contractTestMultiLineRequires.unlock.test_fail_large_cleanup(),
+        )
+        .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      const transaction = contract.functions.test_fail_large_cleanup().to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith('Test.cash:22 Require statement failed at input 0 in contract Test.cash at line 22 with the following message: 1 should equal 2.');
       await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
     });
 
     // test_fail_multiline_require
     it('should fail with correct error message and statement when a multiline require statement fails', async () => {
-      const contract = new Contract(artifact3, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestMultiLineRequiresUtxo,
+          contractTestMultiLineRequires.unlock.test_fail_multiline_require(),
+        )
+        .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      const transaction = contract.functions.test_fail_multiline_require().to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith('Test.cash:26 Require statement failed at input 0 in contract Test.cash at line 26 with the following message: 1 should equal 2.');
       await expect(transaction).toFailRequireWith(`Failing statement: require(
       1 == 2,
@@ -609,10 +347,13 @@ describe('Debugging tests', () => {
 
     // test_fail_multiline_final_require
     it('should fail with correct error message and statement when a multiline final require statement fails', async () => {
-      const contract = new Contract(artifact3, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestMultiLineRequiresUtxo,
+          contractTestMultiLineRequires.unlock.test_fail_multiline_final_require(),
+        )
+        .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      const transaction = contract.functions.test_fail_multiline_final_require().to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith('Test.cash:36 Require statement failed at input 0 in contract Test.cash at line 36 with the following message: 1 should equal 2.');
       await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
     });
@@ -620,10 +361,13 @@ describe('Debugging tests', () => {
     // test_multiline_require_with_unary_op
     // Note that we add this test, because we changed the LocationHint for all Unary Ops to "END"
     it('should fail with correct error message and statement when a multiline require statement with a unary op fails', async () => {
-      const contract = new Contract(artifact3, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestMultiLineRequiresUtxo,
+          contractTestMultiLineRequires.unlock.test_multiline_require_with_unary_op(),
+        )
+        .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      const transaction = contract.functions.test_multiline_require_with_unary_op().to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith('Test.cash:51 Require statement failed at input 0 in contract Test.cash at line 51.');
       await expect(transaction).toFailRequireWith(`Failing statement: require(
       !(
@@ -642,10 +386,13 @@ describe('Debugging tests', () => {
 
     // test_multiline_require_with_instantiation
     it('should fail with correct error message and statement when a multiline require statement with an instantiation fails', async () => {
-      const contract = new Contract(artifact3, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestMultiLineRequiresUtxo,
+          contractTestMultiLineRequires.unlock.test_multiline_require_with_instantiation(),
+        )
+        .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      const transaction = contract.functions.test_multiline_require_with_instantiation().to(contract.address, 1000n);
       await expect(transaction).toFailRequireWith('Test.cash:69 Require statement failed at input 0 in contract Test.cash at line 69.');
       await expect(transaction).toFailRequireWith(`Failing statement: require(
       new LockingBytecodeP2PKH(
@@ -661,17 +408,24 @@ describe('Debugging tests', () => {
   });
 
   describe('Non-require error messages', () => {
-    const artifact = compileString(CONTRACT_CODE);
-    const artifact3 = compileString(CONTRACT_CODE3);
     const provider = new MockNetworkProvider();
 
+    const contractTestRequires = new Contract(artifactTestRequires, [], { provider });
+    const contractTestRequiresUtxo = randomUtxo();
+    provider.addUtxo(contractTestRequires.address, contractTestRequiresUtxo);
+
+    const contractTestMultiLineRequires = new Contract(artifactTestMultilineRequires, [], { provider });
+    const contractTestMultiLineRequiresUtxo = randomUtxo();
+    provider.addUtxo(contractTestMultiLineRequires.address, contractTestMultiLineRequiresUtxo);
+
     // test_invalid_split_range
     it('should fail with correct error message when an invalid OP_SPLIT range is used', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transactionPromise = contract.functions.test_invalid_split_range()
-        .to(contract.address, 1000n)
+      const transactionPromise = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_invalid_split_range(),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 1000n })
         .debug();
 
       await expect(transactionPromise).rejects.toThrow('Test.cash:68 Error in transaction at input 0 in contract Test.cash at line 68.');
@@ -681,11 +435,12 @@ describe('Debugging tests', () => {
 
     // test_invalid_input_index
     it('should fail with correct error message when an invalid input index is used', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transactionPromise = contract.functions.test_invalid_input_index()
-        .to(contract.address, 1000n)
+      const transactionPromise = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_invalid_input_index(),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 1000n })
         .debug();
 
       await expect(transactionPromise).rejects.toThrow('Test.cash:73 Error in transaction at input 0 in contract Test.cash at line 73.');
@@ -695,12 +450,12 @@ describe('Debugging tests', () => {
 
     // test_multiline_non_require_error
     it('should fail with correct error message and statement when a multiline non-require statement fails', async () => {
-      const contract = new Contract(artifact3, [], { provider });
-
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transactionPromise = contract.functions.test_multiline_non_require_error()
-        .to(contract.address, 1000n)
+      const transactionPromise = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestMultiLineRequiresUtxo,
+          contractTestMultiLineRequires.unlock.test_multiline_non_require_error(),
+        )
+        .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n })
         .debug();
 
       await expect(transactionPromise).rejects.toThrow('Test.cash:43 Error in transaction at input 0 in contract Test.cash at line 43.');
@@ -712,30 +467,37 @@ describe('Debugging tests', () => {
   });
 
   describe('Template encoding', () => {
-    const artifact = compileString(CONTRACT_CODE_ZERO_HANDLING);
     const provider = new MockNetworkProvider();
 
     // test_zero_handling
     it('should encode a locking and unlocking parameter of value 0 correctly and evaluate the execution', async () => {
-      const contract = new Contract(artifact, [0n], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const contract = new Contract(artifactTestZeroHandling, [0n], { provider });
+      const contractUtxo = randomUtxo();
+      provider.addUtxo(contract.address, contractUtxo);
+
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contract.unlock.test_zero_handling(0n))
+        .addOutput({ to: contract.address, amount: 1000n });
 
-      const transaction = contract.functions.test_zero_handling(0n).to(contract.address, 1000n);
       await expect(transaction).not.toFailRequire();
     });
   });
 
   describe('JestExtensions', () => {
-    const artifact = compileString(CONTRACT_CODE);
     const provider = new MockNetworkProvider();
+    const contractTestRequires = new Contract(artifactTestRequires, [], { provider });
+    const contractTestRequiresUtxo = randomUtxo();
+    provider.addUtxo(contractTestRequires.address, contractTestRequiresUtxo);
 
     // Note: happy cases are implicitly tested by the "regular" debugging tests, since the use JestExtensions
 
     it('should fail the JestExtensions test if an incorrect log is expected', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions.test_logs().to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_logs(),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
@@ -744,10 +506,12 @@ describe('Debugging tests', () => {
     });
 
     it('should fail the JestExtensions test if a log is logged that is NOT expected', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions.test_logs().to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_logs(),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
@@ -760,10 +524,12 @@ describe('Debugging tests', () => {
     });
 
     it('should fail the JestExtensions test if a log is expected where no log is logged', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions.test_no_logs().to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_no_logs(),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
@@ -772,10 +538,12 @@ describe('Debugging tests', () => {
     });
 
     it('should fail the JestExtensions test if an incorrect require error message is expected', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions.test_require().to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_require(),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
@@ -784,10 +552,12 @@ describe('Debugging tests', () => {
     });
 
     it('should fail the JestExtensions test if a require error message is expected where no error is thrown', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions.test_require_no_failure().to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_require_no_failure(),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
@@ -796,10 +566,12 @@ describe('Debugging tests', () => {
     });
 
     it('should fail the JestExtensions test if an error is thrown where it is NOT expected', async () => {
-      const contract = new Contract(artifact, [], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
-
-      const transaction = contract.functions.test_require().to(contract.address, 10000n);
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(
+          contractTestRequiresUtxo,
+          contractTestRequires.unlock.test_require(),
+        )
+        .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
       await expect(
diff --git a/packages/cashscript/test/e2e/Announcement.test.ts b/packages/cashscript/test/e2e/Announcement.test.ts
index 2821362d..9f33f65a 100644
--- a/packages/cashscript/test/e2e/Announcement.test.ts
+++ b/packages/cashscript/test/e2e/Announcement.test.ts
@@ -1,59 +1,50 @@
-import {
-  Contract, ElectrumNetworkProvider, MockNetworkProvider, Network,
-} from '../../src/index.js';
+import { Contract, ElectrumNetworkProvider, MockNetworkProvider, Network, TransactionBuilder } from '../../src/index.js';
 import { getLargestUtxo, getTxOutputs } from '../test-util.js';
 import { FailedRequireError } from '../../src/Errors.js';
 import { createOpReturnOutput, randomUtxo } from '../../src/utils.js';
 import { aliceAddress } from '../fixture/vars.js';
-import artifact from '../fixture/announcement.json' with { type: 'json' };
+import artifact from '../fixture/announcement.artifact.js';
 
 describe('Announcement', () => {
-  let announcement: Contract;
+  const provider = process.env.TESTS_USE_MOCKNET
+    ? new MockNetworkProvider()
+    : new ElectrumNetworkProvider(Network.CHIPNET);
+  const announcement = new Contract(artifact, [], { provider });
   const minerFee = 1000n;
 
   beforeAll(() => {
-    const provider = process.env.TESTS_USE_MOCKNET
-      ? new MockNetworkProvider()
-      : new ElectrumNetworkProvider(Network.CHIPNET);
-    announcement = new Contract(artifact, [], { provider });
     console.log(announcement.address);
     (provider as any).addUtxo?.(announcement.address, randomUtxo());
   });
 
   describe('send', () => {
-    it('should fail when trying to send money', async () => {
+    it('should fail when trying to send money ', async () => {
       // given
       const to = announcement.address;
       const amount = 1000n;
-
-      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
+      const contractUtxo = getLargestUtxo(await announcement.getUtxos());
 
       // when
-      const txPromise = announcement.functions
-        .announce()
-        .from(largestUtxo)
-        .to(to, amount)
-        .withHardcodedFee(minerFee)
-        .withMinChange(minerFee)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, announcement.unlock.announce())
+        .addOutput({ to, amount })
         .send();
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow();
+      await expect(txPromise).rejects.toThrow('Announcement.cash:16 Require statement failed at input 0 in contract Announcement.cash at line 16.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(tx.outputs[0].value == 0)');
     });
 
     it('should fail when trying to announce incorrect announcement', async () => {
       // given
       const str = 'A contract may injure a human being and, through inaction, allow a human being to come to harm.';
-      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
+      const contractUtxo = getLargestUtxo(await announcement.getUtxos());
 
       // when
-      const txPromise = announcement.functions
-        .announce()
-        .from(largestUtxo)
-        .withOpReturn(['0x6d02', str])
-        .withHardcodedFee(minerFee)
-        .withMinChange(minerFee)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, announcement.unlock.announce())
+        .addOutput(createOpReturnOutput(['0x6d02', str]))
         .send();
 
       // then
@@ -65,15 +56,15 @@ describe('Announcement', () => {
     it('should fail when sending incorrect amount of change', async () => {
       // given
       const str = 'A contract may not injure a human being or, through inaction, allow a human being to come to harm.';
-      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
+      const contractUtxo = getLargestUtxo(await announcement.getUtxos());
+      const changeAmount = contractUtxo.satoshis - minerFee;
+      const incorrectChangeAmount = changeAmount * 2n;
 
       // when
-      const txPromise = announcement.functions
-        .announce()
-        .from(largestUtxo)
-        .withOpReturn(['0x6d02', str])
-        .withHardcodedFee(minerFee * 2n)
-        .withMinChange(minerFee)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, announcement.unlock.announce())
+        .addOutput(createOpReturnOutput(['0x6d02', str]))
+        .addOutput({ to: announcement.address, amount: incorrectChangeAmount })
         .send();
 
       // then
@@ -85,17 +76,14 @@ describe('Announcement', () => {
     it('should fail when sending the correct change amount to an incorrect address', async () => {
       // given
       const str = 'A contract may not injure a human being or, through inaction, allow a human being to come to harm.';
-      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
-      const changeAmount = largestUtxo?.satoshis - minerFee;
+      const contractUtxo = getLargestUtxo(await announcement.getUtxos());
+      const changeAmount = contractUtxo.satoshis - minerFee;
 
       // when
-      const txPromise = announcement.functions
-        .announce()
-        .from(largestUtxo)
-        .withOpReturn(['0x6d02', str])
-        .to(aliceAddress, changeAmount)
-        .withHardcodedFee(minerFee)
-        .withoutChange()
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, announcement.unlock.announce())
+        .addOutput(createOpReturnOutput(['0x6d02', str]))
+        .addOutput({ to: aliceAddress, amount: changeAmount })
         .send();
 
       // then
@@ -107,15 +95,14 @@ describe('Announcement', () => {
     it('should succeed when announcing correct announcement', async () => {
       // given
       const str = 'A contract may not injure a human being or, through inaction, allow a human being to come to harm.';
-      const largestUtxo = getLargestUtxo(await announcement.getUtxos());
+      const contractUtxo = getLargestUtxo(await announcement.getUtxos());
+      const changeAmount = contractUtxo.satoshis - minerFee;
 
       // when
-      const tx = await announcement.functions
-        .announce()
-        .from(largestUtxo)
-        .withOpReturn(['0x6d02', str])
-        .withHardcodedFee(minerFee)
-        .withMinChange(minerFee)
+      const tx = await new TransactionBuilder({ provider })
+        .addInput(contractUtxo, announcement.unlock.announce())
+        .addOutput(createOpReturnOutput(['0x6d02', str]))
+        .addOutput({ to: announcement.address, amount: changeAmount })
         .send();
 
       // then
diff --git a/packages/cashscript/test/e2e/BigInt.test.ts b/packages/cashscript/test/e2e/BigInt.test.ts
index dcd5cd9a..0c256fcb 100644
--- a/packages/cashscript/test/e2e/BigInt.test.ts
+++ b/packages/cashscript/test/e2e/BigInt.test.ts
@@ -4,87 +4,61 @@ import {
   FailedRequireError,
   ElectrumNetworkProvider,
   Network,
+  TransactionBuilder,
 } from '../../src/index.js';
-import { getTxOutputs } from '../test-util.js';
-import artifact from '../fixture/bigint.json' with { type: 'json' };
+import artifact from '../fixture/bigint.artifact.js';
 import { randomUtxo } from '../../src/utils.js';
+import { gatherUtxos } from '../test-util.js';
 
 describe('BigInt', () => {
-  let bigintContract: Contract;
-  const MAX_INT32 = BigInt('2147483647');
+  const provider = process.env.TESTS_USE_MOCKNET
+    ? new MockNetworkProvider()
+    : new ElectrumNetworkProvider(Network.CHIPNET);
+  const bigintContract = new Contract(artifact, [], { provider });
   const MAX_INT64 = BigInt('9223372036854775807');
 
   beforeAll(() => {
-    const provider = process.env.TESTS_USE_MOCKNET
-      ? new MockNetworkProvider()
-      : new ElectrumNetworkProvider(Network.CHIPNET);
-    bigintContract = new Contract(artifact, [], { provider });
     console.log(bigintContract.address);
     (provider as any).addUtxo?.(bigintContract.address, randomUtxo());
   });
 
   describe('proofOfBigInt', () => {
-    it('should fail require statement when providing a number that fits within 32 bits', async () => {
+    it('should fail require statement when providing a number that fits within 64 bits', async () => {
       // given
       const to = bigintContract.address;
       const amount = 1000n;
+      const { utxos, changeAmount } = gatherUtxos(await bigintContract.getUtxos(), { amount });
 
       // when
-      const txPromise = bigintContract.functions
-        .proofOfBigInt(MAX_INT32, 10n)
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, bigintContract.unlock.proofOfBigInt(MAX_INT64, 10n))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
       await expect(txPromise).rejects.toThrow('BigInt.cash:4 Require statement failed at input 0 in contract BigInt.cash at line 4');
-      await expect(txPromise).rejects.toThrow('Failing statement: require(x >= maxInt32PlusOne)');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(x >= maxInt64PlusOne)');
     });
 
     it('should succeed when providing numbers that are larger than 64 bits when multiplied', async () => {
       // given
       const to = bigintContract.address;
       const amount = 1000n;
+      const { utxos, changeAmount } = gatherUtxos(await bigintContract.getUtxos(), { amount });
 
       // when
-      const txPromise = bigintContract.functions
-        .proofOfBigInt(MAX_INT64 / 9n, 10n)
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, bigintContract.unlock.proofOfBigInt(MAX_INT64 * 2n, MAX_INT64 + 2n))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
       await expect(txPromise).resolves.not.toThrow();
     });
 
-    it('should succeed when providing a number that does not fit within 64 bits', async () => {
-      // given
-      const to = bigintContract.address;
-      const amount = 1000n;
-
-      // when
-      const txPromise = bigintContract.functions
-        .proofOfBigInt(MAX_INT64 + 1n, 10n)
-        .to(to, amount)
-        .send();
-
-      // then
-      await expect(txPromise).resolves.not.toThrow();
-    });
-
-    it('should succeed when providing a number within 32b < x < 64b', async () => {
-      // given
-      const to = bigintContract.address;
-      const amount = 1000n;
-
-      // when
-      const tx = await bigintContract.functions
-        .proofOfBigInt(MAX_INT32 + 1n, 10n)
-        .to(to, amount)
-        .send();
-
-      // then
-      const txOutputs = getTxOutputs(tx);
-      expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-    });
+    it.todo('should fail when contract exceeds the maximum compute budget');
   });
 });
diff --git a/packages/cashscript/test/e2e/HodlVault.test.ts b/packages/cashscript/test/e2e/HodlVault.test.ts
index d62156b0..f9ef0a92 100644
--- a/packages/cashscript/test/e2e/HodlVault.test.ts
+++ b/packages/cashscript/test/e2e/HodlVault.test.ts
@@ -4,6 +4,7 @@ import {
   MockNetworkProvider,
   ElectrumNetworkProvider,
   Network,
+  TransactionBuilder,
 } from '../../src/index.js';
 import {
   alicePriv,
@@ -11,19 +12,18 @@ import {
   oracle,
   oraclePub,
 } from '../fixture/vars.js';
-import { getTxOutputs } from '../test-util.js';
+import { gatherUtxos, getTxOutputs } from '../test-util.js';
 import { FailedRequireError } from '../../src/Errors.js';
-import artifact from '../fixture/hodl_vault.json' with { type: 'json' };
+import artifact from '../fixture/hodl_vault.artifact.js';
 import { randomUtxo } from '../../src/utils.js';
 
 describe('HodlVault', () => {
-  let hodlVault: Contract;
+  const provider = process.env.TESTS_USE_MOCKNET
+    ? new MockNetworkProvider()
+    : new ElectrumNetworkProvider(Network.CHIPNET);
+  const hodlVault = new Contract(artifact, [alicePub, oraclePub, 99000n, 30000n], { provider });
 
   beforeAll(() => {
-    const provider = process.env.TESTS_USE_MOCKNET
-      ? new MockNetworkProvider()
-      : new ElectrumNetworkProvider(Network.CHIPNET);
-    hodlVault = new Contract(artifact, [alicePub, oraclePub, 99000n, 30000n], { provider });
     console.log(hodlVault.address);
     (provider as any).addUtxo?.(hodlVault.address, randomUtxo());
   });
@@ -36,11 +36,14 @@ describe('HodlVault', () => {
       const wrongSig = oracle.signMessage(wrongMessage);
       const to = hodlVault.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await hodlVault.getUtxos(), { amount, fee: 2000n });
 
       // when
-      const txPromise = hodlVault.functions
-        .spend(new SignatureTemplate(alicePriv), wrongSig, message)
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, hodlVault.unlock.spend(new SignatureTemplate(alicePriv), wrongSig, message))
+        .addOutput({ to: to, amount: amount })
+        .addOutput({ to: to, amount: changeAmount })
+        .setLocktime(100_000)
         .send();
 
       // then
@@ -55,11 +58,14 @@ describe('HodlVault', () => {
       const oracleSig = oracle.signMessage(message);
       const to = hodlVault.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await hodlVault.getUtxos(), { amount, fee: 2000n });
 
       // when
-      const txPromise = hodlVault.functions
-        .spend(new SignatureTemplate(alicePriv), oracleSig, message)
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, hodlVault.unlock.spend(new SignatureTemplate(alicePriv), oracleSig, message))
+        .addOutput({ to: to, amount: amount })
+        .addOutput({ to: to, amount: changeAmount })
+        .setLocktime(100_000)
         .send();
 
       // then
@@ -74,11 +80,14 @@ describe('HodlVault', () => {
       const oracleSig = oracle.signMessage(message);
       const to = hodlVault.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await hodlVault.getUtxos(), { amount, fee: 2000n });
 
       // when
-      const tx = await hodlVault.functions
-        .spend(new SignatureTemplate(alicePriv), oracleSig, message)
-        .to(to, amount)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, hodlVault.unlock.spend(new SignatureTemplate(alicePriv), oracleSig, message))
+        .addOutput({ to: to, amount: amount })
+        .addOutput({ to: to, amount: changeAmount })
+        .setLocktime(100_000)
         .send();
 
       // then
diff --git a/packages/cashscript/test/e2e/Mecenas.test.ts b/packages/cashscript/test/e2e/Mecenas.test.ts
index ede860e1..bc19b82b 100644
--- a/packages/cashscript/test/e2e/Mecenas.test.ts
+++ b/packages/cashscript/test/e2e/Mecenas.test.ts
@@ -1,28 +1,25 @@
-import {
-  Contract, ElectrumNetworkProvider, MockNetworkProvider, Network,
-} from '../../src/index.js';
+import { Contract, ElectrumNetworkProvider, MockNetworkProvider, Network, TransactionBuilder } from '../../src/index.js';
 import {
   alicePkh,
   bobPkh,
   aliceAddress,
   bobAddress,
 } from '../fixture/vars.js';
-import { getTxOutputs } from '../test-util.js';
+import { getLargestUtxo, getTxOutputs } from '../test-util.js';
 import { FailedRequireError } from '../../src/Errors.js';
-import artifact from '../fixture/mecenas.json' with { type: 'json' };
+import artifact from '../fixture/mecenas.artifact.js';
 import { randomUtxo } from '../../src/utils.js';
 
 // Mecenas has tx.age check omitted for testing
 describe('Mecenas', () => {
-  let mecenas: Contract;
+  const provider = process.env.TESTS_USE_MOCKNET
+    ? new MockNetworkProvider()
+    : new ElectrumNetworkProvider(Network.CHIPNET);
   const pledge = 10000n;
+  const mecenas = new Contract(artifact, [alicePkh, bobPkh, pledge], { provider });
   const minerFee = 1000n;
 
   beforeAll(() => {
-    const provider = process.env.TESTS_USE_MOCKNET
-      ? new MockNetworkProvider()
-      : new ElectrumNetworkProvider(Network.CHIPNET);
-    mecenas = new Contract(artifact, [alicePkh, bobPkh, pledge], { provider });
     console.log(mecenas.address);
     (provider as any).addUtxo?.(mecenas.address, randomUtxo());
   });
@@ -30,14 +27,16 @@ describe('Mecenas', () => {
   describe('send', () => {
     it('should fail when trying to send more than pledge', async () => {
       // given
-      const to = aliceAddress;
-      const amount = pledge + 10n;
+      const recipient = aliceAddress;
+      const pledgeAmount = pledge + 10n;
+      const contractUtxo = getLargestUtxo(await mecenas.getUtxos());
+      const changeAmount = contractUtxo.satoshis - pledgeAmount - minerFee;
 
       // when
-      const txPromise = mecenas.functions
-        .receive()
-        .to(to, amount)
-        .withHardcodedFee(minerFee)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, mecenas.unlock.receive())
+        .addOutput({ to: recipient, amount: pledgeAmount })
+        .addOutput({ to: mecenas.address, amount: changeAmount })
         .send();
 
       // then
@@ -48,14 +47,16 @@ describe('Mecenas', () => {
 
     it('should fail when trying to send to wrong person', async () => {
       // given
-      const to = bobAddress;
-      const amount = pledge;
+      const recipient = bobAddress;
+      const pledgeAmount = pledge;
+      const contractUtxo = getLargestUtxo(await mecenas.getUtxos());
+      const changeAmount = contractUtxo.satoshis - pledgeAmount - minerFee;
 
       // when
-      const txPromise = mecenas.functions
-        .receive()
-        .to(to, amount)
-        .withHardcodedFee(minerFee)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, mecenas.unlock.receive())
+        .addOutput({ to: recipient, amount: pledgeAmount })
+        .addOutput({ to: mecenas.address, amount: changeAmount })
         .send();
 
       // then
@@ -66,15 +67,17 @@ describe('Mecenas', () => {
 
     it('should fail when trying to send to multiple people', async () => {
       // given
-      const to = aliceAddress;
-      const amount = pledge;
+      const recipient = aliceAddress;
+      const pledgeAmount = pledge;
+      const contractUtxo = getLargestUtxo(await mecenas.getUtxos());
+      const changeAmount = contractUtxo.satoshis - pledgeAmount - minerFee;
 
       // when
-      const txPromise = mecenas.functions
-        .receive()
-        .to(to, amount)
-        .to(to, amount)
-        .withHardcodedFee(minerFee)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, mecenas.unlock.receive())
+        .addOutput({ to: recipient, amount: pledgeAmount })
+        .addOutput({ to: recipient, amount: pledgeAmount })
+        .addOutput({ to: mecenas.address, amount: changeAmount })
         .send();
 
       // then
@@ -85,14 +88,17 @@ describe('Mecenas', () => {
 
     it('should fail when sending incorrect amount of change', async () => {
       // given
-      const to = aliceAddress;
-      const amount = pledge;
+      const recipient = aliceAddress;
+      const pledgeAmount = pledge;
+      const contractUtxo = getLargestUtxo(await mecenas.getUtxos());
+      const changeAmount = contractUtxo.satoshis - pledgeAmount - minerFee;
+      const incorrectChangeAmount = changeAmount * 2n;
 
       // when
-      const txPromise = mecenas.functions
-        .receive()
-        .to(to, amount)
-        .withHardcodedFee(minerFee * 2n)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, mecenas.unlock.receive())
+        .addOutput({ to: recipient, amount: pledgeAmount })
+        .addOutput({ to: mecenas.address, amount: incorrectChangeAmount })
         .send();
 
       // then
@@ -103,19 +109,21 @@ describe('Mecenas', () => {
 
     it('should succeed when sending pledge to receiver', async () => {
       // given
-      const to = aliceAddress;
-      const amount = pledge;
+      const recipient = aliceAddress;
+      const pledgeAmount = pledge;
+      const contractUtxo = getLargestUtxo(await mecenas.getUtxos());
+      const changeAmount = contractUtxo.satoshis - pledgeAmount - minerFee;
 
       // when
-      const tx = await mecenas.functions
-        .receive()
-        .to(to, amount)
-        .withHardcodedFee(minerFee)
+      const tx = await new TransactionBuilder({ provider })
+        .addInput(contractUtxo, mecenas.unlock.receive())
+        .addOutput({ to: recipient, amount: pledgeAmount })
+        .addOutput({ to: mecenas.address, amount: changeAmount })
         .send();
 
       // then
       const txOutputs = getTxOutputs(tx);
-      expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
+      expect(txOutputs).toEqual(expect.arrayContaining([{ to: recipient, amount: pledgeAmount }]));
     });
   });
 });
diff --git a/packages/cashscript/test/e2e/MultiContract.test.ts b/packages/cashscript/test/e2e/MultiContract.test.ts
new file mode 100644
index 00000000..8136ebff
--- /dev/null
+++ b/packages/cashscript/test/e2e/MultiContract.test.ts
@@ -0,0 +1,184 @@
+import {
+  Contract,
+  ElectrumNetworkProvider,
+  FailedRequireError,
+  MockNetworkProvider,
+  SignatureTemplate,
+  TransactionBuilder,
+} from '../../src/index.js';
+import {
+  bobAddress,
+  bobPkh,
+  bobPriv,
+  bobPub,
+  carolPkh,
+  carolPriv,
+  carolPub,
+} from '../fixture/vars.js';
+import { Network } from '../../src/interfaces.js';
+import { randomUtxo } from '../../src/utils.js';
+import p2pkhArtifact from '../fixture/p2pkh.artifact.js';
+import twtArtifact from '../fixture/transfer_with_timeout.artifact.js';
+import { getTxOutputs } from '../test-util.js';
+
+describe('Multi Contract', () => {
+  const provider = process.env.TESTS_USE_MOCKNET
+    ? new MockNetworkProvider()
+    : new ElectrumNetworkProvider(Network.CHIPNET);
+
+  const bobSignatureTemplate = new SignatureTemplate(bobPriv);
+  const carolSignatureTemplate = new SignatureTemplate(carolPriv);
+
+  describe('Different instances of the same contract', () => {
+    const p2pkhInstance1 = new Contract(p2pkhArtifact, [bobPkh], { provider });
+    const p2pkhInstance2 = new Contract(p2pkhArtifact, [carolPkh], { provider });
+
+    beforeAll(() => {
+      // Note: We instantiate the contract with carolPkh to avoid mempool conflicts with other (P2PKH) tests
+      console.log(p2pkhInstance1.tokenAddress);
+      console.log(p2pkhInstance2.tokenAddress);
+      (provider as any).addUtxo?.(p2pkhInstance1.address, randomUtxo());
+      (provider as any).addUtxo?.(p2pkhInstance1.address, randomUtxo());
+      (provider as any).addUtxo?.(p2pkhInstance2.address, randomUtxo());
+      (provider as any).addUtxo?.(p2pkhInstance2.address, randomUtxo());
+      (provider as any).addUtxo?.(bobAddress, randomUtxo());
+      (provider as any).addUtxo?.(bobAddress, randomUtxo());
+    });
+
+    it('should fail with correct errors when using incorrect unlocker for p2pkhInstance1', async () => {
+      // given
+      const to = p2pkhInstance1.address;
+      const amount = 10000n;
+      const p2pkhInstance1Utxos = await p2pkhInstance1.getUtxos();
+      const p2pkhInstance2Utxos = await p2pkhInstance2.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(p2pkhInstance1Utxos[0], p2pkhInstance1.unlock.spend(carolPub, bobSignatureTemplate))
+        .addInput(p2pkhInstance2Utxos[0], p2pkhInstance2.unlock.spend(carolPub, carolSignatureTemplate))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount })
+        .send();
+
+      // then
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('P2PKH.cash:4 Require statement failed at input 0 in contract P2PKH.cash at line 4.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(hash160(pk) == pkh)');
+    });
+
+    it('should fail with correct errors when using incorrect unlocker for p2pkhInstance2', async () => {
+      // given
+      const to = p2pkhInstance1.address;
+      const amount = 10000n;
+      const p2pkhInstance1Utxos = await p2pkhInstance1.getUtxos();
+      const p2pkhInstance2Utxos = await p2pkhInstance2.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(p2pkhInstance1Utxos[0], p2pkhInstance1.unlock.spend(bobPub, bobSignatureTemplate))
+        .addInput(p2pkhInstance2Utxos[0], p2pkhInstance2.unlock.spend(bobPub, carolSignatureTemplate))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount });
+
+      console.log(transaction.bitauthUri());
+
+      const txPromise = transaction.send();
+
+      // then
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('P2PKH.cash:4 Require statement failed at input 1 in contract P2PKH.cash at line 4.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(hash160(pk) == pkh)');
+    });
+
+    it.todo('should fail with correct errors when using incorrect unlocker for p2pkhInstance 1 and 2');
+
+    it.todo('should fail with correct error when using incorrect unlocker for bobAddress');
+
+    it('should succeed for correct unlockers (p2pkhInstance1 + p2pkhInstance2 + bobAddress)', async () => {
+      // given
+      const to = p2pkhInstance1.address;
+      const amount = 10000n;
+      const outputs = [{ to, amount }];
+      const p2pkhInstance1Utxos = await p2pkhInstance1.getUtxos();
+      const p2pkhInstance2Utxos = await p2pkhInstance2.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const tx = await new TransactionBuilder({ provider })
+        .addInput(p2pkhInstance1Utxos[0], p2pkhInstance1.unlock.spend(bobPub, bobSignatureTemplate))
+        .addInput(p2pkhInstance2Utxos[0], p2pkhInstance2.unlock.spend(carolPub, carolSignatureTemplate))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount })
+        .send();
+
+      // then
+      const txOutputs = getTxOutputs(tx);
+      expect(txOutputs).toEqual(expect.arrayContaining(outputs));
+    });
+  });
+
+  describe('Different contracts', () => {
+    const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
+    const twtContract = new Contract(twtArtifact, [bobPub, carolPub, 100000n], { provider });
+
+    beforeAll(() => {
+      console.log(p2pkhContract.tokenAddress);
+      console.log(twtContract.tokenAddress);
+
+      (provider as any).addUtxo?.(p2pkhContract.address, randomUtxo());
+      (provider as any).addUtxo?.(twtContract.address, randomUtxo());
+    });
+
+    it('should fail with correct errors when using incorrect unlocker for p2pkhContract', async () => {
+      // given
+      const to = p2pkhContract.address;
+      const amount = 10000n;
+      const p2pkhContractUtxos = await p2pkhContract.getUtxos();
+      const twtContractUtxos = await twtContract.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(p2pkhContractUtxos[0], p2pkhContract.unlock.spend(carolPub, bobSignatureTemplate))
+        .addInput(twtContractUtxos[0], twtContract.unlock.transfer(bobSignatureTemplate))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount })
+        .send();
+
+      // then
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('P2PKH.cash:4 Require statement failed at input 0 in contract P2PKH.cash at line 4.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(hash160(pk) == pkh)');
+    });
+
+    it('should fail with correct errors when using incorrect unlocker for twtContract', async () => {
+      // given
+      const to = p2pkhContract.address;
+      const amount = 10000n;
+      const p2pkhContractUtxos = await p2pkhContract.getUtxos();
+      const twtContractUtxos = await twtContract.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(p2pkhContractUtxos[0], p2pkhContract.unlock.spend(bobPub, bobSignatureTemplate))
+        .addInput(twtContractUtxos[0], twtContract.unlock.transfer(bobSignatureTemplate))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount });
+
+      console.log(transaction.bitauthUri());
+
+      const txPromise = transaction.send();
+
+      // then
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('TransferWithTimeout.cash:8 Require statement failed at input 1 in contract TransferWithTimeout.cash at line 8.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(checkSig(recipientSig, recipient))');
+    });
+
+  });
+});
+
+// TODO: Add test that introspects "sibling" UTXOs
diff --git a/packages/cashscript/test/e2e/P2PKH.test.ts b/packages/cashscript/test/e2e/P2PKH.test.ts
index 9a313829..75c6fa02 100644
--- a/packages/cashscript/test/e2e/P2PKH.test.ts
+++ b/packages/cashscript/test/e2e/P2PKH.test.ts
@@ -2,6 +2,7 @@ import { binToHex } from '@bitauth/libauth';
 import {
   Contract, SignatureTemplate, MockNetworkProvider, ElectrumNetworkProvider,
   FailedRequireError,
+  TransactionBuilder,
 } from '../../src/index.js';
 import {
   bobAddress,
@@ -10,39 +11,44 @@ import {
   bobPkh,
   alicePriv,
   alicePub,
+  aliceAddress,
 } from '../fixture/vars.js';
-import { getTxOutputs } from '../test-util.js';
-import { Network, Utxo } from '../../src/interfaces.js';
+import { gatherUtxos, getTxOutputs, itOrSkip } from '../test-util.js';
+import { Network } from '../../src/interfaces.js';
 import {
-  createOpReturnOutput, randomUtxo, utxoComparator,
+  createOpReturnOutput, randomUtxo,
 } from '../../src/utils.js';
-import artifact from '../fixture/p2pkh.json' with { type: 'json' };
+import artifact from '../fixture/p2pkh.artifact.js';
 
 describe('P2PKH-no-tokens', () => {
-  let p2pkhInstance: Contract;
-
   const provider = process.env.TESTS_USE_MOCKNET
     ? new MockNetworkProvider()
     : new ElectrumNetworkProvider(Network.CHIPNET);
 
+  // define contract in the describe block so artifact typings aren't lost
+  const p2pkhContract = new Contract(artifact, [bobPkh], { provider });
+
   beforeAll(() => {
     // Note: We instantiate the contract with bobPkh to avoid mempool conflicts with other (P2PKH tokens) tests
-    p2pkhInstance = new Contract(artifact, [bobPkh], { provider });
-    console.log(p2pkhInstance.tokenAddress);
-    (provider as any).addUtxo?.(p2pkhInstance.address, randomUtxo({ satoshis: 10000000n }));
-    (provider as any).addUtxo?.(p2pkhInstance.address, randomUtxo({ satoshis: 10000000n }));
+    console.log(p2pkhContract.tokenAddress);
+    (provider as any).addUtxo?.(p2pkhContract.address, randomUtxo({ satoshis: 10000000n }));
+    (provider as any).addUtxo?.(p2pkhContract.address, randomUtxo({ satoshis: 10000000n }));
+    (provider as any).addUtxo?.(bobAddress, randomUtxo());
+    (provider as any).addUtxo?.(bobAddress, randomUtxo());
   });
 
   describe('send', () => {
     it('should fail when using incorrect public key', async () => {
       // given
-      const to = p2pkhInstance.address;
+      const to = p2pkhContract.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await p2pkhContract.getUtxos(), { amount });
 
       // when
-      const txPromise = p2pkhInstance.functions
-        .spend(alicePub, new SignatureTemplate(bobPriv))
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhContract.unlock.spend(alicePub, new SignatureTemplate(bobPriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
@@ -53,13 +59,15 @@ describe('P2PKH-no-tokens', () => {
 
     it('should fail when using incorrect signature', async () => {
       // given
-      const to = p2pkhInstance.address;
+      const to = p2pkhContract.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await p2pkhContract.getUtxos(), { amount });
 
       // when
-      const txPromise = p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(alicePriv))
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhContract.unlock.spend(bobPub, new SignatureTemplate(alicePriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
@@ -70,13 +78,15 @@ describe('P2PKH-no-tokens', () => {
 
     it('should succeed when using correct function arguments', async () => {
       // given
-      const to = p2pkhInstance.address;
+      const to = p2pkhContract.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await p2pkhContract.getUtxos(), { amount });
 
       // when
-      const tx = await p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(bobPriv))
-        .to(to, amount)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhContract.unlock.spend(bobPub, new SignatureTemplate(bobPriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
@@ -85,61 +95,63 @@ describe('P2PKH-no-tokens', () => {
       expect(tx.txid).toBeDefined();
     });
 
-    it('should fail when not enough satoshis are provided in utxos', async () => {
+    // TODO: this fails on mocknet, because mocknet doesn't check inputs vs outputs,
+    // we should add a sanity check in our own code
+    itOrSkip(!process.env.TESTS_USE_MOCKNET, 'should fail when not enough satoshis are provided in utxos', async () => {
       // given
-      const to = p2pkhInstance.address;
+      const to = p2pkhContract.address;
       const amount = 1000n;
-      const utxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
-      const { utxos: gathered } = gatherUtxos(utxos, { amount });
-      const failureAmount = gathered.reduce((acc, utxo) => acc + utxo.satoshis, 0n) + 1n;
+      const { utxos, total, changeAmount } = gatherUtxos(await p2pkhContract.getUtxos(), { amount });
+      const failureAmount = total + 1n;
 
       // when
-      const txPromise = p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(bobPriv))
-        .from(gathered)
-        .to(to, failureAmount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhContract.unlock.spend(bobPub, new SignatureTemplate(bobPriv)))
+        .addOutput({ to, amount: failureAmount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
       await expect(txPromise).rejects.toThrow();
     });
 
-    it('should succeed when providing UTXOs', async () => {
+    it('should succeed when providing UTXOs to .addInputs', async () => {
       // given
-      const to = p2pkhInstance.address;
+      const to = p2pkhContract.address;
       const amount = 1000n;
-      const utxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
-      const { utxos: gathered } = gatherUtxos(utxos, { amount });
+      const { utxos, changeAmount } = gatherUtxos(await p2pkhContract.getUtxos(), { amount });
 
       // when
-      const receipt = await p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(bobPriv))
-        .from(gathered)
-        .to(to, amount)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhContract.unlock.spend(bobPub, new SignatureTemplate(bobPriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
       expect.hasAssertions();
-      receipt.inputs.forEach((input) => {
-        expect(gathered.find((utxo) => (
+      tx.inputs.forEach((input) => {
+        expect(utxos.find((utxo) => (
           utxo.txid === binToHex(input.outpointTransactionHash)
           && utxo.vout === input.outpointIndex
         ))).toBeTruthy();
       });
     });
 
-    it('can call to() multiple times', async () => {
+    it('can call addOutput() multiple times', async () => {
       // given
       const outputs = [
-        { to: p2pkhInstance.address, amount: 10000n },
-        { to: p2pkhInstance.address, amount: 20000n },
+        { to: p2pkhContract.address, amount: 10_000n },
+        { to: p2pkhContract.address, amount: 20_000n },
       ];
+      const { utxos, changeAmount } = gatherUtxos(await p2pkhContract.getUtxos(), { amount: 30_000n, fee: 2000n });
 
       // when
-      const tx = await p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(bobPriv))
-        .to(outputs[0].to, outputs[0].amount)
-        .to(outputs[1].to, outputs[1].amount)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhContract.unlock.spend(bobPub, new SignatureTemplate(bobPriv)))
+        .addOutput({ to: outputs[0].to, amount: outputs[0].amount })
+        .addOutput({ to: outputs[1].to, amount: outputs[1].amount })
+        .addOutput({ to: aliceAddress, amount: changeAmount })
         .send();
 
       // then
@@ -150,14 +162,16 @@ describe('P2PKH-no-tokens', () => {
     it('can send to list of recipients', async () => {
       // given
       const outputs = [
-        { to: p2pkhInstance.address, amount: 10000n },
-        { to: p2pkhInstance.address, amount: 20000n },
+        { to: p2pkhContract.address, amount: 10_000n },
+        { to: p2pkhContract.address, amount: 20_000n },
       ];
+      const { utxos, changeAmount } = gatherUtxos(await p2pkhContract.getUtxos(), { amount: 30_000n, fee: 2000n });
 
       // when
-      const tx = await p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(bobPriv))
-        .to(outputs)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhContract.unlock.spend(bobPub, new SignatureTemplate(bobPriv)))
+        .addOutputs(outputs)
+        .addOutput({ to: aliceAddress, amount: changeAmount })
         .send();
 
       // then
@@ -167,20 +181,22 @@ describe('P2PKH-no-tokens', () => {
 
     it('can include OP_RETURN data as an output', async () => {
       // given
-      const opReturn = ['0x6d02', 'Hello, World!', '0x01'];
-      const to = p2pkhInstance.address;
+      const opReturnData = ['0x6d02', 'Hello, World!', '0x01'];
+      const to = p2pkhContract.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await p2pkhContract.getUtxos(), { amount });
 
       // when
-      const tx = await p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(bobPriv))
-        .to(to, amount)
-        .withOpReturn(opReturn)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhContract.unlock.spend(bobPub, new SignatureTemplate(bobPriv)))
+        .addOutput({ to, amount })
+        .addOutput(createOpReturnOutput(opReturnData))
+        .addOutput({ to: aliceAddress, amount: changeAmount })
         .send();
 
       // then
       const txOutputs = getTxOutputs(tx);
-      const expectedOutputs = [{ to, amount }, createOpReturnOutput(opReturn)];
+      const expectedOutputs = [{ to, amount }, createOpReturnOutput(opReturnData)];
       expect(txOutputs).toEqual(expect.arrayContaining(expectedOutputs));
     });
 
@@ -188,19 +204,19 @@ describe('P2PKH-no-tokens', () => {
       // given
       const to = bobAddress;
       const amount = 10000n;
+      const bobSignatureTemplate = new SignatureTemplate(bobPriv);
 
-      const contractUtxos = (await p2pkhInstance.getUtxos()).sort(utxoComparator).reverse();
+      const contractUtxos = await p2pkhContract.getUtxos();
       const bobUtxos = await provider.getUtxos(bobAddress);
 
       // when
-      const tx = await p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(bobPriv))
-        .fromP2PKH(bobUtxos[0], new SignatureTemplate(bobPriv))
-        .from(contractUtxos[0])
-        .fromP2PKH(bobUtxos[1], new SignatureTemplate(bobPriv))
-        .from(contractUtxos[1])
-        .to(to, amount)
-        .to(to, amount)
+      const tx = await new TransactionBuilder({ provider })
+        .addInput(contractUtxos[0], p2pkhContract.unlock.spend(bobPub, bobSignatureTemplate))
+        .addInput(bobUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addInput(contractUtxos[1], p2pkhContract.unlock.spend(bobPub, bobSignatureTemplate))
+        .addInput(bobUtxos[1], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount })
+        .addOutput({ to, amount })
         .send();
 
       // then
@@ -209,25 +225,3 @@ describe('P2PKH-no-tokens', () => {
     });
   });
 });
-
-function gatherUtxos(
-  utxos: Utxo[],
-  options?: { amount?: bigint, fees?: bigint },
-): { utxos: Utxo[], total: bigint } {
-  const targetUtxos: Utxo[] = [];
-  let total = 0n;
-
-  // 1000 for fees
-  const { amount = 0n, fees = 1000n } = options ?? {};
-
-  for (const utxo of utxos) {
-    if (total - fees > amount) break;
-    total += utxo.satoshis;
-    targetUtxos.push(utxo);
-  }
-
-  return {
-    utxos: targetUtxos,
-    total,
-  };
-}
diff --git a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
index 5ecdfd1f..36ca67ba 100644
--- a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
+++ b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
@@ -1,51 +1,49 @@
-import { randomUtxo, randomToken } from '../../src/utils.js';
+import { randomUtxo, randomToken, isFungibleTokenUtxo, isNonTokenUtxo, utxoComparator } from '../../src/utils.js';
 import {
   Contract, ElectrumNetworkProvider, FailedRequireError, MockNetworkProvider,
+  TransactionBuilder,
 } from '../../src/index.js';
-import { Network, Utxo } from '../../src/interfaces.js';
+import { Network } from '../../src/interfaces.js';
 import artifact from '../fixture/token_category_comparison.json' with { type: 'json' };
 
 describe('TokenCategoryCheck', () => {
-  let tokenCategoryCheckInstance: Contract;
+  const provider = process.env.TESTS_USE_MOCKNET
+    ? new MockNetworkProvider()
+    : new ElectrumNetworkProvider(Network.CHIPNET);
+  const checkTokenCategoryContract = new Contract(artifact, [], { provider });
 
   beforeAll(() => {
-    const provider = process.env.TESTS_USE_MOCKNET
-      ? new MockNetworkProvider()
-      : new ElectrumNetworkProvider(Network.CHIPNET);
-    tokenCategoryCheckInstance = new Contract(artifact, [], { provider });
-    console.log(tokenCategoryCheckInstance.tokenAddress);
-
-    (provider as any).addUtxo?.(tokenCategoryCheckInstance.address, randomUtxo());
-    (provider as any).addUtxo?.(tokenCategoryCheckInstance.address, randomUtxo());
-    (provider as any).addUtxo?.(tokenCategoryCheckInstance.address, randomUtxo({
-      satoshis: 1000n,
-      token: randomToken(),
-    }));
+    console.log(checkTokenCategoryContract.tokenAddress);
+    (provider as any).addUtxo?.(checkTokenCategoryContract.address, randomUtxo({ satoshis: 1000n, token: randomToken() }));
+    (provider as any).addUtxo?.(checkTokenCategoryContract.address, randomUtxo());
+    (provider as any).addUtxo?.(checkTokenCategoryContract.address, randomUtxo());
+    (provider as any).addUtxo?.(checkTokenCategoryContract.address, randomUtxo());
   });
 
   describe('send', () => {
     it('cannot send if the input at index 1 contains tokens', async () => {
-      const contractUtxos = await tokenCategoryCheckInstance.getUtxos();
+      const contractUtxos = await checkTokenCategoryContract.getUtxos();
       const tokenUtxo = contractUtxos.find(isFungibleTokenUtxo);
-      const nonTokenUtxo = contractUtxos.find(isNonTokenUtxo);
+      const nonTokenUtxos = contractUtxos.filter(isNonTokenUtxo).sort(utxoComparator).reverse();
 
       if (!tokenUtxo) {
         throw new Error('No token UTXO found with fungible tokens');
       }
 
-      if (!nonTokenUtxo) {
-        throw new Error('No non-token UTXOs found');
+      if (nonTokenUtxos.length < 1) {
+        throw new Error('Less than one non-token UTXO found');
       }
 
-      const to = tokenCategoryCheckInstance.tokenAddress;
+      const to = checkTokenCategoryContract.tokenAddress;
       const amount = 1000n;
       const { token } = tokenUtxo;
+      const changeAmount = tokenUtxo.satoshis + nonTokenUtxos[0].satoshis - amount - 1000n;
 
-      const txPromise = tokenCategoryCheckInstance.functions
-        .send()
-        .from(nonTokenUtxo)
-        .from(tokenUtxo)
-        .to(to, amount, token)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(nonTokenUtxos[0], checkTokenCategoryContract.unlock.send())
+        .addInput(tokenUtxo, checkTokenCategoryContract.unlock.send())
+        .addOutput({ to, amount, token })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       await expect(txPromise).rejects.toThrow(FailedRequireError);
@@ -54,21 +52,22 @@ describe('TokenCategoryCheck', () => {
     });
 
     it('can send if the input at index 1 does not contain tokens', async () => {
-      const contractUtxos = await tokenCategoryCheckInstance.getUtxos();
-      const nonTokenUtxos = contractUtxos.filter(isNonTokenUtxo);
+      const contractUtxos = await checkTokenCategoryContract.getUtxos();
+      const nonTokenUtxos = contractUtxos.filter(isNonTokenUtxo).sort(utxoComparator).reverse();
 
       if (nonTokenUtxos.length < 2) {
         throw new Error('Less than two non-token UTXOs found');
       }
 
-      const to = tokenCategoryCheckInstance.tokenAddress;
+      const to = checkTokenCategoryContract.tokenAddress;
       const amount = 1000n;
+      const changeAmount = nonTokenUtxos[0].satoshis + nonTokenUtxos[1].satoshis - amount - 1000n;
 
-      const txPromise = tokenCategoryCheckInstance.functions
-        .send()
-        .from(nonTokenUtxos[0])
-        .from(nonTokenUtxos[1])
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(nonTokenUtxos[0], checkTokenCategoryContract.unlock.send())
+        .addInput(nonTokenUtxos[1], checkTokenCategoryContract.unlock.send())
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       await expect(txPromise).resolves.toBeTruthy();
@@ -76,9 +75,3 @@ describe('TokenCategoryCheck', () => {
   });
 });
 
-// We don't include UTXOs that contain BOTH fungible and non-fungible tokens
-const isFungibleTokenUtxo = (utxo: Utxo): boolean => (
-  utxo.token !== undefined && utxo.token.amount > 0n && utxo.token.nft === undefined
-);
-
-const isNonTokenUtxo = (utxo: Utxo): boolean => utxo.token === undefined;
diff --git a/packages/cashscript/test/e2e/TransferWithTimeout.test.ts b/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
index f83595a6..5bdebfd7 100644
--- a/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
+++ b/packages/cashscript/test/e2e/TransferWithTimeout.test.ts
@@ -5,24 +5,23 @@ import {
   Network,
   MockNetworkProvider,
   FailedRequireError,
+  TransactionBuilder,
 } from '../../src/index.js';
 import {
   alicePriv, alicePub, bobPriv, bobPub,
 } from '../fixture/vars.js';
-import { getTxOutputs } from '../test-util.js';
-import artifact from '../fixture/transfer_with_timeout.json' with { type: 'json' };
+import { gatherUtxos, getTxOutputs } from '../test-util.js';
+import twtArtifact from '../fixture/transfer_with_timeout.artifact.js';
 import { randomUtxo } from '../../src/utils.js';
 
 describe('TransferWithTimeout', () => {
-  let twtInstancePast: Contract;
-  let twtInstanceFuture: Contract;
+  const provider = process.env.TESTS_USE_MOCKNET
+    ? new MockNetworkProvider()
+    : new ElectrumNetworkProvider(Network.CHIPNET);
+  const twtInstancePast = new Contract(twtArtifact, [alicePub, bobPub, 100000n], { provider });
+  const twtInstanceFuture = new Contract(twtArtifact, [alicePub, bobPub, 2000000n], { provider });
 
   beforeAll(() => {
-    const provider = process.env.TESTS_USE_MOCKNET
-      ? new MockNetworkProvider()
-      : new ElectrumNetworkProvider(Network.CHIPNET);
-    twtInstancePast = new Contract(artifact, [alicePub, bobPub, 100000n], { provider });
-    twtInstanceFuture = new Contract(artifact, [alicePub, bobPub, 2000000n], { provider });
     console.log(twtInstancePast.address);
     console.log(twtInstanceFuture.address);
 
@@ -35,11 +34,13 @@ describe('TransferWithTimeout', () => {
       // given
       const to = twtInstancePast.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await twtInstancePast.getUtxos(), { amount, fee: 2000n });
 
       // when
-      const txPromise = twtInstancePast.functions
-        .transfer(new SignatureTemplate(alicePriv))
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, twtInstancePast.unlock.transfer(new SignatureTemplate(alicePriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
@@ -52,11 +53,13 @@ describe('TransferWithTimeout', () => {
       // given
       const to = twtInstancePast.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await twtInstancePast.getUtxos(), { amount, fee: 2000n });
 
       // when
-      const txPromise = twtInstancePast.functions
-        .timeout(new SignatureTemplate(bobPriv))
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, twtInstancePast.unlock.timeout(new SignatureTemplate(bobPriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
@@ -69,11 +72,13 @@ describe('TransferWithTimeout', () => {
       // given
       const to = twtInstanceFuture.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await twtInstanceFuture.getUtxos(), { amount, fee: 2000n });
 
       // when
-      const txPromise = twtInstanceFuture.functions
-        .timeout(new SignatureTemplate(alicePriv))
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, twtInstanceFuture.unlock.timeout(new SignatureTemplate(alicePriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
@@ -86,11 +91,13 @@ describe('TransferWithTimeout', () => {
       // given
       const to = twtInstancePast.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await twtInstancePast.getUtxos(), { amount, fee: 2000n });
 
       // when
-      const tx = await twtInstancePast.functions
-        .transfer(new SignatureTemplate(bobPriv))
-        .to(to, amount)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, twtInstancePast.unlock.transfer(new SignatureTemplate(bobPriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
@@ -102,11 +109,13 @@ describe('TransferWithTimeout', () => {
       // given
       const to = twtInstanceFuture.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await twtInstanceFuture.getUtxos(), { amount, fee: 2000n });
 
       // when
-      const tx = await twtInstanceFuture.functions
-        .transfer(new SignatureTemplate(bobPriv))
-        .to(to, amount)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, twtInstanceFuture.unlock.transfer(new SignatureTemplate(bobPriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
@@ -118,11 +127,15 @@ describe('TransferWithTimeout', () => {
       // given
       const to = twtInstancePast.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await twtInstancePast.getUtxos(), { amount, fee: 2000n });
+      const blockHeight = await provider.getBlockHeight();
 
       // when
-      const tx = await twtInstancePast.functions
-        .timeout(new SignatureTemplate(alicePriv))
-        .to(to, amount)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, twtInstancePast.unlock.timeout(new SignatureTemplate(alicePriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
+        .setLocktime(blockHeight)
         .send();
 
       // then
diff --git a/packages/cashscript/test/e2e/misc.test.ts b/packages/cashscript/test/e2e/misc.test.ts
deleted file mode 100644
index a4f7b5e8..00000000
--- a/packages/cashscript/test/e2e/misc.test.ts
+++ /dev/null
@@ -1,65 +0,0 @@
-import { randomUtxo } from '../../src/utils.js';
-import {
-  Contract, MockNetworkProvider, ElectrumNetworkProvider, Network,
-} from '../../src/index.js';
-import { getTxOutputs } from '../test-util.js';
-import artifact from '../fixture/simple_covenant.json' with { type: 'json' };
-
-describe('Simple Covenant', () => {
-  const provider = process.env.TESTS_USE_MOCKNET
-    ? new MockNetworkProvider()
-    : new ElectrumNetworkProvider(Network.CHIPNET);
-  let covenant: Contract;
-
-  beforeAll(() => {
-    covenant = new Contract(artifact, [], { provider });
-    console.log(covenant.address);
-    (provider as any).addUtxo?.(covenant.address, randomUtxo());
-  });
-
-  describe('send', () => {
-    it('should succeed', async () => {
-      // given
-      const to = covenant.address;
-      const amount = 1000n;
-
-      // when
-      const tx = await covenant.functions.spend().to(to, amount).send();
-
-      // then
-      const txOutputs = getTxOutputs(tx);
-      expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-    });
-
-    it('should succeed with bip68 relative timelock', async () => {
-      // given
-      // eslint-disable-next-line
-      const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-      // eslint-disable-next-line
-      const covenant = new Contract(artifact, [], { provider });
-
-      const to = covenant.address;
-      const amount = 1000n;
-
-      const utxos = await covenant.getUtxos();
-
-      const utxo0Info: any = await provider.performRequest('blockchain.utxo.get_info', utxos[0].txid, utxos[0].vout);
-      const utxo1Info: any = await provider.performRequest('blockchain.utxo.get_info', utxos[1].txid, utxos[1].vout);
-      const currentBlockHeight = await provider.getBlockHeight();
-
-      const age = (Math.max(utxo0Info.confirmed_height, utxo1Info.confirmed_height) - currentBlockHeight) || 0;
-
-      // when
-      const tx = await covenant.functions.spend()
-        .from(utxos[0])
-        .from(utxos[1])
-        .to(to, amount)
-        .withAge(age)
-        .send();
-
-      // then
-      const txOutputs = getTxOutputs(tx);
-      expect(txOutputs).toEqual(expect.arrayContaining([{ to, amount }]));
-    });
-  });
-});
diff --git a/packages/cashscript/test/e2e/misc/timelocks.test.ts b/packages/cashscript/test/e2e/misc/timelocks.test.ts
new file mode 100644
index 00000000..bb329e96
--- /dev/null
+++ b/packages/cashscript/test/e2e/misc/timelocks.test.ts
@@ -0,0 +1,92 @@
+import { Contract, SignatureTemplate, ElectrumNetworkProvider, MockNetworkProvider } from '../../../src/index.js';
+import {
+  bobAddress,
+  bobPub,
+  carolPkh,
+  carolPub,
+  carolAddress,
+  carolPriv,
+} from '../../fixture/vars.js';
+import { Network } from '../../../src/interfaces.js';
+import { utxoComparator, calculateDust, randomUtxo, isNonTokenUtxo } from '../../../src/utils.js';
+import p2pkhArtifact from '../../fixture/p2pkh.json' with { type: 'json' };
+import twtArtifact from '../../fixture/transfer_with_timeout.json' with { type: 'json' };
+import { TransactionBuilder } from '../../../src/TransactionBuilder.js';
+import { describeOrSkip, getTxOutputs } from '../../test-util.js';
+
+
+describe('Timelocks', () => {
+  const provider = process.env.TESTS_USE_MOCKNET
+    ? new MockNetworkProvider()
+    : new ElectrumNetworkProvider(Network.CHIPNET);
+
+  let p2pkhInstance: Contract;
+  let twtInstance: Contract;
+
+  beforeAll(() => {
+    // Note: We instantiate the contract with carolPkh to avoid mempool conflicts with other (P2PKH) tests
+    p2pkhInstance = new Contract(p2pkhArtifact, [carolPkh], { provider });
+    twtInstance = new Contract(twtArtifact, [bobPub, carolPub, 100000n], { provider });
+    console.log(p2pkhInstance.tokenAddress);
+    console.log(twtInstance.tokenAddress);
+    (provider as any).addUtxo?.(p2pkhInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(p2pkhInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(twtInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(twtInstance.address, randomUtxo());
+    (provider as any).addUtxo?.(bobAddress, randomUtxo());
+    (provider as any).addUtxo?.(bobAddress, randomUtxo());
+    (provider as any).addUtxo?.(carolAddress, randomUtxo());
+    (provider as any).addUtxo?.(carolAddress, randomUtxo());
+  });
+
+  describeOrSkip(!process.env.TESTS_USE_MOCKNET, 'Locktime', () => {
+    it('should fail when locktime is higher than current block height', async () => {
+      const fee = 1000n;
+      const p2pkhUtxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
+
+      const amount = p2pkhUtxos[0].satoshis - fee;
+      const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
+
+      if (amount < dustAmount) {
+        throw new Error('Not enough funds to send transaction');
+      }
+
+      const blockHeight = await provider.getBlockHeight();
+
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(p2pkhUtxos[0], p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
+        .addOutput({ to: p2pkhInstance.address, amount })
+        .setLocktime(blockHeight + 100)
+        .send();
+
+      await expect(txPromise).rejects.toThrow(/non-final transaction/);
+    });
+
+    it('should succeed when locktime is lower than current block height', async () => {
+      const fee = 1000n;
+      const p2pkhUtxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
+
+      const amount = p2pkhUtxos[0].satoshis - fee;
+      const dustAmount = calculateDust({ to: p2pkhInstance.address, amount });
+
+      if (amount < dustAmount) {
+        throw new Error('Not enough funds to send transaction');
+      }
+
+      const blockHeight = await provider.getBlockHeight();
+
+      const tx = await new TransactionBuilder({ provider })
+        .addInput(p2pkhUtxos[0], p2pkhInstance.unlock.spend(carolPub, new SignatureTemplate(carolPriv)))
+        .addOutput({ to: p2pkhInstance.address, amount })
+        .setLocktime(blockHeight - 100)
+        .send();
+
+      const txOutputs = getTxOutputs(tx);
+      expect(txOutputs).toEqual(expect.arrayContaining([{ to: p2pkhInstance.address, amount }]));
+    });
+  });
+
+  // bip68 relative timelock
+  it.todo('test sequence numbers');
+  // Get utxo age on chipnet with provider.performRequest('blockchain.utxo.get_info', utxo.txid, utxo.vout);
+});
diff --git a/packages/cashscript/test/e2e/network/FullStack.test.ts b/packages/cashscript/test/e2e/network/FullStack.test.ts
index b0e6f48f..4fb3fd7e 100644
--- a/packages/cashscript/test/e2e/network/FullStack.test.ts
+++ b/packages/cashscript/test/e2e/network/FullStack.test.ts
@@ -6,13 +6,11 @@ import {
   bobPriv,
   bobPub,
 } from '../../fixture/vars.js';
-import { getTxOutputs } from '../../test-util.js';
+import { describeOrSkip, getTxOutputs } from '../../test-util.js';
 import { FailedRequireError } from '../../../src/Errors.js';
 import artifact from '../../fixture/p2pkh.json' with { type: 'json' };
 
-const describeOrSkip = process.env.TESTS_USE_MOCKNET ? describe.skip : describe;
-
-describeOrSkip('test FullStackNetworkProvider', () => {
+describeOrSkip(!process.env.TESTS_USE_MOCKNET, 'test FullStackNetworkProvider', () => {
   const provider = new FullStackNetworkProvider('mainnet', new BCHJS({ restURL: 'https://api.fullstack.cash/v5/' }));
 
   describe('get utxos using FullStackNetworkProvider', () => {
diff --git a/packages/cashscript/test/fixture/Bar.artifact.ts b/packages/cashscript/test/fixture/Bar.artifact.ts
new file mode 100644
index 00000000..0b7cfeec
--- /dev/null
+++ b/packages/cashscript/test/fixture/Bar.artifact.ts
@@ -0,0 +1,70 @@
+export default {
+  contractName: 'Bar',
+  constructorInputs: [
+    {
+      name: 'pkh_bar',
+      type: 'bytes20',
+    },
+  ],
+  abi: [
+    {
+      name: 'funcA',
+      inputs: [],
+    },
+    {
+      name: 'funcB',
+      inputs: [],
+    },
+    {
+      name: 'execute',
+      inputs: [
+        {
+          name: 'pk',
+          type: 'pubkey',
+        },
+        {
+          name: 's',
+          type: 'sig',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_OVER OP_0 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_OVER OP_1 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_SWAP OP_2 OP_NUMEQUALVERIFY OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG OP_ENDIF OP_ENDIF',
+  source: 'pragma cashscript >=0.10.2;\n\ncontract Bar(bytes20 pkh_bar) {\n    function funcA() {\n        require(2==2);\n    }\n\n    function funcB() {\n        require(2==2);\n    }\n\n    function execute(pubkey pk, sig s) {\n        console.log(\'Bar \'execute\' function called.\');\n        require(hash160(pk) == pkh_bar);\n        require(checkSig(s, pk));\n    }\n}\n',
+  debug: {
+    bytecode: '5179009c6352529c7777675179519c6352529c777767517a529c695179a9517a8769517a517aac6868',
+    sourceMap: '4:4:6:5;;;;;5:16:5:17;:19::20;:16:::1;4:4:6:5;;;8::10::0;;;;;9:16:9:17;:19::20;:16:::1;8:4:10:5;;;12::16::0;;;;;14:24:14:26;;:16::27:1;:31::38:0;;:16:::1;:8::40;15:25:15:26:0;;:28::30;;:16::31:1;3:0:17:1;',
+    logs: [
+      {
+        ip: 28,
+        line: 13,
+        data: [
+          'Bar \'execute\' function called.',
+        ],
+      },
+    ],
+    requires: [
+      {
+        ip: 9,
+        line: 5,
+      },
+      {
+        ip: 20,
+        line: 9,
+      },
+      {
+        ip: 34,
+        line: 14,
+      },
+      {
+        ip: 40,
+        line: 15,
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.11.0-next.0',
+  },
+  updatedAt: '2025-02-18T09:30:48.653Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/Bar.cash b/packages/cashscript/test/fixture/Bar.cash
new file mode 100644
index 00000000..812e5a55
--- /dev/null
+++ b/packages/cashscript/test/fixture/Bar.cash
@@ -0,0 +1,17 @@
+pragma cashscript >=0.10.2;
+
+contract Bar(bytes20 pkh_bar) {
+    function funcA() {
+        require(2==2);
+    }
+
+    function funcB() {
+        require(2==2);
+    }
+
+    function execute(pubkey pk, sig s) {
+        console.log("Bar 'execute' function called.");
+        require(hash160(pk) == pkh_bar);
+        require(checkSig(s, pk));
+    }
+}
diff --git a/packages/cashscript/test/fixture/Bar.json b/packages/cashscript/test/fixture/Bar.json
new file mode 100644
index 00000000..67db2a67
--- /dev/null
+++ b/packages/cashscript/test/fixture/Bar.json
@@ -0,0 +1,70 @@
+{
+  "contractName": "Bar",
+  "constructorInputs": [
+    {
+      "name": "pkh_bar",
+      "type": "bytes20"
+    }
+  ],
+  "abi": [
+    {
+      "name": "funcA",
+      "inputs": []
+    },
+    {
+      "name": "funcB",
+      "inputs": []
+    },
+    {
+      "name": "execute",
+      "inputs": [
+        {
+          "name": "pk",
+          "type": "pubkey"
+        },
+        {
+          "name": "s",
+          "type": "sig"
+        }
+      ]
+    }
+  ],
+  "bytecode": "OP_OVER OP_0 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_OVER OP_1 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_SWAP OP_2 OP_NUMEQUALVERIFY OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG OP_ENDIF OP_ENDIF",
+  "source": "pragma cashscript >=0.10.2;\n\ncontract Bar(bytes20 pkh_bar) {\n    function funcA() {\n        require(2==2);\n    }\n\n    function funcB() {\n        require(2==2);\n    }\n\n    function execute(pubkey pk, sig s) {\n        console.log(\"Bar 'execute' function called.\");\n        require(hash160(pk) == pkh_bar);\n        require(checkSig(s, pk));\n    }\n}\n",
+  "debug": {
+    "bytecode": "5179009c6352529c7777675179519c6352529c777767517a529c695179a9517a8769517a517aac6868",
+    "sourceMap": "4:4:6:5;;;;;5:16:5:17;:19::20;:16:::1;4:4:6:5;;;8::10::0;;;;;9:16:9:17;:19::20;:16:::1;8:4:10:5;;;12::16::0;;;;;14:24:14:26;;:16::27:1;:31::38:0;;:16:::1;:8::40;15:25:15:26:0;;:28::30;;:16::31:1;3:0:17:1;",
+    "logs": [
+      {
+        "ip": 28,
+        "line": 13,
+        "data": [
+          "Bar 'execute' function called."
+        ]
+      }
+    ],
+    "requires": [
+      {
+        "ip": 9,
+        "line": 5
+      },
+      {
+        "ip": 20,
+        "line": 9
+      },
+      {
+        "ip": 34,
+        "line": 14
+      },
+      {
+        "ip": 40,
+        "line": 15
+      }
+    ]
+  },
+  "compiler": {
+    "name": "cashc",
+    "version": "0.11.0-next.0"
+  },
+  "updatedAt": "2025-02-18T09:30:48.363Z"
+}
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/Foo.artifact.ts b/packages/cashscript/test/fixture/Foo.artifact.ts
new file mode 100644
index 00000000..1cb3af77
--- /dev/null
+++ b/packages/cashscript/test/fixture/Foo.artifact.ts
@@ -0,0 +1,54 @@
+export default {
+  contractName: 'Foo',
+  constructorInputs: [
+    {
+      name: 'pkh_foo',
+      type: 'bytes20',
+    },
+  ],
+  abi: [
+    {
+      name: 'execute',
+      inputs: [
+        {
+          name: 'pk',
+          type: 'pubkey',
+        },
+        {
+          name: 's',
+          type: 'sig',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG',
+  source: 'pragma cashscript >=0.10.2;\n\ncontract Foo(bytes20 pkh_foo) {\n    // Require pk to match stored pkh and signature to match\n    function execute(pubkey pk, sig s) {\n        console.log(\'Foo \'execute\' function called.\');\n        require(hash160(pk) == pkh_foo);\n        require(checkSig(s, pk));\n    }\n}\n',
+  debug: {
+    bytecode: '5179a9517a8769517a517aac',
+    sourceMap: '7:24:7:26;;:16::27:1;:31::38:0;;:16:::1;:8::40;8:25:8:26:0;;:28::30;;:16::31:1',
+    logs: [
+      {
+        ip: 1,
+        line: 6,
+        data: [
+          'Foo \'execute\' function called.',
+        ],
+      },
+    ],
+    requires: [
+      {
+        ip: 7,
+        line: 7,
+      },
+      {
+        ip: 13,
+        line: 8,
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.11.0-next.0',
+  },
+  updatedAt: '2025-02-18T09:30:49.147Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/Foo.cash b/packages/cashscript/test/fixture/Foo.cash
new file mode 100644
index 00000000..89c3306e
--- /dev/null
+++ b/packages/cashscript/test/fixture/Foo.cash
@@ -0,0 +1,10 @@
+pragma cashscript >=0.10.2;
+
+contract Foo(bytes20 pkh_foo) {
+    // Require pk to match stored pkh and signature to match
+    function execute(pubkey pk, sig s) {
+        console.log("Foo 'execute' function called.");
+        require(hash160(pk) == pkh_foo);
+        require(checkSig(s, pk));
+    }
+}
diff --git a/packages/cashscript/test/fixture/Foo.json b/packages/cashscript/test/fixture/Foo.json
new file mode 100644
index 00000000..210d45bf
--- /dev/null
+++ b/packages/cashscript/test/fixture/Foo.json
@@ -0,0 +1,54 @@
+{
+  "contractName": "Foo",
+  "constructorInputs": [
+    {
+      "name": "pkh_foo",
+      "type": "bytes20"
+    }
+  ],
+  "abi": [
+    {
+      "name": "execute",
+      "inputs": [
+        {
+          "name": "pk",
+          "type": "pubkey"
+        },
+        {
+          "name": "s",
+          "type": "sig"
+        }
+      ]
+    }
+  ],
+  "bytecode": "OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG",
+  "source": "pragma cashscript >=0.10.2;\n\ncontract Foo(bytes20 pkh_foo) {\n    // Require pk to match stored pkh and signature to match\n    function execute(pubkey pk, sig s) {\n        console.log(\"Foo 'execute' function called.\");\n        require(hash160(pk) == pkh_foo);\n        require(checkSig(s, pk));\n    }\n}\n",
+  "debug": {
+    "bytecode": "5179a9517a8769517a517aac",
+    "sourceMap": "7:24:7:26;;:16::27:1;:31::38:0;;:16:::1;:8::40;8:25:8:26:0;;:28::30;;:16::31:1",
+    "logs": [
+      {
+        "ip": 1,
+        "line": 6,
+        "data": [
+          "Foo 'execute' function called."
+        ]
+      }
+    ],
+    "requires": [
+      {
+        "ip": 7,
+        "line": 7
+      },
+      {
+        "ip": 13,
+        "line": 8
+      }
+    ]
+  },
+  "compiler": {
+    "name": "cashc",
+    "version": "0.11.0-next.0"
+  },
+  "updatedAt": "2025-02-18T09:30:48.900Z"
+}
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.artifact.ts b/packages/cashscript/test/fixture/bigint.artifact.ts
index f60e5d43..9658f82c 100644
--- a/packages/cashscript/test/fixture/bigint.artifact.ts
+++ b/packages/cashscript/test/fixture/bigint.artifact.ts
@@ -16,11 +16,11 @@ export default {
       ],
     },
   ],
-  bytecode: '0000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL',
-  source: 'contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt32PlusOne = 2147483648;\n        require(x >= maxInt32PlusOne);\n        require(x * y >= maxInt32PlusOne);\n    }\n}\n',
+  bytecode: '000000000000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL',
+  source: 'contract BigInt() {\r\n    function proofOfBigInt(int x, int y) {\r\n        int maxInt64PlusOne = 9223372036854775808;\r\n        require(x >= maxInt64PlusOne);\r\n        require(x * y >= maxInt64PlusOne);\r\n    }\r\n}\r\n',
   debug: {
-    bytecode: '05000000800051795179a269517a527a95517aa2',
-    sourceMap: '3:30:3:40;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1',
+    bytecode: '0900000000000000800051795179a269517a527a95517aa2',
+    sourceMap: '3:30:3:49;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1',
     logs: [],
     requires: [
       {
@@ -35,7 +35,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.4',
+    version: '0.10.5',
   },
-  updatedAt: '2024-12-03T13:57:07.265Z',
+  updatedAt: '2025-02-10T07:12:49.834Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/bigint.cash b/packages/cashscript/test/fixture/bigint.cash
index e236f5dd..603c50e6 100644
--- a/packages/cashscript/test/fixture/bigint.cash
+++ b/packages/cashscript/test/fixture/bigint.cash
@@ -1,7 +1,7 @@
 contract BigInt() {
     function proofOfBigInt(int x, int y) {
-        int maxInt32PlusOne = 2147483648;
-        require(x >= maxInt32PlusOne);
-        require(x * y >= maxInt32PlusOne);
+        int maxInt64PlusOne = 9223372036854775808;
+        require(x >= maxInt64PlusOne);
+        require(x * y >= maxInt64PlusOne);
     }
 }
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index 7bb4ec7b..fc4e23e7 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -16,11 +16,11 @@
       ]
     }
   ],
-  "bytecode": "0000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL",
-  "source": "contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt32PlusOne = 2147483648;\n        require(x >= maxInt32PlusOne);\n        require(x * y >= maxInt32PlusOne);\n    }\n}\n",
+  "bytecode": "000000000000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL",
+  "source": "contract BigInt() {\r\n    function proofOfBigInt(int x, int y) {\r\n        int maxInt64PlusOne = 9223372036854775808;\r\n        require(x >= maxInt64PlusOne);\r\n        require(x * y >= maxInt64PlusOne);\r\n    }\r\n}\r\n",
   "debug": {
-    "bytecode": "05000000800051795179a269517a527a95517aa2",
-    "sourceMap": "3:30:3:40;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1",
+    "bytecode": "0900000000000000800051795179a269517a527a95517aa2",
+    "sourceMap": "3:30:3:49;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1",
     "logs": [],
     "requires": [
       {
@@ -35,7 +35,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.4"
+    "version": "0.10.5"
   },
-  "updatedAt": "2024-12-03T13:57:06.999Z"
+  "updatedAt": "2025-02-10T07:11:56.680Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/debugging/debugging_contracts.ts b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
new file mode 100644
index 00000000..ef1c04c8
--- /dev/null
+++ b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
@@ -0,0 +1,279 @@
+import { compileString } from 'cashc';
+
+const CONTRACT_TEST_REQUIRES = `
+contract Test() {
+  function test_logs() {
+    console.log("Hello World");
+    require(1 == 2);
+  }
+
+  function test_no_logs() {
+    require(1 == 2);
+  }
+
+  function test_require() {
+    require(1 == 2, "1 should equal 2");
+  }
+
+  function test_require_no_failure() {
+    require(1 == 1, "1 should equal 1");
+  }
+
+  function test_multiple_require_statements() {
+    require(1 == 2, "1 should equal 2");
+    require(1 == 1, "1 should equal 1");
+  }
+
+  function test_multiple_require_statements_final_fails() {
+    require(1 == 1, "1 should equal 1");
+    require(1 == 2, "1 should equal 2");
+  }
+
+  function test_multiple_require_statements_no_message_final() {
+    require(1 == 1, "1 should equal 1");
+    require(1 == 2);
+  }
+
+  function test_timeops_as_final_require() {
+    require(1 == 1, "1 should equal 1");
+    require(tx.time >= 100000000, "time should be HUGE");
+  }
+
+  function test_final_require_in_if_statement(int switch) {
+    if (switch == 1) {
+      int a = 2;
+      require(1 == a, "1 should equal 2");
+    } else if (switch == 2) {
+      int b = 3;
+      require(1 == b, "1 should equal 3");
+    } else {
+      int c = 4;
+      require(switch == c, "switch should equal 4");
+    }
+  }
+
+  function test_final_require_in_if_statement_with_deep_reassignment() {
+    int a = 0;
+    int b = 1;
+    int c = 2;
+    int d = 3;
+    int e = 4;
+    if (a == 0) {
+      a =
+        10 + 10;
+      require(a + b + c + d + e == 10, "sum should equal 10");
+    }
+  }
+
+  function test_invalid_split_range() {
+    bytes test = 0x1234;
+    bytes test2 = test.split(4)[0];
+    require(test2 == 0x1234);
+  }
+
+  function test_invalid_input_index() {
+    require(tx.inputs[5].value == 1000);
+  }
+
+  function test_fail_checksig(sig s, pubkey pk) {
+    require(checkSig(s, pk), "Signatures do not match");
+    require(1 == 2, "1 should equal 2");
+  }
+
+  function test_fail_checksig_final_verify(sig s, pubkey pk) {
+    require(checkSig(s, pk), "Signatures do not match");
+  }
+
+  function test_fail_checkdatasig(datasig s, bytes message, pubkey pk) {
+    require(checkDataSig(s, message, pk), "Data Signatures do not match");
+  }
+
+  function test_fail_checkmultisig(sig s1, pubkey pk1, sig s2, pubkey pk2) {
+    require(checkMultiSig([s1, s2], [pk1, pk2]), "Multi Signatures do not match");
+  }
+}
+`;
+
+const CONTRACT_TEST_REQUIRE_SINGLE_FUNCTION = `
+contract Test() {
+  function test_require_single_function() {
+    require(tx.outputs.length == 1, "should have 1 output");
+  }
+}`;
+
+const CONTRACT_TEST_MULTILINE_REQUIRES = `
+contract Test() {
+  // We test this because the cleanup looks different and the final OP_VERIFY isn't removed for these kinds of functions
+  function test_fail_large_cleanup() {
+    int a = 1;
+    int b = 2;
+    int c = 3;
+    int d = 4;
+    int e = 5;
+    int f = 6;
+    int g = 7;
+    int h = 8;
+
+    // Use all variables inside this if-statement so they do not get OP_ROLL'ed
+    if (
+    1
+      == 2
+    ) {
+      require(a + b + c + d + e + f + g + h == 1, "sum should equal 36");
+    }
+
+    require(1 == 2, "1 should equal 2");
+  }
+
+  function test_fail_multiline_require() {
+    require(
+      1 == 2,
+      "1 should equal 2"
+    );
+
+    require(1 == 1);
+  }
+
+  function test_fail_multiline_final_require() {
+    require(
+      1 == 2,
+      "1 should equal 2"
+    );
+  }
+
+  function test_multiline_non_require_error() {
+    int x =
+      tx.outputs[
+        5
+      ].value +
+      tx.inputs[5].value;
+    require(x == 1000);
+  }
+
+  function test_multiline_require_with_unary_op() {
+    require(
+      !(
+        0x000000
+        .reverse()
+        .length
+        !=
+        -(
+          30
+            +
+          15
+        )
+      )
+    );
+
+    require(1 == 1);
+  }
+
+  function test_multiline_require_with_instantiation() {
+    require(
+      new LockingBytecodeP2PKH(
+        hash160(0x000000)
+      )
+        ==
+      new LockingBytecodeNullData([
+        0x00,
+        bytes("hello world")
+      ])
+    );
+
+    require(1 == 1);
+  }
+}
+`;
+
+const CONTRACT_TEST_ZERO_HANDLING = `
+contract Test(int a) {
+  function test_zero_handling(int b) {
+    require(a == 0, "a should be 0");
+    require(b == 0, "b should be 0");
+    require(a == b, "a should equal b");
+  }
+}
+`;
+
+const CONTRACT_TEST_LOGS = `
+contract Test(pubkey owner) {
+  function transfer(sig ownerSig, int num) {
+    console.log('Hello First Function');
+    require(checkSig(ownerSig, owner));
+
+    bytes2 beef = 0xbeef;
+    require(beef != 0xfeed);
+
+    console.log(ownerSig, owner, num, beef, 1, "test", true);
+
+    require(num == 1000);
+  }
+
+  function secondFunction() {
+    console.log("Hello Second Function");
+    require(1 == 1);
+  }
+
+  function functionWithIfStatement(int a) {
+    int b = 0;
+
+    if (a == 1) {
+      console.log("a is 1");
+      b = a;
+    } else {
+      console.log("a is not 1");
+      b = 2;
+    }
+
+    console.log('a equals', a);
+    console.log('b equals', b);
+
+    require(1 == 1);
+  }
+
+  function noLogs() {
+    require(1 == 1);
+  }
+}
+`;
+
+const CONTRACT_TEST_CONSECUTIVE_LOGS = `
+contract Test(pubkey owner) {
+  function transfer(sig ownerSig, int num) {
+    require(checkSig(ownerSig, owner));
+
+    bytes2 beef = 0xbeef;
+    require(beef != 0xfeed);
+
+    console.log(ownerSig, owner, num);
+    console.log(beef, 1, "test", true);
+
+    require(num == 1000);
+  }
+}
+`;
+
+const CONTRACT_TEST_MULTPLE_LOGS = `
+contract Test(pubkey owner) {
+  function transfer(sig ownerSig, int num) {
+    require(checkSig(ownerSig, owner));
+    
+    console.log(ownerSig, owner, num);
+
+    bytes2 beef = 0xbeef;
+    require(beef != 0xfeed);
+
+    console.log(beef, 1, "test", true);
+
+    require(num == 1000);
+  }
+}
+`;
+
+export const artifactTestRequires = compileString(CONTRACT_TEST_REQUIRES);
+export const artifactTestSingleFunction = compileString(CONTRACT_TEST_REQUIRE_SINGLE_FUNCTION);
+export const artifactTestMultilineRequires = compileString(CONTRACT_TEST_MULTILINE_REQUIRES);
+export const artifactTestZeroHandling = compileString(CONTRACT_TEST_ZERO_HANDLING);
+export const artifactTestLogs = compileString(CONTRACT_TEST_LOGS);
+export const artifactTestConsecutiveLogs = compileString(CONTRACT_TEST_CONSECUTIVE_LOGS);
+export const artifactTestMultipleLogs = compileString(CONTRACT_TEST_MULTPLE_LOGS);
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 608497a8..a00de46b 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -31,18 +31,18 @@ export const fixtures: Fixture[] = [
     template: {
       '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
       'description': 'Imported from cashscript',
-      'name': 'TransferWithTimeout',
+      'name': 'CashScript Generated Debugging Template',
       'supported': [
         'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
-        'parameters': {
+        'transfer_with_timeout_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'parameters',
+          'name': 'transfer_with_timeout_parameters',
           'scripts': [
-            'lock',
-            'unlock_lock',
+            'transfer_with_timeout_lock',
+            'transfer_with_timeout_unlock',
           ],
           'variables': {
             'recipient_sig': {
@@ -74,8 +74,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'evaluate_function': {
-          'name': 'Evaluate',
+        'transfer_with_timeout_evaluate': {
+          'name': 'transfer_with_timeout_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -123,17 +123,17 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'unlock_lock': {
+        'transfer_with_timeout_unlock': {
           'passes': [
-            'evaluate_function',
+            'transfer_with_timeout_evaluate',
           ],
-          'name': 'unlock',
+          'name': 'transfer_with_timeout_unlock',
           'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'lock',
+          'unlocks': 'transfer_with_timeout_lock',
         },
-        'lock': {
+        'transfer_with_timeout_lock': {
           'lockingType': 'p2sh32',
-          'name': 'lock',
+          'name': 'transfer_with_timeout_lock',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
         },
       },
@@ -155,18 +155,18 @@ export const fixtures: Fixture[] = [
     template: {
       '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
       'description': 'Imported from cashscript',
-      'name': 'TransferWithTimeout',
+      'name': 'CashScript Generated Debugging Template',
       'supported': [
         'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
-        'parameters': {
+        'transfer_with_timeout_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'parameters',
+          'name': 'transfer_with_timeout_parameters',
           'scripts': [
-            'lock',
-            'unlock_lock',
+            'transfer_with_timeout_lock',
+            'transfer_with_timeout_unlock',
           ],
           'variables': {
             'function_index': {
@@ -198,8 +198,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'evaluate_function': {
-          'name': 'Evaluate',
+        'transfer_with_timeout_evaluate': {
+          'name': 'transfer_with_timeout_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -247,17 +247,17 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'unlock_lock': {
+        'transfer_with_timeout_unlock': {
           'passes': [
-            'evaluate_function',
+            'transfer_with_timeout_evaluate',
           ],
-          'name': 'unlock',
+          'name': 'transfer_with_timeout_unlock',
           'script': '// "timeout\" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'lock',
+          'unlocks': 'transfer_with_timeout_lock',
         },
-        'lock': {
+        'transfer_with_timeout_lock': {
           'lockingType': 'p2sh32',
-          'name': 'lock',
+          'name': 'transfer_with_timeout_lock',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
         },
       },
@@ -279,18 +279,18 @@ export const fixtures: Fixture[] = [
     template: {
       '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
       'description': 'Imported from cashscript',
-      'name': 'Mecenas',
+      'name': 'CashScript Generated Debugging Template',
       'supported': [
         'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
-        'parameters': {
+        'mecenas_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'parameters',
+          'name': 'mecenas_parameters',
           'scripts': [
-            'lock',
-            'unlock_lock',
+            'mecenas_lock',
+            'mecenas_unlock',
           ],
           'variables': {
             'function_index': {
@@ -317,8 +317,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'evaluate_function': {
-          'name': 'Evaluate',
+        'mecenas_evaluate': {
+          'name': 'mecenas_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -368,17 +368,17 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'unlock_lock': {
+        'mecenas_unlock': {
           'passes': [
-            'evaluate_function',
+            'mecenas_evaluate',
           ],
-          'name': 'unlock',
+          'name': 'mecenas_unlock',
           'script': '// "receive" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'lock',
+          'unlocks': 'mecenas_lock',
         },
-        'lock': {
+        'mecenas_lock': {
           'lockingType': 'p2sh32',
-          'name': 'lock',
+          'name': 'mecenas_lock',
           'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(tx.age >= period);                                                                              */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
         },
       },
@@ -408,18 +408,18 @@ export const fixtures: Fixture[] = [
     template: {
       '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
       'description': 'Imported from cashscript',
-      'name': 'P2PKH',
+      'name': 'CashScript Generated Debugging Template',
       'supported': [
         'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
-        'parameters': {
+        'p2_pkh_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'parameters',
+          'name': 'p2_pkh_parameters',
           'scripts': [
-            'lock',
-            'unlock_lock',
+            'p2_pkh_lock',
+            'p2_pkh_unlock',
           ],
           'variables': {
             's': {
@@ -441,8 +441,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'evaluate_function': {
-          'name': 'Evaluate',
+        'p2_pkh_evaluate': {
+          'name': 'p2_pkh_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -510,17 +510,17 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'unlock_lock': {
+        'p2_pkh_unlock': {
           'passes': [
-            'evaluate_function',
+            'p2_pkh_evaluate',
           ],
-          'name': 'unlock',
+          'name': 'p2_pkh_unlock',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'lock',
+          'unlocks': 'p2_pkh_lock',
         },
-        'lock': {
+        'p2_pkh_lock': {
           'lockingType': 'p2sh32',
-          'name': 'lock',
+          'name': 'p2_pkh_lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
       },
@@ -548,18 +548,18 @@ export const fixtures: Fixture[] = [
     template: {
       '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
       'description': 'Imported from cashscript',
-      'name': 'P2PKH',
+      'name': 'CashScript Generated Debugging Template',
       'supported': [
         'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
-        'parameters': {
+        'p2_pkh_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'parameters',
+          'name': 'p2_pkh_parameters',
           'scripts': [
-            'lock',
-            'unlock_lock',
+            'p2_pkh_lock',
+            'p2_pkh_unlock',
           ],
           'variables': {
             's': {
@@ -581,8 +581,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'evaluate_function': {
-          'name': 'Evaluate',
+        'p2_pkh_evaluate': {
+          'name': 'p2_pkh_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -631,17 +631,17 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'unlock_lock': {
+        'p2_pkh_unlock': {
           'passes': [
-            'evaluate_function',
+            'p2_pkh_evaluate',
           ],
-          'name': 'unlock',
+          'name': 'p2_pkh_unlock',
           'script': '// "spend" function parameters\n<s> // sig = <0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61>\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'lock',
+          'unlocks': 'p2_pkh_lock',
         },
-        'lock': {
+        'p2_pkh_lock': {
           'lockingType': 'p2sh32',
-          'name': 'lock',
+          'name': 'p2_pkh_lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
       },
@@ -671,18 +671,18 @@ export const fixtures: Fixture[] = [
     template: {
       '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
       'description': 'Imported from cashscript',
-      'name': 'P2PKH',
+      'name': 'CashScript Generated Debugging Template',
       'supported': [
         'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
-        'parameters': {
+        'p2_pkh_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'parameters',
+          'name': 'p2_pkh_parameters',
           'scripts': [
-            'lock',
-            'unlock_lock',
+            'p2_pkh_lock',
+            'p2_pkh_unlock',
           ],
           'variables': {
             's': {
@@ -704,8 +704,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'evaluate_function': {
-          'name': 'Evaluate',
+        'p2_pkh_evaluate': {
+          'name': 'p2_pkh_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -781,17 +781,17 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'unlock_lock': {
+        'p2_pkh_unlock': {
           'passes': [
-            'evaluate_function',
+            'p2_pkh_evaluate',
           ],
-          'name': 'unlock',
+          'name': 'p2_pkh_unlock',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'lock',
+          'unlocks': 'p2_pkh_lock',
         },
-        'lock': {
+        'p2_pkh_lock': {
           'lockingType': 'p2sh32',
-          'name': 'lock',
+          'name': 'p2_pkh_lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
       },
@@ -819,18 +819,18 @@ export const fixtures: Fixture[] = [
     template: {
       '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
       'description': 'Imported from cashscript',
-      'name': 'HodlVault',
+      'name': 'CashScript Generated Debugging Template',
       'supported': [
         'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
-        'parameters': {
+        'hodl_vault_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'parameters',
+          'name': 'hodl_vault_parameters',
           'scripts': [
-            'lock',
-            'unlock_lock',
+            'hodl_vault_lock',
+            'hodl_vault_unlock',
           ],
           'variables': {
             'oracle_message': {
@@ -872,8 +872,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'evaluate_function': {
-          'name': 'Evaluate',
+        'hodl_vault_evaluate': {
+          'name': 'hodl_vault_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -927,17 +927,17 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'unlock_lock': {
+        'hodl_vault_unlock': {
           'passes': [
-            'evaluate_function',
+            'hodl_vault_evaluate',
           ],
-          'name': 'unlock',
+          'name': 'hodl_vault_unlock',
           'script': '// "spend" function parameters\n<oracle_message> // bytes8 = <0xa086010030750000>\n<oracle_sig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<owner_sig.schnorr_signature.all_outputs_all_utxos> // sig\n',
-          'unlocks': 'lock',
+          'unlocks': 'hodl_vault_lock',
         },
-        'lock': {
+        'hodl_vault_lock': {
           'lockingType': 'p2sh32',
-          'name': 'lock',
+          'name': 'hodl_vault_lock',
           'script': '// "HodlVault" contract constructor parameters\n<price_target> // int = <0x3075>\n<min_block> // int = <0xb88201>\n<oracle_pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<owner_pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
         },
       },
@@ -990,18 +990,18 @@ export const fixtures: Fixture[] = [
     template: {
       '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
       'description': 'Imported from cashscript',
-      'name': 'P2PKH',
+      'name': 'CashScript Generated Debugging Template',
       'supported': [
         'BCH_2023_05',
       ],
       'version': 0,
       'entities': {
-        'parameters': {
+        'p2_pkh_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'parameters',
+          'name': 'p2_pkh_parameters',
           'scripts': [
-            'lock',
-            'unlock_lock',
+            'p2_pkh_lock',
+            'p2_pkh_unlock',
             'p2pkh_placeholder_lock_0',
             'p2pkh_placeholder_unlock_0',
             'p2pkh_placeholder_lock_2',
@@ -1037,8 +1037,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'evaluate_function': {
-          'name': 'Evaluate',
+        'p2_pkh_evaluate': {
+          'name': 'p2_pkh_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1144,17 +1144,17 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'unlock_lock': {
+        'p2_pkh_unlock': {
           'passes': [
-            'evaluate_function',
+            'p2_pkh_evaluate',
           ],
-          'name': 'unlock',
+          'name': 'p2_pkh_unlock',
           'script': '// "spend" function parameters\n<s.ecdsa_signature.no_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'lock',
+          'unlocks': 'p2_pkh_lock',
         },
-        'lock': {
+        'p2_pkh_lock': {
           'lockingType': 'p2sh20',
-          'name': 'lock',
+          'name': 'p2_pkh_lock',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
         'p2pkh_placeholder_unlock_0': {
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
new file mode 100644
index 00000000..3bc388fc
--- /dev/null
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -0,0 +1,1426 @@
+import { TransactionBuilder, Contract, MockNetworkProvider, SignatureTemplate, randomNFT, randomToken, randomUtxo } from '../../../src/index.js';
+import BarArtifact from '../Bar.artifact.js';
+import FooArtifact from '../Foo.artifact.js';
+import { aliceAddress, alicePkh, alicePriv, alicePub, aliceTokenAddress, bobPriv, bobPub } from '../vars.js';
+import { WalletTemplate } from '@bitauth/libauth';
+
+const provider = new MockNetworkProvider();
+
+export interface Fixture {
+  name: string;
+  transaction: Promise<TransactionBuilder>;
+  template: WalletTemplate;
+}
+
+export const fixtures: Fixture[] = [
+  {
+    name: 'Foo + Bar + P2PKH UTXOs',
+    transaction: (async () => {
+      // TODO: Foo contract is just P2PKH contract with extra log, see if we can use P2PKH contract instead
+      const fooContract = new Contract(FooArtifact, [alicePkh], { provider });
+      provider.addUtxo(fooContract.address, randomUtxo());
+
+      const tokenA = randomToken({ amount: 100000000n });
+      const nftB = randomNFT({
+        nft: {
+          capability: 'minting',
+          commitment: '00',
+        },
+      });
+
+      const barContract = new Contract(BarArtifact, [alicePkh], { provider });
+      provider.addUtxo(barContract.address, randomUtxo());
+      provider.addUtxo(barContract.address, randomUtxo());
+      provider.addUtxo(barContract.address, randomUtxo());
+
+      const aliceTemplate = new SignatureTemplate(alicePriv);
+      provider.addUtxo(aliceAddress, randomUtxo());
+      provider.addUtxo(aliceAddress, randomUtxo({ token: tokenA }));
+      provider.addUtxo(aliceAddress, randomUtxo({ token: nftB }));
+
+      const utxos = await provider.getUtxos(aliceAddress);
+      const fooContractUtxos = await fooContract.getUtxos();
+      const barContractUtxos = await barContract.getUtxos();
+
+      return new TransactionBuilder({ provider })
+        .addInputs([utxos[0], utxos[1], utxos[2]], aliceTemplate.unlockP2PKH())
+        .addInput(barContractUtxos[0], barContract.unlock.funcA())
+        .addInput(barContractUtxos[1], barContract.unlock.execute(alicePub, aliceTemplate))
+        .addInput(fooContractUtxos[0], fooContract.unlock.execute(alicePub, aliceTemplate))
+        .addInput(barContractUtxos[2], barContract.unlock.funcB())
+        .addOutput({ to: fooContract.address, amount: 8000n })
+        .addOutput({ to: aliceTokenAddress, amount: 800n, token: tokenA })
+        .addOutput({ to: aliceTokenAddress, amount: 1000n, token: nftB })
+        .addOpReturnOutput(['hello', 'world']);
+
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2023_05',
+      ],
+      'version': 0,
+      'entities': {
+        'bar_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Bar',
+          'scripts': [
+            'bar_lock',
+            'bar_func_b_unlock',
+          ],
+          'variables': {
+            'pkh_bar': {
+              'description': '"pkh_bar" parameter of this contract',
+              'name': 'Pkh Bar',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'foo_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Foo',
+          'scripts': [
+            'foo_lock',
+            'foo_execute_unlock',
+          ],
+          'variables': {
+            'pk': {
+              'description': '"pk" parameter of function "execute"',
+              'name': 'Pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "execute"',
+              'name': 'S',
+              'type': 'Key',
+            },
+            'pkh_foo': {
+              'description': '"pkh_foo" parameter of this contract',
+              'name': 'Pkh Foo',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'signer_0': {
+          'scripts': [
+            'bar_func_a_unlock',
+            'bar_lock',
+            'bar_execute_unlock',
+            'foo_execute_unlock',
+            'foo_lock',
+            'bar_func_b_unlock',
+            'p2pkh_placeholder_lock_0',
+            'p2pkh_placeholder_unlock_0',
+          ],
+          'description': 'placeholder_key_0',
+          'name': 'Signer 0',
+          'variables': {
+            'placeholder_key_0': {
+              'description': '',
+              'name': 'Placeholder Key 0',
+              'type': 'Key',
+            },
+          },
+        },
+        'signer_1': {
+          'scripts': [
+            'bar_func_a_unlock',
+            'bar_lock',
+            'bar_execute_unlock',
+            'foo_execute_unlock',
+            'foo_lock',
+            'bar_func_b_unlock',
+            'p2pkh_placeholder_lock_1',
+            'p2pkh_placeholder_unlock_1',
+          ],
+          'description': 'placeholder_key_1',
+          'name': 'Signer 1',
+          'variables': {
+            'placeholder_key_1': {
+              'description': '',
+              'name': 'Placeholder Key 1',
+              'type': 'Key',
+            },
+          },
+        },
+        'signer_2': {
+          'scripts': [
+            'bar_func_a_unlock',
+            'bar_lock',
+            'bar_execute_unlock',
+            'foo_execute_unlock',
+            'foo_lock',
+            'bar_func_b_unlock',
+            'p2pkh_placeholder_lock_2',
+            'p2pkh_placeholder_unlock_2',
+          ],
+          'description': 'placeholder_key_2',
+          'name': 'Signer 2',
+          'variables': {
+            'placeholder_key_2': {
+              'description': '',
+              'name': 'Placeholder Key 2',
+              'type': 'Key',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'bar_func_a_unlock': {
+          'passes': [
+            'bar_func_a_evaluate',
+          ],
+          'name': 'funcA',
+          'script': '// "funcA" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'bar_lock',
+        },
+        'bar_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'Bar',
+          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
+        },
+        'bar_execute_unlock': {
+          'passes': [
+            'bar_execute_evaluate',
+          ],
+          'name': 'execute',
+          'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// function index in contract\n<function_index> // int = <2>\n',
+          'unlocks': 'bar_lock',
+        },
+        'foo_execute_unlock': {
+          'passes': [
+            'foo_execute_evaluate',
+          ],
+          'name': 'execute',
+          'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'foo_lock',
+        },
+        'foo_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'Foo',
+          'script': "// \"Foo\" contract constructor parameters\n<pkh_foo> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                                  */\n                                                        /*                                                              */\n                                                        /* contract Foo(bytes20 pkh_foo) {                              */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function execute(pubkey pk, sig s) {                     */\n                                                        /*         console.log('Foo 'execute' function called.');       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_foo);                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */",
+        },
+        'bar_func_b_unlock': {
+          'passes': [
+            'bar_func_b_evaluate',
+          ],
+          'name': 'funcB',
+          'script': '// "funcB" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'bar_lock',
+        },
+        'p2pkh_placeholder_unlock_0': {
+          'name': 'p2pkh_placeholder_unlock_0',
+          'script': '<placeholder_key_0.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_0.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock_0',
+        },
+        'p2pkh_placeholder_lock_0': {
+          'lockingType': 'standard',
+          'name': 'p2pkh_placeholder_lock_0',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_0.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+        },
+        'p2pkh_placeholder_unlock_1': {
+          'name': 'p2pkh_placeholder_unlock_1',
+          'script': '<placeholder_key_1.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_1.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock_1',
+        },
+        'p2pkh_placeholder_lock_1': {
+          'lockingType': 'standard',
+          'name': 'p2pkh_placeholder_lock_1',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_1.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+        },
+        'p2pkh_placeholder_unlock_2': {
+          'name': 'p2pkh_placeholder_unlock_2',
+          'script': '<placeholder_key_2.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_2.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock_2',
+        },
+        'p2pkh_placeholder_lock_2': {
+          'lockingType': 'standard',
+          'name': 'p2pkh_placeholder_lock_2',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_2.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+        },
+      },
+      'scenarios': {
+        'bar_func_a_evaluate': {
+          'name': 'bar_func_a_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              'function_index': '0',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {},
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_0',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_1',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_1': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_2',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_2': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': expect.any(Number),
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'foo_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
+                'valueSatoshis': 8000,
+              },
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'token': {
+                  'amount': '100000000',
+                  'category': expect.any(String),
+                },
+                'valueSatoshis': 800,
+              },
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'token': {
+                  'amount': '0',
+                  'category': expect.any(String),
+                  'nft': {
+                    'capability': 'minting',
+                    'commitment': '00',
+                  },
+                },
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': '6a0568656c6c6f05776f726c64',
+                'valueSatoshis': 0,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_0',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_1',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_1': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_2',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_2': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'foo_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+        'bar_execute_evaluate': {
+          'name': 'bar_execute_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              'function_index': '2',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_0',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_1',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_1': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_2',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_2': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'foo_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
+                'valueSatoshis': 8000,
+              },
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'token': {
+                  'amount': '100000000',
+                  'category': expect.any(String),
+                },
+                'valueSatoshis': 800,
+              },
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'token': {
+                  'amount': '0',
+                  'category': expect.any(String),
+                  'nft': {
+                    'capability': 'minting',
+                    'commitment': '00',
+                  },
+                },
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': '6a0568656c6c6f05776f726c64',
+                'valueSatoshis': 0,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_0',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_1',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_1': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_2',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_2': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'foo_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+        'foo_execute_evaluate': {
+          'name': 'foo_execute_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_0',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_1',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_1': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_2',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_2': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'foo_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
+                'valueSatoshis': 8000,
+              },
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'token': {
+                  'amount': '100000000',
+                  'category': expect.any(String),
+                },
+                'valueSatoshis': 800,
+              },
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'token': {
+                  'amount': '0',
+                  'category': expect.any(String),
+                  'nft': {
+                    'capability': 'minting',
+                    'commitment': '00',
+                  },
+                },
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': '6a0568656c6c6f05776f726c64',
+                'valueSatoshis': 0,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_0',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_1',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_1': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_2',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_2': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+        'bar_func_b_evaluate': {
+          'name': 'bar_func_b_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              'function_index': '1',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {},
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_0',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_1',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_1': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_2',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_2': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'foo_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
+                'valueSatoshis': 8000,
+              },
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'token': {
+                  'amount': '100000000',
+                  'category': expect.any(String),
+                },
+                'valueSatoshis': 800,
+              },
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'token': {
+                  'amount': '0',
+                  'category': expect.any(String),
+                  'nft': {
+                    'capability': 'minting',
+                    'commitment': '00',
+                  },
+                },
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': '6a0568656c6c6f05776f726c64',
+                'valueSatoshis': 0,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_0',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_1',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_1': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_2',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_2': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'foo_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
+  {
+    name: 'Simple 1 contract input & 1 contract output',
+    transaction: (async () => {
+      const contract = new Contract(BarArtifact, [alicePkh], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const contractUtxos = await contract.getUtxos();
+
+      return new TransactionBuilder({ provider })
+        .addInput(
+          contractUtxos[0],
+          contract.unlock.funcA(),
+        )
+        .addOutput({ to: contract.address, amount: 10_000n });
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2023_05',
+      ],
+      'version': 0,
+      'entities': {
+        'bar_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Bar',
+          'scripts': [
+            'bar_lock',
+            'bar_func_a_unlock',
+          ],
+          'variables': {
+            'pkh_bar': {
+              'description': '"pkh_bar" parameter of this contract',
+              'name': 'Pkh Bar',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'bar_func_a_unlock': {
+          'passes': [
+            'bar_func_a_evaluate',
+          ],
+          'name': 'funcA',
+          'script': '// "funcA" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'bar_lock',
+        },
+        'bar_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'Bar',
+          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
+        },
+      },
+      'scenarios': {
+        'bar_func_a_evaluate': {
+          'name': 'bar_func_a_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              'function_index': '0',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {},
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'bar_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
+                'valueSatoshis': 10000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
+  {
+    // TODO: Duplicate input scenarios with the same function call have the same name
+    name: 'Duplicate function calls',
+    transaction: (async () => {
+      const barContract = new Contract(BarArtifact, [alicePkh], { provider });
+      provider.addUtxo(barContract.address, randomUtxo());
+      provider.addUtxo(barContract.address, randomUtxo());
+
+      const barContractUtxos = await barContract.getUtxos();
+
+      const aliceTemplate = new SignatureTemplate(alicePriv);
+      const bobTemplate = new SignatureTemplate(bobPriv);
+
+      return new TransactionBuilder({ provider })
+        .addInput(barContractUtxos[0], barContract.unlock.execute(alicePub, aliceTemplate))
+        .addInput(barContractUtxos[1], barContract.unlock.execute(bobPub, bobTemplate))
+        .addOutput({ to: barContract.address, amount: 20_000n });
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2023_05',
+      ],
+      'version': 0,
+      'entities': {
+        'bar_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Bar',
+          'scripts': [
+            'bar_lock',
+            'bar_execute_unlock',
+          ],
+          'variables': {
+            'pk': {
+              'description': '"pk" parameter of function "execute"',
+              'name': 'Pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "execute"',
+              'name': 'S',
+              'type': 'Key',
+            },
+            'pkh_bar': {
+              'description': '"pkh_bar" parameter of this contract',
+              'name': 'Pkh Bar',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'bar_execute_unlock': {
+          'passes': [
+            'bar_execute_evaluate',
+            'bar_execute_evaluate1',
+          ],
+          'name': 'execute',
+          'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// function index in contract\n<function_index> // int = <2>\n',
+          'unlocks': 'bar_lock',
+        },
+        'bar_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'Bar',
+          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
+        },
+      },
+      'scenarios': {
+        'bar_execute_evaluate': {
+          'name': 'bar_execute_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              'function_index': '2',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'bar_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
+                'valueSatoshis': 20000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+        'bar_execute_evaluate1': {
+          'name': 'bar_execute_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              'function_index': '2',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'bar_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
+                'valueSatoshis': 20000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'bar_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
+];
diff --git a/packages/cashscript/test/fixture/simple_covenant.artifact.ts b/packages/cashscript/test/fixture/simple_covenant.artifact.ts
deleted file mode 100644
index e2f83179..00000000
--- a/packages/cashscript/test/fixture/simple_covenant.artifact.ts
+++ /dev/null
@@ -1,48 +0,0 @@
-export default {
-  contractName: 'Covenant',
-  constructorInputs: [],
-  abi: [
-    {
-      name: 'spend',
-      inputs: [],
-    },
-  ],
-  bytecode: 'OP_TXVERSION OP_2 OP_GREATERTHANOREQUAL OP_VERIFY OP_TXINPUTCOUNT OP_1 OP_GREATERTHANOREQUAL OP_VERIFY OP_TXOUTPUTCOUNT OP_1 OP_GREATERTHANOREQUAL OP_VERIFY OP_ACTIVEBYTECODE OP_SIZE OP_NIP 0802 OP_LESSTHAN OP_VERIFY OP_0 OP_UTXOVALUE 2202 OP_GREATERTHANOREQUAL OP_VERIFY OP_0 OP_OUTPUTVALUE 2202 OP_GREATERTHANOREQUAL',
-  source: 'contract Covenant() {\n    function spend() {\n        require(tx.version >= 2);\n        require(tx.inputs.length >= 1);\n        require(tx.outputs.length >= 1);\n        require(this.activeBytecode.length < 520);\n        require(tx.inputs[0].value >= 546);\n        require(tx.outputs[0].value >= 546);\n    }\n}\n',
-  debug: {
-    bytecode: 'c252a269c351a269c451a269c182770208029f6900c6022202a26900cc022202a2',
-    sourceMap: '3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:32:0;:36::37;:16:::1;:8::39;5:16:5:33:0;:37::38;:16:::1;:8::40;6:16:6:35:0;:::42:1;;:45::48:0;:16:::1;:8::50;7:26:7:27:0;:16::34:1;:38::41:0;:16:::1;:8::43;8:27:8:28:0;:16::35:1;:39::42:0;:16:::1',
-    logs: [],
-    requires: [
-      {
-        ip: 3,
-        line: 3,
-      },
-      {
-        ip: 7,
-        line: 4,
-      },
-      {
-        ip: 11,
-        line: 5,
-      },
-      {
-        ip: 17,
-        line: 6,
-      },
-      {
-        ip: 22,
-        line: 7,
-      },
-      {
-        ip: 27,
-        line: 8,
-      },
-    ],
-  },
-  compiler: {
-    name: 'cashc',
-    version: '0.10.4',
-  },
-  updatedAt: '2024-12-03T13:57:09.639Z',
-} as const;
diff --git a/packages/cashscript/test/fixture/simple_covenant.cash b/packages/cashscript/test/fixture/simple_covenant.cash
deleted file mode 100644
index 12b6ec4e..00000000
--- a/packages/cashscript/test/fixture/simple_covenant.cash
+++ /dev/null
@@ -1,10 +0,0 @@
-contract Covenant() {
-    function spend() {
-        require(tx.version >= 2);
-        require(tx.inputs.length >= 1);
-        require(tx.outputs.length >= 1);
-        require(this.activeBytecode.length < 520);
-        require(tx.inputs[0].value >= 546);
-        require(tx.outputs[0].value >= 546);
-    }
-}
diff --git a/packages/cashscript/test/fixture/simple_covenant.json b/packages/cashscript/test/fixture/simple_covenant.json
deleted file mode 100644
index 65241c57..00000000
--- a/packages/cashscript/test/fixture/simple_covenant.json
+++ /dev/null
@@ -1,48 +0,0 @@
-{
-  "contractName": "Covenant",
-  "constructorInputs": [],
-  "abi": [
-    {
-      "name": "spend",
-      "inputs": []
-    }
-  ],
-  "bytecode": "OP_TXVERSION OP_2 OP_GREATERTHANOREQUAL OP_VERIFY OP_TXINPUTCOUNT OP_1 OP_GREATERTHANOREQUAL OP_VERIFY OP_TXOUTPUTCOUNT OP_1 OP_GREATERTHANOREQUAL OP_VERIFY OP_ACTIVEBYTECODE OP_SIZE OP_NIP 0802 OP_LESSTHAN OP_VERIFY OP_0 OP_UTXOVALUE 2202 OP_GREATERTHANOREQUAL OP_VERIFY OP_0 OP_OUTPUTVALUE 2202 OP_GREATERTHANOREQUAL",
-  "source": "contract Covenant() {\n    function spend() {\n        require(tx.version >= 2);\n        require(tx.inputs.length >= 1);\n        require(tx.outputs.length >= 1);\n        require(this.activeBytecode.length < 520);\n        require(tx.inputs[0].value >= 546);\n        require(tx.outputs[0].value >= 546);\n    }\n}\n",
-  "debug": {
-    "bytecode": "c252a269c351a269c451a269c182770208029f6900c6022202a26900cc022202a2",
-    "sourceMap": "3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:32:0;:36::37;:16:::1;:8::39;5:16:5:33:0;:37::38;:16:::1;:8::40;6:16:6:35:0;:::42:1;;:45::48:0;:16:::1;:8::50;7:26:7:27:0;:16::34:1;:38::41:0;:16:::1;:8::43;8:27:8:28:0;:16::35:1;:39::42:0;:16:::1",
-    "logs": [],
-    "requires": [
-      {
-        "ip": 3,
-        "line": 3
-      },
-      {
-        "ip": 7,
-        "line": 4
-      },
-      {
-        "ip": 11,
-        "line": 5
-      },
-      {
-        "ip": 17,
-        "line": 6
-      },
-      {
-        "ip": 22,
-        "line": 7
-      },
-      {
-        "ip": 27,
-        "line": 8
-      }
-    ]
-  },
-  "compiler": {
-    "name": "cashc",
-    "version": "0.10.4"
-  },
-  "updatedAt": "2024-12-03T13:57:09.409Z"
-}
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/vars.ts b/packages/cashscript/test/fixture/vars.ts
index 70614c91..ffd77c38 100644
--- a/packages/cashscript/test/fixture/vars.ts
+++ b/packages/cashscript/test/fixture/vars.ts
@@ -26,16 +26,19 @@ export const alicePriv = aliceNode.privateKey;
 export const alicePub = secp256k1.derivePublicKeyCompressed(alicePriv) as Uint8Array;
 export const alicePkh = hash160(alicePub);
 export const aliceAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkh', payload: alicePkh, throwErrors: true }).address;
+export const aliceTokenAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkhWithTokens', payload: alicePkh, throwErrors: true }).address;
 
 export const bobPriv = bobNode.privateKey;
 export const bobPub = secp256k1.derivePublicKeyCompressed(bobPriv) as Uint8Array;
 export const bobPkh = hash160(bobPub);
 export const bobAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkh', payload: bobPkh, throwErrors: true }).address;
+export const bobTokenAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkhWithTokens', payload: bobPkh, throwErrors: true }).address;
 
 export const carolPriv = carolNode.privateKey;
 export const carolPub = secp256k1.derivePublicKeyCompressed(carolPriv) as Uint8Array;
 export const carolPkh = hash160(carolPub);
 export const carolAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkh', payload: carolPkh, throwErrors: true }).address;
+export const carolTokenAddress = encodeCashAddress({ prefix: 'bchtest', type: 'p2pkhWithTokens', payload: carolPkh, throwErrors: true }).address;
 
 export const oracle = new PriceOracle(bobPriv);
 export const oraclePub = bobPub;
diff --git a/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts b/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts
new file mode 100644
index 00000000..9e388127
--- /dev/null
+++ b/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts
@@ -0,0 +1,13 @@
+import { fixtures } from '../fixture/libauth-template/multi-contract-fixtures.js';
+
+describe('Libauth Template generation tests (multi-contract)', () => {
+  fixtures.forEach((fixture) => {
+    it(`should generate a valid libauth template for ${fixture.name}`, async () => {
+      const builder = await fixture.transaction;
+      const generatedTemplate = await builder.getLibauthTemplate();
+      // console.log(await builder.bitauthUri());
+      // console.log(JSON.stringify(generatedTemplate, null, 2));
+      expect(generatedTemplate).toEqual(fixture.template);
+    });
+  });
+});
diff --git a/packages/cashscript/test/test-util.ts b/packages/cashscript/test/test-util.ts
index e4852f10..3b588ee6 100644
--- a/packages/cashscript/test/test-util.ts
+++ b/packages/cashscript/test/test-util.ts
@@ -35,3 +35,42 @@ export function getTxOutputs(tx: Transaction, network: Network = defaultNetwork)
 export function getLargestUtxo(utxos: Utxo[]): Utxo {
   return [...utxos].sort(utxoComparator).reverse()[0];
 }
+
+export function gatherUtxos(
+  utxos: Utxo[],
+  options?: { amount?: bigint, fee?: bigint },
+): { utxos: Utxo[], total: bigint, changeAmount: bigint } {
+  const targetUtxos: Utxo[] = [];
+  let total = 0n;
+
+  // 1000 for fees
+  const { amount = 0n, fee = 1000n } = options ?? {};
+
+  const minChangeAmount = 1000n;
+
+  for (const utxo of utxos) {
+    if (total - fee - minChangeAmount > amount) break;
+    total += utxo.satoshis;
+    targetUtxos.push(utxo);
+  }
+
+  const changeAmount = total - amount - fee;
+
+  if (changeAmount < minChangeAmount) {
+    throw new Error('Not enough funds to cover transaction');
+  }
+
+  return {
+    utxos: targetUtxos,
+    total,
+    changeAmount,
+  };
+}
+
+export const itOrSkip = (condition: boolean, message: string, fn: () => Promise<void>): void => (
+  condition ? it(message, fn) : it.skip(message, fn)
+);
+
+export const describeOrSkip = (condition: boolean, message: string, fn: () => void): void => (
+  condition ? describe(message, fn) : describe.skip(message, fn)
+);
diff --git a/yarn.lock b/yarn.lock
index 15fa8ffb..9a1a8d22 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2667,6 +2667,13 @@
   dependencies:
     "@babel/types" "^7.3.0"
 
+"@types/change-case@^2.3.5":
+  version "2.3.5"
+  resolved "https://registry.yarnpkg.com/@types/change-case/-/change-case-2.3.5.tgz#7c86cefd5897738980fc3bcbe466b03b38026dbd"
+  integrity sha512-JvctDvBuY3MVSEisGbSgaAdJTcs+2JjBKO60W1Isr3GnX2YZCyJYLDY96bV4eWensEUrQLRGEL+egAkIXYrW1Q==
+  dependencies:
+    change-case "*"
+
 "@types/color-name@^1.1.1":
   version "1.1.4"
   resolved "https://registry.yarnpkg.com/@types/color-name/-/color-name-1.1.4.tgz#e002611ff627347818d440a05e81650e9a4053b8"
@@ -3850,6 +3857,11 @@ chalk@^5.2.0, chalk@^5.4.1:
   resolved "https://registry.yarnpkg.com/chalk/-/chalk-5.4.1.tgz#1b48bf0963ec158dce2aacf69c093ae2dd2092d8"
   integrity sha512-zgVZuo2WcZgfUEmsn6eO3kINexW8RAE4maiQ8QNs8CtpPCSyMiYsULR3HQYkm3w8FIA3SberyMJMSldGsW+U3w==
 
+change-case@*, change-case@^5.4.4:
+  version "5.4.4"
+  resolved "https://registry.yarnpkg.com/change-case/-/change-case-5.4.4.tgz#0d52b507d8fb8f204343432381d1a6d7bff97a02"
+  integrity sha512-HRQyTk2/YPEkt9TnUPbOpr64Uw3KOicFWPVBb+xiHvd6eBx/qPr9xqfBFDT8P2vWsvvz4jbEkfDe71W3VyNu2w==
+
 char-regex@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/char-regex/-/char-regex-1.0.2.tgz#d744358226217f981ed58f479b1d6bcc29545dcf"

From 19d1c60c6a48475b4c7fa8da3bb8ebb52a680664 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Thu, 27 Feb 2025 10:51:23 +0100
Subject: [PATCH 178/267] General docs update + deprecate simple txbuilder in
 docs (#261)

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
---
 .cspell.json                                  |   1 +
 README.md                                     |  25 ++--
 website/docs/basics/about-bch.md              |  25 +++-
 website/docs/basics/about.md                  |   8 +-
 website/docs/basics/getting-started.md        |  48 +++++---
 website/docs/compiler/compiler.md             |   8 +-
 website/docs/compiler/vm-limits.md            |   4 +
 website/docs/guides/covenants.md              |  23 ++--
 website/docs/guides/debugging.md              |  55 +++------
 website/docs/guides/optimization.md           | 116 ++++++++++++++----
 website/docs/guides/walletconnect.md          |   5 +-
 website/docs/language/globals.md              |  18 +--
 website/docs/language/types.md                |   5 +
 website/docs/releases/migration-notes.md      |  69 ++++++++++-
 website/docs/releases/release-notes.md        |   9 +-
 website/docs/sdk/examples.md                  |  24 +++-
 website/docs/sdk/instantiation.md             |  38 ++----
 website/docs/sdk/network-provider.md          |   4 +-
 website/docs/sdk/signature-templates.md       |  45 ++++++-
 website/docs/sdk/testing-setup.md             |  47 ++++---
 ...ons-advanced.md => transaction-builder.md} |  38 ++++--
 website/docs/sdk/transactions.md              |   9 +-
 website/docs/showcase.md                      |  10 ++
 website/docusaurus.config.js                  |   1 +
 website/sidebars.js                           |   3 +-
 website/src/css/custom.css                    |   8 +-
 website/src/pages/index.js                    |  10 +-
 website/static/img/zapit_logo.svg             |  10 ++
 28 files changed, 473 insertions(+), 193 deletions(-)
 rename website/docs/sdk/{transactions-advanced.md => transaction-builder.md} (74%)
 create mode 100644 website/static/img/zapit_logo.svg

diff --git a/.cspell.json b/.cspell.json
index 233e798a..a3359143 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -246,6 +246,7 @@
         "withopreturn",
         "withtime",
         "XBVJRKV",
+        "zapit",
         "zwets"
     ],
     "ignorePaths": [
diff --git a/README.md b/README.md
index 2cc8cb2e..a1aa4e24 100644
--- a/README.md
+++ b/README.md
@@ -64,24 +64,33 @@ Using the CashScript SDK, you can import contract artifact files, create new ins
   import P2PKH from './p2pkh-artifact.json' with { type: 'json' };
 
   // Instantiate a network provider for CashScript's network operations
-  const provider = new ElectrumNetworkProvider('mainnet');
+  const provider = new ElectrumNetworkProvider('chipnet');
 
   // Create a new P2PKH contract with constructor arguments: { pkh: pkh }
-  const contract = new Contract(P2PKH, [pkh], provider);
+  const contract = new Contract(P2PKH, [pkh], {provider});
 
-  // Get contract balance & output address + balance
+  // Fetch contract utxos
+  const contractUtxos = await contract.getUtxos();
+
+  // Log contract output address + contract utxos
   console.log('contract address:', contract.address);
-  console.log('contract balance:', await contract.getBalance());
+  console.log('contract utxos', contractUtxos);
+
+  // Specify the contract UTXO
+  const selectedContractUtxo = contractUtxos[0]
 
+  // Start building the transaction
   // Call the spend function with the owner's signature
   // And use it to send 0. 000 100 00 BCH back to the contract's address
-  const txDetails = await contract.functions
-    .spend(pk, new SignatureTemplate(keypair))
-    .to(contract.address, 10000)
+  const txDetails = await new TransactionBuilder({ provider })
+    .addInput(selectedContractUtxo, contract.unlock.spend(new SignatureTemplate(keypair)))
+    .addOutput({
+      to: contract.address,
+      amount: 10000n
+    })
     .send();
 
   console.log(txDetails);
-...
 ```
 
 ## Examples
diff --git a/website/docs/basics/about-bch.md b/website/docs/basics/about-bch.md
index 6a60ba5c..b490c558 100644
--- a/website/docs/basics/about-bch.md
+++ b/website/docs/basics/about-bch.md
@@ -14,21 +14,34 @@ To learn more about the Bitcoin Basics refer to the book ['Mastering Bitcoin'](h
 ## UTXO model
 Bitcoin Cash transactions work with in- and outputs. All current balances are so called *Unspent Transaction Outputs (UTXOs)*, which simply means they can be used as inputs for future spending transactions.
 
-When UTXOs are used as inputs to a Bitcoin Cash transaction, they produce new UTXOs as outputs. UTXOs need to be spent in their entirety within a transaction. So whenever the user wishes to use a 10 BCH UTXO to send someone 1 BCH, they need to send 9 BCH back to themselves. Realistically, part of the funds would be reserved for transaction fees as well.
+When UTXOs are used as inputs to a Bitcoin Cash transaction, they produce new UTXOs as outputs. UTXOs are fully 'consumed' or 'destroyed' when used in a transaction. So whenever the user wishes to use a 10 BCH UTXO to send someone 1 BCH, they need to add an output to send 9 BCH back to themselves. Realistically, part of the funds would be reserved for transaction fees as well.
 
-The most used locking/unlocking script pattern is called *Pay-to-Public-Key-Hash (P2PKH)*, where the locking script contains the hash of a public key and expects the unlocking script to contain a public key and transaction signature. The locking script then checks that the provided public key matches the stored hash, and that the transaction signature is valid. This pattern is used in regular Bitcoin Cash wallets. And the user's balance is simply the sum of all UTXOs that can be spent by the user's public keys.
+UTXOs are locked using a locking script that specifies the conditions to spend the UTXO. When attempting to spend a UTXO, an unlocking script is provided. These scripts are then executed together and the transaction is only valid if the scripts execute without errors and the evaluation result is `TRUE`.
+
+## P2PKH transactions
+
+The most used locking/unlocking script pattern is called *Pay-to-Public-Key-Hash (P2PKH)*, where the locking script contains the hash of a public key and expects the unlocking script to contain a public key and transaction signature. The locking script then checks that the provided public key matches the stored hash, and that the transaction signature is valid. 
+
+The P2PKH pattern is used in regular Bitcoin Cash wallets. These wallets only know how to spend from inputs with this pattern, where the public-key-hash in question is the owners' public key. The user's wallet balance then is simply the sum of all UTXOs that can be spent by the user's public keys.
 
 ## Smart Contracts on BCH
+
+Smart contracts on Bitcoin Cash also use this same locking/unlocking model. The most used locking/unlocking for smart contracts is called *Pay-to-Script-Hash (P2SH)* with two variants depending on the length of the script-hash: *P2SH20* and *P2SH32*. The 'script' contains the arbitrary code logic written by smart contract authors!
+
 Bitcoin Cash has had many script upgrades, including transaction introspection and CashTokens. Because of these upgrades, DeFi is very much possible on Bitcoin Cash. However, compared to EVM, smart contracts work very differently due to BCH's UTXO architecture.
 
 Smart contracts on Bitcoin Cash only have access to the current transaction context, which enables 'local state'. This model allows transactions to be verified independently and efficiently. Because there is no global state that can impact the execution of these smart contracts, the results are deterministic and predictable.
 
-### Bitcoin Cash Script
-UTXOs are locked using a locking script (or `scriptPubKey`) that specifies the conditions to spend the UTXO. When attempting to spend a UTXO, an unlocking script (or `scriptSig`) is provided. These scripts are then executed together and the transaction is only valid if the scripts execute without errors and the resulting value is `TRUE`.
+:::tip
+The UTXO model where transactions only have access to the local transaction context enables parallel transaction validation and is the reason why Bitcoin Cash is hugely scalable!
+:::
 
-The locking and unlocking scripts of regular transactions and smart contracts on Bitcoin Cash are written using Bitcoin Cash' transaction scripting language, creatively named Script. To avoid ambiguity, it can also be referred to as Bitcoin Cash Script or BCH Script. Script is a stack based assembly-like language, because it is a low-level language and requires stack management it is hard to write complex smart contract in Script directly.
+### Bitcoin Cash Script
 
+The locking and unlocking scripts of regular transactions and smart contracts on Bitcoin Cash are written using Bitcoin Cash' transaction scripting language, referred to as BCH Script (or Bitcoin Cash Script in full). BCH Script is a stack based assembly-like language, because it is a low-level language and requires stack management it is hard to write complex smart contract in Script directly.
 
 ### CashScript
 
-CashScript is a high-level programming language for smart contracts on Bitcoin Cash that offers a strong abstraction for a smoother development experience. The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum.
+CashScript is a high-level programming language for smart contracts on Bitcoin Cash that offers a strong abstraction for a smoother development experience. CashScript fully abstracts the management of items on the 'stack' from developers, allowing them to focus on their application logic instead of low-level details.
+
+The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum.
diff --git a/website/docs/basics/about.md b/website/docs/basics/about.md
index 1f7aadf9..f91de61b 100644
--- a/website/docs/basics/about.md
+++ b/website/docs/basics/about.md
@@ -3,11 +3,13 @@ title: What is CashScript?
 sidebar_label: About CashScript
 ---
 
-CashScript is a high-level programming language for smart contracts on Bitcoin Cash. It offers a strong abstraction layer over Bitcoin Cash' native virtual machine, BCH Script. The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum.
+CashScript is a high-level programming language for smart contracts on Bitcoin Cash. It offers a strong abstraction layer over Bitcoin Cash' native virtual machine, BCH Script. CashScript was created in 2019 and has seen major upgrades over the years, thereby supporting new script functionalities enabled with the different Bitcoin Cash network upgrades — including native introspection and CashTokens.
 
-CashScript was created in 2019 and has seen major upgrades over the years, thereby supporting new script functionalities enabled with the different Bitcoin Cash network upgrades — including native introspection and CashTokens. Unrelated to the network upgrades, CashScript has also been upgraded with an advanced transaction builder and integrated debug tooling.
+The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum. You can read more on these differences on the ['About Bitcoin Cash' page](./about-bch.md).
 
-CashScript aims to make programming Bitcoin Cash accessible to a wide range of developers and enable the next-generation of UTXO smart contract applications.
+CashScript comes with a powerful TypeScript SDK for creating, debugging and testing smart contract transactions on BCH. The SDK has an integrated networkProvider API to fetch data from the BCH blockchain. With all this functionality, the Typescript SDK makes it easy to use CashScript contracts in applications in the browser or on the server in a type-safe way.
+
+CashScript aims to make building smart contract apps on Bitcoin Cash accessible to a wide range of developers and to power the next-generation of UTXO smart contract applications.
 
 :::tip
 To see what kind of things can be built with CashScript, you can look at the [Showcase](/docs/showcase) or [Examples](/docs/language/examples). 
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 7c14079d..94dce696 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -29,7 +29,7 @@ To write CashScript smart contracts locally you use a code editor. For the best
 
 :::note prerequisites
 - Basic familiarity with the command line
-- Node.js installed
+- Node.js installed (v20 or newer)
 - A code editor (VS Code recommended)
 :::
 
@@ -88,7 +88,7 @@ OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_ROLL OP_ROT OP_CHECKSIG OP_NIP OP_NI
 
 ## Creating a CashScript Transaction
 
-After creating a contract artifact, we can now use the TypeScript SDK to initialise the smart contract and to invoke spending functions on the smart contract UTXOs. We'll continue with the `TransferWithTimeout` artifact generated earlier.
+After creating a contract artifact, we can now use the TypeScript SDK to initialise the smart contract and to create a transaction spending from the smart contract UTXO. We'll continue with the `TransferWithTimeout` artifact generated earlier.
 
 :::info
 The CashScript SDK is written in TypeScript meaning that you can either use TypeScript or vanilla JavaScript to use the SDK.
@@ -106,6 +106,11 @@ npm install cashscript
 
 Now to initialise a contract we will import the `ElectrumNetworkProvider` and `Contract` classes from the CashScript SDK. We also need to import the contract artifact. Lastly, we need public keys from a generated key-pair to use as arguments for contract initialisation.
 
+:::tip
+For a code example of how to generate key-pairs with Libauth, see the [CashScript Examples' `common.ts`](https://github.com/CashScript/cashscript/blob/master/examples/common.ts) file where Alice and Bob's key-pairs are created.
+:::
+
+
 ```javascript
 import { ElectrumNetworkProvider, Contract } from 'cashscript';
 import artifact from './TransferWithTimeout.json' with { type: 'json' };
@@ -116,8 +121,7 @@ const provider = new ElectrumNetworkProvider('chipnet');
 
 // Instantiate a new TransferWithTimeout contract
 const contractArguments = [alicePub, bobPub, 100000n];
-const options = { provider };
-const contract = new Contract(artifact, contractArguments, options);
+const contract = new Contract(artifact, contractArguments, {provider});
 
 // Get the contract address and info about its balance
 console.log("Contract address: " + contract.address);
@@ -125,32 +129,40 @@ console.log("Contract balance: " + await contract.getBalance());
 console.log("Contract UTXOs: " + await contract.getUtxos());
 ```
 
-:::tip
-For a code example of how to generate key-pairs with Libauth, see the [CashScript Examples' `common.ts`](https://github.com/CashScript/cashscript/blob/master/examples/common.ts) file where Alice and Bob's key-pairs are created.
-:::
+Next, to spend from the smart contract we've initialised, you need to make sure there is an actual contract balance on the smart contract address. Later you'll learn to use the `MockNetworkProvider` so you can simulate transactions in a 'mock' network environment.
 
 ### Creating a Transaction
 
-Lastly, to spend from the smart contract we've initialised, you need to make sure there is an actual contract balance on the smart contract address. In other words, we need to make sure there's at least one UTXO with the smart contract locking bytecode, so that we can spend from it!
+Finally to create a transaction spending from the smart contract UTXO we use the `TransactionBuilder` to add in- and outputs to the transaction. The difference between the total BCH amount in the in- and outputs is the transaction fee.
+
+To spend from an input you specify the `UTXO` together with an `Unlocker` to actually provide the 'unlock' script matching the input's locking bytecode. For the initialized smart contract the `Unlockers` are available as methods on the `Contract` instance. Below we will invoke the `transfer` function on the contract utxo through `contract.unlock.transfer(...)`.
 
 ```javascript
-import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
+import { ElectrumNetworkProvider, Contract, SignatureTemplate, TransactionBuilder } from 'cashscript';
 import { alicePub, bobPriv, bobPub } from './keys.js';
-import artifact from './TransferWithTimeout.json';
+import artifact from './TransferWithTimeout.json' with { type: 'json' };
 
 // Initialise a network provider for network operations
 const provider = new ElectrumNetworkProvider('chipnet');
 
 // Instantiate a new TransferWithTimeout contract
 const contractArguments = [alicePub, bobPub, 100000n];
-const options = { provider };
-const contract = new Contract(artifact, contractArguments, options);
-
-// Call the transfer function with Bob's signature
-// i.e. Bob claims the money that Alice has sent him
-const transferDetails = await contract.functions
-  .transfer(new SignatureTemplate(bobPriv))
-  .to('bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx', 10000n)
+const contract = new Contract(artifact, contractArguments, {provider});
+
+// Specify the contract UTXO
+const contractUtxos = await contract.getUtxos();
+const selectedContractUtxo = contractUtxos[0]
+
+// Create the signatureTemplate for bob to sign the contract input
+const bobSignatureTemplate = new SignatureTemplate(bobPriv)
+
+// Start building the transaction
+const transferDetails = await new TransactionBuilder({ provider })
+  .addInput(selectedContractUtxo, contract.unlock.transfer(bobSignatureTemplate))
+  .addOutput({
+    to: 'bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx',
+    amount: 10000n
+  })
   .send();
 
 console.log(transferDetails);
diff --git a/website/docs/compiler/compiler.md b/website/docs/compiler/compiler.md
index 510ea0ba..ee3baac8 100644
--- a/website/docs/compiler/compiler.md
+++ b/website/docs/compiler/compiler.md
@@ -49,7 +49,11 @@ npm install cashc
 compileFile(sourceFile: PathLike): Artifact
 ```
 
-Compiles a CashScript contract from a source file. This is the recommended compile method if you're using Node.js and you have a source file available.
+Compiles a CashScript contract from a source file. This compile method is handy when using Node.js with the contract source file available but you are doing quick compilations (for example for contract size comparisons) and you don't need the contract artifact file to be generated.
+
+:::note
+`compileFile()` only works from a Node.js context because it uses the file-system so it's not available in browser setting.
+:::
 
 #### Example
 ```ts
@@ -61,7 +65,7 @@ const P2PKH = compileFile(new URL('p2pkh.cash', import.meta.url));
 compileString(sourceCode: string): Artifact
 ```
 
-Compiles a CashScript contract from a source code string. This is the recommended compile method if you're building a webapp, because `compileFile()` only works from a Node.js context. This is also the recommended method if no source file is locally available (e.g. the source code is retrieved with a REST API).
+Compiles a CashScript contract from a source code string. This compile method is handy in a browser compilation setting like the [CashScript Playground](https://playground.cashscript.org/) where testing contracts can be quickly compiled and discarded. The method is also useful if no source file is locally available (e.g. the source code is retrieved with a REST API).
 
 ```ts
 const baseUrl = 'https://raw.githubusercontent.com/CashScript/cashscript'
diff --git a/website/docs/compiler/vm-limits.md b/website/docs/compiler/vm-limits.md
index a25c8cde..39a5e981 100644
--- a/website/docs/compiler/vm-limits.md
+++ b/website/docs/compiler/vm-limits.md
@@ -29,6 +29,10 @@ With this formula, increasing your input length allows for a larger compute budg
 
 To increase your contract's compute budget for resource-intensive operations (e.g., cryptographic hashing or large number calculations), you can use zero-padding to extend the input length. By adding non-essential, zero-value bytes, you effectively buy more computation power for your contract without adding functional complexity. This technique could be useful for contracts requiring a higher operation budget, allowing them to meet the contract's computational demands without exceeding the op-cost limit.
 
+## NFT Commitment Length Limit
+
+Currently NFT commitments can keep no more than 40 bytes of data as local state. To work around this limit it is possible to hash state longer than 40 bytes so it fits within the length limit. Then in a later transaction the full state has to be provided and has to match the state-hash.  
+
 ## Other Limits
 
 For completeness, here are additional Bitcoin Cash VM limits relevant to CashScript development:
diff --git a/website/docs/guides/covenants.md b/website/docs/guides/covenants.md
index 9f8b3c86..ef0dd547 100644
--- a/website/docs/guides/covenants.md
+++ b/website/docs/guides/covenants.md
@@ -35,7 +35,7 @@ When using CashScript, you can access a lot of *introspection data* that can be
 While we know the individual data fields, it's not immediately clear how this can be used to create useful smart contracts on Bitcoin Cash. However, there are several constraints that can be created using these fields — most important of which are constraints on the recipients of funds — so that is what we discuss.
 
 ### Restricting P2PKH recipients
-One interesting technique in Bitcoin Cash is called blind escrow, meaning that funds are placed in an escrow contract. This contract can only release the funds to one of the escrow participants, and has no other control over the funds. Non-custodial local exchange [LocalCryptos](https://localcryptos.com) used `OP_CHECKDATASIG` to do this. We can achieve something similar by restricting recipients with a covenant.
+One interesting technique in Bitcoin Cash is called blind escrow, meaning that funds are placed in an escrow contract. This contract can only release the funds to one of the escrow participants, and has no other control over the funds. We can implement this blind escrow as a covenants by restricting the possible recipients (although there are other possible designs for escrows).
 
 ```solidity
 contract Escrow(bytes20 arbiter, bytes20 buyer, bytes20 seller) {
@@ -150,6 +150,9 @@ To demonstrate the concept of 'local state' we consider the Mecenas contract aga
 Besides these wasted days it can also be inconvenient to claim at set intervals, rather than the "streaming" model that the Ethereum project [Sablier](https://www.sablier.finance/) employs. Instead of set intervals, you should be able to claim funds at any time during the "money stream". Using local state, we can approach a similar system with BCH.
 
 ```solidity
+// Mutable NFT Commitment contract state
+// bytes8 latestLockTime
+
 contract StreamingMecenas(
     bytes20 recipient,
     bytes20 funder,
@@ -223,6 +226,10 @@ Let's take a look at an example contract called `PooledFunds` which has two cont
 
 
 ```solidity
+// Immutable NFT Commitment User-Receipt
+// bytes1 actionIdentifier
+// bytes8 amountSatsAdded | amountTokensAdded
+
 contract PooledFunds(
 ) {
     function addFunds(
@@ -236,18 +243,20 @@ contract PooledFunds(
         int amountSatsAdded = tx.outputs[0].value - tx.inputs[0].value;
         int amountTokensAdded = tx.outputs[0].tokenAmount - tx.inputs[0].tokenAmount;
 
+        // Require either BCH or fungible tokens to contributed, not both at once
+        require(amountSatsAdded == 0 || amountTokensAdded == 0);
+
         // Determine whether BCH or fungible tokens were contributed to the pool
-        bytes actionIdentifier = 0x00;
+        bytes receiptCommitment = 0x;
         if (amountTokensAdded > 0) {
             // Require 1000 sats to pay for future withdrawal fee
             require(amountSatsAdded == 1000);
-            actionIdentifier = 0x01;
-            actionIdentifier = actionIdentifier + bytes8(amountTokensAdded);
+            receiptCommitment = 0x01 + bytes8(amountTokensAdded);
         } else {
             // Place a minimum on the amount of funds that can be added
             // Implicitly requires tx.outputs[0].value > tx.inputs[0].value
             require(amountSatsAdded > 10000);
-            actionIdentifier = actionIdentifier + bytes8(amountSatsAdded);
+            receiptCommitment = 0x00 + bytes8(amountSatsAdded);
         }
 
         // Require there to be at most three outputs so no additional NFTs can be minted
@@ -261,7 +270,7 @@ contract PooledFunds(
         // The receipt NFT is sent back to the same address of the first user's input
         // The NFT commitment of the receipt contains what was added to the pool
         require(tx.outputs[1].lockingBytecode == tx.inputs[1].lockingBytecode);
-        require(tx.outputs[1].nftCommitment == actionIdentifier);
+        require(tx.outputs[1].nftCommitment == receiptCommitment);
 
         // A 3rd output for change is allowed
         if (tx.outputs.length == 3) {
@@ -283,7 +292,7 @@ contract PooledFunds(
 
         // Read the amount that was contributed to the pool from the NFT commitment
         bytes ntfCommitmentData = tx.inputs[1].nftCommitment;
-        bytes actionIdentifier, bytes amountToWithdrawBytes = ntfCommitmentData.split(2);
+        bytes actionIdentifier, bytes amountToWithdrawBytes = ntfCommitmentData.split(1);
         int amountToWithdraw = int(amountToWithdrawBytes);
 
         if (actionIdentifier == 0x01) {
diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 42f65c94..1146d325 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -2,22 +2,25 @@
 title: Debugging
 ---
 
-Debugging is no walk in the park. This is especially true for debugging complex smart contracts. Luckily there is a handful of strategies that can make it easier for developers to discover bugs in their contracts.
+Debugging is no walk in the park. This is especially true for debugging complex smart contracts. Luckily there are strategies that can make it easier for developers to discover bugs in their contracts.
 
-Generally there are 2 broad categories of smart contract bugs:
+## Categories of Bugs
 
-- A bug in your invocation making the transaction invalid
-- A bug in the smart contract which prohibits valid spending
+There are 2 broad categories of smart contract bugs:
 
-Whatever category your bug falls into, the first step is discovering what line in your CashScript contract is making your transaction get rejected. Afterwards, investigation needs to start whether it's a contract bug, or an invocation bug.
+### 1. Bug in Transaction Building
 
-## Simple Transaction Builder
+The first category of bugs is a bug in the transaction building meaning the 'invocation' of your smart contracts fails. This means the bug is in the usage of the CashScript Transaction builder and you need to carefully review the shape of your transaction and whether it matches the requirements imposed by the smart contract UTXOs.
 
-The [Simple Transaction Builder](/docs/sdk/transactions) has deep integration with libauth to enable local transaction evaluation, without actual interaction with the Bitcoin Cash network. This allows for advanced debugging functionality.
+### 2. Bug in Contract Logic
 
-:::note
-Currently the CashScript debugging tools only work with the [Simple Transaction Builder](/docs/sdk/transactions). We plan to extend the debugging tools to work with the [Advanced Transaction Builder](/docs/sdk/transactions-advanced) in the future.
-:::
+The second category of bugs is a bug in the smart contract logic which prohibits valid spending, this results in the shape of the Transaction builder not matching with the contracts simply because there is a coding error in the contract! Carefully review the logic in the failing line and if needed check the documentation so you are sure about the functionality of your CashScript contract code.
+
+Whatever category your bug falls into, the first step of debugging is understanding what line in your CashScript contract is making your transaction get rejected. Afterwards, investigation needs to start whether it's a transaction building bug or a bug in contract logic.
+
+## Debugging Tools
+
+The [Transaction Builder](/docs/sdk/transaction-builder) has deep integration with libauth to enable local transaction evaluation, without actual interaction with the Bitcoin Cash network. This allows for fully integrated debugging functionality.
 
 ### Error messages
 
@@ -42,14 +45,17 @@ Whenever a transaction fails, there will be a link in the console to open your s
 It's also possible to export the transaction for step-by-step debugging in the BitAuth IDE without failure. To do so, you can call the `bitauthUri()` function on the transaction. This will return a URI that can be opened in the BitAuth IDE.
 
 ```ts
-const transaction = contract.functions.exampleFunction(0n).to(contract.address, 10000n);
-const uri = await transaction.bitauthUri();
+const uri = await transactionBuilder.bitauthUri();
 ```
 
 :::caution
 It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
 :::
 
+:::note
+Currently the raw BCH Script you see in the Bitauth IDE is what the script looks like **before** any optimizations happen for the compiled output. This means you might spot some inefficiencies but those will likely not be present in the final compiled bytecode.
+:::
+
 The Bitauth IDE will show you the two-way mapping between the CashScript contract code generated opcodes. Here is [a Bitauth IDE link][BitauthIDE] for the basic `TransferWithTimeout` contract as an example:
 
 ```js
@@ -76,29 +82,4 @@ OP_ENDIF                                        /* }
                                                 /*
 ```
 
-## Advanced Transaction Builder
-
-Because the advanced transaction builder does not yet support the advanced debugging tooling, you are left with just a few strategies.
-
-### Failing Opcode
-
-When a transaction gets rejected by a full node, it will return a cryptic error message. An example error looks like this:
-
-```bash
-mandatory-script-verify-flag-failed (Script failed an OP_VERIFY operation) (code 16)
-```
-
-Read the message carefully to investigate whether the issue is a failing script (failing OpCode) or whether a standardness rule like minimum-relay-fee is violated.
-If the cause is a failing OpCode, you can check the contract's Artifact to see how many appearances this OpCode has. Sometimes the OpCode only appears once or twice, indicating where the failing `require` statement is. Other times you might see 15 appearances of the OpCode leaving you to try the next strategies.
-
-### Removing Contract Checks
-
-If your contract fails, you can remove (or comment out) the lines that are the likely cause of the error. After recompiling to a new Artifact you can test whether the remaining subcontract works or fails with a different error. If this is the case, then you learned that there is an issue in the removed CashScript code block. In the worst case, when you have no indication from the failing opcode (previous strategy), then you will have to try to remove different parts of your contract and try different sub-contracts repeatedly.
-
-To use this strategy effectively, the contract setup with funding should be automated as to avoid having to send testnet coins manually to each different subcontract. However inefficient, this strategy should always be able to get you to find the failing line in your CashScript contract. Then you can investigate whether the issue is the contract invocation or the `require` statement in the CashScript file.
-
-### Single Check Contract
-
-If it is unclear whether the issue is the contract invocation or the `require` statement in the CashScript file, it might prove handy to create a 'single-check' contract, which has only the previously failing `require` statement. The goal then is to discover if your transaction is the issue, and you are violating a correct contract requirement, or whether the contract is enforcing an incorrect/impossible condition to hold in the spending transaction.
-
 [BitauthIDE]: https://ide.bitauth.com/import-template/eJzVWG1v2zYQ_isCMWBJ4drUG21lbYAmcRsjaZIl6YqhDgyKomItNuVRVJbA8H_fUe9-qeF06Yfxg0WRvLvnjs9RR8_RLwkb8ylFB2is1Cw56HSigLf9SNFUjdssnnZ0hwsVMaqiWLxVfDqbUMXfPuJ2Ltv-K4kFaqGAJ0xGM70K1A2ms1gqHhihjKcGo8k4n4WFgk45rLiVVCQhl18jNb6NpjxO9WSSznJBdPANHR2fjixs2SPsorsWeuQyybTjFtKQVMQTdDBHMypBpYJZ_baM4zgWSlKmDCZ55oFBBYBKBcteGqIVsKWxXFei0Uxi9gAjqdCdUfamQVEZUX-SI5GcRbMIsI2S6H4dzLBecBPdD1Ft3ojDGtQQqSI2Q1TDaorCqHqe6dEz_owWAJOLgMtNFvOZVVtqHCUGK2JT2yjUVNq_0smEqxOqqDZSIdjq2Y6mamXfsaYKTmywVUztaElV5Npopwz7KALfn9bN3WT9eneyZYaKDf7EWap4bWhF00Z70Bqkmi-xKaNykvCMbfyRTlJItFGpVZOtMJQLVeyEkU5niTWbCD4U75boqdNXxFLqvqAqlbwNOEcQqVmqkkMDVMLMUAwF9Fa8j0QVZ1C77HcmGQllvDfe4cOhqFIG3MpzCCJQ-qufkbi_zQM1s5KxbdUB3ejlhnMDHGZVnsciUTJlKpbLzhc0WIL3hLuHzbhkk7PUf-DPxbxFrNBlZo8GoR14PYyh77uc2CElLnY563HfDByPEbfnugGxKKfE6zmWS23PI4Rr_Xla_Rzl2fb4z4qzOOBDYbywdd4YM0nvp7RxRhuH7w3c7rXxby_VZhhvOj-E4VXbD2KoKLSBYXvFvuU72Sq3sSJOK6NUQbF9Y_5f4gD7ec3_TiPJa_2_JkaVpvrsmVLFxrvE4fJqZBvwczU4PtNPrH8uvnzu__7lw7nuDz5uwlDle3mm7IF5o_kJ0k7u0AoMjjZ1fXmembSaL8en_eOzm8GndQy6yTwQe1BpsAewuteE0KoB7e9v4WqB4WJwZaw9-uc3_U0yBYbFLj7u0v7HeZE9ak4WJM-emoq-pimFDQqy0irPkO_ytcnJkgLmKif_6F8PPv65iqHmZJGTmpK5ud35uBXDGidrLNs4WWFoFXC2snEJw7rZ88vjs9vB535hF4ZPri-vmnFoYlBP7Wwf4MQuD5_dD-0mBp0Ou7SfkRc6DS9OVg6i7RhezX6J4aUyr5-bKK8MuYALRZzVhuslIAwWpVG_mFu7eH0QUJhSuKRxo5DXKfPPmOtE1AVy8Y3Pq9e8RNQ1Z1tr0iUq2CjLCd0vbxboNeoVtHSJeC2V1U1BK-yi9ZIeYV1zslRKsHukq8pTHt2PQcJaHtZfe3Rgds1e1_QcDLPwlc_vmDJ6hHCfFa8rFz3EnYAwSrnjmbbj-TYLzSBgVkg8jK0uDT3sU9-1AuZzjwQMRm2XEmb1HOLTrk1Qdi_IPra02upI6EocLgNzpKvyGEqMQe6Q2apGbmuZU6jgAItHHdMnNMDEcmyn1w2xF1oEguoHDrFcn1gcez4Ofdt1Qs58gu3ANonjEerYZtDTFTccL1wwfpFOfb35juXBdBd-y2IeivajiiXfUDKJFbpb3OWVvcrCaGGX2FaOtPRjTXS-0FfoScpvqIoT4Cc4hzFetHZb27U9Z9H8a8DSSRSnkvHLbWZLxGsKe8TrLu5gN_4FON-z9w==
diff --git a/website/docs/guides/optimization.md b/website/docs/guides/optimization.md
index 9186fab6..bfa81976 100644
--- a/website/docs/guides/optimization.md
+++ b/website/docs/guides/optimization.md
@@ -3,41 +3,46 @@ title: Optimizing Contracts
 sidebar_label: Optimization
 ---
 
-CashScript contracts are transpiled from a solidity syntax to [BCH Script](https://reference.cash/protocol/blockchain/script) by the `cashc` compiler. BCH Script is a lower level language (a list of stack-based operations) where each available operation is mapped to a single byte.
+CashScript contracts are transpiled from the high-level CashScript code to [BCH Script](https://reference.cash/protocol/blockchain/script) by the `cashc` compiler. BCH Script is the low-level language used for the Bitcoin Cash Virtual Machine (BCH VM) to evaluate contracts.
 
-Depending on the complexity of the contract or system design, it may be useful to optimize the Bitcoin Script by tweaking the contract in CashScript before it is compiled because the minimum fees on the Bitcoin Cash network are based on the bytesize of a transaction (including your contract).
+Because transaction fees are based on the bytesize of a transaction, it may be useful to optimize the compiled size of your smart contract by tweaking your CashScript code.
 
 ## Example Workflow
 
-When optimizing your contract, you will need to compare the contract size to see if the changes have a positive impact.
-With the compiler CLI, you can easily check the opcode count and bytesize directly from the generated contract artifact.
+When optimizing your contract, you will need to continuously compare the contract size to see if the changes have a positive impact.
+With the compiler CLI, you can easily check the bytesize and opcode count directly from the generated contract artifact.
 
 ```bash
 cashc ./contract.cash --size --opcount
 ```
 
-The size outputs of the `cashc` compiler are based on the bytecode without constructor arguments. This means they will always be an underestimate, as the contract hasn't been initialized with contract arguments.
-
-:::note
-The compiler opcount and bytesize outputs are still helpful to compare the effect of changes to the smart contract code on the compiled output, given that the contract constructor arguments stay the same.
-:::
+The compiler calculates the size from the contract's bytecode without constructor arguments. For the `opcount` this is not a problem but the `bytesize` output will be an underestimate, as the contract hasn't been initialized with contract arguments.
+The compiler `bytesize` output is still helpful to compare the effect of changes, given that the contract constructor arguments stay the same.
 
 :::tip
 To get the exact contract bytesize including constructor parameters, initialise the contract with the TypScript SDK and check the value of `contract.bytesize`.
 :::
 
-## Optimization Tips & Tricks
+## Optimization Tips
 
-The `cashc` compiler does some optimisations automatically. By writing your CashScript code in a specific way, the compiler is better able to optimise it. Trial & error is definitely part of it, but here are some tricks that may help:
+The `cashc` compiler does some optimisations automatically. By writing your CashScript code in a specific way, the compiler is better able to optimise it.
 
-### 1. Consume stack items
+### 1. Declare variables
 
-It's best to "consume" values (i.e. their final use in the contract) as soon as possible. This frees up space on the stack.
-Use/consume values as close to their declaration as possible, both for variables and for parameters. This avoids having to do deep stack operations. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L61-72) from AnyHedge illustrates consuming values immediately.
+Declare variables instead of hardcoding the same values in multiple places:
+
+```solidity title="Example CashScript code"
+    // do this
+    bytes tokenId = 0x8473d94f604de351cdee3030f6c354d36b257861ad8e95bbc0a06fbab2a2f9cf;
+    require(tx.outputs[0].tokenCategory == tokenId);
+    require(tx.outputs[1].tokenCategory == tokenId);
 
-### 2. Declare variables
+    // not this
+    require(tx.outputs[0].tokenCategory == 0x8473d94f604de351cdee3030f6c354d36b257861ad8e95bbc0a06fbab2a2f9cf);
+    require(tx.inputs[1].tokenCategory == 0x8473d94f604de351cdee3030f6c354d36b257861ad8e95bbc0a06fbab2a2f9cf);
+```
 
-Declare variables when re-using certain common introspection items to avoid duplicate expressions.
+Also declare variables when re-using certain common introspection items to avoid duplicate expressions:
 
 ```solidity title="Example CashScript code"
     // do this
@@ -47,10 +52,14 @@ Declare variables when re-using certain common introspection items to avoid dupl
 
     // not this
     require(tx.inputs[1].tokenCategory == tx.inputs[0].tokenCategory.split(32)[0]);
-    ...
-    require(tx.inputs[1].tokenCategory == tx.inputs[0].tokenCategory.split(32)[0]);
+    require(tx.outputs[1].tokenCategory == tx.inputs[0].tokenCategory.split(32)[0]);
 ```
 
+### 2. Consume stack items
+
+It's best to "consume" values (i.e. their final use in the contract) as soon as possible. This frees up space on the stack.
+Use/consume values as close to their declaration as possible, both for variables and for parameters. This avoids having to do deep stack operations. This [example](https://gitlab.com/GeneralProtocols/anyhedge/contracts/-/blob/development/contracts/v0.11/contract.cash#L61-72) from AnyHedge illustrates consuming values immediately.
+
 ### 3. Parse efficiently
 When using `.split()` to use both sides of a `bytes` element, declare both parts immediately to save on opcodes parsing the byte array.
 
@@ -60,7 +69,6 @@ When using `.split()` to use both sides of a `bytes` element, declare both parts
 
     // not this
     bytes firstPart = tx.inputs[0].nftCommitment.split(10)[0];
-    ...
     bytes secondPart = tx.inputs[0].nftCommitment.split(10)[1];
 ```
 ### 4. Avoid if-else
@@ -80,11 +88,18 @@ Avoid if-statements when possible. Instead, try to "inline" them. This is becaus
     }
 ```
 
-## Modular Contract Design
+### 5. Trial & Error
+
+When the contract logic is finished, that is a great time to revisit the order of the contract's constructor argument, the different contract functions and even the contract parameters. Currently the compiler does not change/optimize the user-defined order, so in addition to the guidelines above, it can still be helpful to trial and error different ordering for the items.
 
-An alternative to optimizing your contract to shrink in size is to redesign your contract to use a composable architecture. The contract logic is separated out in to multiple components of which only some can be used in a transaction, and hence shrink your contract size.
+## Avoid Many Functions
 
-### NFT contract functions
+When a contract has many different functions or has a lot duplicate code shared across two functions, this can be a natural indication that contract optimization is possible. There's a different optimization strategy for each:
+
+### Modular Contract Design
+
+Modular contract design avoids the added size of having many functions, instead the contract logic is separated out in to different components which we will call 'function contracts'.
+By only adding the function contract you are actually using in the transaction, and not all the other unused functions, you can drastically shrink the size of your contracts used in a transaction.
 
 The concept of having NFT functions was first introduced by the [Jedex demo](https://github.com/bitjson/jedex#demonstrated-concepts) and was first implemented in a CashScript contract by the [FexCash DEX](https://github.com/fex-cash/fex/blob/main/whitepaper/fex_whitepaper.md). The concept is that by authenticating NFTs, you can make each function a separate contract with the same tokenId. This way, you can offload logic from the main contract. One function NFT contract is attached to the main contract during spending, while the other contract functions exist as unused UTXOs, separate from the transaction.
 
@@ -92,25 +107,72 @@ The concept of having NFT functions was first introduced by the [Jedex demo](htt
 By using function NFTs you can use a modular contract design where the contract functions are offloaded to different UTXOs, each identifiable by the main contract by using the same tokenId.
 :::
 
+### Combining Functions
+
+If there is a lot of duplicate code across different functions in your contract, you could consider combining the functions into one, where the logic of the different functions are conditionally executed based on the function arguments, removing duplicate code.
+
+The difficulty with this approach is that CashScript functions expect a fixed number of arguments for each function. So when trying to combine two functions into one it might prove very difficult due to the different arguments they each expect. There is no notion of optional arguments or function overloading in CashScript currently.
+
+:::caution
+This optimization is considered advanced, as it steps away from the CashScript abstraction for contract structure and often requires workarounds.
+:::
+
+```solidity title="Example CashScript code"
+contract Example(){
+  function Main(){
+    // logic applying to all if/else branches
+    if(conditionFunction1){
+       // logic function1
+    } else if(conditionFunction2){
+       // logic function2
+    } else {
+      // logic applying to function 3 & 4
+      if(conditionFunction3){
+        // logic function3
+      } else {
+        // logic function4
+      }
+    }
+  }
+}
+```
+
+In Cashscript, when defining multiple functions, a `selectorIndex` parameter is added under-the-hood to select which of the contract's functions you want to use, this wraps your functions in big `if-else` cases. However when combining multiple functions in one cases you will have to think about the function conditions and `if-else` branching yourself.
+
 ## Hand-optimizing Bytecode
 
-It's worth considering whether hand-optimizing the contract is necessary at all. If the contract works and there is no glaring inefficiency in the bytecode, perhaps the best optimization is to not to obsess prematurely about things like transaction size.
+It's worth considering whether hand-optimizing the contract is necessary at all. If the contract works and there is no glaring inefficiency in the bytecode, perhaps the best optimization is to not to obsess prematurely about the transaction size with Bitcoin Cash's negligible fees.
 
 >We should forget about small efficiencies, say about 97% of the time: premature optimization is the root of all evil. Yet we should not pass up our opportunities in that critical 3%.
 
+### Optimizing with the BitauthIDE
+
+When optimizing the bytecode of your contract you'll likely want to use the [BitauthIDE](https://ide.bitauth.com) so you can see the stack changes of each OpCode. It's important to realize that `transactionBuilder.bitauthUri()` will show the two-wap mapping to the **un-optimized** bytecode, so this is not the final resulting bytecode produced by the compiler. The compiler will perform a bunch of optimizations already, so you should look at the `Artifact bytecode` if you want to further optimize the compiled contract bytecode.
+
 ### Overwriting the Artifact
 
-To manually change the contract bytecode, you need to overwrite the `bytecode` key of your contract artifact.
+To manually optimize a CashScript contract's bytecode, you need to overwrite the `bytecode` key of your contract artifact.
+
+If you manually overwrite the `bytecode` in the artifact, the auto generated 2-way-mapping generated by the compiler becomes obsolete. You are no longer compiling high-level CashScript code into BCH script, instead you are writing BCH script by hand.
+This causes the link of the BCH opcodes to your original CashScript code will be entirely lost for debugging.
+
+You can still use the CashScript TypeScript SDK while using a hand-optimized or hand-written contract.
+
 
 ```typescript
 interface Artifact {
   bytecode: string // Compiled Script without constructor parameters added (in ASM format)
+  // remove the 'debug' property as the info becomes obsoleted
 }
 ```
 
-This way you can still use the CashScript TypeScript SDK while using a hand-optimized contract.
 
 :::caution
-If you manually overwrite the `bytecode` in the artifact, this will make the auto generated 2-way-mapping to become obsolete.
-This result of this is that the debugging functionality will no longer work for the contract.
+If you use hand-optimized `bytecode` in your Contract's artifact, the `debug` info on your artifact will become obsolete and should be removed.
 :::
+
+:::tip
+You can create an `Artifact` for a fully hand-written contract so it becomes possible to use the contract with the nice features of the CashScript SDK! An example of this is [Cauldron_Swap_Test](https://github.com/mr-zwets/Cauldron_Swap_Test) which uses `Artifact bytecode` not produced by `cashc` at all but still uses the CashScript SDK.
+:::
+
+[BitauthIDE]: https://ide.bitauth.com
diff --git a/website/docs/guides/walletconnect.md b/website/docs/guides/walletconnect.md
index d6f2c15e..51c819f6 100644
--- a/website/docs/guides/walletconnect.md
+++ b/website/docs/guides/walletconnect.md
@@ -2,9 +2,10 @@
 title: WalletConnect
 ---
 
-The BCH WalletConnect specification was created in July of 2023 and has become popular since. The standard integrates nicely with CashScript contract development as it was designed with CashScript contract usage in mind.
+The BCH WalletConnect specification was created in July of 2023 and has become popular since, being supported in multiple wallets and a wide range of dapps. You can find a full list of Bitcoin Cash dapps supporting WalletConnect on [Tokenaut.cash](https://tokenaut.cash/dapps?filter=walletconnect).
+
+BCH WalletConnect uses the generic 'WalletConnect' transport layer to communicate between the wallet and the dapp. The contents being communicated is what is BCH-specific. The BCH WalletConnect standard was designed with CashScript contract usage in mind.
 
-You can find a full list of Bitcoin Cash dapps supporting WalletConnect on [Tokenaut.cash](https://tokenaut.cash/dapps?filter=walletconnect).
 
 :::tip
 The specification is called ['wc2-bch-bcr'](https://github.com/mainnet-pat/wc2-bch-bcr) and has extra discussion and info on the [BCH research forum](https://bitcoincashresearch.org/t/wallet-connect-v2-support-for-bitcoincash/).
diff --git a/website/docs/language/globals.md b/website/docs/language/globals.md
index a5473ccf..764a569d 100644
--- a/website/docs/language/globals.md
+++ b/website/docs/language/globals.md
@@ -33,7 +33,7 @@ require(tx.age >= <expression>);
 ```
 
 :::note
-To access the value of the `nSequence` field for assignment, use the `tx.inputs[i].sequenceNumber` introspection variable.
+To access the value of the `nSequence` field for variable assignment, use the [`sequenceNumber` introspection variable](#txinputsisequencenumber).
 :::
 
 Because of the way time locks work, **a corresponding time lock needs to be added to the transaction**. This can be done in the CashScript SDK using the [`withAge()`][withAge()] function. However, the value passed into this function will always be treated as a number of blocks, so **it is currently not supported to use `tx.age` as a number of second chunks**.
@@ -124,7 +124,7 @@ Represents the outpoint index where a specific input was initially locked.
 int tx.inputs[i].sequenceNumber
 ```
 
-Represents the `nSequence` number of a specific input.
+Represents the `nSequence` number of a specific input. This value of the input's `sequenceNumber` is only consensus-enforced as a relative timelock when using transaction version 2.
 
 #### tx.inputs[i].tokenCategory
 ```solidity
@@ -133,8 +133,8 @@ bytes tx.inputs[i].tokenCategory
 
 Represents the `tokenCategory` of a specific input. Returns 0 when that specific input contains no tokens. When the input contains an NFT with a capability, the 32-byte `tokenCategory` is concatenated together with `0x01` for a mutable NFT and `0x02` for a minting NFT.
 
-:::note
-The `tokenCategory` is returned in the original unreversed order. Explorers and wallets change the byte order by default but for CashScript you need to be careful to use the unreversed order.
+:::caution
+The `tokenCategory` introspection variable returns the tokenCategory in the original unreversed order, this is unlike wallets and explorers which use the reversed byte-order. So be careful about the byte-order of `tokenCategory` when working with BCH smart contracts.
 :::
 
 #### tx.inputs[i].nftCommitment
@@ -182,8 +182,8 @@ bytes tx.output[i].tokenCategory
 
 Represents the `tokenCategory` of a specific output. Returns 0 when that specific output contains no tokens. When the output contains an NFT with a capability, the 32-byte `tokenCategory` is concatenated together with `0x01` for a mutable NFT and `0x02` for a minting NFT.
 
-:::note
-The `tokenCategory` is returned in the original unreversed order. Explorers and wallets change the byte order by default but for CashScript you need to be careful to use the unreversed order.
+:::caution
+The `tokenCategory` introspection variable returns the tokenCategory in the original unreversed order, this is unlike wallets and explorers which use the reversed byte-order. So be careful about the byte-order of `tokenCategory` when working with BCH smart contracts.
 :::
 
 #### tx.output[i].nftCommitment
@@ -206,7 +206,7 @@ One of the main use cases of covenants is enforcing transaction outputs (where m
 #### Example
 ```solidity
 bytes25 lockingBytecode = new LockingBytecodeP2PKH(pkh);
-int value = 10000;
+int value = 10_000;
 require(tx.outputs[0].lockingBytecode == lockingBytecode);
 require(tx.outputs[0].value == value);
 ```
@@ -243,6 +243,10 @@ new LockingBytecodeNullData(bytes[] chunks): bytes
 
 Creates new OP_RETURN locking bytecode with `chunks` as its OP_RETURN data.
 
+:::note
+`LockingBytecodeNullData` outputs are provably unspendable, so any BCH sent there would be burned. For these outputs no dust-minimum is enforced so often `LockingBytecodeNullData` outputs have 0 BCH on them.
+:::
+
 ## Globally available units
 
 An integer literal can take a suffix of either monetary or temporary units to add semantic value to these integers and to simplify arithmetic. When these units are used, the underlying integer is automatically multiplied by the value of the unit.
diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index f55968fa..a5597454 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -174,6 +174,11 @@ bytes4 integer = bytes4(25);
 
 When casting integer types to bytes of a certain size, the integer value is padded with zeros, e.g. `bytes4(0) == 0x00000000`. It is also possible to pad with a variable number of zeros by passing in a `size` parameter, which indicates the size of the output, e.g. `bytes(0, 4 - 2) == 0x0000`. The size casting can be a very important feature when keeping local state in an nftCommitment or in the simulated state.
 
+:::tip
+Using `bytes20 placeholderPkh= bytes20(0)` will generate a 20 byte zero-array programmatically, whereas 
+`bytes20 placeholderPkh= 0x0000000000000000000000000000000000000000` will actually take 20 bytes of space in your contract.
+:::
+
 :::note
 VM numbers follow Script Number format (A.K.A. CSCriptNum), to convert VM number to bytes or the reverse, it's recommended to use helper functions for these conversions from libraries like Libauth.
 :::
diff --git a/website/docs/releases/migration-notes.md b/website/docs/releases/migration-notes.md
index 8c3d9765..a1c1cc3c 100644
--- a/website/docs/releases/migration-notes.md
+++ b/website/docs/releases/migration-notes.md
@@ -2,7 +2,74 @@
 title: Migration Notes
 ---
 
-## v0.9 to 0.10
+## v0.10 to v0.11
+
+### CashScript SDK
+
+The 'Simple Transaction builder' has been marked as deprecated and the 'Advanced Transaction Builder' is now simply referred to as the CashScript `Transaction Builder`, as there is only one supported for the future.
+
+#### Example
+Since the new transaction builder is quite different from the old one, it may be useful to see an example refactored from the old way to the new way.
+
+With the deprecated 'simple transaction builder' the API looked like this:
+
+```js
+import { ElectrumNetworkProvider, SignatureTemplate } from 'cashscript';
+
+const provider = new ElectrumNetworkProvider(Network.MAINNET);
+
+// Optionally specify the contract UTXO
+const contractUtxos = await contract.getUtxos();
+const selectedContractUtxo = contractUtxos[0]
+
+// Specify Bob Utxo to add to the transaction
+const bobUtxos = await provider.getUtxos(bobAddress);
+const selectedUtxoBob = bobUtxos[0]
+
+const bobSignatureTemplate = new SignatureTemplate(bobPriv)
+
+// Start building the transaction
+const txDetails = await contract.functions
+  .transfer(bobSignatureTemplate)
+  .from(selectedContractUtxo)
+  .fromP2PKH(selectedUtxoBob, bobSignatureTemplate)
+  .to('bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx', 10000n)
+  .withoutChange()
+  .send();
+```
+
+With the new transaction builder the API looks like this:
+
+
+```js
+import { transactionBuilder, ElectrumNetworkProvider, SignatureTemplate } from 'cashscript';
+
+const provider = new ElectrumNetworkProvider(Network.MAINNET);
+
+// Specify the contract UTXO
+const contractUtxos = await contract.getUtxos();
+const selectedContractUtxo = contractUtxos[0]
+
+// Specify Bob Utxo to add to the transaction
+const bobUtxos = await provider.getUtxos(bobAddress);
+const selectedUtxoBob = bobUtxos[0]
+
+const bobSignatureTemplate = new SignatureTemplate(bobPriv)
+
+// Start building the transaction
+const txDetails = await new TransactionBuilder({ provider })
+  .addInput(selectedContractUtxo, contract.unlock.transfer(bobSignatureTemplate))
+  .addInput(selectedUtxoBob, bobSignatureTemplate.unlockP2PKH())
+  .addOutput({
+    to: 'bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx',
+    amount: 10000n
+  })
+  .send();
+```
+
+With the new transaction builder, all inputs and outputs are explicitly specified. This means that there are no automatic change outputs added (for BCH or tokens). This means that there are also no `.withMinChange()`, `.withoutChange()`, `.withoutTokenChange()`, `withHardcodedFee()`, or `.withFeePerByte()` methods. The developer is responsible for manually adding change outputs. There is still an option to use `.setMaxFee()` as a security measure to prevent the transaction from being too expensive.
+
+## v0.9 to v0.10
 
 ### CashScript SDK
 
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 09b45eab..a40a865d 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,7 +2,7 @@
 title: Release Notes
 ---
 
-## v0.11.0-next.0
+## v0.11.0-next.1
 
 This update adds CashScript support for the new BCH 2025 network upgrade. To read more about the upgrade, see [this blog post](https://blog.bitjson.com/2025-chips/).
 
@@ -11,6 +11,11 @@ This update adds CashScript support for the new BCH 2025 network upgrade. To rea
 
 #### CashScript SDK
 - :hammer_and_wrench: Update debug tooling to work with the new `BCH_2025_05` instruction set.
+- :sparkles: Add debugging capabilities to the `TransactionBuilder`.
+  - `transaction.debug()` & `transaction.bitauthUri()`
+  - Output BitAuth IDE URI for debugging when transaction is rejected.
+  - Libauth template generation and debugging for multi-contract transactions
+- :hammer_and_wrench: Deprecate the simple transaction builder. You can still use the simple transaction builder with the current SDK, but this support will be removed in a future release.
 - :boom: **BREAKING**: Remove support for old contracts compiled with CashScript v0.6.x or earlier.
 
 ## v0.10.5
@@ -108,7 +113,7 @@ https://x.com/CashScriptBCH/status/1833454128426615174
 ## v0.9.0
 
 #### CashScript SDK
-- :sparkles: Add new advanced `TransactionBuilder` class that allows combining UTXOs from multiple different smart contracts and P2PKH UTXOs in a single transaction.
+- :sparkles: Add new `TransactionBuilder` class that allows combining UTXOs from multiple different smart contracts and P2PKH UTXOs in a single transaction.
 - :hammer_and_wrench: Deprecate all `meep` functionality. Meep has been unmaintained for years and does not support many new CashScript features. Meep functionality will be removed in a future release.
 
 ---
diff --git a/website/docs/sdk/examples.md b/website/docs/sdk/examples.md
index c03a8af7..7047ae5e 100644
--- a/website/docs/sdk/examples.md
+++ b/website/docs/sdk/examples.md
@@ -143,21 +143,33 @@ const provider = new ElectrumNetworkProvider('chipnet');
 const parameters = [alicePub, oraclePub, 100000n, 30000n];
 const contract = new Contract(artifact, parameters, { provider });
 
-// Get contract balance & output address + balance
+// Fetch contract utxos
+const contractUtxos = await contract.getUtxos();
+
+// Log contract output address + contract utxos
 console.log('contract address:', contract.address);
-console.log('contract balance:', await contract.getBalance());
+console.log('contract utxos', contractUtxos);
 
 // Produce new oracle message and signature
 const oracleMessage = oracle.createMessage(100000n, 30000n);
 const oracleSignature = oracle.signMessage(oracleMessage);
 
+// Select a hodlvault utxo to spend from
+const selectedContractUtxo = contractUtxos[0]
+
+// Create the signatureTemplate for alice to sign the contract input
+const aliceSignatureTemplate = new SignatureTemplate(alicePriv)
+
 // Spend from the vault
-const tx = await contract.functions
-  .spend(new SignatureTemplate(alicePriv), oracleSignature, oracleMessage)
-  .to(contract.address, 1000n)
+const transferDetails = await new TransactionBuilder({ provider })
+  .addInput(selectedContractUtxo, contract.unlock.spend(aliceSignatureTemplate, oracleSignature, oracleMessage))
+  .addOutput({
+    to: contract.address,
+    amount: 1000n
+  })
   .send();
 
-console.log(stringify(tx));
+console.log(transferDetails);
 ```
 
 [bchjs]: https://bchjs.fullstack.cash/
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 9a701218..a6b5c927 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -47,10 +47,10 @@ import P2PKH from './p2pkh.json' with { type: 'json' };
 // Or compile a contract file
 const P2PKH = compileFile(new URL('p2pkh.cash', import.meta.url));
 
-const provider = new ElectrumNetworkProvider('chipnet');
-const addressType = 'p2sh20';
 const contractArguments = [alicePkh]
-const options = { provider, addressType}
+
+const provider = new ElectrumNetworkProvider('chipnet');
+const options = { provider, addressType: 'p2sh20' }
 const contract = new Contract(P2PKH, contractArguments, options);
 ```
 
@@ -159,40 +159,16 @@ interface Utxo {
 const utxos = await contract.getUtxos()
 ```
 
-### Contract functions
-```ts
-contract.functions.<functionName>(...args: FunctionArgument[]): Transaction
-```
-
-Once a smart contract has been instantiated, you can invoke a contract function to spend from the contract with the '[Simple transaction-builder](/docs/sdk/transactions)' by calling the function name under the `functions` member field of a contract object.
-To call these functions successfully, the provided parameters must match the function signature defined in the CashScript code.
-
-These contract functions return an incomplete `Transaction` object, which needs to be completed by providing outputs of the transaction. For more information see the [Simple transaction-builder](/docs/sdk/transactions) page.
-
-#### Example
-```ts
-import { alice } from './somewhere';
-
-const tx = await contract.functions
-  .transfer(new SignatureTemplate(alice))
-  .to('bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx', 10000n)
-  .send()
-```
-
-:::tip
-If the contract artifact is generated using the `cashc` CLI with the `--format ts` option, you will get explicit types and type checking for the function name and arguments.
-:::
-
 ### Contract unlockers
 
 ```ts
 contract.unlock.<functionName>(...args: FunctionArgument[]): Unlocker
 ```
 
-Once a smart contract has been instantiated, you can invoke a contract function on a smart contract UTXO to use the '[Advanced transaction-builder](/docs/sdk/transactions-advanced)' by calling the function name under the `unlock` member field of a contract object.
+Once a smart contract has been instantiated, you can invoke a contract function on a smart contract UTXO to use the '[Transaction Builder](/docs/sdk/transaction-builder)' by calling the function name under the `unlock` member field of a contract object.
 To call these functions successfully, the provided parameters must match the function signature defined in the CashScript code.
 
-These contract functions return an incomplete `transactionBuilder` object, which needs to be completed by providing outputs of the transaction. For more information see the [Advanced transaction-builder](/docs/sdk/transactions-advanced) page.
+These contract functions return an incomplete `transactionBuilder` object, which needs to be completed by providing outputs of the transaction. For more information see the [transaction-builder](/docs/sdk/transaction-builder) page.
 
 ```ts
 import { contract, transactionBuilder } from './somewhere.js';
@@ -201,3 +177,7 @@ const contractUtxos = await contract.getUtxos();
 
 transactionBuilder.addInput(contractUtxos[0], contract.unlock.spend());
 ```
+
+:::tip
+If the contract artifact is generated using the `cashc` CLI with the `--format ts` option, you will get explicit types and type checking for the function name and arguments.
+:::
\ No newline at end of file
diff --git a/website/docs/sdk/network-provider.md b/website/docs/sdk/network-provider.md
index 88cfbc6f..7e7e83b2 100644
--- a/website/docs/sdk/network-provider.md
+++ b/website/docs/sdk/network-provider.md
@@ -19,7 +19,7 @@ In some cases it might be desirable to overwrite the 2-of-3 ElectrumCluster defa
 
 ### Network
 ```ts
-type Network = 'mainnet' | 'testnet3' | 'testnet4' | 'chipnet' | 'regtest';
+type Network = 'mainnet' | 'chipnet' | 'testnet3' | 'testnet4' | 'regtest';
 ```
 
 The network parameter can be one of 5 different options.
@@ -120,7 +120,7 @@ There are two alternative network providers implemented:
 Currently neither supports CashTokens, so it is recommended to use the `ElectrumNetworkProvider`.
 
 ### Custom NetworkProviders
-A big strength of the NetworkProvider setup is that it allows you to implement custom providers. So if new BCH libraries are created in the future, it is simple to use them with CashScript. Custom NetworkProviders also potentially enables the CashScript SDK to be used with other (partially) compatible networks, such as BTC or BSV.
+A big strength of the NetworkProvider setup is that it allows you to implement custom providers. So if you want to use a new or different BCH indexers for network information, it is simple to use it with CashScript.
 
 :::info
 To implement a Custom NetworkProvider, refer to the [NetworkProvider interface](https://github.com/CashScript/cashscript/blob/master/packages/cashscript/src/network/NetworkProvider.ts).
diff --git a/website/docs/sdk/signature-templates.md b/website/docs/sdk/signature-templates.md
index bd3a2106..090a400e 100644
--- a/website/docs/sdk/signature-templates.md
+++ b/website/docs/sdk/signature-templates.md
@@ -17,21 +17,52 @@ new SignatureTemplate(
 )
 ```
 
-In place of a signature, a `SignatureTemplate` can be passed, which will automatically generate the correct signature using the `signer` parameter. This signer can be any representation of a private key, including [BCHJS' `ECPair`][ecpair], [bitcore-lib-cash' `PrivateKey`][privatekey], [WIF strings][wif], or raw private key buffers. This ensures that any BCH library can be used.
+In place of a signature, a `SignatureTemplate` can be passed, which will automatically generate the correct signature using the `signer` parameter. This signer can be any representation of a private key, including [WIF strings][wif], [BCHJS' `ECPair`][ecpair], [bitcore-lib-cash' `PrivateKey`][privatekey], or binary private keys represented as `Uint8Array`. This ensures that `SignatureTemplate` can be used with any BCH library.
 
 #### Example
 ```ts
 const aliceWif = 'L4vmKsStbQaCvaKPnCzdRArZgdAxTqVx8vjMGLW5nHtWdRguiRi1';
 const aliceSignatureTemplate = new SignatureTemplate(aliceWif)
 
-const tx = await contract.functions
-  .transfer(aliceSignatureTemplate)
-  .to('bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx', 10000n)
-  .send()
+const transferDetails = await new TransactionBuilder({ provider })
+  .addInput(selectedContractUtxo, contract.unlock.transfer(aliceSignatureTemplate))
+  .addOutput({
+    to: 'bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx',
+    amount: 10000n
+  })
+  .send();
 ```
 
 The `hashtype` and `signatureAlgorithm` options are covered under ['Advanced Usage'](/docs/sdk/signature-templates#advanced-usage).
 
+## SignatureTemplate Methods
+
+### getPublicKey()
+```ts
+signatureTemplate.getPublicKey(): Uint8Array
+```
+
+#### Example
+```ts
+import { aliceTemplate } from './somewhere.js';
+
+const alicePublicKey = aliceTemplate.getPublicKey()
+```
+
+### unlockP2PKH()
+```ts
+signatureTemplate.unlockP2PKH(): Unlocker
+```
+
+#### Example
+```ts
+import { aliceTemplate, aliceAddress, transactionBuilder } from './somewhere.js';
+
+const aliceUtxos = await provider.getUtxos(aliceAddress);
+transactionBuilder.addInput(aliceUtxos[0], aliceTemplate.unlockP2PKH());
+```
+
+
 ## Advanced Usage
 
 ### HashType
@@ -55,6 +86,8 @@ const wif = 'L4vmKsStbQaCvaKPnCzdRArZgdAxTqVx8vjMGLW5nHtWdRguiRi1';
 const signatureTemplate = new SignatureTemplate(
   wif, HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS
 );
+
+const configuredHashType = signatureTemplate.getHashType()
 ```
 
 ### SignatureAlgorithm
@@ -75,6 +108,8 @@ const wif = 'L4vmKsStbQaCvaKPnCzdRArZgdAxTqVx8vjMGLW5nHtWdRguiRi1';
 const hashType = HashType.SIGHASH_ALL | HashType.SIGHASH_UTXOS
 const signatureAlgorithm = SignatureAlgorithm.SCHNORR
 const signatureTemplate = new SignatureTemplate(wif, hashType,signatureAlgorithm);
+
+const configuredSignatureAlgorithm = signatureTemplate.getSignatureAlgorithm()
 ```
 
 [wif]: https://en.bitcoin.it/wiki/Wallet_import_format
diff --git a/website/docs/sdk/testing-setup.md b/website/docs/sdk/testing-setup.md
index 7cb9234e..6bf806a6 100644
--- a/website/docs/sdk/testing-setup.md
+++ b/website/docs/sdk/testing-setup.md
@@ -2,25 +2,25 @@
 title: Testing Setup
 ---
 
-Because of deep integration with libauth, CashScript allows for local transaction evaluation without actual interaction with any Bitcoin Cash test network. With a MockNetwork environment you can create virtual UTXOs without doing additional preparations. This has the advantages of not needing any testnet balances, not having to set up smart contract UTXOs and not having network latency. This setup allows for using a testing framework to run repeated automated tests for increased smart contract security.
+For the ease of development, CashScript has a `MockNetwork` environment where you can create virtual UTXOs. This has the advantages of not needing any testnet balances, not having to set up smart contract UTXOs and not having network latency. Because of this the MockNetwork environment is the ideal setup to run repeated automated tests with a testing framework for increased smart contract security.
 
-For a quick start with a CashScript testing setup, you can check out [our testing-suite example](https://github.com/CashScript/cashscript/tree/next/examples/testing-suite) that demonstrates a full development and testing environment for CashScript contracts, similar to Hardhat on Ethereum.
-
-:::caution
-The CashScript debugging tools only work with the [Simple Transaction Builder](/docs/sdk/transactions). We plan to extend the debugging tools to work with the [Advanced Transaction Builder](/docs/sdk/transactions-advanced) in the future.
+:::tip
+For a quick start with a CashScript testing setup, check out the [example testing-suite](https://github.com/CashScript/cashscript/tree/next/examples/testing-suite) that demonstrates a full development and testing environment for CashScript contracts, similar to Hardhat on Ethereum.
 :::
 
 ## MockNetworkProvider
 
-The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. By default, it generates some random mock UTXOs for the contract address, but you can also add your own UTXOs to the provider.
+The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. To create a new virtual UTXO use `provider.addUtxo()`.
+
+#### Example
 
 ```ts
 import { MockNetworkProvider, randomUtxo, randomToken, randomNFT } from 'cashscript';
 
 const provider = new MockNetworkProvider();
-provider.addUtxo(contract.address, { vout: 0, txid: "ab...", satoshis: 10000n });
+const contractUtxo = provider.addUtxo(contract.address, { vout: 0, txid: "ab...", satoshis: 10000n });
 
-provider.addUtxo(aliceAddress, randomUtxo({
+const aliceUtxo = provider.addUtxo(aliceAddress, randomUtxo({
   satoshis: 1000n,
   token: { ...randomNFT(), ...randomToken() },
 }));
@@ -56,7 +56,11 @@ Logging is only available in debug evaluation of a transaction. It has no impact
 describe('Example contract', () => {
   it('should log the passed parameter', async () => {
     const contract = new Contract(artifact, [], { provider });
-    const transaction = contract.functions.exampleFunction(1000n).to(contract.address, 10000n);
+    const contractUtxo = provider.addUtxo(contract.address, randomUtxo());
+
+    const transaction = new TransactionBuilder({ provider })
+      .addInput(contractUtxo, contract.unlock.exampleFunction(1000n))
+      .addOutput({ to: contract.address, amount: 10000n })
     await expect(transaction).toLog('passed parameter: 1000');
   });
 });
@@ -73,14 +77,19 @@ Similar to `console.log`, the error message in a `require` statement is only ava
 ```ts
 describe('Example contract', () => {
   const contract = new Contract(artifact, [], { provider });
+  const contractUtxo = provider.addUtxo(contract.address, randomUtxo());
 
   it('should fail require statement when incorrect parameter is passed', async () => {
-    const transaction = contract.functions.exampleFunction(999n).to(contract.address, 10000n);
+    const transaction = new TransactionBuilder({ provider })
+      .addInput(contractUtxo, contract.unlock.exampleFunction(999n))
+      .addOutput({ to: contract.address, amount: 10000n })
     await expect(transaction).toFailRequireWith('passed parameter is not 1000');
   });
 
   it('should pass require statement when correct parameter is passed', async () => {
-    const transaction = contract.functions.exampleFunction(1000n).to(contract.address, 10000n);
+    const transaction = new TransactionBuilder({ provider })
+      .addInput(contractUtxo, contract.unlock.exampleFunction(999n))
+      .addOutput({ to: contract.address, amount: 10000n })
     await expect(transaction).not.toFailRequire();
   });
 });
@@ -103,23 +112,29 @@ import { Contract, MockNetworkProvider, randomUtxo } from 'cashscript';
 import 'cashscript/jest';
 
 describe('Example contract', () => {
-  const contract = new Contract(artifact, [], { provider });
   const provider = new MockNetworkProvider();
-  provider.addUtxo(contract.address, randomUtxo());
+  const contract = new Contract(artifact, [], { provider });
+  const contractUtxo = provider.addUtxo(contract.address, randomUtxo());
 
   it('should log the passed parameter', async () => {
     const contract = new Contract(artifact, [], { provider });
-    const transaction = contract.functions.exampleFunction(1000n).to(contract.address, 10000n);
+    const transaction = new TransactionBuilder({ provider })
+      .addInput(contractUtxo, contract.unlock.exampleFunction(1000n))
+      .addOutput({ to: contract.address, amount: 10000n })
     await expect(transaction).toLog('passed parameter: 1000');
   });
 
   it('should fail require statement when incorrect parameter is passed', async () => {
-    const transaction = contract.functions.exampleFunction(999n).to(contract.address, 10000n);
+    const transaction = new TransactionBuilder({ provider })
+      .addInput(contractUtxo, contract.unlock.exampleFunction(999n))
+      .addOutput({ to: contract.address, amount: 10000n })
     await expect(transaction).toFailRequireWith('passed parameter is not 1000');
   });
 
   it('should pass require statement when correct parameter is passed', async () => {
-    const transaction = contract.functions.exampleFunction(1000n).to(contract.address, 10000n);
+    const transaction = new TransactionBuilder({ provider })
+      .addInput(contractUtxo, contract.unlock.exampleFunction(1000n))
+      .addOutput({ to: contract.address, amount: 10000n })
     await expect(transaction).not.toFailRequire();
   });
 });
diff --git a/website/docs/sdk/transactions-advanced.md b/website/docs/sdk/transaction-builder.md
similarity index 74%
rename from website/docs/sdk/transactions-advanced.md
rename to website/docs/sdk/transaction-builder.md
index 97865c00..b2c4c468 100644
--- a/website/docs/sdk/transactions-advanced.md
+++ b/website/docs/sdk/transaction-builder.md
@@ -1,10 +1,14 @@
 ---
-title: Advanced Transaction Builder
+title: Transaction Builder
 ---
 
-With the introduction of newer smart contract features to BCH, such as native introspection and CashTokens, we've seen use cases for combining UTXOs of multiple different smart contracts within a single transaction — such as [Fex][fex]. The [simple transaction builder][transactions-simple] only operates on a single smart contract. To support more advanced use cases, you can use the Advanced Transaction Builder.
+The CashScript Transaction Builder generalizes transaction building to allow for complex transactions combining multiple different smart contracts within a single transaction or to create basic P2PKH transactions. The Transaction Builder works by adding inputs and outputs to fully specify the transaction shape.
 
-The Advanced Transaction Builder supports adding UTXOs from any number of different smart contracts and P2PKH UTXOs. While the simplified transaction builder automatically selects UTXOs for you and adds change outputs, the advanced transaction builder requires you to provide the UTXOs yourself and manage change carefully.
+For the documentation for the old and deprecated transaction builder API, refer to [this docs page instead](/docs/sdk/transactions).
+
+:::info
+Defining the inputs and outputs requires careful consideration because the difference in Bitcoin Cash value between in- and outputs is what's paid in transaction fees to the miners.
+:::
 
 ## Instantiating a transaction builder
 ```ts
@@ -28,7 +32,7 @@ const provider = new ElectrumNetworkProvider(Network.MAINNET);
 const transactionBuilder = new TransactionBuilder({ provider });
 ```
 
-## Transaction options
+## Transaction Building
 
 ### addInput()
 ```ts
@@ -38,7 +42,7 @@ transactionBuilder.addInput(utxo: Utxo, unlocker: Unlocker, options?: InputOptio
 Adds a single input UTXO to the transaction that can be unlocked using the provided unlocker. The unlocker can be derived from a `SignatureTemplate` or a `Contract` instance's spending functions. The `InputOptions` object can be used to specify the sequence number of the input.
 
 :::note
-It is possible to create custom unlockers by implementing the `Unlocker` interface. Most use cases are covered by the `SignatureTemplate` and `Contract` classes.
+It is possible to create custom unlockers by implementing the `Unlocker` interface. Most use cases however are covered by the `SignatureTemplate` and `Contract` classes.
 :::
 
 #### Example
@@ -162,7 +166,7 @@ transactionBuilder.setLocktime(((Date.now() / 1000) + 24 * 60 * 60) * 1000);
 transactionBuilder.setMaxFee(maxFee: bigint): this
 ```
 
-Sets a max fee for the transaction. Because the advanced transaction builder does not automatically add a change output, you can set a max fee as a safety measure to make sure you don't accidentally pay too much in fees. If the transaction fee exceeds the max fee, an error will be thrown when building the transaction.
+Sets a max fee for the transaction. Because the transaction builder does not automatically add a change output, you can set a max fee as a safety measure to make sure you don't accidentally pay too much in fees. If the transaction fee exceeds the max fee, an error will be thrown when building the transaction.
 
 #### Example
 ```ts
@@ -227,11 +231,29 @@ const txHex = new TransactionBuilder({ provider })
   .build()
 ```
 
+### debug()
+```ts
+async transactionBuilder.debug(): Promise<DebugResult>
+```
+
+If you want to debug a transaction locally instead of sending it to the network, you can call the `debug()` function on the transaction. This will return intermediate values and the final result of the transaction. It will also show any logged values and `require` error messages.
+
+### bitauthUri()
+```ts
+transactionBuilder.bitauthUri(): string
+```
+
+If you prefer a lower-level debugging experience, you can call the `bitauthUri()` function on the transaction. This will return a URI that can be opened in the BitAuth IDE. This URI is also displayed in the console whenever a transaction fails.
+You can read more about debugging transactions on the [debugging page](/docs/guides/debugging).
+
+:::caution
+It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
+:::
+
 ## Transaction errors
 
-Transactions can fail for a number of reasons. Refer to the [Transaction Errors][transactions-simple-errors] section of the simplified transaction builder documentation for more information. Note that the advanced transaction builder does not yet support the `FailedRequireError` mentioned in the simplified transaction builder documentation so any error will be of type `FailedTransactionError` and include any of the mentioned error reasons in its message.
+Transactions can fail for a number of reasons. Refer to the [Transaction Errors][transactions-simple-errors] section of the simplified transaction builder documentation for more information. Note that the transaction builder does not yet support the `FailedRequireError` mentioned in the simplified transaction builder documentation so any error will be of type `FailedTransactionError` and include any of the mentioned error reasons in its message.
 
-[fex]: https://github.com/fex-cash/fex
 [bitcoin-wiki-timelocks]: https://en.bitcoin.it/wiki/Timelock
 
 [transactions-simple]: /docs/sdk/transactions
diff --git a/website/docs/sdk/transactions.md b/website/docs/sdk/transactions.md
index f491a7b8..64cdeaab 100644
--- a/website/docs/sdk/transactions.md
+++ b/website/docs/sdk/transactions.md
@@ -1,8 +1,13 @@
 ---
-title: Simple Transaction Builder
+title: Old Transaction Builder
 ---
 
-When calling a contract function on a Contract object, an incomplete Transaction object is returned. This transaction can be completed by providing a number of outputs using the [`to()`][to()] or [`withOpReturn()`][withOpReturn()] functions. Other chained functions are included to set other transaction parameters.
+:::caution
+This is the documentation for the old and now deprecated 'Simple Transaction Builder' by calling a function on the contract object directly.
+It is strongly recommended to migrate over to the new default transaction builder [using the migration notes](/docs/releases/migration-notes).
+:::
+
+When calling a contract function of a Contract object's `functions`, an incomplete Transaction object is returned. This transaction can be completed by providing a number of outputs using the [`to()`][to()] or [`withOpReturn()`][withOpReturn()] functions. Other chained functions are included to set other transaction parameters.
 
 Most of the available transaction options are only useful in very specific use cases, but the functions [`to()`][to()], [`withOpReturn()`][withOpReturn()] and [`send()`][send()] are commonly used. [`withHardcodedFee()`][withHardcodedFee()] is also commonly used with covenant contracts.
 
diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index 45eeb6b8..b061a7ee 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -78,6 +78,16 @@ BadgerCoin is a fungible CashToken using a novel distribution mechanism. BadgerC
 
 FundMe is a new BCH crowdfunding platform using WalletConnect. Fundme campaigns have revocable and refundable pledges through the use of CashTokens receipts. By using receipts, Fundme does not have a maximum limit on the number of participants in a campaign.
 
+## Zapit P2P Exchange
+
+<div style={{textAlign: 'center', width: '50%', margin: 'auto', marginBottom: '20px'}}>
+    <a href="https://zapit.io/" target="_blank">
+        <img src="/img/zapit_logo.svg" style={{width: '100%', margin: "50px 0"}} />
+    </a>
+</div>
+
+The Zapit wallet has a built-in P2P Exchange which allows user to buy or sell Bitcoin Cash directly without a custodial middleman. The P2P exchange works with an escrow smart contract which is written in CashScript. The P2P exchange contract has already processed hundreds of BCH in volume.
+
 ## Unspent Phi
 
 <div style={{textAlign: 'center', width: '50%', margin: 'auto', marginBottom: '20px'}}>
diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
index a2f73e86..e50eb37c 100755
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@@ -119,6 +119,7 @@ module.exports = {
           { from: ['/docs', '/docs/about', '/docs/basics'], to: '/docs/basics/about'},
           { from: '/docs/language', to: '/docs/language/contracts' },
           { from: '/docs/sdk', to: '/docs/sdk/instantiation' },
+          { from: '/docs/sdk/transactions-advanced', to: '/docs/sdk/transaction-builder' },
           { from: '/docs/guides', to: '/docs/guides/covenants' },
           { from: '/docs/getting-started', to: '/docs/basics/getting-started' },
           { from: '/docs/examples', to: '/docs/language/examples' },
diff --git a/website/sidebars.js b/website/sidebars.js
index e27144ce..0c318587 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -35,10 +35,9 @@ module.exports = {
       label: 'TypeScript SDK',
       items: [
         'sdk/instantiation',
+        'sdk/transaction-builder',
         'sdk/signature-templates',
         'sdk/network-provider',
-        'sdk/transactions',
-        'sdk/transactions-advanced',
         'sdk/testing-setup',
         'sdk/examples',
       ],
diff --git a/website/src/css/custom.css b/website/src/css/custom.css
index b85de855..632edca3 100755
--- a/website/src/css/custom.css
+++ b/website/src/css/custom.css
@@ -9,6 +9,7 @@
   --ifm-color-primary: #1D64F2;
   --ifm-color-secondary: #04FF84;
   --ifm-color-light: #f4f4f4;
+  --ifm-color-secondary-dark: #0ed482;
 
   /* Dark theme colour in three different intensities */
   --ifm-color-dark: #012335;
@@ -53,7 +54,9 @@
 html[data-theme="dark"] {
   /* Theme colours inverted in dark mode */
   --ifm-color-primary: #04FF84;
+  --ifm-color-primary-dark: #0ed482;
   --ifm-color-secondary: #1D64F2;
+  --ifm-color-secondary-dark: #306CCE;
 
   /* Extend navbar in dark mode */
   --ifm-background-surface-color: var(--ifm-color-dark);
@@ -74,12 +77,13 @@ html[data-theme="dark"] {
   /* Alert headings are black, while regular headings are white */
   --ifm-alert-color:#000000;
   --ifm-heading-color: #ffffff;
+
+  --ifm-alert-background-color: #474748;
 }
 
 /* NOTE admonitions should be light grey (instead of secondary colour) */
 .alert--secondary {
-  --ifm-alert-background-color: #ebedf0;
-  --ifm-alert-border-color: #ebedf0;
+  --ifm-alert-border-color: #d4d5d8;
 }
 
 /* Light/dark toggle colour should change depending on theme */
diff --git a/website/src/pages/index.js b/website/src/pages/index.js
index 6183bed3..2c052e1c 100755
--- a/website/src/pages/index.js
+++ b/website/src/pages/index.js
@@ -76,12 +76,20 @@ function Home() {
             <div className={classnames('col col--6 col--offset-3')}>
               <h1>{siteConfig.title}</h1>
               <h2>{siteConfig.tagline}</h2>
-              <div className={styles.buttons}>
+              <div className={styles.buttons} style={{ gap: '1rem' }}>
                 <Link
                   className={classnames(
                     'button button--primary button--lg',
                     styles.getStarted,
                   )}
+                  to={useBaseUrl('docs/basics/about')}>
+                  Learn More
+                </Link>
+                <Link
+                  className={classnames(
+                    'button button--secondary button--lg',
+                    styles.getStarted,
+                  )}
                   to={useBaseUrl('docs/basics/getting-started')}>
                   Get Started
                 </Link>
diff --git a/website/static/img/zapit_logo.svg b/website/static/img/zapit_logo.svg
new file mode 100644
index 00000000..74bde9c4
--- /dev/null
+++ b/website/static/img/zapit_logo.svg
@@ -0,0 +1,10 @@
+<svg width="149" height="40" viewBox="0 0 149 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M131.41 9.89648H125.472V31.2734H131.41V9.89648Z" fill="#3267CF"/>
+<path d="M29.76 37.4411C25.3214 39.9292 19.9357 40.7357 14.6451 39.2687C9.32916 37.7951 5.1129 34.3036 2.59486 29.8529C0.0779296 25.4022 -0.742966 19.9913 0.731789 14.6755C1.01501 13.6566 1.37236 12.6775 1.79498 11.7427C2.78848 9.54774 6.01345 10.7791 4.91596 13.2185C4.5741 13.9774 4.28645 14.7717 4.05743 15.597C2.83824 19.9957 3.51644 24.4707 5.59858 28.1536C7.68292 31.8343 11.1701 34.7229 15.5678 35.942C19.8184 37.1202 24.142 36.5262 27.752 34.6056C30.1163 33.3466 31.8045 36.296 29.76 37.4411ZM10.2098 2.58906C14.6485 0.100978 20.0342 -0.705521 25.3247 0.761443C30.6407 2.23615 34.8569 5.72655 37.375 10.1772C39.8908 14.629 40.7128 20.04 39.238 25.3558C38.9548 26.3747 38.5975 27.3538 38.1748 28.2875C37.2699 30.2855 34.0913 28.9502 35.0538 26.8117C35.3957 26.0527 35.6833 25.2584 35.9124 24.4331C37.1315 20.0344 36.4534 15.5594 34.3713 11.8765C32.2869 8.19473 28.7997 5.30726 24.402 4.08811C20.1514 2.9099 15.8289 3.5062 12.2178 5.42453C9.93765 6.63594 8.08895 3.77613 10.2098 2.58906Z" fill="#3267CF"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M128.639 7.12565C130.575 7.12565 132.202 5.49904 132.202 3.56283C132.202 1.62662 130.575 0 128.639 0C126.703 0 125.076 1.62662 125.076 3.56283C125.076 5.49904 126.703 7.12565 128.639 7.12565Z" fill="#3267CF"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M110.726 26.4516C114.182 26.4516 116.456 24.0618 116.456 20.6961C116.456 17.332 114.182 14.9423 110.726 14.9423C107.269 14.9423 104.994 17.332 104.994 20.6961C104.996 24.0635 107.269 26.4516 110.726 26.4516ZM104.996 10.1677H99.1467V31.2278V39.9826H104.996V35.7122V31.2278V28.9937C111.041 34.7816 122.305 29.8821 122.305 20.6977C122.305 11.5279 111.04 6.58795 104.996 12.4018V10.1677Z" fill="#3267CF"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M82.4192 26.2853C78.9627 26.2853 76.6891 23.9196 76.6891 20.5877C76.6891 17.2573 78.9627 14.8916 82.4192 14.8916C85.8758 14.8916 88.1493 17.2573 88.1493 20.5877C88.1509 23.9212 85.8774 26.2853 82.4192 26.2853ZM88.151 10.165V12.3766C82.1069 6.62118 70.8417 11.5115 70.8417 20.5893C70.8417 29.6814 82.1053 34.5317 88.151 28.8019V31.0136H94V10.165H88.151Z" fill="#3267CF"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M65.186 9.89648C66.3002 9.89648 67.2595 10.4264 67.8674 11.3792C68.4769 12.3304 68.5656 13.4396 68.1173 14.4812C67.84 15.1247 67.4853 15.7484 67.0499 16.3589L60.2602 25.8922H69.8523V31.2734H56.4275C55.3134 31.2734 54.3556 30.7435 53.7461 29.7907C53.1367 28.8379 53.048 27.7303 53.4962 26.6887C53.7735 26.0452 54.1283 25.4199 54.5636 24.811L61.3534 15.2777H52.632V9.89648H65.186Z" fill="#3267CF"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M148.63 15.5701V10.1167H144.152V4.15625L138.451 5.87075V10.1167H134.973V15.5701H138.451V23.6971C138.451 30.7682 142.366 31.7175 148.63 31.1266V26.0089C146.762 26.1203 144.152 26.1671 144.152 23.6971V15.5701H148.63Z" fill="#3267CF"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M15.6059 16.9215C15.3761 16.0344 14.5023 15.2893 13.9312 14.8851L12.5548 14.0034L10.035 12.3886L7.51416 10.775L4.99328 9.16129C4.15372 8.62377 3.31306 8.08624 2.47351 7.54762C0.103981 6.0301 1.48926 5.43903 3.62791 6.03228C4.70938 6.33054 5.79086 6.62989 6.87123 6.92706L11.5904 8.23045L15.2126 9.2323C18.2682 11.4206 19.7462 14.9681 15.6059 16.9215ZM24.3649 23.1752C24.5957 24.0623 25.4684 24.8074 26.0395 25.2117L27.416 26.0933L29.9357 27.7081L32.4566 29.3207L34.9775 30.9343C35.817 31.4719 36.6577 32.0094 37.4972 32.548C39.8667 34.0655 38.4815 34.6555 36.3428 34.0634C35.2613 33.7651 34.1799 33.4657 33.0995 33.1686L28.3803 31.8652L24.757 30.8622C21.7015 28.6761 20.2245 25.1297 24.3649 23.1752ZM15.9936 18.2457L17.5943 17.2307C17.5943 17.2307 23.2425 13.8439 17.5567 9.88018L21.0287 10.8394L25.7468 12.1428C34.5875 14.5824 29.4 18.3495 27.1785 19.8211C26.6504 20.1718 26.1102 20.4985 25.5778 20.8361L23.976 21.851L22.3753 22.866C22.3753 22.866 16.7282 26.2528 22.4129 30.2165L18.9409 29.2573L15.9969 28.4445C6.88558 25.9284 10.0947 22.1504 12.7912 20.2756C13.3104 19.9129 13.8583 19.5993 14.3918 19.2606L15.9936 18.2457ZM26.5521 25.5394C26.5521 25.5394 26.3356 25.4225 26.0395 25.2117L26.5521 25.5394ZM13.4175 14.5573C13.4175 14.5573 13.634 14.6742 13.9301 14.8862L13.4175 14.5573Z" fill="#3267CF"/>
+</svg>

From 41f969f460606048595bb108e753044b9673e748 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 27 Feb 2025 10:52:21 +0100
Subject: [PATCH 179/267] Bump version to 0.11.0-next.1

---
 examples/package.json               | 6 +++---
 examples/testing-suite/package.json | 6 +++---
 packages/cashc/package.json         | 4 ++--
 packages/cashc/src/index.ts         | 2 +-
 packages/cashscript/package.json    | 4 ++--
 packages/utils/package.json         | 2 +-
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index 49128af2..0f548dc5 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.11.0-next.0",
+  "version": "0.11.0-next.1",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
     "@types/node": "^22.10.7",
-    "cashc": "^0.11.0-next.0",
-    "cashscript": "^0.11.0-next.0",
+    "cashc": "^0.11.0-next.1",
+    "cashscript": "^0.11.0-next.1",
     "eslint": "^8.56.0",
     "typescript": "^5.7.3"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index ab41724d..40dcba96 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.11.0-next.0",
+  "version": "0.11.0-next.1",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -26,8 +26,8 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "cashc": "^0.11.0-next.0",
-    "cashscript": "^0.11.0-next.0",
+    "cashc": "^0.11.0-next.1",
+    "cashscript": "^0.11.0-next.1",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 11a6659f..828dcd4f 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.11.0-next.0",
+  "version": "0.11.0-next.1",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.0",
+    "@cashscript/utils": "^0.11.0-next.1",
     "antlr4": "^4.13.2",
     "commander": "^13.1.0",
     "semver": "^7.6.3"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index dcf7c2f4..0a5d6122 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.11.0-next.0';
+export const version = '0.11.0-next.1';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index e94301b4..b5fde331 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.11.0-next.0",
+  "version": "0.11.0-next.1",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.0",
+    "@cashscript/utils": "^0.11.0-next.1",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "change-case": "^5.4.4",
     "delay": "^6.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 5f2a4cc8..6a6e8eb8 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.11.0-next.0",
+  "version": "0.11.0-next.1",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From adae18fd9e0b6e3105e58783c40092c34e6f37bf Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 28 Feb 2025 12:42:50 +0100
Subject: [PATCH 180/267] small fixes to docs

---
 website/docs/basics/getting-started.md   |  2 +-
 website/docs/language/contracts.md       | 12 ++++++------
 website/docs/language/examples.md        |  6 +++---
 website/docs/releases/migration-notes.md |  2 +-
 website/docs/releases/release-notes.md   |  2 +-
 website/docs/sdk/instantiation.md        |  2 +-
 website/docs/sdk/transaction-builder.md  |  2 +-
 website/docs/sdk/transactions.md         |  2 +-
 8 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 94dce696..b9d1f325 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -52,7 +52,7 @@ We can start from a basic `TransferWithTimeout` smart contract. Create a new fil
 The `TransferWithTimeout` contract takes in 3 contract arguments and has 2 contract functions: `transfer` and `timeout`.
 
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
     // Allow the recipient to claim their received money
diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index 35bccd6e..315cba09 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -13,7 +13,7 @@ Contract authors should be careful when allowing a range of versions to check th
 
 #### Example
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 pragma cashscript >= 0.7.0 < 0.9.3;
 ```
 
@@ -22,7 +22,7 @@ A CashScript constructor works slightly differently than what you might be used
 
 #### Example
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract HTLC(pubkey sender, pubkey recipient, int expiration, bytes32 hash) {
     ...
@@ -38,7 +38,7 @@ The main construct in a CashScript contract is the function. A contract can cont
 
 #### Example
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
     function transfer(sig recipientSig) {
@@ -69,7 +69,7 @@ The error message in a `require` statement is only available in debug evaluation
 
 #### Example
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract P2PKH(bytes20 pkh) {
     function spend(pubkey pk, sig s) {
@@ -111,7 +111,7 @@ There is no implicit type conversion from non-boolean to boolean types. So `if (
 
 #### Example
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract OneOfTwo(bytes20 pkh1, bytes32 hash1, bytes20 pkh2, bytes32 hash2) {
     function spend(pubkey pk, sig s, bytes message) {
@@ -138,7 +138,7 @@ Logging is only available in debug evaluation of a transaction, but has no impac
 
 #### Example
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract P2PKH(bytes20 pkh) {
     function spend(pubkey pk, sig s) {
diff --git a/website/docs/language/examples.md b/website/docs/language/examples.md
index 6d49ff62..9d45db94 100644
--- a/website/docs/language/examples.md
+++ b/website/docs/language/examples.md
@@ -12,7 +12,7 @@ This smart contract works by connecting with a price oracle. This price oracle i
 This involves some degree of trust in the price oracle, but since the oracle produces price data for everyone to use, their incentive to attack *your* smart contract is minimised. To improve this situation, you can also choose to connect with multiple oracle providers so you do not have to trust a single party.
 
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 // A minimum block is provided to ensure that oracle price entries from before
 // this block are disregarded. i.e. when the BCH price was $1000 in the past,
@@ -53,7 +53,7 @@ The contract works by checking that a UTXO is at least 30 days old, after which
 Due to the nature of covenants, we have to be very specific about the outputs (amounts and destinations) of the transaction. This also means that we have to account for the special case where the remaining contract balance is lower than the `pledge` amount, meaning no remainder should be sent back. Finally, we have to account for a small fee that has to be taken from the contract's balance to pay the miners.
 
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
     function receive() {
@@ -95,7 +95,7 @@ AMM DEX contract based on [the Cauldron DEX contract](https://www.cauldron.quest
 Compared to the manually written and hand-optimized opcodes version of the contract, the CashScript compiled bytecode has just 5 extra opcodes overhead (7 extra bytes).
 
 ```solidity
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract DexContract(bytes20 poolOwnerPkh) {
     function swap() {
diff --git a/website/docs/releases/migration-notes.md b/website/docs/releases/migration-notes.md
index a1c1cc3c..881a1ab0 100644
--- a/website/docs/releases/migration-notes.md
+++ b/website/docs/releases/migration-notes.md
@@ -42,7 +42,7 @@ With the new transaction builder the API looks like this:
 
 
 ```js
-import { transactionBuilder, ElectrumNetworkProvider, SignatureTemplate } from 'cashscript';
+import { TransactionBuilder, ElectrumNetworkProvider, SignatureTemplate } from 'cashscript';
 
 const provider = new ElectrumNetworkProvider(Network.MAINNET);
 
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index a40a865d..bb560464 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -10,12 +10,12 @@ This update adds CashScript support for the new BCH 2025 network upgrade. To rea
 - :hammer_and_wrench: Remove warning for opcount and update warning for byte size to match new limits.
 
 #### CashScript SDK
-- :hammer_and_wrench: Update debug tooling to work with the new `BCH_2025_05` instruction set.
 - :sparkles: Add debugging capabilities to the `TransactionBuilder`.
   - `transaction.debug()` & `transaction.bitauthUri()`
   - Output BitAuth IDE URI for debugging when transaction is rejected.
   - Libauth template generation and debugging for multi-contract transactions
 - :hammer_and_wrench: Deprecate the simple transaction builder. You can still use the simple transaction builder with the current SDK, but this support will be removed in a future release.
+- :hammer_and_wrench: Update debug tooling to use the new `BCH_2025_05` instruction set.
 - :boom: **BREAKING**: Remove support for old contracts compiled with CashScript v0.6.x or earlier.
 
 ## v0.10.5
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index a6b5c927..06c3c57f 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -10,7 +10,7 @@ Because of the separation of the compiler and the SDK, CashScript contracts can
 :::
 
 ## Creating a Contract
-The `Contract` class is used to represent a CashScript contract in a JavaScript object. These objects can be used to retrieve information such as the contract's address and balance. They can also be used to interact with the contract by calling the contract's functions.
+The `Contract` class is used to represent a CashScript contract in a JavaScript object. These objects can be used to retrieve information such as the contract's address and balance. Contract objects can be used to interact with the contract by generating an `Unlocker` by calling the contract's unlocker functions.
 
 ### Constructor
 ```ts
diff --git a/website/docs/sdk/transaction-builder.md b/website/docs/sdk/transaction-builder.md
index b2c4c468..64b1d23b 100644
--- a/website/docs/sdk/transaction-builder.md
+++ b/website/docs/sdk/transaction-builder.md
@@ -173,7 +173,7 @@ Sets a max fee for the transaction. Because the transaction builder does not aut
 transactionBuilder.setMaxFee(1000n);
 ```
 
-## Transaction building
+## Completing the Transaction
 ### send()
 ```ts
 async transactionBuilder.send(): Promise<TransactionDetails>
diff --git a/website/docs/sdk/transactions.md b/website/docs/sdk/transactions.md
index 64cdeaab..5ffb08b7 100644
--- a/website/docs/sdk/transactions.md
+++ b/website/docs/sdk/transactions.md
@@ -3,7 +3,7 @@ title: Old Transaction Builder
 ---
 
 :::caution
-This is the documentation for the old and now deprecated 'Simple Transaction Builder' by calling a function on the contract object directly.
+This is the documentation for the old and now deprecated 'Simple Transaction Builder' which operated on a single contract.
 It is strongly recommended to migrate over to the new default transaction builder [using the migration notes](/docs/releases/migration-notes).
 :::
 

From 5a77c2eb4900e7bcaf7077206c64bfdb6c976de7 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 28 Feb 2025 13:46:16 +0100
Subject: [PATCH 181/267] use TransactionBuilder in testing-suite

---
 examples/testing-suite/test/example.test.ts | 22 ++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/examples/testing-suite/test/example.test.ts b/examples/testing-suite/test/example.test.ts
index f793c428..517914d6 100644
--- a/examples/testing-suite/test/example.test.ts
+++ b/examples/testing-suite/test/example.test.ts
@@ -1,18 +1,26 @@
 import artifact from '../artifacts/example.json' with { type: 'json' };
-import { Contract, MockNetworkProvider, randomUtxo } from 'cashscript';
+import { Contract, MockNetworkProvider, TransactionBuilder, randomUtxo } from 'cashscript';
 import 'cashscript/jest';
 
 describe('test example contract functions', () => {
   it('should check for output logs and error messages', async () => {
     const provider = new MockNetworkProvider();
     const contract = new Contract(artifact, [], { provider });
-    provider.addUtxo(contract.address, randomUtxo());
+    
+    // Create a contract Utxo
+    const contractUtxo = randomUtxo();
+    provider.addUtxo(contract.address, contractUtxo);
 
-    let transaction = contract.functions.test(0n).to(contract.address, 10000n);
-    await (expect(transaction)).toLog(/0 test/);
-    await (expect(transaction)).toFailRequireWith(/Wrong value passed/);
+    const transactionWrongValuePassed = new TransactionBuilder({ provider })
+      .addInput(contractUtxo, contract.unlock.test(0n))
+      .addOutput({ to: contract.address, amount: 10000n });
+    await (expect(transactionWrongValuePassed)).toLog(/0 test/);
+    await (expect(transactionWrongValuePassed)).toFailRequireWith(/Wrong value passed/);
 
-    transaction = contract.functions.test(1n).to(contract.address, 10000n);
-    await expect(transaction.send()).resolves.not.toThrow();
+    const transactionRightValuePassed = new TransactionBuilder({ provider })
+      .addInput(contractUtxo, contract.unlock.test(1n))
+      .addOutput({ to: contract.address, amount: 10000n })
+      .send();
+    await expect(transactionRightValuePassed).resolves.not.toThrow();
   });
 });

From 228a5e573f39ca321aa26af40e60de34e550799e Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 3 Mar 2025 07:41:24 +0100
Subject: [PATCH 182/267] add success case to MultiContract.test.ts with
 different contracts

---
 .../cashscript/test/e2e/MultiContract.test.ts | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/packages/cashscript/test/e2e/MultiContract.test.ts b/packages/cashscript/test/e2e/MultiContract.test.ts
index 8136ebff..933a1639 100644
--- a/packages/cashscript/test/e2e/MultiContract.test.ts
+++ b/packages/cashscript/test/e2e/MultiContract.test.ts
@@ -178,6 +178,29 @@ describe('Multi Contract', () => {
       await expect(txPromise).rejects.toThrow('Failing statement: require(checkSig(recipientSig, recipient))');
     });
 
+    it('should succeed for correct unlockers (p2pkhContract + twtContract + bobAddress)', async () => {
+      // given
+      const to = p2pkhContract.address;
+      const amount = 10000n;
+      const outputs = [{ to, amount }];
+      const p2pkhContractUtxos = await p2pkhContract.getUtxos();
+      const twtContractUtxos = await twtContract.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const tx = await new TransactionBuilder({ provider })
+        .addInput(p2pkhContractUtxos[0], p2pkhContract.unlock.spend(bobPub, bobSignatureTemplate))
+        .addInput(twtContractUtxos[0], twtContract.unlock.timeout(bobSignatureTemplate))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount })
+        .setLocktime(1000000)
+        .send();
+
+      // then
+      const txOutputs = getTxOutputs(tx);
+      expect(txOutputs).toEqual(expect.arrayContaining(outputs));
+    });
+
   });
 });
 

From b3117df811dbd77cc9031054a632561c3132d93b Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 3 Mar 2025 12:55:11 +0100
Subject: [PATCH 183/267] fix casing in generateLockingScriptParams + add test

---
 .../src/advanced/LibauthTemplate.ts           |   4 +-
 .../multi-contract-fixtures.ts                | 303 +++++++++++++++++-
 .../LibauthTemplateMultiContract.test.ts      |   4 +-
 3 files changed, 307 insertions(+), 4 deletions(-)

diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index 1cc06444..f9d120d5 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -564,7 +564,9 @@ const generateLockingScriptParams = (
       addHexPrefixExceptEmpty(binToHex(csInput.unlocker!.contract!.encodedConstructorArgs[index])),
     ]);
 
-  const constructorParams = Object.fromEntries(constructorParamsEntries);
+  const constructorParams = Object.fromEntries(
+    constructorParamsEntries.map(([key, value]) => [snakeCase(key), value]),
+  );
 
   return {
     script: lockScriptName,
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index 3bc388fc..8986ed74 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -1,7 +1,9 @@
 import { TransactionBuilder, Contract, MockNetworkProvider, SignatureTemplate, randomNFT, randomToken, randomUtxo } from '../../../src/index.js';
 import BarArtifact from '../Bar.artifact.js';
 import FooArtifact from '../Foo.artifact.js';
-import { aliceAddress, alicePkh, alicePriv, alicePub, aliceTokenAddress, bobPriv, bobPub } from '../vars.js';
+import twtArtifact from '../transfer_with_timeout.artifact.js';
+import hodlVaultArtifact from '../hodl_vault.artifact.js';
+import { aliceAddress, alicePkh, alicePriv, alicePub, aliceTokenAddress, bobPriv, bobPub, carolPub, oracle, oraclePub } from '../vars.js';
 import { WalletTemplate } from '@bitauth/libauth';
 
 const provider = new MockNetworkProvider();
@@ -1205,6 +1207,305 @@ export const fixtures: Fixture[] = [
       },
     },
   },
+  {
+    name: 'HodlVault + twtContract',
+    transaction: (async () => {
+      const twtContract = new Contract(twtArtifact, [bobPub, carolPub, 100000n], { provider });
+      const hodlVault = new Contract(hodlVaultArtifact, [alicePub, oraclePub, 99000n, 30000n], { provider });
+      const bobSignatureTemplate = new SignatureTemplate(bobPriv);
+
+      const to = hodlVault.address;
+      const amount = 10000n;
+      const message = oracle.createMessage(100000n, 30000n);
+      const oracleSig = oracle.signMessage(message);
+      provider.addUtxo(twtContract.address, randomUtxo());
+      provider.addUtxo(hodlVault.address, randomUtxo());
+      const hodlVaultUtxos = await hodlVault.getUtxos();
+      const twtContractUtxos = await twtContract.getUtxos();
+
+      return new TransactionBuilder({ provider })
+        .addInput(hodlVaultUtxos[0], hodlVault.unlock.spend(new SignatureTemplate(alicePriv), oracleSig, message))
+        .addInput(twtContractUtxos[0], twtContract.unlock.timeout(bobSignatureTemplate))
+        .addOutput({ to, amount })
+        .setLocktime(1000000);
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2023_05',
+      ],
+      'version': 0,
+      'entities': {
+        'hodl_vault_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Hodl Vault',
+          'scripts': [
+            'hodl_vault_lock',
+            'hodl_vault_spend_unlock',
+          ],
+          'variables': {
+            'owner_sig': {
+              'description': '"ownerSig" parameter of function "spend"',
+              'name': 'Owner Sig',
+              'type': 'Key',
+            },
+            'oracle_sig': {
+              'description': '"oracleSig" parameter of function "spend"',
+              'name': 'Oracle Sig',
+              'type': 'WalletData',
+            },
+            'oracle_message': {
+              'description': '"oracleMessage" parameter of function "spend"',
+              'name': 'Oracle Message',
+              'type': 'WalletData',
+            },
+            'owner_pk': {
+              'description': '"ownerPk" parameter of this contract',
+              'name': 'Owner Pk',
+              'type': 'WalletData',
+            },
+            'oracle_pk': {
+              'description': '"oraclePk" parameter of this contract',
+              'name': 'Oracle Pk',
+              'type': 'WalletData',
+            },
+            'min_block': {
+              'description': '"minBlock" parameter of this contract',
+              'name': 'Min Block',
+              'type': 'WalletData',
+            },
+            'price_target': {
+              'description': '"priceTarget" parameter of this contract',
+              'name': 'Price Target',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'transfer_with_timeout_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Transfer With Timeout',
+          'scripts': [
+            'transfer_with_timeout_lock',
+            'transfer_with_timeout_timeout_unlock',
+          ],
+          'variables': {
+            'sender_sig': {
+              'description': '"senderSig" parameter of function "timeout"',
+              'name': 'Sender Sig',
+              'type': 'Key',
+            },
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'Sender',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'Recipient',
+              'type': 'WalletData',
+            },
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'Timeout',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'hodl_vault_spend_unlock': {
+          'passes': [
+            'hodl_vault_spend_evaluate',
+          ],
+          'name': 'spend',
+          'script': '// "spend" function parameters\n<oracle_message> // bytes8 = <0xa086010030750000>\n<oracle_sig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<owner_sig.schnorr_signature.all_outputs_all_utxos> // sig\n',
+          'unlocks': 'hodl_vault_lock',
+        },
+        'hodl_vault_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'HodlVault',
+          'script': '// "HodlVault" contract constructor parameters\n<price_target> // int = <0x3075>\n<min_block> // int = <0xb88201>\n<oracle_pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<owner_pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
+        },
+        'transfer_with_timeout_timeout_unlock': {
+          'passes': [
+            'transfer_with_timeout_timeout_evaluate',
+          ],
+          'name': 'timeout',
+          'script': '// "timeout" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'transfer_with_timeout_lock',
+        },
+        'transfer_with_timeout_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'TransferWithTimeout',
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+        },
+      },
+      'scenarios': {
+        'hodl_vault_spend_evaluate': {
+          'name': 'hodl_vault_spend_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'oracle_sig': '0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b',
+              'oracle_message': '0xa086010030750000',
+              'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'min_block': '0xb88201',
+              'price_target': '0x3075',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'owner_sig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': expect.any(Number),
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': expect.any(Number),
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 1000000,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'hodl_vault_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'min_block': '0xb88201',
+                      'price_target': '0x3075',
+                    },
+                  },
+                },
+                'valueSatoshis': 10000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+        'transfer_with_timeout_timeout_evaluate': {
+          'name': 'transfer_with_timeout_timeout_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+              'timeout': '0xa08601',
+              'function_index': '1',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'sender_sig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': expect.any(Number),
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': expect.any(Number),
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 1000000,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'hodl_vault_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'min_block': '0xb88201',
+                      'price_target': '0x3075',
+                    },
+                  },
+                },
+                'valueSatoshis': 10000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'hodl_vault_lock',
+                'overrides': {
+                  'bytecode': {
+                    'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                    'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'min_block': '0xb88201',
+                    'price_target': '0x3075',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
   {
     // TODO: Duplicate input scenarios with the same function call have the same name
     name: 'Duplicate function calls',
diff --git a/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts b/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts
index 9e388127..ee1e33a6 100644
--- a/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts
+++ b/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts
@@ -4,8 +4,8 @@ describe('Libauth Template generation tests (multi-contract)', () => {
   fixtures.forEach((fixture) => {
     it(`should generate a valid libauth template for ${fixture.name}`, async () => {
       const builder = await fixture.transaction;
-      const generatedTemplate = await builder.getLibauthTemplate();
-      // console.log(await builder.bitauthUri());
+      const generatedTemplate = builder.getLibauthTemplate();
+      // console.log(builder.bitauthUri());
       // console.log(JSON.stringify(generatedTemplate, null, 2));
       expect(generatedTemplate).toEqual(fixture.template);
     });

From f154c4914f1a44e2f1f8af5f2dd555f5efe612a8 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 3 Mar 2025 13:08:54 +0100
Subject: [PATCH 184/267] update supported VM in LibauthTemplates to
 BCH_2025_05

---
 packages/cashscript/src/LibauthTemplate.ts       |  2 +-
 .../cashscript/src/advanced/LibauthTemplate.ts   |  2 +-
 .../test/fixture/libauth-template/fixtures.ts    | 16 ++++++++--------
 .../libauth-template/multi-contract-fixtures.ts  |  8 ++++----
 4 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 70a04f98..0cafefa4 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -56,7 +56,7 @@ export const buildTemplate = async ({
     $schema: 'https://ide.bitauth.com/authentication-template-v0.schema.json',
     description: 'Imported from cashscript',
     name: 'CashScript Generated Debugging Template',
-    supported: ['BCH_2023_05'],
+    supported: ['BCH_2025_05'],
     version: 0,
     entities: generateTemplateEntities(contract.artifact, transaction.abiFunction, transaction.encodedFunctionArgs),
     scripts: generateTemplateScripts(
diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index f9d120d5..604d7940 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -369,7 +369,7 @@ export const getLibauthTemplates = (
     $schema: 'https://ide.bitauth.com/authentication-template-v0.schema.json',
     description: 'Imported from cashscript',
     name: 'CashScript Generated Debugging Template',
-    supported: ['BCH_2023_05'],
+    supported: ['BCH_2025_05'],
     version: 0,
     entities: {},
     scripts: {},
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index a00de46b..83ff63ef 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -33,7 +33,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -157,7 +157,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -281,7 +281,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -410,7 +410,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -550,7 +550,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -673,7 +673,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -821,7 +821,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -992,7 +992,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index 8986ed74..2f0c6776 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -61,7 +61,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -1113,7 +1113,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -1234,7 +1234,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {
@@ -1529,7 +1529,7 @@ export const fixtures: Fixture[] = [
       'description': 'Imported from cashscript',
       'name': 'CashScript Generated Debugging Template',
       'supported': [
-        'BCH_2023_05',
+        'BCH_2025_05',
       ],
       'version': 0,
       'entities': {

From 0ee8930eace60d9dd9b5018bc1e2d7dd78374e99 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 3 Mar 2025 13:23:03 +0100
Subject: [PATCH 185/267] update decodeInt() and corresponding test

---
 packages/utils/src/data.ts       | 2 +-
 packages/utils/test/data.test.ts | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/utils/src/data.ts b/packages/utils/src/data.ts
index 169f1695..7bd6881f 100644
--- a/packages/utils/src/data.ts
+++ b/packages/utils/src/data.ts
@@ -26,7 +26,7 @@ export function encodeInt(int: bigint): Uint8Array {
   return bigIntToVmNumber(int);
 }
 
-export function decodeInt(encodedInt: Uint8Array, maxLength: number = 8): bigint {
+export function decodeInt(encodedInt: Uint8Array, maxLength: number = Infinity): bigint {
   const options = { maximumVmNumberByteLength: maxLength };
   const result = vmNumberToBigInt(encodedInt, options);
 
diff --git a/packages/utils/test/data.test.ts b/packages/utils/test/data.test.ts
index 326c3856..813c2fe0 100644
--- a/packages/utils/test/data.test.ts
+++ b/packages/utils/test/data.test.ts
@@ -60,6 +60,7 @@ describe('data utils', () => {
       expect(decodeInt(hexToBin('e803'))).toEqual(1000n);
       expect(decodeInt(hexToBin('e883'))).toEqual(BigInt(-1000));
       expect(decodeInt(hexToBin('00407a10f35a'))).toEqual(100000000000000n);
+      expect(decodeInt(hexToBin('00000000000000000001'))).toEqual(4722366482869645213696n);
     });
 
     it('should throw if the integer is not minimally encoded', () => {
@@ -71,7 +72,7 @@ describe('data utils', () => {
 
     it('should throw if the integer is too large', () => {
       const expectedError = VmNumberError.outOfRange;
-      expect(() => decodeInt(hexToBin('00000000000000000001'))).toThrow(expectedError);
+      expect(() => decodeInt(hexToBin('00000000000000000001'), 8)).toThrow(expectedError);
       expect(() => decodeInt(hexToBin('000001'), 2)).toThrow(expectedError);
     });
   });

From 53fb662f56b947019cc23cc9b69b61667083244b Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 3 Mar 2025 15:00:23 +0100
Subject: [PATCH 186/267] remove accidentally committed test artifact

---
 packages/cashc/x.json | 78 -------------------------------------------
 1 file changed, 78 deletions(-)
 delete mode 100644 packages/cashc/x.json

diff --git a/packages/cashc/x.json b/packages/cashc/x.json
deleted file mode 100644
index 4c95ed84..00000000
--- a/packages/cashc/x.json
+++ /dev/null
@@ -1,78 +0,0 @@
-export default {
-  contractName: 'Mecenas',
-  constructorInputs: [
-    {
-      name: 'recipient',
-      type: 'bytes20',
-    },
-    {
-      name: 'funder',
-      type: 'bytes20',
-    },
-    {
-      name: 'pledge',
-      type: 'int',
-    },
-  ],
-  abi: [
-    {
-      name: 'receive',
-      inputs: [],
-    },
-    {
-      name: 'reclaim',
-      inputs: [
-        {
-          name: 'pk',
-          type: 'pubkey',
-        },
-        {
-          name: 's',
-          type: 'sig',
-        },
-      ],
-    },
-  ],
-  bytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
-  source: 'pragma cashscript >=0.10.0;\n\n/* This is an unofficial CashScript port of Licho\'s Mecenas contract. It is\n * not compatible with Licho\'s EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(tx.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n',
-  debug: {
-    bytecode: '5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768',
-    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
-    logs: [],
-    requires: [
-      {
-        ip: 17,
-        line: 13,
-      },
-      {
-        ip: 46,
-        line: 22,
-      },
-      {
-        ip: 53,
-        line: 24,
-      },
-      {
-        ip: 59,
-        line: 25,
-      },
-      {
-        ip: 65,
-        line: 26,
-      },
-      {
-        ip: 86,
-        line: 31,
-      },
-      {
-        ip: 92,
-        line: 32,
-      },
-    ],
-  },
-  compiler: {
-    name: 'cashc',
-    version: '0.11.0-next.0',
-  },
-  updatedAt: '2025-01-21T10:30:20.052Z',
-} as const;

From b97cdc204e062485539c295762678abf6173ab68 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Tue, 4 Mar 2025 10:28:09 +0100
Subject: [PATCH 187/267] rename tx.age to this.age (#288)

* rename tx.age to this.age
* update grammar docs
* Update generated antlr files
* Recompile fixture contracts after this.age update
* Update cashc tests for new this.age syntax

---------

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
---
 examples/mecenas.cash                         |   2 +-
 packages/cashc/src/ast/Globals.ts             |   2 +-
 packages/cashc/src/grammar/CashScript.g4      |   2 +-
 .../cashc/src/grammar/CashScriptLexer.interp  |   2 +-
 packages/cashc/src/grammar/CashScriptLexer.ts | 220 +++++++++---------
 packages/cashc/test/ast/Location.test.ts      |   2 +-
 packages/cashc/test/generation/fixtures.ts    |   4 +-
 .../test/valid-contract-files/everything.cash |   2 +-
 .../test/valid-contract-files/mecenas.cash    |   2 +-
 packages/cashscript/test/e2e/Mecenas.test.ts  |   2 +-
 .../test/fixture/bigint.artifact.ts           |   6 +-
 packages/cashscript/test/fixture/bigint.json  |   6 +-
 .../test/fixture/libauth-template/fixtures.ts |   2 +-
 .../test/fixture/mecenas.artifact.ts          |   6 +-
 packages/cashscript/test/fixture/mecenas.cash |   2 +-
 packages/cashscript/test/fixture/mecenas.json |   6 +-
 .../test/fixtures/bitauth-script.fixture.ts   |   4 +-
 website/docs/compiler/grammar.md              |  17 +-
 website/docs/guides/covenants.md              |   8 +-
 website/docs/language/examples.md             |   4 +-
 website/docs/language/globals.md              |  18 +-
 website/docs/releases/release-notes.md        |   1 +
 22 files changed, 163 insertions(+), 157 deletions(-)

diff --git a/examples/mecenas.cash b/examples/mecenas.cash
index 268c4cf7..5ac228cc 100644
--- a/examples/mecenas.cash
+++ b/examples/mecenas.cash
@@ -7,7 +7,7 @@ pragma cashscript ^0.10.0;
  */
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {
     function receive() {
-        // require(tx.age >= period);
+        // require(this.age >= period);
 
         // Check that the first output sends to the recipient
         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));
diff --git a/packages/cashc/src/ast/Globals.ts b/packages/cashc/src/ast/Globals.ts
index 4a09951a..cec809e4 100644
--- a/packages/cashc/src/ast/Globals.ts
+++ b/packages/cashc/src/ast/Globals.ts
@@ -30,7 +30,7 @@ export enum GlobalFunction {
 }
 
 export enum TimeOp {
-  CHECK_SEQUENCE = 'tx.age',
+  CHECK_SEQUENCE = 'this.age',
   CHECK_LOCKTIME = 'tx.time',
 }
 
diff --git a/packages/cashc/src/grammar/CashScript.g4 b/packages/cashc/src/grammar/CashScript.g4
index eec1fb9f..b20c0b83 100644
--- a/packages/cashc/src/grammar/CashScript.g4
+++ b/packages/cashc/src/grammar/CashScript.g4
@@ -198,7 +198,7 @@ HexLiteral
     ;
 
 TxVar
-    : 'tx.age'
+    : 'this.age'
     | 'tx.time'
     ;
 
diff --git a/packages/cashc/src/grammar/CashScriptLexer.interp b/packages/cashc/src/grammar/CashScriptLexer.interp
index e1f0983f..7c142a52 100644
--- a/packages/cashc/src/grammar/CashScriptLexer.interp
+++ b/packages/cashc/src/grammar/CashScriptLexer.interp
@@ -236,4 +236,4 @@ mode names:
 DEFAULT_MODE
 
 atn:
-[4, 0, 74, 834, 6, -1, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 2, 25, 7, 25, 2, 26, 7, 26, 2, 27, 7, 27, 2, 28, 7, 28, 2, 29, 7, 29, 2, 30, 7, 30, 2, 31, 7, 31, 2, 32, 7, 32, 2, 33, 7, 33, 2, 34, 7, 34, 2, 35, 7, 35, 2, 36, 7, 36, 2, 37, 7, 37, 2, 38, 7, 38, 2, 39, 7, 39, 2, 40, 7, 40, 2, 41, 7, 41, 2, 42, 7, 42, 2, 43, 7, 43, 2, 44, 7, 44, 2, 45, 7, 45, 2, 46, 7, 46, 2, 47, 7, 47, 2, 48, 7, 48, 2, 49, 7, 49, 2, 50, 7, 50, 2, 51, 7, 51, 2, 52, 7, 52, 2, 53, 7, 53, 2, 54, 7, 54, 2, 55, 7, 55, 2, 56, 7, 56, 2, 57, 7, 57, 2, 58, 7, 58, 2, 59, 7, 59, 2, 60, 7, 60, 2, 61, 7, 61, 2, 62, 7, 62, 2, 63, 7, 63, 2, 64, 7, 64, 2, 65, 7, 65, 2, 66, 7, 66, 2, 67, 7, 67, 2, 68, 7, 68, 2, 69, 7, 69, 2, 70, 7, 70, 2, 71, 7, 71, 2, 72, 7, 72, 2, 73, 7, 73, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 3, 1, 3, 1, 4, 1, 4, 1, 5, 1, 5, 1, 5, 1, 6, 1, 6, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 11, 1, 11, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 15, 1, 15, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 19, 1, 19, 1, 19, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 21, 1, 21, 1, 21, 1, 21, 1, 22, 1, 22, 1, 23, 1, 23, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 38, 1, 38, 1, 39, 1, 39, 1, 40, 1, 40, 1, 41, 1, 41, 1, 42, 1, 42, 1, 43, 1, 43, 1, 44, 1, 44, 1, 44, 1, 45, 1, 45, 1, 45, 1, 46, 1, 46, 1, 47, 1, 47, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49, 1, 49, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 51, 1, 51, 1, 51, 1, 51, 1, 52, 1, 52, 1, 52, 1, 52, 1, 52, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 55, 1, 55, 1, 55, 1, 55, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 57, 4, 57, 512, 8, 57, 11, 57, 12, 57, 513, 1, 57, 1, 57, 4, 57, 518, 8, 57, 11, 57, 12, 57, 519, 1, 57, 1, 57, 4, 57, 524, 8, 57, 11, 57, 12, 57, 525, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 3, 58, 537, 8, 58, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 3, 59, 596, 8, 59, 1, 60, 3, 60, 599, 8, 60, 1, 60, 1, 60, 3, 60, 603, 8, 60, 1, 61, 4, 61, 606, 8, 61, 11, 61, 12, 61, 607, 1, 61, 1, 61, 4, 61, 612, 8, 61, 11, 61, 12, 61, 613, 5, 61, 616, 8, 61, 10, 61, 12, 61, 619, 9, 61, 1, 62, 1, 62, 1, 62, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 3, 63, 631, 8, 63, 1, 63, 1, 63, 1, 63, 1, 63, 3, 63, 637, 8, 63, 1, 64, 1, 64, 5, 64, 641, 8, 64, 10, 64, 12, 64, 644, 9, 64, 1, 65, 1, 65, 1, 65, 1, 65, 5, 65, 650, 8, 65, 10, 65, 12, 65, 653, 9, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 5, 65, 660, 8, 65, 10, 65, 12, 65, 663, 9, 65, 1, 65, 3, 65, 666, 8, 65, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 67, 1, 67, 1, 67, 5, 67, 680, 8, 67, 10, 67, 12, 67, 683, 9, 67, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 3, 68, 698, 8, 68, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 3, 69, 794, 8, 69, 1, 70, 1, 70, 5, 70, 798, 8, 70, 10, 70, 12, 70, 801, 9, 70, 1, 71, 4, 71, 804, 8, 71, 11, 71, 12, 71, 805, 1, 71, 1, 71, 1, 72, 1, 72, 1, 72, 1, 72, 5, 72, 814, 8, 72, 10, 72, 12, 72, 817, 9, 72, 1, 72, 1, 72, 1, 72, 1, 72, 1, 72, 1, 73, 1, 73, 1, 73, 1, 73, 5, 73, 828, 8, 73, 10, 73, 12, 73, 831, 9, 73, 1, 73, 1, 73, 3, 651, 661, 815, 0, 74, 1, 1, 3, 2, 5, 3, 7, 4, 9, 5, 11, 6, 13, 7, 15, 8, 17, 9, 19, 10, 21, 11, 23, 12, 25, 13, 27, 14, 29, 15, 31, 16, 33, 17, 35, 18, 37, 19, 39, 20, 41, 21, 43, 22, 45, 23, 47, 24, 49, 25, 51, 26, 53, 27, 55, 28, 57, 29, 59, 30, 61, 31, 63, 32, 65, 33, 67, 34, 69, 35, 71, 36, 73, 37, 75, 38, 77, 39, 79, 40, 81, 41, 83, 42, 85, 43, 87, 44, 89, 45, 91, 46, 93, 47, 95, 48, 97, 49, 99, 50, 101, 51, 103, 52, 105, 53, 107, 54, 109, 55, 111, 56, 113, 57, 115, 58, 117, 59, 119, 60, 121, 61, 123, 62, 125, 63, 127, 64, 129, 65, 131, 66, 133, 67, 135, 68, 137, 69, 139, 70, 141, 71, 143, 72, 145, 73, 147, 74, 1, 0, 11, 1, 0, 48, 57, 2, 0, 69, 69, 101, 101, 1, 0, 49, 57, 3, 0, 10, 10, 13, 13, 34, 34, 3, 0, 10, 10, 13, 13, 39, 39, 2, 0, 88, 88, 120, 120, 3, 0, 48, 57, 65, 70, 97, 102, 2, 0, 65, 90, 97, 122, 4, 0, 48, 57, 65, 90, 95, 95, 97, 122, 3, 0, 9, 10, 12, 13, 32, 32, 2, 0, 10, 10, 13, 13, 870, 0, 1, 1, 0, 0, 0, 0, 3, 1, 0, 0, 0, 0, 5, 1, 0, 0, 0, 0, 7, 1, 0, 0, 0, 0, 9, 1, 0, 0, 0, 0, 11, 1, 0, 0, 0, 0, 13, 1, 0, 0, 0, 0, 15, 1, 0, 0, 0, 0, 17, 1, 0, 0, 0, 0, 19, 1, 0, 0, 0, 0, 21, 1, 0, 0, 0, 0, 23, 1, 0, 0, 0, 0, 25, 1, 0, 0, 0, 0, 27, 1, 0, 0, 0, 0, 29, 1, 0, 0, 0, 0, 31, 1, 0, 0, 0, 0, 33, 1, 0, 0, 0, 0, 35, 1, 0, 0, 0, 0, 37, 1, 0, 0, 0, 0, 39, 1, 0, 0, 0, 0, 41, 1, 0, 0, 0, 0, 43, 1, 0, 0, 0, 0, 45, 1, 0, 0, 0, 0, 47, 1, 0, 0, 0, 0, 49, 1, 0, 0, 0, 0, 51, 1, 0, 0, 0, 0, 53, 1, 0, 0, 0, 0, 55, 1, 0, 0, 0, 0, 57, 1, 0, 0, 0, 0, 59, 1, 0, 0, 0, 0, 61, 1, 0, 0, 0, 0, 63, 1, 0, 0, 0, 0, 65, 1, 0, 0, 0, 0, 67, 1, 0, 0, 0, 0, 69, 1, 0, 0, 0, 0, 71, 1, 0, 0, 0, 0, 73, 1, 0, 0, 0, 0, 75, 1, 0, 0, 0, 0, 77, 1, 0, 0, 0, 0, 79, 1, 0, 0, 0, 0, 81, 1, 0, 0, 0, 0, 83, 1, 0, 0, 0, 0, 85, 1, 0, 0, 0, 0, 87, 1, 0, 0, 0, 0, 89, 1, 0, 0, 0, 0, 91, 1, 0, 0, 0, 0, 93, 1, 0, 0, 0, 0, 95, 1, 0, 0, 0, 0, 97, 1, 0, 0, 0, 0, 99, 1, 0, 0, 0, 0, 101, 1, 0, 0, 0, 0, 103, 1, 0, 0, 0, 0, 105, 1, 0, 0, 0, 0, 107, 1, 0, 0, 0, 0, 109, 1, 0, 0, 0, 0, 111, 1, 0, 0, 0, 0, 113, 1, 0, 0, 0, 0, 115, 1, 0, 0, 0, 0, 117, 1, 0, 0, 0, 0, 119, 1, 0, 0, 0, 0, 121, 1, 0, 0, 0, 0, 123, 1, 0, 0, 0, 0, 125, 1, 0, 0, 0, 0, 127, 1, 0, 0, 0, 0, 129, 1, 0, 0, 0, 0, 131, 1, 0, 0, 0, 0, 133, 1, 0, 0, 0, 0, 135, 1, 0, 0, 0, 0, 137, 1, 0, 0, 0, 0, 139, 1, 0, 0, 0, 0, 141, 1, 0, 0, 0, 0, 143, 1, 0, 0, 0, 0, 145, 1, 0, 0, 0, 0, 147, 1, 0, 0, 0, 1, 149, 1, 0, 0, 0, 3, 156, 1, 0, 0, 0, 5, 158, 1, 0, 0, 0, 7, 169, 1, 0, 0, 0, 9, 171, 1, 0, 0, 0, 11, 173, 1, 0, 0, 0, 13, 176, 1, 0, 0, 0, 15, 178, 1, 0, 0, 0, 17, 180, 1, 0, 0, 0, 19, 183, 1, 0, 0, 0, 21, 185, 1, 0, 0, 0, 23, 194, 1, 0, 0, 0, 25, 196, 1, 0, 0, 0, 27, 198, 1, 0, 0, 0, 29, 207, 1, 0, 0, 0, 31, 209, 1, 0, 0, 0, 33, 211, 1, 0, 0, 0, 35, 213, 1, 0, 0, 0, 37, 221, 1, 0, 0, 0, 39, 224, 1, 0, 0, 0, 41, 229, 1, 0, 0, 0, 43, 241, 1, 0, 0, 0, 45, 245, 1, 0, 0, 0, 47, 247, 1, 0, 0, 0, 49, 249, 1, 0, 0, 0, 51, 260, 1, 0, 0, 0, 53, 267, 1, 0, 0, 0, 55, 284, 1, 0, 0, 0, 57, 299, 1, 0, 0, 0, 59, 314, 1, 0, 0, 0, 61, 327, 1, 0, 0, 0, 63, 337, 1, 0, 0, 0, 65, 362, 1, 0, 0, 0, 67, 377, 1, 0, 0, 0, 69, 396, 1, 0, 0, 0, 71, 412, 1, 0, 0, 0, 73, 423, 1, 0, 0, 0, 75, 431, 1, 0, 0, 0, 77, 438, 1, 0, 0, 0, 79, 440, 1, 0, 0, 0, 81, 442, 1, 0, 0, 0, 83, 444, 1, 0, 0, 0, 85, 446, 1, 0, 0, 0, 87, 448, 1, 0, 0, 0, 89, 450, 1, 0, 0, 0, 91, 453, 1, 0, 0, 0, 93, 456, 1, 0, 0, 0, 95, 458, 1, 0, 0, 0, 97, 460, 1, 0, 0, 0, 99, 463, 1, 0, 0, 0, 101, 466, 1, 0, 0, 0, 103, 475, 1, 0, 0, 0, 105, 479, 1, 0, 0, 0, 107, 484, 1, 0, 0, 0, 109, 491, 1, 0, 0, 0, 111, 498, 1, 0, 0, 0, 113, 502, 1, 0, 0, 0, 115, 511, 1, 0, 0, 0, 117, 536, 1, 0, 0, 0, 119, 595, 1, 0, 0, 0, 121, 598, 1, 0, 0, 0, 123, 605, 1, 0, 0, 0, 125, 620, 1, 0, 0, 0, 127, 636, 1, 0, 0, 0, 129, 638, 1, 0, 0, 0, 131, 665, 1, 0, 0, 0, 133, 667, 1, 0, 0, 0, 135, 676, 1, 0, 0, 0, 137, 697, 1, 0, 0, 0, 139, 793, 1, 0, 0, 0, 141, 795, 1, 0, 0, 0, 143, 803, 1, 0, 0, 0, 145, 809, 1, 0, 0, 0, 147, 823, 1, 0, 0, 0, 149, 150, 5, 112, 0, 0, 150, 151, 5, 114, 0, 0, 151, 152, 5, 97, 0, 0, 152, 153, 5, 103, 0, 0, 153, 154, 5, 109, 0, 0, 154, 155, 5, 97, 0, 0, 155, 2, 1, 0, 0, 0, 156, 157, 5, 59, 0, 0, 157, 4, 1, 0, 0, 0, 158, 159, 5, 99, 0, 0, 159, 160, 5, 97, 0, 0, 160, 161, 5, 115, 0, 0, 161, 162, 5, 104, 0, 0, 162, 163, 5, 115, 0, 0, 163, 164, 5, 99, 0, 0, 164, 165, 5, 114, 0, 0, 165, 166, 5, 105, 0, 0, 166, 167, 5, 112, 0, 0, 167, 168, 5, 116, 0, 0, 168, 6, 1, 0, 0, 0, 169, 170, 5, 94, 0, 0, 170, 8, 1, 0, 0, 0, 171, 172, 5, 126, 0, 0, 172, 10, 1, 0, 0, 0, 173, 174, 5, 62, 0, 0, 174, 175, 5, 61, 0, 0, 175, 12, 1, 0, 0, 0, 176, 177, 5, 62, 0, 0, 177, 14, 1, 0, 0, 0, 178, 179, 5, 60, 0, 0, 179, 16, 1, 0, 0, 0, 180, 181, 5, 60, 0, 0, 181, 182, 5, 61, 0, 0, 182, 18, 1, 0, 0, 0, 183, 184, 5, 61, 0, 0, 184, 20, 1, 0, 0, 0, 185, 186, 5, 99, 0, 0, 186, 187, 5, 111, 0, 0, 187, 188, 5, 110, 0, 0, 188, 189, 5, 116, 0, 0, 189, 190, 5, 114, 0, 0, 190, 191, 5, 97, 0, 0, 191, 192, 5, 99, 0, 0, 192, 193, 5, 116, 0, 0, 193, 22, 1, 0, 0, 0, 194, 195, 5, 123, 0, 0, 195, 24, 1, 0, 0, 0, 196, 197, 5, 125, 0, 0, 197, 26, 1, 0, 0, 0, 198, 199, 5, 102, 0, 0, 199, 200, 5, 117, 0, 0, 200, 201, 5, 110, 0, 0, 201, 202, 5, 99, 0, 0, 202, 203, 5, 116, 0, 0, 203, 204, 5, 105, 0, 0, 204, 205, 5, 111, 0, 0, 205, 206, 5, 110, 0, 0, 206, 28, 1, 0, 0, 0, 207, 208, 5, 40, 0, 0, 208, 30, 1, 0, 0, 0, 209, 210, 5, 44, 0, 0, 210, 32, 1, 0, 0, 0, 211, 212, 5, 41, 0, 0, 212, 34, 1, 0, 0, 0, 213, 214, 5, 114, 0, 0, 214, 215, 5, 101, 0, 0, 215, 216, 5, 113, 0, 0, 216, 217, 5, 117, 0, 0, 217, 218, 5, 105, 0, 0, 218, 219, 5, 114, 0, 0, 219, 220, 5, 101, 0, 0, 220, 36, 1, 0, 0, 0, 221, 222, 5, 105, 0, 0, 222, 223, 5, 102, 0, 0, 223, 38, 1, 0, 0, 0, 224, 225, 5, 101, 0, 0, 225, 226, 5, 108, 0, 0, 226, 227, 5, 115, 0, 0, 227, 228, 5, 101, 0, 0, 228, 40, 1, 0, 0, 0, 229, 230, 5, 99, 0, 0, 230, 231, 5, 111, 0, 0, 231, 232, 5, 110, 0, 0, 232, 233, 5, 115, 0, 0, 233, 234, 5, 111, 0, 0, 234, 235, 5, 108, 0, 0, 235, 236, 5, 101, 0, 0, 236, 237, 5, 46, 0, 0, 237, 238, 5, 108, 0, 0, 238, 239, 5, 111, 0, 0, 239, 240, 5, 103, 0, 0, 240, 42, 1, 0, 0, 0, 241, 242, 5, 110, 0, 0, 242, 243, 5, 101, 0, 0, 243, 244, 5, 119, 0, 0, 244, 44, 1, 0, 0, 0, 245, 246, 5, 91, 0, 0, 246, 46, 1, 0, 0, 0, 247, 248, 5, 93, 0, 0, 248, 48, 1, 0, 0, 0, 249, 250, 5, 116, 0, 0, 250, 251, 5, 120, 0, 0, 251, 252, 5, 46, 0, 0, 252, 253, 5, 111, 0, 0, 253, 254, 5, 117, 0, 0, 254, 255, 5, 116, 0, 0, 255, 256, 5, 112, 0, 0, 256, 257, 5, 117, 0, 0, 257, 258, 5, 116, 0, 0, 258, 259, 5, 115, 0, 0, 259, 50, 1, 0, 0, 0, 260, 261, 5, 46, 0, 0, 261, 262, 5, 118, 0, 0, 262, 263, 5, 97, 0, 0, 263, 264, 5, 108, 0, 0, 264, 265, 5, 117, 0, 0, 265, 266, 5, 101, 0, 0, 266, 52, 1, 0, 0, 0, 267, 268, 5, 46, 0, 0, 268, 269, 5, 108, 0, 0, 269, 270, 5, 111, 0, 0, 270, 271, 5, 99, 0, 0, 271, 272, 5, 107, 0, 0, 272, 273, 5, 105, 0, 0, 273, 274, 5, 110, 0, 0, 274, 275, 5, 103, 0, 0, 275, 276, 5, 66, 0, 0, 276, 277, 5, 121, 0, 0, 277, 278, 5, 116, 0, 0, 278, 279, 5, 101, 0, 0, 279, 280, 5, 99, 0, 0, 280, 281, 5, 111, 0, 0, 281, 282, 5, 100, 0, 0, 282, 283, 5, 101, 0, 0, 283, 54, 1, 0, 0, 0, 284, 285, 5, 46, 0, 0, 285, 286, 5, 116, 0, 0, 286, 287, 5, 111, 0, 0, 287, 288, 5, 107, 0, 0, 288, 289, 5, 101, 0, 0, 289, 290, 5, 110, 0, 0, 290, 291, 5, 67, 0, 0, 291, 292, 5, 97, 0, 0, 292, 293, 5, 116, 0, 0, 293, 294, 5, 101, 0, 0, 294, 295, 5, 103, 0, 0, 295, 296, 5, 111, 0, 0, 296, 297, 5, 114, 0, 0, 297, 298, 5, 121, 0, 0, 298, 56, 1, 0, 0, 0, 299, 300, 5, 46, 0, 0, 300, 301, 5, 110, 0, 0, 301, 302, 5, 102, 0, 0, 302, 303, 5, 116, 0, 0, 303, 304, 5, 67, 0, 0, 304, 305, 5, 111, 0, 0, 305, 306, 5, 109, 0, 0, 306, 307, 5, 109, 0, 0, 307, 308, 5, 105, 0, 0, 308, 309, 5, 116, 0, 0, 309, 310, 5, 109, 0, 0, 310, 311, 5, 101, 0, 0, 311, 312, 5, 110, 0, 0, 312, 313, 5, 116, 0, 0, 313, 58, 1, 0, 0, 0, 314, 315, 5, 46, 0, 0, 315, 316, 5, 116, 0, 0, 316, 317, 5, 111, 0, 0, 317, 318, 5, 107, 0, 0, 318, 319, 5, 101, 0, 0, 319, 320, 5, 110, 0, 0, 320, 321, 5, 65, 0, 0, 321, 322, 5, 109, 0, 0, 322, 323, 5, 111, 0, 0, 323, 324, 5, 117, 0, 0, 324, 325, 5, 110, 0, 0, 325, 326, 5, 116, 0, 0, 326, 60, 1, 0, 0, 0, 327, 328, 5, 116, 0, 0, 328, 329, 5, 120, 0, 0, 329, 330, 5, 46, 0, 0, 330, 331, 5, 105, 0, 0, 331, 332, 5, 110, 0, 0, 332, 333, 5, 112, 0, 0, 333, 334, 5, 117, 0, 0, 334, 335, 5, 116, 0, 0, 335, 336, 5, 115, 0, 0, 336, 62, 1, 0, 0, 0, 337, 338, 5, 46, 0, 0, 338, 339, 5, 111, 0, 0, 339, 340, 5, 117, 0, 0, 340, 341, 5, 116, 0, 0, 341, 342, 5, 112, 0, 0, 342, 343, 5, 111, 0, 0, 343, 344, 5, 105, 0, 0, 344, 345, 5, 110, 0, 0, 345, 346, 5, 116, 0, 0, 346, 347, 5, 84, 0, 0, 347, 348, 5, 114, 0, 0, 348, 349, 5, 97, 0, 0, 349, 350, 5, 110, 0, 0, 350, 351, 5, 115, 0, 0, 351, 352, 5, 97, 0, 0, 352, 353, 5, 99, 0, 0, 353, 354, 5, 116, 0, 0, 354, 355, 5, 105, 0, 0, 355, 356, 5, 111, 0, 0, 356, 357, 5, 110, 0, 0, 357, 358, 5, 72, 0, 0, 358, 359, 5, 97, 0, 0, 359, 360, 5, 115, 0, 0, 360, 361, 5, 104, 0, 0, 361, 64, 1, 0, 0, 0, 362, 363, 5, 46, 0, 0, 363, 364, 5, 111, 0, 0, 364, 365, 5, 117, 0, 0, 365, 366, 5, 116, 0, 0, 366, 367, 5, 112, 0, 0, 367, 368, 5, 111, 0, 0, 368, 369, 5, 105, 0, 0, 369, 370, 5, 110, 0, 0, 370, 371, 5, 116, 0, 0, 371, 372, 5, 73, 0, 0, 372, 373, 5, 110, 0, 0, 373, 374, 5, 100, 0, 0, 374, 375, 5, 101, 0, 0, 375, 376, 5, 120, 0, 0, 376, 66, 1, 0, 0, 0, 377, 378, 5, 46, 0, 0, 378, 379, 5, 117, 0, 0, 379, 380, 5, 110, 0, 0, 380, 381, 5, 108, 0, 0, 381, 382, 5, 111, 0, 0, 382, 383, 5, 99, 0, 0, 383, 384, 5, 107, 0, 0, 384, 385, 5, 105, 0, 0, 385, 386, 5, 110, 0, 0, 386, 387, 5, 103, 0, 0, 387, 388, 5, 66, 0, 0, 388, 389, 5, 121, 0, 0, 389, 390, 5, 116, 0, 0, 390, 391, 5, 101, 0, 0, 391, 392, 5, 99, 0, 0, 392, 393, 5, 111, 0, 0, 393, 394, 5, 100, 0, 0, 394, 395, 5, 101, 0, 0, 395, 68, 1, 0, 0, 0, 396, 397, 5, 46, 0, 0, 397, 398, 5, 115, 0, 0, 398, 399, 5, 101, 0, 0, 399, 400, 5, 113, 0, 0, 400, 401, 5, 117, 0, 0, 401, 402, 5, 101, 0, 0, 402, 403, 5, 110, 0, 0, 403, 404, 5, 99, 0, 0, 404, 405, 5, 101, 0, 0, 405, 406, 5, 78, 0, 0, 406, 407, 5, 117, 0, 0, 407, 408, 5, 109, 0, 0, 408, 409, 5, 98, 0, 0, 409, 410, 5, 101, 0, 0, 410, 411, 5, 114, 0, 0, 411, 70, 1, 0, 0, 0, 412, 413, 5, 46, 0, 0, 413, 414, 5, 114, 0, 0, 414, 415, 5, 101, 0, 0, 415, 416, 5, 118, 0, 0, 416, 417, 5, 101, 0, 0, 417, 418, 5, 114, 0, 0, 418, 419, 5, 115, 0, 0, 419, 420, 5, 101, 0, 0, 420, 421, 5, 40, 0, 0, 421, 422, 5, 41, 0, 0, 422, 72, 1, 0, 0, 0, 423, 424, 5, 46, 0, 0, 424, 425, 5, 108, 0, 0, 425, 426, 5, 101, 0, 0, 426, 427, 5, 110, 0, 0, 427, 428, 5, 103, 0, 0, 428, 429, 5, 116, 0, 0, 429, 430, 5, 104, 0, 0, 430, 74, 1, 0, 0, 0, 431, 432, 5, 46, 0, 0, 432, 433, 5, 115, 0, 0, 433, 434, 5, 112, 0, 0, 434, 435, 5, 108, 0, 0, 435, 436, 5, 105, 0, 0, 436, 437, 5, 116, 0, 0, 437, 76, 1, 0, 0, 0, 438, 439, 5, 33, 0, 0, 439, 78, 1, 0, 0, 0, 440, 441, 5, 45, 0, 0, 441, 80, 1, 0, 0, 0, 442, 443, 5, 42, 0, 0, 443, 82, 1, 0, 0, 0, 444, 445, 5, 47, 0, 0, 445, 84, 1, 0, 0, 0, 446, 447, 5, 37, 0, 0, 447, 86, 1, 0, 0, 0, 448, 449, 5, 43, 0, 0, 449, 88, 1, 0, 0, 0, 450, 451, 5, 61, 0, 0, 451, 452, 5, 61, 0, 0, 452, 90, 1, 0, 0, 0, 453, 454, 5, 33, 0, 0, 454, 455, 5, 61, 0, 0, 455, 92, 1, 0, 0, 0, 456, 457, 5, 38, 0, 0, 457, 94, 1, 0, 0, 0, 458, 459, 5, 124, 0, 0, 459, 96, 1, 0, 0, 0, 460, 461, 5, 38, 0, 0, 461, 462, 5, 38, 0, 0, 462, 98, 1, 0, 0, 0, 463, 464, 5, 124, 0, 0, 464, 465, 5, 124, 0, 0, 465, 100, 1, 0, 0, 0, 466, 467, 5, 99, 0, 0, 467, 468, 5, 111, 0, 0, 468, 469, 5, 110, 0, 0, 469, 470, 5, 115, 0, 0, 470, 471, 5, 116, 0, 0, 471, 472, 5, 97, 0, 0, 472, 473, 5, 110, 0, 0, 473, 474, 5, 116, 0, 0, 474, 102, 1, 0, 0, 0, 475, 476, 5, 105, 0, 0, 476, 477, 5, 110, 0, 0, 477, 478, 5, 116, 0, 0, 478, 104, 1, 0, 0, 0, 479, 480, 5, 98, 0, 0, 480, 481, 5, 111, 0, 0, 481, 482, 5, 111, 0, 0, 482, 483, 5, 108, 0, 0, 483, 106, 1, 0, 0, 0, 484, 485, 5, 115, 0, 0, 485, 486, 5, 116, 0, 0, 486, 487, 5, 114, 0, 0, 487, 488, 5, 105, 0, 0, 488, 489, 5, 110, 0, 0, 489, 490, 5, 103, 0, 0, 490, 108, 1, 0, 0, 0, 491, 492, 5, 112, 0, 0, 492, 493, 5, 117, 0, 0, 493, 494, 5, 98, 0, 0, 494, 495, 5, 107, 0, 0, 495, 496, 5, 101, 0, 0, 496, 497, 5, 121, 0, 0, 497, 110, 1, 0, 0, 0, 498, 499, 5, 115, 0, 0, 499, 500, 5, 105, 0, 0, 500, 501, 5, 103, 0, 0, 501, 112, 1, 0, 0, 0, 502, 503, 5, 100, 0, 0, 503, 504, 5, 97, 0, 0, 504, 505, 5, 116, 0, 0, 505, 506, 5, 97, 0, 0, 506, 507, 5, 115, 0, 0, 507, 508, 5, 105, 0, 0, 508, 509, 5, 103, 0, 0, 509, 114, 1, 0, 0, 0, 510, 512, 7, 0, 0, 0, 511, 510, 1, 0, 0, 0, 512, 513, 1, 0, 0, 0, 513, 511, 1, 0, 0, 0, 513, 514, 1, 0, 0, 0, 514, 515, 1, 0, 0, 0, 515, 517, 5, 46, 0, 0, 516, 518, 7, 0, 0, 0, 517, 516, 1, 0, 0, 0, 518, 519, 1, 0, 0, 0, 519, 517, 1, 0, 0, 0, 519, 520, 1, 0, 0, 0, 520, 521, 1, 0, 0, 0, 521, 523, 5, 46, 0, 0, 522, 524, 7, 0, 0, 0, 523, 522, 1, 0, 0, 0, 524, 525, 1, 0, 0, 0, 525, 523, 1, 0, 0, 0, 525, 526, 1, 0, 0, 0, 526, 116, 1, 0, 0, 0, 527, 528, 5, 116, 0, 0, 528, 529, 5, 114, 0, 0, 529, 530, 5, 117, 0, 0, 530, 537, 5, 101, 0, 0, 531, 532, 5, 102, 0, 0, 532, 533, 5, 97, 0, 0, 533, 534, 5, 108, 0, 0, 534, 535, 5, 115, 0, 0, 535, 537, 5, 101, 0, 0, 536, 527, 1, 0, 0, 0, 536, 531, 1, 0, 0, 0, 537, 118, 1, 0, 0, 0, 538, 539, 5, 115, 0, 0, 539, 540, 5, 97, 0, 0, 540, 541, 5, 116, 0, 0, 541, 542, 5, 111, 0, 0, 542, 543, 5, 115, 0, 0, 543, 544, 5, 104, 0, 0, 544, 545, 5, 105, 0, 0, 545, 596, 5, 115, 0, 0, 546, 547, 5, 115, 0, 0, 547, 548, 5, 97, 0, 0, 548, 549, 5, 116, 0, 0, 549, 596, 5, 115, 0, 0, 550, 551, 5, 102, 0, 0, 551, 552, 5, 105, 0, 0, 552, 553, 5, 110, 0, 0, 553, 554, 5, 110, 0, 0, 554, 555, 5, 101, 0, 0, 555, 596, 5, 121, 0, 0, 556, 557, 5, 98, 0, 0, 557, 558, 5, 105, 0, 0, 558, 559, 5, 116, 0, 0, 559, 596, 5, 115, 0, 0, 560, 561, 5, 98, 0, 0, 561, 562, 5, 105, 0, 0, 562, 563, 5, 116, 0, 0, 563, 564, 5, 99, 0, 0, 564, 565, 5, 111, 0, 0, 565, 566, 5, 105, 0, 0, 566, 596, 5, 110, 0, 0, 567, 568, 5, 115, 0, 0, 568, 569, 5, 101, 0, 0, 569, 570, 5, 99, 0, 0, 570, 571, 5, 111, 0, 0, 571, 572, 5, 110, 0, 0, 572, 573, 5, 100, 0, 0, 573, 596, 5, 115, 0, 0, 574, 575, 5, 109, 0, 0, 575, 576, 5, 105, 0, 0, 576, 577, 5, 110, 0, 0, 577, 578, 5, 117, 0, 0, 578, 579, 5, 116, 0, 0, 579, 580, 5, 101, 0, 0, 580, 596, 5, 115, 0, 0, 581, 582, 5, 104, 0, 0, 582, 583, 5, 111, 0, 0, 583, 584, 5, 117, 0, 0, 584, 585, 5, 114, 0, 0, 585, 596, 5, 115, 0, 0, 586, 587, 5, 100, 0, 0, 587, 588, 5, 97, 0, 0, 588, 589, 5, 121, 0, 0, 589, 596, 5, 115, 0, 0, 590, 591, 5, 119, 0, 0, 591, 592, 5, 101, 0, 0, 592, 593, 5, 101, 0, 0, 593, 594, 5, 107, 0, 0, 594, 596, 5, 115, 0, 0, 595, 538, 1, 0, 0, 0, 595, 546, 1, 0, 0, 0, 595, 550, 1, 0, 0, 0, 595, 556, 1, 0, 0, 0, 595, 560, 1, 0, 0, 0, 595, 567, 1, 0, 0, 0, 595, 574, 1, 0, 0, 0, 595, 581, 1, 0, 0, 0, 595, 586, 1, 0, 0, 0, 595, 590, 1, 0, 0, 0, 596, 120, 1, 0, 0, 0, 597, 599, 5, 45, 0, 0, 598, 597, 1, 0, 0, 0, 598, 599, 1, 0, 0, 0, 599, 600, 1, 0, 0, 0, 600, 602, 3, 123, 61, 0, 601, 603, 3, 125, 62, 0, 602, 601, 1, 0, 0, 0, 602, 603, 1, 0, 0, 0, 603, 122, 1, 0, 0, 0, 604, 606, 7, 0, 0, 0, 605, 604, 1, 0, 0, 0, 606, 607, 1, 0, 0, 0, 607, 605, 1, 0, 0, 0, 607, 608, 1, 0, 0, 0, 608, 617, 1, 0, 0, 0, 609, 611, 5, 95, 0, 0, 610, 612, 7, 0, 0, 0, 611, 610, 1, 0, 0, 0, 612, 613, 1, 0, 0, 0, 613, 611, 1, 0, 0, 0, 613, 614, 1, 0, 0, 0, 614, 616, 1, 0, 0, 0, 615, 609, 1, 0, 0, 0, 616, 619, 1, 0, 0, 0, 617, 615, 1, 0, 0, 0, 617, 618, 1, 0, 0, 0, 618, 124, 1, 0, 0, 0, 619, 617, 1, 0, 0, 0, 620, 621, 7, 1, 0, 0, 621, 622, 3, 123, 61, 0, 622, 126, 1, 0, 0, 0, 623, 624, 5, 98, 0, 0, 624, 625, 5, 121, 0, 0, 625, 626, 5, 116, 0, 0, 626, 627, 5, 101, 0, 0, 627, 628, 5, 115, 0, 0, 628, 630, 1, 0, 0, 0, 629, 631, 3, 129, 64, 0, 630, 629, 1, 0, 0, 0, 630, 631, 1, 0, 0, 0, 631, 637, 1, 0, 0, 0, 632, 633, 5, 98, 0, 0, 633, 634, 5, 121, 0, 0, 634, 635, 5, 116, 0, 0, 635, 637, 5, 101, 0, 0, 636, 623, 1, 0, 0, 0, 636, 632, 1, 0, 0, 0, 637, 128, 1, 0, 0, 0, 638, 642, 7, 2, 0, 0, 639, 641, 7, 0, 0, 0, 640, 639, 1, 0, 0, 0, 641, 644, 1, 0, 0, 0, 642, 640, 1, 0, 0, 0, 642, 643, 1, 0, 0, 0, 643, 130, 1, 0, 0, 0, 644, 642, 1, 0, 0, 0, 645, 651, 5, 34, 0, 0, 646, 647, 5, 92, 0, 0, 647, 650, 5, 34, 0, 0, 648, 650, 8, 3, 0, 0, 649, 646, 1, 0, 0, 0, 649, 648, 1, 0, 0, 0, 650, 653, 1, 0, 0, 0, 651, 652, 1, 0, 0, 0, 651, 649, 1, 0, 0, 0, 652, 654, 1, 0, 0, 0, 653, 651, 1, 0, 0, 0, 654, 666, 5, 34, 0, 0, 655, 661, 5, 39, 0, 0, 656, 657, 5, 92, 0, 0, 657, 660, 5, 39, 0, 0, 658, 660, 8, 4, 0, 0, 659, 656, 1, 0, 0, 0, 659, 658, 1, 0, 0, 0, 660, 663, 1, 0, 0, 0, 661, 662, 1, 0, 0, 0, 661, 659, 1, 0, 0, 0, 662, 664, 1, 0, 0, 0, 663, 661, 1, 0, 0, 0, 664, 666, 5, 39, 0, 0, 665, 645, 1, 0, 0, 0, 665, 655, 1, 0, 0, 0, 666, 132, 1, 0, 0, 0, 667, 668, 5, 100, 0, 0, 668, 669, 5, 97, 0, 0, 669, 670, 5, 116, 0, 0, 670, 671, 5, 101, 0, 0, 671, 672, 5, 40, 0, 0, 672, 673, 1, 0, 0, 0, 673, 674, 3, 131, 65, 0, 674, 675, 5, 41, 0, 0, 675, 134, 1, 0, 0, 0, 676, 677, 5, 48, 0, 0, 677, 681, 7, 5, 0, 0, 678, 680, 7, 6, 0, 0, 679, 678, 1, 0, 0, 0, 680, 683, 1, 0, 0, 0, 681, 679, 1, 0, 0, 0, 681, 682, 1, 0, 0, 0, 682, 136, 1, 0, 0, 0, 683, 681, 1, 0, 0, 0, 684, 685, 5, 116, 0, 0, 685, 686, 5, 120, 0, 0, 686, 687, 5, 46, 0, 0, 687, 688, 5, 97, 0, 0, 688, 689, 5, 103, 0, 0, 689, 698, 5, 101, 0, 0, 690, 691, 5, 116, 0, 0, 691, 692, 5, 120, 0, 0, 692, 693, 5, 46, 0, 0, 693, 694, 5, 116, 0, 0, 694, 695, 5, 105, 0, 0, 695, 696, 5, 109, 0, 0, 696, 698, 5, 101, 0, 0, 697, 684, 1, 0, 0, 0, 697, 690, 1, 0, 0, 0, 698, 138, 1, 0, 0, 0, 699, 700, 5, 116, 0, 0, 700, 701, 5, 104, 0, 0, 701, 702, 5, 105, 0, 0, 702, 703, 5, 115, 0, 0, 703, 704, 5, 46, 0, 0, 704, 705, 5, 97, 0, 0, 705, 706, 5, 99, 0, 0, 706, 707, 5, 116, 0, 0, 707, 708, 5, 105, 0, 0, 708, 709, 5, 118, 0, 0, 709, 710, 5, 101, 0, 0, 710, 711, 5, 73, 0, 0, 711, 712, 5, 110, 0, 0, 712, 713, 5, 112, 0, 0, 713, 714, 5, 117, 0, 0, 714, 715, 5, 116, 0, 0, 715, 716, 5, 73, 0, 0, 716, 717, 5, 110, 0, 0, 717, 718, 5, 100, 0, 0, 718, 719, 5, 101, 0, 0, 719, 794, 5, 120, 0, 0, 720, 721, 5, 116, 0, 0, 721, 722, 5, 104, 0, 0, 722, 723, 5, 105, 0, 0, 723, 724, 5, 115, 0, 0, 724, 725, 5, 46, 0, 0, 725, 726, 5, 97, 0, 0, 726, 727, 5, 99, 0, 0, 727, 728, 5, 116, 0, 0, 728, 729, 5, 105, 0, 0, 729, 730, 5, 118, 0, 0, 730, 731, 5, 101, 0, 0, 731, 732, 5, 66, 0, 0, 732, 733, 5, 121, 0, 0, 733, 734, 5, 116, 0, 0, 734, 735, 5, 101, 0, 0, 735, 736, 5, 99, 0, 0, 736, 737, 5, 111, 0, 0, 737, 738, 5, 100, 0, 0, 738, 794, 5, 101, 0, 0, 739, 740, 5, 116, 0, 0, 740, 741, 5, 120, 0, 0, 741, 742, 5, 46, 0, 0, 742, 743, 5, 105, 0, 0, 743, 744, 5, 110, 0, 0, 744, 745, 5, 112, 0, 0, 745, 746, 5, 117, 0, 0, 746, 747, 5, 116, 0, 0, 747, 748, 5, 115, 0, 0, 748, 749, 5, 46, 0, 0, 749, 750, 5, 108, 0, 0, 750, 751, 5, 101, 0, 0, 751, 752, 5, 110, 0, 0, 752, 753, 5, 103, 0, 0, 753, 754, 5, 116, 0, 0, 754, 794, 5, 104, 0, 0, 755, 756, 5, 116, 0, 0, 756, 757, 5, 120, 0, 0, 757, 758, 5, 46, 0, 0, 758, 759, 5, 111, 0, 0, 759, 760, 5, 117, 0, 0, 760, 761, 5, 116, 0, 0, 761, 762, 5, 112, 0, 0, 762, 763, 5, 117, 0, 0, 763, 764, 5, 116, 0, 0, 764, 765, 5, 115, 0, 0, 765, 766, 5, 46, 0, 0, 766, 767, 5, 108, 0, 0, 767, 768, 5, 101, 0, 0, 768, 769, 5, 110, 0, 0, 769, 770, 5, 103, 0, 0, 770, 771, 5, 116, 0, 0, 771, 794, 5, 104, 0, 0, 772, 773, 5, 116, 0, 0, 773, 774, 5, 120, 0, 0, 774, 775, 5, 46, 0, 0, 775, 776, 5, 118, 0, 0, 776, 777, 5, 101, 0, 0, 777, 778, 5, 114, 0, 0, 778, 779, 5, 115, 0, 0, 779, 780, 5, 105, 0, 0, 780, 781, 5, 111, 0, 0, 781, 794, 5, 110, 0, 0, 782, 783, 5, 116, 0, 0, 783, 784, 5, 120, 0, 0, 784, 785, 5, 46, 0, 0, 785, 786, 5, 108, 0, 0, 786, 787, 5, 111, 0, 0, 787, 788, 5, 99, 0, 0, 788, 789, 5, 107, 0, 0, 789, 790, 5, 116, 0, 0, 790, 791, 5, 105, 0, 0, 791, 792, 5, 109, 0, 0, 792, 794, 5, 101, 0, 0, 793, 699, 1, 0, 0, 0, 793, 720, 1, 0, 0, 0, 793, 739, 1, 0, 0, 0, 793, 755, 1, 0, 0, 0, 793, 772, 1, 0, 0, 0, 793, 782, 1, 0, 0, 0, 794, 140, 1, 0, 0, 0, 795, 799, 7, 7, 0, 0, 796, 798, 7, 8, 0, 0, 797, 796, 1, 0, 0, 0, 798, 801, 1, 0, 0, 0, 799, 797, 1, 0, 0, 0, 799, 800, 1, 0, 0, 0, 800, 142, 1, 0, 0, 0, 801, 799, 1, 0, 0, 0, 802, 804, 7, 9, 0, 0, 803, 802, 1, 0, 0, 0, 804, 805, 1, 0, 0, 0, 805, 803, 1, 0, 0, 0, 805, 806, 1, 0, 0, 0, 806, 807, 1, 0, 0, 0, 807, 808, 6, 71, 0, 0, 808, 144, 1, 0, 0, 0, 809, 810, 5, 47, 0, 0, 810, 811, 5, 42, 0, 0, 811, 815, 1, 0, 0, 0, 812, 814, 9, 0, 0, 0, 813, 812, 1, 0, 0, 0, 814, 817, 1, 0, 0, 0, 815, 816, 1, 0, 0, 0, 815, 813, 1, 0, 0, 0, 816, 818, 1, 0, 0, 0, 817, 815, 1, 0, 0, 0, 818, 819, 5, 42, 0, 0, 819, 820, 5, 47, 0, 0, 820, 821, 1, 0, 0, 0, 821, 822, 6, 72, 1, 0, 822, 146, 1, 0, 0, 0, 823, 824, 5, 47, 0, 0, 824, 825, 5, 47, 0, 0, 825, 829, 1, 0, 0, 0, 826, 828, 8, 10, 0, 0, 827, 826, 1, 0, 0, 0, 828, 831, 1, 0, 0, 0, 829, 827, 1, 0, 0, 0, 829, 830, 1, 0, 0, 0, 830, 832, 1, 0, 0, 0, 831, 829, 1, 0, 0, 0, 832, 833, 6, 73, 1, 0, 833, 148, 1, 0, 0, 0, 26, 0, 513, 519, 525, 536, 595, 598, 602, 607, 613, 617, 630, 636, 642, 649, 651, 659, 661, 665, 681, 697, 793, 799, 805, 815, 829, 2, 6, 0, 0, 0, 1, 0]
\ No newline at end of file
+[4, 0, 74, 836, 6, -1, 2, 0, 7, 0, 2, 1, 7, 1, 2, 2, 7, 2, 2, 3, 7, 3, 2, 4, 7, 4, 2, 5, 7, 5, 2, 6, 7, 6, 2, 7, 7, 7, 2, 8, 7, 8, 2, 9, 7, 9, 2, 10, 7, 10, 2, 11, 7, 11, 2, 12, 7, 12, 2, 13, 7, 13, 2, 14, 7, 14, 2, 15, 7, 15, 2, 16, 7, 16, 2, 17, 7, 17, 2, 18, 7, 18, 2, 19, 7, 19, 2, 20, 7, 20, 2, 21, 7, 21, 2, 22, 7, 22, 2, 23, 7, 23, 2, 24, 7, 24, 2, 25, 7, 25, 2, 26, 7, 26, 2, 27, 7, 27, 2, 28, 7, 28, 2, 29, 7, 29, 2, 30, 7, 30, 2, 31, 7, 31, 2, 32, 7, 32, 2, 33, 7, 33, 2, 34, 7, 34, 2, 35, 7, 35, 2, 36, 7, 36, 2, 37, 7, 37, 2, 38, 7, 38, 2, 39, 7, 39, 2, 40, 7, 40, 2, 41, 7, 41, 2, 42, 7, 42, 2, 43, 7, 43, 2, 44, 7, 44, 2, 45, 7, 45, 2, 46, 7, 46, 2, 47, 7, 47, 2, 48, 7, 48, 2, 49, 7, 49, 2, 50, 7, 50, 2, 51, 7, 51, 2, 52, 7, 52, 2, 53, 7, 53, 2, 54, 7, 54, 2, 55, 7, 55, 2, 56, 7, 56, 2, 57, 7, 57, 2, 58, 7, 58, 2, 59, 7, 59, 2, 60, 7, 60, 2, 61, 7, 61, 2, 62, 7, 62, 2, 63, 7, 63, 2, 64, 7, 64, 2, 65, 7, 65, 2, 66, 7, 66, 2, 67, 7, 67, 2, 68, 7, 68, 2, 69, 7, 69, 2, 70, 7, 70, 2, 71, 7, 71, 2, 72, 7, 72, 2, 73, 7, 73, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 1, 1, 1, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 2, 1, 3, 1, 3, 1, 4, 1, 4, 1, 5, 1, 5, 1, 5, 1, 6, 1, 6, 1, 7, 1, 7, 1, 8, 1, 8, 1, 8, 1, 9, 1, 9, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 10, 1, 11, 1, 11, 1, 12, 1, 12, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 13, 1, 14, 1, 14, 1, 15, 1, 15, 1, 16, 1, 16, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 17, 1, 18, 1, 18, 1, 18, 1, 19, 1, 19, 1, 19, 1, 19, 1, 19, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 20, 1, 21, 1, 21, 1, 21, 1, 21, 1, 22, 1, 22, 1, 23, 1, 23, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 24, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 25, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 26, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 27, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 28, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 29, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 30, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 31, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 32, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 33, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 34, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 35, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 36, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 37, 1, 38, 1, 38, 1, 39, 1, 39, 1, 40, 1, 40, 1, 41, 1, 41, 1, 42, 1, 42, 1, 43, 1, 43, 1, 44, 1, 44, 1, 44, 1, 45, 1, 45, 1, 45, 1, 46, 1, 46, 1, 47, 1, 47, 1, 48, 1, 48, 1, 48, 1, 49, 1, 49, 1, 49, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 50, 1, 51, 1, 51, 1, 51, 1, 51, 1, 52, 1, 52, 1, 52, 1, 52, 1, 52, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 53, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 54, 1, 55, 1, 55, 1, 55, 1, 55, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 56, 1, 57, 4, 57, 512, 8, 57, 11, 57, 12, 57, 513, 1, 57, 1, 57, 4, 57, 518, 8, 57, 11, 57, 12, 57, 519, 1, 57, 1, 57, 4, 57, 524, 8, 57, 11, 57, 12, 57, 525, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 1, 58, 3, 58, 537, 8, 58, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 1, 59, 3, 59, 596, 8, 59, 1, 60, 3, 60, 599, 8, 60, 1, 60, 1, 60, 3, 60, 603, 8, 60, 1, 61, 4, 61, 606, 8, 61, 11, 61, 12, 61, 607, 1, 61, 1, 61, 4, 61, 612, 8, 61, 11, 61, 12, 61, 613, 5, 61, 616, 8, 61, 10, 61, 12, 61, 619, 9, 61, 1, 62, 1, 62, 1, 62, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 1, 63, 3, 63, 631, 8, 63, 1, 63, 1, 63, 1, 63, 1, 63, 3, 63, 637, 8, 63, 1, 64, 1, 64, 5, 64, 641, 8, 64, 10, 64, 12, 64, 644, 9, 64, 1, 65, 1, 65, 1, 65, 1, 65, 5, 65, 650, 8, 65, 10, 65, 12, 65, 653, 9, 65, 1, 65, 1, 65, 1, 65, 1, 65, 1, 65, 5, 65, 660, 8, 65, 10, 65, 12, 65, 663, 9, 65, 1, 65, 3, 65, 666, 8, 65, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 66, 1, 67, 1, 67, 1, 67, 5, 67, 680, 8, 67, 10, 67, 12, 67, 683, 9, 67, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 1, 68, 3, 68, 700, 8, 68, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 1, 69, 3, 69, 796, 8, 69, 1, 70, 1, 70, 5, 70, 800, 8, 70, 10, 70, 12, 70, 803, 9, 70, 1, 71, 4, 71, 806, 8, 71, 11, 71, 12, 71, 807, 1, 71, 1, 71, 1, 72, 1, 72, 1, 72, 1, 72, 5, 72, 816, 8, 72, 10, 72, 12, 72, 819, 9, 72, 1, 72, 1, 72, 1, 72, 1, 72, 1, 72, 1, 73, 1, 73, 1, 73, 1, 73, 5, 73, 830, 8, 73, 10, 73, 12, 73, 833, 9, 73, 1, 73, 1, 73, 3, 651, 661, 817, 0, 74, 1, 1, 3, 2, 5, 3, 7, 4, 9, 5, 11, 6, 13, 7, 15, 8, 17, 9, 19, 10, 21, 11, 23, 12, 25, 13, 27, 14, 29, 15, 31, 16, 33, 17, 35, 18, 37, 19, 39, 20, 41, 21, 43, 22, 45, 23, 47, 24, 49, 25, 51, 26, 53, 27, 55, 28, 57, 29, 59, 30, 61, 31, 63, 32, 65, 33, 67, 34, 69, 35, 71, 36, 73, 37, 75, 38, 77, 39, 79, 40, 81, 41, 83, 42, 85, 43, 87, 44, 89, 45, 91, 46, 93, 47, 95, 48, 97, 49, 99, 50, 101, 51, 103, 52, 105, 53, 107, 54, 109, 55, 111, 56, 113, 57, 115, 58, 117, 59, 119, 60, 121, 61, 123, 62, 125, 63, 127, 64, 129, 65, 131, 66, 133, 67, 135, 68, 137, 69, 139, 70, 141, 71, 143, 72, 145, 73, 147, 74, 1, 0, 11, 1, 0, 48, 57, 2, 0, 69, 69, 101, 101, 1, 0, 49, 57, 3, 0, 10, 10, 13, 13, 34, 34, 3, 0, 10, 10, 13, 13, 39, 39, 2, 0, 88, 88, 120, 120, 3, 0, 48, 57, 65, 70, 97, 102, 2, 0, 65, 90, 97, 122, 4, 0, 48, 57, 65, 90, 95, 95, 97, 122, 3, 0, 9, 10, 12, 13, 32, 32, 2, 0, 10, 10, 13, 13, 872, 0, 1, 1, 0, 0, 0, 0, 3, 1, 0, 0, 0, 0, 5, 1, 0, 0, 0, 0, 7, 1, 0, 0, 0, 0, 9, 1, 0, 0, 0, 0, 11, 1, 0, 0, 0, 0, 13, 1, 0, 0, 0, 0, 15, 1, 0, 0, 0, 0, 17, 1, 0, 0, 0, 0, 19, 1, 0, 0, 0, 0, 21, 1, 0, 0, 0, 0, 23, 1, 0, 0, 0, 0, 25, 1, 0, 0, 0, 0, 27, 1, 0, 0, 0, 0, 29, 1, 0, 0, 0, 0, 31, 1, 0, 0, 0, 0, 33, 1, 0, 0, 0, 0, 35, 1, 0, 0, 0, 0, 37, 1, 0, 0, 0, 0, 39, 1, 0, 0, 0, 0, 41, 1, 0, 0, 0, 0, 43, 1, 0, 0, 0, 0, 45, 1, 0, 0, 0, 0, 47, 1, 0, 0, 0, 0, 49, 1, 0, 0, 0, 0, 51, 1, 0, 0, 0, 0, 53, 1, 0, 0, 0, 0, 55, 1, 0, 0, 0, 0, 57, 1, 0, 0, 0, 0, 59, 1, 0, 0, 0, 0, 61, 1, 0, 0, 0, 0, 63, 1, 0, 0, 0, 0, 65, 1, 0, 0, 0, 0, 67, 1, 0, 0, 0, 0, 69, 1, 0, 0, 0, 0, 71, 1, 0, 0, 0, 0, 73, 1, 0, 0, 0, 0, 75, 1, 0, 0, 0, 0, 77, 1, 0, 0, 0, 0, 79, 1, 0, 0, 0, 0, 81, 1, 0, 0, 0, 0, 83, 1, 0, 0, 0, 0, 85, 1, 0, 0, 0, 0, 87, 1, 0, 0, 0, 0, 89, 1, 0, 0, 0, 0, 91, 1, 0, 0, 0, 0, 93, 1, 0, 0, 0, 0, 95, 1, 0, 0, 0, 0, 97, 1, 0, 0, 0, 0, 99, 1, 0, 0, 0, 0, 101, 1, 0, 0, 0, 0, 103, 1, 0, 0, 0, 0, 105, 1, 0, 0, 0, 0, 107, 1, 0, 0, 0, 0, 109, 1, 0, 0, 0, 0, 111, 1, 0, 0, 0, 0, 113, 1, 0, 0, 0, 0, 115, 1, 0, 0, 0, 0, 117, 1, 0, 0, 0, 0, 119, 1, 0, 0, 0, 0, 121, 1, 0, 0, 0, 0, 123, 1, 0, 0, 0, 0, 125, 1, 0, 0, 0, 0, 127, 1, 0, 0, 0, 0, 129, 1, 0, 0, 0, 0, 131, 1, 0, 0, 0, 0, 133, 1, 0, 0, 0, 0, 135, 1, 0, 0, 0, 0, 137, 1, 0, 0, 0, 0, 139, 1, 0, 0, 0, 0, 141, 1, 0, 0, 0, 0, 143, 1, 0, 0, 0, 0, 145, 1, 0, 0, 0, 0, 147, 1, 0, 0, 0, 1, 149, 1, 0, 0, 0, 3, 156, 1, 0, 0, 0, 5, 158, 1, 0, 0, 0, 7, 169, 1, 0, 0, 0, 9, 171, 1, 0, 0, 0, 11, 173, 1, 0, 0, 0, 13, 176, 1, 0, 0, 0, 15, 178, 1, 0, 0, 0, 17, 180, 1, 0, 0, 0, 19, 183, 1, 0, 0, 0, 21, 185, 1, 0, 0, 0, 23, 194, 1, 0, 0, 0, 25, 196, 1, 0, 0, 0, 27, 198, 1, 0, 0, 0, 29, 207, 1, 0, 0, 0, 31, 209, 1, 0, 0, 0, 33, 211, 1, 0, 0, 0, 35, 213, 1, 0, 0, 0, 37, 221, 1, 0, 0, 0, 39, 224, 1, 0, 0, 0, 41, 229, 1, 0, 0, 0, 43, 241, 1, 0, 0, 0, 45, 245, 1, 0, 0, 0, 47, 247, 1, 0, 0, 0, 49, 249, 1, 0, 0, 0, 51, 260, 1, 0, 0, 0, 53, 267, 1, 0, 0, 0, 55, 284, 1, 0, 0, 0, 57, 299, 1, 0, 0, 0, 59, 314, 1, 0, 0, 0, 61, 327, 1, 0, 0, 0, 63, 337, 1, 0, 0, 0, 65, 362, 1, 0, 0, 0, 67, 377, 1, 0, 0, 0, 69, 396, 1, 0, 0, 0, 71, 412, 1, 0, 0, 0, 73, 423, 1, 0, 0, 0, 75, 431, 1, 0, 0, 0, 77, 438, 1, 0, 0, 0, 79, 440, 1, 0, 0, 0, 81, 442, 1, 0, 0, 0, 83, 444, 1, 0, 0, 0, 85, 446, 1, 0, 0, 0, 87, 448, 1, 0, 0, 0, 89, 450, 1, 0, 0, 0, 91, 453, 1, 0, 0, 0, 93, 456, 1, 0, 0, 0, 95, 458, 1, 0, 0, 0, 97, 460, 1, 0, 0, 0, 99, 463, 1, 0, 0, 0, 101, 466, 1, 0, 0, 0, 103, 475, 1, 0, 0, 0, 105, 479, 1, 0, 0, 0, 107, 484, 1, 0, 0, 0, 109, 491, 1, 0, 0, 0, 111, 498, 1, 0, 0, 0, 113, 502, 1, 0, 0, 0, 115, 511, 1, 0, 0, 0, 117, 536, 1, 0, 0, 0, 119, 595, 1, 0, 0, 0, 121, 598, 1, 0, 0, 0, 123, 605, 1, 0, 0, 0, 125, 620, 1, 0, 0, 0, 127, 636, 1, 0, 0, 0, 129, 638, 1, 0, 0, 0, 131, 665, 1, 0, 0, 0, 133, 667, 1, 0, 0, 0, 135, 676, 1, 0, 0, 0, 137, 699, 1, 0, 0, 0, 139, 795, 1, 0, 0, 0, 141, 797, 1, 0, 0, 0, 143, 805, 1, 0, 0, 0, 145, 811, 1, 0, 0, 0, 147, 825, 1, 0, 0, 0, 149, 150, 5, 112, 0, 0, 150, 151, 5, 114, 0, 0, 151, 152, 5, 97, 0, 0, 152, 153, 5, 103, 0, 0, 153, 154, 5, 109, 0, 0, 154, 155, 5, 97, 0, 0, 155, 2, 1, 0, 0, 0, 156, 157, 5, 59, 0, 0, 157, 4, 1, 0, 0, 0, 158, 159, 5, 99, 0, 0, 159, 160, 5, 97, 0, 0, 160, 161, 5, 115, 0, 0, 161, 162, 5, 104, 0, 0, 162, 163, 5, 115, 0, 0, 163, 164, 5, 99, 0, 0, 164, 165, 5, 114, 0, 0, 165, 166, 5, 105, 0, 0, 166, 167, 5, 112, 0, 0, 167, 168, 5, 116, 0, 0, 168, 6, 1, 0, 0, 0, 169, 170, 5, 94, 0, 0, 170, 8, 1, 0, 0, 0, 171, 172, 5, 126, 0, 0, 172, 10, 1, 0, 0, 0, 173, 174, 5, 62, 0, 0, 174, 175, 5, 61, 0, 0, 175, 12, 1, 0, 0, 0, 176, 177, 5, 62, 0, 0, 177, 14, 1, 0, 0, 0, 178, 179, 5, 60, 0, 0, 179, 16, 1, 0, 0, 0, 180, 181, 5, 60, 0, 0, 181, 182, 5, 61, 0, 0, 182, 18, 1, 0, 0, 0, 183, 184, 5, 61, 0, 0, 184, 20, 1, 0, 0, 0, 185, 186, 5, 99, 0, 0, 186, 187, 5, 111, 0, 0, 187, 188, 5, 110, 0, 0, 188, 189, 5, 116, 0, 0, 189, 190, 5, 114, 0, 0, 190, 191, 5, 97, 0, 0, 191, 192, 5, 99, 0, 0, 192, 193, 5, 116, 0, 0, 193, 22, 1, 0, 0, 0, 194, 195, 5, 123, 0, 0, 195, 24, 1, 0, 0, 0, 196, 197, 5, 125, 0, 0, 197, 26, 1, 0, 0, 0, 198, 199, 5, 102, 0, 0, 199, 200, 5, 117, 0, 0, 200, 201, 5, 110, 0, 0, 201, 202, 5, 99, 0, 0, 202, 203, 5, 116, 0, 0, 203, 204, 5, 105, 0, 0, 204, 205, 5, 111, 0, 0, 205, 206, 5, 110, 0, 0, 206, 28, 1, 0, 0, 0, 207, 208, 5, 40, 0, 0, 208, 30, 1, 0, 0, 0, 209, 210, 5, 44, 0, 0, 210, 32, 1, 0, 0, 0, 211, 212, 5, 41, 0, 0, 212, 34, 1, 0, 0, 0, 213, 214, 5, 114, 0, 0, 214, 215, 5, 101, 0, 0, 215, 216, 5, 113, 0, 0, 216, 217, 5, 117, 0, 0, 217, 218, 5, 105, 0, 0, 218, 219, 5, 114, 0, 0, 219, 220, 5, 101, 0, 0, 220, 36, 1, 0, 0, 0, 221, 222, 5, 105, 0, 0, 222, 223, 5, 102, 0, 0, 223, 38, 1, 0, 0, 0, 224, 225, 5, 101, 0, 0, 225, 226, 5, 108, 0, 0, 226, 227, 5, 115, 0, 0, 227, 228, 5, 101, 0, 0, 228, 40, 1, 0, 0, 0, 229, 230, 5, 99, 0, 0, 230, 231, 5, 111, 0, 0, 231, 232, 5, 110, 0, 0, 232, 233, 5, 115, 0, 0, 233, 234, 5, 111, 0, 0, 234, 235, 5, 108, 0, 0, 235, 236, 5, 101, 0, 0, 236, 237, 5, 46, 0, 0, 237, 238, 5, 108, 0, 0, 238, 239, 5, 111, 0, 0, 239, 240, 5, 103, 0, 0, 240, 42, 1, 0, 0, 0, 241, 242, 5, 110, 0, 0, 242, 243, 5, 101, 0, 0, 243, 244, 5, 119, 0, 0, 244, 44, 1, 0, 0, 0, 245, 246, 5, 91, 0, 0, 246, 46, 1, 0, 0, 0, 247, 248, 5, 93, 0, 0, 248, 48, 1, 0, 0, 0, 249, 250, 5, 116, 0, 0, 250, 251, 5, 120, 0, 0, 251, 252, 5, 46, 0, 0, 252, 253, 5, 111, 0, 0, 253, 254, 5, 117, 0, 0, 254, 255, 5, 116, 0, 0, 255, 256, 5, 112, 0, 0, 256, 257, 5, 117, 0, 0, 257, 258, 5, 116, 0, 0, 258, 259, 5, 115, 0, 0, 259, 50, 1, 0, 0, 0, 260, 261, 5, 46, 0, 0, 261, 262, 5, 118, 0, 0, 262, 263, 5, 97, 0, 0, 263, 264, 5, 108, 0, 0, 264, 265, 5, 117, 0, 0, 265, 266, 5, 101, 0, 0, 266, 52, 1, 0, 0, 0, 267, 268, 5, 46, 0, 0, 268, 269, 5, 108, 0, 0, 269, 270, 5, 111, 0, 0, 270, 271, 5, 99, 0, 0, 271, 272, 5, 107, 0, 0, 272, 273, 5, 105, 0, 0, 273, 274, 5, 110, 0, 0, 274, 275, 5, 103, 0, 0, 275, 276, 5, 66, 0, 0, 276, 277, 5, 121, 0, 0, 277, 278, 5, 116, 0, 0, 278, 279, 5, 101, 0, 0, 279, 280, 5, 99, 0, 0, 280, 281, 5, 111, 0, 0, 281, 282, 5, 100, 0, 0, 282, 283, 5, 101, 0, 0, 283, 54, 1, 0, 0, 0, 284, 285, 5, 46, 0, 0, 285, 286, 5, 116, 0, 0, 286, 287, 5, 111, 0, 0, 287, 288, 5, 107, 0, 0, 288, 289, 5, 101, 0, 0, 289, 290, 5, 110, 0, 0, 290, 291, 5, 67, 0, 0, 291, 292, 5, 97, 0, 0, 292, 293, 5, 116, 0, 0, 293, 294, 5, 101, 0, 0, 294, 295, 5, 103, 0, 0, 295, 296, 5, 111, 0, 0, 296, 297, 5, 114, 0, 0, 297, 298, 5, 121, 0, 0, 298, 56, 1, 0, 0, 0, 299, 300, 5, 46, 0, 0, 300, 301, 5, 110, 0, 0, 301, 302, 5, 102, 0, 0, 302, 303, 5, 116, 0, 0, 303, 304, 5, 67, 0, 0, 304, 305, 5, 111, 0, 0, 305, 306, 5, 109, 0, 0, 306, 307, 5, 109, 0, 0, 307, 308, 5, 105, 0, 0, 308, 309, 5, 116, 0, 0, 309, 310, 5, 109, 0, 0, 310, 311, 5, 101, 0, 0, 311, 312, 5, 110, 0, 0, 312, 313, 5, 116, 0, 0, 313, 58, 1, 0, 0, 0, 314, 315, 5, 46, 0, 0, 315, 316, 5, 116, 0, 0, 316, 317, 5, 111, 0, 0, 317, 318, 5, 107, 0, 0, 318, 319, 5, 101, 0, 0, 319, 320, 5, 110, 0, 0, 320, 321, 5, 65, 0, 0, 321, 322, 5, 109, 0, 0, 322, 323, 5, 111, 0, 0, 323, 324, 5, 117, 0, 0, 324, 325, 5, 110, 0, 0, 325, 326, 5, 116, 0, 0, 326, 60, 1, 0, 0, 0, 327, 328, 5, 116, 0, 0, 328, 329, 5, 120, 0, 0, 329, 330, 5, 46, 0, 0, 330, 331, 5, 105, 0, 0, 331, 332, 5, 110, 0, 0, 332, 333, 5, 112, 0, 0, 333, 334, 5, 117, 0, 0, 334, 335, 5, 116, 0, 0, 335, 336, 5, 115, 0, 0, 336, 62, 1, 0, 0, 0, 337, 338, 5, 46, 0, 0, 338, 339, 5, 111, 0, 0, 339, 340, 5, 117, 0, 0, 340, 341, 5, 116, 0, 0, 341, 342, 5, 112, 0, 0, 342, 343, 5, 111, 0, 0, 343, 344, 5, 105, 0, 0, 344, 345, 5, 110, 0, 0, 345, 346, 5, 116, 0, 0, 346, 347, 5, 84, 0, 0, 347, 348, 5, 114, 0, 0, 348, 349, 5, 97, 0, 0, 349, 350, 5, 110, 0, 0, 350, 351, 5, 115, 0, 0, 351, 352, 5, 97, 0, 0, 352, 353, 5, 99, 0, 0, 353, 354, 5, 116, 0, 0, 354, 355, 5, 105, 0, 0, 355, 356, 5, 111, 0, 0, 356, 357, 5, 110, 0, 0, 357, 358, 5, 72, 0, 0, 358, 359, 5, 97, 0, 0, 359, 360, 5, 115, 0, 0, 360, 361, 5, 104, 0, 0, 361, 64, 1, 0, 0, 0, 362, 363, 5, 46, 0, 0, 363, 364, 5, 111, 0, 0, 364, 365, 5, 117, 0, 0, 365, 366, 5, 116, 0, 0, 366, 367, 5, 112, 0, 0, 367, 368, 5, 111, 0, 0, 368, 369, 5, 105, 0, 0, 369, 370, 5, 110, 0, 0, 370, 371, 5, 116, 0, 0, 371, 372, 5, 73, 0, 0, 372, 373, 5, 110, 0, 0, 373, 374, 5, 100, 0, 0, 374, 375, 5, 101, 0, 0, 375, 376, 5, 120, 0, 0, 376, 66, 1, 0, 0, 0, 377, 378, 5, 46, 0, 0, 378, 379, 5, 117, 0, 0, 379, 380, 5, 110, 0, 0, 380, 381, 5, 108, 0, 0, 381, 382, 5, 111, 0, 0, 382, 383, 5, 99, 0, 0, 383, 384, 5, 107, 0, 0, 384, 385, 5, 105, 0, 0, 385, 386, 5, 110, 0, 0, 386, 387, 5, 103, 0, 0, 387, 388, 5, 66, 0, 0, 388, 389, 5, 121, 0, 0, 389, 390, 5, 116, 0, 0, 390, 391, 5, 101, 0, 0, 391, 392, 5, 99, 0, 0, 392, 393, 5, 111, 0, 0, 393, 394, 5, 100, 0, 0, 394, 395, 5, 101, 0, 0, 395, 68, 1, 0, 0, 0, 396, 397, 5, 46, 0, 0, 397, 398, 5, 115, 0, 0, 398, 399, 5, 101, 0, 0, 399, 400, 5, 113, 0, 0, 400, 401, 5, 117, 0, 0, 401, 402, 5, 101, 0, 0, 402, 403, 5, 110, 0, 0, 403, 404, 5, 99, 0, 0, 404, 405, 5, 101, 0, 0, 405, 406, 5, 78, 0, 0, 406, 407, 5, 117, 0, 0, 407, 408, 5, 109, 0, 0, 408, 409, 5, 98, 0, 0, 409, 410, 5, 101, 0, 0, 410, 411, 5, 114, 0, 0, 411, 70, 1, 0, 0, 0, 412, 413, 5, 46, 0, 0, 413, 414, 5, 114, 0, 0, 414, 415, 5, 101, 0, 0, 415, 416, 5, 118, 0, 0, 416, 417, 5, 101, 0, 0, 417, 418, 5, 114, 0, 0, 418, 419, 5, 115, 0, 0, 419, 420, 5, 101, 0, 0, 420, 421, 5, 40, 0, 0, 421, 422, 5, 41, 0, 0, 422, 72, 1, 0, 0, 0, 423, 424, 5, 46, 0, 0, 424, 425, 5, 108, 0, 0, 425, 426, 5, 101, 0, 0, 426, 427, 5, 110, 0, 0, 427, 428, 5, 103, 0, 0, 428, 429, 5, 116, 0, 0, 429, 430, 5, 104, 0, 0, 430, 74, 1, 0, 0, 0, 431, 432, 5, 46, 0, 0, 432, 433, 5, 115, 0, 0, 433, 434, 5, 112, 0, 0, 434, 435, 5, 108, 0, 0, 435, 436, 5, 105, 0, 0, 436, 437, 5, 116, 0, 0, 437, 76, 1, 0, 0, 0, 438, 439, 5, 33, 0, 0, 439, 78, 1, 0, 0, 0, 440, 441, 5, 45, 0, 0, 441, 80, 1, 0, 0, 0, 442, 443, 5, 42, 0, 0, 443, 82, 1, 0, 0, 0, 444, 445, 5, 47, 0, 0, 445, 84, 1, 0, 0, 0, 446, 447, 5, 37, 0, 0, 447, 86, 1, 0, 0, 0, 448, 449, 5, 43, 0, 0, 449, 88, 1, 0, 0, 0, 450, 451, 5, 61, 0, 0, 451, 452, 5, 61, 0, 0, 452, 90, 1, 0, 0, 0, 453, 454, 5, 33, 0, 0, 454, 455, 5, 61, 0, 0, 455, 92, 1, 0, 0, 0, 456, 457, 5, 38, 0, 0, 457, 94, 1, 0, 0, 0, 458, 459, 5, 124, 0, 0, 459, 96, 1, 0, 0, 0, 460, 461, 5, 38, 0, 0, 461, 462, 5, 38, 0, 0, 462, 98, 1, 0, 0, 0, 463, 464, 5, 124, 0, 0, 464, 465, 5, 124, 0, 0, 465, 100, 1, 0, 0, 0, 466, 467, 5, 99, 0, 0, 467, 468, 5, 111, 0, 0, 468, 469, 5, 110, 0, 0, 469, 470, 5, 115, 0, 0, 470, 471, 5, 116, 0, 0, 471, 472, 5, 97, 0, 0, 472, 473, 5, 110, 0, 0, 473, 474, 5, 116, 0, 0, 474, 102, 1, 0, 0, 0, 475, 476, 5, 105, 0, 0, 476, 477, 5, 110, 0, 0, 477, 478, 5, 116, 0, 0, 478, 104, 1, 0, 0, 0, 479, 480, 5, 98, 0, 0, 480, 481, 5, 111, 0, 0, 481, 482, 5, 111, 0, 0, 482, 483, 5, 108, 0, 0, 483, 106, 1, 0, 0, 0, 484, 485, 5, 115, 0, 0, 485, 486, 5, 116, 0, 0, 486, 487, 5, 114, 0, 0, 487, 488, 5, 105, 0, 0, 488, 489, 5, 110, 0, 0, 489, 490, 5, 103, 0, 0, 490, 108, 1, 0, 0, 0, 491, 492, 5, 112, 0, 0, 492, 493, 5, 117, 0, 0, 493, 494, 5, 98, 0, 0, 494, 495, 5, 107, 0, 0, 495, 496, 5, 101, 0, 0, 496, 497, 5, 121, 0, 0, 497, 110, 1, 0, 0, 0, 498, 499, 5, 115, 0, 0, 499, 500, 5, 105, 0, 0, 500, 501, 5, 103, 0, 0, 501, 112, 1, 0, 0, 0, 502, 503, 5, 100, 0, 0, 503, 504, 5, 97, 0, 0, 504, 505, 5, 116, 0, 0, 505, 506, 5, 97, 0, 0, 506, 507, 5, 115, 0, 0, 507, 508, 5, 105, 0, 0, 508, 509, 5, 103, 0, 0, 509, 114, 1, 0, 0, 0, 510, 512, 7, 0, 0, 0, 511, 510, 1, 0, 0, 0, 512, 513, 1, 0, 0, 0, 513, 511, 1, 0, 0, 0, 513, 514, 1, 0, 0, 0, 514, 515, 1, 0, 0, 0, 515, 517, 5, 46, 0, 0, 516, 518, 7, 0, 0, 0, 517, 516, 1, 0, 0, 0, 518, 519, 1, 0, 0, 0, 519, 517, 1, 0, 0, 0, 519, 520, 1, 0, 0, 0, 520, 521, 1, 0, 0, 0, 521, 523, 5, 46, 0, 0, 522, 524, 7, 0, 0, 0, 523, 522, 1, 0, 0, 0, 524, 525, 1, 0, 0, 0, 525, 523, 1, 0, 0, 0, 525, 526, 1, 0, 0, 0, 526, 116, 1, 0, 0, 0, 527, 528, 5, 116, 0, 0, 528, 529, 5, 114, 0, 0, 529, 530, 5, 117, 0, 0, 530, 537, 5, 101, 0, 0, 531, 532, 5, 102, 0, 0, 532, 533, 5, 97, 0, 0, 533, 534, 5, 108, 0, 0, 534, 535, 5, 115, 0, 0, 535, 537, 5, 101, 0, 0, 536, 527, 1, 0, 0, 0, 536, 531, 1, 0, 0, 0, 537, 118, 1, 0, 0, 0, 538, 539, 5, 115, 0, 0, 539, 540, 5, 97, 0, 0, 540, 541, 5, 116, 0, 0, 541, 542, 5, 111, 0, 0, 542, 543, 5, 115, 0, 0, 543, 544, 5, 104, 0, 0, 544, 545, 5, 105, 0, 0, 545, 596, 5, 115, 0, 0, 546, 547, 5, 115, 0, 0, 547, 548, 5, 97, 0, 0, 548, 549, 5, 116, 0, 0, 549, 596, 5, 115, 0, 0, 550, 551, 5, 102, 0, 0, 551, 552, 5, 105, 0, 0, 552, 553, 5, 110, 0, 0, 553, 554, 5, 110, 0, 0, 554, 555, 5, 101, 0, 0, 555, 596, 5, 121, 0, 0, 556, 557, 5, 98, 0, 0, 557, 558, 5, 105, 0, 0, 558, 559, 5, 116, 0, 0, 559, 596, 5, 115, 0, 0, 560, 561, 5, 98, 0, 0, 561, 562, 5, 105, 0, 0, 562, 563, 5, 116, 0, 0, 563, 564, 5, 99, 0, 0, 564, 565, 5, 111, 0, 0, 565, 566, 5, 105, 0, 0, 566, 596, 5, 110, 0, 0, 567, 568, 5, 115, 0, 0, 568, 569, 5, 101, 0, 0, 569, 570, 5, 99, 0, 0, 570, 571, 5, 111, 0, 0, 571, 572, 5, 110, 0, 0, 572, 573, 5, 100, 0, 0, 573, 596, 5, 115, 0, 0, 574, 575, 5, 109, 0, 0, 575, 576, 5, 105, 0, 0, 576, 577, 5, 110, 0, 0, 577, 578, 5, 117, 0, 0, 578, 579, 5, 116, 0, 0, 579, 580, 5, 101, 0, 0, 580, 596, 5, 115, 0, 0, 581, 582, 5, 104, 0, 0, 582, 583, 5, 111, 0, 0, 583, 584, 5, 117, 0, 0, 584, 585, 5, 114, 0, 0, 585, 596, 5, 115, 0, 0, 586, 587, 5, 100, 0, 0, 587, 588, 5, 97, 0, 0, 588, 589, 5, 121, 0, 0, 589, 596, 5, 115, 0, 0, 590, 591, 5, 119, 0, 0, 591, 592, 5, 101, 0, 0, 592, 593, 5, 101, 0, 0, 593, 594, 5, 107, 0, 0, 594, 596, 5, 115, 0, 0, 595, 538, 1, 0, 0, 0, 595, 546, 1, 0, 0, 0, 595, 550, 1, 0, 0, 0, 595, 556, 1, 0, 0, 0, 595, 560, 1, 0, 0, 0, 595, 567, 1, 0, 0, 0, 595, 574, 1, 0, 0, 0, 595, 581, 1, 0, 0, 0, 595, 586, 1, 0, 0, 0, 595, 590, 1, 0, 0, 0, 596, 120, 1, 0, 0, 0, 597, 599, 5, 45, 0, 0, 598, 597, 1, 0, 0, 0, 598, 599, 1, 0, 0, 0, 599, 600, 1, 0, 0, 0, 600, 602, 3, 123, 61, 0, 601, 603, 3, 125, 62, 0, 602, 601, 1, 0, 0, 0, 602, 603, 1, 0, 0, 0, 603, 122, 1, 0, 0, 0, 604, 606, 7, 0, 0, 0, 605, 604, 1, 0, 0, 0, 606, 607, 1, 0, 0, 0, 607, 605, 1, 0, 0, 0, 607, 608, 1, 0, 0, 0, 608, 617, 1, 0, 0, 0, 609, 611, 5, 95, 0, 0, 610, 612, 7, 0, 0, 0, 611, 610, 1, 0, 0, 0, 612, 613, 1, 0, 0, 0, 613, 611, 1, 0, 0, 0, 613, 614, 1, 0, 0, 0, 614, 616, 1, 0, 0, 0, 615, 609, 1, 0, 0, 0, 616, 619, 1, 0, 0, 0, 617, 615, 1, 0, 0, 0, 617, 618, 1, 0, 0, 0, 618, 124, 1, 0, 0, 0, 619, 617, 1, 0, 0, 0, 620, 621, 7, 1, 0, 0, 621, 622, 3, 123, 61, 0, 622, 126, 1, 0, 0, 0, 623, 624, 5, 98, 0, 0, 624, 625, 5, 121, 0, 0, 625, 626, 5, 116, 0, 0, 626, 627, 5, 101, 0, 0, 627, 628, 5, 115, 0, 0, 628, 630, 1, 0, 0, 0, 629, 631, 3, 129, 64, 0, 630, 629, 1, 0, 0, 0, 630, 631, 1, 0, 0, 0, 631, 637, 1, 0, 0, 0, 632, 633, 5, 98, 0, 0, 633, 634, 5, 121, 0, 0, 634, 635, 5, 116, 0, 0, 635, 637, 5, 101, 0, 0, 636, 623, 1, 0, 0, 0, 636, 632, 1, 0, 0, 0, 637, 128, 1, 0, 0, 0, 638, 642, 7, 2, 0, 0, 639, 641, 7, 0, 0, 0, 640, 639, 1, 0, 0, 0, 641, 644, 1, 0, 0, 0, 642, 640, 1, 0, 0, 0, 642, 643, 1, 0, 0, 0, 643, 130, 1, 0, 0, 0, 644, 642, 1, 0, 0, 0, 645, 651, 5, 34, 0, 0, 646, 647, 5, 92, 0, 0, 647, 650, 5, 34, 0, 0, 648, 650, 8, 3, 0, 0, 649, 646, 1, 0, 0, 0, 649, 648, 1, 0, 0, 0, 650, 653, 1, 0, 0, 0, 651, 652, 1, 0, 0, 0, 651, 649, 1, 0, 0, 0, 652, 654, 1, 0, 0, 0, 653, 651, 1, 0, 0, 0, 654, 666, 5, 34, 0, 0, 655, 661, 5, 39, 0, 0, 656, 657, 5, 92, 0, 0, 657, 660, 5, 39, 0, 0, 658, 660, 8, 4, 0, 0, 659, 656, 1, 0, 0, 0, 659, 658, 1, 0, 0, 0, 660, 663, 1, 0, 0, 0, 661, 662, 1, 0, 0, 0, 661, 659, 1, 0, 0, 0, 662, 664, 1, 0, 0, 0, 663, 661, 1, 0, 0, 0, 664, 666, 5, 39, 0, 0, 665, 645, 1, 0, 0, 0, 665, 655, 1, 0, 0, 0, 666, 132, 1, 0, 0, 0, 667, 668, 5, 100, 0, 0, 668, 669, 5, 97, 0, 0, 669, 670, 5, 116, 0, 0, 670, 671, 5, 101, 0, 0, 671, 672, 5, 40, 0, 0, 672, 673, 1, 0, 0, 0, 673, 674, 3, 131, 65, 0, 674, 675, 5, 41, 0, 0, 675, 134, 1, 0, 0, 0, 676, 677, 5, 48, 0, 0, 677, 681, 7, 5, 0, 0, 678, 680, 7, 6, 0, 0, 679, 678, 1, 0, 0, 0, 680, 683, 1, 0, 0, 0, 681, 679, 1, 0, 0, 0, 681, 682, 1, 0, 0, 0, 682, 136, 1, 0, 0, 0, 683, 681, 1, 0, 0, 0, 684, 685, 5, 116, 0, 0, 685, 686, 5, 104, 0, 0, 686, 687, 5, 105, 0, 0, 687, 688, 5, 115, 0, 0, 688, 689, 5, 46, 0, 0, 689, 690, 5, 97, 0, 0, 690, 691, 5, 103, 0, 0, 691, 700, 5, 101, 0, 0, 692, 693, 5, 116, 0, 0, 693, 694, 5, 120, 0, 0, 694, 695, 5, 46, 0, 0, 695, 696, 5, 116, 0, 0, 696, 697, 5, 105, 0, 0, 697, 698, 5, 109, 0, 0, 698, 700, 5, 101, 0, 0, 699, 684, 1, 0, 0, 0, 699, 692, 1, 0, 0, 0, 700, 138, 1, 0, 0, 0, 701, 702, 5, 116, 0, 0, 702, 703, 5, 104, 0, 0, 703, 704, 5, 105, 0, 0, 704, 705, 5, 115, 0, 0, 705, 706, 5, 46, 0, 0, 706, 707, 5, 97, 0, 0, 707, 708, 5, 99, 0, 0, 708, 709, 5, 116, 0, 0, 709, 710, 5, 105, 0, 0, 710, 711, 5, 118, 0, 0, 711, 712, 5, 101, 0, 0, 712, 713, 5, 73, 0, 0, 713, 714, 5, 110, 0, 0, 714, 715, 5, 112, 0, 0, 715, 716, 5, 117, 0, 0, 716, 717, 5, 116, 0, 0, 717, 718, 5, 73, 0, 0, 718, 719, 5, 110, 0, 0, 719, 720, 5, 100, 0, 0, 720, 721, 5, 101, 0, 0, 721, 796, 5, 120, 0, 0, 722, 723, 5, 116, 0, 0, 723, 724, 5, 104, 0, 0, 724, 725, 5, 105, 0, 0, 725, 726, 5, 115, 0, 0, 726, 727, 5, 46, 0, 0, 727, 728, 5, 97, 0, 0, 728, 729, 5, 99, 0, 0, 729, 730, 5, 116, 0, 0, 730, 731, 5, 105, 0, 0, 731, 732, 5, 118, 0, 0, 732, 733, 5, 101, 0, 0, 733, 734, 5, 66, 0, 0, 734, 735, 5, 121, 0, 0, 735, 736, 5, 116, 0, 0, 736, 737, 5, 101, 0, 0, 737, 738, 5, 99, 0, 0, 738, 739, 5, 111, 0, 0, 739, 740, 5, 100, 0, 0, 740, 796, 5, 101, 0, 0, 741, 742, 5, 116, 0, 0, 742, 743, 5, 120, 0, 0, 743, 744, 5, 46, 0, 0, 744, 745, 5, 105, 0, 0, 745, 746, 5, 110, 0, 0, 746, 747, 5, 112, 0, 0, 747, 748, 5, 117, 0, 0, 748, 749, 5, 116, 0, 0, 749, 750, 5, 115, 0, 0, 750, 751, 5, 46, 0, 0, 751, 752, 5, 108, 0, 0, 752, 753, 5, 101, 0, 0, 753, 754, 5, 110, 0, 0, 754, 755, 5, 103, 0, 0, 755, 756, 5, 116, 0, 0, 756, 796, 5, 104, 0, 0, 757, 758, 5, 116, 0, 0, 758, 759, 5, 120, 0, 0, 759, 760, 5, 46, 0, 0, 760, 761, 5, 111, 0, 0, 761, 762, 5, 117, 0, 0, 762, 763, 5, 116, 0, 0, 763, 764, 5, 112, 0, 0, 764, 765, 5, 117, 0, 0, 765, 766, 5, 116, 0, 0, 766, 767, 5, 115, 0, 0, 767, 768, 5, 46, 0, 0, 768, 769, 5, 108, 0, 0, 769, 770, 5, 101, 0, 0, 770, 771, 5, 110, 0, 0, 771, 772, 5, 103, 0, 0, 772, 773, 5, 116, 0, 0, 773, 796, 5, 104, 0, 0, 774, 775, 5, 116, 0, 0, 775, 776, 5, 120, 0, 0, 776, 777, 5, 46, 0, 0, 777, 778, 5, 118, 0, 0, 778, 779, 5, 101, 0, 0, 779, 780, 5, 114, 0, 0, 780, 781, 5, 115, 0, 0, 781, 782, 5, 105, 0, 0, 782, 783, 5, 111, 0, 0, 783, 796, 5, 110, 0, 0, 784, 785, 5, 116, 0, 0, 785, 786, 5, 120, 0, 0, 786, 787, 5, 46, 0, 0, 787, 788, 5, 108, 0, 0, 788, 789, 5, 111, 0, 0, 789, 790, 5, 99, 0, 0, 790, 791, 5, 107, 0, 0, 791, 792, 5, 116, 0, 0, 792, 793, 5, 105, 0, 0, 793, 794, 5, 109, 0, 0, 794, 796, 5, 101, 0, 0, 795, 701, 1, 0, 0, 0, 795, 722, 1, 0, 0, 0, 795, 741, 1, 0, 0, 0, 795, 757, 1, 0, 0, 0, 795, 774, 1, 0, 0, 0, 795, 784, 1, 0, 0, 0, 796, 140, 1, 0, 0, 0, 797, 801, 7, 7, 0, 0, 798, 800, 7, 8, 0, 0, 799, 798, 1, 0, 0, 0, 800, 803, 1, 0, 0, 0, 801, 799, 1, 0, 0, 0, 801, 802, 1, 0, 0, 0, 802, 142, 1, 0, 0, 0, 803, 801, 1, 0, 0, 0, 804, 806, 7, 9, 0, 0, 805, 804, 1, 0, 0, 0, 806, 807, 1, 0, 0, 0, 807, 805, 1, 0, 0, 0, 807, 808, 1, 0, 0, 0, 808, 809, 1, 0, 0, 0, 809, 810, 6, 71, 0, 0, 810, 144, 1, 0, 0, 0, 811, 812, 5, 47, 0, 0, 812, 813, 5, 42, 0, 0, 813, 817, 1, 0, 0, 0, 814, 816, 9, 0, 0, 0, 815, 814, 1, 0, 0, 0, 816, 819, 1, 0, 0, 0, 817, 818, 1, 0, 0, 0, 817, 815, 1, 0, 0, 0, 818, 820, 1, 0, 0, 0, 819, 817, 1, 0, 0, 0, 820, 821, 5, 42, 0, 0, 821, 822, 5, 47, 0, 0, 822, 823, 1, 0, 0, 0, 823, 824, 6, 72, 1, 0, 824, 146, 1, 0, 0, 0, 825, 826, 5, 47, 0, 0, 826, 827, 5, 47, 0, 0, 827, 831, 1, 0, 0, 0, 828, 830, 8, 10, 0, 0, 829, 828, 1, 0, 0, 0, 830, 833, 1, 0, 0, 0, 831, 829, 1, 0, 0, 0, 831, 832, 1, 0, 0, 0, 832, 834, 1, 0, 0, 0, 833, 831, 1, 0, 0, 0, 834, 835, 6, 73, 1, 0, 835, 148, 1, 0, 0, 0, 26, 0, 513, 519, 525, 536, 595, 598, 602, 607, 613, 617, 630, 636, 642, 649, 651, 659, 661, 665, 681, 699, 795, 801, 807, 817, 831, 2, 6, 0, 0, 0, 1, 0]
\ No newline at end of file
diff --git a/packages/cashc/src/grammar/CashScriptLexer.ts b/packages/cashc/src/grammar/CashScriptLexer.ts
index 3310a249..87add6e5 100644
--- a/packages/cashc/src/grammar/CashScriptLexer.ts
+++ b/packages/cashc/src/grammar/CashScriptLexer.ts
@@ -204,7 +204,7 @@ export default class CashScriptLexer extends Lexer {
 
 	public get modeNames(): string[] { return CashScriptLexer.modeNames; }
 
-	public static readonly _serializedATN: number[] = [4,0,74,834,6,-1,2,0,
+	public static readonly _serializedATN: number[] = [4,0,74,836,6,-1,2,0,
 	7,0,2,1,7,1,2,2,7,2,2,3,7,3,2,4,7,4,2,5,7,5,2,6,7,6,2,7,7,7,2,8,7,8,2,9,
 	7,9,2,10,7,10,2,11,7,11,2,12,7,12,2,13,7,13,2,14,7,14,2,15,7,15,2,16,7,
 	16,2,17,7,17,2,18,7,18,2,19,7,19,2,20,7,20,2,21,7,21,2,22,7,22,2,23,7,23,
@@ -254,79 +254,79 @@ export default class CashScriptLexer extends Lexer {
 	1,65,1,65,5,65,660,8,65,10,65,12,65,663,9,65,1,65,3,65,666,8,65,1,66,1,
 	66,1,66,1,66,1,66,1,66,1,66,1,66,1,66,1,67,1,67,1,67,5,67,680,8,67,10,67,
 	12,67,683,9,67,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,68,1,
-	68,1,68,3,68,698,8,68,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,
+	68,1,68,1,68,1,68,3,68,700,8,68,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,
 	1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,
 	69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,
 	1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,
 	69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,
 	1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,
-	69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,3,69,794,8,69,
-	1,70,1,70,5,70,798,8,70,10,70,12,70,801,9,70,1,71,4,71,804,8,71,11,71,12,
-	71,805,1,71,1,71,1,72,1,72,1,72,1,72,5,72,814,8,72,10,72,12,72,817,9,72,
-	1,72,1,72,1,72,1,72,1,72,1,73,1,73,1,73,1,73,5,73,828,8,73,10,73,12,73,
-	831,9,73,1,73,1,73,3,651,661,815,0,74,1,1,3,2,5,3,7,4,9,5,11,6,13,7,15,
-	8,17,9,19,10,21,11,23,12,25,13,27,14,29,15,31,16,33,17,35,18,37,19,39,20,
-	41,21,43,22,45,23,47,24,49,25,51,26,53,27,55,28,57,29,59,30,61,31,63,32,
-	65,33,67,34,69,35,71,36,73,37,75,38,77,39,79,40,81,41,83,42,85,43,87,44,
-	89,45,91,46,93,47,95,48,97,49,99,50,101,51,103,52,105,53,107,54,109,55,
-	111,56,113,57,115,58,117,59,119,60,121,61,123,62,125,63,127,64,129,65,131,
-	66,133,67,135,68,137,69,139,70,141,71,143,72,145,73,147,74,1,0,11,1,0,48,
-	57,2,0,69,69,101,101,1,0,49,57,3,0,10,10,13,13,34,34,3,0,10,10,13,13,39,
-	39,2,0,88,88,120,120,3,0,48,57,65,70,97,102,2,0,65,90,97,122,4,0,48,57,
-	65,90,95,95,97,122,3,0,9,10,12,13,32,32,2,0,10,10,13,13,870,0,1,1,0,0,0,
-	0,3,1,0,0,0,0,5,1,0,0,0,0,7,1,0,0,0,0,9,1,0,0,0,0,11,1,0,0,0,0,13,1,0,0,
-	0,0,15,1,0,0,0,0,17,1,0,0,0,0,19,1,0,0,0,0,21,1,0,0,0,0,23,1,0,0,0,0,25,
-	1,0,0,0,0,27,1,0,0,0,0,29,1,0,0,0,0,31,1,0,0,0,0,33,1,0,0,0,0,35,1,0,0,
-	0,0,37,1,0,0,0,0,39,1,0,0,0,0,41,1,0,0,0,0,43,1,0,0,0,0,45,1,0,0,0,0,47,
-	1,0,0,0,0,49,1,0,0,0,0,51,1,0,0,0,0,53,1,0,0,0,0,55,1,0,0,0,0,57,1,0,0,
-	0,0,59,1,0,0,0,0,61,1,0,0,0,0,63,1,0,0,0,0,65,1,0,0,0,0,67,1,0,0,0,0,69,
-	1,0,0,0,0,71,1,0,0,0,0,73,1,0,0,0,0,75,1,0,0,0,0,77,1,0,0,0,0,79,1,0,0,
-	0,0,81,1,0,0,0,0,83,1,0,0,0,0,85,1,0,0,0,0,87,1,0,0,0,0,89,1,0,0,0,0,91,
-	1,0,0,0,0,93,1,0,0,0,0,95,1,0,0,0,0,97,1,0,0,0,0,99,1,0,0,0,0,101,1,0,0,
-	0,0,103,1,0,0,0,0,105,1,0,0,0,0,107,1,0,0,0,0,109,1,0,0,0,0,111,1,0,0,0,
-	0,113,1,0,0,0,0,115,1,0,0,0,0,117,1,0,0,0,0,119,1,0,0,0,0,121,1,0,0,0,0,
-	123,1,0,0,0,0,125,1,0,0,0,0,127,1,0,0,0,0,129,1,0,0,0,0,131,1,0,0,0,0,133,
-	1,0,0,0,0,135,1,0,0,0,0,137,1,0,0,0,0,139,1,0,0,0,0,141,1,0,0,0,0,143,1,
-	0,0,0,0,145,1,0,0,0,0,147,1,0,0,0,1,149,1,0,0,0,3,156,1,0,0,0,5,158,1,0,
-	0,0,7,169,1,0,0,0,9,171,1,0,0,0,11,173,1,0,0,0,13,176,1,0,0,0,15,178,1,
-	0,0,0,17,180,1,0,0,0,19,183,1,0,0,0,21,185,1,0,0,0,23,194,1,0,0,0,25,196,
-	1,0,0,0,27,198,1,0,0,0,29,207,1,0,0,0,31,209,1,0,0,0,33,211,1,0,0,0,35,
-	213,1,0,0,0,37,221,1,0,0,0,39,224,1,0,0,0,41,229,1,0,0,0,43,241,1,0,0,0,
-	45,245,1,0,0,0,47,247,1,0,0,0,49,249,1,0,0,0,51,260,1,0,0,0,53,267,1,0,
-	0,0,55,284,1,0,0,0,57,299,1,0,0,0,59,314,1,0,0,0,61,327,1,0,0,0,63,337,
-	1,0,0,0,65,362,1,0,0,0,67,377,1,0,0,0,69,396,1,0,0,0,71,412,1,0,0,0,73,
-	423,1,0,0,0,75,431,1,0,0,0,77,438,1,0,0,0,79,440,1,0,0,0,81,442,1,0,0,0,
-	83,444,1,0,0,0,85,446,1,0,0,0,87,448,1,0,0,0,89,450,1,0,0,0,91,453,1,0,
-	0,0,93,456,1,0,0,0,95,458,1,0,0,0,97,460,1,0,0,0,99,463,1,0,0,0,101,466,
-	1,0,0,0,103,475,1,0,0,0,105,479,1,0,0,0,107,484,1,0,0,0,109,491,1,0,0,0,
-	111,498,1,0,0,0,113,502,1,0,0,0,115,511,1,0,0,0,117,536,1,0,0,0,119,595,
-	1,0,0,0,121,598,1,0,0,0,123,605,1,0,0,0,125,620,1,0,0,0,127,636,1,0,0,0,
-	129,638,1,0,0,0,131,665,1,0,0,0,133,667,1,0,0,0,135,676,1,0,0,0,137,697,
-	1,0,0,0,139,793,1,0,0,0,141,795,1,0,0,0,143,803,1,0,0,0,145,809,1,0,0,0,
-	147,823,1,0,0,0,149,150,5,112,0,0,150,151,5,114,0,0,151,152,5,97,0,0,152,
-	153,5,103,0,0,153,154,5,109,0,0,154,155,5,97,0,0,155,2,1,0,0,0,156,157,
-	5,59,0,0,157,4,1,0,0,0,158,159,5,99,0,0,159,160,5,97,0,0,160,161,5,115,
-	0,0,161,162,5,104,0,0,162,163,5,115,0,0,163,164,5,99,0,0,164,165,5,114,
-	0,0,165,166,5,105,0,0,166,167,5,112,0,0,167,168,5,116,0,0,168,6,1,0,0,0,
-	169,170,5,94,0,0,170,8,1,0,0,0,171,172,5,126,0,0,172,10,1,0,0,0,173,174,
-	5,62,0,0,174,175,5,61,0,0,175,12,1,0,0,0,176,177,5,62,0,0,177,14,1,0,0,
-	0,178,179,5,60,0,0,179,16,1,0,0,0,180,181,5,60,0,0,181,182,5,61,0,0,182,
-	18,1,0,0,0,183,184,5,61,0,0,184,20,1,0,0,0,185,186,5,99,0,0,186,187,5,111,
-	0,0,187,188,5,110,0,0,188,189,5,116,0,0,189,190,5,114,0,0,190,191,5,97,
-	0,0,191,192,5,99,0,0,192,193,5,116,0,0,193,22,1,0,0,0,194,195,5,123,0,0,
-	195,24,1,0,0,0,196,197,5,125,0,0,197,26,1,0,0,0,198,199,5,102,0,0,199,200,
-	5,117,0,0,200,201,5,110,0,0,201,202,5,99,0,0,202,203,5,116,0,0,203,204,
-	5,105,0,0,204,205,5,111,0,0,205,206,5,110,0,0,206,28,1,0,0,0,207,208,5,
-	40,0,0,208,30,1,0,0,0,209,210,5,44,0,0,210,32,1,0,0,0,211,212,5,41,0,0,
-	212,34,1,0,0,0,213,214,5,114,0,0,214,215,5,101,0,0,215,216,5,113,0,0,216,
-	217,5,117,0,0,217,218,5,105,0,0,218,219,5,114,0,0,219,220,5,101,0,0,220,
-	36,1,0,0,0,221,222,5,105,0,0,222,223,5,102,0,0,223,38,1,0,0,0,224,225,5,
-	101,0,0,225,226,5,108,0,0,226,227,5,115,0,0,227,228,5,101,0,0,228,40,1,
-	0,0,0,229,230,5,99,0,0,230,231,5,111,0,0,231,232,5,110,0,0,232,233,5,115,
-	0,0,233,234,5,111,0,0,234,235,5,108,0,0,235,236,5,101,0,0,236,237,5,46,
-	0,0,237,238,5,108,0,0,238,239,5,111,0,0,239,240,5,103,0,0,240,42,1,0,0,
-	0,241,242,5,110,0,0,242,243,5,101,0,0,243,244,5,119,0,0,244,44,1,0,0,0,
-	245,246,5,91,0,0,246,46,1,0,0,0,247,248,5,93,0,0,248,48,1,0,0,0,249,250,
+	69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,1,69,3,69,
+	796,8,69,1,70,1,70,5,70,800,8,70,10,70,12,70,803,9,70,1,71,4,71,806,8,71,
+	11,71,12,71,807,1,71,1,71,1,72,1,72,1,72,1,72,5,72,816,8,72,10,72,12,72,
+	819,9,72,1,72,1,72,1,72,1,72,1,72,1,73,1,73,1,73,1,73,5,73,830,8,73,10,
+	73,12,73,833,9,73,1,73,1,73,3,651,661,817,0,74,1,1,3,2,5,3,7,4,9,5,11,6,
+	13,7,15,8,17,9,19,10,21,11,23,12,25,13,27,14,29,15,31,16,33,17,35,18,37,
+	19,39,20,41,21,43,22,45,23,47,24,49,25,51,26,53,27,55,28,57,29,59,30,61,
+	31,63,32,65,33,67,34,69,35,71,36,73,37,75,38,77,39,79,40,81,41,83,42,85,
+	43,87,44,89,45,91,46,93,47,95,48,97,49,99,50,101,51,103,52,105,53,107,54,
+	109,55,111,56,113,57,115,58,117,59,119,60,121,61,123,62,125,63,127,64,129,
+	65,131,66,133,67,135,68,137,69,139,70,141,71,143,72,145,73,147,74,1,0,11,
+	1,0,48,57,2,0,69,69,101,101,1,0,49,57,3,0,10,10,13,13,34,34,3,0,10,10,13,
+	13,39,39,2,0,88,88,120,120,3,0,48,57,65,70,97,102,2,0,65,90,97,122,4,0,
+	48,57,65,90,95,95,97,122,3,0,9,10,12,13,32,32,2,0,10,10,13,13,872,0,1,1,
+	0,0,0,0,3,1,0,0,0,0,5,1,0,0,0,0,7,1,0,0,0,0,9,1,0,0,0,0,11,1,0,0,0,0,13,
+	1,0,0,0,0,15,1,0,0,0,0,17,1,0,0,0,0,19,1,0,0,0,0,21,1,0,0,0,0,23,1,0,0,
+	0,0,25,1,0,0,0,0,27,1,0,0,0,0,29,1,0,0,0,0,31,1,0,0,0,0,33,1,0,0,0,0,35,
+	1,0,0,0,0,37,1,0,0,0,0,39,1,0,0,0,0,41,1,0,0,0,0,43,1,0,0,0,0,45,1,0,0,
+	0,0,47,1,0,0,0,0,49,1,0,0,0,0,51,1,0,0,0,0,53,1,0,0,0,0,55,1,0,0,0,0,57,
+	1,0,0,0,0,59,1,0,0,0,0,61,1,0,0,0,0,63,1,0,0,0,0,65,1,0,0,0,0,67,1,0,0,
+	0,0,69,1,0,0,0,0,71,1,0,0,0,0,73,1,0,0,0,0,75,1,0,0,0,0,77,1,0,0,0,0,79,
+	1,0,0,0,0,81,1,0,0,0,0,83,1,0,0,0,0,85,1,0,0,0,0,87,1,0,0,0,0,89,1,0,0,
+	0,0,91,1,0,0,0,0,93,1,0,0,0,0,95,1,0,0,0,0,97,1,0,0,0,0,99,1,0,0,0,0,101,
+	1,0,0,0,0,103,1,0,0,0,0,105,1,0,0,0,0,107,1,0,0,0,0,109,1,0,0,0,0,111,1,
+	0,0,0,0,113,1,0,0,0,0,115,1,0,0,0,0,117,1,0,0,0,0,119,1,0,0,0,0,121,1,0,
+	0,0,0,123,1,0,0,0,0,125,1,0,0,0,0,127,1,0,0,0,0,129,1,0,0,0,0,131,1,0,0,
+	0,0,133,1,0,0,0,0,135,1,0,0,0,0,137,1,0,0,0,0,139,1,0,0,0,0,141,1,0,0,0,
+	0,143,1,0,0,0,0,145,1,0,0,0,0,147,1,0,0,0,1,149,1,0,0,0,3,156,1,0,0,0,5,
+	158,1,0,0,0,7,169,1,0,0,0,9,171,1,0,0,0,11,173,1,0,0,0,13,176,1,0,0,0,15,
+	178,1,0,0,0,17,180,1,0,0,0,19,183,1,0,0,0,21,185,1,0,0,0,23,194,1,0,0,0,
+	25,196,1,0,0,0,27,198,1,0,0,0,29,207,1,0,0,0,31,209,1,0,0,0,33,211,1,0,
+	0,0,35,213,1,0,0,0,37,221,1,0,0,0,39,224,1,0,0,0,41,229,1,0,0,0,43,241,
+	1,0,0,0,45,245,1,0,0,0,47,247,1,0,0,0,49,249,1,0,0,0,51,260,1,0,0,0,53,
+	267,1,0,0,0,55,284,1,0,0,0,57,299,1,0,0,0,59,314,1,0,0,0,61,327,1,0,0,0,
+	63,337,1,0,0,0,65,362,1,0,0,0,67,377,1,0,0,0,69,396,1,0,0,0,71,412,1,0,
+	0,0,73,423,1,0,0,0,75,431,1,0,0,0,77,438,1,0,0,0,79,440,1,0,0,0,81,442,
+	1,0,0,0,83,444,1,0,0,0,85,446,1,0,0,0,87,448,1,0,0,0,89,450,1,0,0,0,91,
+	453,1,0,0,0,93,456,1,0,0,0,95,458,1,0,0,0,97,460,1,0,0,0,99,463,1,0,0,0,
+	101,466,1,0,0,0,103,475,1,0,0,0,105,479,1,0,0,0,107,484,1,0,0,0,109,491,
+	1,0,0,0,111,498,1,0,0,0,113,502,1,0,0,0,115,511,1,0,0,0,117,536,1,0,0,0,
+	119,595,1,0,0,0,121,598,1,0,0,0,123,605,1,0,0,0,125,620,1,0,0,0,127,636,
+	1,0,0,0,129,638,1,0,0,0,131,665,1,0,0,0,133,667,1,0,0,0,135,676,1,0,0,0,
+	137,699,1,0,0,0,139,795,1,0,0,0,141,797,1,0,0,0,143,805,1,0,0,0,145,811,
+	1,0,0,0,147,825,1,0,0,0,149,150,5,112,0,0,150,151,5,114,0,0,151,152,5,97,
+	0,0,152,153,5,103,0,0,153,154,5,109,0,0,154,155,5,97,0,0,155,2,1,0,0,0,
+	156,157,5,59,0,0,157,4,1,0,0,0,158,159,5,99,0,0,159,160,5,97,0,0,160,161,
+	5,115,0,0,161,162,5,104,0,0,162,163,5,115,0,0,163,164,5,99,0,0,164,165,
+	5,114,0,0,165,166,5,105,0,0,166,167,5,112,0,0,167,168,5,116,0,0,168,6,1,
+	0,0,0,169,170,5,94,0,0,170,8,1,0,0,0,171,172,5,126,0,0,172,10,1,0,0,0,173,
+	174,5,62,0,0,174,175,5,61,0,0,175,12,1,0,0,0,176,177,5,62,0,0,177,14,1,
+	0,0,0,178,179,5,60,0,0,179,16,1,0,0,0,180,181,5,60,0,0,181,182,5,61,0,0,
+	182,18,1,0,0,0,183,184,5,61,0,0,184,20,1,0,0,0,185,186,5,99,0,0,186,187,
+	5,111,0,0,187,188,5,110,0,0,188,189,5,116,0,0,189,190,5,114,0,0,190,191,
+	5,97,0,0,191,192,5,99,0,0,192,193,5,116,0,0,193,22,1,0,0,0,194,195,5,123,
+	0,0,195,24,1,0,0,0,196,197,5,125,0,0,197,26,1,0,0,0,198,199,5,102,0,0,199,
+	200,5,117,0,0,200,201,5,110,0,0,201,202,5,99,0,0,202,203,5,116,0,0,203,
+	204,5,105,0,0,204,205,5,111,0,0,205,206,5,110,0,0,206,28,1,0,0,0,207,208,
+	5,40,0,0,208,30,1,0,0,0,209,210,5,44,0,0,210,32,1,0,0,0,211,212,5,41,0,
+	0,212,34,1,0,0,0,213,214,5,114,0,0,214,215,5,101,0,0,215,216,5,113,0,0,
+	216,217,5,117,0,0,217,218,5,105,0,0,218,219,5,114,0,0,219,220,5,101,0,0,
+	220,36,1,0,0,0,221,222,5,105,0,0,222,223,5,102,0,0,223,38,1,0,0,0,224,225,
+	5,101,0,0,225,226,5,108,0,0,226,227,5,115,0,0,227,228,5,101,0,0,228,40,
+	1,0,0,0,229,230,5,99,0,0,230,231,5,111,0,0,231,232,5,110,0,0,232,233,5,
+	115,0,0,233,234,5,111,0,0,234,235,5,108,0,0,235,236,5,101,0,0,236,237,5,
+	46,0,0,237,238,5,108,0,0,238,239,5,111,0,0,239,240,5,103,0,0,240,42,1,0,
+	0,0,241,242,5,110,0,0,242,243,5,101,0,0,243,244,5,119,0,0,244,44,1,0,0,
+	0,245,246,5,91,0,0,246,46,1,0,0,0,247,248,5,93,0,0,248,48,1,0,0,0,249,250,
 	5,116,0,0,250,251,5,120,0,0,251,252,5,46,0,0,252,253,5,111,0,0,253,254,
 	5,117,0,0,254,255,5,116,0,0,255,256,5,112,0,0,256,257,5,117,0,0,257,258,
 	5,116,0,0,258,259,5,115,0,0,259,50,1,0,0,0,260,261,5,46,0,0,261,262,5,118,
@@ -437,47 +437,47 @@ export default class CashScriptLexer extends Lexer {
 	5,101,0,0,671,672,5,40,0,0,672,673,1,0,0,0,673,674,3,131,65,0,674,675,5,
 	41,0,0,675,134,1,0,0,0,676,677,5,48,0,0,677,681,7,5,0,0,678,680,7,6,0,0,
 	679,678,1,0,0,0,680,683,1,0,0,0,681,679,1,0,0,0,681,682,1,0,0,0,682,136,
-	1,0,0,0,683,681,1,0,0,0,684,685,5,116,0,0,685,686,5,120,0,0,686,687,5,46,
-	0,0,687,688,5,97,0,0,688,689,5,103,0,0,689,698,5,101,0,0,690,691,5,116,
-	0,0,691,692,5,120,0,0,692,693,5,46,0,0,693,694,5,116,0,0,694,695,5,105,
-	0,0,695,696,5,109,0,0,696,698,5,101,0,0,697,684,1,0,0,0,697,690,1,0,0,0,
-	698,138,1,0,0,0,699,700,5,116,0,0,700,701,5,104,0,0,701,702,5,105,0,0,702,
-	703,5,115,0,0,703,704,5,46,0,0,704,705,5,97,0,0,705,706,5,99,0,0,706,707,
-	5,116,0,0,707,708,5,105,0,0,708,709,5,118,0,0,709,710,5,101,0,0,710,711,
-	5,73,0,0,711,712,5,110,0,0,712,713,5,112,0,0,713,714,5,117,0,0,714,715,
-	5,116,0,0,715,716,5,73,0,0,716,717,5,110,0,0,717,718,5,100,0,0,718,719,
-	5,101,0,0,719,794,5,120,0,0,720,721,5,116,0,0,721,722,5,104,0,0,722,723,
-	5,105,0,0,723,724,5,115,0,0,724,725,5,46,0,0,725,726,5,97,0,0,726,727,5,
-	99,0,0,727,728,5,116,0,0,728,729,5,105,0,0,729,730,5,118,0,0,730,731,5,
-	101,0,0,731,732,5,66,0,0,732,733,5,121,0,0,733,734,5,116,0,0,734,735,5,
-	101,0,0,735,736,5,99,0,0,736,737,5,111,0,0,737,738,5,100,0,0,738,794,5,
-	101,0,0,739,740,5,116,0,0,740,741,5,120,0,0,741,742,5,46,0,0,742,743,5,
-	105,0,0,743,744,5,110,0,0,744,745,5,112,0,0,745,746,5,117,0,0,746,747,5,
-	116,0,0,747,748,5,115,0,0,748,749,5,46,0,0,749,750,5,108,0,0,750,751,5,
-	101,0,0,751,752,5,110,0,0,752,753,5,103,0,0,753,754,5,116,0,0,754,794,5,
-	104,0,0,755,756,5,116,0,0,756,757,5,120,0,0,757,758,5,46,0,0,758,759,5,
-	111,0,0,759,760,5,117,0,0,760,761,5,116,0,0,761,762,5,112,0,0,762,763,5,
-	117,0,0,763,764,5,116,0,0,764,765,5,115,0,0,765,766,5,46,0,0,766,767,5,
-	108,0,0,767,768,5,101,0,0,768,769,5,110,0,0,769,770,5,103,0,0,770,771,5,
-	116,0,0,771,794,5,104,0,0,772,773,5,116,0,0,773,774,5,120,0,0,774,775,5,
-	46,0,0,775,776,5,118,0,0,776,777,5,101,0,0,777,778,5,114,0,0,778,779,5,
-	115,0,0,779,780,5,105,0,0,780,781,5,111,0,0,781,794,5,110,0,0,782,783,5,
-	116,0,0,783,784,5,120,0,0,784,785,5,46,0,0,785,786,5,108,0,0,786,787,5,
-	111,0,0,787,788,5,99,0,0,788,789,5,107,0,0,789,790,5,116,0,0,790,791,5,
-	105,0,0,791,792,5,109,0,0,792,794,5,101,0,0,793,699,1,0,0,0,793,720,1,0,
-	0,0,793,739,1,0,0,0,793,755,1,0,0,0,793,772,1,0,0,0,793,782,1,0,0,0,794,
-	140,1,0,0,0,795,799,7,7,0,0,796,798,7,8,0,0,797,796,1,0,0,0,798,801,1,0,
-	0,0,799,797,1,0,0,0,799,800,1,0,0,0,800,142,1,0,0,0,801,799,1,0,0,0,802,
-	804,7,9,0,0,803,802,1,0,0,0,804,805,1,0,0,0,805,803,1,0,0,0,805,806,1,0,
-	0,0,806,807,1,0,0,0,807,808,6,71,0,0,808,144,1,0,0,0,809,810,5,47,0,0,810,
-	811,5,42,0,0,811,815,1,0,0,0,812,814,9,0,0,0,813,812,1,0,0,0,814,817,1,
-	0,0,0,815,816,1,0,0,0,815,813,1,0,0,0,816,818,1,0,0,0,817,815,1,0,0,0,818,
-	819,5,42,0,0,819,820,5,47,0,0,820,821,1,0,0,0,821,822,6,72,1,0,822,146,
-	1,0,0,0,823,824,5,47,0,0,824,825,5,47,0,0,825,829,1,0,0,0,826,828,8,10,
-	0,0,827,826,1,0,0,0,828,831,1,0,0,0,829,827,1,0,0,0,829,830,1,0,0,0,830,
-	832,1,0,0,0,831,829,1,0,0,0,832,833,6,73,1,0,833,148,1,0,0,0,26,0,513,519,
-	525,536,595,598,602,607,613,617,630,636,642,649,651,659,661,665,681,697,
-	793,799,805,815,829,2,6,0,0,0,1,0];
+	1,0,0,0,683,681,1,0,0,0,684,685,5,116,0,0,685,686,5,104,0,0,686,687,5,105,
+	0,0,687,688,5,115,0,0,688,689,5,46,0,0,689,690,5,97,0,0,690,691,5,103,0,
+	0,691,700,5,101,0,0,692,693,5,116,0,0,693,694,5,120,0,0,694,695,5,46,0,
+	0,695,696,5,116,0,0,696,697,5,105,0,0,697,698,5,109,0,0,698,700,5,101,0,
+	0,699,684,1,0,0,0,699,692,1,0,0,0,700,138,1,0,0,0,701,702,5,116,0,0,702,
+	703,5,104,0,0,703,704,5,105,0,0,704,705,5,115,0,0,705,706,5,46,0,0,706,
+	707,5,97,0,0,707,708,5,99,0,0,708,709,5,116,0,0,709,710,5,105,0,0,710,711,
+	5,118,0,0,711,712,5,101,0,0,712,713,5,73,0,0,713,714,5,110,0,0,714,715,
+	5,112,0,0,715,716,5,117,0,0,716,717,5,116,0,0,717,718,5,73,0,0,718,719,
+	5,110,0,0,719,720,5,100,0,0,720,721,5,101,0,0,721,796,5,120,0,0,722,723,
+	5,116,0,0,723,724,5,104,0,0,724,725,5,105,0,0,725,726,5,115,0,0,726,727,
+	5,46,0,0,727,728,5,97,0,0,728,729,5,99,0,0,729,730,5,116,0,0,730,731,5,
+	105,0,0,731,732,5,118,0,0,732,733,5,101,0,0,733,734,5,66,0,0,734,735,5,
+	121,0,0,735,736,5,116,0,0,736,737,5,101,0,0,737,738,5,99,0,0,738,739,5,
+	111,0,0,739,740,5,100,0,0,740,796,5,101,0,0,741,742,5,116,0,0,742,743,5,
+	120,0,0,743,744,5,46,0,0,744,745,5,105,0,0,745,746,5,110,0,0,746,747,5,
+	112,0,0,747,748,5,117,0,0,748,749,5,116,0,0,749,750,5,115,0,0,750,751,5,
+	46,0,0,751,752,5,108,0,0,752,753,5,101,0,0,753,754,5,110,0,0,754,755,5,
+	103,0,0,755,756,5,116,0,0,756,796,5,104,0,0,757,758,5,116,0,0,758,759,5,
+	120,0,0,759,760,5,46,0,0,760,761,5,111,0,0,761,762,5,117,0,0,762,763,5,
+	116,0,0,763,764,5,112,0,0,764,765,5,117,0,0,765,766,5,116,0,0,766,767,5,
+	115,0,0,767,768,5,46,0,0,768,769,5,108,0,0,769,770,5,101,0,0,770,771,5,
+	110,0,0,771,772,5,103,0,0,772,773,5,116,0,0,773,796,5,104,0,0,774,775,5,
+	116,0,0,775,776,5,120,0,0,776,777,5,46,0,0,777,778,5,118,0,0,778,779,5,
+	101,0,0,779,780,5,114,0,0,780,781,5,115,0,0,781,782,5,105,0,0,782,783,5,
+	111,0,0,783,796,5,110,0,0,784,785,5,116,0,0,785,786,5,120,0,0,786,787,5,
+	46,0,0,787,788,5,108,0,0,788,789,5,111,0,0,789,790,5,99,0,0,790,791,5,107,
+	0,0,791,792,5,116,0,0,792,793,5,105,0,0,793,794,5,109,0,0,794,796,5,101,
+	0,0,795,701,1,0,0,0,795,722,1,0,0,0,795,741,1,0,0,0,795,757,1,0,0,0,795,
+	774,1,0,0,0,795,784,1,0,0,0,796,140,1,0,0,0,797,801,7,7,0,0,798,800,7,8,
+	0,0,799,798,1,0,0,0,800,803,1,0,0,0,801,799,1,0,0,0,801,802,1,0,0,0,802,
+	142,1,0,0,0,803,801,1,0,0,0,804,806,7,9,0,0,805,804,1,0,0,0,806,807,1,0,
+	0,0,807,805,1,0,0,0,807,808,1,0,0,0,808,809,1,0,0,0,809,810,6,71,0,0,810,
+	144,1,0,0,0,811,812,5,47,0,0,812,813,5,42,0,0,813,817,1,0,0,0,814,816,9,
+	0,0,0,815,814,1,0,0,0,816,819,1,0,0,0,817,818,1,0,0,0,817,815,1,0,0,0,818,
+	820,1,0,0,0,819,817,1,0,0,0,820,821,5,42,0,0,821,822,5,47,0,0,822,823,1,
+	0,0,0,823,824,6,72,1,0,824,146,1,0,0,0,825,826,5,47,0,0,826,827,5,47,0,
+	0,827,831,1,0,0,0,828,830,8,10,0,0,829,828,1,0,0,0,830,833,1,0,0,0,831,
+	829,1,0,0,0,831,832,1,0,0,0,832,834,1,0,0,0,833,831,1,0,0,0,834,835,6,73,
+	1,0,835,148,1,0,0,0,26,0,513,519,525,536,595,598,602,607,613,617,630,636,
+	642,649,651,659,661,665,681,699,795,801,807,817,831,2,6,0,0,0,1,0];
 
 	private static __ATN: ATN;
 	public static get _ATN(): ATN {
diff --git a/packages/cashc/test/ast/Location.test.ts b/packages/cashc/test/ast/Location.test.ts
index d6a70891..4f7d9418 100644
--- a/packages/cashc/test/ast/Location.test.ts
+++ b/packages/cashc/test/ast/Location.test.ts
@@ -37,7 +37,7 @@ contract test() {
       'abs(-1) == 1', 'within(1,1,1) == true', 'bytes(sha256(1)) == bytes(0x01)',
       'checkSig(sig(0x00), pubkey(0x00))', 'checkMultiSig([sig(0x00), sig(0x00)], [pubkey(0x00), pubkey(0x00)])',
       'checkDataSig(datasig(0x00), 0x00, pubkey(0x00))',
-      'tx.time >= 1', 'tx.age >= 1',
+      'tx.time >= 1', 'this.age >= 1',
       'bytes(1) == 0x01', 'int(0x01) == 1',
     ];
 
diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index 5735b517..e328e816 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -558,7 +558,7 @@ export const fixtures: Fixture[] = [
       bytecode:
         // function receive
         'OP_4 OP_PICK OP_0 OP_NUMEQUAL OP_IF '
-        // require(tx.age >= period)
+        // require(this.age >= period)
         + 'OP_3 OP_ROLL OP_CHECKSEQUENCEVERIFY OP_DROP '
         // require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient))
         + 'OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY '
@@ -605,7 +605,7 @@ export const fixtures: Fixture[] = [
           { ip: 91, line: 24 },
           { ip: 97, line: 25 },
         ],
-        sourceMap: '2:4:21:5;;;;;3:26:3:32;;:8::34:1;;6:27:6:28:0;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;8:23:8:27:0;9:37:9:58;:27::65:1;10:26:10:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;16:15:20:9:0;17:31:17:32;:20::39:1;:43::49:0;;:20:::1;:12::51;18:31:18:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;19:31:19:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;16:15:20:9;2:4:21:5;;;;;;;;23::26::0;;;;;24:24:24:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
+        sourceMap: '2:4:21:5;;;;;3:28:3:34;;:8::36:1;;6:27:6:28:0;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;8:23:8:27:0;9:37:9:58;:27::65:1;10:26:10:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;16:15:20:9:0;17:31:17:32;:20::39:1;:43::49:0;;:20:::1;:12::51;18:31:18:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;19:31:19:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;16:15:20:9;2:4:21:5;;;;;;;;23::26::0;;;;;24:24:24:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/mecenas.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
diff --git a/packages/cashc/test/valid-contract-files/everything.cash b/packages/cashc/test/valid-contract-files/everything.cash
index 68ef9417..63dab05c 100644
--- a/packages/cashc/test/valid-contract-files/everything.cash
+++ b/packages/cashc/test/valid-contract-files/everything.cash
@@ -17,7 +17,7 @@ contract Test(int x, string y) {
         myVariable = 10;
 
         require(ripemd160(b) == ripemd160(bytes(myVariable)));
-        require(tx.age >= 500);
+        require(this.age >= 500);
         require(y.length < -10);
 
         if (i > 400) {
diff --git a/packages/cashc/test/valid-contract-files/mecenas.cash b/packages/cashc/test/valid-contract-files/mecenas.cash
index 00bd109e..563a3aa1 100644
--- a/packages/cashc/test/valid-contract-files/mecenas.cash
+++ b/packages/cashc/test/valid-contract-files/mecenas.cash
@@ -1,6 +1,6 @@
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
     function receive() {
-        require(tx.age >= period);
+        require(this.age >= period);
 
         // Check that the first output sends to the recipient
         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));
diff --git a/packages/cashscript/test/e2e/Mecenas.test.ts b/packages/cashscript/test/e2e/Mecenas.test.ts
index bc19b82b..4d16dcd4 100644
--- a/packages/cashscript/test/e2e/Mecenas.test.ts
+++ b/packages/cashscript/test/e2e/Mecenas.test.ts
@@ -10,7 +10,7 @@ import { FailedRequireError } from '../../src/Errors.js';
 import artifact from '../fixture/mecenas.artifact.js';
 import { randomUtxo } from '../../src/utils.js';
 
-// Mecenas has tx.age check omitted for testing
+// Mecenas has this.age check omitted for testing
 describe('Mecenas', () => {
   const provider = process.env.TESTS_USE_MOCKNET
     ? new MockNetworkProvider()
diff --git a/packages/cashscript/test/fixture/bigint.artifact.ts b/packages/cashscript/test/fixture/bigint.artifact.ts
index 9658f82c..0a9f7957 100644
--- a/packages/cashscript/test/fixture/bigint.artifact.ts
+++ b/packages/cashscript/test/fixture/bigint.artifact.ts
@@ -17,7 +17,7 @@ export default {
     },
   ],
   bytecode: '000000000000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL',
-  source: 'contract BigInt() {\r\n    function proofOfBigInt(int x, int y) {\r\n        int maxInt64PlusOne = 9223372036854775808;\r\n        require(x >= maxInt64PlusOne);\r\n        require(x * y >= maxInt64PlusOne);\r\n    }\r\n}\r\n',
+  source: 'contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt64PlusOne = 9223372036854775808;\n        require(x >= maxInt64PlusOne);\n        require(x * y >= maxInt64PlusOne);\n    }\n}\n',
   debug: {
     bytecode: '0900000000000000800051795179a269517a527a95517aa2',
     sourceMap: '3:30:3:49;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1',
@@ -35,7 +35,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.5',
+    version: '0.11.0-next.1',
   },
-  updatedAt: '2025-02-10T07:12:49.834Z',
+  updatedAt: '2025-03-04T09:20:05.977Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index fc4e23e7..507f9a8a 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -17,7 +17,7 @@
     }
   ],
   "bytecode": "000000000000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL",
-  "source": "contract BigInt() {\r\n    function proofOfBigInt(int x, int y) {\r\n        int maxInt64PlusOne = 9223372036854775808;\r\n        require(x >= maxInt64PlusOne);\r\n        require(x * y >= maxInt64PlusOne);\r\n    }\r\n}\r\n",
+  "source": "contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt64PlusOne = 9223372036854775808;\n        require(x >= maxInt64PlusOne);\n        require(x * y >= maxInt64PlusOne);\n    }\n}\n",
   "debug": {
     "bytecode": "0900000000000000800051795179a269517a527a95517aa2",
     "sourceMap": "3:30:3:49;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1",
@@ -35,7 +35,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.5"
+    "version": "0.11.0-next.1"
   },
-  "updatedAt": "2025-02-10T07:11:56.680Z"
+  "updatedAt": "2025-03-04T09:20:05.760Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 83ff63ef..ba1967f2 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -379,7 +379,7 @@ export const fixtures: Fixture[] = [
         'mecenas_lock': {
           'lockingType': 'p2sh32',
           'name': 'mecenas_lock',
-          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(tx.age >= period);                                                                              */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
+          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(this.age >= period);                                                                            */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
         },
       },
     },
diff --git a/packages/cashscript/test/fixture/mecenas.artifact.ts b/packages/cashscript/test/fixture/mecenas.artifact.ts
index 3f27d191..9d157e82 100644
--- a/packages/cashscript/test/fixture/mecenas.artifact.ts
+++ b/packages/cashscript/test/fixture/mecenas.artifact.ts
@@ -34,7 +34,7 @@ export default {
     },
   ],
   bytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
-  source: 'pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho\'s Mecenas contract. It is\n * not compatible with Licho\'s EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(tx.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n',
+  source: 'pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho\'s Mecenas contract. It is\n * not compatible with Licho\'s EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(this.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
     bytecode: '5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768',
     sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
@@ -72,7 +72,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.4',
+    version: '0.11.0-next.1',
   },
-  updatedAt: '2024-12-03T13:57:11.555Z',
+  updatedAt: '2025-03-04T09:20:10.767Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/mecenas.cash b/packages/cashscript/test/fixture/mecenas.cash
index 259e95fe..35786b60 100644
--- a/packages/cashscript/test/fixture/mecenas.cash
+++ b/packages/cashscript/test/fixture/mecenas.cash
@@ -7,7 +7,7 @@ pragma cashscript >=0.8.0;
  */
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {
     function receive() {
-        // require(tx.age >= period);
+        // require(this.age >= period);
 
         // Check that the first output sends to the recipient
         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index f809fbf2..1e3edb89 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -34,7 +34,7 @@
     }
   ],
   "bytecode": "OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF",
-  "source": "pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(tx.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
+  "source": "pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(this.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
     "bytecode": "5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768",
     "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1",
@@ -72,7 +72,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.4"
+    "version": "0.11.0-next.1"
   },
-  "updatedAt": "2024-12-03T13:57:11.304Z"
+  "updatedAt": "2025-03-04T09:20:10.424Z"
 }
\ No newline at end of file
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index c1dfdde5..48714a52 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -99,7 +99,7 @@ pragma cashscript >=0.8.0;
  */
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {
     function receive() {
-        // require(tx.age >= period);
+        // require(this.age >= period);
 
         // Check that the first output sends to the recipient
         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));
@@ -176,7 +176,7 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
                                                                                          /*  *\\/                                                                                                               */
                                                                                          /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */
 OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */
-                                                                                         /*         // require(tx.age >= period);                                                                              */
+                                                                                         /*         // require(this.age >= period);                                                                            */
                                                                                          /*                                                                                                                    */
                                                                                          /*         // Check that the first output sends to the recipient                                                      */
 OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */
diff --git a/website/docs/compiler/grammar.md b/website/docs/compiler/grammar.md
index 04743e05..991e609b 100644
--- a/website/docs/compiler/grammar.md
+++ b/website/docs/compiler/grammar.md
@@ -91,10 +91,7 @@ consoleStatement
 
 consoleParameter
     : Identifier
-    | StringLiteral
-    | NumberLiteral
-    | HexLiteral
-    | BooleanLiteral
+    | literal
     ;
 
 consoleParameterList
@@ -170,7 +167,15 @@ NumberUnit
     ;
 
 NumberLiteral
-    : [-]?[0-9]+ ([eE] [0-9]+)?
+    : '-'? NumberPart ExponentPart?
+    ;
+
+NumberPart
+    : [0-9]+ ('_' [0-9]+)*
+    ;
+
+ExponentPart
+    : [eE] NumberPart
     ;
 
 Bytes
@@ -195,7 +200,7 @@ HexLiteral
     ;
 
 TxVar
-    : 'tx.age'
+    : 'this.age'
     | 'tx.time'
     ;
 
diff --git a/website/docs/guides/covenants.md b/website/docs/guides/covenants.md
index ef0dd547..35a978db 100644
--- a/website/docs/guides/covenants.md
+++ b/website/docs/guides/covenants.md
@@ -68,7 +68,7 @@ This is especially effective when used together with time constraints. An exampl
 ```solidity
 contract LastWill(bytes20 inheritor, bytes20 cold, bytes20 hot) {
     function inherit(pubkey pk, sig s) {
-        require(tx.age >= 180 days);
+        require(this.age >= 180 days);
         require(hash160(pk) == inheritor);
         require(checkSig(s, pk));
     }
@@ -94,7 +94,7 @@ contract LastWill(bytes20 inheritor, bytes20 cold, bytes20 hot) {
 }
 ```
 
-This contract has three functions, but only the `refresh()` function uses a covenant. Again it performs necessary checks to verify that the transaction is signed by the owner, after which it checks that the entire contract balance is sent. It then uses `tx.inputs[this.activeInputIndex].lockingBytecode` to access its own locking bytecode, which can be used as the locking bytecode of this output. Sending the full value back to the same contract effectively resets the `tx.age` counter, so the owner of the contract needs to do this every 180 days.
+This contract has three functions, but only the `refresh()` function uses a covenant. Again it performs necessary checks to verify that the transaction is signed by the owner, after which it checks that the entire contract balance is sent. It then uses `tx.inputs[this.activeInputIndex].lockingBytecode` to access its own locking bytecode, which can be used as the locking bytecode of this output. Sending the full value back to the same contract effectively resets the `this.age` counter, so the owner of the contract needs to do this every 180 days.
 
 ### Restricting P2PKH and P2SH
 The earlier examples showed sending money to only a single output of either `P2PKH` or `P2SH`. But there's nothing preventing us from writing a contract that can send to multiple outputs, including a combination of `P2PKH` and `P2SH` outputs. A good example is the *Licho's Mecenas* contract that allows you to set up recurring payments where the recipient is able to claim the same amount every month, while the remainder has to be sent back to the contract.
@@ -102,7 +102,7 @@ The earlier examples showed sending money to only a single output of either `P2P
 ```solidity
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
     function receive() {
-        require(tx.age >= period);
+        require(this.age >= period);
 
         // Check that the first output sends to the recipient
         bytes25 recipientLockingBytecode = new LockingBytecodeP2PKH(recipient);
@@ -145,7 +145,7 @@ Covenants can also use 'simulated state', where state is kept in the contract sc
 
 ### Keeping local State in NFTs
 
-To demonstrate the concept of 'local state' we consider the Mecenas contract again, and focus on a drawback of this contract: you have to claim the funds at exactly the right moment or you're leaving money on the table. Every time you claim money from the contract, the `tx.age` counter is reset, so the next claim is possible 30 days after the previous claim. So if we wait a few days to claim, **these days are basically wasted**.
+To demonstrate the concept of 'local state' we consider the Mecenas contract again, and focus on a drawback of this contract: you have to claim the funds at exactly the right moment or you're leaving money on the table. Every time you claim money from the contract, the `this.age` counter is reset, so the next claim is possible 30 days after the previous claim. So if we wait a few days to claim, **these days are basically wasted**.
 
 Besides these wasted days it can also be inconvenient to claim at set intervals, rather than the "streaming" model that the Ethereum project [Sablier](https://www.sablier.finance/) employs. Instead of set intervals, you should be able to claim funds at any time during the "money stream". Using local state, we can approach a similar system with BCH.
 
diff --git a/website/docs/language/examples.md b/website/docs/language/examples.md
index 9d45db94..a007754c 100644
--- a/website/docs/language/examples.md
+++ b/website/docs/language/examples.md
@@ -48,7 +48,7 @@ For how to put the HodlVault contract to use in a Typescript application, see th
 ## Licho's Mecenas
 Donations are a great way to support the projects you love, and periodic donations can incentivise continuous improvement to the product. But platforms like Patreon generally take fees of 10%+ and don't accept cryptocurrencies. Instead you can create a peer-to-peer smart contract that allows a recipient to withdraw a specific amount every month.
 
-The contract works by checking that a UTXO is at least 30 days old, after which it uses a covenant to enforce that the `pledge` amount is sent to the recipient, while the remainder is sent back to the contract itself. By sending it back, the `tx.age` counter is effectively reset, meaning this process can only be repeated when another 30 days have past.
+The contract works by checking that a UTXO is at least 30 days old, after which it uses a covenant to enforce that the `pledge` amount is sent to the recipient, while the remainder is sent back to the contract itself. By sending it back, the `this.age` counter is effectively reset, meaning this process can only be repeated when another 30 days have past.
 
 Due to the nature of covenants, we have to be very specific about the outputs (amounts and destinations) of the transaction. This also means that we have to account for the special case where the remaining contract balance is lower than the `pledge` amount, meaning no remainder should be sent back. Finally, we have to account for a small fee that has to be taken from the contract's balance to pay the miners.
 
@@ -57,7 +57,7 @@ pragma cashscript ^0.11.0;
 
 contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
     function receive() {
-        require(tx.age >= period);
+        require(this.age >= period);
 
         // Check that the first output sends to the recipient
         bytes25 recipientLockingBytecode = new LockingBytecodeP2PKH(recipient);
diff --git a/website/docs/language/globals.md b/website/docs/language/globals.md
index 764a569d..62365591 100644
--- a/website/docs/language/globals.md
+++ b/website/docs/language/globals.md
@@ -9,7 +9,7 @@ It can be difficult to fully grasp the intricacies of time locks, so if you're s
 
 
 ### tx.time
-`tx.time` is used to create *absolute* time locks. The value of `tx.time` can either represent the block number of the spending transaction or its timestamp. When comparing it with values below `500,000,000`, it is treated as a blocknumber, while higher values are treated as a timestamp.
+`tx.time` is used to create *absolute* time lock on the transaction. The value of `tx.time` can either represent the block number of the spending transaction or its timestamp. When comparing it with values below `500,000,000`, it is treated as a blocknumber, while higher values are treated as a timestamp.
 
 `tx.time` corresponds to the `nLocktime` field of the current transaction using the `OP_CHECKLOCKTIMEVERIFY` opcode. Because of this `tx.time` can only be used in the following way:
 
@@ -21,22 +21,22 @@ require(tx.time >= <expression>);
 To access the value of the `nLocktime` field for assignment, use the `tx.locktime` introspection variable.
 :::
 
-Because of the way time locks work, **a corresponding time lock needs to be added to the transaction**. The CashScript SDK automatically sets this *transaction level* time lock to the most recent block number, as this is the most common use case. If you need to use a different block number or timestamp, this should be passed into the CashScript SDK using the [`withTime()`][withTime()] function. If the default matches your use case, **no additional actions are required**.
+Because of the way time locks work, **a corresponding time lock needs to be added to the transaction**. This can be done with the CashScript SDK by calling [`setLocktime()`][setLocktime()] on the `TransactionBuilder` instance.
 
-### tx.age
-`tx.age` is used to create *relative* time locks. The value of `tx.age` can either represent a number of blocks, or a number of *chunks*, which are 512 seconds. The corresponding *transaction level* time lock determines which of the two options is used.
+### this.age
+`this.age` is used to create *relative* time lock on a UTXO. The value of `this.age` can either represent a number of blocks, or a number of *chunks*, which are 512 seconds. The corresponding *transaction level* time lock determines which of the two options is used.
 
-`tx.age` corresponds to the `nSequence` field of the current *UTXO* using the `OP_CHECKSEQUENCEVERIFY` opcode. Because of this `tx.age` can only be used in the following way:
+`this.age` corresponds to the `nSequence` field of the current evaluated *UTXO* using the `OP_CHECKSEQUENCEVERIFY` opcode. Because of this `this.age` can only be used in the following way:
 
 ```solidity
-require(tx.age >= <expression>);
+require(this.age >= <expression>);
 ```
 
 :::note
 To access the value of the `nSequence` field for variable assignment, use the [`sequenceNumber` introspection variable](#txinputsisequencenumber).
 :::
 
-Because of the way time locks work, **a corresponding time lock needs to be added to the transaction**. This can be done in the CashScript SDK using the [`withAge()`][withAge()] function. However, the value passed into this function will always be treated as a number of blocks, so **it is currently not supported to use `tx.age` as a number of second chunks**.
+Because of the way time locks work, **a corresponding time lock needs to be added to the transaction**. This can be done in the CashScript SDK through [`addInput()`][addInput()] by passing the `sequence` as optional argument. However, the value passed into this function will always be treated as a number of blocks, so **it is currently not supported to use `this.age` as a number of second chunks**.
 
 ## Introspection variables
 Introspection functionality is used to create *covenant* contracts. Covenants are a technique used to put constraints on spending the money inside a smart contract. The main use case of this is limiting the addresses where money can be sent and the amount sent. To explore the possible uses of covenants inside smart contracts, read the [CashScript Covenants Guide][covenants-guide].
@@ -281,7 +281,7 @@ require(1 weeks == 7 days);
 ```
 
 [bip68]: https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki
-[withAge()]: /docs/sdk/transactions#withage
-[withTime()]: /docs/sdk/transactions#withtime
+[addInput()]: /docs/sdk/transaction-builder#addinput
+[setLocktime()]: docs/sdk/transaction-builder#setlocktime
 [covenants-guide]: /docs/guides/covenants
 [tx.time]: #txtime
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index bb560464..83977861 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -8,6 +8,7 @@ This update adds CashScript support for the new BCH 2025 network upgrade. To rea
 
 #### cashc compiler
 - :hammer_and_wrench: Remove warning for opcount and update warning for byte size to match new limits.
+- :boom: **BREAKING**: `tx.age` was renamed to `this.age` to better reflect that it enforces a UTXO-level locktime check (*not* transaction-level).
 
 #### CashScript SDK
 - :sparkles: Add debugging capabilities to the `TransactionBuilder`.

From 33df3d44417ab6b3673825f8e6ffe4471ecfd1b8 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Tue, 4 Mar 2025 11:46:16 +0100
Subject: [PATCH 188/267] Switch to @electrum-cash/network library & rework to
 use ElectrumClient (#287)

* rework ElectrumNetworkProvider
* update docs for electrumNetworkProvider & release-notes
* small docs update
* Re-add concurrent connection management + test
* Add options object to pass in custom electrum/hostname and re-add manual connection management + tests
* Update docs and release notes for ElectrumNetworkProvider changes

---------

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
---
 packages/cashscript/package.json              |   2 +-
 .../src/network/ElectrumNetworkProvider.ts    | 113 +++++++++---------
 .../network/ElectrumNetworkProvider.test.ts   |  61 ++++++++++
 ...st.ts => FullStackNetworkProvider.test.ts} |   0
 website/docs/releases/migration-notes.md      |  40 ++++++-
 website/docs/releases/release-notes.md        |   5 +-
 website/docs/sdk/network-provider.md          |  66 +++++++---
 yarn.lock                                     | 106 ++++++++++------
 8 files changed, 288 insertions(+), 105 deletions(-)
 create mode 100644 packages/cashscript/test/e2e/network/ElectrumNetworkProvider.test.ts
 rename packages/cashscript/test/e2e/network/{FullStack.test.ts => FullStackNetworkProvider.test.ts} (100%)

diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index b5fde331..f6372471 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -45,10 +45,10 @@
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
     "@cashscript/utils": "^0.11.0-next.1",
+    "@electrum-cash/network": "^4.1.1",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "change-case": "^5.4.4",
     "delay": "^6.0.0",
-    "electrum-cash": "^2.0.10",
     "fast-deep-equal": "^3.1.3",
     "pako": "^2.1.0",
     "semver": "^7.6.3"
diff --git a/packages/cashscript/src/network/ElectrumNetworkProvider.ts b/packages/cashscript/src/network/ElectrumNetworkProvider.ts
index 789b7ef9..49ae4478 100644
--- a/packages/cashscript/src/network/ElectrumNetworkProvider.ts
+++ b/packages/cashscript/src/network/ElectrumNetworkProvider.ts
@@ -1,55 +1,58 @@
 import { binToHex } from '@bitauth/libauth';
 import { sha256 } from '@cashscript/utils';
 import {
-  ElectrumCluster,
-  ElectrumTransport,
-  ClusterOrder,
-  RequestResponse,
-} from 'electrum-cash';
+  ElectrumClient,
+  type RequestResponse,
+  type ElectrumClientEvents,
+} from '@electrum-cash/network';
 import { Utxo, Network } from '../interfaces.js';
 import NetworkProvider from './NetworkProvider.js';
 import { addressToLockScript } from '../utils.js';
 
+
+interface OptionsBase {
+  manualConnectionManagement?: boolean;
+}
+
+interface CustomHostNameOptions extends OptionsBase {
+  hostname: string;
+}
+
+interface CustomElectrumOptions extends OptionsBase {
+  electrum: ElectrumClient<ElectrumClientEvents>;
+}
+
+type Options = OptionsBase | CustomHostNameOptions | CustomElectrumOptions;
+
 export default class ElectrumNetworkProvider implements NetworkProvider {
-  private electrum: ElectrumCluster;
+  private electrum: ElectrumClient<ElectrumClientEvents>;
   private concurrentRequests: number = 0;
+  private manualConnectionManagement: boolean;
 
-  constructor(
-    public network: Network = Network.MAINNET,
-    electrum?: ElectrumCluster,
-    private manualConnectionManagement?: boolean,
-  ) {
-    // If a custom Electrum Cluster is passed, we use it instead of the default.
-    if (electrum) {
-      this.electrum = electrum;
-      return;
-    }
+  constructor(public network: Network = Network.MAINNET, options: Options = {}) {
+    this.electrum = this.instantiateElectrumClient(network, options);
+    this.manualConnectionManagement = options?.manualConnectionManagement ?? false;
+  }
+
+  private instantiateElectrumClient(network: Network, options: Options): ElectrumClient<ElectrumClientEvents> {
+    if ('electrum' in options) return options.electrum;
+    const server = 'hostname' in options ? options.hostname : this.getServerForNetwork(network);
+    return new ElectrumClient('CashScript Application', '1.4.1', server);
+  }
 
-    if (network === Network.MAINNET) {
-      // Initialise a 2-of-3 Electrum Cluster with 6 reliable hardcoded servers
-      // using the first three servers as "priority" servers
-      this.electrum = new ElectrumCluster('CashScript Application', '1.4.1', 2, 3, ClusterOrder.PRIORITY);
-      this.electrum.addServer('bch.imaginary.cash', 50004, ElectrumTransport.WSS.Scheme, false);
-      this.electrum.addServer('blackie.c3-soft.com', 50004, ElectrumTransport.WSS.Scheme, false);
-      this.electrum.addServer('electroncash.de', 60002, ElectrumTransport.WSS.Scheme, false);
-      this.electrum.addServer('electroncash.dk', 50004, ElectrumTransport.WSS.Scheme, false);
-      this.electrum.addServer('bch.loping.net', 50004, ElectrumTransport.WSS.Scheme, false);
-      this.electrum.addServer('electrum.imaginary.cash', 50004, ElectrumTransport.WSS.Scheme, false);
-    } else if (network === Network.TESTNET3) {
-      // Initialise a 1-of-2 Electrum Cluster with 2 hardcoded servers
-      this.electrum = new ElectrumCluster('CashScript Application', '1.4.1', 1, 2, ClusterOrder.PRIORITY);
-      this.electrum.addServer('blackie.c3-soft.com', 60004, ElectrumTransport.WSS.Scheme, false);
-      this.electrum.addServer('electroncash.de', 60004, ElectrumTransport.WSS.Scheme, false);
-      // this.electrum.addServer('bch.loping.net', 60004, ElectrumTransport.WSS.Scheme, false);
-      // this.electrum.addServer('testnet.imaginary.cash', 50004, ElectrumTransport.WSS.Scheme);
-    } else if (network === Network.TESTNET4) {
-      this.electrum = new ElectrumCluster('CashScript Application', '1.4.1', 1, 1, ClusterOrder.PRIORITY);
-      this.electrum.addServer('testnet4.imaginary.cash', 50004, ElectrumTransport.WSS.Scheme, false);
-    } else if (network === Network.CHIPNET) {
-      this.electrum = new ElectrumCluster('CashScript Application', '1.4.1', 1, 1, ClusterOrder.PRIORITY);
-      this.electrum.addServer('chipnet.bch.ninja', 50004, ElectrumTransport.WSS.Scheme, false);
-    } else {
-      throw new Error(`Tried to instantiate an ElectrumNetworkProvider for unsupported network ${network}`);
+  // Get Electrum server based on network
+  private getServerForNetwork(network: Network): string {
+    switch (network) {
+      case Network.MAINNET:
+        return 'bch.imaginary.cash';
+      case Network.TESTNET3:
+        return 'testnet.imaginary.cash';
+      case Network.TESTNET4:
+        return 'testnet4.imaginary.cash';
+      case Network.CHIPNET:
+        return 'chipnet.bch.ninja';
+      default:
+        throw new Error(`Unsupported network: ${network}`);
     }
   }
 
@@ -85,39 +88,41 @@ export default class ElectrumNetworkProvider implements NetworkProvider {
     return await this.performRequest('blockchain.transaction.broadcast', txHex) as string;
   }
 
-  async connectCluster(): Promise<void[]> {
-    try {
-      return await this.electrum.startup();
-    } catch (e) {
-      return [];
+  async connect(): Promise<void> {
+    if (!this.manualConnectionManagement) {
+      throw new Error('Manual connection management is disabled');
     }
+
+    return this.electrum.connect();
   }
 
-  async disconnectCluster(): Promise<boolean[]> {
-    return this.electrum.shutdown();
+  async disconnect(): Promise<boolean> {
+    if (!this.manualConnectionManagement) {
+      throw new Error('Manual connection management is disabled');
+    }
+
+    return this.electrum.disconnect();
   }
 
   async performRequest(
     name: string,
     ...parameters: (string | number | boolean)[]
   ): Promise<RequestResponse> {
-    // Only connect the cluster when no concurrent requests are running
+    // Only connect the electrum client when no concurrent requests are running
     if (this.shouldConnect()) {
-      this.connectCluster();
+      await this.electrum.connect();
     }
 
     this.concurrentRequests += 1;
 
-    await this.electrum.ready();
-
     let result;
     try {
       result = await this.electrum.request(name, ...parameters);
     } finally {
-      // Always disconnect the cluster, also if the request fails
+      // Always disconnect the electrum client, also if the request fails
       // as long as no other concurrent requests are running
       if (this.shouldDisconnect()) {
-        await this.disconnectCluster();
+        await this.electrum.disconnect();
       }
     }
 
diff --git a/packages/cashscript/test/e2e/network/ElectrumNetworkProvider.test.ts b/packages/cashscript/test/e2e/network/ElectrumNetworkProvider.test.ts
new file mode 100644
index 00000000..653b1a56
--- /dev/null
+++ b/packages/cashscript/test/e2e/network/ElectrumNetworkProvider.test.ts
@@ -0,0 +1,61 @@
+import { describeOrSkip } from '../../../test/test-util.js';
+import { ElectrumNetworkProvider, Network } from '../../../src/index.js';
+import { ElectrumClient } from '@electrum-cash/network';
+
+describeOrSkip(!process.env.TESTS_USE_MOCKNET, 'ElectrumNetworkProvider', () => {
+  // TODO: Test more of the API
+  it('should be able to request data', async () => {
+    const provider = new ElectrumNetworkProvider(Network.CHIPNET);
+    const blockHeight = await provider.getBlockHeight();
+    expect(blockHeight).toBeDefined();
+  });
+
+  it('should be able to handle multiple concurrent requests', async () => {
+    const provider = new ElectrumNetworkProvider(Network.CHIPNET);
+
+    const transactionPromise = provider.getRawTransaction('d72923b7cf345d2a90f951d66f437d4fbb941fcbd87bb54d8d88e51ecb3e3b9f');
+    const blockHeightPromise = provider.getBlockHeight();
+
+    const transaction = await transactionPromise;
+    const blockHeight = await blockHeightPromise;
+
+    expect(blockHeight).toBeDefined();
+    expect(transaction).toBeDefined();
+  });
+
+  it('should be able to pass in a custom electrum client', async () => {
+    const electrum = new ElectrumClient('CashScript Application', '1.4.1', 'chipnet.bch.ninja');
+    const provider = new ElectrumNetworkProvider(Network.CHIPNET, { electrum });
+    const blockHeight = await provider.getBlockHeight();
+    expect(blockHeight).toBeDefined();
+  });
+
+  it('should be able to pass in a custom host name', async () => {
+    const provider = new ElectrumNetworkProvider(Network.CHIPNET, { hostname: 'chipnet.bch.ninja' });
+    const blockHeight = await provider.getBlockHeight();
+    expect(blockHeight).toBeDefined();
+  });
+
+  describe('manual connection management', () => {
+    it('should throw an error if trying to use connect/disconnect without specifying manualConnectionManagement', async () => {
+      const provider = new ElectrumNetworkProvider(Network.CHIPNET);
+      expect(provider.connect()).rejects.toThrow('Manual connection management is disabled');
+    });
+
+    it('should throw an error if client is not connected', async () => {
+      const provider = new ElectrumNetworkProvider(Network.CHIPNET, { manualConnectionManagement: true });
+      expect(provider.getBlockHeight()).rejects.toThrow('Unable to send request to a disconnected server');
+    });
+
+    it('should be able to send requests after connecting', async () => {
+      const provider = new ElectrumNetworkProvider(Network.CHIPNET, { manualConnectionManagement: true });
+
+      await provider.connect();
+      const blockHeight = await provider.getBlockHeight();
+      await provider.disconnect();
+
+      expect(blockHeight).toBeDefined();
+    });
+  });
+});
+
diff --git a/packages/cashscript/test/e2e/network/FullStack.test.ts b/packages/cashscript/test/e2e/network/FullStackNetworkProvider.test.ts
similarity index 100%
rename from packages/cashscript/test/e2e/network/FullStack.test.ts
rename to packages/cashscript/test/e2e/network/FullStackNetworkProvider.test.ts
diff --git a/website/docs/releases/migration-notes.md b/website/docs/releases/migration-notes.md
index 881a1ab0..04d704dc 100644
--- a/website/docs/releases/migration-notes.md
+++ b/website/docs/releases/migration-notes.md
@@ -4,7 +4,9 @@ title: Migration Notes
 
 ## v0.10 to v0.11
 
-### CashScript SDK
+There are several breaking changes to the SDK in this release. They are listed below in their own sections.
+
+### CashScript SDK (Transaction Builder)
 
 The 'Simple Transaction builder' has been marked as deprecated and the 'Advanced Transaction Builder' is now simply referred to as the CashScript `Transaction Builder`, as there is only one supported for the future.
 
@@ -69,6 +71,42 @@ const txDetails = await new TransactionBuilder({ provider })
 
 With the new transaction builder, all inputs and outputs are explicitly specified. This means that there are no automatic change outputs added (for BCH or tokens). This means that there are also no `.withMinChange()`, `.withoutChange()`, `.withoutTokenChange()`, `withHardcodedFee()`, or `.withFeePerByte()` methods. The developer is responsible for manually adding change outputs. There is still an option to use `.setMaxFee()` as a security measure to prevent the transaction from being too expensive.
 
+### CashScript SDK (ElectrumNetworkProvider)
+
+The underlying `electrum-cash` library has been mgrated to the new `@electrum-cash/network` package. This drops support for electrum cluster functionality. We reworked the second parameter of the `ElectrumNetworkProvider` constructor to be an options object, which can contain a custom electrum client or a custom hostname.
+
+If you were not using custom clusters, there is no need to change anything. If you were using custom clusters, you will need to update your code to use the new `@electrum-cash/network` package and use a single client instead of a cluster.
+
+#### Example
+
+Before:
+
+```ts
+import { ElectrumCluster, ClusterOrder } from 'electrum-cash';
+import { ElectrumNetworkProvider } from 'cashscript';
+
+const customCluster = new ElectrumCluster('CashScript Application', '1.4.1', 2, 3, ClusterOrder.PRIORITY);
+customCluster.addServer('bch.imaginary.cash', 50004, ElectrumTransport.WSS.Scheme, false);
+customCluster.addServer('blackie.c3-soft.com', 50004, ElectrumTransport.WSS.Scheme, false);
+customCluster.addServer('electroncash.dk', 50004, ElectrumTransport.WSS.Scheme, false);
+
+const provider = new ElectrumNetworkProvider('mainnet', customCluster);
+```
+
+After:
+
+```ts
+import { ElectrumClient } from '@electrum-cash/network';
+import { ElectrumNetworkProvider } from 'cashscript';
+
+const customClient = new ElectrumClient('CashScript Application', '1.4.1', 'bch.imaginary.cash');
+const provider = new ElectrumNetworkProvider('mainnet', { electrum: customClient });
+
+// or
+
+const provider = new ElectrumNetworkProvider('mainnet', { hostname: 'bch.imaginary.cash' });
+```
+
 ## v0.9 to v0.10
 
 ### CashScript SDK
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 83977861..1b9c090e 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,10 +2,12 @@
 title: Release Notes
 ---
 
-## v0.11.0-next.1
+## v0.11.0-next.2
 
 This update adds CashScript support for the new BCH 2025 network upgrade. To read more about the upgrade, see [this blog post](https://blog.bitjson.com/2025-chips/).
 
+This release also contains several breaking changes, please refer to the [migration notes](/docs/releases/migration-notes) for more information.
+
 #### cashc compiler
 - :hammer_and_wrench: Remove warning for opcount and update warning for byte size to match new limits.
 - :boom: **BREAKING**: `tx.age` was renamed to `this.age` to better reflect that it enforces a UTXO-level locktime check (*not* transaction-level).
@@ -17,6 +19,7 @@ This update adds CashScript support for the new BCH 2025 network upgrade. To rea
   - Libauth template generation and debugging for multi-contract transactions
 - :hammer_and_wrench: Deprecate the simple transaction builder. You can still use the simple transaction builder with the current SDK, but this support will be removed in a future release.
 - :hammer_and_wrench: Update debug tooling to use the new `BCH_2025_05` instruction set.
+- :boom: **BREAKING**: Remove support for custom Clusters from `ElectrumNetworkProvider` and added a configuration object to the constructor.
 - :boom: **BREAKING**: Remove support for old contracts compiled with CashScript v0.6.x or earlier.
 
 ## v0.10.5
diff --git a/website/docs/sdk/network-provider.md b/website/docs/sdk/network-provider.md
index 7e7e83b2..97faf9c6 100644
--- a/website/docs/sdk/network-provider.md
+++ b/website/docs/sdk/network-provider.md
@@ -6,30 +6,45 @@ The CashScript SDK needs to connect to the BCH network to perform certain operat
 
 ## ElectrumNetworkProvider
 
-The ElectrumNetworkProvider uses [electrum-cash][electrum-cash] to connect to the BCH network. Both `network` and `electrum` parameters are optional, and they default to mainnet and a 2-of-3 ElectrumCluster with a number of reliable electrum servers.
+The ElectrumNetworkProvider uses [@electrum-cash/network][electrum-cash] to connect to the BCH network. Both `network` and `options` parameters are optional, and they default to mainnet with the `bch.imaginary.cash` electrum server.
 
 ```ts
-new ElectrumNetworkProvider(network?: Network, electrum?: ElectrumCluster)
+new ElectrumNetworkProvider(network?: Network, options?: Options)
 ```
 
-:::note
-In some cases it might be desirable to overwrite the 2-of-3 ElectrumCluster default to use only a 1-of-1 cluster because of network latency.
-:::
-
+Using the `network` parameter, you can specify the network to connect to.
 
-### Network
 ```ts
 type Network = 'mainnet' | 'chipnet' | 'testnet3' | 'testnet4' | 'regtest';
 ```
 
+Using the `options` parameter, you can specify a custom electrum client or hostname, and enable manual connection management.
+
+```ts
+type Options = OptionsBase | CustomHostNameOptions | CustomElectrumOptions;
+
+interface OptionsBase {
+  manualConnectionManagement?: boolean;
+}
+
+interface CustomHostNameOptions extends OptionsBase {
+  hostname: string;
+}
+
+interface CustomElectrumOptions extends OptionsBase {
+  electrum: ElectrumClient<ElectrumClientEvents>;
+}
+```
+
 The network parameter can be one of 5 different options.
 
 #### Example
 ```ts
-const provider = new ElectrumProvider('chipnet');
+const hostname = 'chipnet.bch.ninja';
+const provider = new ElectrumNetworkProvider('chipnet', { hostname });
 ```
 
-### getUtxos
+### getUtxos()
 ```ts
 async provider.getUtxos(address: string): Promise<Utxo[]>;
 ```
@@ -49,7 +64,7 @@ interface Utxo {
 const userUtxos = await provider.getUtxos(userAddress)
 ```
 
-### getBlockHeight
+### getBlockHeight()
 ```ts
 async provider.getBlockHeight(): Promise<number>;
 ```
@@ -60,7 +75,7 @@ Get the current blockHeight.
 const currentBlockHeight = await provider.getBlockHeight()
 ```
 
-### getRawTransaction
+### getRawTransaction()
 ```ts
 async provider.getRawTransaction(txid: string): Promise<string>;
 ```
@@ -72,7 +87,7 @@ Retrieve the Hex transaction details for a given transaction ID.
 const rawTransaction = await provider.getRawTransaction(txid)
 ```
 
-### sendRawTransaction
+### sendRawTransaction()
 ```ts
 async provider.sendRawTransaction(txHex: string): Promise<string>;
 ```
@@ -83,7 +98,7 @@ Broadcast a raw hex transaction to the network.
 const txId = await provider.sendRawTransaction(txHex)
 ```
 
-### performRequest
+### performRequest()
 
 Perform an arbitrary electrum request, refer to the docs at [electrum-cash-protocol](https://electrum-cash-protocol.readthedocs.io/en/latest/).
 
@@ -93,6 +108,29 @@ const verbose = true // get parsed transaction as json result
 const txId = await provider.performRequest('blockchain.transaction.get', txid, verbose)
 ```
 
+### Manual Connection Management
+
+By default, the ElectrumNetworkProvider will automatically connect and disconnect to the electrum client as needed. However, you can enable manual connection management by setting the `manualConnectionManagement` option to `true`. This can be useful if you are passing a custom electrum client and are using that client for other purposes, such as subscribing to events.
+
+```ts
+const provider = new ElectrumNetworkProvider('chipnet', { manualConnectionManagement: true });
+```
+
+#### connect()
+```ts
+provider.connect(): Promise<void>;
+```
+
+Connects to the electrum client.
+
+#### disconnect()
+```ts
+provider.disconnect(): Promise<boolean>;
+```
+
+Disconnects from the electrum client, returns `true` if the client was connected, `false` if it was already disconnected.
+
+
 ## Advanced Options
 
 All network functionality that the CashScript SDK needs is encapsulated in a network provider. This allows different network providers to be used and makes it easy to swap out dependencies.
@@ -127,6 +165,6 @@ To implement a Custom NetworkProvider, refer to the [NetworkProvider interface](
 :::
 
 
-[electrum-cash]: https://www.npmjs.com/package/electrum-cash
+[electrum-cash]: https://www.npmjs.com/package/@electrum-cash/network
 [fullstack]: https://fullstack.cash/
 [bchjs]: https://bchjs.fullstack.cash/
diff --git a/yarn.lock b/yarn.lock
index 9a1a8d22..5e08360e 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -1056,6 +1056,38 @@
   resolved "https://registry.yarnpkg.com/@cspell/url/-/url-8.17.2.tgz#81f8cd7d31b7d160971a207da5b6486eebc5aecb"
   integrity sha512-yy4eYWNX2iutXmy4Igbn/hL/NYaNt94DylohPtgVr0Zxnn/AAArt9Bv1KXPpjB8VFy2wzzPzWmZ+MWDUVpHCbg==
 
+"@electrum-cash/debug-logs@^1.0.0":
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/@electrum-cash/debug-logs/-/debug-logs-1.0.0.tgz#7d021515f1b881f477176cb640f2178d094181e5"
+  integrity sha512-GU/CvRR9lZ0d8gy9CXGW7f//OHCIydBavv9q+JcxjGj8Xr7HwlGqHx+Wzhx9y3YmJrXfExpgClcd++gTjdEmzA==
+  dependencies:
+    debug "^4.3.7"
+
+"@electrum-cash/network@^4.1.1":
+  version "4.1.1"
+  resolved "https://registry.yarnpkg.com/@electrum-cash/network/-/network-4.1.1.tgz#1f9571c783f613ce960374b4bffb73c27b28c429"
+  integrity sha512-v5abF2qGRTnBoi9tcS/iz7j82D8HYsK9iY0NM5v8/Qu8SnlMGGNz8UDFl+YzRPFXb4SUL3K0uf3Oydy82DB3oA==
+  dependencies:
+    "@electrum-cash/debug-logs" "^1.0.0"
+    "@electrum-cash/web-socket" "^1.0.0"
+    async-mutex "^0.5.0"
+    debug "^4.3.2"
+    eventemitter3 "^5.0.1"
+    lossless-json "^4.0.1"
+
+"@electrum-cash/web-socket@^1.0.0":
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/@electrum-cash/web-socket/-/web-socket-1.0.0.tgz#0ab57e46d41e941ffb57deff86afea3ae1379d5d"
+  integrity sha512-+VQ6aPE7nUysyDn9SB7/uqKuVJmjrhvr0LRK2ANTeR1DfmXBnv5z29e/0zK5A7ZoAz0gdZZuLDzN46r8S5Cxig==
+  dependencies:
+    "@electrum-cash/debug-logs" "^1.0.0"
+    "@monsterbitar/isomorphic-ws" "^5.3.0"
+    "@types/ws" "^8.5.5"
+    async-mutex "^0.5.0"
+    eventemitter3 "^5.0.1"
+    lossless-json "^4.0.1"
+    ws "^8.13.0"
+
 "@esbuild/aix-ppc64@0.23.1":
   version "0.23.1"
   resolved "https://registry.yarnpkg.com/@esbuild/aix-ppc64/-/aix-ppc64-0.23.1.tgz#51299374de171dbd80bb7d838e1cfce9af36f353"
@@ -2385,6 +2417,11 @@
     npmlog "^4.1.2"
     write-file-atomic "^2.3.0"
 
+"@monsterbitar/isomorphic-ws@^5.3.0":
+  version "5.3.1"
+  resolved "https://registry.yarnpkg.com/@monsterbitar/isomorphic-ws/-/isomorphic-ws-5.3.1.tgz#acd6be86c7568682d8146f8b5fadbec74bf8789e"
+  integrity sha512-BWfWUffbg3uO4K6Cyokg9ff43lPaXAOZcCnNe1lcjCjUMDVrRAb5qEHG5qeJp3ud2SPYbORaNsls5as6SR3oig==
+
 "@mr-zwets/bchn-api-wrapper@^1.0.1":
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/@mr-zwets/bchn-api-wrapper/-/bchn-api-wrapper-1.0.1.tgz#1ecd9fca91ed7e33df9769e243ae04871d2d356f"
@@ -2778,10 +2815,10 @@
   resolved "https://registry.yarnpkg.com/@types/stack-utils/-/stack-utils-2.0.3.tgz#6209321eb2c1712a7e7466422b8cb1fc0d9dd5d8"
   integrity sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==
 
-"@types/ws@^7.4.6":
-  version "7.4.7"
-  resolved "https://registry.yarnpkg.com/@types/ws/-/ws-7.4.7.tgz#f7c390a36f7a0679aa69de2d501319f4f8d9b702"
-  integrity sha512-JQbbmxZTZehdc2iszGKs5oC3NFnjeay7mtAWrdt7qNtAVK0g19muApzAy4bm9byz79xa2ZnO/BOBC2R8RC5Lww==
+"@types/ws@^8.5.5":
+  version "8.5.14"
+  resolved "https://registry.yarnpkg.com/@types/ws/-/ws-8.5.14.tgz#93d44b268c9127d96026cf44353725dd9b6c3c21"
+  integrity sha512-bd/YFLW+URhBzMXurx7lWByOu+xzU9+kb3RboOteXYDfW+tr+JZa99OyNmPINEGB/ahzKrEuc8rcv4gnpJmxTw==
   dependencies:
     "@types/node" "*"
 
@@ -3250,12 +3287,12 @@ assign-symbols@^1.0.0:
   resolved "https://registry.yarnpkg.com/assign-symbols/-/assign-symbols-1.0.0.tgz#59667f41fadd4f20ccbc2bb96b8d4f7f78ec0367"
   integrity sha1-WWZ/QfrdTyDMvCu5a41Pf3jsA2c=
 
-async-mutex@^0.3.1:
-  version "0.3.2"
-  resolved "https://registry.yarnpkg.com/async-mutex/-/async-mutex-0.3.2.tgz#1485eda5bda1b0ec7c8df1ac2e815757ad1831df"
-  integrity sha512-HuTK7E7MT7jZEh1P9GtRW9+aTWiDWWi9InbZ5hjxrnRa39KS4BW04+xLBhYNS2aXhHUIKZSw3gj4Pn1pj+qGAA==
+async-mutex@^0.5.0:
+  version "0.5.0"
+  resolved "https://registry.yarnpkg.com/async-mutex/-/async-mutex-0.5.0.tgz#353c69a0b9e75250971a64ac203b0ebfddd75482"
+  integrity sha512-1A94B18jkJ3DYq284ohPxoXbfTA5HsQ7/Mf4DEhcyLx3Bz27Rh59iScbB6EPiP+B+joue6YCxcMXSbFC1tZKwA==
   dependencies:
-    tslib "^2.3.1"
+    tslib "^2.4.0"
 
 asynckit@^0.4.0:
   version "0.4.0"
@@ -4543,6 +4580,13 @@ debug@^4.1.1, debug@^4.3.1, debug@^4.3.2, debug@^4.3.4:
   dependencies:
     ms "2.1.2"
 
+debug@^4.3.7:
+  version "4.4.0"
+  resolved "https://registry.yarnpkg.com/debug/-/debug-4.4.0.tgz#2b3f2aea2ffeb776477460267377dc8710faba8a"
+  integrity sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==
+  dependencies:
+    ms "^2.1.3"
+
 debuglog@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/debuglog/-/debuglog-1.0.1.tgz#aa24ffb9ac3df9a2351837cfb2d279360cd78492"
@@ -4823,17 +4867,6 @@ electron-to-chromium@^1.5.73:
   resolved "https://registry.yarnpkg.com/electron-to-chromium/-/electron-to-chromium-1.5.84.tgz#8e334ca206bb293a20b16418bf454783365b0a95"
   integrity sha512-I+DQ8xgafao9Ha6y0qjHHvpZ9OfyA1qKlkHkjywxzniORU2awxyz7f/iVJcULmrF2yrM3nHQf+iDjJtbbexd/g==
 
-electrum-cash@^2.0.10:
-  version "2.0.10"
-  resolved "https://registry.yarnpkg.com/electrum-cash/-/electrum-cash-2.0.10.tgz#0b2831d01b214bff1dfee7b90022f36126cb6945"
-  integrity sha512-xxKXWyDsnUR2pkqzb7r7ANf6yzlHO8+Rkq8HOFkKiH1tF1BJwyh6sDhGAy4lkTv2sU8Uv1em/itYZ5n2Cr6zaA==
-  dependencies:
-    "@types/ws" "^7.4.6"
-    async-mutex "^0.3.1"
-    debug "^4.3.2"
-    isomorphic-ws "^4.0.1"
-    ws "^7.5.2"
-
 elliptic@^6.5.2:
   version "6.5.3"
   resolved "https://registry.yarnpkg.com/elliptic/-/elliptic-6.5.3.tgz#cb59eb2efdaf73a0bd78ccd7015a62ad6e0f93d6"
@@ -5325,6 +5358,11 @@ eventemitter3@^3.1.0:
   resolved "https://registry.yarnpkg.com/eventemitter3/-/eventemitter3-3.1.2.tgz#2d3d48f9c346698fce83a85d7d664e98535df6e7"
   integrity sha512-tvtQIeLVHjDkJYnzf2dgVMxfuSGJeM/7UCG17TT4EumTfNtF+0nebF/4zWOIkCreAbtNqhGEboB6BWrwqNaw4Q==
 
+eventemitter3@^5.0.1:
+  version "5.0.1"
+  resolved "https://registry.yarnpkg.com/eventemitter3/-/eventemitter3-5.0.1.tgz#53f5ffd0a492ac800721bb42c66b841de96423c4"
+  integrity sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==
+
 evp_bytestokey@^1.0.3:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/evp_bytestokey/-/evp_bytestokey-1.0.3.tgz#7fcbdb198dc71959432efe13842684e0525acb02"
@@ -6979,11 +7017,6 @@ isobject@^3.0.0, isobject@^3.0.1:
   resolved "https://registry.yarnpkg.com/isobject/-/isobject-3.0.1.tgz#4e431e92b11a9731636aa1f9c8d1ccbcfdab78df"
   integrity sha1-TkMekrEalzFjaqH5yNHMvP2reN8=
 
-isomorphic-ws@^4.0.1:
-  version "4.0.1"
-  resolved "https://registry.yarnpkg.com/isomorphic-ws/-/isomorphic-ws-4.0.1.tgz#55fd4cd6c5e6491e76dc125938dd863f5cd4f2dc"
-  integrity sha512-BhBvN2MBpWTaSHdWRb/bwdZJ1WaehQ2L1KngkCkfLUGF0mAWAT1sQUQacEmQ0jXkFw/czDXPNQSL5u2/Krsz1w==
-
 isstream@~0.1.2:
   version "0.1.2"
   resolved "https://registry.yarnpkg.com/isstream/-/isstream-0.1.2.tgz#47e63f7af55afa6f92e1500e690eb8b8529c099a"
@@ -7837,6 +7870,11 @@ lodash@^4.17.12, lodash@^4.17.15, lodash@^4.17.19, lodash@^4.2.1:
   resolved "https://registry.yarnpkg.com/lodash/-/lodash-4.17.20.tgz#b44a9b6297bcb698f1c51a3545a2b3b368d59c52"
   integrity sha512-PlhdFcillOINfeV7Ni6oF1TAEayyZBoZ8bcshTHqOYJYlrqzRK5hagpagky5o4HfCzzd1TRkXPMFq6cKk9rGmA==
 
+lossless-json@^4.0.1:
+  version "4.0.2"
+  resolved "https://registry.yarnpkg.com/lossless-json/-/lossless-json-4.0.2.tgz#f00c52815805d1421930a87e2670e27350958a3f"
+  integrity sha512-+z0EaLi2UcWi8MZRxA5iTb6m4Ys4E80uftGY+yG5KNFJb5EceQXOhdW/pWJZ8m97s26u7yZZAYMcKWNztSZssA==
+
 loud-rejection@^1.0.0:
   version "1.6.0"
   resolved "https://registry.yarnpkg.com/loud-rejection/-/loud-rejection-1.6.0.tgz#5b46f80147edee578870f086d04821cf998e551f"
@@ -8210,7 +8248,7 @@ ms@2.1.2, ms@^2.0.0:
   resolved "https://registry.yarnpkg.com/ms/-/ms-2.1.2.tgz#d09d1f357b443f493382a8eb3ccd183872ae6009"
   integrity sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==
 
-ms@^2.1.1:
+ms@^2.1.1, ms@^2.1.3:
   version "2.1.3"
   resolved "https://registry.yarnpkg.com/ms/-/ms-2.1.3.tgz#574c8138ce1d2b5861f0b44579dbadd60c6615b2"
   integrity sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==
@@ -10614,10 +10652,10 @@ tslib@^1.9.0:
   resolved "https://registry.yarnpkg.com/tslib/-/tslib-1.13.0.tgz#c881e13cc7015894ed914862d276436fa9a47043"
   integrity sha512-i/6DQjL8Xf3be4K/E6Wgpekn5Qasl1usyw++dAA35Ue5orEn65VIxOA+YvNNl9HV3qv70T7CNwjODHZrLwvd1Q==
 
-tslib@^2.3.1:
-  version "2.6.2"
-  resolved "https://registry.yarnpkg.com/tslib/-/tslib-2.6.2.tgz#703ac29425e7b37cd6fd456e92404d46d1f3e4ae"
-  integrity sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q==
+tslib@^2.4.0:
+  version "2.8.1"
+  resolved "https://registry.yarnpkg.com/tslib/-/tslib-2.8.1.tgz#612efe4ed235d567e8aba5f2a5fab70280ade83f"
+  integrity sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==
 
 tsx@^4.19.2:
   version "4.19.2"
@@ -11198,10 +11236,10 @@ write-pkg@^3.1.0:
     sort-keys "^2.0.0"
     write-json-file "^2.2.0"
 
-ws@^7.5.2:
-  version "7.5.9"
-  resolved "https://registry.yarnpkg.com/ws/-/ws-7.5.9.tgz#54fa7db29f4c7cec68b1ddd3a89de099942bb591"
-  integrity sha512-F+P9Jil7UiSKSkppIiD94dN07AwvFixvLIj1Og1Rl9GGMuNipJnV9JzjD6XuqmAeiswGvUmNLjr5cFuXwNS77Q==
+ws@^8.13.0:
+  version "8.18.1"
+  resolved "https://registry.yarnpkg.com/ws/-/ws-8.18.1.tgz#ea131d3784e1dfdff91adb0a4a116b127515e3cb"
+  integrity sha512-RKW2aJZMXeMxVpnZ6bck+RswznaxmzdULiBr6KY7XkTnW8uvt0iT9H5DkHUChXrc+uurzwa0rVI16n/Xzjdz1w==
 
 xdg-basedir@^5.1.0:
   version "5.1.0"

From 47d29372460bc397abc174e7404b7620858b6ecc Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 4 Mar 2025 11:59:18 +0100
Subject: [PATCH 189/267] Bump version to 0.11.0-next.2

---
 examples/package.json               | 6 +++---
 examples/testing-suite/package.json | 6 +++---
 packages/cashc/package.json         | 4 ++--
 packages/cashc/src/index.ts         | 2 +-
 packages/cashscript/package.json    | 4 ++--
 packages/utils/package.json         | 2 +-
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index 0f548dc5..15ff2d15 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.11.0-next.1",
+  "version": "0.11.0-next.2",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
     "@types/node": "^22.10.7",
-    "cashc": "^0.11.0-next.1",
-    "cashscript": "^0.11.0-next.1",
+    "cashc": "^0.11.0-next.2",
+    "cashscript": "^0.11.0-next.2",
     "eslint": "^8.56.0",
     "typescript": "^5.7.3"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 40dcba96..f266d9aa 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.11.0-next.1",
+  "version": "0.11.0-next.2",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -26,8 +26,8 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "cashc": "^0.11.0-next.1",
-    "cashscript": "^0.11.0-next.1",
+    "cashc": "^0.11.0-next.2",
+    "cashscript": "^0.11.0-next.2",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 828dcd4f..f0bad7ab 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.11.0-next.1",
+  "version": "0.11.0-next.2",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.1",
+    "@cashscript/utils": "^0.11.0-next.2",
     "antlr4": "^4.13.2",
     "commander": "^13.1.0",
     "semver": "^7.6.3"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 0a5d6122..12e4a4e2 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.11.0-next.1';
+export const version = '0.11.0-next.2';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index f6372471..bb3ba65d 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.11.0-next.1",
+  "version": "0.11.0-next.2",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.1",
+    "@cashscript/utils": "^0.11.0-next.2",
     "@electrum-cash/network": "^4.1.1",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "change-case": "^5.4.4",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 6a6e8eb8..85594dae 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.11.0-next.1",
+  "version": "0.11.0-next.2",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From 7d95d870894406372668aa1b82db6866f9dc9518 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 4 Mar 2025 12:41:07 +0100
Subject: [PATCH 190/267] tiny docs fix

---
 website/docs/sdk/network-provider.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/website/docs/sdk/network-provider.md b/website/docs/sdk/network-provider.md
index 97faf9c6..48fd1de3 100644
--- a/website/docs/sdk/network-provider.md
+++ b/website/docs/sdk/network-provider.md
@@ -12,7 +12,7 @@ The ElectrumNetworkProvider uses [@electrum-cash/network][electrum-cash] to conn
 new ElectrumNetworkProvider(network?: Network, options?: Options)
 ```
 
-Using the `network` parameter, you can specify the network to connect to.
+Using the `network` parameter, you can specify the network to connect to. The network parameter can be one of 5 different options:
 
 ```ts
 type Network = 'mainnet' | 'chipnet' | 'testnet3' | 'testnet4' | 'regtest';
@@ -36,8 +36,6 @@ interface CustomElectrumOptions extends OptionsBase {
 }
 ```
 
-The network parameter can be one of 5 different options.
-
 #### Example
 ```ts
 const hostname = 'chipnet.bch.ninja';

From f2ea16f1b575f8f72ae9c994c82edd81055c889a Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 5 Mar 2025 11:10:35 +0100
Subject: [PATCH 191/267] improve docs example tuple

---
 website/docs/language/types.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index a5597454..23edc552 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -138,14 +138,14 @@ Tuples are the type that is returned when calling the `split` member function on
 
 ```solidity
 string question = "What is Bitcoin Cash?";
-string answer = question.split(15)[0].split(8)[1];
+string answer = question.split(15)[0].split(8)[1]; // Answer is "Cash"
 ```
 
 It is also possible to assign both sides of the tuple at once with a destructuring syntax:
 
 ```solidity
-string bitcoin, string cash = "BitcoinCash".split(7);
-require(bitcoin == cash);
+string hello, string world = "Hello World".split(5);
+require(hello + "world" == "Hello " + world);
 ```
 
 ## Type Casting

From 92ba1cf6663c3033c3abb966f2c6541dcc6dde28 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 5 Mar 2025 12:37:34 +0100
Subject: [PATCH 192/267] improve docs on Nullfail & add example for Nullfail
 handling

---
 website/docs/language/functions.md | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/website/docs/language/functions.md b/website/docs/language/functions.md
index d0740e10..2c8c3be8 100644
--- a/website/docs/language/functions.md
+++ b/website/docs/language/functions.md
@@ -71,9 +71,23 @@ Returns the double SHA-256 hash of argument `x`.
 
 ## Signature checking functions
 :::caution
-All signature checking functions must comply with the [NULLFAIL][bip146] rule. This means that if you want to use the output of a signature check inside the condition of an if-statement, the input signature needs to either be correct, or an empty byte array. When you use an incorrect signature as an input, the script will fail.
+All signature checking functions must comply with the [NULLFAIL][bip146] rule which only allows `0x` as an invalid signature — any other invalid signature will **immediately fail** the entire script.
 :::
 
+#### Nullfail example
+
+The `NULLFAIL` rule means passing an invalid  signature to `checkSig()` does not return `false` — it fails the script. To safely return `false` on a signature check, use an empty `0x` signature instead, as shown below:
+
+```solidity
+// this script will immediately fail
+// because userSig will be invalid for either the 'seller' or the 'refere'
+require(checkSig(userSig, seller) || checkSig(userSig, refere));
+
+// instead, use 2 different  signatures
+// set the unused signature to 0x so 'checkSig' returns false
+require(checkSig(sellerSig, seller) || checkSig(userSig, refere));
+```
+
 ### checkSig()
 ```solidity
 bool checksig(sig s, pubkey pk)

From 3dcbbdb76ff0c27df8f21f1b091ae8a9d56a271f Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 5 Mar 2025 13:37:15 +0100
Subject: [PATCH 193/267] update test FullStackNetworkProvider to use
 TransactionBuilder

---
 .../network/FullStackNetworkProvider.test.ts  | 22 +++++++++++--------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/packages/cashscript/test/e2e/network/FullStackNetworkProvider.test.ts b/packages/cashscript/test/e2e/network/FullStackNetworkProvider.test.ts
index 4fb3fd7e..7de56703 100644
--- a/packages/cashscript/test/e2e/network/FullStackNetworkProvider.test.ts
+++ b/packages/cashscript/test/e2e/network/FullStackNetworkProvider.test.ts
@@ -1,14 +1,14 @@
 import BCHJS from '@psf/bch-js';
-import { Contract, SignatureTemplate, FullStackNetworkProvider } from '../../../src/index.js';
+import { Contract, SignatureTemplate, FullStackNetworkProvider, TransactionBuilder } from '../../../src/index.js';
 import {
   alicePriv,
   bobPkh,
   bobPriv,
   bobPub,
 } from '../../fixture/vars.js';
-import { describeOrSkip, getTxOutputs } from '../../test-util.js';
+import { describeOrSkip, gatherUtxos, getTxOutputs } from '../../test-util.js';
 import { FailedRequireError } from '../../../src/Errors.js';
-import artifact from '../../fixture/p2pkh.json' with { type: 'json' };
+import artifact from '../../fixture/p2pkh.artifact.js';
 
 describeOrSkip(!process.env.TESTS_USE_MOCKNET, 'test FullStackNetworkProvider', () => {
   const provider = new FullStackNetworkProvider('mainnet', new BCHJS({ restURL: 'https://api.fullstack.cash/v5/' }));
@@ -42,11 +42,13 @@ describeOrSkip(!process.env.TESTS_USE_MOCKNET, 'test FullStackNetworkProvider',
       // given
       const to = p2pkhInstance.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await p2pkhInstance.getUtxos(), { amount });
 
       // when
-      const txPromise = p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(alicePriv))
-        .to(to, amount)
+      const txPromise = new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhInstance.unlock.spend(bobPub, new SignatureTemplate(alicePriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then
@@ -58,11 +60,13 @@ describeOrSkip(!process.env.TESTS_USE_MOCKNET, 'test FullStackNetworkProvider',
       // given
       const to = p2pkhInstance.address;
       const amount = 10000n;
+      const { utxos, changeAmount } = gatherUtxos(await p2pkhInstance.getUtxos(), { amount });
 
       // when
-      const tx = await p2pkhInstance.functions
-        .spend(bobPub, new SignatureTemplate(bobPriv))
-        .to(to, amount)
+      const tx = await new TransactionBuilder({ provider })
+        .addInputs(utxos, p2pkhInstance.unlock.spend(bobPub, new SignatureTemplate(bobPriv)))
+        .addOutput({ to, amount })
+        .addOutput({ to, amount: changeAmount })
         .send();
 
       // then

From bc9fe16d8f490d5aae652b43eb1d89136f6b62e2 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 6 Mar 2025 09:07:34 +0100
Subject: [PATCH 194/267] add .setLocktime to example & getting started

---
 website/docs/basics/getting-started.md | 2 ++
 website/docs/sdk/examples.md           | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index b9d1f325..1e18b833 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -169,3 +169,5 @@ console.log(transferDetails);
 ```
 
 Congrats 🎉! You've successfully created a transaction spending from a Bitcoin Cash smart contract!
+
+To use the `timeout` function you need to use Alice as signer for the spending condition. Secondly you also need get to use `.setLocktime()` with a valid argument during the transaction building to pass the `tx.time` check of the `timeout` function.
diff --git a/website/docs/sdk/examples.md b/website/docs/sdk/examples.md
index 7047ae5e..04b828dc 100644
--- a/website/docs/sdk/examples.md
+++ b/website/docs/sdk/examples.md
@@ -150,6 +150,9 @@ const contractUtxos = await contract.getUtxos();
 console.log('contract address:', contract.address);
 console.log('contract utxos', contractUtxos);
 
+// get current blockheight
+const currentBlockHeight = await provider.getBlockHeight()
+
 // Produce new oracle message and signature
 const oracleMessage = oracle.createMessage(100000n, 30000n);
 const oracleSignature = oracle.signMessage(oracleMessage);
@@ -167,6 +170,7 @@ const transferDetails = await new TransactionBuilder({ provider })
     to: contract.address,
     amount: 1000n
   })
+  .setLocktime(currentBlockHeight)
   .send();
 
 console.log(transferDetails);

From 39a18d50725add7721ed6a20df1feb21cc723758 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 10 Mar 2025 07:54:46 +0100
Subject: [PATCH 195/267] add new test case to multi-contract-fixtures

---
 .../multi-contract-fixtures.ts                | 246 +++++++++++++++++-
 1 file changed, 245 insertions(+), 1 deletion(-)

diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index 2f0c6776..b1a2947d 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -3,7 +3,7 @@ import BarArtifact from '../Bar.artifact.js';
 import FooArtifact from '../Foo.artifact.js';
 import twtArtifact from '../transfer_with_timeout.artifact.js';
 import hodlVaultArtifact from '../hodl_vault.artifact.js';
-import { aliceAddress, alicePkh, alicePriv, alicePub, aliceTokenAddress, bobPriv, bobPub, carolPub, oracle, oraclePub } from '../vars.js';
+import { aliceAddress, alicePkh, alicePriv, alicePub, aliceTokenAddress, bobPriv, bobPub, carolPriv, carolPub, oracle, oraclePub } from '../vars.js';
 import { WalletTemplate } from '@bitauth/libauth';
 
 const provider = new MockNetworkProvider();
@@ -1506,6 +1506,250 @@ export const fixtures: Fixture[] = [
       },
     },
   },
+  {
+    name: 'TwtContract timeout + twtContract transfer',
+    transaction: ( async () => {
+      const twtContract = new Contract(twtArtifact, [bobPub, carolPub, 100000n], { provider });
+      provider.addUtxo(twtContract.address, randomUtxo());
+      provider.addUtxo(twtContract.address, randomUtxo());
+
+      const twtContractUtxos = await twtContract.getUtxos();
+
+      const bobTemplate = new SignatureTemplate(bobPriv);
+      const carolTemplate = new SignatureTemplate(carolPriv);
+
+      return new TransactionBuilder({ provider })
+        .addInput(twtContractUtxos[0], twtContract.unlock.timeout(bobTemplate))
+        .addInput(twtContractUtxos[1], twtContract.unlock.transfer(carolTemplate))
+        .addOutput({ to: twtContract.address, amount: 20_000n });
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2025_05',
+      ],
+      'version': 0,
+      'entities': {
+        'transfer_with_timeout_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Transfer With Timeout',
+          'scripts': [
+            'transfer_with_timeout_lock',
+            'transfer_with_timeout_transfer_unlock',
+          ],
+          'variables': {
+            'recipient_sig': {
+              'description': '"recipientSig" parameter of function "transfer"',
+              'name': 'Recipient Sig',
+              'type': 'Key',
+            },
+            'sender_sig': {
+              'description': '"senderSig" parameter of function "timeout"',
+              'name': 'Sender Sig',
+              'type': 'Key',
+            },
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'Sender',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'Recipient',
+              'type': 'WalletData',
+            },
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'Timeout',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'transfer_with_timeout_timeout_unlock': {
+          'passes': [
+            'transfer_with_timeout_timeout_evaluate',
+          ],
+          'name': 'timeout',
+          'script': '// "timeout" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'transfer_with_timeout_lock',
+        },
+        'transfer_with_timeout_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'TransferWithTimeout',
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+        },
+        'transfer_with_timeout_transfer_unlock': {
+          'passes': [
+            'transfer_with_timeout_transfer_evaluate',
+          ],
+          'name': 'transfer',
+          'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'transfer_with_timeout_lock',
+        },
+      },
+      'scenarios': {
+        'transfer_with_timeout_timeout_evaluate': {
+          'name': 'transfer_with_timeout_timeout_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+              'timeout': '0xa08601',
+              'function_index': '1',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'sender_sig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'transfer_with_timeout_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'timeout': '0xa08601',
+                    },
+                  },
+                },
+                'valueSatoshis': 20000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+        'transfer_with_timeout_transfer_evaluate': {
+          'name': 'transfer_with_timeout_transfer_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+              'timeout': '0xa08601',
+              'function_index': '0',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'recipient_sig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'transfer_with_timeout_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'timeout': '0xa08601',
+                    },
+                  },
+                },
+                'valueSatoshis': 20000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
   {
     // TODO: Duplicate input scenarios with the same function call have the same name
     name: 'Duplicate function calls',

From aced094455ad91cb106127c28e9cdc5be8784e35 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 10 Mar 2025 08:49:21 +0100
Subject: [PATCH 196/267] improve documentation on BCH script & transaction
 limits

---
 website/docs/compiler/script-limits.md | 87 ++++++++++++++++++++++++++
 website/docs/compiler/vm-limits.md     | 46 --------------
 2 files changed, 87 insertions(+), 46 deletions(-)
 create mode 100644 website/docs/compiler/script-limits.md
 delete mode 100644 website/docs/compiler/vm-limits.md

diff --git a/website/docs/compiler/script-limits.md b/website/docs/compiler/script-limits.md
new file mode 100644
index 00000000..acc2e4aa
--- /dev/null
+++ b/website/docs/compiler/script-limits.md
@@ -0,0 +1,87 @@
+---
+title: BCH Script & Transaction Limits
+sidebar_label: Script & Transaction Limits
+---
+
+Bitcoin Cash imposes various constraints on scripts and transactions to ensure efficient contract execution and network stability. We'll categorize these limits into two types:
+
+1. Contract-related limits
+2. General transaction limits
+
+## Contract-related limits
+
+### Maximum contract size
+
+The Bitcoin Cash VM limits contract bytecode to **1,650 bytes**. While typical contracts stay well below this, complex contracts with extensive logic might need adjustments to fit within this constraint.
+
+#### Modular contract design
+
+To keep contracts within size limits, consider modular design. Splitting contract logic into smaller, independent components allows each function to be deployed separately, reducing transaction size. See [Contract Optimization](/docs/guides/optimization) for more details.
+
+### NFT commitment length limit
+
+NFT commitments can store up to 40 bytes of data as local state. If more data is needed, you can hash the full state and store only the hash in the commitment data. Later, when required, the full state must be provided and validated against the stored hash.
+
+### Operation cost limit
+
+Bitcoin Cash enforces an operation cost limit (op-cost) per transaction input. This determines the computational budget available for operations in a contract. The op-cost is based on script length: longer input scripts allow for a higher compute budget.
+
+#### Buying compute budget
+
+Since longer input scripts allow for a larger compute budget, some contracts use zero-padding (adding non-functional bytes) to "buy" more computation power without changing logic. You can find the exact op-cost per operation in the [op-cost-table][op-cost-table].
+
+```ts
+function maxOperationCost(unlockingBytecodeLength) {  
+  return (41n + unlockingBytecodeLength) * 800n;  
+}
+```
+
+### Other contract-related limits
+
+- Signature operation count (SigChecks): Limits the number of signature verifications (`OP_CHECKSIG`, `OP_CHECKDATASIG`) per transaction to ensure efficient validation.
+- Hashing limit: Limits the number of hashing operations (`OP_SHA256`, `OP_HASH160`) allowed per transaction to prevent excessive resource usage.
+- Stack element byte length: Each stack element has a maximum length of 10,000 bytes, affecting Pay-to-Script-Hash (P2SH) contracts.
+
+## General transaction limits
+
+In addition to contract-related limits, Bitcoin Cash also enforces general transaction limits, which are network-level policies.
+
+### Maximum transaction size
+
+Bitcoin Cash transactions must not exceed 100,000 bytes to be considered standard. Transactions above this size may not be relayed by most nodes.
+
+### Data output size limit
+
+Bitcoin Cash allows multiple OP_RETURN outputs, but the total size of all data outputs in a transaction must not exceed 220 bytes of data payload (223 bytes total).
+
+### Dust threshold
+
+Bitcoin Cash defines a "dust" threshold for output value. Outputs below this threshold are considered dust and will not be relayed by standard nodes.
+
+The dust threshold is calculated as:
+
+```ts
+function calculateDust(outputSize: number): number {
+  const dustThreshold = 444 + outputSize * 3;
+  return dustThreshold;
+}
+```
+
+Before CashTokens `546` bytes was often used as good default value, however with tokenData outputs have become larger in size.
+For ease of development, it is standard practice to use 1,000 satoshis as dust to outputs. Provably unspendable outputs (OP_RETURN outputs) are exempt from this rule.
+
+## Summary table
+
+| Limit type | Constraint |
+|------------|-------------|
+| Max contract size | 1,650 bytes |
+| NFT commitment length | 40 bytes |
+| Operation cost limit | Based on script length |
+| Max stack element size | 10,000 bytes |
+| Max transaction size | 100,000 bytes |
+| Max OP_RETURN data size | 220 bytes data payload |
+| Dust threshold | based on output size (commonly 1,000 sats is used as dust) |
+
+For further details on transaction validation and standardness rules, see the [documentation on BCH transaction validation](https://documentation.cash/protocol/blockchain/transaction-validation.html).
+
+[op-cost-table]: https://github.com/bitjson/bch-vm-limits/blob/master/operation-costs.md
diff --git a/website/docs/compiler/vm-limits.md b/website/docs/compiler/vm-limits.md
deleted file mode 100644
index 39a5e981..00000000
--- a/website/docs/compiler/vm-limits.md
+++ /dev/null
@@ -1,46 +0,0 @@
----
-title: Bitcoin Cash VM Limits
-sidebar_label: VM Limits
----
-
-Bitcoin Cash enforces VM limits to ensure secure and efficient contract execution. When developing with CashScript, keep these limits in mind to ensure your contracts run smoothly without encountering transaction errors due to size or computational constraints.
-
-## Maximum Contract Size
-
-The Bitcoin Cash VM has a **maximum size for smart contracts** which limits the length of input bytecode to **1,650 bytes**. While typical contracts stay well below this, complex contracts with extensive logic might require adjustments to fit within this constraint.
-
-### Modular Contract Design
-
-If your contract includes multiple functions, consider a modular design. Separating contract logic into independent components allows each function to be deployed as a smaller contract, reducing the overall transaction size. This approach can naturally divide complex contracts without impacting functionality. For more on this, see the guide on [Contract Optimization](/docs/guides/optimization).
-
-## Operation Cost Limit
-
-Bitcoin Cash also enforces an **operation cost limit** (op-cost) on each transaction input. The op-cost limit controls the computational budget available for operations in a contract and is calculated based on the input length, with each byte allowing for a higher maximum operation cost.
-
-```ts
-function maxOperationCost(unlockingBytecodeLength) {
-  return (41n + unlockingBytecodeLength) * 800n;
-}
-```
-
-With this formula, increasing your input length allows for a larger compute budget. You can view specific op-costs for each operation in the [op-cost-table][op-cost-table], which outlines the compute cost of operation.
-
-### Buying Compute Budget
-
-To increase your contract's compute budget for resource-intensive operations (e.g., cryptographic hashing or large number calculations), you can use zero-padding to extend the input length. By adding non-essential, zero-value bytes, you effectively buy more computation power for your contract without adding functional complexity. This technique could be useful for contracts requiring a higher operation budget, allowing them to meet the contract's computational demands without exceeding the op-cost limit.
-
-## NFT Commitment Length Limit
-
-Currently NFT commitments can keep no more than 40 bytes of data as local state. To work around this limit it is possible to hash state longer than 40 bytes so it fits within the length limit. Then in a later transaction the full state has to be provided and has to match the state-hash.  
-
-## Other Limits
-
-For completeness, here are additional Bitcoin Cash VM limits relevant to CashScript development:
-
-- **Signature Operation Count** (SigChecks) Limits the number of signature verifications (e.g. `OP_CHECKSIG`, `OP_CHECKDATASIG`) per transaction to ensure efficient validation.
-
-- **Hashing Limit**: Limits the number of hashing operations (e.g. `OP_SHA256`, `OP_HASH160`) allowed per transaction to prevent excessive resource usage.
-
-- **Stack Element Byte Length**: Each stack element has a maximum length of 10,000 bytes. This limit also affects the size of Pay-to-Script-Hash (P2SH) contracts which are pushed as an element to the stack on spending.
-
-[op-cost-table]: https://github.com/bitjson/bch-vm-limits/blob/master/operation-costs.md

From 3664175fca7e6d0b391e3d41e952ce5095dd933d Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 10 Mar 2025 09:27:02 +0100
Subject: [PATCH 197/267] spellcheck fixes + sidebar fix

---
 .cspell.json                             | 2 ++
 website/docs/language/functions.md       | 6 +++---
 website/docs/releases/migration-notes.md | 2 +-
 website/docs/sdk/examples.md             | 2 +-
 website/sidebars.js                      | 2 +-
 5 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/.cspell.json b/.cspell.json
index a3359143..43f004e9 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -199,6 +199,7 @@
         "workdir"
     ],
     "ignoreWords": [
+        "addinput",
         "bitcats",
         "bitcoincashjs",
         "branchup",
@@ -230,6 +231,7 @@
         "pushd",
         "sendrawtransaction",
         "setfiletype",
+        "setlocktime",
         "tada",
         "tapswap",
         "tokenaut",
diff --git a/website/docs/language/functions.md b/website/docs/language/functions.md
index 2c8c3be8..2cec0839 100644
--- a/website/docs/language/functions.md
+++ b/website/docs/language/functions.md
@@ -80,12 +80,12 @@ The `NULLFAIL` rule means passing an invalid  signature to `checkSig()` does not
 
 ```solidity
 // this script will immediately fail
-// because userSig will be invalid for either the 'seller' or the 'refere'
-require(checkSig(userSig, seller) || checkSig(userSig, refere));
+// because userSig will be invalid for either the 'seller' or the 'referee'
+require(checkSig(userSig, seller) || checkSig(userSig, referee));
 
 // instead, use 2 different  signatures
 // set the unused signature to 0x so 'checkSig' returns false
-require(checkSig(sellerSig, seller) || checkSig(userSig, refere));
+require(checkSig(sellerSig, seller) || checkSig(userSig, referee));
 ```
 
 ### checkSig()
diff --git a/website/docs/releases/migration-notes.md b/website/docs/releases/migration-notes.md
index 04d704dc..34d75027 100644
--- a/website/docs/releases/migration-notes.md
+++ b/website/docs/releases/migration-notes.md
@@ -73,7 +73,7 @@ With the new transaction builder, all inputs and outputs are explicitly specifie
 
 ### CashScript SDK (ElectrumNetworkProvider)
 
-The underlying `electrum-cash` library has been mgrated to the new `@electrum-cash/network` package. This drops support for electrum cluster functionality. We reworked the second parameter of the `ElectrumNetworkProvider` constructor to be an options object, which can contain a custom electrum client or a custom hostname.
+The underlying `electrum-cash` library has been migrated to the new `@electrum-cash/network` package. This drops support for electrum cluster functionality. We reworked the second parameter of the `ElectrumNetworkProvider` constructor to be an options object, which can contain a custom electrum client or a custom hostname.
 
 If you were not using custom clusters, there is no need to change anything. If you were using custom clusters, you will need to update your code to use the new `@electrum-cash/network` package and use a single client instead of a cluster.
 
diff --git a/website/docs/sdk/examples.md b/website/docs/sdk/examples.md
index 04b828dc..25fd2beb 100644
--- a/website/docs/sdk/examples.md
+++ b/website/docs/sdk/examples.md
@@ -150,7 +150,7 @@ const contractUtxos = await contract.getUtxos();
 console.log('contract address:', contract.address);
 console.log('contract utxos', contractUtxos);
 
-// get current blockheight
+// get current block height
 const currentBlockHeight = await provider.getBlockHeight()
 
 // Produce new oracle message and signature
diff --git a/website/sidebars.js b/website/sidebars.js
index 0c318587..909f0f22 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -25,7 +25,7 @@ module.exports = {
       label: 'Compiler',
       items: [
         'compiler/compiler',
-        'compiler/vm-limits',
+        'compiler/script-limits',
         'compiler/artifacts',
         'compiler/grammar',
       ],

From 13785016cce4627bc61f5fda806c237e1e6e7897 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 10 Mar 2025 12:11:54 +0100
Subject: [PATCH 198/267] rework docs for networkProvider

---
 website/docs/sdk/electrum-network-provider.md | 134 ++++++++++++++++++
 website/docs/sdk/network-provider.md          | 109 ++------------
 website/docs/sdk/other-network-providers.md   |  72 ++++++++++
 website/sidebars.js                           |  10 +-
 4 files changed, 227 insertions(+), 98 deletions(-)
 create mode 100644 website/docs/sdk/electrum-network-provider.md
 create mode 100644 website/docs/sdk/other-network-providers.md

diff --git a/website/docs/sdk/electrum-network-provider.md b/website/docs/sdk/electrum-network-provider.md
new file mode 100644
index 00000000..9544f5dd
--- /dev/null
+++ b/website/docs/sdk/electrum-network-provider.md
@@ -0,0 +1,134 @@
+---
+title: Electrum Network Provider
+---
+
+The CashScript SDK needs to connect to the BCH network to perform certain operations, like retrieving the contract's balance, or sending transactions. By default the network provider is an `ElectrumNetworkProvider`.
+
+## ElectrumNetworkProvider
+
+The ElectrumNetworkProvider uses [@electrum-cash/network][electrum-cash] to connect to the BCH network. Both `network` and `options` parameters are optional, and they default to mainnet with the `bch.imaginary.cash` electrum server.
+
+```ts
+new ElectrumNetworkProvider(network?: Network, options?: Options)
+```
+
+Using the `network` parameter, you can specify the network to connect to. There's 4 networks supported by the `ElectrumNetworkProvider`:
+
+```ts
+type Network = 'mainnet' | 'chipnet' | 'testnet3' | 'testnet4';
+```
+
+Using the `options` parameter, you can specify a custom electrum client or hostname, and enable manual connection management.
+
+```ts
+type Options = OptionsBase | CustomHostNameOptions | CustomElectrumOptions;
+
+interface OptionsBase {
+  manualConnectionManagement?: boolean;
+}
+
+interface CustomHostNameOptions extends OptionsBase {
+  hostname: string;
+}
+
+interface CustomElectrumOptions extends OptionsBase {
+  electrum: ElectrumClient<ElectrumClientEvents>;
+}
+```
+
+#### Example
+```ts
+import { ElectrumNetworkProvider } from 'cashscript';
+
+const hostname = 'chipnet.bch.ninja';
+const provider = new ElectrumNetworkProvider('chipnet', { hostname });
+```
+
+### getUtxos()
+```ts
+async provider.getUtxos(address: string): Promise<Utxo[]>;
+```
+Returns all UTXOs on specific address. Both confirmed and unconfirmed UTXOs are included.
+
+```ts
+interface Utxo {
+  txid: string;
+  vout: number;
+  satoshis: bigint;
+  token?: TokenDetails;
+}
+```
+
+#### Example
+```ts
+const userUtxos = await provider.getUtxos(userAddress)
+```
+
+### getBlockHeight()
+```ts
+async provider.getBlockHeight(): Promise<number>;
+```
+Get the current blockHeight.
+
+#### Example
+```ts
+const currentBlockHeight = await provider.getBlockHeight()
+```
+
+### getRawTransaction()
+```ts
+async provider.getRawTransaction(txid: string): Promise<string>;
+```
+
+Retrieve the Hex transaction details for a given transaction ID.
+
+#### Example
+```ts
+const rawTransaction = await provider.getRawTransaction(txid)
+```
+
+### sendRawTransaction()
+```ts
+async provider.sendRawTransaction(txHex: string): Promise<string>;
+```
+Broadcast a raw hex transaction to the network.
+
+#### Example
+```ts
+const txId = await provider.sendRawTransaction(txHex)
+```
+
+### performRequest()
+
+Perform an arbitrary electrum request, refer to the docs at [electrum-cash-protocol](https://electrum-cash-protocol.readthedocs.io/en/latest/).
+
+#### Example
+```ts
+const verbose = true // get parsed transaction as json result
+const txId = await provider.performRequest('blockchain.transaction.get', txid, verbose)
+```
+
+### Manual Connection Management
+
+By default, the ElectrumNetworkProvider will automatically connect and disconnect to the electrum client as needed. However, you can enable manual connection management by setting the `manualConnectionManagement` option to `true`. This can be useful if you are passing a custom electrum client and are using that client for other purposes, such as subscribing to events.
+
+```ts
+const provider = new ElectrumNetworkProvider('chipnet', { manualConnectionManagement: true });
+```
+
+#### connect()
+```ts
+provider.connect(): Promise<void>;
+```
+
+Connects to the electrum client.
+
+#### disconnect()
+```ts
+provider.disconnect(): Promise<boolean>;
+```
+
+Disconnects from the electrum client, returns `true` if the client was connected, `false` if it was already disconnected.
+
+
+[electrum-cash]: https://www.npmjs.com/package/@electrum-cash/network
diff --git a/website/docs/sdk/network-provider.md b/website/docs/sdk/network-provider.md
index 48fd1de3..505a81e6 100644
--- a/website/docs/sdk/network-provider.md
+++ b/website/docs/sdk/network-provider.md
@@ -2,44 +2,24 @@
 title: Network Provider
 ---
 
-The CashScript SDK needs to connect to the BCH network to perform certain operations, like retrieving the contract's balance, or sending transactions. By default the network provider is an `ElectrumNetworkProvider`.
+The CashScript SDK needs to connect to the BCH network to perform certain operations, like retrieving the contract's balance, or sending transactions. By default the network provider is an `ElectrumNetworkProvider`, however for local development it is recommended to use a `MockNetworkProvider`.
 
-## ElectrumNetworkProvider
-
-The ElectrumNetworkProvider uses [@electrum-cash/network][electrum-cash] to connect to the BCH network. Both `network` and `options` parameters are optional, and they default to mainnet with the `bch.imaginary.cash` electrum server.
-
-```ts
-new ElectrumNetworkProvider(network?: Network, options?: Options)
-```
+:::tip
+CashScript NetworkProviders have a standardized interface, this allows different network providers to be used by the SDK and makes it easy to swap out dependencies.
+:::
 
-Using the `network` parameter, you can specify the network to connect to. The network parameter can be one of 5 different options:
+## Interface NetworkProvider
 
+### Network
 ```ts
-type Network = 'mainnet' | 'chipnet' | 'testnet3' | 'testnet4' | 'regtest';
+type Network = 'mainnet' | 'chipnet' | 'mocknet' | 'testnet3' | 'testnet4' | 'regtest';
 ```
 
-Using the `options` parameter, you can specify a custom electrum client or hostname, and enable manual connection management.
-
-```ts
-type Options = OptionsBase | CustomHostNameOptions | CustomElectrumOptions;
-
-interface OptionsBase {
-  manualConnectionManagement?: boolean;
-}
-
-interface CustomHostNameOptions extends OptionsBase {
-  hostname: string;
-}
-
-interface CustomElectrumOptions extends OptionsBase {
-  electrum: ElectrumClient<ElectrumClientEvents>;
-}
-```
+The network parameter can be one of 6 different options.
 
 #### Example
 ```ts
-const hostname = 'chipnet.bch.ninja';
-const provider = new ElectrumNetworkProvider('chipnet', { hostname });
+const connectedNetwork = provider.network;
 ```
 
 ### getUtxos()
@@ -96,73 +76,8 @@ Broadcast a raw hex transaction to the network.
 const txId = await provider.sendRawTransaction(txHex)
 ```
 
-### performRequest()
-
-Perform an arbitrary electrum request, refer to the docs at [electrum-cash-protocol](https://electrum-cash-protocol.readthedocs.io/en/latest/).
-
-#### Example
-```ts
-const verbose = true // get parsed transaction as json result
-const txId = await provider.performRequest('blockchain.transaction.get', txid, verbose)
-```
-
-### Manual Connection Management
-
-By default, the ElectrumNetworkProvider will automatically connect and disconnect to the electrum client as needed. However, you can enable manual connection management by setting the `manualConnectionManagement` option to `true`. This can be useful if you are passing a custom electrum client and are using that client for other purposes, such as subscribing to events.
-
-```ts
-const provider = new ElectrumNetworkProvider('chipnet', { manualConnectionManagement: true });
-```
-
-#### connect()
-```ts
-provider.connect(): Promise<void>;
-```
-
-Connects to the electrum client.
-
-#### disconnect()
-```ts
-provider.disconnect(): Promise<boolean>;
-```
-
-Disconnects from the electrum client, returns `true` if the client was connected, `false` if it was already disconnected.
-
-
-## Advanced Options
-
-All network functionality that the CashScript SDK needs is encapsulated in a network provider. This allows different network providers to be used and makes it easy to swap out dependencies.
-
-### MockNetworkProvider
-```ts
-new MockNetworkProvider()
-```
-
-The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. You can read more about the `MockNetworkProvider` and automated tests on the [testing setup](/docs/sdk/testing-setup) page.
-
-#### Example
-```ts
-const provider = new MockNetworkProvider();
-const newUtxo = randomUtxo({satoshis: 10_000n})
-provider.addUtxo(contractAddress, newUtxo);
-```
-
-### Other NetworkProviders
-
-There are two alternative network providers implemented:
-- `FullStackNetworkProvider`: uses [FullStack.cash][fullstack]' infrastructure to connect to the BCH network.
-- `BitcoinRpcNetworkProvider`: uses a direct connection to a Bitcoin Cash node.
-
-Currently neither supports CashTokens, so it is recommended to use the `ElectrumNetworkProvider`.
-
-### Custom NetworkProviders
-A big strength of the NetworkProvider setup is that it allows you to implement custom providers. So if you want to use a new or different BCH indexers for network information, it is simple to use it with CashScript.
-
-:::info
-To implement a Custom NetworkProvider, refer to the [NetworkProvider interface](https://github.com/CashScript/cashscript/blob/master/packages/cashscript/src/network/NetworkProvider.ts).
-:::
+## Custom NetworkProviders
 
+A big strength of the NetworkProvider setup is that it allows you to implement custom providers. So if you want to use a new or different BCH indexer for network information, it is simple to add support for it by creating your own `NetworkProvider` adapter by implementing the [NetworkProvider interface](https://github.com/CashScript/cashscript/blob/master/packages/cashscript/src/network/NetworkProvider.ts).
 
-[electrum-cash]: https://www.npmjs.com/package/@electrum-cash/network
-[fullstack]: https://fullstack.cash/
-[bchjs]: https://bchjs.fullstack.cash/
+You can create a PR to add your custom `NetworkProvider` to the CashScript codebase to share this functionality with others. It is required to have basic automated tests for any new `NetworkProvider`.
diff --git a/website/docs/sdk/other-network-providers.md b/website/docs/sdk/other-network-providers.md
new file mode 100644
index 00000000..3d8b0295
--- /dev/null
+++ b/website/docs/sdk/other-network-providers.md
@@ -0,0 +1,72 @@
+---
+title: Other Network Providers
+---
+
+The CashScript SDK needs to connect to the BCH network to perform certain operations, like retrieving the contract's balance, or sending transactions.
+
+## MockNetworkProvider
+```ts
+new MockNetworkProvider()
+```
+
+The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. You can read more about the `MockNetworkProvider` and automated tests on the [testing setup](/docs/sdk/testing-setup) page.
+
+#### Example
+```ts
+const provider = new MockNetworkProvider();
+const newUtxo = randomUtxo({satoshis: 10_000n})
+provider.addUtxo(contractAddress, newUtxo);
+```
+
+The network type of the `MockNetworkProvider`.
+
+## Other NetworkProviders
+
+There are two alternative network providers implemented. Currently neither supports CashTokens, so it is recommended to use the `ElectrumNetworkProvider`.
+
+### FullStackNetworkProvider
+
+```ts
+new FullStackNetworkProvider(network: Network, bchjs: BCHJS)
+```
+
+The `FullStackNetworkProvider` uses [FullStack.cash][fullstack]' infrastructure to connect to the BCH network. FullStack.cash' offers dedicated infrastructure and support plans for larger projects. Both `network` and `bchjs` parameters are mandatory, where `bchjs` is an instance of FullStack.cash' [BCHJS][bchjs].
+
+:::caution
+The `FullStackNetworkProvider` does not currently support CashTokens. If you want to use CashTokens, please use the `ElectrumNetworkProvider` instead.
+:::
+
+#### Example
+
+```js
+import BCHJS from '@psf/bch-js';
+import { FullStackNetworkProvider } from 'cashscript';
+
+const restURL = 'https://api.fullstack.cash/v3/';
+const apiToken = 'eyJhbGciO...'; // Your JWT token here.
+const bchjs = new BCHJS({ restURL, apiToken });
+
+const provider = new FullStackNetworkProvider('mainnet', bchjs);
+```
+
+### BitcoinRpcNetworkProvider
+
+```ts
+new BitcoinRpcNetworkProvider(network: Network, url: string, options?: any)
+```
+
+The `BitcoinRpcNetworkProvider` uses a direct connection to a BCH node. Note that a regular node does not have indexing, so any address of interest (e.g. the contract address) need to be registered by the node *before* sending any funds to those addresses. Because of this it is recommended to use a different network provider unless you have a specific reason to use the RPC provider.
+
+:::caution
+The `BitcoinRpcNetworkProvider` does not currently support CashTokens. If you want to use CashTokens, please use the `ElectrumNetworkProvider` instead.
+:::
+
+#### Example
+```js
+import { BitcoinRpcNetworkProvider } from 'cashscript';
+
+const provider = new BitcoinRpcNetworkProvider('mainnet', 'http://localhost:8332');
+```
+
+[fullstack]: https://fullstack.cash/
+[bchjs]: https://bchjs.fullstack.cash/
diff --git a/website/sidebars.js b/website/sidebars.js
index 909f0f22..06449327 100755
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -36,8 +36,16 @@ module.exports = {
       items: [
         'sdk/instantiation',
         'sdk/transaction-builder',
+        {
+          type: 'category',
+          label: 'Network Providers',
+          items: [
+            'sdk/network-provider',
+            'sdk/electrum-network-provider',
+            'sdk/other-network-providers',
+          ],
+        },
         'sdk/signature-templates',
-        'sdk/network-provider',
         'sdk/testing-setup',
         'sdk/examples',
       ],

From f72311d8b7095278bf4a42fd4f286939f528c9dd Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 10 Mar 2025 13:50:32 +0100
Subject: [PATCH 199/267] add to the walletconnect docs

---
 website/docs/guides/walletconnect.md | 120 ++++++++++++++++++++++-----
 1 file changed, 98 insertions(+), 22 deletions(-)

diff --git a/website/docs/guides/walletconnect.md b/website/docs/guides/walletconnect.md
index 51c819f6..49cf3024 100644
--- a/website/docs/guides/walletconnect.md
+++ b/website/docs/guides/walletconnect.md
@@ -2,10 +2,9 @@
 title: WalletConnect
 ---
 
-The BCH WalletConnect specification was created in July of 2023 and has become popular since, being supported in multiple wallets and a wide range of dapps. You can find a full list of Bitcoin Cash dapps supporting WalletConnect on [Tokenaut.cash](https://tokenaut.cash/dapps?filter=walletconnect).
-
-BCH WalletConnect uses the generic 'WalletConnect' transport layer to communicate between the wallet and the dapp. The contents being communicated is what is BCH-specific. The BCH WalletConnect standard was designed with CashScript contract usage in mind.
+The BCH WalletConnect spec lays out a BCH-specific API for how Bitcoin Cash dapps can communicate to BCH Wallets. BCH WalletConnect uses the generic 'WalletConnect' transport layer but the contents being communicated is what's BCH-specific. The standard was designed with CashScript smart contract usage in mind.
 
+The BCH WalletConnect standard is supported in multiple wallets and a wide range of dapps. You can find a full list of Bitcoin Cash dapps supporting WalletConnect on [Tokenaut.cash](https://tokenaut.cash/dapps?filter=walletconnect).
 
 :::tip
 The specification is called ['wc2-bch-bcr'](https://github.com/mainnet-pat/wc2-bch-bcr) and has extra discussion and info on the [BCH research forum](https://bitcoincashresearch.org/t/wallet-connect-v2-support-for-bitcoincash/).
@@ -28,62 +27,139 @@ signTransaction: (
 ) => Promise<{ signedTransaction: string, signedTransactionHash: string } | undefined>;
 ```
 
-Important to note is how the wallet knows which inputs to sign:
+You can see that the CashScript `ContractInfo` needs to be provided as part of the `sourceOutputs`. Important to note from the spec is how the wallet knows which inputs to sign:
 
 >To signal that the wallet needs to sign an input, the app sets the corresponding input's `unlockingBytecode` to empty Uint8Array.
 
-## signTransaction Example
+Also important for smart contract usage is how the wallet adds the public-key or a signature to contract inputs:
+
+> We signal the use of pubkeys by using a 33-byte long zero-filled arrays and schnorr (the currently supported type) signatures by using a 65-byte long zero-filled arrays. Wallet detects these patterns and replaces them accordingly.
+
+## Create wcTransactionObj
+
+To use the BCH WalletConnect `signTransaction` API, we need to pass an `options` object which we'll call `wcTransactionObj`.
+
+Below we'll give 2 example, the first example using spending a user-input and in the second example spending from a user-contract with the `userPubKey` and the `userSig`
 
-### Create wcTransactionObj
+### Spending a user-input
 
-Example code from the 'Cash-Ninjas' minting dapp repository, [link to source code](https://github.com/cashninjas/ninjas.cash/blob/main/js/mint.js).
+Below is example code from the `CreateContract` code of the 'Hodl Vault' dapp repository, [link to source code](https://github.com/mr-zwets/bch-hodl-dapp/blob/main/src/views/CreateContract.vue#L14).
 
-```javascript
+```ts
 import { Contract } from "cashscript";
 import { hexToBin, decodeTransaction } from "@bitauth/libauth";
 
-async function transactionWalletConnect(){
+async function proposeWcTransaction(){
+  // create a placeholderUnlocker for the empty signature
+  const placeholderUnlocker: Unlocker = {
+    generateLockingBytecode: () => convertPkhToLockingBytecode(userPkh),
+    generateUnlockingBytecode: () => Uint8Array.from(Array(0))
+  }
+
   // use the CashScript SDK to build a transaction
-  const rawTransactionHex = await transaction.build();
-  const decodedTransaction = decodeTransaction(hexToBin(rawTransactionHex));
+  const transactionBuilder = new TransactionBuilder({provider: store.provider})
+  transactionBuilder.addInputs(userInputUtxos, placeholderUnlocker)
+  transactionBuilder.addOpReturnOutput(opreturnData)
+  transactionBuilder.addOutput(contractOutput)
+  if(changeAmount > 550n) transactionBuilder.addOutput(changeOutput)
+
+  const unsignedRawTransactionHex = await transactionBuilder.build();
+
+  const decodedTransaction = decodeTransaction(hexToBin(unsignedRawTransactionHex));
+  if(typeof decodedTransaction == "string") throw new Error("!decodedTransaction")
 
-  // set input unlockingBytecode to empty Uint8Array for wallet signing
-  decodedTransaction.inputs[1].unlockingBytecode = Uint8Array.from([]);
+  // construct SourceOutputs from transaction input, see source code
+  const sourceOutputs = generateSourceOutputs(transactionBuilder.inputs)
 
-  // construct list SourceOutputs, see source code
-  const listSourceOutputs = constructSourceOutputs(decodedTransaction, utxoInfo, contract)
+  // we don't need to add the contractInfo to the wcSourceOutputs here  
+  const wcSourceOutputs = sourceOutputs.map((sourceOutput, index) => {
+    return { ...sourceOutput, ...decodedTransaction.inputs[index] }
+  })
 
   // wcTransactionObj to pass to signTransaction endpoint
   const wcTransactionObj = {
     transaction: decodedTransaction,
     sourceOutputs: listSourceOutputs,
     broadcast: true,
-    userPrompt: "Mint Cash-Ninja NFT"
+    userPrompt: "Create HODL Contract"
   };
 
   // pass wcTransactionObj to WalletConnect client
-  const signResult = await signTransaction(wcTransactionObj);
+  const signResult = await signWcTransaction(wcTransactionObj);
 
   // Handle signResult success / failure
 }
 ```
 
-### signTransaction Client interaction
+### Spending from a user-contract
+
+Below is example code from the `unlockHodlVault` code of the 'Hodl Vault' dapp repository, [link to source code](https://github.com/mr-zwets/bch-hodl-dapp/blob/main/src/views/UserContracts.vue#L66).
+
+```ts
+import { Contract } from "cashscript";
+import { hexToBin, decodeTransaction } from "@bitauth/libauth";
+
+async function unlockHodlVault(){
+  // create a placeholdes for the unlocking arguments
+  const placeholderSig = Uint8Array.from(Array(65))
+  const placeholderPubKey = Uint8Array.from(Array(33));
+
+  const transactionBuilder = new TransactionBuilder({provider: store.provider})
+
+  transactionBuilder.setLocktime(store.currentBlockHeight)
+  transactionBuilder.addInputs(contractUtxos, hodlContract.unlock.spend(placeholderPubKey, placeholderSig))
+  transactionBuilder.addOutput(reclaimOutput)
+
+  const unsignedRawTransactionHex = transactionBuilder.build();
+
+  const decodedTransaction = decodeTransaction(hexToBin(unsignedRawTransactionHex));
+  if(typeof decodedTransaction == "string") throw new Error("!decodedTransaction")
 
-Below is an implementation of `signTransaction` used earlier, this is where the communication with the client for 'signTransaction' takes place. See the source code for `signClient`, `connectedChain` and `session` details.
+  const sourceOutputs = generateSourceOutputs(transactionBuilder.inputs)
 
-```javascript
+  // Add the contractInfo to the wcSourceOutputs
+  const wcSourceOutputs: wcSourceOutputs = sourceOutputs.map((sourceOutput, index) => {
+    const contractInfoWc = createWcContractObj(hodlContract, index)
+    return { ...sourceOutput, ...contractInfoWc, ...decodedTransaction.inputs[index] }
+  })
+
+  const wcTransactionObj = {
+    transaction: decodedTransaction,
+    sourceOutputs: wcSourceOutputs,
+    broadcast: true,
+    userPrompt: "Reclaim HODL Value",
+  };
+
+  // pass wcTransactionObj to WalletConnect client
+  const signResult = await signWcTransaction(wcTransactionObj);
+
+  // Handle signResult success / failure
+}
+```
+
+## signTransaction Wallet interaction
+
+To communicate the `wcTransactionObj` with the user's Wallet we use the `@walletconnect/sign-client` library to request the connected user's wallet to sign the transaction.
+
+See the source code for how to initialize the `signClient` and for details about the `connectedChain` and `session`.
+
+```ts
 import SignClient from '@walletconnect/sign-client';
 import { stringify } from "@bitauth/libauth";
 
-async function signTransaction(options){
+interface signedTxObject {
+  signedTransaction: string;
+  signedTransactionHash: string;
+}
+
+async function signWcTransaction(wcTransactionObj): signedTxObject | undefined {
   try {
     const result = await signClient.request({
       chainId: connectedChain,
       topic: session.topic,
       request: {
         method: "bch_signTransaction",
-        params: JSON.parse(stringify(options)),
+        params: JSON.parse(stringify(wcTransactionObj)),
       },
     });
     return result;

From dcb054ef440137fe2801337d18f043982f1a5fdd Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 11 Mar 2025 08:44:52 +0100
Subject: [PATCH 200/267] add note for variables in tuple indexes

---
 website/docs/language/types.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index 23edc552..cbbdc46c 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -141,6 +141,10 @@ string question = "What is Bitcoin Cash?";
 string answer = question.split(15)[0].split(8)[1]; // Answer is "Cash"
 ```
 
+:::note
+It is not supported to use a variable for the tupleIndex. Instead you can assign both sides of the tuple as shown below and use either element conditional on the value of the variable. 
+:::
+
 It is also possible to assign both sides of the tuple at once with a destructuring syntax:
 
 ```solidity

From 107c6955c2e2d2940649b470e16e2f40c36f826d Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 14 Mar 2025 11:33:38 +0100
Subject: [PATCH 201/267] add link to walletconnect guide

---
 website/docs/guides/walletconnect.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website/docs/guides/walletconnect.md b/website/docs/guides/walletconnect.md
index 49cf3024..c4c6d207 100644
--- a/website/docs/guides/walletconnect.md
+++ b/website/docs/guides/walletconnect.md
@@ -141,7 +141,7 @@ async function unlockHodlVault(){
 
 To communicate the `wcTransactionObj` with the user's Wallet we use the `@walletconnect/sign-client` library to request the connected user's wallet to sign the transaction.
 
-See the source code for how to initialize the `signClient` and for details about the `connectedChain` and `session`.
+See [the source code](https://github.com/mr-zwets/bch-hodl-dapp/blob/main/src/store/store.ts#L60) for how to initialize the `signClient` and for details about the `connectedChain` and `session`.
 
 ```ts
 import SignClient from '@walletconnect/sign-client';

From 8eba21c396d2a8a3fb8a8e4dc94f167738cc7bb0 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Mon, 17 Mar 2025 14:52:41 +0100
Subject: [PATCH 202/267] update examples

---
 examples/announcement.cash          |  2 +-
 examples/announcement.ts            | 38 ++++++++++++-----
 examples/hodl_vault.cash            |  2 +-
 examples/hodl_vault.ts              | 38 ++++++++++++++---
 examples/mecenas.cash               |  2 +-
 examples/mecenas.ts                 | 37 +++++++++++++----
 examples/mecenas_locktime.cash      |  2 +-
 examples/p2pkh.cash                 |  2 +-
 examples/p2pkh.js                   | 51 ++++++++++++++---------
 examples/p2pkh.ts                   | 49 ++++++++++++++--------
 examples/transfer_with_timeout.cash |  2 +-
 examples/transfer_with_timeout.ts   | 63 ++++++++++++++++++++++++-----
 website/docs/guides/debugging.md    |  2 +-
 13 files changed, 214 insertions(+), 76 deletions(-)

diff --git a/examples/announcement.cash b/examples/announcement.cash
index 6f06492b..a678e80a 100644
--- a/examples/announcement.cash
+++ b/examples/announcement.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 /* This is a contract showcasing covenants outside of regular transactional use.
  * It enforces the contract to make an "announcement" on Memo.cash, and send the
diff --git a/examples/announcement.ts b/examples/announcement.ts
index dac7fa1c..a7710c03 100644
--- a/examples/announcement.ts
+++ b/examples/announcement.ts
@@ -1,4 +1,4 @@
-import { Contract, ElectrumNetworkProvider } from 'cashscript';
+import { Contract, ElectrumNetworkProvider, Output, TransactionBuilder } from 'cashscript';
 import { compileFile } from 'cashc';
 import { stringify } from '@bitauth/libauth';
 import { URL } from 'url';
@@ -16,20 +16,36 @@ const contract = new Contract(artifact, [], { provider, addressType });
 
 // Get contract balance & output address + balance
 console.log('contract address:', contract.address);
+const contractUtxos = await contract.getUtxos();
+console.log('contract utxos:', contractUtxos);
 console.log('contract balance:', await contract.getBalance());
 console.log('contract opcount:', contract.opcount);
 console.log('contract bytesize:', contract.bytesize);
 
-// Send the announcement. Trying to send any other announcement will fail because
-// the contract's covenant logic. Uses a hardcoded fee and minChange so that
-// change is only sent back to the contract if there's enough leftover
-// for another announcement.
+// Select a contract UTXO to spend from
+const contractInputUtxo = contractUtxos.find(utxo => utxo.satoshis > 10_000n);
+if (!contractInputUtxo) throw new Error('No contract UTXO with enough satoshis found');
+const inputAmount = contractInputUtxo.satoshis;
+
+// Announcement string
 const str = 'A contract may not injure a human being or, through inaction, allow a human being to come to harm.';
-const tx = await contract.functions
-  .announce()
-  .withOpReturn(['0x6d02', str])
-  .withHardcodedFee(1000n)
-  .withMinChange(1000n)
-  .send();
+
+// Construct a changeOutput so the leftover BCH can be send back for another announcement
+const minerFee = 1000n;
+const changeAmount = inputAmount - minerFee;
+const contractChangeOutput: Output = {
+  amount: changeAmount,
+  to: contract.address,
+};
+
+// Send the announcement. Trying to send any other announcement or other change output
+// will fail because of the contract's covenant logic
+const transactionBuilder = new TransactionBuilder({ provider });
+
+transactionBuilder.addInput(contractInputUtxo, contract.unlock.announce());
+transactionBuilder.addOpReturnOutput(['0x6d02', str]);
+if (changeAmount > 1000n) transactionBuilder.addOutput(contractChangeOutput);
+
+const tx = await transactionBuilder.send();
 
 console.log('transaction details:', stringify(tx));
diff --git a/examples/hodl_vault.cash b/examples/hodl_vault.cash
index 3e92be36..1af8c96b 100644
--- a/examples/hodl_vault.cash
+++ b/examples/hodl_vault.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 // This contract forces HODLing until a certain price target has been reached
 // A minimum block is provided to ensure that oracle price entries from before this block are disregarded
diff --git a/examples/hodl_vault.ts b/examples/hodl_vault.ts
index ff29721c..a151451d 100644
--- a/examples/hodl_vault.ts
+++ b/examples/hodl_vault.ts
@@ -1,5 +1,5 @@
 import { stringify } from '@bitauth/libauth';
-import { Contract, SignatureTemplate, ElectrumNetworkProvider } from 'cashscript';
+import { Contract, SignatureTemplate, ElectrumNetworkProvider, TransactionBuilder, Output } from 'cashscript';
 import { compileFile } from 'cashc';
 import { URL } from 'url';
 
@@ -24,16 +24,44 @@ const contract = new Contract(artifact, parameters, { provider });
 
 // Get contract balance & output address + balance
 console.log('contract address:', contract.address);
+const contractUtxos = await contract.getUtxos();
+console.log('contract utxos:', contractUtxos);
 console.log('contract balance:', await contract.getBalance());
 
+const currentBlockHeight = await provider.getBlockHeight();
+console.log('current block height:', currentBlockHeight);
+
+// Select a contract UTXO to spend from
+const contractInputUtxo = contractUtxos.find(utxo => utxo.satoshis > 10_000n);
+if (!contractInputUtxo) throw new Error('No contract UTXO with enough satoshis found');
+const inputAmount = contractInputUtxo.satoshis;
+
 // Produce new oracle message and signature
 const oracleMessage = oracle.createMessage(100000n, 30000n);
 const oracleSignature = oracle.signMessage(oracleMessage);
 
+// construct an output
+const outputAmount = 1000n;
+const output: Output = { amount: outputAmount, to: contract.address };
+
+// Construct a changeOutput
+const minerFee = 1000n;
+const changeAmount = inputAmount - outputAmount - minerFee;
+const changeOutput: Output = {
+  amount: changeAmount,
+  to: contract.address,
+};
+
+const aliceTemplate = new SignatureTemplate(alicePriv);
+
 // Spend from the vault
-const tx = await contract.functions
-  .spend(new SignatureTemplate(alicePriv), oracleSignature, oracleMessage)
-  .to(contract.address, 1000n)
-  .send();
+const transactionBuilder = new TransactionBuilder({ provider });
+
+transactionBuilder.setLocktime(currentBlockHeight);
+transactionBuilder.addInput(contractInputUtxo, contract.unlock.spend(aliceTemplate, oracleSignature, oracleMessage));
+transactionBuilder.addOutput(output);
+if (changeAmount > 1000n) transactionBuilder.addOutput(changeOutput);
+
+const tx = await transactionBuilder.send();
 
 console.log(stringify(tx));
diff --git a/examples/mecenas.cash b/examples/mecenas.cash
index 5ac228cc..341a523d 100644
--- a/examples/mecenas.cash
+++ b/examples/mecenas.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 /* This is an unofficial CashScript port of Licho's Mecenas contract. It is
  * not compatible with Licho's EC plugin, but rather meant as a demonstration
diff --git a/examples/mecenas.ts b/examples/mecenas.ts
index 650a754e..cf28c126 100644
--- a/examples/mecenas.ts
+++ b/examples/mecenas.ts
@@ -1,5 +1,5 @@
 import { stringify } from '@bitauth/libauth';
-import { Contract, ElectrumNetworkProvider } from 'cashscript';
+import { Contract, ElectrumNetworkProvider, Output, TransactionBuilder } from 'cashscript';
 import { compileFile } from 'cashc';
 import { URL } from 'url';
 
@@ -15,21 +15,44 @@ const provider = new ElectrumNetworkProvider('chipnet');
 // Instantiate a new contract using the compiled artifact and network provider
 // AND providing the constructor parameters:
 // (recipient: alicePkh, funder: bobPkh, pledge: 10000)
-const contract = new Contract(artifact, [alicePkh, bobPkh, 10000n], { provider });
+const pledgeAmount = 10_000n;
+const contract = new Contract(artifact, [alicePkh, bobPkh, pledgeAmount], { provider });
 
 // Get contract balance & output address + balance
 console.log('contract address:', contract.address);
+const contractUtxos = await contract.getUtxos();
+console.log('contract utxos:', contractUtxos);
 console.log('contract balance:', await contract.getBalance());
 console.log('contract opcount:', contract.opcount);
 console.log('contract bytesize:', contract.bytesize);
 
+// Select a contract UTXO to spend from
+const contractInputUtxo = contractUtxos.find(utxo => utxo.satoshis > 10_000n);
+if (!contractInputUtxo) throw new Error('No contract UTXO with enough satoshis found');
+const inputAmount = contractInputUtxo.satoshis;
+
+const receiverOutput: Output = {
+  amount: 10_000n,
+  to: aliceAddress,
+};
+
+// Construct the changeOutput
+const minerFee = 1000n;
+const changeAmount = inputAmount - pledgeAmount - minerFee;
+const contractChangeOutput: Output = {
+  amount: changeAmount,
+  to: contract.address,
+};
+
 // Call the transfer function with any signature
 // Will send one pledge amount to alice, and send change back to the contract
 // Manually set fee to 1000 because this is hardcoded in the contract
-const tx = await contract.functions
-  .receive()
-  .to(aliceAddress, 10000n)
-  .withHardcodedFee(1000n)
-  .send();
+const transactionBuilder = new TransactionBuilder({ provider });
+
+transactionBuilder.addInput(contractInputUtxo, contract.unlock.receive());
+transactionBuilder.addOutput(receiverOutput);
+if (changeAmount > pledgeAmount + minerFee) transactionBuilder.addOutput(contractChangeOutput);
+
+const tx = await transactionBuilder.send();
 
 console.log('transaction details:', stringify(tx));
diff --git a/examples/mecenas_locktime.cash b/examples/mecenas_locktime.cash
index 8ea17dc4..cb0e56ff 100644
--- a/examples/mecenas_locktime.cash
+++ b/examples/mecenas_locktime.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 // This is an experimental contract for a more "streaming" Mecenas experience
 // Completely untested, just a concept
diff --git a/examples/p2pkh.cash b/examples/p2pkh.cash
index 974ca04a..6cc64059 100644
--- a/examples/p2pkh.cash
+++ b/examples/p2pkh.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract P2PKH(bytes20 pkh) {
     // Require pk to match stored pkh and signature to match
diff --git a/examples/p2pkh.js b/examples/p2pkh.js
index 7fe516e2..b10dc6f8 100644
--- a/examples/p2pkh.js
+++ b/examples/p2pkh.js
@@ -1,10 +1,10 @@
 import { URL } from 'url';
 import { compileFile } from 'cashc';
-import { ElectrumNetworkProvider, Contract, SignatureTemplate } from 'cashscript';
+import { ElectrumNetworkProvider, Contract, SignatureTemplate, TransactionBuilder } from 'cashscript';
 import { stringify } from '@bitauth/libauth';
 
-// Import Alice's keys from common-js.js
-import { alicePkh, alicePriv, alicePub } from './common-js.js';
+// Import Alice's keys from common.ts
+import { alicePkh, alicePriv, aliceAddress, alicePub } from './common.js';
 
 // Compile the P2PKH contract to an artifact object
 const artifact = compileFile(new URL('p2pkh.cash', import.meta.url));
@@ -18,23 +18,38 @@ const contract = new Contract(artifact, [alicePkh], { provider });
 
 // Get contract balance & output address + balance
 console.log('contract address:', contract.address);
+const contractUtxos = await contract.getUtxos();
+console.log('contract utxos:', contractUtxos);
 console.log('contract balance:', await contract.getBalance());
 
-// Call the spend function with alice's signature + pk
-// And use it to send 0. 000 100 00 BCH back to the contract's address
-const tx = await contract.functions
-  .spend(alicePub, new SignatureTemplate(alicePriv))
-  .to(contract.address, 10000n)
-  .send();
+// Select a contract UTXO to spend from
+const contractInputUtxo = contractUtxos.find(utxo => utxo.satoshis > 12_000n);
+if (!contractInputUtxo) throw new Error('No contract UTXO with enough satoshis found');
+const inputAmount = contractInputUtxo.satoshis;
 
-console.log('transaction details:', stringify(tx));
+// construct an output
+const outputAmount = 10_000n;
+const output = { amount: outputAmount, to: aliceAddress };
 
-// Call the spend function with alice's signature + pk
-// And use it to send two outputs of 0. 000 150 00 BCH back to the contract's address
-const tx2 = await contract.functions
-  .spend(alicePub, new SignatureTemplate(alicePriv))
-  .to(contract.address, 15000n)
-  .to(contract.address, 15000n)
-  .send();
+// Construct a changeOutput
+const minerFee = 1000n;
+const changeAmount = inputAmount - outputAmount - minerFee;
+const changeOutput = {
+  amount: changeAmount,
+  to: contract.address,
+};
 
-console.log('transaction details:', stringify(tx2));
+const aliceTemplate = new SignatureTemplate(alicePriv);
+
+// Call the spend() function with alice's signature + pk
+// And use it to send 0. 000 100 00 BCH to aliceAddress and the remainder
+// back to the contract's address
+const transactionBuilder = new TransactionBuilder({ provider });
+
+transactionBuilder.addInput(contractInputUtxo, contract.unlock.spend(alicePub, aliceTemplate));
+transactionBuilder.addOutput(output);
+if (changeAmount > 1000n) transactionBuilder.addOutput(changeOutput);
+
+const tx = await transactionBuilder.send();
+
+console.log('transaction details:', stringify(tx));
\ No newline at end of file
diff --git a/examples/p2pkh.ts b/examples/p2pkh.ts
index 54e10a3d..867cb694 100644
--- a/examples/p2pkh.ts
+++ b/examples/p2pkh.ts
@@ -1,10 +1,10 @@
 import { stringify } from '@bitauth/libauth';
 import { compileFile } from 'cashc';
-import { ElectrumNetworkProvider, SignatureTemplate, Contract } from 'cashscript';
+import { ElectrumNetworkProvider, SignatureTemplate, Contract, TransactionBuilder, Output } from 'cashscript';
 import { URL } from 'url';
 
 // Import Alice's keys from common.ts
-import { alicePkh, alicePriv, alicePub } from './common.js';
+import { alicePkh, alicePriv, aliceAddress, alicePub } from './common.js';
 
 // Compile the P2PKH contract to an artifact object
 const artifact = compileFile(new URL('p2pkh.cash', import.meta.url));
@@ -18,23 +18,38 @@ const contract = new Contract(artifact, [alicePkh], { provider });
 
 // Get contract balance & output address + balance
 console.log('contract address:', contract.address);
+const contractUtxos = await contract.getUtxos();
+console.log('contract utxos:', contractUtxos);
 console.log('contract balance:', await contract.getBalance());
 
-// Call the spend() function with alice's signature + pk
-// And use it to send 0. 000 100 00 BCH back to the contract's address
-const tx = await contract.functions
-  .spend(alicePub, new SignatureTemplate(alicePriv))
-  .to(contract.address, 10000n)
-  .send();
+// Select a contract UTXO to spend from
+const contractInputUtxo = contractUtxos.find(utxo => utxo.satoshis > 12_000n);
+if (!contractInputUtxo) throw new Error('No contract UTXO with enough satoshis found');
+const inputAmount = contractInputUtxo.satoshis;
 
-console.log('transaction details:', stringify(tx));
+// construct an output
+const outputAmount = 10_000n;
+const output: Output = { amount: outputAmount, to: aliceAddress };
+
+// Construct a changeOutput
+const minerFee = 1000n;
+const changeAmount = inputAmount - outputAmount - minerFee;
+const changeOutput: Output = {
+  amount: changeAmount,
+  to: contract.address,
+};
+
+const aliceTemplate = new SignatureTemplate(alicePriv);
 
 // Call the spend() function with alice's signature + pk
-// And use it to send two outputs of 0. 000 150 00 BCH back to the contract's address
-const tx2 = await contract.functions
-  .spend(alicePub, new SignatureTemplate(alicePriv))
-  .to(contract.address, 15000n)
-  .to(contract.address, 15000n)
-  .send();
-
-console.log('transaction details:', stringify(tx2));
+// And use it to send 0. 000 100 00 BCH to aliceAddress and the remainder
+// back to the contract's address
+const transactionBuilder = new TransactionBuilder({ provider });
+
+transactionBuilder.addInput(contractInputUtxo, contract.unlock.spend(alicePub, aliceTemplate));
+transactionBuilder.addOutput(output);
+if (changeAmount > 1000n) transactionBuilder.addOutput(changeOutput);
+
+const tx = await transactionBuilder.send();
+
+console.log('transaction details:', stringify(tx));
diff --git a/examples/transfer_with_timeout.cash b/examples/transfer_with_timeout.cash
index 9d4aaa1a..f49b0e9d 100644
--- a/examples/transfer_with_timeout.cash
+++ b/examples/transfer_with_timeout.cash
@@ -1,4 +1,4 @@
-pragma cashscript ^0.10.0;
+pragma cashscript ^0.11.0;
 
 contract TransferWithTimeout(
     pubkey sender,
diff --git a/examples/transfer_with_timeout.ts b/examples/transfer_with_timeout.ts
index 0ccd4855..caf22ae3 100644
--- a/examples/transfer_with_timeout.ts
+++ b/examples/transfer_with_timeout.ts
@@ -1,6 +1,6 @@
 import { stringify } from '@bitauth/libauth';
 import { compileFile } from 'cashc';
-import { Contract, ElectrumNetworkProvider, SignatureTemplate } from 'cashscript';
+import { Contract, ElectrumNetworkProvider, Output, SignatureTemplate, TransactionBuilder } from 'cashscript';
 import { URL } from 'url';
 
 // Import Bob and Alice's keys from common.ts
@@ -24,22 +24,63 @@ const contract = new Contract(artifact, [alicePub, bobPub, 100000n], { provider
 
 // Get contract balance & output address + balance
 console.log('contract address:', contract.address);
+const contractUtxos = await contract.getUtxos();
+console.log('contract utxos:', contractUtxos);
 console.log('contract balance:', await contract.getBalance());
 
-// Call the transfer function with bob's signature
+// Select a contract UTXO to spend from
+const contractInputUtxo = contractUtxos.find(utxo => utxo.satoshis > 5_000n);
+if (!contractInputUtxo) throw new Error('No contract UTXO with enough satoshis found');
+const inputAmount = contractInputUtxo.satoshis;
+
+// construct an output
+const outputAmount = 1000n;
+const output: Output = { amount: outputAmount, to: contract.address };
+
+// Construct a changeOutput
+const minerFee = 1000n;
+const changeAmount = inputAmount - outputAmount - minerFee;
+const changeOutput: Output = {
+  amount: changeAmount,
+  to: contract.address,
+};
+
+// Call the contract's transfer unlock-function with bob's signature
 // Allows bob to claim the money that alice sent him
-const transferTx = await contract.functions
-  .transfer(new SignatureTemplate(bobPriv))
-  .to(contract.address, 10000n)
-  .send();
+const transactionBuilder = new TransactionBuilder({ provider });
+
+transactionBuilder.addInput(contractInputUtxo, contract.unlock.transfer(new SignatureTemplate(bobPriv)));
+transactionBuilder.addOutput(output);
+if (changeAmount > 1000n) transactionBuilder.addOutput(changeOutput);
+
+const transferTx = await transactionBuilder.send();
 
 console.log('transfer transaction details:', stringify(transferTx));
 
-// Call the timeout function with alice's signature
+// Select a 2nd contract UTXO to spend from
+const updatecContractUtxos = await contract.getUtxos();
+const contractInputUtxo2 = updatecContractUtxos.find(utxo => utxo.satoshis > 5_000n);
+if (!contractInputUtxo2) throw new Error('No contract UTXO with enough satoshis found');
+const inputAmount2 = contractInputUtxo2.satoshis;
+
+const changeAmount2 = inputAmount2 - outputAmount - minerFee;
+const changeOutput2: Output = {
+  amount: changeAmount2,
+  to: contract.address,
+};
+
+const currentBlockHeight = await provider.getBlockHeight();
+console.log('current block height:', currentBlockHeight);
+
+// Call the contract's timeout unlock-function with alice's signature
 // Allows alice to reclaim the money she sent as the timeout is in the past
-const timeoutTx = await contract.functions
-  .timeout(new SignatureTemplate(alicePriv))
-  .to(contract.address, 10000n)
-  .send();
+const transactionBuilder2 = new TransactionBuilder({ provider });
+
+transactionBuilder2.setLocktime(currentBlockHeight);
+transactionBuilder2.addInput(contractInputUtxo2, contract.unlock.timeout(new SignatureTemplate(alicePriv)));
+transactionBuilder2.addOutput(output);
+if (changeAmount2 > 1000n) transactionBuilder2.addOutput(changeOutput2);
+
+const timeoutTx = await transactionBuilder2.send();
 
 console.log('timeout transaction details:', stringify(timeoutTx));
diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 1146d325..8ad63f24 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -65,7 +65,7 @@ The Bitauth IDE will show you the two-way mapping between the CashScript contrac
 <sender> // pubkey = <0x0262f5c18adf3d9800c18b5e63fa6505ec8eb1d49c65855d62aea698425a39966e>
 
 // bytecode
-                                                /* pragma cashscript >= 0.10.0;                                                  */
+                                                /* pragma cashscript >= 0.11.0;                                                  */
                                                 /*                                                                              */
                                                 /* contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) { */
                                                 /*     // Require recipient's signature to match                                */

From 99ff71eff64f110c3727a12002fe543996aef6e1 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 18 Mar 2025 08:15:54 +0100
Subject: [PATCH 203/267] add unlockers test cases to contract-types.test

---
 .../test/types/Contract.types.test.ts         | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/packages/cashscript/test/types/Contract.types.test.ts b/packages/cashscript/test/types/Contract.types.test.ts
index 9c944b23..e7eb0824 100644
--- a/packages/cashscript/test/types/Contract.types.test.ts
+++ b/packages/cashscript/test/types/Contract.types.test.ts
@@ -64,6 +64,49 @@ interface ManualArtifactType extends Artifact {
     new Contract<ManualArtifactType>(p2pkhArtifactJsonNotConst as any, [alicePkh, 1000n]);
   }
 
+  // describe('Contract unlockers')
+  {
+    const contract = new Contract(p2pkhArtifact, [alicePkh]);
+
+    // it('should not give type errors when using correct function inputs')
+    contract.unlock.spend(alicePub, new SignatureTemplate(alicePriv));
+
+    // it('should give type errors when calling a function that does not exist')
+    // @ts-expect-error
+    contract.unlock.notAFunction();
+
+    // it('should give type errors when using incorrect function input types')
+    // @ts-expect-error
+    contract.unlock.spend(1000n, true);
+
+    // it('should give type errors when using incorrect function input length')
+    // @ts-expect-error
+    contract.unlock.spend(alicePub, new SignatureTemplate(alicePriv), 100n);
+    // @ts-expect-error
+    contract.unlock.spend(alicePub);
+
+    // it('should not perform type checking when cast to any')
+    const contractAsAny = new Contract(p2pkhArtifact as any, [alicePkh, 1000n]);
+    contractAsAny.unlock.notAFunction();
+    contractAsAny.unlock.spend();
+    contractAsAny.unlock.spend(1000n, true);
+
+    // it('should not perform type checking when cannot infer type')
+    // Note: would be very nice if it *could* infer the type from static json
+    const contractFromUnknown = new Contract(p2pkhArtifactJsonNotConst, [alicePkh, 1000n]);
+    contractFromUnknown.unlock.notAFunction();
+    contractFromUnknown.unlock.spend();
+    contractFromUnknown.unlock.spend(1000n, true);
+
+    // it('should give type errors when calling methods that do not exist on the returned object')
+    // @ts-expect-error
+    contract.unlock.spend().notAFunction();
+    // @ts-expect-error
+    contractAsAny.unlock.spend().notAFunction();
+    // @ts-expect-error
+    contractFromUnknown.unlock.spend().notAFunction();
+  }
+
   // describe('Contract functions')
   {
     const contract = new Contract(p2pkhArtifact, [alicePkh]);
@@ -167,6 +210,23 @@ interface ManualArtifactType extends Artifact {
     new Contract(announcementArtifact, 'hello');
   }
 
+  // describe('Contract unlockers')
+  {
+    // it('should not give type errors when using correct function inputs')
+    const contract = new Contract(announcementArtifact, []);
+
+    // it('should not give type errors when using correct function inputs')
+    contract.unlock.announce();
+
+    // it('should give type errors when calling a function that does not exist')
+    // @ts-expect-error
+    contract.unlock.notAFunction();
+
+    // it('should give type errors when using incorrect function input length')
+    // @ts-expect-error
+    contract.unlock.announce('hello world');
+  }
+
   // describe('Contract functions')
   {
     // it('should not give type errors when using correct function inputs')
@@ -213,6 +273,31 @@ interface ManualArtifactType extends Artifact {
     new Contract(transferWithTimeoutArtifact, [alicePub, bobPub, 100_000n]);
   }
 
+  // describe('Contract unlockers')
+  {
+    const contract = new Contract(transferWithTimeoutArtifact, [alicePub, bobPub, 100_000n]);
+
+    // it('should not give type errors when using correct function inputs')
+    contract.unlock.transfer(new SignatureTemplate(alicePriv));
+    contract.unlock.timeout(new SignatureTemplate(alicePriv));
+
+    // it('should give type errors when calling a function that does not exist')
+    // @ts-expect-error
+    contract.unlock.notAFunction();
+
+    // it('should give type errors when using incorrect function input types')
+    // @ts-expect-error
+    contract.unlock.transfer(1000n);
+    // @ts-expect-error
+    contract.unlock.timeout(true);
+
+    // it('should give type errors when using incorrect function input length')
+    // @ts-expect-error
+    contract.unlock.transfer(new SignatureTemplate(alicePub), 100n);
+    // @ts-expect-error
+    contract.unlock.timeout();
+  }
+
   // describe('Contract functions')
   {
     const contract = new Contract(transferWithTimeoutArtifact, [alicePub, bobPub, 100_000n]);

From ffa40081c14bee1f823d28d67ba823b51d917bd1 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 19 Mar 2025 15:59:57 +0100
Subject: [PATCH 204/267] commit failing test case

---
 .../test/multi-contract-debugging.test.ts     | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 packages/cashscript/test/multi-contract-debugging.test.ts

diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
new file mode 100644
index 00000000..8862fbf6
--- /dev/null
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -0,0 +1,52 @@
+import {
+  Contract,
+  MockNetworkProvider,
+  randomUtxo,
+  SignatureTemplate,
+  TransactionBuilder,
+} from './../src/index.js';
+import {
+  bobAddress,
+  bobPkh,
+  bobPriv,
+  bobPub,
+} from './fixture/vars.js';
+import p2pkhArtifact from './fixture/p2pkh.artifact.js';
+import bigintArtifact from './fixture/bigint.artifact.js';
+import '../src/test/JestExtensions.js';
+
+const bobSignatureTemplate = new SignatureTemplate(bobPriv);
+
+const provider = new MockNetworkProvider();
+
+describe('Multi-Contract-Debugging tests', () => {
+  describe('require statements', () => {
+    it('it should only fail with correct error message when a final verify fails', async () => {
+      const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
+      const bigintContract = new Contract(bigintArtifact, [], { provider });
+      
+      const MAX_INT64 = BigInt('9223372036854775807');
+
+      (provider as any).addUtxo?.(p2pkhContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bigintContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bobAddress, randomUtxo());
+
+      const to = p2pkhContract.address;
+      const amount = 10000n;
+      const p2pkhContractUtxos = await p2pkhContract.getUtxos();
+      const bigIntContractUtxos = await bigintContract.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(p2pkhContractUtxos[0], p2pkhContract.unlock.spend(bobPub, bobSignatureTemplate))
+        .addInput(bigIntContractUtxos[0], bigintContract.unlock.proofOfBigInt(MAX_INT64 + 1n, -1n))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount });
+
+      console.warn(transaction.bitauthUri());
+      
+      await expect(transaction).toFailRequire();
+    });
+  });
+});

From b7a030c837c94d816cbbfd9e52bfe1eb7b8e4b70 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 25 Mar 2025 11:59:47 +0100
Subject: [PATCH 205/267] Fix name collision bugs

- Append an input index to all scripts / entities
- Create new entities and unlock scripts per input
- Revert back to 1 scenario per unlock script (/ input)
- Remove P2PKH script merge (not sure why that was there)
- Some name changes
- Update 2 fixtures
---
 .../src/advanced/LibauthTemplate.ts           |  75 ++-
 .../multi-contract-fixtures.ts                | 618 +++++++++++++++---
 2 files changed, 576 insertions(+), 117 deletions(-)

diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index 604d7940..385ade3c 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -51,20 +51,20 @@ import { TransactionBuilder } from '../TransactionBuilder.js';
  *
  */
 export const generateTemplateEntitiesP2PKH = (
-  index: number,
+  inputIndex: number,
 ): WalletTemplate['entities'] => {
-  const lockScriptName = `p2pkh_placeholder_lock_${index}`;
-  const unlockScriptName = `p2pkh_placeholder_unlock_${index}`;
+  const lockScriptName = `p2pkh_placeholder_lock_${inputIndex}`;
+  const unlockScriptName = `p2pkh_placeholder_unlock_${inputIndex}`;
 
   return {
-    [`signer_${index}`]: {
+    [`signer_${inputIndex}`]: {
       scripts: [lockScriptName, unlockScriptName],
-      description: `placeholder_key_${index}`,
-      name: `Signer ${index}`,
+      description: `placeholder_key_${inputIndex}`,
+      name: `P2PKH Signer (input #${inputIndex})`,
       variables: {
-        [`placeholder_key_${index}`]: {
+        [`placeholder_key_${inputIndex}`]: {
           description: '',
-          name: `Placeholder Key ${index}`,
+          name: `P2PKH Placeholder Key (input #${inputIndex})`,
           type: 'Key',
         },
       },
@@ -83,6 +83,7 @@ export const generateTemplateEntitiesP2SH = (
   artifact: Artifact,
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedFunctionArgument[],
+  inputIndex: number,
 ): WalletTemplate['entities'] => {
   const functionParameters = Object.fromEntries<WalletTemplateVariable>(
     abiFunction.inputs.map((input, index) => ([
@@ -107,12 +108,12 @@ export const generateTemplateEntitiesP2SH = (
   );
 
   const entities = {
-    [snakeCase(artifact.contractName + 'Parameters')]: {
+    [snakeCase(artifact.contractName + 'Parameters' + '_input' + inputIndex)]: {
       description: 'Contract creation and function parameters',
-      name: titleCase(artifact.contractName),
+      name: `${artifact.contractName} (input #${inputIndex})`,
       scripts: [
         snakeCase(artifact.contractName + '_lock'),
-        snakeCase(artifact.contractName + '_' + abiFunction.name + '_unlock'),
+        snakeCase(artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock'),
       ],
       variables: {
         ...functionParameters,
@@ -123,7 +124,7 @@ export const generateTemplateEntitiesP2SH = (
 
   // function_index is a special variable that indicates the function to execute
   if (artifact.abi.length > 1) {
-    entities[snakeCase(artifact.contractName + 'Parameters')].variables.function_index = {
+    entities[snakeCase(artifact.contractName + 'Parameters' + '_input' + inputIndex)].variables.function_index = {
       description: 'Script function index to execute',
       name: titleCase('function_index'),
       type: 'WalletData',
@@ -142,12 +143,12 @@ export const generateTemplateEntitiesP2SH = (
  */
 export const generateTemplateScriptsP2PKH = (
   template: SignatureTemplate,
-  index: number,
+  inputIndex: number,
 ): WalletTemplate['scripts'] => {
   const scripts: WalletTemplate['scripts'] = {};
-  const lockScriptName = `p2pkh_placeholder_lock_${index}`;
-  const unlockScriptName = `p2pkh_placeholder_unlock_${index}`;
-  const placeholderKeyName = `placeholder_key_${index}`;
+  const lockScriptName = `p2pkh_placeholder_lock_${inputIndex}`;
+  const unlockScriptName = `p2pkh_placeholder_unlock_${inputIndex}`;
+  const placeholderKeyName = `placeholder_key_${inputIndex}`;
 
   const signatureAlgorithmName = getSignatureAlgorithmName(template.getSignatureAlgorithm());
   const hashtypeName = getHashTypeName(template.getHashType(false));
@@ -155,14 +156,14 @@ export const generateTemplateScriptsP2PKH = (
   // add extra unlocking and locking script for P2PKH inputs spent alongside our contract
   // this is needed for correct cross-references in the template
   scripts[unlockScriptName] = {
-    name: unlockScriptName,
+    name: `P2PKH Unlock (input #${inputIndex})`,
     script:
       `<${signatureString}>\n<${placeholderKeyName}.public_key>`,
     unlocks: lockScriptName,
   };
   scripts[lockScriptName] = {
     lockingType: 'standard',
-    name: lockScriptName,
+    name: `P2PKH Lock (input #${inputIndex})`,
     script:
       `OP_DUP\nOP_HASH160 <$(<${placeholderKeyName}.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG`,
   };
@@ -183,12 +184,16 @@ export const generateTemplateScriptsP2SH = (
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedFunctionArgument[],
   encodedConstructorArgs: EncodedConstructorArgument[],
-  scenarioIds: string[],
+  scenarioId: string,
+  inputIndex: number,
 ): WalletTemplate['scripts'] => {
   // definition of locking scripts and unlocking scripts with their respective bytecode
+  const unlockingScriptName = snakeCase(artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock');
+  const lockingScriptName = snakeCase(artifact.contractName + '_lock');
+
   return {
-    [snakeCase(artifact.contractName + '_' + abiFunction.name + '_unlock')]: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs, scenarioIds),
-    [snakeCase(artifact.contractName + '_lock')]: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
+    [unlockingScriptName]: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs, scenarioId, inputIndex),
+    [lockingScriptName]: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
   };
 };
 
@@ -228,7 +233,8 @@ const generateTemplateUnlockScript = (
   artifact: Artifact,
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedFunctionArgument[],
-  scenarioIds: string[],
+  scenarioId: string,
+  inputIndex: number,
 ): WalletTemplateScriptUnlocking => {
   const functionIndex = artifact.abi.findIndex((func) => func.name === abiFunction.name);
 
@@ -238,8 +244,8 @@ const generateTemplateUnlockScript = (
 
   return {
     // this unlocking script must pass our only scenario
-    passes: scenarioIds,
-    name: abiFunction.name,
+    passes: [scenarioId],
+    name: `${abiFunction.name} (input #${inputIndex})`,
     script: [
       `// "${abiFunction.name}" function parameters`,
       formatParametersForDebugging(abiFunction.inputs, encodedFunctionArgs),
@@ -389,13 +395,13 @@ export const getLibauthTemplates = (
   const unlockingBytecodeToLockingBytecodeParams: Record<string, WalletTemplateScenarioBytecode> = {};
   const lockingBytecodeToLockingBytecodeParams: Record<string, WalletTemplateScenarioBytecode> = {};
 
-  for (const [idx, input] of txn.inputs.entries()) {
+  for (const [inputIndex, input] of txn.inputs.entries()) {
     // If template exists on the input, it indicates this is a P2PKH (Pay to Public Key Hash) input
     if (input.unlocker?.template) {
       // @ts-ignore TODO: Remove UtxoP2PKH type and only use UnlockableUtxo in Libaith Template generation
       input.template = input.unlocker?.template;  // Added to support P2PKH inputs in buildTemplate
-      Object.assign(p2pkhEntities, generateTemplateEntitiesP2PKH(idx));
-      Object.assign(p2pkhScripts, generateTemplateScriptsP2PKH(input.unlocker.template, idx));
+      Object.assign(p2pkhEntities, generateTemplateEntitiesP2PKH(inputIndex));
+      Object.assign(p2pkhScripts, generateTemplateScriptsP2PKH(input.unlocker.template, inputIndex));
 
       continue;
     }
@@ -441,7 +447,7 @@ export const getLibauthTemplates = (
           csTransaction as any,
           abiFunction,
           encodedArgs,
-          idx,
+          inputIndex,
         ),
       );
 
@@ -450,6 +456,7 @@ export const getLibauthTemplates = (
         contract.artifact,
         abiFunction,
         encodedArgs,
+        inputIndex,
       );
 
       // Generate scripts for this contract input
@@ -459,15 +466,16 @@ export const getLibauthTemplates = (
         abiFunction,
         encodedArgs,
         contract.encodedConstructorArgs,
-        scenarioIds,
+        scenarioIdentifier,
+        inputIndex,
       );
 
       // Find the lock script name for this contract input
       const lockScriptName = Object.keys(script).find(scriptName => scriptName.includes('_lock'));
       if (lockScriptName) {
         // Generate bytecodes for this contract input
-        const csInput = csTransaction.inputs[idx];
-        const unlockingBytecode = binToHex(libauthTransaction.inputs[idx].unlockingBytecode);
+        const csInput = csTransaction.inputs[inputIndex];
+        const unlockingBytecode = binToHex(libauthTransaction.inputs[inputIndex].unlockingBytecode);
         const lockingScriptParams = generateLockingScriptParams(csInput.unlocker!.contract!, csInput, lockScriptName);
 
         // Assign a name to the unlocking bytecode so later it can be used to replace the bytecode/slot in scenarios
@@ -482,11 +490,6 @@ export const getLibauthTemplates = (
     }
   }
 
-  // Merge P2PKH scripts
-  for (const entity of Object.values(p2pkhEntities) as { scripts?: string[] }[]) {
-    if (entity.scripts) { entity.scripts = [...Object.keys(scripts), ...entity.scripts]; }
-  }
-
   Object.assign(entities, p2pkhEntities);
   Object.assign(scripts, p2pkhScripts);
 
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index b1a2947d..9e65b574 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -3,7 +3,7 @@ import BarArtifact from '../Bar.artifact.js';
 import FooArtifact from '../Foo.artifact.js';
 import twtArtifact from '../transfer_with_timeout.artifact.js';
 import hodlVaultArtifact from '../hodl_vault.artifact.js';
-import { aliceAddress, alicePkh, alicePriv, alicePub, aliceTokenAddress, bobPriv, bobPub, carolPriv, carolPub, oracle, oraclePub } from '../vars.js';
+import { aliceAddress, alicePkh, alicePriv, alicePub, aliceTokenAddress, bobPkh, bobPriv, bobPub, carolPriv, carolPub, oracle, oraclePub } from '../vars.js';
 import { WalletTemplate } from '@bitauth/libauth';
 
 const provider = new MockNetworkProvider();
@@ -19,7 +19,7 @@ export const fixtures: Fixture[] = [
     name: 'Foo + Bar + P2PKH UTXOs',
     transaction: (async () => {
       // TODO: Foo contract is just P2PKH contract with extra log, see if we can use P2PKH contract instead
-      const fooContract = new Contract(FooArtifact, [alicePkh], { provider });
+      const fooContract = new Contract(FooArtifact, [bobPkh], { provider });
       provider.addUtxo(fooContract.address, randomUtxo());
 
       const tokenA = randomToken({ amount: 100000000n });
@@ -40,6 +40,8 @@ export const fixtures: Fixture[] = [
       provider.addUtxo(aliceAddress, randomUtxo({ token: tokenA }));
       provider.addUtxo(aliceAddress, randomUtxo({ token: nftB }));
 
+      const bobTemplate = new SignatureTemplate(bobPriv);
+
       const utxos = await provider.getUtxos(aliceAddress);
       const fooContractUtxos = await fooContract.getUtxos();
       const barContractUtxos = await barContract.getUtxos();
@@ -48,7 +50,7 @@ export const fixtures: Fixture[] = [
         .addInputs([utxos[0], utxos[1], utxos[2]], aliceTemplate.unlockP2PKH())
         .addInput(barContractUtxos[0], barContract.unlock.funcA())
         .addInput(barContractUtxos[1], barContract.unlock.execute(alicePub, aliceTemplate))
-        .addInput(fooContractUtxos[0], fooContract.unlock.execute(alicePub, aliceTemplate))
+        .addInput(fooContractUtxos[0], fooContract.unlock.execute(bobPub, bobTemplate))
         .addInput(barContractUtxos[2], barContract.unlock.funcB())
         .addOutput({ to: fooContract.address, amount: 8000n })
         .addOutput({ to: aliceTokenAddress, amount: 800n, token: tokenA })
@@ -65,12 +67,12 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'bar_parameters': {
+        'bar_parameters_input3': {
           'description': 'Contract creation and function parameters',
-          'name': 'Bar',
+          'name': 'Bar (input #3)',
           'scripts': [
             'bar_lock',
-            'bar_func_b_unlock',
+            'bar_func_a_input3_unlock',
           ],
           'variables': {
             'pkh_bar': {
@@ -85,12 +87,62 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'foo_parameters': {
+        'bar_parameters_input4': {
           'description': 'Contract creation and function parameters',
-          'name': 'Foo',
+          'name': 'Bar (input #4)',
+          'scripts': [
+            'bar_lock',
+            'bar_execute_input4_unlock',
+          ],
+          'variables': {
+            'pkh_bar': {
+              'description': '"pkh_bar" parameter of this contract',
+              'name': 'Pkh Bar',
+              'type': 'WalletData',
+            },
+            'pk': {
+              'description': '"pk" parameter of function "execute"',
+              'name': 'Pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "execute"',
+              'name': 'S',
+              'type': 'Key',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'bar_parameters_input6': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Bar (input #6)',
+          'scripts': [
+            'bar_lock',
+            'bar_func_b_input6_unlock',
+          ],
+          'variables': {
+            'pkh_bar': {
+              'description': '"pkh_bar" parameter of this contract',
+              'name': 'Pkh Bar',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'foo_parameters_input5': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Foo (input #5)',
           'scripts': [
             'foo_lock',
-            'foo_execute_unlock',
+            'foo_execute_input5_unlock',
           ],
           'variables': {
             'pk': {
@@ -112,74 +164,56 @@ export const fixtures: Fixture[] = [
         },
         'signer_0': {
           'scripts': [
-            'bar_func_a_unlock',
-            'bar_lock',
-            'bar_execute_unlock',
-            'foo_execute_unlock',
-            'foo_lock',
-            'bar_func_b_unlock',
             'p2pkh_placeholder_lock_0',
             'p2pkh_placeholder_unlock_0',
           ],
           'description': 'placeholder_key_0',
-          'name': 'Signer 0',
+          'name': 'P2PKH Signer (input #0)',
           'variables': {
             'placeholder_key_0': {
               'description': '',
-              'name': 'Placeholder Key 0',
+              'name': 'P2PKH Placeholder Key (input #0)',
               'type': 'Key',
             },
           },
         },
         'signer_1': {
           'scripts': [
-            'bar_func_a_unlock',
-            'bar_lock',
-            'bar_execute_unlock',
-            'foo_execute_unlock',
-            'foo_lock',
-            'bar_func_b_unlock',
             'p2pkh_placeholder_lock_1',
             'p2pkh_placeholder_unlock_1',
           ],
           'description': 'placeholder_key_1',
-          'name': 'Signer 1',
+          'name': 'P2PKH Signer (input #1)',
           'variables': {
             'placeholder_key_1': {
               'description': '',
-              'name': 'Placeholder Key 1',
+              'name': 'P2PKH Placeholder Key (input #1)',
               'type': 'Key',
             },
           },
         },
         'signer_2': {
           'scripts': [
-            'bar_func_a_unlock',
-            'bar_lock',
-            'bar_execute_unlock',
-            'foo_execute_unlock',
-            'foo_lock',
-            'bar_func_b_unlock',
             'p2pkh_placeholder_lock_2',
             'p2pkh_placeholder_unlock_2',
           ],
           'description': 'placeholder_key_2',
-          'name': 'Signer 2',
+          'name': 'P2PKH Signer (input #2)',
           'variables': {
             'placeholder_key_2': {
               'description': '',
-              'name': 'Placeholder Key 2',
+              'name': 'P2PKH Placeholder Key (input #2)',
               'type': 'Key',
             },
           },
         },
       },
       'scripts': {
-        'bar_func_a_unlock': {
+        'bar_func_a_input3_unlock': {
           'passes': [
             'bar_func_a_evaluate',
           ],
-          'name': 'funcA',
+          'name': 'funcA (input #3)',
           'script': '// "funcA" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
           'unlocks': 'bar_lock',
         },
@@ -188,63 +222,63 @@ export const fixtures: Fixture[] = [
           'name': 'Bar',
           'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
         },
-        'bar_execute_unlock': {
+        'bar_execute_input4_unlock': {
           'passes': [
             'bar_execute_evaluate',
           ],
-          'name': 'execute',
+          'name': 'execute (input #4)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// function index in contract\n<function_index> // int = <2>\n',
           'unlocks': 'bar_lock',
         },
-        'foo_execute_unlock': {
+        'foo_execute_input5_unlock': {
           'passes': [
             'foo_execute_evaluate',
           ],
-          'name': 'execute',
-          'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'name': 'execute (input #5)',
+          'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n',
           'unlocks': 'foo_lock',
         },
         'foo_lock': {
           'lockingType': 'p2sh32',
           'name': 'Foo',
-          'script': "// \"Foo\" contract constructor parameters\n<pkh_foo> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                                  */\n                                                        /*                                                              */\n                                                        /* contract Foo(bytes20 pkh_foo) {                              */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function execute(pubkey pk, sig s) {                     */\n                                                        /*         console.log('Foo 'execute' function called.');       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_foo);                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */",
+          'script': "// \"Foo\" contract constructor parameters\n<pkh_foo> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                                  */\n                                                        /*                                                              */\n                                                        /* contract Foo(bytes20 pkh_foo) {                              */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function execute(pubkey pk, sig s) {                     */\n                                                        /*         console.log('Foo 'execute' function called.');       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_foo);                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */",
         },
-        'bar_func_b_unlock': {
+        'bar_func_b_input6_unlock': {
           'passes': [
             'bar_func_b_evaluate',
           ],
-          'name': 'funcB',
+          'name': 'funcB (input #6)',
           'script': '// "funcB" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <1>\n',
           'unlocks': 'bar_lock',
         },
         'p2pkh_placeholder_unlock_0': {
-          'name': 'p2pkh_placeholder_unlock_0',
+          'name': 'P2PKH Unlock (input #0)',
           'script': '<placeholder_key_0.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_0.public_key>',
           'unlocks': 'p2pkh_placeholder_lock_0',
         },
         'p2pkh_placeholder_lock_0': {
           'lockingType': 'standard',
-          'name': 'p2pkh_placeholder_lock_0',
+          'name': 'P2PKH Lock (input #0)',
           'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_0.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
         },
         'p2pkh_placeholder_unlock_1': {
-          'name': 'p2pkh_placeholder_unlock_1',
+          'name': 'P2PKH Unlock (input #1)',
           'script': '<placeholder_key_1.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_1.public_key>',
           'unlocks': 'p2pkh_placeholder_lock_1',
         },
         'p2pkh_placeholder_lock_1': {
           'lockingType': 'standard',
-          'name': 'p2pkh_placeholder_lock_1',
+          'name': 'P2PKH Lock (input #1)',
           'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_1.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
         },
         'p2pkh_placeholder_unlock_2': {
-          'name': 'p2pkh_placeholder_unlock_2',
+          'name': 'P2PKH Unlock (input #2)',
           'script': '<placeholder_key_2.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_2.public_key>',
           'unlocks': 'p2pkh_placeholder_lock_2',
         },
         'p2pkh_placeholder_lock_2': {
           'lockingType': 'standard',
-          'name': 'p2pkh_placeholder_lock_2',
+          'name': 'P2PKH Lock (input #2)',
           'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_2.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
         },
       },
@@ -344,7 +378,7 @@ export const fixtures: Fixture[] = [
                   'script': 'foo_lock',
                   'overrides': {
                     'bytecode': {
-                      'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                      'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
                     },
                   },
                 },
@@ -439,7 +473,7 @@ export const fixtures: Fixture[] = [
                 'script': 'foo_lock',
                 'overrides': {
                   'bytecode': {
-                    'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
                   },
                 },
               },
@@ -556,7 +590,7 @@ export const fixtures: Fixture[] = [
                   'script': 'foo_lock',
                   'overrides': {
                     'bytecode': {
-                      'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                      'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
                     },
                   },
                 },
@@ -651,7 +685,7 @@ export const fixtures: Fixture[] = [
                 'script': 'foo_lock',
                 'overrides': {
                   'bytecode': {
-                    'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
                   },
                 },
               },
@@ -675,14 +709,14 @@ export const fixtures: Fixture[] = [
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
-              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
-              'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              'pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
             },
             'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                's': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
               },
             },
           },
@@ -767,7 +801,7 @@ export const fixtures: Fixture[] = [
                   'script': 'foo_lock',
                   'overrides': {
                     'bytecode': {
-                      'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                      'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
                     },
                   },
                 },
@@ -976,7 +1010,7 @@ export const fixtures: Fixture[] = [
                   'script': 'foo_lock',
                   'overrides': {
                     'bytecode': {
-                      'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                      'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
                     },
                   },
                 },
@@ -1076,7 +1110,7 @@ export const fixtures: Fixture[] = [
                 'script': 'foo_lock',
                 'overrides': {
                   'bytecode': {
-                    'pkh_foo': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
                   },
                 },
               },
@@ -1507,11 +1541,13 @@ export const fixtures: Fixture[] = [
     },
   },
   {
-    name: 'TwtContract timeout + twtContract transfer',
-    transaction: ( async () => {
+    name: '4 twtContract inputs',
+    transaction: (async () => {
       const twtContract = new Contract(twtArtifact, [bobPub, carolPub, 100000n], { provider });
       provider.addUtxo(twtContract.address, randomUtxo());
       provider.addUtxo(twtContract.address, randomUtxo());
+      provider.addUtxo(twtContract.address, randomUtxo());
+      provider.addUtxo(twtContract.address, randomUtxo());
 
       const twtContractUtxos = await twtContract.getUtxos();
 
@@ -1519,9 +1555,12 @@ export const fixtures: Fixture[] = [
       const carolTemplate = new SignatureTemplate(carolPriv);
 
       return new TransactionBuilder({ provider })
-        .addInput(twtContractUtxos[0], twtContract.unlock.timeout(bobTemplate))
-        .addInput(twtContractUtxos[1], twtContract.unlock.transfer(carolTemplate))
-        .addOutput({ to: twtContract.address, amount: 20_000n });
+        .addInput(twtContractUtxos[0], twtContract.unlock.timeout(bobTemplate)) // should succeed
+        .addInput(twtContractUtxos[1], twtContract.unlock.timeout(carolTemplate)) // should fail (wrong sig)
+        .addInput(twtContractUtxos[2], twtContract.unlock.transfer(carolTemplate)) // should succeed
+        .addInput(twtContractUtxos[3], twtContract.unlock.transfer(bobTemplate)) // should fail (wrong sig)
+        .addOutput({ to: twtContract.address, amount: 20_000n })
+        .setLocktime(1000000);
     })(),
     template: {
       '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
@@ -1532,19 +1571,49 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'transfer_with_timeout_parameters': {
+        'transfer_with_timeout_parameters_input0': {
           'description': 'Contract creation and function parameters',
-          'name': 'Transfer With Timeout',
+          'name': 'TransferWithTimeout (input #0)',
           'scripts': [
             'transfer_with_timeout_lock',
-            'transfer_with_timeout_transfer_unlock',
+            'transfer_with_timeout_timeout_input0_unlock',
           ],
           'variables': {
-            'recipient_sig': {
-              'description': '"recipientSig" parameter of function "transfer"',
-              'name': 'Recipient Sig',
+            'sender_sig': {
+              'description': '"senderSig" parameter of function "timeout"',
+              'name': 'Sender Sig',
               'type': 'Key',
             },
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'Sender',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'Recipient',
+              'type': 'WalletData',
+            },
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'Timeout',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'transfer_with_timeout_parameters_input1': {
+          'description': 'Contract creation and function parameters',
+          'name': 'TransferWithTimeout (input #1)',
+          'scripts': [
+            'transfer_with_timeout_lock',
+            'transfer_with_timeout_timeout_input1_unlock',
+          ],
+          'variables': {
             'sender_sig': {
               'description': '"senderSig" parameter of function "timeout"',
               'name': 'Sender Sig',
@@ -1572,13 +1641,83 @@ export const fixtures: Fixture[] = [
             },
           },
         },
+        'transfer_with_timeout_parameters_input2': {
+          'description': 'Contract creation and function parameters',
+          'name': 'TransferWithTimeout (input #2)',
+          'scripts': [
+            'transfer_with_timeout_lock',
+            'transfer_with_timeout_transfer_input2_unlock',
+          ],
+          'variables': {
+            'recipient_sig': {
+              'description': '"recipientSig" parameter of function "transfer"',
+              'name': 'Recipient Sig',
+              'type': 'Key',
+            },
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'Sender',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'Recipient',
+              'type': 'WalletData',
+            },
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'Timeout',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'transfer_with_timeout_parameters_input3': {
+          'description': 'Contract creation and function parameters',
+          'name': 'TransferWithTimeout (input #3)',
+          'scripts': [
+            'transfer_with_timeout_lock',
+            'transfer_with_timeout_transfer_input3_unlock',
+          ],
+          'variables': {
+            'recipient_sig': {
+              'description': '"recipientSig" parameter of function "transfer"',
+              'name': 'Recipient Sig',
+              'type': 'Key',
+            },
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'Sender',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'Recipient',
+              'type': 'WalletData',
+            },
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'Timeout',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'Function Index',
+              'type': 'WalletData',
+            },
+          },
+        },
       },
       'scripts': {
-        'transfer_with_timeout_timeout_unlock': {
+        'transfer_with_timeout_timeout_input0_unlock': {
           'passes': [
             'transfer_with_timeout_timeout_evaluate',
           ],
-          'name': 'timeout',
+          'name': 'timeout (input #0)',
           'script': '// "timeout" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
           'unlocks': 'transfer_with_timeout_lock',
         },
@@ -1587,11 +1726,27 @@ export const fixtures: Fixture[] = [
           'name': 'TransferWithTimeout',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
         },
-        'transfer_with_timeout_transfer_unlock': {
+        'transfer_with_timeout_timeout_input1_unlock': {
+          'passes': [
+            'transfer_with_timeout_timeout_evaluate1',
+          ],
+          'name': 'timeout (input #1)',
+          'script': '// "timeout" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'transfer_with_timeout_lock',
+        },
+        'transfer_with_timeout_transfer_input2_unlock': {
           'passes': [
             'transfer_with_timeout_transfer_evaluate',
           ],
-          'name': 'transfer',
+          'name': 'transfer (input #2)',
+          'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'transfer_with_timeout_lock',
+        },
+        'transfer_with_timeout_transfer_input3_unlock': {
+          'passes': [
+            'transfer_with_timeout_transfer_evaluate1',
+          ],
+          'name': 'transfer (input #3)',
           'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
           'unlocks': 'transfer_with_timeout_lock',
         },
@@ -1607,7 +1762,7 @@ export const fixtures: Fixture[] = [
               'timeout': '0xa08601',
               'function_index': '1',
             },
-            'currentBlockHeight': expect.any(Number),
+            'currentBlockHeight': 2,
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
@@ -1631,8 +1786,20 @@ export const fixtures: Fixture[] = [
                 'sequenceNumber': 4294967294,
                 'unlockingBytecode': {},
               },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
             ],
-            'locktime': 0,
+            'locktime': 1000000,
             'outputs': [
               {
                 'lockingBytecode': {
@@ -1670,6 +1837,145 @@ export const fixtures: Fixture[] = [
               },
               'valueSatoshis': expect.any(Number),
             },
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+        'transfer_with_timeout_timeout_evaluate1': {
+          'name': 'transfer_with_timeout_timeout_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+              'timeout': '0xa08601',
+              'function_index': '1',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'sender_sig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 1000000,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'transfer_with_timeout_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'timeout': '0xa08601',
+                    },
+                  },
+                },
+                'valueSatoshis': 20000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
           ],
         },
         'transfer_with_timeout_transfer_evaluate': {
@@ -1682,7 +1988,7 @@ export const fixtures: Fixture[] = [
               'timeout': '0xa08601',
               'function_index': '0',
             },
-            'currentBlockHeight': expect.any(Number),
+            'currentBlockHeight': 2,
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
@@ -1698,6 +2004,12 @@ export const fixtures: Fixture[] = [
                 'sequenceNumber': 4294967294,
                 'unlockingBytecode': {},
               },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
@@ -1706,8 +2018,14 @@ export const fixtures: Fixture[] = [
                   'slot',
                 ],
               },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
             ],
-            'locktime': 0,
+            'locktime': 1000000,
             'outputs': [
               {
                 'lockingBytecode': {
@@ -1726,6 +2044,145 @@ export const fixtures: Fixture[] = [
             'version': 2,
           },
           'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+        'transfer_with_timeout_transfer_evaluate1': {
+          'name': 'transfer_with_timeout_transfer_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+              'timeout': '0xa08601',
+              'function_index': '0',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'recipient_sig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.any(String),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 1000000,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'transfer_with_timeout_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'timeout': '0xa08601',
+                    },
+                  },
+                },
+                'valueSatoshis': 20000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'transfer_with_timeout_lock',
+                'overrides': {
+                  'bytecode': {
+                    'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                    'timeout': '0xa08601',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
             {
               'lockingBytecode': {
                 'script': 'transfer_with_timeout_lock',
@@ -1782,7 +2239,7 @@ export const fixtures: Fixture[] = [
           'name': 'Bar',
           'scripts': [
             'bar_lock',
-            'bar_execute_unlock',
+            'bar_execute_input4_unlock',
           ],
           'variables': {
             'pk': {
@@ -1809,10 +2266,9 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'bar_execute_unlock': {
+        'bar_execute_input4_unlock': {
           'passes': [
             'bar_execute_evaluate',
-            'bar_execute_evaluate1',
           ],
           'name': 'execute',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// function index in contract\n<function_index> // int = <2>\n',

From e730a6d23afbef583ad339ea371523efec189e36 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 25 Mar 2025 18:44:22 +0100
Subject: [PATCH 206/267] add info about the typings of constructor & function
 arguments to docs

---
 website/docs/language/contracts.md | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index 315cba09..addc554c 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -29,12 +29,17 @@ contract HTLC(pubkey sender, pubkey recipient, int expiration, bytes32 hash) {
 }
 ```
 
+:::info
+The typings for the constructor arguments are only semantic and used when initilaizing the contract with the SDK. This means when not using the SDK you could still pass a different byte length item to `bytes32 hash`.
+:::
+
+
 :::note
-Upon initialization of the contract, constructor parameters are encoded and added to the contract's bytecode in the reversed order of their declaration. This can be important when manually initializing contracts for debugging purposes.
+Upon initialization of the contract, constructor parameters are encoded and added to the contract's bytecode in the reversed order of their declaration. This can be important when manually constructing the contract locking script for debugging purposes.
 :::
 
 ## Functions
-The main construct in a CashScript contract is the function. A contract can contain one or multiple functions that can be executed to trigger transactions that spend money from the contract. At its core, the result of a function is just a yes or no answer to the question 'Can money be sent out of this contract?'. However, by using a technique called covenants, it's possible to specify additional conditions — like restricting *where* money can be sent. To read more about this technique, refer to the [CashScript Covenants Guide](/docs/guides/covenants).
+The main construct in a CashScript contract is the function. A contract can contain one or multiple functions that can be executed to trigger transactions that spend money from the contract. At its core, the result of a function is just a yes or no answer to the question 'Can money be sent out of this contract?'. However, by using 'covenants it's possible to specify additional conditions — like restricting *where* money can be sent. To learn more about covenants, refer to the [CashScript Covenants Guide](/docs/guides/covenants).
 
 #### Example
 ```solidity
@@ -51,8 +56,12 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 }
 ```
 
+:::caution
+The typings for the function arguments are only semantic, this means the length of bounded bytes types like `bytes20` are **not** contract enforced automatically. Instead add an explicit length check `require(item.length == 20)`.
+:::
+
 :::note
-Function parameters are passed in the reversed order of their declaration. This can be important when manually creating contract transactions for debugging purposes.
+Function parameters are passed in the reversed order of their declaration. This can be important when debugging or when creating transactions manually.
 :::
 
 ## Statements

From c504a1760083e05fda4f25992fcce831ceabb808 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 26 Mar 2025 07:02:32 +0100
Subject: [PATCH 207/267] remove change-case dependency and usage of snakeCase
 in libauthTemplate generation

---
 packages/cashscript/package.json              |  2 -
 packages/cashscript/src/LibauthTemplate.ts    | 48 +++++++++----------
 .../src/advanced/LibauthTemplate.ts           | 40 +++++++---------
 packages/cashscript/src/debugging.ts          |  4 +-
 packages/cashscript/src/utils.ts              | 23 ---------
 yarn.lock                                     | 12 -----
 6 files changed, 44 insertions(+), 85 deletions(-)

diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index bb3ba65d..91dc6bc3 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -47,7 +47,6 @@
     "@cashscript/utils": "^0.11.0-next.2",
     "@electrum-cash/network": "^4.1.1",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
-    "change-case": "^5.4.4",
     "delay": "^6.0.0",
     "fast-deep-equal": "^3.1.3",
     "pako": "^2.1.0",
@@ -56,7 +55,6 @@
   "devDependencies": {
     "@jest/globals": "^29.7.0",
     "@psf/bch-js": "^6.8.0",
-    "@types/change-case": "^2.3.5",
     "@types/pako": "^2.0.3",
     "@types/semver": "^7.5.8",
     "eslint": "^8.54.0",
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 0cafefa4..a8d02993 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -37,7 +37,7 @@ import {
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
 import { EncodedConstructorArgument, EncodedFunctionArgument } from './Argument.js';
-import { addressToLockScript, extendedStringify, snakeCase, zip } from './utils.js';
+import { addressToLockScript, extendedStringify, zip } from './utils.js';
 import { Contract } from './Contract.js';
 
 interface BuildTemplateOptions {
@@ -89,9 +89,9 @@ export const buildTemplate = async ({
       const hashtypeName = getHashTypeName(input.template.getHashType(false));
       const signatureString = `${placeholderKeyName}.${signatureAlgorithmName}.${hashtypeName}`;
 
-      template.entities[snakeCase(contract.name + 'Parameters')].scripts!.push(lockScriptName, unlockScriptName);
-      template.entities[snakeCase(contract.name + 'Parameters')].variables = {
-        ...template.entities[snakeCase(contract.name + 'Parameters')].variables,
+      template.entities[contract.name + '_parameters'].scripts!.push(lockScriptName, unlockScriptName);
+      template.entities[contract.name + '_parameters'].variables = {
+        ...template.entities[contract.name + '_parameters'].variables,
         [placeholderKeyName]: {
           description: placeholderKeyName,
           name: placeholderKeyName,
@@ -132,7 +132,7 @@ const generateTemplateEntities = (
 ): WalletTemplate['entities'] => {
   const functionParameters = Object.fromEntries<WalletTemplateVariable>(
     abiFunction.inputs.map((input, index) => ([
-      snakeCase(input.name),
+      input.name,
       {
         description: `"${input.name}" parameter of function "${abiFunction.name}"`,
         name: input.name,
@@ -143,7 +143,7 @@ const generateTemplateEntities = (
 
   const constructorParameters = Object.fromEntries<WalletTemplateVariable>(
     artifact.constructorInputs.map((input) => ([
-      snakeCase(input.name),
+      input.name,
       {
         description: `"${input.name}" parameter of this contract`,
         name: input.name,
@@ -153,12 +153,12 @@ const generateTemplateEntities = (
   );
 
   const entities = {
-    [snakeCase(artifact.contractName + 'Parameters')]: {
+    [artifact.contractName + '_parameters']: {
       description: 'Contract creation and function parameters',
-      name: snakeCase(artifact.contractName + 'Parameters'),
+      name: artifact.contractName + '_parameters',
       scripts: [
-        snakeCase(artifact.contractName + '_lock'),
-        snakeCase(artifact.contractName + '_unlock'),
+        artifact.contractName + '_lock',
+        artifact.contractName + '_unlock',
       ],
       variables: {
         ...functionParameters,
@@ -169,7 +169,7 @@ const generateTemplateEntities = (
 
   // function_index is a special variable that indicates the function to execute
   if (artifact.abi.length > 1) {
-    entities[snakeCase(artifact.contractName + 'Parameters')].variables.function_index = {
+    entities[artifact.contractName + '_parameters'].variables.function_index = {
       description: 'Script function index to execute',
       name: 'function_index',
       type: 'WalletData',
@@ -188,8 +188,8 @@ const generateTemplateScripts = (
 ): WalletTemplate['scripts'] => {
   // definition of locking scripts and unlocking scripts with their respective bytecode
   return {
-    [snakeCase(artifact.contractName + '_unlock')]: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs),
-    [snakeCase(artifact.contractName + '_lock')]: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
+    [artifact.contractName + '_unlock']: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs),
+    [artifact.contractName + '_lock']: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
   };
 };
 
@@ -200,7 +200,7 @@ const generateTemplateLockScript = (
 ): WalletTemplateScriptLocking => {
   return {
     lockingType: addressType,
-    name: snakeCase(artifact.contractName + '_lock'),
+    name: artifact.contractName + '_lock',
     script: [
       `// "${artifact.contractName}" contract constructor parameters`,
       formatParametersForDebugging(artifact.constructorInputs, constructorArguments),
@@ -224,15 +224,15 @@ const generateTemplateUnlockScript = (
 
   return {
     // this unlocking script must pass our only scenario
-    passes: [snakeCase(artifact.contractName + 'Evaluate')],
-    name: snakeCase(artifact.contractName + '_unlock'),
+    passes: [artifact.contractName + '_evaluate'],
+    name: artifact.contractName + '_unlock',
     script: [
       `// "${abiFunction.name}" function parameters`,
       formatParametersForDebugging(abiFunction.inputs, encodedFunctionArgs),
       '',
       ...functionIndexString,
     ].join('\n'),
-    unlocks: snakeCase(artifact.contractName + '_lock'),
+    unlocks: artifact.contractName + '_lock',
   };
 };
 
@@ -250,8 +250,8 @@ const generateTemplateScenarios = (
 
   const scenarios = {
     // single scenario to spend out transaction under test given the CashScript parameters provided
-    [snakeCase(artifact.contractName + 'Evaluate')]: {
-      name: snakeCase(artifact.contractName + 'Evaluate'),
+    [artifact.contractName + '_evaluate']: {
+      name: artifact.contractName + '_evaluate',
       description: 'An example evaluation where this script execution passes.',
       data: {
         // encode values for the variables defined above in `entities` property
@@ -272,7 +272,7 @@ const generateTemplateScenarios = (
 
   if (artifact.abi.length > 1) {
     const functionIndex = artifact.abi.findIndex((func) => func.name === transaction.abiFunction.name);
-    scenarios![snakeCase(artifact.contractName + 'Evaluate')].data!.bytecode!.function_index = functionIndex.toString();
+    scenarios![artifact.contractName + '_evaluate'].data!.bytecode!.function_index = functionIndex.toString();
   }
 
   return scenarios;
@@ -382,7 +382,7 @@ export const generateTemplateScenarioParametersValues = (
     .map(([input, arg]) => {
       const encodedArgumentHex = binToHex(arg as Uint8Array);
       const prefixedEncodedArgument = addHexPrefixExceptEmpty(encodedArgumentHex);
-      return [snakeCase(input.name), prefixedEncodedArgument] as const;
+      return [input.name, prefixedEncodedArgument] as const;
     });
 
   return Object.fromEntries(entries);
@@ -400,7 +400,7 @@ export const generateTemplateScenarioKeys = (
 
   const entries = typesAndArguments
     .filter(([, arg]) => arg instanceof SignatureTemplate)
-    .map(([input, arg]) => ([snakeCase(input.name), binToHex((arg as SignatureTemplate).privateKey)] as const));
+    .map(([input, arg]) => ([input.name, binToHex((arg as SignatureTemplate).privateKey)] as const));
 
   return Object.fromEntries(entries);
 };
@@ -415,14 +415,14 @@ export const formatParametersForDebugging = (types: readonly AbiInput[], args: E
     if (arg instanceof SignatureTemplate) {
       const signatureAlgorithmName = getSignatureAlgorithmName(arg.getSignatureAlgorithm());
       const hashtypeName = getHashTypeName(arg.getHashType(false));
-      return `<${snakeCase(input.name)}.${signatureAlgorithmName}.${hashtypeName}> // ${input.type}`;
+      return `<${input.name}.${signatureAlgorithmName}.${hashtypeName}> // ${input.type}`;
     }
 
     const typeStr = input.type === 'bytes' ? `bytes${arg.length}` : input.type;
 
     // we output these values as pushdata, comment will contain the type and the value of the variable
     // e.g. <timeout> // int = <0xa08601>
-    return `<${snakeCase(input.name)}> // ${typeStr} = <${`0x${binToHex(arg)}`}>`;
+    return `<${input.name}> // ${typeStr} = <${`0x${binToHex(arg)}`}>`;
   }).join('\n');
 };
 
diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index 385ade3c..2fa15c86 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -39,7 +39,7 @@ import {
 } from '../LibauthTemplate.js';
 import SignatureTemplate from '../SignatureTemplate.js';
 import { Transaction } from '../Transaction.js';
-import { addressToLockScript, snakeCase, titleCase } from '../utils.js';
+import { addressToLockScript } from '../utils.js';
 import { TransactionBuilder } from '../TransactionBuilder.js';
 
 
@@ -87,10 +87,10 @@ export const generateTemplateEntitiesP2SH = (
 ): WalletTemplate['entities'] => {
   const functionParameters = Object.fromEntries<WalletTemplateVariable>(
     abiFunction.inputs.map((input, index) => ([
-      snakeCase(input.name),
+      input.name,
       {
         description: `"${input.name}" parameter of function "${abiFunction.name}"`,
-        name: titleCase(input.name),
+        name: input.name,
         type: encodedFunctionArgs[index] instanceof SignatureTemplate ? 'Key' : 'WalletData',
       },
     ])),
@@ -98,22 +98,22 @@ export const generateTemplateEntitiesP2SH = (
 
   const constructorParameters = Object.fromEntries<WalletTemplateVariable>(
     artifact.constructorInputs.map((input) => ([
-      snakeCase(input.name),
+      input.name,
       {
         description: `"${input.name}" parameter of this contract`,
-        name: titleCase(input.name),
+        name: input.name,
         type: 'WalletData',
       },
     ])),
   );
 
   const entities = {
-    [snakeCase(artifact.contractName + 'Parameters' + '_input' + inputIndex)]: {
+    [artifact.contractName + '_parameters' + '_input' + inputIndex]: {
       description: 'Contract creation and function parameters',
       name: `${artifact.contractName} (input #${inputIndex})`,
       scripts: [
-        snakeCase(artifact.contractName + '_lock'),
-        snakeCase(artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock'),
+        artifact.contractName + '_lock',
+        artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock',
       ],
       variables: {
         ...functionParameters,
@@ -124,9 +124,9 @@ export const generateTemplateEntitiesP2SH = (
 
   // function_index is a special variable that indicates the function to execute
   if (artifact.abi.length > 1) {
-    entities[snakeCase(artifact.contractName + 'Parameters' + '_input' + inputIndex)].variables.function_index = {
+    entities[artifact.contractName + '_parameters' + '_input' + inputIndex].variables.function_index = {
       description: 'Script function index to execute',
-      name: titleCase('function_index'),
+      name: 'function_index',
       type: 'WalletData',
     };
   }
@@ -188,8 +188,8 @@ export const generateTemplateScriptsP2SH = (
   inputIndex: number,
 ): WalletTemplate['scripts'] => {
   // definition of locking scripts and unlocking scripts with their respective bytecode
-  const unlockingScriptName = snakeCase(artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock');
-  const lockingScriptName = snakeCase(artifact.contractName + '_lock');
+  const unlockingScriptName = artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock';
+  const lockingScriptName = artifact.contractName + '_lock';
 
   return {
     [unlockingScriptName]: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs, scenarioId, inputIndex),
@@ -252,7 +252,7 @@ const generateTemplateUnlockScript = (
       '',
       ...functionIndexString,
     ].join('\n'),
-    unlocks: snakeCase(artifact.contractName + '_lock'),
+    unlocks: artifact.contractName + '_lock',
   };
 };
 
@@ -271,7 +271,7 @@ export const generateTemplateScenarios = (
   const scenarios = {
     // single scenario to spend out transaction under test given the CashScript parameters provided
     [scenarioIdentifier]: {
-      name: snakeCase(artifact.contractName + '_' + abiFunction.name + 'Evaluate'),
+      name: artifact.contractName + '_' + abiFunction.name + '_evaluate',
       description: 'An example evaluation where this script execution passes.',
       data: {
         // encode values for the variables defined above in `entities` property
@@ -421,17 +421,15 @@ export const getLibauthTemplates = (
       let scenarioIdentifier = baseIdentifier;
       let counter = 0;
 
-      const scenarioIds = [snakeCase(scenarioIdentifier)];
+      const scenarioIds = [scenarioIdentifier];
 
       // Find first available unique identifier by incrementing counter
-      while (scenarios[snakeCase(scenarioIdentifier)]) {
+      while (scenarios[scenarioIdentifier]) {
         counter++;
         scenarioIdentifier = `${baseIdentifier}${counter}`;
-        scenarioIds.push(snakeCase(scenarioIdentifier));
+        scenarioIds.push(scenarioIdentifier);
       }
 
-      scenarioIdentifier = snakeCase(scenarioIdentifier);
-
       // Encode the function arguments for this contract input
       const encodedArgs = encodeFunctionArguments(
         abiFunction,
@@ -567,9 +565,7 @@ const generateLockingScriptParams = (
       addHexPrefixExceptEmpty(binToHex(csInput.unlocker!.contract!.encodedConstructorArgs[index])),
     ]);
 
-  const constructorParams = Object.fromEntries(
-    constructorParamsEntries.map(([key, value]) => [snakeCase(key), value]),
-  );
+  const constructorParams = Object.fromEntries(constructorParamsEntries);
 
   return {
     script: lockScriptName,
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index b46a6efc..70bab181 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -1,6 +1,6 @@
 import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, WalletTemplateScriptUnlocking, binToHex, createCompiler, createVirtualMachineBch2025, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
 import { Artifact, LogEntry, Op, PrimitiveType, StackItem, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
-import { findLastIndex, snakeCase, toRegExp } from './utils.js';
+import { findLastIndex, toRegExp } from './utils.js';
 import { FailedRequireError, FailedTransactionError, FailedTransactionEvaluationError } from './Errors.js';
 import { getBitauthUri } from './LibauthTemplate.js';
 
@@ -17,7 +17,7 @@ export const debugTemplate = (template: WalletTemplate, artifacts: Artifact[]):
     // There are no scenarios defined for P2PKH placeholder scripts, so we skip them
     if (scenarioIds.length === 0) continue;
 
-    const matchingArtifact = artifacts.find((artifact) => unlockingScriptId.startsWith(snakeCase(artifact.contractName)));
+    const matchingArtifact = artifacts.find((artifact) => unlockingScriptId.startsWith(artifact.contractName));
 
     if (!matchingArtifact) {
       throw new Error(`No artifact found for unlocking script ${unlockingScriptId}`);
diff --git a/packages/cashscript/src/utils.ts b/packages/cashscript/src/utils.ts
index a6a68252..26699d88 100644
--- a/packages/cashscript/src/utils.ts
+++ b/packages/cashscript/src/utils.ts
@@ -41,8 +41,6 @@ import {
   UndefinedInputError,
 } from './Errors.js';
 
-export { snakeCase } from 'change-case';
-
 // ////////// PARAMETER VALIDATION ////////////////////////////////////////////
 export function validateInput(utxo: Utxo): void {
   if (!utxo) {
@@ -349,27 +347,6 @@ export function findLastIndex<T>(array: Array<T>, predicate: (value: T, index: n
   return -1;
 }
 
-// TODO: Somehow, this turns P2PKHLock into p2pkh_lock, but P2PKH_Lock into p2_pkh_lock
-// export const snakeCase = (str: string): string => (
-//   str
-//   && str
-//     .match(
-//       /([A-Z]+\d*[A-Z]*(?=[A-Z][a-z])|[A-Z]?[a-z]+\d*[a-z]+|[A-Z]?[a-z]+\d*|[A-Z]+\d*|\d+)/g,
-//     )!
-//     .map((s) => s.toLowerCase())
-//     .join('_')
-// );
-
-export const titleCase = (str: string): string => {
-  if (!str) return '';
-  return str
-    .match(
-      /[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g,
-    )!
-    .map((s) => s.charAt(0).toUpperCase() + s.slice(1).toLowerCase())
-    .join(' ');
-};
-
 // JSON.stringify version that can serialize otherwise unsupported types (bigint and Uint8Array)
 export const extendedStringify = (obj: any, spaces?: number): string => JSON.stringify(
   obj,
diff --git a/yarn.lock b/yarn.lock
index 5e08360e..0b1d34ae 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -2704,13 +2704,6 @@
   dependencies:
     "@babel/types" "^7.3.0"
 
-"@types/change-case@^2.3.5":
-  version "2.3.5"
-  resolved "https://registry.yarnpkg.com/@types/change-case/-/change-case-2.3.5.tgz#7c86cefd5897738980fc3bcbe466b03b38026dbd"
-  integrity sha512-JvctDvBuY3MVSEisGbSgaAdJTcs+2JjBKO60W1Isr3GnX2YZCyJYLDY96bV4eWensEUrQLRGEL+egAkIXYrW1Q==
-  dependencies:
-    change-case "*"
-
 "@types/color-name@^1.1.1":
   version "1.1.4"
   resolved "https://registry.yarnpkg.com/@types/color-name/-/color-name-1.1.4.tgz#e002611ff627347818d440a05e81650e9a4053b8"
@@ -3894,11 +3887,6 @@ chalk@^5.2.0, chalk@^5.4.1:
   resolved "https://registry.yarnpkg.com/chalk/-/chalk-5.4.1.tgz#1b48bf0963ec158dce2aacf69c093ae2dd2092d8"
   integrity sha512-zgVZuo2WcZgfUEmsn6eO3kINexW8RAE4maiQ8QNs8CtpPCSyMiYsULR3HQYkm3w8FIA3SberyMJMSldGsW+U3w==
 
-change-case@*, change-case@^5.4.4:
-  version "5.4.4"
-  resolved "https://registry.yarnpkg.com/change-case/-/change-case-5.4.4.tgz#0d52b507d8fb8f204343432381d1a6d7bff97a02"
-  integrity sha512-HRQyTk2/YPEkt9TnUPbOpr64Uw3KOicFWPVBb+xiHvd6eBx/qPr9xqfBFDT8P2vWsvvz4jbEkfDe71W3VyNu2w==
-
 char-regex@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/char-regex/-/char-regex-1.0.2.tgz#d744358226217f981ed58f479b1d6bcc29545dcf"

From 0c7f510b108e240dafa7cd0ff39132fb142c6a4e Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 26 Mar 2025 08:16:22 +0100
Subject: [PATCH 208/267] update fixtures

---
 .../src/advanced/LibauthTemplate.ts           |   2 +-
 .../test/fixture/libauth-template/fixtures.ts | 576 +++++++++---------
 .../multi-contract-fixtures.ts                | 562 +++++++++--------
 3 files changed, 589 insertions(+), 551 deletions(-)

diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index 2fa15c86..abe85f6a 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -417,7 +417,7 @@ export const getLibauthTemplates = (
 
       // Find matching function and index from contract.unlock Object, this uses Function Reference Comparison.
       // Generate unique scenario identifier by combining contract name, function name and counter
-      const baseIdentifier = `${contract.artifact.contractName}_${abiFunction.name}Evaluate`;
+      const baseIdentifier = `${contract.artifact.contractName}_${abiFunction.name}_evaluate`;
       let scenarioIdentifier = baseIdentifier;
       let counter = 0;
 
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index ba1967f2..f5d370d8 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -37,27 +37,22 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'transfer_with_timeout_parameters': {
+        'TransferWithTimeout_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'transfer_with_timeout_parameters',
+          'name': 'TransferWithTimeout_parameters',
           'scripts': [
-            'transfer_with_timeout_lock',
-            'transfer_with_timeout_unlock',
+            'TransferWithTimeout_lock',
+            'TransferWithTimeout_unlock',
           ],
           'variables': {
-            'recipient_sig': {
+            'recipientSig': {
               'description': '"recipientSig" parameter of function "transfer"',
               'name': 'recipientSig',
               'type': 'Key',
             },
-            'function_index': {
-              'description': 'Script function index to execute',
-              'name': 'function_index',
-              'type': 'WalletData',
-            },
-            'timeout': {
-              'description': '"timeout" parameter of this contract',
-              'name': 'timeout',
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'sender',
               'type': 'WalletData',
             },
             'recipient': {
@@ -65,30 +60,50 @@ export const fixtures: Fixture[] = [
               'name': 'recipient',
               'type': 'WalletData',
             },
-            'sender': {
-              'description': '"sender" parameter of this contract',
-              'name': 'sender',
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'timeout',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
       },
+      'scripts': {
+        'TransferWithTimeout_unlock': {
+          'passes': [
+            'TransferWithTimeout_evaluate',
+          ],
+          'name': 'TransferWithTimeout_unlock',
+          'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'TransferWithTimeout_lock',
+        },
+        'TransferWithTimeout_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'TransferWithTimeout_lock',
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+        },
+      },
       'scenarios': {
-        'transfer_with_timeout_evaluate': {
-          'name': 'transfer_with_timeout_evaluate',
+        'TransferWithTimeout_evaluate': {
+          'name': 'TransferWithTimeout_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
-              'function_index': '0',
-              'timeout': '0xa08601',
-              'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
               'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'timeout': '0xa08601',
+              'function_index': '0',
             },
-            'currentBlockHeight': 2,
+            'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                'recipient_sig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                'recipientSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
               },
             },
           },
@@ -122,21 +137,6 @@ export const fixtures: Fixture[] = [
           ],
         },
       },
-      'scripts': {
-        'transfer_with_timeout_unlock': {
-          'passes': [
-            'transfer_with_timeout_evaluate',
-          ],
-          'name': 'transfer_with_timeout_unlock',
-          'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'transfer_with_timeout_lock',
-        },
-        'transfer_with_timeout_lock': {
-          'lockingType': 'p2sh32',
-          'name': 'transfer_with_timeout_lock',
-          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
-        },
-      },
     },
   },
   {
@@ -161,22 +161,22 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'transfer_with_timeout_parameters': {
+        'TransferWithTimeout_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'transfer_with_timeout_parameters',
+          'name': 'TransferWithTimeout_parameters',
           'scripts': [
-            'transfer_with_timeout_lock',
-            'transfer_with_timeout_unlock',
+            'TransferWithTimeout_lock',
+            'TransferWithTimeout_unlock',
           ],
           'variables': {
-            'function_index': {
-              'description': 'Script function index to execute',
-              'name': 'function_index',
-              'type': 'WalletData',
+            'senderSig': {
+              'description': '"senderSig" parameter of function "timeout"',
+              'name': 'senderSig',
+              'type': 'Key',
             },
-            'timeout': {
-              'description': '"timeout" parameter of this contract',
-              'name': 'timeout',
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'sender',
               'type': 'WalletData',
             },
             'recipient': {
@@ -184,35 +184,50 @@ export const fixtures: Fixture[] = [
               'name': 'recipient',
               'type': 'WalletData',
             },
-            'sender': {
-              'description': '"sender" parameter of this contract',
-              'name': 'sender',
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'timeout',
               'type': 'WalletData',
             },
-            'sender_sig': {
-              'description': '"senderSig" parameter of function "timeout\"',
-              'name': 'senderSig',
-              'type': 'Key',
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
             },
           },
         },
       },
+      'scripts': {
+        'TransferWithTimeout_unlock': {
+          'passes': [
+            'TransferWithTimeout_evaluate',
+          ],
+          'name': 'TransferWithTimeout_unlock',
+          'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'TransferWithTimeout_lock',
+        },
+        'TransferWithTimeout_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'TransferWithTimeout_lock',
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+        },
+      },
       'scenarios': {
-        'transfer_with_timeout_evaluate': {
-          'name': 'transfer_with_timeout_evaluate',
+        'TransferWithTimeout_evaluate': {
+          'name': 'TransferWithTimeout_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
-              'function_index': '1',
-              'timeout': '0xa08601',
-              'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
               'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'timeout': '0xa08601',
+              'function_index': '1',
             },
-            'currentBlockHeight': 2,
+            'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                'sender_sig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                'senderSig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
               },
             },
           },
@@ -246,21 +261,6 @@ export const fixtures: Fixture[] = [
           ],
         },
       },
-      'scripts': {
-        'transfer_with_timeout_unlock': {
-          'passes': [
-            'transfer_with_timeout_evaluate',
-          ],
-          'name': 'transfer_with_timeout_unlock',
-          'script': '// "timeout\" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'transfer_with_timeout_lock',
-        },
-        'transfer_with_timeout_lock': {
-          'lockingType': 'p2sh32',
-          'name': 'transfer_with_timeout_lock',
-          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
-        },
-      },
     },
   },
   {
@@ -285,22 +285,17 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'mecenas_parameters': {
+        'Mecenas_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'mecenas_parameters',
+          'name': 'Mecenas_parameters',
           'scripts': [
-            'mecenas_lock',
-            'mecenas_unlock',
+            'Mecenas_lock',
+            'Mecenas_unlock',
           ],
           'variables': {
-            'function_index': {
-              'description': 'Script function index to execute',
-              'name': 'function_index',
-              'type': 'WalletData',
-            },
-            'pledge': {
-              'description': '"pledge" parameter of this contract',
-              'name': 'pledge',
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'recipient',
               'type': 'WalletData',
             },
             'funder': {
@@ -308,24 +303,44 @@ export const fixtures: Fixture[] = [
               'name': 'funder',
               'type': 'WalletData',
             },
-            'recipient': {
-              'description': '"recipient" parameter of this contract',
-              'name': 'recipient',
+            'pledge': {
+              'description': '"pledge" parameter of this contract',
+              'name': 'pledge',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
       },
+      'scripts': {
+        'Mecenas_unlock': {
+          'passes': [
+            'Mecenas_evaluate',
+          ],
+          'name': 'Mecenas_unlock',
+          'script': '// "receive" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'Mecenas_lock',
+        },
+        'Mecenas_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'Mecenas_lock',
+          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(this.age >= period);                                                                            */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
+        },
+      },
       'scenarios': {
-        'mecenas_evaluate': {
-          'name': 'mecenas_evaluate',
+        'Mecenas_evaluate': {
+          'name': 'Mecenas_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
-              'function_index': '0',
-              'pledge': '0x1027',
-              'funder': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
               'recipient': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              'funder': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
+              'pledge': '0x1027',
+              'function_index': '0',
             },
             'currentBlockHeight': 2,
             'currentBlockTime': expect.any(Number),
@@ -367,21 +382,6 @@ export const fixtures: Fixture[] = [
           ],
         },
       },
-      'scripts': {
-        'mecenas_unlock': {
-          'passes': [
-            'mecenas_evaluate',
-          ],
-          'name': 'mecenas_unlock',
-          'script': '// "receive" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'mecenas_lock',
-        },
-        'mecenas_lock': {
-          'lockingType': 'p2sh32',
-          'name': 'mecenas_lock',
-          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(this.age >= period);                                                                            */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
-        },
-      },
     },
   },
   {
@@ -414,24 +414,24 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'p2_pkh_parameters': {
+        'P2PKH_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'p2_pkh_parameters',
+          'name': 'P2PKH_parameters',
           'scripts': [
-            'p2_pkh_lock',
-            'p2_pkh_unlock',
+            'P2PKH_lock',
+            'P2PKH_unlock',
           ],
           'variables': {
-            's': {
-              'description': '"s" parameter of function "spend"',
-              'name': 's',
-              'type': 'Key',
-            },
             'pk': {
               'description': '"pk" parameter of function "spend"',
               'name': 'pk',
               'type': 'WalletData',
             },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
             'pkh': {
               'description': '"pkh" parameter of this contract',
               'name': 'pkh',
@@ -440,16 +440,31 @@ export const fixtures: Fixture[] = [
           },
         },
       },
+      'scripts': {
+        'P2PKH_unlock': {
+          'passes': [
+            'P2PKH_evaluate',
+          ],
+          'name': 'P2PKH_unlock',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
+        'P2PKH_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'P2PKH_lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+      },
       'scenarios': {
-        'p2_pkh_evaluate': {
-          'name': 'p2_pkh_evaluate',
+        'P2PKH_evaluate': {
+          'name': 'P2PKH_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
               'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
               'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
             },
-            'currentBlockHeight': 2,
+            'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
@@ -509,21 +524,6 @@ export const fixtures: Fixture[] = [
           ],
         },
       },
-      'scripts': {
-        'p2_pkh_unlock': {
-          'passes': [
-            'p2_pkh_evaluate',
-          ],
-          'name': 'p2_pkh_unlock',
-          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'p2_pkh_lock',
-        },
-        'p2_pkh_lock': {
-          'lockingType': 'p2sh32',
-          'name': 'p2_pkh_lock',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
-        },
-      },
     },
   },
   {
@@ -554,24 +554,24 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'p2_pkh_parameters': {
+        'P2PKH_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'p2_pkh_parameters',
+          'name': 'P2PKH_parameters',
           'scripts': [
-            'p2_pkh_lock',
-            'p2_pkh_unlock',
+            'P2PKH_lock',
+            'P2PKH_unlock',
           ],
           'variables': {
-            's': {
-              'description': '"s" parameter of function "spend"',
-              'name': 's',
-              'type': 'WalletData',
-            },
             'pk': {
               'description': '"pk" parameter of function "spend"',
               'name': 'pk',
               'type': 'WalletData',
             },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'WalletData',
+            },
             'pkh': {
               'description': '"pkh" parameter of this contract',
               'name': 'pkh',
@@ -580,15 +580,30 @@ export const fixtures: Fixture[] = [
           },
         },
       },
+      'scripts': {
+        'P2PKH_unlock': {
+          'passes': [
+            'P2PKH_evaluate',
+          ],
+          'name': 'P2PKH_unlock',
+          'script': '// "spend" function parameters\n<s> // sig = <0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61>\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
+        'P2PKH_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'P2PKH_lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+      },
       'scenarios': {
-        'p2_pkh_evaluate': {
-          'name': 'p2_pkh_evaluate',
+        'P2PKH_evaluate': {
+          'name': 'P2PKH_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
               'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
-              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
               's': '0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
             },
             'currentBlockHeight': 2,
             'currentBlockTime': expect.any(Number),
@@ -630,21 +645,6 @@ export const fixtures: Fixture[] = [
           ],
         },
       },
-      'scripts': {
-        'p2_pkh_unlock': {
-          'passes': [
-            'p2_pkh_evaluate',
-          ],
-          'name': 'p2_pkh_unlock',
-          'script': '// "spend" function parameters\n<s> // sig = <0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61>\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'p2_pkh_lock',
-        },
-        'p2_pkh_lock': {
-          'lockingType': 'p2sh32',
-          'name': 'p2_pkh_lock',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
-        },
-      },
     },
   },
   {
@@ -677,24 +677,24 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'p2_pkh_parameters': {
+        'P2PKH_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'p2_pkh_parameters',
+          'name': 'P2PKH_parameters',
           'scripts': [
-            'p2_pkh_lock',
-            'p2_pkh_unlock',
+            'P2PKH_lock',
+            'P2PKH_unlock',
           ],
           'variables': {
-            's': {
-              'description': '"s" parameter of function "spend"',
-              'name': 's',
-              'type': 'Key',
-            },
             'pk': {
               'description': '"pk" parameter of function "spend"',
               'name': 'pk',
               'type': 'WalletData',
             },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
             'pkh': {
               'description': '"pkh" parameter of this contract',
               'name': 'pkh',
@@ -703,9 +703,24 @@ export const fixtures: Fixture[] = [
           },
         },
       },
+      'scripts': {
+        'P2PKH_unlock': {
+          'passes': [
+            'P2PKH_evaluate',
+          ],
+          'name': 'P2PKH_unlock',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
+        'P2PKH_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'P2PKH_lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+      },
       'scenarios': {
-        'p2_pkh_evaluate': {
-          'name': 'p2_pkh_evaluate',
+        'P2PKH_evaluate': {
+          'name': 'P2PKH_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -780,21 +795,6 @@ export const fixtures: Fixture[] = [
           ],
         },
       },
-      'scripts': {
-        'p2_pkh_unlock': {
-          'passes': [
-            'p2_pkh_evaluate',
-          ],
-          'name': 'p2_pkh_unlock',
-          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'p2_pkh_lock',
-        },
-        'p2_pkh_lock': {
-          'lockingType': 'p2sh32',
-          'name': 'p2_pkh_lock',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
-        },
-      },
     },
   },
   {
@@ -825,70 +825,85 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'hodl_vault_parameters': {
+        'HodlVault_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'hodl_vault_parameters',
+          'name': 'HodlVault_parameters',
           'scripts': [
-            'hodl_vault_lock',
-            'hodl_vault_unlock',
+            'HodlVault_lock',
+            'HodlVault_unlock',
           ],
           'variables': {
-            'oracle_message': {
-              'description': '"oracleMessage" parameter of function "spend"',
-              'name': 'oracleMessage',
-              'type': 'WalletData',
+            'ownerSig': {
+              'description': '"ownerSig" parameter of function "spend"',
+              'name': 'ownerSig',
+              'type': 'Key',
             },
-            'oracle_sig': {
+            'oracleSig': {
               'description': '"oracleSig" parameter of function "spend"',
               'name': 'oracleSig',
               'type': 'WalletData',
             },
-            'owner_sig': {
-              'description': '"ownerSig" parameter of function "spend"',
-              'name': 'ownerSig',
-              'type': 'Key',
-            },
-            'price_target': {
-              'description': '"priceTarget" parameter of this contract',
-              'name': 'priceTarget',
+            'oracleMessage': {
+              'description': '"oracleMessage" parameter of function "spend"',
+              'name': 'oracleMessage',
               'type': 'WalletData',
             },
-            'min_block': {
-              'description': '"minBlock" parameter of this contract',
-              'name': 'minBlock',
+            'ownerPk': {
+              'description': '"ownerPk" parameter of this contract',
+              'name': 'ownerPk',
               'type': 'WalletData',
             },
-            'oracle_pk': {
+            'oraclePk': {
               'description': '"oraclePk" parameter of this contract',
               'name': 'oraclePk',
               'type': 'WalletData',
             },
-            'owner_pk': {
-              'description': '"ownerPk" parameter of this contract',
-              'name': 'ownerPk',
+            'minBlock': {
+              'description': '"minBlock" parameter of this contract',
+              'name': 'minBlock',
+              'type': 'WalletData',
+            },
+            'priceTarget': {
+              'description': '"priceTarget" parameter of this contract',
+              'name': 'priceTarget',
               'type': 'WalletData',
             },
           },
         },
       },
+      'scripts': {
+        'HodlVault_unlock': {
+          'passes': [
+            'HodlVault_evaluate',
+          ],
+          'name': 'HodlVault_unlock',
+          'script': '// "spend" function parameters\n<oracleMessage> // bytes8 = <0xa086010030750000>\n<oracleSig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<ownerSig.schnorr_signature.all_outputs_all_utxos> // sig\n',
+          'unlocks': 'HodlVault_lock',
+        },
+        'HodlVault_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'HodlVault_lock',
+          'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
+        },
+      },
       'scenarios': {
-        'hodl_vault_evaluate': {
-          'name': 'hodl_vault_evaluate',
+        'HodlVault_evaluate': {
+          'name': 'HodlVault_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
-              'oracle_message': '0xa086010030750000',
-              'oracle_sig': '0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b',
-              'price_target': '0x3075',
-              'min_block': '0xb88201',
-              'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
-              'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'oracleSig': '0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b',
+              'oracleMessage': '0xa086010030750000',
+              'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'oraclePk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'minBlock': '0xb88201',
+              'priceTarget': '0x3075',
             },
             'currentBlockHeight': 2,
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                'owner_sig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                'ownerSig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
               },
             },
           },
@@ -926,21 +941,6 @@ export const fixtures: Fixture[] = [
           ],
         },
       },
-      'scripts': {
-        'hodl_vault_unlock': {
-          'passes': [
-            'hodl_vault_evaluate',
-          ],
-          'name': 'hodl_vault_unlock',
-          'script': '// "spend" function parameters\n<oracle_message> // bytes8 = <0xa086010030750000>\n<oracle_sig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<owner_sig.schnorr_signature.all_outputs_all_utxos> // sig\n',
-          'unlocks': 'hodl_vault_lock',
-        },
-        'hodl_vault_lock': {
-          'lockingType': 'p2sh32',
-          'name': 'hodl_vault_lock',
-          'script': '// "HodlVault" contract constructor parameters\n<price_target> // int = <0x3075>\n<min_block> // int = <0xb88201>\n<oracle_pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<owner_pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
-        },
-      },
     },
   },
   // TODO: Make it work with different hashtypes and signature algorithms
@@ -996,28 +996,28 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'p2_pkh_parameters': {
+        'P2PKH_parameters': {
           'description': 'Contract creation and function parameters',
-          'name': 'p2_pkh_parameters',
+          'name': 'P2PKH_parameters',
           'scripts': [
-            'p2_pkh_lock',
-            'p2_pkh_unlock',
+            'P2PKH_lock',
+            'P2PKH_unlock',
             'p2pkh_placeholder_lock_0',
             'p2pkh_placeholder_unlock_0',
             'p2pkh_placeholder_lock_2',
             'p2pkh_placeholder_unlock_2',
           ],
           'variables': {
-            's': {
-              'description': '"s" parameter of function "spend"',
-              'name': 's',
-              'type': 'Key',
-            },
             'pk': {
               'description': '"pk" parameter of function "spend"',
               'name': 'pk',
               'type': 'WalletData',
             },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
             'pkh': {
               'description': '"pkh" parameter of this contract',
               'name': 'pkh',
@@ -1036,16 +1036,51 @@ export const fixtures: Fixture[] = [
           },
         },
       },
+      'scripts': {
+        'P2PKH_unlock': {
+          'passes': [
+            'P2PKH_evaluate',
+          ],
+          'name': 'P2PKH_unlock',
+          'script': '// "spend" function parameters\n<s.ecdsa_signature.no_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
+        'P2PKH_lock': {
+          'lockingType': 'p2sh20',
+          'name': 'P2PKH_lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+        'p2pkh_placeholder_unlock_0': {
+          'name': 'p2pkh_placeholder_unlock_0',
+          'script': '<placeholder_key_0.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_0.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock_0',
+        },
+        'p2pkh_placeholder_lock_0': {
+          'lockingType': 'standard',
+          'name': 'p2pkh_placeholder_lock_0',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_0.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+        },
+        'p2pkh_placeholder_unlock_2': {
+          'name': 'p2pkh_placeholder_unlock_2',
+          'script': '<placeholder_key_2.ecdsa_signature.all_outputs>\n<placeholder_key_2.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock_2',
+        },
+        'p2pkh_placeholder_lock_2': {
+          'lockingType': 'standard',
+          'name': 'p2pkh_placeholder_lock_2',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_2.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+        },
+      },
       'scenarios': {
-        'p2_pkh_evaluate': {
-          'name': 'p2_pkh_evaluate',
+        'P2PKH_evaluate': {
+          'name': 'P2PKH_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
               'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
               'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
             },
-            'currentBlockHeight': 2,
+            'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
@@ -1143,41 +1178,6 @@ export const fixtures: Fixture[] = [
           ],
         },
       },
-      'scripts': {
-        'p2_pkh_unlock': {
-          'passes': [
-            'p2_pkh_evaluate',
-          ],
-          'name': 'p2_pkh_unlock',
-          'script': '// "spend" function parameters\n<s.ecdsa_signature.no_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'p2_pkh_lock',
-        },
-        'p2_pkh_lock': {
-          'lockingType': 'p2sh20',
-          'name': 'p2_pkh_lock',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
-        },
-        'p2pkh_placeholder_unlock_0': {
-          'name': 'p2pkh_placeholder_unlock_0',
-          'script': '<placeholder_key_0.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_0.public_key>',
-          'unlocks': 'p2pkh_placeholder_lock_0',
-        },
-        'p2pkh_placeholder_lock_0': {
-          'lockingType': 'standard',
-          'name': 'p2pkh_placeholder_lock_0',
-          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_0.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
-        },
-        'p2pkh_placeholder_unlock_2': {
-          'name': 'p2pkh_placeholder_unlock_2',
-          'script': '<placeholder_key_2.ecdsa_signature.all_outputs>\n<placeholder_key_2.public_key>',
-          'unlocks': 'p2pkh_placeholder_lock_2',
-        },
-        'p2pkh_placeholder_lock_2': {
-          'lockingType': 'standard',
-          'name': 'p2pkh_placeholder_lock_2',
-          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_2.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
-        },
-      },
     },
   },
 ];
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index 9e65b574..9dc704dd 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -67,97 +67,97 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'bar_parameters_input3': {
+        'Bar_parameters_input3': {
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #3)',
           'scripts': [
-            'bar_lock',
-            'bar_func_a_input3_unlock',
+            'Bar_lock',
+            'Bar_funcA_input3_unlock',
           ],
           'variables': {
             'pkh_bar': {
               'description': '"pkh_bar" parameter of this contract',
-              'name': 'Pkh Bar',
+              'name': 'pkh_bar',
               'type': 'WalletData',
             },
             'function_index': {
               'description': 'Script function index to execute',
-              'name': 'Function Index',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
-        'bar_parameters_input4': {
+        'Bar_parameters_input4': {
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #4)',
           'scripts': [
-            'bar_lock',
-            'bar_execute_input4_unlock',
+            'Bar_lock',
+            'Bar_execute_input4_unlock',
           ],
           'variables': {
-            'pkh_bar': {
-              'description': '"pkh_bar" parameter of this contract',
-              'name': 'Pkh Bar',
-              'type': 'WalletData',
-            },
             'pk': {
               'description': '"pk" parameter of function "execute"',
-              'name': 'Pk',
+              'name': 'pk',
               'type': 'WalletData',
             },
             's': {
               'description': '"s" parameter of function "execute"',
-              'name': 'S',
+              'name': 's',
               'type': 'Key',
             },
-            'function_index': {
-              'description': 'Script function index to execute',
-              'name': 'Function Index',
-              'type': 'WalletData',
-            },
-          },
-        },
-        'bar_parameters_input6': {
-          'description': 'Contract creation and function parameters',
-          'name': 'Bar (input #6)',
-          'scripts': [
-            'bar_lock',
-            'bar_func_b_input6_unlock',
-          ],
-          'variables': {
             'pkh_bar': {
               'description': '"pkh_bar" parameter of this contract',
-              'name': 'Pkh Bar',
+              'name': 'pkh_bar',
               'type': 'WalletData',
             },
             'function_index': {
               'description': 'Script function index to execute',
-              'name': 'Function Index',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
-        'foo_parameters_input5': {
+        'Foo_parameters_input5': {
           'description': 'Contract creation and function parameters',
           'name': 'Foo (input #5)',
           'scripts': [
-            'foo_lock',
-            'foo_execute_input5_unlock',
+            'Foo_lock',
+            'Foo_execute_input5_unlock',
           ],
           'variables': {
             'pk': {
               'description': '"pk" parameter of function "execute"',
-              'name': 'Pk',
+              'name': 'pk',
               'type': 'WalletData',
             },
             's': {
               'description': '"s" parameter of function "execute"',
-              'name': 'S',
+              'name': 's',
               'type': 'Key',
             },
             'pkh_foo': {
               'description': '"pkh_foo" parameter of this contract',
-              'name': 'Pkh Foo',
+              'name': 'pkh_foo',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'Bar_parameters_input6': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Bar (input #6)',
+          'scripts': [
+            'Bar_lock',
+            'Bar_funcB_input6_unlock',
+          ],
+          'variables': {
+            'pkh_bar': {
+              'description': '"pkh_bar" parameter of this contract',
+              'name': 'pkh_bar',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
@@ -209,47 +209,47 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'bar_func_a_input3_unlock': {
+        'Bar_funcA_input3_unlock': {
           'passes': [
-            'bar_func_a_evaluate',
+            'Bar_funcA_evaluate',
           ],
           'name': 'funcA (input #3)',
           'script': '// "funcA" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'bar_lock',
+          'unlocks': 'Bar_lock',
         },
-        'bar_lock': {
+        'Bar_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
           'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
         },
-        'bar_execute_input4_unlock': {
+        'Bar_execute_input4_unlock': {
           'passes': [
-            'bar_execute_evaluate',
+            'Bar_execute_evaluate',
           ],
           'name': 'execute (input #4)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// function index in contract\n<function_index> // int = <2>\n',
-          'unlocks': 'bar_lock',
+          'unlocks': 'Bar_lock',
         },
-        'foo_execute_input5_unlock': {
+        'Foo_execute_input5_unlock': {
           'passes': [
-            'foo_execute_evaluate',
+            'Foo_execute_evaluate',
           ],
           'name': 'execute (input #5)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n',
-          'unlocks': 'foo_lock',
+          'unlocks': 'Foo_lock',
         },
-        'foo_lock': {
+        'Foo_lock': {
           'lockingType': 'p2sh32',
           'name': 'Foo',
           'script': "// \"Foo\" contract constructor parameters\n<pkh_foo> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                                  */\n                                                        /*                                                              */\n                                                        /* contract Foo(bytes20 pkh_foo) {                              */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function execute(pubkey pk, sig s) {                     */\n                                                        /*         console.log('Foo 'execute' function called.');       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_foo);                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */",
         },
-        'bar_func_b_input6_unlock': {
+        'Bar_funcB_input6_unlock': {
           'passes': [
-            'bar_func_b_evaluate',
+            'Bar_funcB_evaluate',
           ],
           'name': 'funcB (input #6)',
           'script': '// "funcB" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'bar_lock',
+          'unlocks': 'Bar_lock',
         },
         'p2pkh_placeholder_unlock_0': {
           'name': 'P2PKH Unlock (input #0)',
@@ -283,8 +283,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'bar_func_a_evaluate': {
-          'name': 'bar_func_a_evaluate',
+        'Bar_funcA_evaluate': {
+          'name': 'Bar_funcA_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -375,7 +375,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'foo_lock',
+                  'script': 'Foo_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -459,7 +459,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -470,7 +470,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'foo_lock',
+                'script': 'Foo_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -481,7 +481,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -492,8 +492,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'bar_execute_evaluate': {
-          'name': 'bar_execute_evaluate',
+        'Bar_execute_evaluate': {
+          'name': 'Bar_execute_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -587,7 +587,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'foo_lock',
+                  'script': 'Foo_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -665,7 +665,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -682,7 +682,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'foo_lock',
+                'script': 'Foo_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -693,7 +693,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -704,8 +704,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'foo_execute_evaluate': {
-          'name': 'foo_execute_evaluate',
+        'Foo_execute_evaluate': {
+          'name': 'Foo_execute_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -798,7 +798,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'foo_lock',
+                  'script': 'Foo_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -876,7 +876,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -887,7 +887,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -904,7 +904,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -915,8 +915,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'bar_func_b_evaluate': {
-          'name': 'bar_func_b_evaluate',
+        'Bar_funcB_evaluate': {
+          'name': 'Bar_funcB_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1007,7 +1007,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'foo_lock',
+                  'script': 'Foo_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -1085,7 +1085,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1096,7 +1096,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1107,7 +1107,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'foo_lock',
+                'script': 'Foo_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -1151,45 +1151,45 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'bar_parameters': {
+        'Bar_parameters_input0': {
           'description': 'Contract creation and function parameters',
-          'name': 'Bar',
+          'name': 'Bar (input #0)',
           'scripts': [
-            'bar_lock',
-            'bar_func_a_unlock',
+            'Bar_lock',
+            'Bar_funcA_input0_unlock',
           ],
           'variables': {
             'pkh_bar': {
               'description': '"pkh_bar" parameter of this contract',
-              'name': 'Pkh Bar',
+              'name': 'pkh_bar',
               'type': 'WalletData',
             },
             'function_index': {
               'description': 'Script function index to execute',
-              'name': 'Function Index',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
       },
       'scripts': {
-        'bar_func_a_unlock': {
+        'Bar_funcA_input0_unlock': {
           'passes': [
-            'bar_func_a_evaluate',
+            'Bar_funcA_evaluate',
           ],
-          'name': 'funcA',
+          'name': 'funcA (input #0)',
           'script': '// "funcA" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'bar_lock',
+          'unlocks': 'Bar_lock',
         },
-        'bar_lock': {
+        'Bar_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
           'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
         },
       },
       'scenarios': {
-        'bar_func_a_evaluate': {
-          'name': 'bar_func_a_evaluate',
+        'Bar_funcA_evaluate': {
+          'name': 'Bar_funcA_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1217,7 +1217,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'bar_lock',
+                  'script': 'Bar_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1272,133 +1272,133 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'hodl_vault_parameters': {
+        'HodlVault_parameters_input0': {
           'description': 'Contract creation and function parameters',
-          'name': 'Hodl Vault',
+          'name': 'HodlVault (input #0)',
           'scripts': [
-            'hodl_vault_lock',
-            'hodl_vault_spend_unlock',
+            'HodlVault_lock',
+            'HodlVault_spend_input0_unlock',
           ],
           'variables': {
-            'owner_sig': {
+            'ownerSig': {
               'description': '"ownerSig" parameter of function "spend"',
-              'name': 'Owner Sig',
+              'name': 'ownerSig',
               'type': 'Key',
             },
-            'oracle_sig': {
+            'oracleSig': {
               'description': '"oracleSig" parameter of function "spend"',
-              'name': 'Oracle Sig',
+              'name': 'oracleSig',
               'type': 'WalletData',
             },
-            'oracle_message': {
+            'oracleMessage': {
               'description': '"oracleMessage" parameter of function "spend"',
-              'name': 'Oracle Message',
+              'name': 'oracleMessage',
               'type': 'WalletData',
             },
-            'owner_pk': {
+            'ownerPk': {
               'description': '"ownerPk" parameter of this contract',
-              'name': 'Owner Pk',
+              'name': 'ownerPk',
               'type': 'WalletData',
             },
-            'oracle_pk': {
+            'oraclePk': {
               'description': '"oraclePk" parameter of this contract',
-              'name': 'Oracle Pk',
+              'name': 'oraclePk',
               'type': 'WalletData',
             },
-            'min_block': {
+            'minBlock': {
               'description': '"minBlock" parameter of this contract',
-              'name': 'Min Block',
+              'name': 'minBlock',
               'type': 'WalletData',
             },
-            'price_target': {
+            'priceTarget': {
               'description': '"priceTarget" parameter of this contract',
-              'name': 'Price Target',
+              'name': 'priceTarget',
               'type': 'WalletData',
             },
           },
         },
-        'transfer_with_timeout_parameters': {
+        'TransferWithTimeout_parameters_input1': {
           'description': 'Contract creation and function parameters',
-          'name': 'Transfer With Timeout',
+          'name': 'TransferWithTimeout (input #1)',
           'scripts': [
-            'transfer_with_timeout_lock',
-            'transfer_with_timeout_timeout_unlock',
+            'TransferWithTimeout_lock',
+            'TransferWithTimeout_timeout_input1_unlock',
           ],
           'variables': {
-            'sender_sig': {
+            'senderSig': {
               'description': '"senderSig" parameter of function "timeout"',
-              'name': 'Sender Sig',
+              'name': 'senderSig',
               'type': 'Key',
             },
             'sender': {
               'description': '"sender" parameter of this contract',
-              'name': 'Sender',
+              'name': 'sender',
               'type': 'WalletData',
             },
             'recipient': {
               'description': '"recipient" parameter of this contract',
-              'name': 'Recipient',
+              'name': 'recipient',
               'type': 'WalletData',
             },
             'timeout': {
               'description': '"timeout" parameter of this contract',
-              'name': 'Timeout',
+              'name': 'timeout',
               'type': 'WalletData',
             },
             'function_index': {
               'description': 'Script function index to execute',
-              'name': 'Function Index',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
       },
       'scripts': {
-        'hodl_vault_spend_unlock': {
+        'HodlVault_spend_input0_unlock': {
           'passes': [
-            'hodl_vault_spend_evaluate',
+            'HodlVault_spend_evaluate',
           ],
-          'name': 'spend',
-          'script': '// "spend" function parameters\n<oracle_message> // bytes8 = <0xa086010030750000>\n<oracle_sig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<owner_sig.schnorr_signature.all_outputs_all_utxos> // sig\n',
-          'unlocks': 'hodl_vault_lock',
+          'name': 'spend (input #0)',
+          'script': '// "spend" function parameters\n<oracleMessage> // bytes8 = <0xa086010030750000>\n<oracleSig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<ownerSig.schnorr_signature.all_outputs_all_utxos> // sig\n',
+          'unlocks': 'HodlVault_lock',
         },
-        'hodl_vault_lock': {
+        'HodlVault_lock': {
           'lockingType': 'p2sh32',
           'name': 'HodlVault',
-          'script': '// "HodlVault" contract constructor parameters\n<price_target> // int = <0x3075>\n<min_block> // int = <0xb88201>\n<oracle_pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<owner_pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
+          'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
         },
-        'transfer_with_timeout_timeout_unlock': {
+        'TransferWithTimeout_timeout_input1_unlock': {
           'passes': [
-            'transfer_with_timeout_timeout_evaluate',
+            'TransferWithTimeout_timeout_evaluate',
           ],
-          'name': 'timeout',
-          'script': '// "timeout" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'transfer_with_timeout_lock',
+          'name': 'timeout (input #1)',
+          'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'TransferWithTimeout_lock',
         },
-        'transfer_with_timeout_lock': {
+        'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
         },
       },
       'scenarios': {
-        'hodl_vault_spend_evaluate': {
-          'name': 'hodl_vault_spend_evaluate',
+        'HodlVault_spend_evaluate': {
+          'name': 'HodlVault_spend_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
-              'oracle_sig': '0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b',
-              'oracle_message': '0xa086010030750000',
-              'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
-              'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
-              'min_block': '0xb88201',
-              'price_target': '0x3075',
+              'oracleSig': '0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b',
+              'oracleMessage': '0xa086010030750000',
+              'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'oraclePk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'minBlock': '0xb88201',
+              'priceTarget': '0x3075',
             },
             'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                'owner_sig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                'ownerSig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
               },
             },
           },
@@ -1423,13 +1423,13 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'hodl_vault_lock',
+                  'script': 'HodlVault_lock',
                   'overrides': {
                     'bytecode': {
-                      'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
-                      'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
-                      'min_block': '0xb88201',
-                      'price_target': '0x3075',
+                      'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'oraclePk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'minBlock': '0xb88201',
+                      'priceTarget': '0x3075',
                     },
                   },
                 },
@@ -1447,7 +1447,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1460,8 +1460,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'transfer_with_timeout_timeout_evaluate': {
-          'name': 'transfer_with_timeout_timeout_evaluate',
+        'TransferWithTimeout_timeout_evaluate': {
+          'name': 'TransferWithTimeout_timeout_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1474,7 +1474,7 @@ export const fixtures: Fixture[] = [
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                'sender_sig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                'senderSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
               },
             },
           },
@@ -1499,13 +1499,13 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'hodl_vault_lock',
+                  'script': 'HodlVault_lock',
                   'overrides': {
                     'bytecode': {
-                      'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
-                      'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
-                      'min_block': '0xb88201',
-                      'price_target': '0x3075',
+                      'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'oraclePk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'minBlock': '0xb88201',
+                      'priceTarget': '0x3075',
                     },
                   },
                 },
@@ -1517,13 +1517,13 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'hodl_vault_lock',
+                'script': 'HodlVault_lock',
                 'overrides': {
                   'bytecode': {
-                    'owner_pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
-                    'oracle_pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
-                    'min_block': '0xb88201',
-                    'price_target': '0x3075',
+                    'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                    'oraclePk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                    'minBlock': '0xb88201',
+                    'priceTarget': '0x3075',
                   },
                 },
               },
@@ -1571,189 +1571,189 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'transfer_with_timeout_parameters_input0': {
+        'TransferWithTimeout_parameters_input0': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #0)',
           'scripts': [
-            'transfer_with_timeout_lock',
-            'transfer_with_timeout_timeout_input0_unlock',
+            'TransferWithTimeout_lock',
+            'TransferWithTimeout_timeout_input0_unlock',
           ],
           'variables': {
-            'sender_sig': {
+            'senderSig': {
               'description': '"senderSig" parameter of function "timeout"',
-              'name': 'Sender Sig',
+              'name': 'senderSig',
               'type': 'Key',
             },
             'sender': {
               'description': '"sender" parameter of this contract',
-              'name': 'Sender',
+              'name': 'sender',
               'type': 'WalletData',
             },
             'recipient': {
               'description': '"recipient" parameter of this contract',
-              'name': 'Recipient',
+              'name': 'recipient',
               'type': 'WalletData',
             },
             'timeout': {
               'description': '"timeout" parameter of this contract',
-              'name': 'Timeout',
+              'name': 'timeout',
               'type': 'WalletData',
             },
             'function_index': {
               'description': 'Script function index to execute',
-              'name': 'Function Index',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
-        'transfer_with_timeout_parameters_input1': {
+        'TransferWithTimeout_parameters_input1': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #1)',
           'scripts': [
-            'transfer_with_timeout_lock',
-            'transfer_with_timeout_timeout_input1_unlock',
+            'TransferWithTimeout_lock',
+            'TransferWithTimeout_timeout_input1_unlock',
           ],
           'variables': {
-            'sender_sig': {
+            'senderSig': {
               'description': '"senderSig" parameter of function "timeout"',
-              'name': 'Sender Sig',
+              'name': 'senderSig',
               'type': 'Key',
             },
             'sender': {
               'description': '"sender" parameter of this contract',
-              'name': 'Sender',
+              'name': 'sender',
               'type': 'WalletData',
             },
             'recipient': {
               'description': '"recipient" parameter of this contract',
-              'name': 'Recipient',
+              'name': 'recipient',
               'type': 'WalletData',
             },
             'timeout': {
               'description': '"timeout" parameter of this contract',
-              'name': 'Timeout',
+              'name': 'timeout',
               'type': 'WalletData',
             },
             'function_index': {
               'description': 'Script function index to execute',
-              'name': 'Function Index',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
-        'transfer_with_timeout_parameters_input2': {
+        'TransferWithTimeout_parameters_input2': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #2)',
           'scripts': [
-            'transfer_with_timeout_lock',
-            'transfer_with_timeout_transfer_input2_unlock',
+            'TransferWithTimeout_lock',
+            'TransferWithTimeout_transfer_input2_unlock',
           ],
           'variables': {
-            'recipient_sig': {
+            'recipientSig': {
               'description': '"recipientSig" parameter of function "transfer"',
-              'name': 'Recipient Sig',
+              'name': 'recipientSig',
               'type': 'Key',
             },
             'sender': {
               'description': '"sender" parameter of this contract',
-              'name': 'Sender',
+              'name': 'sender',
               'type': 'WalletData',
             },
             'recipient': {
               'description': '"recipient" parameter of this contract',
-              'name': 'Recipient',
+              'name': 'recipient',
               'type': 'WalletData',
             },
             'timeout': {
               'description': '"timeout" parameter of this contract',
-              'name': 'Timeout',
+              'name': 'timeout',
               'type': 'WalletData',
             },
             'function_index': {
               'description': 'Script function index to execute',
-              'name': 'Function Index',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
-        'transfer_with_timeout_parameters_input3': {
+        'TransferWithTimeout_parameters_input3': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #3)',
           'scripts': [
-            'transfer_with_timeout_lock',
-            'transfer_with_timeout_transfer_input3_unlock',
+            'TransferWithTimeout_lock',
+            'TransferWithTimeout_transfer_input3_unlock',
           ],
           'variables': {
-            'recipient_sig': {
+            'recipientSig': {
               'description': '"recipientSig" parameter of function "transfer"',
-              'name': 'Recipient Sig',
+              'name': 'recipientSig',
               'type': 'Key',
             },
             'sender': {
               'description': '"sender" parameter of this contract',
-              'name': 'Sender',
+              'name': 'sender',
               'type': 'WalletData',
             },
             'recipient': {
               'description': '"recipient" parameter of this contract',
-              'name': 'Recipient',
+              'name': 'recipient',
               'type': 'WalletData',
             },
             'timeout': {
               'description': '"timeout" parameter of this contract',
-              'name': 'Timeout',
+              'name': 'timeout',
               'type': 'WalletData',
             },
             'function_index': {
               'description': 'Script function index to execute',
-              'name': 'Function Index',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
       },
       'scripts': {
-        'transfer_with_timeout_timeout_input0_unlock': {
+        'TransferWithTimeout_timeout_input0_unlock': {
           'passes': [
-            'transfer_with_timeout_timeout_evaluate',
+            'TransferWithTimeout_timeout_evaluate',
           ],
           'name': 'timeout (input #0)',
-          'script': '// "timeout" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'transfer_with_timeout_lock',
+          'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'TransferWithTimeout_lock',
         },
-        'transfer_with_timeout_lock': {
+        'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
         },
-        'transfer_with_timeout_timeout_input1_unlock': {
+        'TransferWithTimeout_timeout_input1_unlock': {
           'passes': [
-            'transfer_with_timeout_timeout_evaluate1',
+            'TransferWithTimeout_timeout_evaluate1',
           ],
           'name': 'timeout (input #1)',
-          'script': '// "timeout" function parameters\n<sender_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'transfer_with_timeout_lock',
+          'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'TransferWithTimeout_lock',
         },
-        'transfer_with_timeout_transfer_input2_unlock': {
+        'TransferWithTimeout_transfer_input2_unlock': {
           'passes': [
-            'transfer_with_timeout_transfer_evaluate',
+            'TransferWithTimeout_transfer_evaluate',
           ],
           'name': 'transfer (input #2)',
-          'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'transfer_with_timeout_lock',
+          'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'TransferWithTimeout_lock',
         },
-        'transfer_with_timeout_transfer_input3_unlock': {
+        'TransferWithTimeout_transfer_input3_unlock': {
           'passes': [
-            'transfer_with_timeout_transfer_evaluate1',
+            'TransferWithTimeout_transfer_evaluate1',
           ],
           'name': 'transfer (input #3)',
-          'script': '// "transfer" function parameters\n<recipient_sig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'transfer_with_timeout_lock',
+          'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'TransferWithTimeout_lock',
         },
       },
       'scenarios': {
-        'transfer_with_timeout_timeout_evaluate': {
-          'name': 'transfer_with_timeout_timeout_evaluate',
+        'TransferWithTimeout_timeout_evaluate': {
+          'name': 'TransferWithTimeout_timeout_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1766,7 +1766,7 @@ export const fixtures: Fixture[] = [
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                'sender_sig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                'senderSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
               },
             },
           },
@@ -1803,7 +1803,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'transfer_with_timeout_lock',
+                  'script': 'TransferWithTimeout_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1826,7 +1826,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1839,7 +1839,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1852,7 +1852,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1865,8 +1865,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'transfer_with_timeout_timeout_evaluate1': {
-          'name': 'transfer_with_timeout_timeout_evaluate',
+        'TransferWithTimeout_timeout_evaluate1': {
+          'name': 'TransferWithTimeout_timeout_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1879,7 +1879,7 @@ export const fixtures: Fixture[] = [
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                'sender_sig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+                'senderSig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
               },
             },
           },
@@ -1916,7 +1916,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'transfer_with_timeout_lock',
+                  'script': 'TransferWithTimeout_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1933,7 +1933,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1952,7 +1952,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1965,7 +1965,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1978,8 +1978,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'transfer_with_timeout_transfer_evaluate': {
-          'name': 'transfer_with_timeout_transfer_evaluate',
+        'TransferWithTimeout_transfer_evaluate': {
+          'name': 'TransferWithTimeout_transfer_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1992,7 +1992,7 @@ export const fixtures: Fixture[] = [
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                'recipient_sig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+                'recipientSig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
               },
             },
           },
@@ -2029,7 +2029,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'transfer_with_timeout_lock',
+                  'script': 'TransferWithTimeout_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2046,7 +2046,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2059,7 +2059,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2078,7 +2078,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2091,8 +2091,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'transfer_with_timeout_transfer_evaluate1': {
-          'name': 'transfer_with_timeout_transfer_evaluate',
+        'TransferWithTimeout_transfer_evaluate1': {
+          'name': 'TransferWithTimeout_transfer_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -2105,7 +2105,7 @@ export const fixtures: Fixture[] = [
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
-                'recipient_sig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                'recipientSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
               },
             },
           },
@@ -2142,7 +2142,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'transfer_with_timeout_lock',
+                  'script': 'TransferWithTimeout_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2159,7 +2159,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2172,7 +2172,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2185,7 +2185,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'transfer_with_timeout_lock',
+                'script': 'TransferWithTimeout_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2234,55 +2234,93 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'bar_parameters': {
+        'Bar_parameters_input0': {
           'description': 'Contract creation and function parameters',
-          'name': 'Bar',
+          'name': 'Bar (input #0)',
           'scripts': [
-            'bar_lock',
-            'bar_execute_input4_unlock',
+            'Bar_lock',
+            'Bar_execute_input0_unlock',
           ],
           'variables': {
             'pk': {
               'description': '"pk" parameter of function "execute"',
-              'name': 'Pk',
+              'name': 'pk',
               'type': 'WalletData',
             },
             's': {
               'description': '"s" parameter of function "execute"',
-              'name': 'S',
+              'name': 's',
               'type': 'Key',
             },
             'pkh_bar': {
               'description': '"pkh_bar" parameter of this contract',
-              'name': 'Pkh Bar',
+              'name': 'pkh_bar',
               'type': 'WalletData',
             },
             'function_index': {
               'description': 'Script function index to execute',
-              'name': 'Function Index',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'Bar_parameters_input1': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Bar (input #1)',
+          'scripts': [
+            'Bar_lock',
+            'Bar_execute_input1_unlock',
+          ],
+          'variables': {
+            'pk': {
+              'description': '"pk" parameter of function "execute"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "execute"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pkh_bar': {
+              'description': '"pkh_bar" parameter of this contract',
+              'name': 'pkh_bar',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
               'type': 'WalletData',
             },
           },
         },
       },
       'scripts': {
-        'bar_execute_input4_unlock': {
+        'Bar_execute_input0_unlock': {
           'passes': [
-            'bar_execute_evaluate',
+            'Bar_execute_evaluate',
           ],
-          'name': 'execute',
-          'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// function index in contract\n<function_index> // int = <2>\n',
-          'unlocks': 'bar_lock',
+          'name': 'execute (input #0)',
+          'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// function index in contract\n<function_index> // int = <2>\n',
+          'unlocks': 'Bar_lock',
         },
-        'bar_lock': {
+        'Bar_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
           'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
         },
+        'Bar_execute_input1_unlock': {
+          'passes': [
+            'Bar_execute_evaluate1',
+          ],
+          'name': 'execute (input #1)',
+          'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// function index in contract\n<function_index> // int = <2>\n',
+          'unlocks': 'Bar_lock',
+        },
       },
       'scenarios': {
-        'bar_execute_evaluate': {
-          'name': 'bar_execute_evaluate',
+        'Bar_execute_evaluate': {
+          'name': 'Bar_execute_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -2319,7 +2357,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'bar_lock',
+                  'script': 'Bar_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -2340,7 +2378,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -2351,8 +2389,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'bar_execute_evaluate1': {
-          'name': 'bar_execute_evaluate',
+        'Bar_execute_evaluate1': {
+          'name': 'Bar_execute_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -2389,7 +2427,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'bar_lock',
+                  'script': 'Bar_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -2404,7 +2442,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'bar_lock',
+                'script': 'Bar_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',

From 463b41500cb4949b2b45047c8d31d8af7417ff70 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 27 Mar 2025 09:01:41 +0100
Subject: [PATCH 209/267] add standard outputs to transaction limits docs

---
 website/docs/compiler/script-limits.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/website/docs/compiler/script-limits.md b/website/docs/compiler/script-limits.md
index acc2e4aa..c83c6718 100644
--- a/website/docs/compiler/script-limits.md
+++ b/website/docs/compiler/script-limits.md
@@ -22,6 +22,10 @@ To keep contracts within size limits, consider modular design. Splitting contrac
 
 NFT commitments can store up to 40 bytes of data as local state. If more data is needed, you can hash the full state and store only the hash in the commitment data. Later, when required, the full state must be provided and validated against the stored hash.
 
+:::caution
+The 40-bytes limit on commitment length is of great practical importance for contract authors. Workarounds are needed to keep more bytes of local state in smart contracts.
+:::
+
 ### Operation cost limit
 
 Bitcoin Cash enforces an operation cost limit (op-cost) per transaction input. This determines the computational budget available for operations in a contract. The op-cost is based on script length: longer input scripts allow for a higher compute budget.
@@ -70,6 +74,16 @@ function calculateDust(outputSize: number): number {
 Before CashTokens `546` bytes was often used as good default value, however with tokenData outputs have become larger in size.
 For ease of development, it is standard practice to use 1,000 satoshis as dust to outputs. Provably unspendable outputs (OP_RETURN outputs) are exempt from this rule.
 
+### Output Standardness
+
+Bitcoin Cash only allows a few types of `lockingbytecode` scripts for outputs in the normal network relay rules. These are called 'standard outputs', contrasted to 'non-standard outputs' which cause the transaction not to relay on the network.
+
+There's 4 types of standard output types: `P2PKH`, `P2SH` (which includes `P2SH20` & `P2SH32`), `P2MS` and `OP_RETURN` data-outputs. For more details see the [standard outputs documentation][standard-outputs-docs].
+
+:::caution
+The `lockingbytecode` standardness rules can be important for smart contract developers, and is why CashScript has helpers like `LockingBytecodeP2PKH`, `LockingBytecodeP2SH32` and `LockingBytecodeNullData`.
+:::
+
 ## Summary table
 
 | Limit type | Constraint |
@@ -81,7 +95,9 @@ For ease of development, it is standard practice to use 1,000 satoshis as dust t
 | Max transaction size | 100,000 bytes |
 | Max OP_RETURN data size | 220 bytes data payload |
 | Dust threshold | based on output size (commonly 1,000 sats is used as dust) |
+| Output Standardness | `P2PKH`, `P2SH` (incl. `P2SH20` & `P2SH32`), `P2MS` and `OP_RETURN` data-outputs|
 
 For further details on transaction validation and standardness rules, see the [documentation on BCH transaction validation](https://documentation.cash/protocol/blockchain/transaction-validation.html).
 
 [op-cost-table]: https://github.com/bitjson/bch-vm-limits/blob/master/operation-costs.md
+[standard-outputs-docs]: https://documentation.cash/protocol/blockchain/transaction/locking-script.html

From 16a528aa1215fca35b2ed427783fcbf61eee4fd3 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 27 Mar 2025 09:54:21 +0100
Subject: [PATCH 210/267] add to type casting docs

---
 website/docs/language/types.md | 49 +++++++++++++++++++++-------------
 1 file changed, 30 insertions(+), 19 deletions(-)

diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index cbbdc46c..1431aaa5 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -153,7 +153,16 @@ require(hello + "world" == "Hello " + world);
 ```
 
 ## Type Casting
-Type casting can be done both explicitly and implicitly as illustrated below. `pubkey`, `sig` and `datasig` can be implicitly cast to `bytes`, meaning they can be used anywhere where you would normally use a `bytes` type. Explicit type casting can be done with a broader range of types, but is still limited. The syntax of this explicit type casting is illustrated below. Note that you can also cast to bounded `bytes` types.
+Type casting can be done both explicitly and implicitly depending on the type. `pubkey`, `sig` and `datasig` can be implicitly cast to `bytes`, meaning they can be used anywhere where you would normally use a `bytes` type. Explicit type casting can be done with a broader range of types, but is still limited. The syntax of this explicit type casting is illustrated below:
+
+#### Example
+```solidity
+pubkey pk = pubkey(0x0000);
+bytes editedPk = bytes(pk) + 0x1234;
+bytes4 zeroBytes = bytes4(0); // 0x00000000
+```
+
+### Casting Table
 
 See the following table for information on which types can be cast to other which other types.
 
@@ -167,44 +176,46 @@ See the following table for information on which types can be cast to other whic
 | sig     | bytes                  | bytes                              |
 | datasig | bytes                  | bytes                              |
 
-#### Example
-```solidity
-pubkey pk = pubkey(0x0000);
-bytes editedPk = bytes(pk) + 0x1234;
-bytes4 integer = bytes4(25);
-```
-
 ### Int to Byte Casting
 
-When casting integer types to bytes of a certain size, the integer value is padded with zeros, e.g. `bytes4(0) == 0x00000000`. It is also possible to pad with a variable number of zeros by passing in a `size` parameter, which indicates the size of the output, e.g. `bytes(0, 4 - 2) == 0x0000`. The size casting can be a very important feature when keeping local state in an nftCommitment or in the simulated state.
+When casting integer types to bytes of a certain size, the integer value is padded with zeros, e.g. `bytes4(0) == 0x00000000`. It is also possible to pad with a variable number of zeros by passing in a `size` parameter, which indicates the size of the output, e.g. `bytes(0, 4 - 2) == 0x0000`.
 
 :::tip
 Using `bytes20 placeholderPkh= bytes20(0)` will generate a 20 byte zero-array programmatically, whereas 
 `bytes20 placeholderPkh= 0x0000000000000000000000000000000000000000` will actually take 20 bytes of space in your contract.
 :::
 
-:::note
+Casting an integer to a fixed-size byte-length can be a very important when storing local state in an nftCommitment. Developers need to consider what the preferable fixed-size length is for each indivual case depending on the interger range. Below we add a table with information on the maximum integer size for satoshis and fungible CashTokens:
+
+| Integer Type    | Maximum amount         | Max Byte Size                      |
+| --------------  | ---------------------- | ---------------------------------- |
+| Satoshis        | 2.1 quadrillion        | 6 bytes (5 bytes for 1 quadrillion)|
+| CashTokens      | 9223 quadrillion       | 8 bytes for max supply token       |
+
+:::info
 VM numbers follow Script Number format (A.K.A. CSCriptNum), to convert VM number to bytes or the reverse, it's recommended to use helper functions for these conversions from libraries like Libauth.
 :::
 
-### Semantic Byte Casting
+### Bytes to BytesX Casting
 
-When casting unbounded `bytes` types to bounded `bytes` types (such as `bytes20` or `bytes32`), this is a purely semantic cast. The bytes are not padded with zeros, and no checks are performed to ensure the cast bytes are of the correct length. This can be helpful in certain cases, such as `LockingBytecode`, which expects a specific length input.
+If you do need to pad bytes to a specific length, you can convert the bytes to `int` first, and then cast to the bounded `bytes` type. This will pad the bytes with zeros to the specified length, like specified in the *Int to Byte Casting* section above.
 
 #### Example
 ```solidity
-bytes pkh = nftCommitment.split(20)[0]; // (type = bytes, content = 20 bytes)
-bytes20 bytes20Pkh = bytes20(pkh); // (type = bytes20, content = 20 bytes)
-bytes25 lockingBytecode = new LockingBytecodeP2PKH(bytes20Pkh);
+bytes data = nftCommitment.split(10)[0]; // (type = bytes, content = 10 bytes)
+bytes20 paddedData = bytes20(int(data)); // (type = bytes20, content = 20 bytes)
+require(storedContractState == paddedData);
 ```
 
-If you do need to pad bytes to a specific length, you can convert the bytes to `int` first, and then cast to the bounded `bytes` type. This will pad the bytes with zeros to the specified length, like specified in the *Int to Byte Casting* section above.
+### Semantic Byte Casting
+
+When casting unbounded `bytes` types to bounded `bytes` types (such as `bytes20` or `bytes32`), this is a purely semantic cast. The bytes are not padded with zeros, and no checks are performed to ensure the cast bytes are of the correct length. This can be helpful in certain cases, such as `LockingBytecode`, which expects a specific length input.
 
 #### Example
 ```solidity
-bytes data = nftCommitment.split(10)[0]; // (type = bytes, content = 10 bytes)
-bytes20 paddedData = bytes20(int(data)); // (type = bytes20, content = 20 bytes)
-require(storedContractState == paddedData);
+bytes pkh = nftCommitment.split(20)[0]; // (type = bytes, content = 20 bytes)
+bytes20 bytes20Pkh = bytes20(pkh); // (type = bytes20, content = 20 bytes)
+bytes25 lockingBytecode = new LockingBytecodeP2PKH(bytes20Pkh);
 ```
 
 ## Operators

From 8ffe2ae721c55994746537630a9b8fca4ce750c6 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Fri, 28 Mar 2025 10:17:09 +0100
Subject: [PATCH 211/267] update libauth-template fixtures to use
 TransactionBuilder (#290)

---
 .../test/fixture/libauth-template/fixtures.ts |  672 +++++++---
 .../fixture/libauth-template/old-fixtures.ts  | 1183 +++++++++++++++++
 .../libauth-template/LibauthTemplate.test.ts  |   14 +-
 3 files changed, 1672 insertions(+), 197 deletions(-)
 create mode 100644 packages/cashscript/test/fixture/libauth-template/old-fixtures.ts

diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index f5d370d8..7191d765 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -1,8 +1,8 @@
-import { Contract, HashType, MockNetworkProvider, SignatureAlgorithm, SignatureTemplate, Transaction, randomNFT, randomToken, randomUtxo } from '../../../src/index.js';
-import TransferWithTimeout from '../transfer_with_timeout.json' with { type: 'json' };
-import Mecenas from '../mecenas.json' with { type: 'json' };
-import P2PKH from '../p2pkh.json' with { type: 'json' };
-import HoldVault from '../hodl_vault.json' with { type: 'json' };
+import { Contract, HashType, MockNetworkProvider, SignatureAlgorithm, SignatureTemplate, TransactionBuilder, randomNFT, randomToken, randomUtxo } from '../../../src/index.js';
+import TransferWithTimeout from '../transfer_with_timeout.artifact.js';
+import Mecenas from '../mecenas.artifact.js';
+import P2PKH from '../p2pkh.artifact.js';
+import HoldVault from '../hodl_vault.artifact.js';
 import { aliceAddress, alicePkh, alicePriv, alicePub, bobPkh, bobPriv, bobPub, oracle, oraclePub } from '../vars.js';
 import { WalletTemplate, hexToBin } from '@bitauth/libauth';
 
@@ -10,7 +10,7 @@ const provider = new MockNetworkProvider();
 
 export interface Fixture {
   name: string;
-  transaction: Transaction;
+  transaction: TransactionBuilder;
   template: WalletTemplate;
 }
 
@@ -19,12 +19,12 @@ export const fixtures: Fixture[] = [
     name: 'TransferWithTimeout (transfer function)',
     transaction: (() => {
       const contract = new Contract(TransferWithTimeout, [alicePub, bobPub, 100000n], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const contractUtxo = randomUtxo();
+      provider.addUtxo(contract.address, contractUtxo);
 
-      const tx = contract.functions
-        .transfer(new SignatureTemplate(bobPriv))
-        .to(contract.address, 10000n)
-        .withoutChange();
+      const tx = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contract.unlock.transfer(new SignatureTemplate(bobPriv)))
+        .addOutput({ to: contract.address, amount: 10000n });
 
       return tx;
     })(),
@@ -37,12 +37,12 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'TransferWithTimeout_parameters': {
+        'TransferWithTimeout_parameters_input0': {
           'description': 'Contract creation and function parameters',
-          'name': 'TransferWithTimeout_parameters',
+          'name': 'TransferWithTimeout (input #0)',
           'scripts': [
             'TransferWithTimeout_lock',
-            'TransferWithTimeout_unlock',
+            'TransferWithTimeout_transfer_input0_unlock',
           ],
           'variables': {
             'recipientSig': {
@@ -74,23 +74,23 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'TransferWithTimeout_unlock': {
+        'TransferWithTimeout_transfer_input0_unlock': {
           'passes': [
-            'TransferWithTimeout_evaluate',
+            'TransferWithTimeout_transfer_evaluate',
           ],
-          'name': 'TransferWithTimeout_unlock',
+          'name': 'transfer (input #0)',
           'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
           'unlocks': 'TransferWithTimeout_lock',
         },
         'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
-          'name': 'TransferWithTimeout_lock',
+          'name': 'TransferWithTimeout',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
         },
       },
       'scenarios': {
-        'TransferWithTimeout_evaluate': {
-          'name': 'TransferWithTimeout_evaluate',
+        'TransferWithTimeout_transfer_evaluate': {
+          'name': 'TransferWithTimeout_transfer_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -121,7 +121,16 @@ export const fixtures: Fixture[] = [
             'locktime': expect.any(Number),
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': {
+                  'script': 'TransferWithTimeout_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                  },
+                },
                 'valueSatoshis': 10000,
               },
             ],
@@ -143,12 +152,13 @@ export const fixtures: Fixture[] = [
     name: 'TransferWithTimeout (timeout function)',
     transaction: (() => {
       const contract = new Contract(TransferWithTimeout, [alicePub, bobPub, 100000n], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const contractUtxo = randomUtxo();
+      provider.addUtxo(contract.address, contractUtxo);
 
-      const tx = contract.functions
-        .timeout(new SignatureTemplate(alicePriv))
-        .to(contract.address, 10000n)
-        .withoutChange();
+      const tx = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contract.unlock.timeout(new SignatureTemplate(alicePriv)))
+        .addOutput({ to: contract.address, amount: 10000n })
+        .setLocktime(133700);
 
       return tx;
     })(),
@@ -161,12 +171,12 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'TransferWithTimeout_parameters': {
+        'TransferWithTimeout_parameters_input0': {
           'description': 'Contract creation and function parameters',
-          'name': 'TransferWithTimeout_parameters',
+          'name': 'TransferWithTimeout (input #0)',
           'scripts': [
             'TransferWithTimeout_lock',
-            'TransferWithTimeout_unlock',
+            'TransferWithTimeout_timeout_input0_unlock',
           ],
           'variables': {
             'senderSig': {
@@ -198,23 +208,23 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'TransferWithTimeout_unlock': {
+        'TransferWithTimeout_timeout_input0_unlock': {
           'passes': [
-            'TransferWithTimeout_evaluate',
+            'TransferWithTimeout_timeout_evaluate',
           ],
-          'name': 'TransferWithTimeout_unlock',
+          'name': 'timeout (input #0)',
           'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
           'unlocks': 'TransferWithTimeout_lock',
         },
         'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
-          'name': 'TransferWithTimeout_lock',
+          'name': 'TransferWithTimeout',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
         },
       },
       'scenarios': {
-        'TransferWithTimeout_evaluate': {
-          'name': 'TransferWithTimeout_evaluate',
+        'TransferWithTimeout_timeout_evaluate': {
+          'name': 'TransferWithTimeout_timeout_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -242,10 +252,19 @@ export const fixtures: Fixture[] = [
                 ],
               },
             ],
-            'locktime': expect.any(Number),
+            'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': {
+                  'script': 'TransferWithTimeout_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                  },
+                },
                 'valueSatoshis': 10000,
               },
             ],
@@ -267,12 +286,13 @@ export const fixtures: Fixture[] = [
     name: 'Mecenas',
     transaction: (() => {
       const contract = new Contract(Mecenas, [alicePkh, bobPkh, 10_000n], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const contractUtxo = randomUtxo();
+      provider.addUtxo(contract.address, contractUtxo);
 
-      const tx = contract.functions
-        .receive()
-        .to(aliceAddress, 10_000n)
-        .withHardcodedFee(1000n);
+      const tx = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contract.unlock.receive())
+        .addOutput({ to: contract.address, amount: 10000n })
+        .setLocktime(133700);
 
       return tx;
     })(),
@@ -285,12 +305,12 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'Mecenas_parameters': {
+        'Mecenas_parameters_input0': {
           'description': 'Contract creation and function parameters',
-          'name': 'Mecenas_parameters',
+          'name': 'Mecenas (input #0)',
           'scripts': [
             'Mecenas_lock',
-            'Mecenas_unlock',
+            'Mecenas_receive_input0_unlock',
           ],
           'variables': {
             'recipient': {
@@ -317,23 +337,23 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'Mecenas_unlock': {
+        'Mecenas_receive_input0_unlock': {
           'passes': [
-            'Mecenas_evaluate',
+            'Mecenas_receive_evaluate',
           ],
-          'name': 'Mecenas_unlock',
+          'name': 'receive (input #0)',
           'script': '// "receive" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
           'unlocks': 'Mecenas_lock',
         },
         'Mecenas_lock': {
           'lockingType': 'p2sh32',
-          'name': 'Mecenas_lock',
+          'name': 'Mecenas',
           'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(this.age >= period);                                                                            */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
         },
       },
       'scenarios': {
-        'Mecenas_evaluate': {
-          'name': 'Mecenas_evaluate',
+        'Mecenas_receive_evaluate': {
+          'name': 'Mecenas_receive_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -342,7 +362,7 @@ export const fixtures: Fixture[] = [
               'pledge': '0x1027',
               'function_index': '0',
             },
-            'currentBlockHeight': 2,
+            'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {},
@@ -362,13 +382,18 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'lockingBytecode': {
+                  'script': 'Mecenas_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'recipient': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                      'funder': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
+                      'pledge': '0x1027',
+                    },
+                  },
+                },
                 'valueSatoshis': 10000,
               },
-              {
-                'lockingBytecode': {},
-                'valueSatoshis': expect.any(Number),
-              },
             ],
             'version': 2,
           },
@@ -397,11 +422,9 @@ export const fixtures: Fixture[] = [
       const to = contract.tokenAddress;
       const amount = 1000n;
 
-      const tx = contract.functions
-        .spend(alicePub, new SignatureTemplate(alicePriv))
-        .from(regularUtxo)
-        .from(tokenUtxo)
-        .to(to, amount, tokenUtxo.token);
+      const tx = new TransactionBuilder({ provider })
+        .addInputs([regularUtxo, tokenUtxo], contract.unlock.spend(alicePub, new SignatureTemplate(alicePriv)))
+        .addOutput({ to, amount, token: tokenUtxo.token });
 
       return tx;
     })(),
@@ -414,12 +437,37 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'P2PKH_parameters': {
+        'P2PKH_parameters_input0': {
+          'description': 'Contract creation and function parameters',
+          'name': 'P2PKH (input #0)',
+          'scripts': [
+            'P2PKH_lock',
+            'P2PKH_spend_input0_unlock',
+          ],
+          'variables': {
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'P2PKH_parameters_input1': {
           'description': 'Contract creation and function parameters',
-          'name': 'P2PKH_parameters',
+          'name': 'P2PKH (input #1)',
           'scripts': [
             'P2PKH_lock',
-            'P2PKH_unlock',
+            'P2PKH_spend_input1_unlock',
           ],
           'variables': {
             'pk': {
@@ -441,23 +489,31 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'P2PKH_unlock': {
+        'P2PKH_spend_input0_unlock': {
           'passes': [
-            'P2PKH_evaluate',
+            'P2PKH_spend_evaluate',
           ],
-          'name': 'P2PKH_unlock',
+          'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
           'unlocks': 'P2PKH_lock',
         },
         'P2PKH_lock': {
           'lockingType': 'p2sh32',
-          'name': 'P2PKH_lock',
+          'name': 'P2PKH',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
+        'P2PKH_spend_input1_unlock': {
+          'passes': [
+            'P2PKH_spend_evaluate1',
+          ],
+          'name': 'spend (input #1)',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
       },
       'scenarios': {
-        'P2PKH_evaluate': {
-          'name': 'P2PKH_evaluate',
+        'P2PKH_spend_evaluate': {
+          'name': 'P2PKH_spend_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -489,20 +545,23 @@ export const fixtures: Fixture[] = [
                 'unlockingBytecode': {},
               },
             ],
-            'locktime': 133700,
+            'locktime': expect.any(Number),
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': {
+                  'script': 'P2PKH_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
                 'token': {
                   'amount': expect.stringMatching(/^[0-9]+$/),
                   'category': expect.stringMatching(/^[0-9a-f]{64}$/),
                 },
                 'valueSatoshis': 1000,
               },
-              {
-                'lockingBytecode': {},
-                'valueSatoshis': expect.any(Number),
-              },
             ],
             'version': 2,
           },
@@ -514,7 +573,91 @@ export const fixtures: Fixture[] = [
               'valueSatoshis': expect.any(Number),
             },
             {
-              'lockingBytecode': {},
+              'lockingBytecode': {
+                'script': 'P2PKH_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': 1000,
+              'token': {
+                'amount': expect.stringMatching(/^[0-9]+$/),
+                'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+              },
+            },
+          ],
+        },
+        'P2PKH_spend_evaluate1': {
+          'name': 'P2PKH_spend_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'P2PKH_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
+                'token': {
+                  'amount': expect.stringMatching(/^[0-9]+$/),
+                  'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+                },
+                'valueSatoshis': 1000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'P2PKH_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
               'valueSatoshis': 1000,
               'token': {
                 'amount': expect.stringMatching(/^[0-9]+$/),
@@ -538,10 +681,9 @@ export const fixtures: Fixture[] = [
       const amount = 1000n;
 
       const hardcodedSignature = new SignatureTemplate(alicePriv).generateSignature(hexToBin('c0ffee'));
-      const tx = contract.functions
-        .spend(alicePub, hardcodedSignature)
-        .from(regularUtxo)
-        .to(to, amount);
+      const tx = new TransactionBuilder({ provider })
+        .addInput(regularUtxo, contract.unlock.spend(alicePub, hardcodedSignature))
+        .addOutput({ to, amount });
 
       return tx;
     })(),
@@ -554,12 +696,12 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'P2PKH_parameters': {
+        'P2PKH_parameters_input0': {
           'description': 'Contract creation and function parameters',
-          'name': 'P2PKH_parameters',
+          'name': 'P2PKH (input #0)',
           'scripts': [
             'P2PKH_lock',
-            'P2PKH_unlock',
+            'P2PKH_spend_input0_unlock',
           ],
           'variables': {
             'pk': {
@@ -581,23 +723,23 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'P2PKH_unlock': {
+        'P2PKH_spend_input0_unlock': {
           'passes': [
-            'P2PKH_evaluate',
+            'P2PKH_spend_evaluate',
           ],
-          'name': 'P2PKH_unlock',
+          'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<s> // sig = <0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61>\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
           'unlocks': 'P2PKH_lock',
         },
         'P2PKH_lock': {
           'lockingType': 'p2sh32',
-          'name': 'P2PKH_lock',
+          'name': 'P2PKH',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
       },
       'scenarios': {
-        'P2PKH_evaluate': {
-          'name': 'P2PKH_evaluate',
+        'P2PKH_spend_evaluate': {
+          'name': 'P2PKH_spend_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -605,7 +747,7 @@ export const fixtures: Fixture[] = [
               's': '0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61',
               'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
             },
-            'currentBlockHeight': 2,
+            'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {},
@@ -622,16 +764,19 @@ export const fixtures: Fixture[] = [
                 ],
               },
             ],
-            'locktime': 133700,
+            'locktime': 0,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': {
+                  'script': 'P2PKH_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
                 'valueSatoshis': 1000,
               },
-              {
-                'lockingBytecode': {},
-                'valueSatoshis': expect.any(Number),
-              },
             ],
             'version': 2,
           },
@@ -660,11 +805,9 @@ export const fixtures: Fixture[] = [
       const to = contract.tokenAddress;
       const amount = 1000n;
 
-      const tx = contract.functions
-        .spend(alicePub, new SignatureTemplate(alicePriv))
-        .from(regularUtxo)
-        .from(nftUtxo)
-        .to(to, amount, nftUtxo.token);
+      const tx = new TransactionBuilder({ provider })
+        .addInputs([regularUtxo, nftUtxo], contract.unlock.spend(alicePub, new SignatureTemplate(alicePriv)))
+        .addOutput({ to, amount, token: nftUtxo.token });
 
       return tx;
     })(),
@@ -677,12 +820,37 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'P2PKH_parameters': {
+        'P2PKH_parameters_input0': {
+          'description': 'Contract creation and function parameters',
+          'name': 'P2PKH (input #0)',
+          'scripts': [
+            'P2PKH_lock',
+            'P2PKH_spend_input0_unlock',
+          ],
+          'variables': {
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+          },
+        },
+        'P2PKH_parameters_input1': {
           'description': 'Contract creation and function parameters',
-          'name': 'P2PKH_parameters',
+          'name': 'P2PKH (input #1)',
           'scripts': [
             'P2PKH_lock',
-            'P2PKH_unlock',
+            'P2PKH_spend_input1_unlock',
           ],
           'variables': {
             'pk': {
@@ -704,30 +872,38 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'P2PKH_unlock': {
+        'P2PKH_spend_input0_unlock': {
           'passes': [
-            'P2PKH_evaluate',
+            'P2PKH_spend_evaluate',
           ],
-          'name': 'P2PKH_unlock',
+          'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
           'unlocks': 'P2PKH_lock',
         },
         'P2PKH_lock': {
           'lockingType': 'p2sh32',
-          'name': 'P2PKH_lock',
+          'name': 'P2PKH',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
+        'P2PKH_spend_input1_unlock': {
+          'passes': [
+            'P2PKH_spend_evaluate1',
+          ],
+          'name': 'spend (input #1)',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
       },
       'scenarios': {
-        'P2PKH_evaluate': {
-          'name': 'P2PKH_evaluate',
+        'P2PKH_spend_evaluate': {
+          'name': 'P2PKH_spend_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
               'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
               'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
             },
-            'currentBlockHeight': 2,
+            'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
@@ -752,10 +928,17 @@ export const fixtures: Fixture[] = [
                 'unlockingBytecode': {},
               },
             ],
-            'locktime': 133700,
+            'locktime': 0,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': {
+                  'script': 'P2PKH_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
                 'token': {
                   'amount': '0',
                   'category': expect.stringMatching(/^[0-9a-f]{64}$/),
@@ -766,10 +949,6 @@ export const fixtures: Fixture[] = [
                 },
                 'valueSatoshis': 1000,
               },
-              {
-                'lockingBytecode': {},
-                'valueSatoshis': expect.any(Number),
-              },
             ],
             'version': 2,
           },
@@ -781,7 +960,99 @@ export const fixtures: Fixture[] = [
               'valueSatoshis': expect.any(Number),
             },
             {
-              'lockingBytecode': {},
+              'lockingBytecode': {
+                'script': 'P2PKH_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': 1000,
+              'token': {
+                'amount': '0',
+                'category':  expect.stringMatching(/^[0-9a-f]{64}$/),
+                'nft': {
+                  'capability': 'none',
+                  'commitment': expect.stringMatching(/^[0-9a-f]{8}$/),
+                },
+              },
+            },
+          ],
+        },
+        'P2PKH_spend_evaluate1': {
+          'name': 'P2PKH_spend_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 0,
+            'outputs': [
+              {
+                'lockingBytecode': {
+                  'script': 'P2PKH_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
+                'token': {
+                  'amount': '0',
+                  'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+                  'nft': {
+                    'capability': 'none',
+                    'commitment': expect.stringMatching(/^[0-9a-f]{8}$/),
+                  },
+                },
+                'valueSatoshis': 1000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'P2PKH_lock',
+                'overrides': {
+                  'bytecode': {
+                    'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
               'valueSatoshis': 1000,
               'token': {
                 'amount': '0',
@@ -801,18 +1072,21 @@ export const fixtures: Fixture[] = [
     name: 'HodlVault (datasig)',
     transaction: (() => {
       const contract = new Contract(HoldVault, [alicePub, oraclePub, 99000n, 30000n], { provider });
-      provider.addUtxo(contract.address, randomUtxo());
+      const contractUtxo = randomUtxo();
+      provider.addUtxo(contract.address, contractUtxo);
 
       // given
       const message = oracle.createMessage(100000n, 30000n);
       const oracleSig = oracle.signMessage(message);
       const to = contract.address;
       const amount = 10000n;
+      const aliceTemplate = new SignatureTemplate(alicePriv);
 
       // when
-      const tx = contract.functions
-        .spend(new SignatureTemplate(alicePriv), oracleSig, message)
-        .to(to, amount);
+      const tx = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contract.unlock.spend(aliceTemplate, oracleSig, message))
+        .addOutput({ to, amount })
+        .setLocktime(133700);
 
       return tx;
     })(),
@@ -825,12 +1099,12 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'HodlVault_parameters': {
+        'HodlVault_parameters_input0': {
           'description': 'Contract creation and function parameters',
-          'name': 'HodlVault_parameters',
+          'name': 'HodlVault (input #0)',
           'scripts': [
             'HodlVault_lock',
-            'HodlVault_unlock',
+            'HodlVault_spend_input0_unlock',
           ],
           'variables': {
             'ownerSig': {
@@ -872,23 +1146,23 @@ export const fixtures: Fixture[] = [
         },
       },
       'scripts': {
-        'HodlVault_unlock': {
+        'HodlVault_spend_input0_unlock': {
           'passes': [
-            'HodlVault_evaluate',
+            'HodlVault_spend_evaluate',
           ],
-          'name': 'HodlVault_unlock',
+          'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<oracleMessage> // bytes8 = <0xa086010030750000>\n<oracleSig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<ownerSig.schnorr_signature.all_outputs_all_utxos> // sig\n',
           'unlocks': 'HodlVault_lock',
         },
         'HodlVault_lock': {
           'lockingType': 'p2sh32',
-          'name': 'HodlVault_lock',
+          'name': 'HodlVault',
           'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
         },
       },
       'scenarios': {
-        'HodlVault_evaluate': {
-          'name': 'HodlVault_evaluate',
+        'HodlVault_spend_evaluate': {
+          'name': 'HodlVault_spend_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -899,7 +1173,7 @@ export const fixtures: Fixture[] = [
               'minBlock': '0xb88201',
               'priceTarget': '0x3075',
             },
-            'currentBlockHeight': 2,
+            'currentBlockHeight': expect.any(Number),
             'currentBlockTime': expect.any(Number),
             'keys': {
               'privateKeys': {
@@ -921,13 +1195,19 @@ export const fixtures: Fixture[] = [
             'locktime': 133700,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': {
+                  'script': 'HodlVault_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'oraclePk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'minBlock': '0xb88201',
+                      'priceTarget': '0x3075',
+                    },
+                  },
+                },
                 'valueSatoshis': 10000,
               },
-              {
-                'lockingBytecode': {},
-                'valueSatoshis': expect.any(Number),
-              },
             ],
             'version': 2,
           },
@@ -968,9 +1248,8 @@ export const fixtures: Fixture[] = [
     name: 'P2PKH (with P2PKH inputs & P2SH20 address type & ECDSA signature algorithm)',
     transaction: (() => {
       const contract = new Contract(P2PKH, [alicePkh], { provider, addressType: 'p2sh20' });
-
-      const regularUtxo = randomUtxo();
-      provider.addUtxo(contract.address, regularUtxo);
+      const contractUtxo = randomUtxo();
+      provider.addUtxo(contract.address, contractUtxo);
 
       const p2pkhUtxo = randomUtxo();
       provider.addUtxo(aliceAddress, p2pkhUtxo);
@@ -978,12 +1257,14 @@ export const fixtures: Fixture[] = [
       const to = contract.tokenAddress;
       const amount = 1000n;
 
-      const tx = contract.functions
-        .spend(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_NONE, SignatureAlgorithm.ECDSA))
-        .fromP2PKH(p2pkhUtxo, new SignatureTemplate(alicePriv))
-        .from(regularUtxo)
-        .fromP2PKH(p2pkhUtxo, new SignatureTemplate(bobPriv, HashType.SIGHASH_ALL, SignatureAlgorithm.ECDSA))
-        .to(to, amount);
+      const aliceCustomTemplate = new SignatureTemplate(alicePriv, HashType.SIGHASH_NONE, SignatureAlgorithm.ECDSA);
+      const bobCustomTemplate = new SignatureTemplate(bobPriv, HashType.SIGHASH_ALL, SignatureAlgorithm.ECDSA);
+
+      const tx = new TransactionBuilder({ provider })
+        .addInput(p2pkhUtxo, new SignatureTemplate(alicePriv).unlockP2PKH())
+        .addInput(contractUtxo, contract.unlock.spend(alicePub, aliceCustomTemplate))
+        .addInput(p2pkhUtxo, bobCustomTemplate.unlockP2PKH())
+        .addOutput({ to, amount });
 
       return tx;
     })(),
@@ -996,16 +1277,12 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'P2PKH_parameters': {
+        'P2PKH_parameters_input1': {
           'description': 'Contract creation and function parameters',
-          'name': 'P2PKH_parameters',
+          'name': 'P2PKH (input #1)',
           'scripts': [
             'P2PKH_lock',
-            'P2PKH_unlock',
-            'p2pkh_placeholder_lock_0',
-            'p2pkh_placeholder_unlock_0',
-            'p2pkh_placeholder_lock_2',
-            'p2pkh_placeholder_unlock_2',
+            'P2PKH_spend_input1_unlock',
           ],
           'variables': {
             'pk': {
@@ -1023,57 +1300,77 @@ export const fixtures: Fixture[] = [
               'name': 'pkh',
               'type': 'WalletData',
             },
+          },
+        },
+        'signer_0': {
+          'scripts': [
+            'p2pkh_placeholder_lock_0',
+            'p2pkh_placeholder_unlock_0',
+          ],
+          'description': 'placeholder_key_0',
+          'name': 'P2PKH Signer (input #0)',
+          'variables': {
             'placeholder_key_0': {
-              'description': 'placeholder_key_0',
-              'name': 'placeholder_key_0',
+              'description': '',
+              'name': 'P2PKH Placeholder Key (input #0)',
               'type': 'Key',
             },
+          },
+        },
+        'signer_2': {
+          'scripts': [
+            'p2pkh_placeholder_lock_2',
+            'p2pkh_placeholder_unlock_2',
+          ],
+          'description': 'placeholder_key_2',
+          'name': 'P2PKH Signer (input #2)',
+          'variables': {
             'placeholder_key_2': {
-              'description': 'placeholder_key_2',
-              'name': 'placeholder_key_2',
+              'description': '',
+              'name': 'P2PKH Placeholder Key (input #2)',
               'type': 'Key',
             },
           },
         },
       },
       'scripts': {
-        'P2PKH_unlock': {
+        'P2PKH_spend_input1_unlock': {
           'passes': [
-            'P2PKH_evaluate',
+            'P2PKH_spend_evaluate',
           ],
-          'name': 'P2PKH_unlock',
+          'name': 'spend (input #1)',
           'script': '// "spend" function parameters\n<s.ecdsa_signature.no_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
           'unlocks': 'P2PKH_lock',
         },
         'P2PKH_lock': {
           'lockingType': 'p2sh20',
-          'name': 'P2PKH_lock',
+          'name': 'P2PKH',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
         },
         'p2pkh_placeholder_unlock_0': {
-          'name': 'p2pkh_placeholder_unlock_0',
+          'name': 'P2PKH Unlock (input #0)',
           'script': '<placeholder_key_0.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_0.public_key>',
           'unlocks': 'p2pkh_placeholder_lock_0',
         },
         'p2pkh_placeholder_lock_0': {
           'lockingType': 'standard',
-          'name': 'p2pkh_placeholder_lock_0',
+          'name': 'P2PKH Lock (input #0)',
           'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_0.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
         },
         'p2pkh_placeholder_unlock_2': {
-          'name': 'p2pkh_placeholder_unlock_2',
+          'name': 'P2PKH Unlock (input #2)',
           'script': '<placeholder_key_2.ecdsa_signature.all_outputs>\n<placeholder_key_2.public_key>',
           'unlocks': 'p2pkh_placeholder_lock_2',
         },
         'p2pkh_placeholder_lock_2': {
           'lockingType': 'standard',
-          'name': 'p2pkh_placeholder_lock_2',
+          'name': 'P2PKH Lock (input #2)',
           'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_2.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
         },
       },
       'scenarios': {
-        'P2PKH_evaluate': {
-          'name': 'P2PKH_evaluate',
+        'P2PKH_spend_evaluate': {
+          'name': 'P2PKH_spend_evaluate',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1117,28 +1414,22 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {
-                  'script': 'p2pkh_placeholder_unlock_2',
-                  'overrides': {
-                    'keys': {
-                      'privateKeys': {
-                        'placeholder_key_2': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
-                      },
-                    },
-                  },
-                },
+                'unlockingBytecode': {},
               },
             ],
-            'locktime': 133700,
+            'locktime': 0,
             'outputs': [
               {
-                'lockingBytecode': {},
+                'lockingBytecode': {
+                  'script': 'P2PKH_lock',
+                  'overrides': {
+                    'bytecode': {
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                  },
+                },
                 'valueSatoshis': 1000,
               },
-              {
-                'lockingBytecode': {},
-                'valueSatoshis': expect.any(Number),
-              },
             ],
             'version': 2,
           },
@@ -1163,16 +1454,7 @@ export const fixtures: Fixture[] = [
               'valueSatoshis': expect.any(Number),
             },
             {
-              'lockingBytecode': {
-                'script': 'p2pkh_placeholder_lock_2',
-                'overrides': {
-                  'keys': {
-                    'privateKeys': {
-                      'placeholder_key_2': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
-                    },
-                  },
-                },
-              },
+              'lockingBytecode': {},
               'valueSatoshis': expect.any(Number),
             },
           ],
diff --git a/packages/cashscript/test/fixture/libauth-template/old-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/old-fixtures.ts
new file mode 100644
index 00000000..21ddb1e6
--- /dev/null
+++ b/packages/cashscript/test/fixture/libauth-template/old-fixtures.ts
@@ -0,0 +1,1183 @@
+import { Contract, HashType, MockNetworkProvider, SignatureAlgorithm, SignatureTemplate, type Transaction, randomNFT, randomToken, randomUtxo } from '../../../src/index.js';
+import TransferWithTimeout from '../transfer_with_timeout.artifact.js';
+import Mecenas from '../mecenas.artifact.js';
+import P2PKH from '../p2pkh.artifact.js';
+import HoldVault from '../hodl_vault.artifact.js';
+import { aliceAddress, alicePkh, alicePriv, alicePub, bobPkh, bobPriv, bobPub, oracle, oraclePub } from '../vars.js';
+import { WalletTemplate, hexToBin } from '@bitauth/libauth';
+
+const provider = new MockNetworkProvider();
+
+export interface Fixture {
+  name: string;
+  transaction: Transaction;
+  template: WalletTemplate;
+}
+
+export const fixtures: Fixture[] = [
+  {
+    name: 'TransferWithTimeout (transfer function)',
+    transaction: (() => {
+      const contract = new Contract(TransferWithTimeout, [alicePub, bobPub, 100000n], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const tx = contract.functions
+        .transfer(new SignatureTemplate(bobPriv))
+        .to(contract.address, 10000n)
+        .withoutChange();
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2025_05',
+      ],
+      'version': 0,
+      'entities': {
+        'TransferWithTimeout_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'TransferWithTimeout_parameters',
+          'scripts': [
+            'TransferWithTimeout_lock',
+            'TransferWithTimeout_unlock',
+          ],
+          'variables': {
+            'recipientSig': {
+              'description': '"recipientSig" parameter of function "transfer"',
+              'name': 'recipientSig',
+              'type': 'Key',
+            },
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'sender',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'recipient',
+              'type': 'WalletData',
+            },
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'timeout',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'TransferWithTimeout_unlock': {
+          'passes': [
+            'TransferWithTimeout_evaluate',
+          ],
+          'name': 'TransferWithTimeout_unlock',
+          'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'TransferWithTimeout_lock',
+        },
+        'TransferWithTimeout_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'TransferWithTimeout_lock',
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+        },
+      },
+      'scenarios': {
+        'TransferWithTimeout_evaluate': {
+          'name': 'TransferWithTimeout_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'timeout': '0xa08601',
+              'function_index': '0',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'recipientSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': expect.any(Number),
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 10000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
+  {
+    name: 'TransferWithTimeout (timeout function)',
+    transaction: (() => {
+      const contract = new Contract(TransferWithTimeout, [alicePub, bobPub, 100000n], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const tx = contract.functions
+        .timeout(new SignatureTemplate(alicePriv))
+        .to(contract.address, 10000n)
+        .withoutChange();
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2025_05',
+      ],
+      'version': 0,
+      'entities': {
+        'TransferWithTimeout_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'TransferWithTimeout_parameters',
+          'scripts': [
+            'TransferWithTimeout_lock',
+            'TransferWithTimeout_unlock',
+          ],
+          'variables': {
+            'senderSig': {
+              'description': '"senderSig" parameter of function "timeout"',
+              'name': 'senderSig',
+              'type': 'Key',
+            },
+            'sender': {
+              'description': '"sender" parameter of this contract',
+              'name': 'sender',
+              'type': 'WalletData',
+            },
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'recipient',
+              'type': 'WalletData',
+            },
+            'timeout': {
+              'description': '"timeout" parameter of this contract',
+              'name': 'timeout',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'TransferWithTimeout_unlock': {
+          'passes': [
+            'TransferWithTimeout_evaluate',
+          ],
+          'name': 'TransferWithTimeout_unlock',
+          'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
+          'unlocks': 'TransferWithTimeout_lock',
+        },
+        'TransferWithTimeout_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'TransferWithTimeout_lock',
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+        },
+      },
+      'scenarios': {
+        'TransferWithTimeout_evaluate': {
+          'name': 'TransferWithTimeout_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'recipient': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'timeout': '0xa08601',
+              'function_index': '1',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'senderSig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': expect.any(Number),
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 10000,
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
+  {
+    name: 'Mecenas',
+    transaction: (() => {
+      const contract = new Contract(Mecenas, [alicePkh, bobPkh, 10_000n], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      const tx = contract.functions
+        .receive()
+        .to(aliceAddress, 10_000n)
+        .withHardcodedFee(1000n);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2025_05',
+      ],
+      'version': 0,
+      'entities': {
+        'Mecenas_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'Mecenas_parameters',
+          'scripts': [
+            'Mecenas_lock',
+            'Mecenas_unlock',
+          ],
+          'variables': {
+            'recipient': {
+              'description': '"recipient" parameter of this contract',
+              'name': 'recipient',
+              'type': 'WalletData',
+            },
+            'funder': {
+              'description': '"funder" parameter of this contract',
+              'name': 'funder',
+              'type': 'WalletData',
+            },
+            'pledge': {
+              'description': '"pledge" parameter of this contract',
+              'name': 'pledge',
+              'type': 'WalletData',
+            },
+            'function_index': {
+              'description': 'Script function index to execute',
+              'name': 'function_index',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'Mecenas_unlock': {
+          'passes': [
+            'Mecenas_evaluate',
+          ],
+          'name': 'Mecenas_unlock',
+          'script': '// "receive" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
+          'unlocks': 'Mecenas_lock',
+        },
+        'Mecenas_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'Mecenas_lock',
+          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(this.age >= period);                                                                            */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
+        },
+      },
+      'scenarios': {
+        'Mecenas_evaluate': {
+          'name': 'Mecenas_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'recipient': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+              'funder': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
+              'pledge': '0x1027',
+              'function_index': '0',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {},
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'valueSatoshis': 10000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
+  {
+    name: 'P2PKH (sending fungible tokens)',
+    transaction: (() => {
+      const contract = new Contract(P2PKH, [alicePkh], { provider });
+
+      const regularUtxo = randomUtxo();
+      const tokenUtxo = randomUtxo({ satoshis: 1000n, token: randomToken() });
+      provider.addUtxo(contract.address, regularUtxo);
+      provider.addUtxo(contract.address, tokenUtxo);
+
+      const to = contract.tokenAddress;
+      const amount = 1000n;
+
+      const tx = contract.functions
+        .spend(alicePub, new SignatureTemplate(alicePriv))
+        .from(regularUtxo)
+        .from(tokenUtxo)
+        .to(to, amount, tokenUtxo.token);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2025_05',
+      ],
+      'version': 0,
+      'entities': {
+        'P2PKH_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'P2PKH_parameters',
+          'scripts': [
+            'P2PKH_lock',
+            'P2PKH_unlock',
+          ],
+          'variables': {
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'P2PKH_unlock': {
+          'passes': [
+            'P2PKH_evaluate',
+          ],
+          'name': 'P2PKH_unlock',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
+        'P2PKH_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'P2PKH_lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+      },
+      'scenarios': {
+        'P2PKH_evaluate': {
+          'name': 'P2PKH_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'token': {
+                  'amount': expect.stringMatching(/^[0-9]+$/),
+                  'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+                },
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {},
+              'valueSatoshis': 1000,
+              'token': {
+                'amount': expect.stringMatching(/^[0-9]+$/),
+                'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+              },
+            },
+          ],
+        },
+      },
+    },
+  },
+  {
+    name: 'P2PKH (hardcoded signature)',
+    transaction: (() => {
+      const contract = new Contract(P2PKH, [alicePkh], { provider });
+
+      const regularUtxo = randomUtxo();
+      provider.addUtxo(contract.address, regularUtxo);
+
+      const to = contract.tokenAddress;
+      const amount = 1000n;
+
+      const hardcodedSignature = new SignatureTemplate(alicePriv).generateSignature(hexToBin('c0ffee'));
+      const tx = contract.functions
+        .spend(alicePub, hardcodedSignature)
+        .from(regularUtxo)
+        .to(to, amount);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2025_05',
+      ],
+      'version': 0,
+      'entities': {
+        'P2PKH_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'P2PKH_parameters',
+          'scripts': [
+            'P2PKH_lock',
+            'P2PKH_unlock',
+          ],
+          'variables': {
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'WalletData',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'P2PKH_unlock': {
+          'passes': [
+            'P2PKH_evaluate',
+          ],
+          'name': 'P2PKH_unlock',
+          'script': '// "spend" function parameters\n<s> // sig = <0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61>\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
+        'P2PKH_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'P2PKH_lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+      },
+      'scenarios': {
+        'P2PKH_evaluate': {
+          'name': 'P2PKH_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              's': '0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {},
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
+  {
+    name: 'P2PKH (sending NFTs)',
+    transaction: (() => {
+      const contract = new Contract(P2PKH, [alicePkh], { provider });
+
+      const regularUtxo = randomUtxo();
+      const nftUtxo = randomUtxo({ satoshis: 1000n, token: randomNFT() });
+      provider.addUtxo(contract.address, regularUtxo);
+      provider.addUtxo(contract.address, nftUtxo);
+
+      const to = contract.tokenAddress;
+      const amount = 1000n;
+
+      const tx = contract.functions
+        .spend(alicePub, new SignatureTemplate(alicePriv))
+        .from(regularUtxo)
+        .from(nftUtxo)
+        .to(to, amount, nftUtxo.token);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2025_05',
+      ],
+      'version': 0,
+      'entities': {
+        'P2PKH_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'P2PKH_parameters',
+          'scripts': [
+            'P2PKH_lock',
+            'P2PKH_unlock',
+          ],
+          'variables': {
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'P2PKH_unlock': {
+          'passes': [
+            'P2PKH_evaluate',
+          ],
+          'name': 'P2PKH_unlock',
+          'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
+        'P2PKH_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'P2PKH_lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+      },
+      'scenarios': {
+        'P2PKH_evaluate': {
+          'name': 'P2PKH_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {},
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'token': {
+                  'amount': '0',
+                  'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+                  'nft': {
+                    'capability': 'none',
+                    'commitment': expect.stringMatching(/^[0-9a-f]{8}$/),
+                  },
+                },
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {},
+              'valueSatoshis': 1000,
+              'token': {
+                'amount': '0',
+                'category': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'nft': {
+                  'capability': 'none',
+                  'commitment': expect.stringMatching(/^[0-9a-f]{8}$/),
+                },
+              },
+            },
+          ],
+        },
+      },
+    },
+  },
+  {
+    name: 'HodlVault (datasig)',
+    transaction: (() => {
+      const contract = new Contract(HoldVault, [alicePub, oraclePub, 99000n, 30000n], { provider });
+      provider.addUtxo(contract.address, randomUtxo());
+
+      // given
+      const message = oracle.createMessage(100000n, 30000n);
+      const oracleSig = oracle.signMessage(message);
+      const to = contract.address;
+      const amount = 10000n;
+
+      // when
+      const tx = contract.functions
+        .spend(new SignatureTemplate(alicePriv), oracleSig, message)
+        .to(to, amount);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2025_05',
+      ],
+      'version': 0,
+      'entities': {
+        'HodlVault_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'HodlVault_parameters',
+          'scripts': [
+            'HodlVault_lock',
+            'HodlVault_unlock',
+          ],
+          'variables': {
+            'ownerSig': {
+              'description': '"ownerSig" parameter of function "spend"',
+              'name': 'ownerSig',
+              'type': 'Key',
+            },
+            'oracleSig': {
+              'description': '"oracleSig" parameter of function "spend"',
+              'name': 'oracleSig',
+              'type': 'WalletData',
+            },
+            'oracleMessage': {
+              'description': '"oracleMessage" parameter of function "spend"',
+              'name': 'oracleMessage',
+              'type': 'WalletData',
+            },
+            'ownerPk': {
+              'description': '"ownerPk" parameter of this contract',
+              'name': 'ownerPk',
+              'type': 'WalletData',
+            },
+            'oraclePk': {
+              'description': '"oraclePk" parameter of this contract',
+              'name': 'oraclePk',
+              'type': 'WalletData',
+            },
+            'minBlock': {
+              'description': '"minBlock" parameter of this contract',
+              'name': 'minBlock',
+              'type': 'WalletData',
+            },
+            'priceTarget': {
+              'description': '"priceTarget" parameter of this contract',
+              'name': 'priceTarget',
+              'type': 'WalletData',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'HodlVault_unlock': {
+          'passes': [
+            'HodlVault_evaluate',
+          ],
+          'name': 'HodlVault_unlock',
+          'script': '// "spend" function parameters\n<oracleMessage> // bytes8 = <0xa086010030750000>\n<oracleSig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<ownerSig.schnorr_signature.all_outputs_all_utxos> // sig\n',
+          'unlocks': 'HodlVault_lock',
+        },
+        'HodlVault_lock': {
+          'lockingType': 'p2sh32',
+          'name': 'HodlVault_lock',
+          'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
+        },
+      },
+      'scenarios': {
+        'HodlVault_evaluate': {
+          'name': 'HodlVault_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'oracleSig': '0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b',
+              'oracleMessage': '0xa086010030750000',
+              'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'oraclePk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+              'minBlock': '0xb88201',
+              'priceTarget': '0x3075',
+            },
+            'currentBlockHeight': 2,
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                'ownerSig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 10000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
+  // TODO: Make it work with different hashtypes and signature algorithms
+  // {
+  //   name: 'P2PKH (sending NFTs)',
+  //   transaction: (() => {
+  //     const contract = new Contract(P2PKH, [alicePkh], { provider });
+  //     provider.addUtxo(contract.address, randomUtxo());
+
+  //     const to = contract.address;
+  //     const amount = 1000n;
+
+  //     const hashtype = HashType.SIGHASH_SINGLE | HashType.SIGHASH_ANYONECANPAY;
+  //     const signatureAlgorithm = SignatureAlgorithm.ECDSA;
+
+  //     const tx = contract.functions
+  //       .spend(alicePub, new SignatureTemplate(alicePriv, hashtype, signatureAlgorithm))
+  //       .to(to, amount);
+
+  //     return tx;
+  //   })(),
+  //   template: {} as any,
+  // },
+  {
+    name: 'P2PKH (with P2PKH inputs & P2SH20 address type & ECDSA signature algorithm)',
+    transaction: (() => {
+      const contract = new Contract(P2PKH, [alicePkh], { provider, addressType: 'p2sh20' });
+
+      const regularUtxo = randomUtxo();
+      provider.addUtxo(contract.address, regularUtxo);
+
+      const p2pkhUtxo = randomUtxo();
+      provider.addUtxo(aliceAddress, p2pkhUtxo);
+
+      const to = contract.tokenAddress;
+      const amount = 1000n;
+
+      const tx = contract.functions
+        .spend(alicePub, new SignatureTemplate(alicePriv, HashType.SIGHASH_NONE, SignatureAlgorithm.ECDSA))
+        .fromP2PKH(p2pkhUtxo, new SignatureTemplate(alicePriv))
+        .from(regularUtxo)
+        .fromP2PKH(p2pkhUtxo, new SignatureTemplate(bobPriv, HashType.SIGHASH_ALL, SignatureAlgorithm.ECDSA))
+        .to(to, amount);
+
+      return tx;
+    })(),
+    template: {
+      '$schema': 'https://ide.bitauth.com/authentication-template-v0.schema.json',
+      'description': 'Imported from cashscript',
+      'name': 'CashScript Generated Debugging Template',
+      'supported': [
+        'BCH_2025_05',
+      ],
+      'version': 0,
+      'entities': {
+        'P2PKH_parameters': {
+          'description': 'Contract creation and function parameters',
+          'name': 'P2PKH_parameters',
+          'scripts': [
+            'P2PKH_lock',
+            'P2PKH_unlock',
+            'p2pkh_placeholder_lock_0',
+            'p2pkh_placeholder_unlock_0',
+            'p2pkh_placeholder_lock_2',
+            'p2pkh_placeholder_unlock_2',
+          ],
+          'variables': {
+            'pk': {
+              'description': '"pk" parameter of function "spend"',
+              'name': 'pk',
+              'type': 'WalletData',
+            },
+            's': {
+              'description': '"s" parameter of function "spend"',
+              'name': 's',
+              'type': 'Key',
+            },
+            'pkh': {
+              'description': '"pkh" parameter of this contract',
+              'name': 'pkh',
+              'type': 'WalletData',
+            },
+            'placeholder_key_0': {
+              'description': 'placeholder_key_0',
+              'name': 'placeholder_key_0',
+              'type': 'Key',
+            },
+            'placeholder_key_2': {
+              'description': 'placeholder_key_2',
+              'name': 'placeholder_key_2',
+              'type': 'Key',
+            },
+          },
+        },
+      },
+      'scripts': {
+        'P2PKH_unlock': {
+          'passes': [
+            'P2PKH_evaluate',
+          ],
+          'name': 'P2PKH_unlock',
+          'script': '// "spend" function parameters\n<s.ecdsa_signature.no_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
+          'unlocks': 'P2PKH_lock',
+        },
+        'P2PKH_lock': {
+          'lockingType': 'p2sh20',
+          'name': 'P2PKH_lock',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+        },
+        'p2pkh_placeholder_unlock_0': {
+          'name': 'p2pkh_placeholder_unlock_0',
+          'script': '<placeholder_key_0.schnorr_signature.all_outputs_all_utxos>\n<placeholder_key_0.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock_0',
+        },
+        'p2pkh_placeholder_lock_0': {
+          'lockingType': 'standard',
+          'name': 'p2pkh_placeholder_lock_0',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_0.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+        },
+        'p2pkh_placeholder_unlock_2': {
+          'name': 'p2pkh_placeholder_unlock_2',
+          'script': '<placeholder_key_2.ecdsa_signature.all_outputs>\n<placeholder_key_2.public_key>',
+          'unlocks': 'p2pkh_placeholder_lock_2',
+        },
+        'p2pkh_placeholder_lock_2': {
+          'lockingType': 'standard',
+          'name': 'p2pkh_placeholder_lock_2',
+          'script': 'OP_DUP\nOP_HASH160 <$(<placeholder_key_2.public_key> OP_HASH160\n)> OP_EQUALVERIFY\nOP_CHECKSIG',
+        },
+      },
+      'scenarios': {
+        'P2PKH_evaluate': {
+          'name': 'P2PKH_evaluate',
+          'description': 'An example evaluation where this script execution passes.',
+          'data': {
+            'bytecode': {
+              'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+              'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+            },
+            'currentBlockHeight': expect.any(Number),
+            'currentBlockTime': expect.any(Number),
+            'keys': {
+              'privateKeys': {
+                's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+              },
+            },
+          },
+          'transaction': {
+            'inputs': [
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_0',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': [
+                  'slot',
+                ],
+              },
+              {
+                'outpointIndex': expect.any(Number),
+                'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
+                'sequenceNumber': 4294967294,
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_2',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_2': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                },
+              },
+            ],
+            'locktime': 133700,
+            'outputs': [
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': 1000,
+              },
+              {
+                'lockingBytecode': {},
+                'valueSatoshis': expect.any(Number),
+              },
+            ],
+            'version': 2,
+          },
+          'sourceOutputs': [
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_0',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_0': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': [
+                'slot',
+              ],
+              'valueSatoshis': expect.any(Number),
+            },
+            {
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_2',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_2': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                    },
+                  },
+                },
+              },
+              'valueSatoshis': expect.any(Number),
+            },
+          ],
+        },
+      },
+    },
+  },
+];
diff --git a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
index ea5de55b..87d07c63 100644
--- a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
+++ b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
@@ -1,11 +1,21 @@
 import { fixtures } from '../fixture/libauth-template/fixtures.js';
+import { fixtures as oldFixtures } from '../fixture/libauth-template/old-fixtures.js';
 
 describe('Libauth Template generation tests', () => {
   fixtures.forEach((fixture) => {
-    it(`should generate a valid libauth template for ${fixture.name}`, async () => {
+    it(`should generate a valid libauth template for ${fixture.name}`, () => {
+      const generatedTemplate = fixture.transaction.getLibauthTemplate();
+      // console.log(JSON.stringify(generatedTemplate, null, 2));
+      // console.log(fixture.transaction.bitauthUri());
+      expect(generatedTemplate).toEqual(fixture.template);
+    });
+  });
+  // old-fixtures using the deprecated simple transaction builder
+  oldFixtures.forEach((fixture) => {
+    it(`should generate a valid libauth template for old-fixture ${fixture.name}`, async () => {
       const generatedTemplate = await fixture.transaction.getLibauthTemplate();
       // console.log(JSON.stringify(generatedTemplate, null, 2));
-      // console.log(await fixture.transaction.bitauthUri());
+      // console.log(fixture.transaction.bitauthUri());
       expect(generatedTemplate).toEqual(fixture.template);
     });
   });

From 882d837149fd2590ce314fb8f8f1f144a8c9d37a Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 28 Mar 2025 11:04:31 +0100
Subject: [PATCH 212/267] Fix small bug and update libauth template property
 naming

- Fix bug where P2PKH inputs were not correctly detected using the new
  transaction builder
- Update libauth template generation to always include input index in
  names
- Update fixtures accordingly
---
 packages/cashscript/src/LibauthTemplate.ts    |  18 +++
 .../src/advanced/LibauthTemplate.ts           |  38 ++----
 .../test/fixture/libauth-template/fixtures.ts | 119 +++++++++++-------
 .../multi-contract-fixtures.ts                | 104 +++++++--------
 .../libauth-template/LibauthTemplate.test.ts  |   2 +-
 5 files changed, 154 insertions(+), 127 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index a8d02993..4dccd760 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -33,6 +33,7 @@ import {
   AddressType,
   SignatureAlgorithm,
   HashType,
+  isUnlockableUtxo,
 } from './interfaces.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
@@ -354,6 +355,7 @@ const generateTemplateScenarioSourceOutputs = (
 export const generateTemplateScenarioBytecode = (
   input: Utxo, p2pkhScriptName: string, placeholderKeyName: string, insertSlot?: boolean,
 ): WalletTemplateScenarioBytecode | ['slot'] => {
+  // This is for P2PKH inputs in the old transaction builder (TODO: remove when we remove old transaction builder)
   if (isUtxoP2PKH(input)) {
     return {
       script: p2pkhScriptName,
@@ -367,6 +369,22 @@ export const generateTemplateScenarioBytecode = (
     };
   }
 
+  // This is for P2PKH inputs in the new transaction builder
+  if (isUnlockableUtxo(input) && input.unlocker.template) {
+    return {
+      script: p2pkhScriptName,
+      overrides: {
+        keys: {
+          privateKeys: {
+            [placeholderKeyName]: binToHex(input.unlocker.template.privateKey),
+          },
+        },
+      },
+    };
+  }
+
+  // 'slot' means that we are currently evaluating this specific input,
+  // {} means that it is the same script type, but not being evaluated
   return insertSlot ? ['slot'] : {};
 };
 
diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index abe85f6a..a19b61a2 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -108,7 +108,7 @@ export const generateTemplateEntitiesP2SH = (
   );
 
   const entities = {
-    [artifact.contractName + '_parameters' + '_input' + inputIndex]: {
+    [artifact.contractName + '_input' + inputIndex + '_parameters']: {
       description: 'Contract creation and function parameters',
       name: `${artifact.contractName} (input #${inputIndex})`,
       scripts: [
@@ -124,7 +124,7 @@ export const generateTemplateEntitiesP2SH = (
 
   // function_index is a special variable that indicates the function to execute
   if (artifact.abi.length > 1) {
-    entities[artifact.contractName + '_parameters' + '_input' + inputIndex].variables.function_index = {
+    entities[artifact.contractName + '_input' + inputIndex + '_parameters'].variables.function_index = {
       description: 'Script function index to execute',
       name: 'function_index',
       type: 'WalletData',
@@ -184,7 +184,6 @@ export const generateTemplateScriptsP2SH = (
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedFunctionArgument[],
   encodedConstructorArgs: EncodedConstructorArgument[],
-  scenarioId: string,
   inputIndex: number,
 ): WalletTemplate['scripts'] => {
   // definition of locking scripts and unlocking scripts with their respective bytecode
@@ -192,7 +191,7 @@ export const generateTemplateScriptsP2SH = (
   const lockingScriptName = artifact.contractName + '_lock';
 
   return {
-    [unlockingScriptName]: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs, scenarioId, inputIndex),
+    [unlockingScriptName]: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs, inputIndex),
     [lockingScriptName]: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
   };
 };
@@ -233,9 +232,9 @@ const generateTemplateUnlockScript = (
   artifact: Artifact,
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedFunctionArgument[],
-  scenarioId: string,
   inputIndex: number,
 ): WalletTemplateScriptUnlocking => {
+  const scenarioIdentifier = `${artifact.contractName}_${abiFunction.name}_input${inputIndex}_evaluate`;
   const functionIndex = artifact.abi.findIndex((func) => func.name === abiFunction.name);
 
   const functionIndexString = artifact.abi.length > 1
@@ -244,7 +243,7 @@ const generateTemplateUnlockScript = (
 
   return {
     // this unlocking script must pass our only scenario
-    passes: [scenarioId],
+    passes: [scenarioIdentifier],
     name: `${abiFunction.name} (input #${inputIndex})`,
     script: [
       `// "${abiFunction.name}" function parameters`,
@@ -257,21 +256,21 @@ const generateTemplateUnlockScript = (
 };
 
 export const generateTemplateScenarios = (
-  scenarioIdentifier: string,
   contract: Contract,
   libauthTransaction: TransactionBch,
   csTransaction: Transaction,
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedFunctionArgument[],
-  slotIndex: number,
+  inputIndex: number,
 ): WalletTemplate['scenarios'] => {
   const artifact = contract.artifact;
   const encodedConstructorArgs = contract.encodedConstructorArgs;
+  const scenarioIdentifier = `${artifact.contractName}_${abiFunction.name}_input${inputIndex}_evaluate`;
 
   const scenarios = {
     // single scenario to spend out transaction under test given the CashScript parameters provided
     [scenarioIdentifier]: {
-      name: artifact.contractName + '_' + abiFunction.name + '_evaluate',
+      name: `Evaluate ${artifact.contractName} ${abiFunction.name} (input #${inputIndex})`,
       description: 'An example evaluation where this script execution passes.',
       data: {
         // encode values for the variables defined above in `entities` property
@@ -285,8 +284,8 @@ export const generateTemplateScenarios = (
           privateKeys: generateTemplateScenarioKeys(abiFunction.inputs, encodedFunctionArgs),
         },
       },
-      transaction: generateTemplateScenarioTransaction(contract, libauthTransaction, csTransaction, slotIndex),
-      sourceOutputs: generateTemplateScenarioSourceOutputs(csTransaction, slotIndex),
+      transaction: generateTemplateScenarioTransaction(contract, libauthTransaction, csTransaction, inputIndex),
+      sourceOutputs: generateTemplateScenarioSourceOutputs(csTransaction, inputIndex),
     },
   };
 
@@ -415,21 +414,6 @@ export const getLibauthTemplates = (
         throw new Error('No ABI function found in unlocker');
       }
 
-      // Find matching function and index from contract.unlock Object, this uses Function Reference Comparison.
-      // Generate unique scenario identifier by combining contract name, function name and counter
-      const baseIdentifier = `${contract.artifact.contractName}_${abiFunction.name}_evaluate`;
-      let scenarioIdentifier = baseIdentifier;
-      let counter = 0;
-
-      const scenarioIds = [scenarioIdentifier];
-
-      // Find first available unique identifier by incrementing counter
-      while (scenarios[scenarioIdentifier]) {
-        counter++;
-        scenarioIdentifier = `${baseIdentifier}${counter}`;
-        scenarioIds.push(scenarioIdentifier);
-      }
-
       // Encode the function arguments for this contract input
       const encodedArgs = encodeFunctionArguments(
         abiFunction,
@@ -439,7 +423,6 @@ export const getLibauthTemplates = (
       // Generate a scenario object for this contract input
       Object.assign(scenarios,
         generateTemplateScenarios(
-          scenarioIdentifier,
           contract,
           libauthTransaction,
           csTransaction as any,
@@ -464,7 +447,6 @@ export const getLibauthTemplates = (
         abiFunction,
         encodedArgs,
         contract.encodedConstructorArgs,
-        scenarioIdentifier,
         inputIndex,
       );
 
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 7191d765..a372721b 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -37,7 +37,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'TransferWithTimeout_parameters_input0': {
+        'TransferWithTimeout_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #0)',
           'scripts': [
@@ -76,7 +76,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'TransferWithTimeout_transfer_input0_unlock': {
           'passes': [
-            'TransferWithTimeout_transfer_evaluate',
+            'TransferWithTimeout_transfer_input0_evaluate',
           ],
           'name': 'transfer (input #0)',
           'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
@@ -89,8 +89,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'TransferWithTimeout_transfer_evaluate': {
-          'name': 'TransferWithTimeout_transfer_evaluate',
+        'TransferWithTimeout_transfer_input0_evaluate': {
+          'name': 'Evaluate TransferWithTimeout transfer (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -171,7 +171,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'TransferWithTimeout_parameters_input0': {
+        'TransferWithTimeout_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #0)',
           'scripts': [
@@ -210,7 +210,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'TransferWithTimeout_timeout_input0_unlock': {
           'passes': [
-            'TransferWithTimeout_timeout_evaluate',
+            'TransferWithTimeout_timeout_input0_evaluate',
           ],
           'name': 'timeout (input #0)',
           'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
@@ -223,8 +223,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'TransferWithTimeout_timeout_evaluate': {
-          'name': 'TransferWithTimeout_timeout_evaluate',
+        'TransferWithTimeout_timeout_input0_evaluate': {
+          'name': 'Evaluate TransferWithTimeout timeout (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -289,9 +289,13 @@ export const fixtures: Fixture[] = [
       const contractUtxo = randomUtxo();
       provider.addUtxo(contract.address, contractUtxo);
 
+      const hardcodedFee = 1000n;
+      const changeAmount = contractUtxo.satoshis - 10_000n - hardcodedFee;
+
       const tx = new TransactionBuilder({ provider })
         .addInput(contractUtxo, contract.unlock.receive())
-        .addOutput({ to: contract.address, amount: 10000n })
+        .addOutput({ to: aliceAddress, amount: 10_000n })
+        .addOutput({ to: contract.address, amount: changeAmount })
         .setLocktime(133700);
 
       return tx;
@@ -305,7 +309,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'Mecenas_parameters_input0': {
+        'Mecenas_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'Mecenas (input #0)',
           'scripts': [
@@ -339,7 +343,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'Mecenas_receive_input0_unlock': {
           'passes': [
-            'Mecenas_receive_evaluate',
+            'Mecenas_receive_input0_evaluate',
           ],
           'name': 'receive (input #0)',
           'script': '// "receive" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
@@ -352,8 +356,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'Mecenas_receive_evaluate': {
-          'name': 'Mecenas_receive_evaluate',
+        'Mecenas_receive_input0_evaluate': {
+          'name': 'Evaluate Mecenas receive (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -381,6 +385,10 @@ export const fixtures: Fixture[] = [
             ],
             'locktime': 133700,
             'outputs': [
+              {
+                'lockingBytecode': '76a914512dbb2c8c02efbac8d92431aa0ac33f6b0bf97088ac',
+                'valueSatoshis': 10000,
+              },
               {
                 'lockingBytecode': {
                   'script': 'Mecenas_lock',
@@ -392,7 +400,7 @@ export const fixtures: Fixture[] = [
                     },
                   },
                 },
-                'valueSatoshis': 10000,
+                'valueSatoshis': expect.any(Number),
               },
             ],
             'version': 2,
@@ -437,7 +445,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'P2PKH_parameters_input0': {
+        'P2PKH_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #0)',
           'scripts': [
@@ -462,7 +470,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'P2PKH_parameters_input1': {
+        'P2PKH_input1_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #1)',
           'scripts': [
@@ -491,7 +499,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'P2PKH_spend_input0_unlock': {
           'passes': [
-            'P2PKH_spend_evaluate',
+            'P2PKH_spend_input0_evaluate',
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
@@ -504,7 +512,7 @@ export const fixtures: Fixture[] = [
         },
         'P2PKH_spend_input1_unlock': {
           'passes': [
-            'P2PKH_spend_evaluate1',
+            'P2PKH_spend_input1_evaluate',
           ],
           'name': 'spend (input #1)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
@@ -512,8 +520,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'P2PKH_spend_evaluate': {
-          'name': 'P2PKH_spend_evaluate',
+        'P2PKH_spend_input0_evaluate': {
+          'name': 'Evaluate P2PKH spend (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -589,8 +597,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'P2PKH_spend_evaluate1': {
-          'name': 'P2PKH_spend_evaluate',
+        'P2PKH_spend_input1_evaluate': {
+          'name': 'Evaluate P2PKH spend (input #1)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -696,7 +704,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'P2PKH_parameters_input0': {
+        'P2PKH_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #0)',
           'scripts': [
@@ -725,7 +733,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'P2PKH_spend_input0_unlock': {
           'passes': [
-            'P2PKH_spend_evaluate',
+            'P2PKH_spend_input0_evaluate',
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<s> // sig = <0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61>\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
@@ -738,8 +746,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'P2PKH_spend_evaluate': {
-          'name': 'P2PKH_spend_evaluate',
+        'P2PKH_spend_input0_evaluate': {
+          'name': 'Evaluate P2PKH spend (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -820,7 +828,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'P2PKH_parameters_input0': {
+        'P2PKH_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #0)',
           'scripts': [
@@ -845,7 +853,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'P2PKH_parameters_input1': {
+        'P2PKH_input1_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #1)',
           'scripts': [
@@ -874,7 +882,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'P2PKH_spend_input0_unlock': {
           'passes': [
-            'P2PKH_spend_evaluate',
+            'P2PKH_spend_input0_evaluate',
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
@@ -887,7 +895,7 @@ export const fixtures: Fixture[] = [
         },
         'P2PKH_spend_input1_unlock': {
           'passes': [
-            'P2PKH_spend_evaluate1',
+            'P2PKH_spend_input1_evaluate',
           ],
           'name': 'spend (input #1)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
@@ -895,8 +903,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'P2PKH_spend_evaluate': {
-          'name': 'P2PKH_spend_evaluate',
+        'P2PKH_spend_input0_evaluate': {
+          'name': 'Evaluate P2PKH spend (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -971,7 +979,7 @@ export const fixtures: Fixture[] = [
               'valueSatoshis': 1000,
               'token': {
                 'amount': '0',
-                'category':  expect.stringMatching(/^[0-9a-f]{64}$/),
+                'category': expect.stringMatching(/^[0-9a-f]{64}$/),
                 'nft': {
                   'capability': 'none',
                   'commitment': expect.stringMatching(/^[0-9a-f]{8}$/),
@@ -980,8 +988,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'P2PKH_spend_evaluate1': {
-          'name': 'P2PKH_spend_evaluate',
+        'P2PKH_spend_input1_evaluate': {
+          'name': 'Evaluate P2PKH spend (input #1)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1099,7 +1107,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'HodlVault_parameters_input0': {
+        'HodlVault_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'HodlVault (input #0)',
           'scripts': [
@@ -1148,7 +1156,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'HodlVault_spend_input0_unlock': {
           'passes': [
-            'HodlVault_spend_evaluate',
+            'HodlVault_spend_input0_evaluate',
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<oracleMessage> // bytes8 = <0xa086010030750000>\n<oracleSig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<ownerSig.schnorr_signature.all_outputs_all_utxos> // sig\n',
@@ -1161,8 +1169,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'HodlVault_spend_evaluate': {
-          'name': 'HodlVault_spend_evaluate',
+        'HodlVault_spend_input0_evaluate': {
+          'name': 'Evaluate HodlVault spend (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1257,11 +1265,12 @@ export const fixtures: Fixture[] = [
       const to = contract.tokenAddress;
       const amount = 1000n;
 
+      const aliceDefaultTemplate = new SignatureTemplate(alicePriv);
       const aliceCustomTemplate = new SignatureTemplate(alicePriv, HashType.SIGHASH_NONE, SignatureAlgorithm.ECDSA);
       const bobCustomTemplate = new SignatureTemplate(bobPriv, HashType.SIGHASH_ALL, SignatureAlgorithm.ECDSA);
 
       const tx = new TransactionBuilder({ provider })
-        .addInput(p2pkhUtxo, new SignatureTemplate(alicePriv).unlockP2PKH())
+        .addInput(p2pkhUtxo, aliceDefaultTemplate.unlockP2PKH())
         .addInput(contractUtxo, contract.unlock.spend(alicePub, aliceCustomTemplate))
         .addInput(p2pkhUtxo, bobCustomTemplate.unlockP2PKH())
         .addOutput({ to, amount });
@@ -1277,7 +1286,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'P2PKH_parameters_input1': {
+        'P2PKH_input1_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #1)',
           'scripts': [
@@ -1336,7 +1345,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'P2PKH_spend_input1_unlock': {
           'passes': [
-            'P2PKH_spend_evaluate',
+            'P2PKH_spend_input1_evaluate',
           ],
           'name': 'spend (input #1)',
           'script': '// "spend" function parameters\n<s.ecdsa_signature.no_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
@@ -1369,8 +1378,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'P2PKH_spend_evaluate': {
-          'name': 'P2PKH_spend_evaluate',
+        'P2PKH_spend_input1_evaluate': {
+          'name': 'Evaluate P2PKH spend (input #1)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1414,7 +1423,16 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'script': 'p2pkh_placeholder_unlock_2',
+                  'overrides': {
+                    'keys': {
+                      'privateKeys': {
+                        'placeholder_key_2': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                },
               },
             ],
             'locktime': 0,
@@ -1454,7 +1472,16 @@ export const fixtures: Fixture[] = [
               'valueSatoshis': expect.any(Number),
             },
             {
-              'lockingBytecode': {},
+              'lockingBytecode': {
+                'script': 'p2pkh_placeholder_lock_2',
+                'overrides': {
+                  'keys': {
+                    'privateKeys': {
+                      'placeholder_key_2': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                    },
+                  },
+                },
+              },
               'valueSatoshis': expect.any(Number),
             },
           ],
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index 9dc704dd..0c03e042 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -67,7 +67,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'Bar_parameters_input3': {
+        'Bar_input3_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #3)',
           'scripts': [
@@ -87,7 +87,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'Bar_parameters_input4': {
+        'Bar_input4_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #4)',
           'scripts': [
@@ -117,7 +117,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'Foo_parameters_input5': {
+        'Foo_input5_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'Foo (input #5)',
           'scripts': [
@@ -142,7 +142,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'Bar_parameters_input6': {
+        'Bar_input6_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #6)',
           'scripts': [
@@ -211,7 +211,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'Bar_funcA_input3_unlock': {
           'passes': [
-            'Bar_funcA_evaluate',
+            'Bar_funcA_input3_evaluate',
           ],
           'name': 'funcA (input #3)',
           'script': '// "funcA" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
@@ -224,7 +224,7 @@ export const fixtures: Fixture[] = [
         },
         'Bar_execute_input4_unlock': {
           'passes': [
-            'Bar_execute_evaluate',
+            'Bar_execute_input4_evaluate',
           ],
           'name': 'execute (input #4)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// function index in contract\n<function_index> // int = <2>\n',
@@ -232,7 +232,7 @@ export const fixtures: Fixture[] = [
         },
         'Foo_execute_input5_unlock': {
           'passes': [
-            'Foo_execute_evaluate',
+            'Foo_execute_input5_evaluate',
           ],
           'name': 'execute (input #5)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n',
@@ -245,7 +245,7 @@ export const fixtures: Fixture[] = [
         },
         'Bar_funcB_input6_unlock': {
           'passes': [
-            'Bar_funcB_evaluate',
+            'Bar_funcB_input6_evaluate',
           ],
           'name': 'funcB (input #6)',
           'script': '// "funcB" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <1>\n',
@@ -283,8 +283,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'Bar_funcA_evaluate': {
-          'name': 'Bar_funcA_evaluate',
+        'Bar_funcA_input3_evaluate': {
+          'name': 'Evaluate Bar funcA (input #3)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -492,8 +492,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'Bar_execute_evaluate': {
-          'name': 'Bar_execute_evaluate',
+        'Bar_execute_input4_evaluate': {
+          'name': 'Evaluate Bar execute (input #4)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -704,8 +704,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'Foo_execute_evaluate': {
-          'name': 'Foo_execute_evaluate',
+        'Foo_execute_input5_evaluate': {
+          'name': 'Evaluate Foo execute (input #5)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -915,8 +915,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'Bar_funcB_evaluate': {
-          'name': 'Bar_funcB_evaluate',
+        'Bar_funcB_input6_evaluate': {
+          'name': 'Evaluate Bar funcB (input #6)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1151,7 +1151,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'Bar_parameters_input0': {
+        'Bar_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #0)',
           'scripts': [
@@ -1175,7 +1175,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'Bar_funcA_input0_unlock': {
           'passes': [
-            'Bar_funcA_evaluate',
+            'Bar_funcA_input0_evaluate',
           ],
           'name': 'funcA (input #0)',
           'script': '// "funcA" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
@@ -1188,8 +1188,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'Bar_funcA_evaluate': {
-          'name': 'Bar_funcA_evaluate',
+        'Bar_funcA_input0_evaluate': {
+          'name': 'Evaluate Bar funcA (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1272,7 +1272,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'HodlVault_parameters_input0': {
+        'HodlVault_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'HodlVault (input #0)',
           'scripts': [
@@ -1317,7 +1317,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'TransferWithTimeout_parameters_input1': {
+        'TransferWithTimeout_input1_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #1)',
           'scripts': [
@@ -1356,7 +1356,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'HodlVault_spend_input0_unlock': {
           'passes': [
-            'HodlVault_spend_evaluate',
+            'HodlVault_spend_input0_evaluate',
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<oracleMessage> // bytes8 = <0xa086010030750000>\n<oracleSig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<ownerSig.schnorr_signature.all_outputs_all_utxos> // sig\n',
@@ -1369,7 +1369,7 @@ export const fixtures: Fixture[] = [
         },
         'TransferWithTimeout_timeout_input1_unlock': {
           'passes': [
-            'TransferWithTimeout_timeout_evaluate',
+            'TransferWithTimeout_timeout_input1_evaluate',
           ],
           'name': 'timeout (input #1)',
           'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
@@ -1382,8 +1382,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'HodlVault_spend_evaluate': {
-          'name': 'HodlVault_spend_evaluate',
+        'HodlVault_spend_input0_evaluate': {
+          'name': 'Evaluate HodlVault spend (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1460,8 +1460,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'TransferWithTimeout_timeout_evaluate': {
-          'name': 'TransferWithTimeout_timeout_evaluate',
+        'TransferWithTimeout_timeout_input1_evaluate': {
+          'name': 'Evaluate TransferWithTimeout timeout (input #1)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1571,7 +1571,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'TransferWithTimeout_parameters_input0': {
+        'TransferWithTimeout_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #0)',
           'scripts': [
@@ -1606,7 +1606,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'TransferWithTimeout_parameters_input1': {
+        'TransferWithTimeout_input1_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #1)',
           'scripts': [
@@ -1641,7 +1641,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'TransferWithTimeout_parameters_input2': {
+        'TransferWithTimeout_input2_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #2)',
           'scripts': [
@@ -1676,7 +1676,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'TransferWithTimeout_parameters_input3': {
+        'TransferWithTimeout_input3_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #3)',
           'scripts': [
@@ -1715,7 +1715,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'TransferWithTimeout_timeout_input0_unlock': {
           'passes': [
-            'TransferWithTimeout_timeout_evaluate',
+            'TransferWithTimeout_timeout_input0_evaluate',
           ],
           'name': 'timeout (input #0)',
           'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
@@ -1728,7 +1728,7 @@ export const fixtures: Fixture[] = [
         },
         'TransferWithTimeout_timeout_input1_unlock': {
           'passes': [
-            'TransferWithTimeout_timeout_evaluate1',
+            'TransferWithTimeout_timeout_input1_evaluate',
           ],
           'name': 'timeout (input #1)',
           'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
@@ -1736,7 +1736,7 @@ export const fixtures: Fixture[] = [
         },
         'TransferWithTimeout_transfer_input2_unlock': {
           'passes': [
-            'TransferWithTimeout_transfer_evaluate',
+            'TransferWithTimeout_transfer_input2_evaluate',
           ],
           'name': 'transfer (input #2)',
           'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
@@ -1744,7 +1744,7 @@ export const fixtures: Fixture[] = [
         },
         'TransferWithTimeout_transfer_input3_unlock': {
           'passes': [
-            'TransferWithTimeout_transfer_evaluate1',
+            'TransferWithTimeout_transfer_input3_evaluate',
           ],
           'name': 'transfer (input #3)',
           'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
@@ -1752,8 +1752,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'TransferWithTimeout_timeout_evaluate': {
-          'name': 'TransferWithTimeout_timeout_evaluate',
+        'TransferWithTimeout_timeout_input0_evaluate': {
+          'name': 'Evaluate TransferWithTimeout timeout (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1865,8 +1865,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'TransferWithTimeout_timeout_evaluate1': {
-          'name': 'TransferWithTimeout_timeout_evaluate',
+        'TransferWithTimeout_timeout_input1_evaluate': {
+          'name': 'Evaluate TransferWithTimeout timeout (input #1)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -1978,8 +1978,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'TransferWithTimeout_transfer_evaluate': {
-          'name': 'TransferWithTimeout_transfer_evaluate',
+        'TransferWithTimeout_transfer_input2_evaluate': {
+          'name': 'Evaluate TransferWithTimeout transfer (input #2)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -2091,8 +2091,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'TransferWithTimeout_transfer_evaluate1': {
-          'name': 'TransferWithTimeout_transfer_evaluate',
+        'TransferWithTimeout_transfer_input3_evaluate': {
+          'name': 'Evaluate TransferWithTimeout transfer (input #3)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -2234,7 +2234,7 @@ export const fixtures: Fixture[] = [
       ],
       'version': 0,
       'entities': {
-        'Bar_parameters_input0': {
+        'Bar_input0_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #0)',
           'scripts': [
@@ -2264,7 +2264,7 @@ export const fixtures: Fixture[] = [
             },
           },
         },
-        'Bar_parameters_input1': {
+        'Bar_input1_parameters': {
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #1)',
           'scripts': [
@@ -2298,7 +2298,7 @@ export const fixtures: Fixture[] = [
       'scripts': {
         'Bar_execute_input0_unlock': {
           'passes': [
-            'Bar_execute_evaluate',
+            'Bar_execute_input0_evaluate',
           ],
           'name': 'execute (input #0)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// function index in contract\n<function_index> // int = <2>\n',
@@ -2311,7 +2311,7 @@ export const fixtures: Fixture[] = [
         },
         'Bar_execute_input1_unlock': {
           'passes': [
-            'Bar_execute_evaluate1',
+            'Bar_execute_input1_evaluate',
           ],
           'name': 'execute (input #1)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// function index in contract\n<function_index> // int = <2>\n',
@@ -2319,8 +2319,8 @@ export const fixtures: Fixture[] = [
         },
       },
       'scenarios': {
-        'Bar_execute_evaluate': {
-          'name': 'Bar_execute_evaluate',
+        'Bar_execute_input0_evaluate': {
+          'name': 'Evaluate Bar execute (input #0)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
@@ -2389,8 +2389,8 @@ export const fixtures: Fixture[] = [
             },
           ],
         },
-        'Bar_execute_evaluate1': {
-          'name': 'Bar_execute_evaluate',
+        'Bar_execute_input1_evaluate': {
+          'name': 'Evaluate Bar execute (input #1)',
           'description': 'An example evaluation where this script execution passes.',
           'data': {
             'bytecode': {
diff --git a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
index 87d07c63..7abdb0e9 100644
--- a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
+++ b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
@@ -1,7 +1,7 @@
 import { fixtures } from '../fixture/libauth-template/fixtures.js';
 import { fixtures as oldFixtures } from '../fixture/libauth-template/old-fixtures.js';
 
-describe('Libauth Template generation tests', () => {
+describe('Libauth Template generation tests (single-contract)', () => {
   fixtures.forEach((fixture) => {
     it(`should generate a valid libauth template for ${fixture.name}`, () => {
       const generatedTemplate = fixture.transaction.getLibauthTemplate();

From 8f0a80821d11881e9f780c626323f24bd289c19a Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 28 Mar 2025 11:29:00 +0100
Subject: [PATCH 213/267] Add more test cases to multi-contract-debugging tests

---
 .../test/multi-contract-debugging.test.ts     | 65 ++++++++++++++++++-
 1 file changed, 63 insertions(+), 2 deletions(-)

diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index 8862fbf6..e988947e 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -6,6 +6,7 @@ import {
   TransactionBuilder,
 } from './../src/index.js';
 import {
+  alicePub,
   bobAddress,
   bobPkh,
   bobPriv,
@@ -21,10 +22,70 @@ const provider = new MockNetworkProvider();
 
 describe('Multi-Contract-Debugging tests', () => {
   describe('require statements', () => {
+    it('it should not throw an error if no require statement fails', async () => {
+      const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
+      const bigintContract = new Contract(bigintArtifact, [], { provider });
+
+      const MAX_INT64 = BigInt('9223372036854775807');
+
+      (provider as any).addUtxo?.(p2pkhContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bigintContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bobAddress, randomUtxo());
+
+      const to = p2pkhContract.address;
+      const amount = 10000n;
+      const p2pkhContractUtxos = await p2pkhContract.getUtxos();
+      const bigIntContractUtxos = await bigintContract.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const transaction = new TransactionBuilder({ provider })
+        // wrong public key
+        .addInput(p2pkhContractUtxos[0], p2pkhContract.unlock.spend(bobPub, bobSignatureTemplate))
+        .addInput(bigIntContractUtxos[0], bigintContract.unlock.proofOfBigInt(MAX_INT64 + 1n, 1n))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount });
+
+      console.warn(transaction.bitauthUri());
+
+      await expect(transaction).toFailRequire();
+      // throw new Error('test');
+    });
+
+    it('it should fail if a require statement fails', async () => {
+      const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
+      const bigintContract = new Contract(bigintArtifact, [], { provider });
+
+      const MAX_INT64 = BigInt('9223372036854775807');
+
+      (provider as any).addUtxo?.(p2pkhContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bigintContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bobAddress, randomUtxo());
+
+      const to = p2pkhContract.address;
+      const amount = 10000n;
+      const p2pkhContractUtxos = await p2pkhContract.getUtxos();
+      const bigIntContractUtxos = await bigintContract.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const transaction = new TransactionBuilder({ provider })
+        // wrong public key
+        .addInput(p2pkhContractUtxos[0], p2pkhContract.unlock.spend(alicePub, bobSignatureTemplate))
+        .addInput(bigIntContractUtxos[0], bigintContract.unlock.proofOfBigInt(MAX_INT64 + 1n, 1n))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount });
+
+      console.warn(transaction.bitauthUri());
+
+      await expect(transaction).toFailRequire();
+      // throw new Error('test');
+    });
+
     it('it should only fail with correct error message when a final verify fails', async () => {
       const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
       const bigintContract = new Contract(bigintArtifact, [], { provider });
-      
+
       const MAX_INT64 = BigInt('9223372036854775807');
 
       (provider as any).addUtxo?.(p2pkhContract.address, randomUtxo());
@@ -45,7 +106,7 @@ describe('Multi-Contract-Debugging tests', () => {
         .addOutput({ to, amount });
 
       console.warn(transaction.bitauthUri());
-      
+
       await expect(transaction).toFailRequire();
     });
   });

From 73a9cb197dc7435624c42175d780bea20008c4a3 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 1 Apr 2025 11:51:50 +0200
Subject: [PATCH 214/267] Fix bug with missing unlockingBytecode in scenario
 transaction inputs

- Update Unlocker typings for better typescript usage
- Update generateTemplateScenarioBytecode to add unlockingBytecode data
  for P2SH inputs
- Update 1 fixture, rest still needs updating
- Small refactors to advanced libauth template generation
---
 packages/cashscript/src/LibauthTemplate.ts    |  52 +++----
 .../src/advanced/LibauthTemplate.ts           | 128 ++++++++++++------
 packages/cashscript/src/interfaces.ts         |  18 ++-
 .../multi-contract-fixtures.ts                |  37 ++++-
 .../test/multi-contract-debugging.test.ts     |   6 +-
 5 files changed, 165 insertions(+), 76 deletions(-)

diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 4dccd760..4f5cb0c2 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -40,6 +40,7 @@ import { Transaction } from './Transaction.js';
 import { EncodedConstructorArgument, EncodedFunctionArgument } from './Argument.js';
 import { addressToLockScript, extendedStringify, zip } from './utils.js';
 import { Contract } from './Contract.js';
+import { generateUnlockingScriptParams } from './advanced/LibauthTemplate.js';
 
 interface BuildTemplateOptions {
   transaction: Transaction;
@@ -257,6 +258,7 @@ const generateTemplateScenarios = (
       data: {
         // encode values for the variables defined above in `entities` property
         bytecode: {
+          ...generateTemplateScenarioParametersFunctionIndex(abiFunction, artifact.abi),
           ...generateTemplateScenarioParametersValues(abiFunction.inputs, encodedFunctionArgs),
           ...generateTemplateScenarioParametersValues(artifact.constructorInputs, encodedConstructorArgs),
         },
@@ -271,11 +273,6 @@ const generateTemplateScenarios = (
     },
   };
 
-  if (artifact.abi.length > 1) {
-    const functionIndex = artifact.abi.findIndex((func) => func.name === transaction.abiFunction.name);
-    scenarios![artifact.contractName + '_evaluate'].data!.bytecode!.function_index = functionIndex.toString();
-  }
-
   return scenarios;
 };
 
@@ -286,14 +283,14 @@ const generateTemplateScenarioTransaction = (
 ): WalletTemplateScenario['transaction'] => {
   const slotIndex = csTransaction.inputs.findIndex((input) => !isUtxoP2PKH(input));
 
-  const inputs = libauthTransaction.inputs.map((input, index) => {
-    const csInput = csTransaction.inputs[index] as Utxo;
+  const inputs = libauthTransaction.inputs.map((input, inputIndex) => {
+    const csInput = csTransaction.inputs[inputIndex] as Utxo;
 
     return {
       outpointIndex: input.outpointIndex,
       outpointTransactionHash: binToHex(input.outpointTransactionHash),
       sequenceNumber: input.sequenceNumber,
-      unlockingBytecode: generateTemplateScenarioBytecode(csInput, `p2pkh_placeholder_unlock_${index}`, `placeholder_key_${index}`, index === slotIndex),
+      unlockingBytecode: generateTemplateScenarioBytecode(csInput, inputIndex, 'p2pkh_placeholder_unlock', inputIndex === slotIndex),
     } as WalletTemplateScenarioInput;
   });
 
@@ -337,14 +334,15 @@ export const generateTemplateScenarioTransactionOutputLockingBytecode = (
  * The slotIndex tracks which input is the contract input vs P2PKH inputs
  * to properly generate the locking scripts.
  */
+// TODO: This looks like it needs some refactor to work with the new stuff
 const generateTemplateScenarioSourceOutputs = (
   csTransaction: Transaction,
 ): Array<WalletTemplateScenarioOutput<true>> => {
   const slotIndex = csTransaction.inputs.findIndex((input) => !isUtxoP2PKH(input));
 
-  return csTransaction.inputs.map((input, index) => {
+  return csTransaction.inputs.map((input, inputIndex) => {
     return {
-      lockingBytecode: generateTemplateScenarioBytecode(input, `p2pkh_placeholder_lock_${index}`, `placeholder_key_${index}`, index === slotIndex),
+      lockingBytecode: generateTemplateScenarioBytecode(input, inputIndex, 'p2pkh_placeholder_lock', inputIndex === slotIndex),
       valueSatoshis: Number(input.satoshis),
       token: serialiseTokenDetails(input.token),
     };
@@ -353,8 +351,13 @@ const generateTemplateScenarioSourceOutputs = (
 
 // Used for generating the locking / unlocking bytecode for source outputs and inputs
 export const generateTemplateScenarioBytecode = (
-  input: Utxo, p2pkhScriptName: string, placeholderKeyName: string, insertSlot?: boolean,
+  input: Utxo, inputIndex: number, p2pkhScriptNameTemplate: string, insertSlot?: boolean,
 ): WalletTemplateScenarioBytecode | ['slot'] => {
+  if (insertSlot) return ['slot'];
+
+  const p2pkhScriptName = `${p2pkhScriptNameTemplate}_${inputIndex}`;
+  const placeholderKeyName = `placeholder_key_${inputIndex}`;
+
   // This is for P2PKH inputs in the old transaction builder (TODO: remove when we remove old transaction builder)
   if (isUtxoP2PKH(input)) {
     return {
@@ -369,23 +372,13 @@ export const generateTemplateScenarioBytecode = (
     };
   }
 
-  // This is for P2PKH inputs in the new transaction builder
-  if (isUnlockableUtxo(input) && input.unlocker.template) {
-    return {
-      script: p2pkhScriptName,
-      overrides: {
-        keys: {
-          privateKeys: {
-            [placeholderKeyName]: binToHex(input.unlocker.template.privateKey),
-          },
-        },
-      },
-    };
+  if (isUnlockableUtxo(input)) {
+    return generateUnlockingScriptParams(input, p2pkhScriptNameTemplate, inputIndex);
   }
 
   // 'slot' means that we are currently evaluating this specific input,
   // {} means that it is the same script type, but not being evaluated
-  return insertSlot ? ['slot'] : {};
+  return {};
 };
 
 export const generateTemplateScenarioParametersValues = (
@@ -406,6 +399,17 @@ export const generateTemplateScenarioParametersValues = (
   return Object.fromEntries(entries);
 };
 
+export const generateTemplateScenarioParametersFunctionIndex = (
+  abiFunction: AbiFunction,
+  abi: readonly AbiFunction[],
+): Record<string, string> => {
+  const functionIndex = abi.length > 1
+    ? abi.findIndex((func) => func.name === abiFunction.name)
+    : undefined;
+
+  return functionIndex !== undefined ? { function_index: functionIndex.toString() } : {};
+};
+
 export const addHexPrefixExceptEmpty = (value: string): string => {
   return value.length > 0 ? `0x${value}` : '';
 };
diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index a19b61a2..72ccfa29 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -22,6 +22,7 @@ import { Contract } from '../Contract.js';
 import { DebugResults, debugTemplate } from '../debugging.js';
 import {
   AddressType,
+  ContractUnlocker,
   UnlockableUtxo,
   Utxo,
 } from '../interfaces.js';
@@ -31,6 +32,7 @@ import {
   formatParametersForDebugging,
   generateTemplateScenarioBytecode,
   generateTemplateScenarioKeys,
+  generateTemplateScenarioParametersFunctionIndex,
   generateTemplateScenarioParametersValues,
   generateTemplateScenarioTransactionOutputLockingBytecode,
   getHashTypeName,
@@ -85,6 +87,35 @@ export const generateTemplateEntitiesP2SH = (
   encodedFunctionArgs: EncodedFunctionArgument[],
   inputIndex: number,
 ): WalletTemplate['entities'] => {
+  const entities = {
+    [artifact.contractName + '_input' + inputIndex + '_parameters']: {
+      description: 'Contract creation and function parameters',
+      name: `${artifact.contractName} (input #${inputIndex})`,
+      scripts: [
+        artifact.contractName + '_lock',
+        artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock',
+      ],
+      variables: createWalletTemplateVariables(artifact, abiFunction, encodedFunctionArgs),
+    },
+  };
+
+  // function_index is a special variable that indicates the function to execute
+  if (artifact.abi.length > 1) {
+    entities[artifact.contractName + '_input' + inputIndex + '_parameters'].variables.function_index = {
+      description: 'Script function index to execute',
+      name: 'function_index',
+      type: 'WalletData',
+    };
+  }
+
+  return entities;
+};
+
+const createWalletTemplateVariables = (
+  artifact: Artifact,
+  abiFunction: AbiFunction,
+  encodedFunctionArgs: EncodedFunctionArgument[],
+): Record<string, WalletTemplateVariable> => {
   const functionParameters = Object.fromEntries<WalletTemplateVariable>(
     abiFunction.inputs.map((input, index) => ([
       input.name,
@@ -107,31 +138,7 @@ export const generateTemplateEntitiesP2SH = (
     ])),
   );
 
-  const entities = {
-    [artifact.contractName + '_input' + inputIndex + '_parameters']: {
-      description: 'Contract creation and function parameters',
-      name: `${artifact.contractName} (input #${inputIndex})`,
-      scripts: [
-        artifact.contractName + '_lock',
-        artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock',
-      ],
-      variables: {
-        ...functionParameters,
-        ...constructorParameters,
-      },
-    },
-  };
-
-  // function_index is a special variable that indicates the function to execute
-  if (artifact.abi.length > 1) {
-    entities[artifact.contractName + '_input' + inputIndex + '_parameters'].variables.function_index = {
-      description: 'Script function index to execute',
-      name: 'function_index',
-      type: 'WalletData',
-    };
-  }
-
-  return entities;
+  return { ...functionParameters, ...constructorParameters };
 };
 
 /**
@@ -303,14 +310,14 @@ const generateTemplateScenarioTransaction = (
   csTransaction: Transaction,
   slotIndex: number,
 ): WalletTemplateScenario['transaction'] => {
-  const inputs = libauthTransaction.inputs.map((input, index) => {
-    const csInput = csTransaction.inputs[index] as Utxo;
+  const inputs = libauthTransaction.inputs.map((input, inputIndex) => {
+    const csInput = csTransaction.inputs[inputIndex] as Utxo;
 
     return {
       outpointIndex: input.outpointIndex,
       outpointTransactionHash: binToHex(input.outpointTransactionHash),
       sequenceNumber: input.sequenceNumber,
-      unlockingBytecode: generateTemplateScenarioBytecode(csInput, `p2pkh_placeholder_unlock_${index}`, `placeholder_key_${index}`, slotIndex === index),
+      unlockingBytecode: generateTemplateScenarioBytecode(csInput, inputIndex, 'p2pkh_placeholder_unlock', slotIndex === inputIndex),
     } as WalletTemplateScenarioInput;
   });
 
@@ -335,10 +342,9 @@ const generateTemplateScenarioSourceOutputs = (
   csTransaction: Transaction,
   slotIndex: number,
 ): Array<WalletTemplateScenarioOutput<true>> => {
-
-  return csTransaction.inputs.map((input, index) => {
+  return csTransaction.inputs.map((input, inputIndex) => {
     return {
-      lockingBytecode: generateTemplateScenarioBytecode(input, `p2pkh_placeholder_lock_${index}`, `placeholder_key_${index}`, index === slotIndex),
+      lockingBytecode: generateTemplateScenarioBytecode(input, inputIndex, 'p2pkh_placeholder_lock', inputIndex === slotIndex),
       valueSatoshis: Number(input.satoshis),
       token: serialiseTokenDetails(input.token),
     };
@@ -396,7 +402,7 @@ export const getLibauthTemplates = (
 
   for (const [inputIndex, input] of txn.inputs.entries()) {
     // If template exists on the input, it indicates this is a P2PKH (Pay to Public Key Hash) input
-    if (input.unlocker?.template) {
+    if ('template' in input.unlocker) {
       // @ts-ignore TODO: Remove UtxoP2PKH type and only use UnlockableUtxo in Libaith Template generation
       input.template = input.unlocker?.template;  // Added to support P2PKH inputs in buildTemplate
       Object.assign(p2pkhEntities, generateTemplateEntitiesP2PKH(inputIndex));
@@ -406,7 +412,7 @@ export const getLibauthTemplates = (
     }
 
     // If contract exists on the input, it indicates this is a contract input
-    if (input.unlocker?.contract) {
+    if ('contract' in input.unlocker) {
       const contract = input.unlocker?.contract;
       const abiFunction = input.unlocker?.abiFunction;
 
@@ -454,9 +460,8 @@ export const getLibauthTemplates = (
       const lockScriptName = Object.keys(script).find(scriptName => scriptName.includes('_lock'));
       if (lockScriptName) {
         // Generate bytecodes for this contract input
-        const csInput = csTransaction.inputs[inputIndex];
         const unlockingBytecode = binToHex(libauthTransaction.inputs[inputIndex].unlockingBytecode);
-        const lockingScriptParams = generateLockingScriptParams(csInput.unlocker!.contract!, csInput, lockScriptName);
+        const lockingScriptParams = generateLockingScriptParams(input.unlocker.contract, input, lockScriptName);
 
         // Assign a name to the unlocking bytecode so later it can be used to replace the bytecode/slot in scenarios
         unlockingBytecodeToLockingBytecodeParams[unlockingBytecode] = lockingScriptParams;
@@ -525,7 +530,7 @@ export const getLibauthTemplates = (
 
 export const debugLibauthTemplate = (template: WalletTemplate, transaction: TransactionBuilder): DebugResults => {
   const allArtifacts = transaction.inputs
-    .map(input => input.unlocker?.contract)
+    .map(input => 'contract' in input.unlocker ? input.unlocker.contract : undefined)
     .filter((contract): contract is Contract => !!contract)
     .map(contract => contract.artifact);
 
@@ -537,14 +542,19 @@ const generateLockingScriptParams = (
   csInput: UnlockableUtxo,
   lockScriptName: string,
 ): WalletTemplateScenarioBytecode => {
-  if (!csInput.unlocker?.contract) return {
-    script: lockScriptName,
-  };
+  if (('template' in csInput.unlocker)) {
+    return {
+      script: lockScriptName,
+    };
+  }
 
   const constructorParamsEntries = contract.artifact.constructorInputs
     .map(({ name }, index) => [
       name,
-      addHexPrefixExceptEmpty(binToHex(csInput.unlocker!.contract!.encodedConstructorArgs[index])),
+      // TODO: For some reason, typescript forgets that the unlocker is a ContractUnlocker
+      addHexPrefixExceptEmpty(
+        binToHex((csInput.unlocker as ContractUnlocker).contract.encodedConstructorArgs[index]),
+      ),
     ]);
 
   const constructorParams = Object.fromEntries(constructorParamsEntries);
@@ -556,3 +566,41 @@ const generateLockingScriptParams = (
     },
   };
 };
+
+export const generateUnlockingScriptParams = (
+  csInput: UnlockableUtxo,
+  p2pkhScriptNameTemplate: string,
+  inputIndex: number,
+): WalletTemplateScenarioBytecode => {
+  if (('template' in csInput.unlocker)) {
+    return {
+      script: `${p2pkhScriptNameTemplate}_${inputIndex}`,
+      overrides: {
+        keys: {
+          privateKeys: {
+            [`placeholder_key_${inputIndex}`]: binToHex(csInput.unlocker.template.privateKey),
+          },
+        },
+      },
+    };
+  }
+
+  const abiFunction = csInput.unlocker.abiFunction;
+  const contract = csInput.unlocker.contract;
+  const encodedFunctionArgs = encodeFunctionArguments(abiFunction, csInput.unlocker.params);
+
+  return {
+    script: `${csInput.unlocker.contract.name}_${abiFunction.name}_input${inputIndex}_unlock`,
+    overrides: {
+      // encode values for the variables defined above in `entities` property
+      bytecode: {
+        ...generateTemplateScenarioParametersFunctionIndex(abiFunction, contract.artifact.abi),
+        ...generateTemplateScenarioParametersValues(abiFunction.inputs, encodedFunctionArgs),
+        ...generateTemplateScenarioParametersValues(contract.artifact.constructorInputs, contract.encodedConstructorArgs),
+      },
+      keys: {
+        privateKeys: generateTemplateScenarioKeys(abiFunction.inputs, encodedFunctionArgs),
+      },
+    },
+  };
+};
diff --git a/packages/cashscript/src/interfaces.ts b/packages/cashscript/src/interfaces.ts
index 72399fab..65b01c28 100644
--- a/packages/cashscript/src/interfaces.ts
+++ b/packages/cashscript/src/interfaces.ts
@@ -32,15 +32,23 @@ export interface GenerateUnlockingBytecodeOptions {
 }
 
 // TODO: Change this type when we understand the requirements better
-export interface Unlocker {
+export interface BaseUnlocker {
   generateLockingBytecode: () => Uint8Array;
   generateUnlockingBytecode: (options: GenerateUnlockingBytecodeOptions) => Uint8Array;
-  contract?: Contract;
-  params?: FunctionArgument[];
-  abiFunction?: AbiFunction;
-  template?: SignatureTemplate;
 }
 
+export interface ContractUnlocker extends BaseUnlocker {
+  contract: Contract;
+  params: FunctionArgument[];
+  abiFunction: AbiFunction;
+}
+
+export interface P2PKHUnlocker extends BaseUnlocker {
+  template: SignatureTemplate;
+}
+
+export type Unlocker = ContractUnlocker | P2PKHUnlocker;
+
 export interface UtxoP2PKH extends Utxo {
   template: SignatureTemplate;
 }
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index 0c03e042..16c81ef8 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -1416,7 +1416,23 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': expect.any(Number),
-                'unlockingBytecode': {},
+                // TODO: this needs to be added *everywhere*
+                'unlockingBytecode': {
+                  'script': 'TransferWithTimeout_timeout_input1_unlock',
+                  'overrides': {
+                    'bytecode': {
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'timeout': '0xa08601',
+                      'function_index': '1',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'senderSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                },
               },
             ],
             'locktime': 1000000,
@@ -1484,7 +1500,24 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': expect.any(Number),
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'script': 'HodlVault_spend_input0_unlock',
+                  'overrides': {
+                    'bytecode': {
+                      'oracleSig': '0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b',
+                      'oracleMessage': '0xa086010030750000',
+                      'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'oraclePk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'minBlock': '0xb88201',
+                      'priceTarget': '0x3075',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'ownerSig': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index e988947e..1ca7f8c9 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -40,16 +40,12 @@ describe('Multi-Contract-Debugging tests', () => {
 
       // when
       const transaction = new TransactionBuilder({ provider })
-        // wrong public key
         .addInput(p2pkhContractUtxos[0], p2pkhContract.unlock.spend(bobPub, bobSignatureTemplate))
         .addInput(bigIntContractUtxos[0], bigintContract.unlock.proofOfBigInt(MAX_INT64 + 1n, 1n))
         .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
         .addOutput({ to, amount });
 
-      console.warn(transaction.bitauthUri());
-
-      await expect(transaction).toFailRequire();
-      // throw new Error('test');
+      await expect(transaction).not.toFailRequire();
     });
 
     it('it should fail if a require statement fails', async () => {

From a0fb92ebfe4c221b3ccc532d0ce082e4c79434c1 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 1 Apr 2025 12:15:43 +0200
Subject: [PATCH 215/267] Small release notes and migration notes updates

---
 website/docs/releases/migration-notes.md | 6 +++++-
 website/docs/releases/release-notes.md   | 2 +-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/website/docs/releases/migration-notes.md b/website/docs/releases/migration-notes.md
index 34d75027..40e7e25a 100644
--- a/website/docs/releases/migration-notes.md
+++ b/website/docs/releases/migration-notes.md
@@ -4,7 +4,11 @@ title: Migration Notes
 
 ## v0.10 to v0.11
 
-There are several breaking changes to the SDK in this release. They are listed below in their own sections.
+There are several breaking changes to the compiler and SDK in this release. They are listed below in their own sections.
+
+### cashc compiler
+
+`tx.age` was renamed to `this.age` to better reflect that it enforces a UTXO-level locktime check (*not* transaction-level). To migrate, replace all occurrences of `tx.age` with `this.age`.
 
 ### CashScript SDK (Transaction Builder)
 
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 1b9c090e..67cc9945 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,7 +2,7 @@
 title: Release Notes
 ---
 
-## v0.11.0-next.2
+## v0.11.0-next.3
 
 This update adds CashScript support for the new BCH 2025 network upgrade. To read more about the upgrade, see [this blog post](https://blog.bitjson.com/2025-chips/).
 

From 34ae412c888460aa8f533b485c26aeee419c4c87 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 1 Apr 2025 13:06:59 +0200
Subject: [PATCH 216/267] update libauth-template fixtures

---
 .../test/fixture/libauth-template/fixtures.ts |  60 ++-
 .../multi-contract-fixtures.ts                | 408 ++++++++++++++++--
 2 files changed, 438 insertions(+), 30 deletions(-)

diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index a372721b..f8cdf04f 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -550,7 +550,20 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                  'script': 'P2PKH_spend_input1_unlock',
+                },
               },
             ],
             'locktime': expect.any(Number),
@@ -619,7 +632,20 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                  'script': 'P2PKH_spend_input0_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
@@ -933,7 +959,20 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                  'script': 'P2PKH_spend_input1_unlock',
+                },
               },
             ],
             'locktime': 0,
@@ -1010,7 +1049,20 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.stringMatching(/^[0-9a-f]{64}$/),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                  'script': 'P2PKH_spend_input0_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index 16c81ef8..f4442f36 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -356,19 +356,57 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '2',
+                      'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                  'script': 'Bar_execute_input4_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'Foo_execute_input5_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '1',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {},
+                    },
+                  },
+                  'script': 'Bar_funcB_input6_unlock',
+                },
               },
             ],
             'locktime': expect.any(Number),
@@ -560,7 +598,18 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '0',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {},
+                    },
+                  },
+                  'script': 'Bar_funcA_input3_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
@@ -574,13 +623,38 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'Foo_execute_input5_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '1',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {},
+                    },
+                  },
+                  'script': 'Bar_funcB_input6_unlock',
+                },
+
               },
             ],
             'locktime': 0,
@@ -771,13 +845,38 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '0',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {},
+                    },
+                  },
+                  'script': 'Bar_funcA_input3_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '2',
+                      'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                  'script': 'Bar_execute_input4_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
@@ -791,7 +890,19 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '1',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                  
+                    },
+                    'keys': {
+                      'privateKeys': {},
+                    },
+                  },
+                  'script': 'Bar_funcB_input6_unlock',
+                },
               },
             ],
             'locktime': 0,
@@ -980,19 +1091,56 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '0',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {},
+                    },
+                  },
+                  'script': 'Bar_funcA_input3_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '2',
+                      'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                  'script': 'Bar_execute_input4_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0'                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'Foo_execute_input5_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
@@ -1817,19 +1965,64 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '1',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'senderSig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_timeout_input1_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '0',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'recipientSig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_transfer_input2_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '0',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'recipientSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_transfer_input3_unlock',
+                },
               },
             ],
             'locktime': 1000000,
@@ -1922,7 +2115,22 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '1',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'senderSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_timeout_input0_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
@@ -1936,13 +2144,43 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '0',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'recipientSig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_transfer_input2_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '0',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'recipientSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_transfer_input3_unlock',
+                },
               },
             ],
             'locktime': 1000000,
@@ -2035,13 +2273,43 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '1',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'senderSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_timeout_input0_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '1',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'senderSig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_timeout_input1_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
@@ -2055,7 +2323,22 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '0',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'recipientSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_transfer_input3_unlock',
+                },
               },
             ],
             'locktime': 1000000,
@@ -2148,19 +2431,64 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '1',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'senderSig': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_timeout_input0_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '1',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'senderSig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_timeout_input1_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '0',
+                      'recipient': '0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90',
+                      'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'timeout': '0xa08601',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        'recipientSig': '81597823a901865622658cbf6d50c0286aa1d70fa1af98f897e34a0623a828ff',
+                      },
+                    },
+                  },
+                  'script': 'TransferWithTimeout_transfer_input2_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),
@@ -2383,7 +2711,21 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '2',
+                      'pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
+                      },
+                    },
+                  },
+                  'script': 'Bar_execute_input1_unlock',
+                },
               },
             ],
             'locktime': 0,
@@ -2445,7 +2787,21 @@ export const fixtures: Fixture[] = [
                 'outpointIndex': expect.any(Number),
                 'outpointTransactionHash': expect.any(String),
                 'sequenceNumber': 4294967294,
-                'unlockingBytecode': {},
+                'unlockingBytecode': {
+                  'overrides': {
+                    'bytecode': {
+                      'function_index': '2',
+                      'pk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
+                      'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
+                    },
+                    'keys': {
+                      'privateKeys': {
+                        's': '36f8155c559f3a670586bbbf9fd52beef6f96124f5a3a39c167fc24b052d24d7',
+                      },
+                    },
+                  },
+                  'script': 'Bar_execute_input0_unlock',
+                },
               },
               {
                 'outpointIndex': expect.any(Number),

From db17b6670953b4e081e56a3e4870b29af9c927be Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 1 Apr 2025 16:28:17 +0200
Subject: [PATCH 217/267] Bump version to 0.11.0-next.3

---
 examples/package.json               | 6 +++---
 examples/testing-suite/package.json | 6 +++---
 packages/cashc/package.json         | 4 ++--
 packages/cashc/src/index.ts         | 2 +-
 packages/cashscript/package.json    | 4 ++--
 packages/utils/package.json         | 2 +-
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index 15ff2d15..cddc0296 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.11.0-next.2",
+  "version": "0.11.0-next.3",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
     "@types/node": "^22.10.7",
-    "cashc": "^0.11.0-next.2",
-    "cashscript": "^0.11.0-next.2",
+    "cashc": "^0.11.0-next.3",
+    "cashscript": "^0.11.0-next.3",
     "eslint": "^8.56.0",
     "typescript": "^5.7.3"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index f266d9aa..397f08e0 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.11.0-next.2",
+  "version": "0.11.0-next.3",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -26,8 +26,8 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "cashc": "^0.11.0-next.2",
-    "cashscript": "^0.11.0-next.2",
+    "cashc": "^0.11.0-next.3",
+    "cashscript": "^0.11.0-next.3",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index f0bad7ab..4e622ed1 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.11.0-next.2",
+  "version": "0.11.0-next.3",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.2",
+    "@cashscript/utils": "^0.11.0-next.3",
     "antlr4": "^4.13.2",
     "commander": "^13.1.0",
     "semver": "^7.6.3"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 12e4a4e2..1210a864 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.11.0-next.2';
+export const version = '0.11.0-next.3';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 91dc6bc3..eb852369 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.11.0-next.2",
+  "version": "0.11.0-next.3",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.2",
+    "@cashscript/utils": "^0.11.0-next.3",
     "@electrum-cash/network": "^4.1.1",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "delay": "^6.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 85594dae..fe9707fe 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.11.0-next.2",
+  "version": "0.11.0-next.3",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From a8ba6b15e5e5b98cd865933dcd42a06ae1c772d8 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 2 Apr 2025 08:42:38 +0200
Subject: [PATCH 218/267] add failing test case

---
 packages/cashscript/test/multi-contract-debugging.test.ts | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index 1ca7f8c9..cb247132 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -74,8 +74,7 @@ describe('Multi-Contract-Debugging tests', () => {
 
       console.warn(transaction.bitauthUri());
 
-      await expect(transaction).toFailRequire();
-      // throw new Error('test');
+      await expect(transaction).toFailRequireWith('P2PKH.cash:4 Require statement failed at input 0 in contract P2PKH.cash at line 4.');
     });
 
     it('it should only fail with correct error message when a final verify fails', async () => {
@@ -103,7 +102,7 @@ describe('Multi-Contract-Debugging tests', () => {
 
       console.warn(transaction.bitauthUri());
 
-      await expect(transaction).toFailRequire();
+      await expect(transaction).toFailRequireWith('BigInt.cash');
     });
   });
 });

From 77cc27d0d0203e91c946b9fee818865a1b50a677 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 2 Apr 2025 11:02:11 +0200
Subject: [PATCH 219/267] docs: update int-to-bytes table

---
 website/docs/language/types.md | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index 1431aaa5..76029f1a 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -185,12 +185,14 @@ Using `bytes20 placeholderPkh= bytes20(0)` will generate a 20 byte zero-array pr
 `bytes20 placeholderPkh= 0x0000000000000000000000000000000000000000` will actually take 20 bytes of space in your contract.
 :::
 
-Casting an integer to a fixed-size byte-length can be a very important when storing local state in an nftCommitment. Developers need to consider what the preferable fixed-size length is for each indivual case depending on the interger range. Below we add a table with information on the maximum integer size for satoshis and fungible CashTokens:
-
-| Integer Type    | Maximum amount         | Max Byte Size                      |
-| --------------  | ---------------------- | ---------------------------------- |
-| Satoshis        | 2.1 quadrillion        | 6 bytes (5 bytes for 1 quadrillion)|
-| CashTokens      | 9223 quadrillion       | 8 bytes for max supply token       |
+Casting an integer to a fixed-size byte-length can be a very important when storing local state in an nftCommitment. When casting a script number to bytes, developers need to consider what the preferable fixed-size length is for each indivual case depending on the interger range. Below we add a table with info on the maximum integer size for common cases:
+
+| Integer Type    | Max integer value                  | Max Byte Size in Script Number Format  |
+| --------------  | -----------------------------------| ---------------------------------------|
+| Satoshis        | 2.1 quadrillion (21,000,000 BCH)   | 7 bytes                                |
+| CashTokens      | 9.2 quintillion (`2^63 - 1`)       | 8 bytes for max supply token           |
+| Locktime        | 4 bytes uInt (`2^32 - 1`)          | 5 bytes                                |
+| SequenceNumber  | 4 bytes uInt (`2^32 - 1`)          | 5 bytes                                |
 
 :::info
 VM numbers follow Script Number format (A.K.A. CSCriptNum), to convert VM number to bytes or the reverse, it's recommended to use helper functions for these conversions from libraries like Libauth.

From 480b261ffa1f4833bb1a9dff2224f7b04525ab14 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 3 Apr 2025 09:46:38 +0200
Subject: [PATCH 220/267] add multi-contract debugging tests

---
 .../test/multi-contract-debugging.test.ts     | 58 ++++++++++++++++++-
 1 file changed, 56 insertions(+), 2 deletions(-)

diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index cb247132..7a8bda66 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -48,7 +48,7 @@ describe('Multi-Contract-Debugging tests', () => {
       await expect(transaction).not.toFailRequire();
     });
 
-    it('it should fail if a require statement fails', async () => {
+    it('it should fail with correct error message if a require statement fails in contract 1', async () => {
       const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
       const bigintContract = new Contract(bigintArtifact, [], { provider });
 
@@ -77,7 +77,61 @@ describe('Multi-Contract-Debugging tests', () => {
       await expect(transaction).toFailRequireWith('P2PKH.cash:4 Require statement failed at input 0 in contract P2PKH.cash at line 4.');
     });
 
-    it('it should only fail with correct error message when a final verify fails', async () => {
+    it('it should fail with correct error message if a require statement in contract 2', async () => {
+      const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
+      const bigintContract = new Contract(bigintArtifact, [], { provider });
+
+      (provider as any).addUtxo?.(p2pkhContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bigintContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bobAddress, randomUtxo());
+
+      const to = p2pkhContract.address;
+      const amount = 10000n;
+      const p2pkhContractUtxos = await p2pkhContract.getUtxos();
+      const bigIntContractUtxos = await bigintContract.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(p2pkhContractUtxos[0], p2pkhContract.unlock.spend(bobPub, bobSignatureTemplate))
+        .addInput(bigIntContractUtxos[0], bigintContract.unlock.proofOfBigInt(1n, 1n))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount });
+
+      console.warn(transaction.bitauthUri());
+
+      await expect(transaction).toFailRequireWith('BigInt.cash:4 Require statement failed at input 1 in contract BigInt.cash at line 4.');
+    });
+
+    it('it should fail with correct error message when a final verify fails in contract 1', async () => {
+      const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
+      const bigintContract = new Contract(bigintArtifact, [], { provider });
+
+      const MAX_INT64 = BigInt('9223372036854775807');
+
+      (provider as any).addUtxo?.(p2pkhContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bigintContract.address, randomUtxo());
+      (provider as any).addUtxo?.(bobAddress, randomUtxo());
+
+      const to = p2pkhContract.address;
+      const amount = 10000n;
+      const p2pkhContractUtxos = await p2pkhContract.getUtxos();
+      const bigIntContractUtxos = await bigintContract.getUtxos();
+      const bobAddressUtxos = await provider.getUtxos(bobAddress);
+
+      // when
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(p2pkhContractUtxos[0], p2pkhContract.unlock.spend(bobPub, Uint8Array.from(Array(0))))
+        .addInput(bigIntContractUtxos[0], bigintContract.unlock.proofOfBigInt(MAX_INT64 + 1n, -1n))
+        .addInput(bobAddressUtxos[0], bobSignatureTemplate.unlockP2PKH())
+        .addOutput({ to, amount });
+
+      console.warn(transaction.bitauthUri());
+
+      await expect(transaction).toFailRequireWith('P2PKH.cash:5 Require statement failed at input 0 in contract P2PKH.cash at line 5');
+    });
+
+    it('it should fail with correct error message when a final verify fails in contract 2', async () => {
       const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
       const bigintContract = new Contract(bigintArtifact, [], { provider });
 

From d348f0bf22e544246106816130f0e96a6b1b9da9 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 11 Apr 2025 10:38:35 +0200
Subject: [PATCH 221/267] Fix bug in final verify checks + refactor

---
 packages/cashscript/src/debugging.ts | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 70bab181..01147160 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -28,6 +28,8 @@ export const debugTemplate = (template: WalletTemplate, artifacts: Artifact[]):
     }
   }
 
+  verifyFullTransaction(template);
+
   return results;
 };
 
@@ -88,8 +90,10 @@ const debugSingleScenario = (
     );
   }
 
-  const evaluationResult = vm.verify(program);
+  // Evaluate the final program state to see if it evaluated successfully
+  const evaluationResult = vm.stateSuccess(lastExecutedDebugStep);
 
+  // Check if the evaluation failed matches any of the possible failure cases
   if (failedFinalVerify(evaluationResult)) {
     const finalExecutedVerifyIp = getFinalExecutedVerifyIp(executedDebugSteps);
 
@@ -251,3 +255,25 @@ const getFinalExecutedVerifyIp = (executedDebugSteps: AuthenticationProgramState
   const finalExecutedVerifyIp = finalExecutedNonCleanupStep.ip + 1;
   return finalExecutedVerifyIp;
 };
+
+// After debugging, we want to verify the full transaction to ensure it is valid (this catches any errors that are not
+// necessarily script errors)
+const verifyFullTransaction = (template: WalletTemplate): void => {
+  const placeholderScriptId = Object.keys(template.scripts).find((key) => 'unlocks' in template.scripts[key]);
+  const placeholderScenarioId = (template.scripts[placeholderScriptId ?? ''] as WalletTemplateScriptUnlocking)?.passes?.[0];
+
+  if (!placeholderScenarioId || !placeholderScriptId) {
+    throw new Error('No placeholder scenario ID or script ID found');
+  }
+
+  const { vm, program } = createProgram(template, placeholderScriptId, placeholderScenarioId);
+
+  const verificationResult = vm.verify({
+    sourceOutputs: program.sourceOutputs,
+    transaction: program.transaction,
+  });
+
+  if (typeof verificationResult === 'string') {
+    throw new FailedTransactionError(verificationResult, getBitauthUri(template));
+  }
+};

From 1fdc36ca01a59a3f1adc6ebb7490e350a4095309 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 11 Apr 2025 10:55:34 +0200
Subject: [PATCH 222/267] Small package.json updates

---
 packages/cashc/package.json      | 4 +++-
 packages/cashscript/package.json | 4 +++-
 packages/utils/package.json      | 6 +++++-
 3 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 4e622ed1..57d24e4f 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -7,7 +7,8 @@
     "bitcoin cash",
     "cashscript",
     "compiler",
-    "smart contracts"
+    "smart contracts",
+    "cashtokens"
   ],
   "homepage": "https://cashscript.org",
   "bugs": {
@@ -20,6 +21,7 @@
   "license": "MIT",
   "author": "Rosco Kalis <roscokalis@gmail.com>",
   "contributors": [
+    "Mathieu Geukens <mr-zwets@protonmail.com>",
     "Gabriel Cardona <gabriel@bitcoin.com>"
   ],
   "main": "dist/index.js",
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index eb852369..0cf91d22 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -6,7 +6,8 @@
     "bitcoin cash",
     "cashscript",
     "sdk",
-    "smart contracts"
+    "smart contracts",
+    "cashtokens"
   ],
   "homepage": "https://cashscript.org",
   "bugs": {
@@ -19,6 +20,7 @@
   "license": "MIT",
   "author": "Rosco Kalis <roscokalis@gmail.com>",
   "contributors": [
+    "Mathieu Geukens <mr-zwets@protonmail.com>",
     "Gabriel Cardona <gabriel@bitcoin.com>"
   ],
   "main": "dist/index.js",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index fe9707fe..251e93bf 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -6,7 +6,8 @@
     "bitcoin cash",
     "cashscript",
     "sdk",
-    "smart contracts"
+    "smart contracts",
+    "cashtokens"
   ],
   "homepage": "https://cashscript.org",
   "bugs": {
@@ -18,6 +19,9 @@
   },
   "license": "MIT",
   "author": "Rosco Kalis <roscokalis@gmail.com>",
+  "contributors": [
+    "Mathieu Geukens <mr-zwets@protonmail.com>"
+  ],
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",

From 84c53cc13eae8af366ab54794b1ab94fb30e9187 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 11 Apr 2025 10:56:20 +0200
Subject: [PATCH 223/267] Remove importArtifact and exportArtfiact from
 @cashscript/utils

---
 packages/cashc/src/cashc-cli.ts        |  7 ++++---
 packages/utils/src/artifact.ts         | 11 -----------
 website/docs/releases/release-notes.md |  3 +++
 3 files changed, 7 insertions(+), 14 deletions(-)

diff --git a/packages/cashc/src/cashc-cli.ts b/packages/cashc/src/cashc-cli.ts
index 594e3e6c..61b63bb7 100644
--- a/packages/cashc/src/cashc-cli.ts
+++ b/packages/cashc/src/cashc-cli.ts
@@ -4,7 +4,6 @@ import {
   asmToScript,
   calculateBytesize,
   countOpcodes,
-  exportArtifact,
   formatArtifact,
   scriptToAsm,
   scriptToBytecode,
@@ -80,16 +79,18 @@ function run(): void {
       return;
     }
 
+    const formattedArtifact = formatArtifact(artifact, opts.format);
+
     if (outputFile) {
       // Create output file and write the artifact to it
       const outputDir = path.dirname(outputFile);
       if (!fs.existsSync(outputDir)) {
         fs.mkdirSync(outputDir, { recursive: true });
       }
-      exportArtifact(artifact, outputFile, opts.format);
+      fs.writeFileSync(outputFile, formattedArtifact);
     } else {
       // Output artifact to STDOUT
-      console.log(formatArtifact(artifact, opts.format));
+      console.log(formattedArtifact);
     }
   } catch (e: any) {
     abort(e.message);
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index ab3b99ac..7cba4b3a 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -1,5 +1,3 @@
-import fs, { PathLike } from 'fs';
-
 export interface AbiInput {
   name: string;
   type: string;
@@ -51,15 +49,6 @@ export interface Artifact {
   updatedAt: string;
 }
 
-export function importArtifact(artifactFile: PathLike): Artifact {
-  return JSON.parse(fs.readFileSync(artifactFile, { encoding: 'utf-8' }));
-}
-
-export function exportArtifact(artifact: Artifact, targetFile: string, format: 'json' | 'ts'): void {
-  const jsonString = formatArtifact(artifact, format);
-  fs.writeFileSync(targetFile, jsonString);
-}
-
 export function formatArtifact(artifact: Artifact, format: 'json' | 'ts'): string {
   if (format === 'ts') {
     // We remove any undefined values to make the artifact serializable using stringifyAsTs
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 67cc9945..b774c678 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -22,6 +22,9 @@ This release also contains several breaking changes, please refer to the [migrat
 - :boom: **BREAKING**: Remove support for custom Clusters from `ElectrumNetworkProvider` and added a configuration object to the constructor.
 - :boom: **BREAKING**: Remove support for old contracts compiled with CashScript v0.6.x or earlier.
 
+#### @cashscript/utils
+- :boom: **BREAKING**: Remove `importArtifact` and `exportArtifact` helper functions. If you want to import or export artifacts, use `'fs'` to read and write files directly.
+
 ## v0.10.5
 
 #### cashc compiler

From 66d058ff759931b22aa479cb761c73f72434f54e Mon Sep 17 00:00:00 2001
From: PHCitizen <75726261+PHCitizen@users.noreply.github.com>
Date: Fri, 11 Apr 2025 02:11:38 -0700
Subject: [PATCH 224/267] replace all .json to .artifact.ts (#283)

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
---
 .../artifacts/example.artifact.ts             | 47 +++++++++++++++++++
 examples/testing-suite/test/example.test.ts   |  4 +-
 packages/cashscript/test/Contract.test.ts     | 22 ++++-----
 .../test/TransactionBuilder.test.ts           |  8 ++--
 .../cashscript/test/e2e/P2PKH-tokens.test.ts  |  4 +-
 .../test/e2e/TokenCategoryCheck.test.ts       |  2 +-
 .../test/e2e/misc/timelocks.test.ts           |  8 ++--
 website/docs/sdk/testing-setup.md             |  2 +-
 8 files changed, 72 insertions(+), 25 deletions(-)
 create mode 100644 examples/testing-suite/artifacts/example.artifact.ts

diff --git a/examples/testing-suite/artifacts/example.artifact.ts b/examples/testing-suite/artifacts/example.artifact.ts
new file mode 100644
index 00000000..8897869f
--- /dev/null
+++ b/examples/testing-suite/artifacts/example.artifact.ts
@@ -0,0 +1,47 @@
+export default {
+  contractName: 'Example',
+  constructorInputs: [],
+  abi: [
+    {
+      name: 'test',
+      inputs: [
+        {
+          name: 'value',
+          type: 'int',
+        },
+      ],
+    },
+  ],
+  bytecode: 'OP_1 OP_NUMEQUAL',
+  source: 'contract Example() {\n  function test(int value) {\n    console.log(value, \'test\');\n    require(value == 1, \'Wrong value passed\');\n  }\n}\n',
+  debug: {
+    bytecode: '007a519c',
+    sourceMap: '4:12:4:17;;:21::22;:12:::1',
+    logs: [
+      {
+        ip: 0,
+        line: 3,
+        data: [
+          {
+            stackIndex: 0,
+            type: 'int',
+            ip: 0,
+          },
+          'test',
+        ],
+      },
+    ],
+    requires: [
+      {
+        ip: 4,
+        line: 4,
+        message: 'Wrong value passed',
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.11.0-next.3',
+  },
+  updatedAt: '2025-04-11T09:08:09.750Z',
+} as const;
diff --git a/examples/testing-suite/test/example.test.ts b/examples/testing-suite/test/example.test.ts
index 517914d6..f4972490 100644
--- a/examples/testing-suite/test/example.test.ts
+++ b/examples/testing-suite/test/example.test.ts
@@ -1,4 +1,4 @@
-import artifact from '../artifacts/example.json' with { type: 'json' };
+import artifact from '../artifacts/example.artifact.js';
 import { Contract, MockNetworkProvider, TransactionBuilder, randomUtxo } from 'cashscript';
 import 'cashscript/jest';
 
@@ -6,7 +6,7 @@ describe('test example contract functions', () => {
   it('should check for output logs and error messages', async () => {
     const provider = new MockNetworkProvider();
     const contract = new Contract(artifact, [], { provider });
-    
+
     // Create a contract Utxo
     const contractUtxo = randomUtxo();
     provider.addUtxo(contract.address, contractUtxo);
diff --git a/packages/cashscript/test/Contract.test.ts b/packages/cashscript/test/Contract.test.ts
index 14e595b6..a31a16d0 100644
--- a/packages/cashscript/test/Contract.test.ts
+++ b/packages/cashscript/test/Contract.test.ts
@@ -11,21 +11,24 @@ import {
 import {
   alicePkh, alicePriv, alicePub, bobPriv,
 } from './fixture/vars.js';
-import p2pkhArtifact from './fixture/p2pkh.json' with { type: 'json' };
-import twtArtifact from './fixture/transfer_with_timeout.json' with { type: 'json' };
-import hodlVaultArtifact from './fixture/hodl_vault.json' with { type: 'json' };
-import mecenasArtifact from './fixture/mecenas.json' with { type: 'json' };
+import p2pkhArtifact from './fixture/p2pkh.artifact.js';
+import twtArtifact from './fixture/transfer_with_timeout.artifact.js';
+import hodlVaultArtifact from './fixture/hodl_vault.artifact.js';
+import mecenasArtifact from './fixture/mecenas.artifact.js';
 import deprecatedMecenasArtifact from './fixture/deprecated/mecenas-v0.6.0.json' with { type: 'json' };
-import boundedBytesArtifact from './fixture/bounded_bytes.json' with { type: 'json' };
+import boundedBytesArtifact from './fixture/bounded_bytes.artifact.js';
 
 describe('Contract', () => {
   describe('new', () => {
     it('should fail with incorrect constructor args', () => {
       const provider = new ElectrumNetworkProvider(Network.CHIPNET);
 
+      // @ts-expect-error invalid constructor type
       expect(() => new Contract(p2pkhArtifact, [], { provider })).toThrow();
+      // @ts-expect-error invalid constructor type
       expect(() => new Contract(p2pkhArtifact, [20n], { provider })).toThrow();
       expect(
+        // @ts-expect-error invalid constructor type
         () => new Contract(p2pkhArtifact, [placeholder(20), placeholder(20)], { provider }),
       ).toThrow();
       expect(() => new Contract(p2pkhArtifact, [placeholder(19)], { provider })).toThrow();
@@ -62,8 +65,7 @@ describe('Contract', () => {
 
     it('should create new TransferWithTimeout instance', () => {
       const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-      const constructorArgs = [placeholder(65), placeholder(65), 1000000n];
-      const instance = new Contract(twtArtifact, constructorArgs, { provider });
+      const instance = new Contract(twtArtifact, [placeholder(65), placeholder(65), 1000000n], { provider });
 
       expect(typeof instance.address).toBe('string');
       expect(typeof instance.functions.transfer).toBe('function');
@@ -73,8 +75,7 @@ describe('Contract', () => {
 
     it('should create new HodlVault instance', () => {
       const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-      const constructorArgs = [placeholder(65), placeholder(65), 1000000n, 10000n];
-      const instance = new Contract(hodlVaultArtifact, constructorArgs, { provider });
+      const instance = new Contract(hodlVaultArtifact, [placeholder(65), placeholder(65), 1000000n, 10000n], { provider });
 
       expect(typeof instance.address).toBe('string');
       expect(typeof instance.functions.spend).toBe('function');
@@ -83,8 +84,7 @@ describe('Contract', () => {
 
     it('should create new Mecenas instance', () => {
       const provider = new ElectrumNetworkProvider(Network.CHIPNET);
-      const constructorArgs = [placeholder(20), placeholder(20), 1000000n];
-      const instance = new Contract(mecenasArtifact, constructorArgs, { provider });
+      const instance = new Contract(mecenasArtifact, [placeholder(20), placeholder(20), 1000000n], { provider });
 
       expect(typeof instance.address).toBe('string');
       expect(typeof instance.functions.receive).toBe('function');
diff --git a/packages/cashscript/test/TransactionBuilder.test.ts b/packages/cashscript/test/TransactionBuilder.test.ts
index 59e94028..8e8738a4 100644
--- a/packages/cashscript/test/TransactionBuilder.test.ts
+++ b/packages/cashscript/test/TransactionBuilder.test.ts
@@ -12,8 +12,8 @@ import {
 } from './fixture/vars.js';
 import { Network } from '../src/interfaces.js';
 import { utxoComparator, calculateDust, randomUtxo, randomToken, isNonTokenUtxo, isFungibleTokenUtxo } from '../src/utils.js';
-import p2pkhArtifact from './fixture/p2pkh.json' with { type: 'json' };
-import twtArtifact from './fixture/transfer_with_timeout.json' with { type: 'json' };
+import p2pkhArtifact from './fixture/p2pkh.artifact.js';
+import twtArtifact from './fixture/transfer_with_timeout.artifact.js';
 import { TransactionBuilder } from '../src/TransactionBuilder.js';
 import { gatherUtxos, getTxOutputs } from './test-util.js';
 
@@ -22,8 +22,8 @@ describe('Transaction Builder', () => {
     ? new MockNetworkProvider()
     : new ElectrumNetworkProvider(Network.CHIPNET);
 
-  let p2pkhInstance: Contract;
-  let twtInstance: Contract;
+  let p2pkhInstance: Contract<typeof p2pkhArtifact>;
+  let twtInstance: Contract<typeof twtArtifact>;
 
   beforeAll(() => {
     // Note: We instantiate the contract with carolPkh to avoid mempool conflicts with other (P2PKH) tests
diff --git a/packages/cashscript/test/e2e/P2PKH-tokens.test.ts b/packages/cashscript/test/e2e/P2PKH-tokens.test.ts
index dbca1fcb..933a41dd 100644
--- a/packages/cashscript/test/e2e/P2PKH-tokens.test.ts
+++ b/packages/cashscript/test/e2e/P2PKH-tokens.test.ts
@@ -9,10 +9,10 @@ import {
 } from '../fixture/vars.js';
 import { getTxOutputs } from '../test-util.js';
 import { Network, TokenDetails, Utxo } from '../../src/interfaces.js';
-import artifact from '../fixture/p2pkh.json' with { type: 'json' };
+import artifact from '../fixture/p2pkh.artifact.js';
 
 describe('P2PKH-tokens', () => {
-  let p2pkhInstance: Contract;
+  let p2pkhInstance: Contract<typeof artifact>;
 
   beforeAll(() => {
     const provider = process.env.TESTS_USE_MOCKNET
diff --git a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
index 36ca67ba..ab95ba9a 100644
--- a/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
+++ b/packages/cashscript/test/e2e/TokenCategoryCheck.test.ts
@@ -4,7 +4,7 @@ import {
   TransactionBuilder,
 } from '../../src/index.js';
 import { Network } from '../../src/interfaces.js';
-import artifact from '../fixture/token_category_comparison.json' with { type: 'json' };
+import artifact from '../fixture/token_category_comparison.artifact.js';
 
 describe('TokenCategoryCheck', () => {
   const provider = process.env.TESTS_USE_MOCKNET
diff --git a/packages/cashscript/test/e2e/misc/timelocks.test.ts b/packages/cashscript/test/e2e/misc/timelocks.test.ts
index bb329e96..03ed406b 100644
--- a/packages/cashscript/test/e2e/misc/timelocks.test.ts
+++ b/packages/cashscript/test/e2e/misc/timelocks.test.ts
@@ -9,8 +9,8 @@ import {
 } from '../../fixture/vars.js';
 import { Network } from '../../../src/interfaces.js';
 import { utxoComparator, calculateDust, randomUtxo, isNonTokenUtxo } from '../../../src/utils.js';
-import p2pkhArtifact from '../../fixture/p2pkh.json' with { type: 'json' };
-import twtArtifact from '../../fixture/transfer_with_timeout.json' with { type: 'json' };
+import p2pkhArtifact from '../../fixture/p2pkh.artifact.js';
+import twtArtifact from '../../fixture/transfer_with_timeout.artifact.js';
 import { TransactionBuilder } from '../../../src/TransactionBuilder.js';
 import { describeOrSkip, getTxOutputs } from '../../test-util.js';
 
@@ -20,8 +20,8 @@ describe('Timelocks', () => {
     ? new MockNetworkProvider()
     : new ElectrumNetworkProvider(Network.CHIPNET);
 
-  let p2pkhInstance: Contract;
-  let twtInstance: Contract;
+  let p2pkhInstance: Contract<typeof p2pkhArtifact>;
+  let twtInstance: Contract<typeof twtArtifact>;
 
   beforeAll(() => {
     // Note: We instantiate the contract with carolPkh to avoid mempool conflicts with other (P2PKH) tests
diff --git a/website/docs/sdk/testing-setup.md b/website/docs/sdk/testing-setup.md
index 6bf806a6..875100ee 100644
--- a/website/docs/sdk/testing-setup.md
+++ b/website/docs/sdk/testing-setup.md
@@ -107,7 +107,7 @@ contract Example() {
 ```
 
 ```ts title="Example test file"
-import artifact from '../artifacts/example.json' with { type: "json" };
+import artifact from '../artifacts/example.artifact.js';
 import { Contract, MockNetworkProvider, randomUtxo } from 'cashscript';
 import 'cashscript/jest';
 

From 52777d2f95029b7f86b7ef34bb849200271ff3dc Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 15 Apr 2025 10:12:30 +0200
Subject: [PATCH 225/267] Optimised Sourcemap Step 1: create 2 separate
 "optimise" functions and make sure they return the same result

---
 packages/cashc/src/compiler.ts | 7 ++++++-
 packages/utils/src/script.ts   | 4 ++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index d1b3d7ef..6ade7a6f 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -1,6 +1,6 @@
 import { CharStream, CommonTokenStream } from 'antlr4';
 import { binToHex } from '@bitauth/libauth';
-import { Artifact, optimiseBytecode, scriptToBytecode } from '@cashscript/utils';
+import { Artifact, optimiseBytecode, optimiseBytecodeOld, scriptToAsm, scriptToBytecode } from '@cashscript/utils';
 import fs, { PathLike } from 'fs';
 import { generateArtifact } from './artifact/Artifact.js';
 import { Ast } from './ast/AST.js';
@@ -27,8 +27,13 @@ export function compileString(code: string): Artifact {
   ast = ast.accept(traversal) as Ast;
 
   // Bytecode optimisation
+  const optimisedBytecodeOld = optimiseBytecodeOld(traversal.output);
   const optimisedBytecode = optimiseBytecode(traversal.output);
 
+  if (scriptToAsm(optimisedBytecodeOld) !== scriptToAsm(optimisedBytecode)) {
+    throw new Error('New bytecode optimisation is not backwards compatible');
+  }
+
   // Attach debug information
   const debug = {
     bytecode: binToHex(scriptToBytecode(traversal.output)),
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index 5204a528..035ffbe2 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -146,6 +146,10 @@ export function generateRedeemScript(baseScript: Script, encodedConstructorArgs:
 }
 
 export function optimiseBytecode(script: Script, runs: number = 1000): Script {
+  return optimiseBytecodeOld(script, runs);
+}
+
+export function optimiseBytecodeOld(script: Script, runs: number = 1000): Script {
   const optimisations = OptimisationsEquivFile
     // Split by line and filter all line comments (#)
     .split('\n')

From 5641e9a9b87b92fad23d2fd36b359d4a7122f979 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 15 Apr 2025 10:29:55 +0200
Subject: [PATCH 226/267] Optimised Sourcemap Step 2: move all
 provable/unprovable optimisations into the same data structure

---
 packages/cashc/src/compiler.ts      |   2 +
 packages/utils/src/optimisations.ts | 136 ++++++++++++++++++++++++++++
 packages/utils/src/script.ts        |  27 +++++-
 3 files changed, 162 insertions(+), 3 deletions(-)
 create mode 100644 packages/utils/src/optimisations.ts

diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index 6ade7a6f..a66048e1 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -31,6 +31,8 @@ export function compileString(code: string): Artifact {
   const optimisedBytecode = optimiseBytecode(traversal.output);
 
   if (scriptToAsm(optimisedBytecodeOld) !== scriptToAsm(optimisedBytecode)) {
+    console.error(scriptToAsm(optimisedBytecodeOld));
+    console.error(scriptToAsm(optimisedBytecode));
     throw new Error('New bytecode optimisation is not backwards compatible');
   }
 
diff --git a/packages/utils/src/optimisations.ts b/packages/utils/src/optimisations.ts
new file mode 100644
index 00000000..b30b6f00
--- /dev/null
+++ b/packages/utils/src/optimisations.ts
@@ -0,0 +1,136 @@
+const provableOptimisations = [
+  // Hardcoded arithmetic
+  ['OP_1 OP_ADD', 'OP_1ADD'],
+  ['OP_1 OP_SUB', 'OP_1SUB'],
+  ['OP_1 OP_NEGATE', 'OP_1NEGATE'],
+  ['OP_0 OP_NUMEQUAL OP_NOT', 'OP_0NOTEQUAL'],
+  ['OP_NUMEQUAL OP_NOT', 'OP_NUMNOTEQUAL'],
+  ['OP_SHA256 OP_SHA256', 'OP_HASH256'],
+  ['OP_SHA256 OP_RIPEMD160', 'OP_HASH160'],
+
+  // Hardcoded stack ops
+  ['OP_2 OP_PICK OP_1 OP_PICK OP_3 OP_PICK', 'OP_3DUP OP_SWAP'],
+  ['OP_2 OP_PICK OP_2 OP_PICK OP_2 OP_PICK', 'OP_3DUP'],
+
+  ['OP_0 OP_PICK OP_2 OP_PICK', 'OP_2DUP OP_SWAP'],
+  ['OP_2 OP_PICK OP_4 OP_PICK', 'OP_2OVER OP_SWAP'],
+  ['OP_3 OP_PICK OP_3 OP_PICK', 'OP_2OVER'],
+
+  ['OP_2 OP_ROLL OP_3 OP_ROLL', 'OP_2SWAP OP_SWAP'],
+  ['OP_3 OP_ROLL OP_3 OP_ROLL', 'OP_2SWAP'],
+  ['OP_4 OP_ROLL OP_5 OP_ROLL', 'OP_2ROT OP_SWAP'],
+  ['OP_5 OP_ROLL OP_5 OP_ROLL', 'OP_2ROT'],
+
+  ['OP_0 OP_PICK', 'OP_DUP'],
+  ['OP_1 OP_PICK', 'OP_OVER'],
+  ['OP_0 OP_ROLL', ''],
+  ['OP_1 OP_ROLL', 'OP_SWAP'],
+  ['OP_2 OP_ROLL', 'OP_ROT'],
+  ['OP_DROP OP_DROP', 'OP_2DROP'],
+
+  // Secondary effects
+  ['OP_DUP OP_SWAP', 'OP_DUP'],
+  ['OP_SWAP OP_SWAP', ''],
+  ['OP_2SWAP OP_2SWAP', ''],
+  ['OP_ROT OP_ROT OP_ROT', ''],
+  ['OP_2ROT OP_2ROT OP_2ROT', ''],
+  ['OP_OVER OP_OVER', 'OP_2DUP'],
+  ['OP_DUP OP_DROP', ''],
+  ['OP_DUP OP_NIP', ''],
+
+  // Enabling secondary effects
+  ['OP_DUP OP_OVER', 'OP_DUP OP_DUP'],
+
+  // Merge OP_VERIFY
+  ['OP_EQUAL OP_VERIFY', 'OP_EQUALVERIFY'],
+  ['OP_NUMEQUAL OP_VERIFY', 'OP_NUMEQUALVERIFY'],
+  ['OP_CHECKSIG OP_VERIFY', 'OP_CHECKSIGVERIFY'],
+  ['OP_CHECKDATASIG OP_VERIFY', 'OP_CHECKDATASIGVERIFY'],
+
+  // Remove/replace extraneous OP_SWAP
+  ['OP_SWAP OP_ADD', 'OP_ADD'],
+  ['OP_SWAP OP_EQUAL', 'OP_EQUAL'],
+  ['OP_SWAP OP_NUMEQUAL', 'OP_NUMEQUAL'],
+  ['OP_SWAP OP_NUMNOTEQUAL', 'OP_NUMNOTEQUAL'],
+  ['OP_SWAP OP_GREATERTHANOREQUAL', 'OP_LESSTHANOREQUAL'],
+  ['OP_SWAP OP_LESSTHANOREQUAL', 'OP_GREATERTHANOREQUAL'],
+  ['OP_SWAP OP_GREATERTHAN', 'OP_LESSTHAN'],
+  ['OP_SWAP OP_LESSTHAN', 'OP_GREATERTHAN'],
+  ['OP_SWAP OP_DROP', 'OP_NIP'],
+  ['OP_SWAP OP_NIP', 'OP_DROP'],
+
+  // Remove/replace extraneous OP_DUP
+  ['OP_DUP OP_DROP', ''],
+  ['OP_DUP OP_NIP', ''],
+
+  // Random optimisations (don't know what I'm targeting with this)
+  ['OP_2DUP OP_DROP', 'OP_OVER'],
+  ['OP_2DUP OP_NIP', 'OP_DUP'],
+  ['OP_CAT OP_DROP', 'OP_2DROP'],
+  ['OP_NIP OP_DROP', 'OP_2DROP'],
+
+  // Far-fetched stuff
+  ['OP_DUP OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_OVER OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_2 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_3 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_4 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_5 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_6 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_7 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_8 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_9 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_10 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_11 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_12 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_13 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_14 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+  ['OP_16 OP_PICK OP_ROT OP_SWAP OP_DROP', 'OP_SWAP'],
+
+  ['OP_DUP OP_ROT OP_DROP', 'OP_NIP OP_DUP'],
+  ['OP_OVER OP_ROT OP_DROP', 'OP_SWAP'],
+  ['OP_2 OP_PICK OP_ROT OP_DROP', 'OP_NIP OP_OVER'],
+
+  ['OP_0 OP_NIP', 'OP_DROP OP_0'],
+  ['OP_1 OP_NIP', 'OP_DROP OP_1'],
+  ['OP_2 OP_NIP', 'OP_DROP OP_2'],
+  ['OP_3 OP_NIP', 'OP_DROP OP_3'],
+  ['OP_4 OP_NIP', 'OP_DROP OP_4'],
+  ['OP_5 OP_NIP', 'OP_DROP OP_5'],
+  ['OP_6 OP_NIP', 'OP_DROP OP_6'],
+  ['OP_7 OP_NIP', 'OP_DROP OP_7'],
+  ['OP_8 OP_NIP', 'OP_DROP OP_8'],
+  ['OP_9 OP_NIP', 'OP_DROP OP_9'],
+  ['OP_10 OP_NIP', 'OP_DROP OP_10'],
+  ['OP_11 OP_NIP', 'OP_DROP OP_11'],
+  ['OP_12 OP_NIP', 'OP_DROP OP_12'],
+  ['OP_13 OP_NIP', 'OP_DROP OP_13'],
+  ['OP_14 OP_NIP', 'OP_DROP OP_14'],
+  ['OP_15 OP_NIP', 'OP_DROP OP_15'],
+  ['OP_16 OP_NIP', 'OP_DROP OP_16'],
+
+  ['OP_2 OP_PICK OP_SWAP OP_2 OP_PICK OP_NIP', 'OP_DROP OP_2DUP'],
+] as [string, string][];
+
+const unprovableOptimisations = [
+  // Hardcoded arithmetic
+  // CashProof can't prove OP_IF without parameters
+  ['OP_NOT OP_IF', 'OP_NOTIF'],
+  // Merge OP_VERIFY
+  // CashProof can't prove OP_CHECKMULTISIG without specifying N
+  ['OP_CHECKMULTISIG OP_VERIFY', 'OP_CHECKMULTISIGVERIFY'],
+  // Remove/replace extraneous OP_SWAP
+  // CashProof can't prove bitwise operators
+  ['OP_SWAP OP_AND', 'OP_AND'],
+  ['OP_SWAP OP_OR', 'OP_OR'],
+  ['OP_SWAP OP_XOR', 'OP_XOR'],
+
+  // Remove/replace extraneous OP_DUP
+  // CashProof can't prove bitwise operators
+  ['OP_DUP OP_AND', ''],
+  ['OP_DUP OP_OR', ''],
+] as [string, string][];
+
+// Note: we moved these optimisations into a single file, but kept the exact same order as before,
+// because the order in which oprimisations are applied can impact the output.
+export const optimisationReplacements = [...provableOptimisations, ...unprovableOptimisations];
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index 035ffbe2..b45a100c 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -8,6 +8,7 @@ import {
   decodeAuthenticationInstructions,
 } from '@bitauth/libauth';
 import OptimisationsEquivFile from './cashproof-optimisations.js';
+import { optimisationReplacements } from './optimisations.js';
 
 export const Op = OpcodesBch2023;
 export type Op = number;
@@ -146,7 +147,15 @@ export function generateRedeemScript(baseScript: Script, encodedConstructorArgs:
 }
 
 export function optimiseBytecode(script: Script, runs: number = 1000): Script {
-  return optimiseBytecodeOld(script, runs);
+  for (let i = 0; i < runs; i += 1) {
+    const oldScript = script;
+    script = replaceOps(script, optimisationReplacements);
+
+    // Break on fixed point
+    if (scriptToAsm(oldScript) === scriptToAsm(script)) break;
+  }
+
+  return script;
 }
 
 export function optimiseBytecodeOld(script: Script, runs: number = 1000): Script {
@@ -165,7 +174,7 @@ export function optimiseBytecodeOld(script: Script, runs: number = 1000): Script
 
   for (let i = 0; i < runs; i += 1) {
     const oldScript = script;
-    script = replaceOps(script, optimisations);
+    script = replaceOpsOld(script, optimisations);
 
     // Break on fixed point
     if (scriptToAsm(oldScript) === scriptToAsm(script)) break;
@@ -174,7 +183,7 @@ export function optimiseBytecodeOld(script: Script, runs: number = 1000): Script
   return script;
 }
 
-function replaceOps(script: Script, optimisations: string[][]): Script {
+function replaceOpsOld(script: Script, optimisations: string[][]): Script {
   let asm = scriptToAsm(script);
 
   // Apply all optimisations in the cashproof file
@@ -199,3 +208,15 @@ function replaceOps(script: Script, optimisations: string[][]): Script {
 
   return asmToScript(asm);
 }
+
+function replaceOps(script: Script, optimisations: string[][]): Script {
+  let asm = scriptToAsm(script);
+
+  optimisations.forEach(([pattern, replacement]) => {
+    asm = asm.replace(new RegExp(pattern, 'g'), replacement);
+  });
+
+  asm = asm.replace(/\s+/g, ' ').trim();
+
+  return asmToScript(asm);
+}

From 8d11124fdf833d3b507bacbba259153b49dddf06 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 17 Apr 2025 10:44:29 +0200
Subject: [PATCH 227/267] Optimised Sourcemap Step 3.1: update location data /
 sourcemap during optimisations

---
 packages/cashc/src/compiler.ts                |  15 ++-
 .../multiline_statements.cash                 |   4 +-
 packages/utils/src/script.ts                  | 124 +++++++++++++++++-
 3 files changed, 127 insertions(+), 16 deletions(-)

diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index a66048e1..3cd4b8be 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -1,6 +1,6 @@
 import { CharStream, CommonTokenStream } from 'antlr4';
 import { binToHex } from '@bitauth/libauth';
-import { Artifact, optimiseBytecode, optimiseBytecodeOld, scriptToAsm, scriptToBytecode } from '@cashscript/utils';
+import { Artifact, generateSourceMap, optimiseBytecode, optimiseBytecodeOld, scriptToAsm, scriptToBytecode, sourceMapToLocationData } from '@cashscript/utils';
 import fs, { PathLike } from 'fs';
 import { generateArtifact } from './artifact/Artifact.js';
 import { Ast } from './ast/AST.js';
@@ -28,23 +28,24 @@ export function compileString(code: string): Artifact {
 
   // Bytecode optimisation
   const optimisedBytecodeOld = optimiseBytecodeOld(traversal.output);
-  const optimisedBytecode = optimiseBytecode(traversal.output);
+  const optimisationResult = optimiseBytecode(traversal.output, sourceMapToLocationData(traversal.sourceMap));
 
-  if (scriptToAsm(optimisedBytecodeOld) !== scriptToAsm(optimisedBytecode)) {
+  if (scriptToAsm(optimisedBytecodeOld) !== scriptToAsm(optimisationResult.script)) {
     console.error(scriptToAsm(optimisedBytecodeOld));
-    console.error(scriptToAsm(optimisedBytecode));
+    console.error(scriptToAsm(optimisationResult.script));
     throw new Error('New bytecode optimisation is not backwards compatible');
   }
 
   // Attach debug information
   const debug = {
-    bytecode: binToHex(scriptToBytecode(traversal.output)),
-    sourceMap: traversal.sourceMap,
+    bytecode: binToHex(scriptToBytecode(optimisationResult.script)),
+    sourceMap: generateSourceMap(optimisationResult.locationData),
+    // sourceMap: traversal.sourceMap,
     logs: traversal.consoleLogs,
     requires: traversal.requires,
   };
 
-  return generateArtifact(ast, optimisedBytecode, code, debug);
+  return generateArtifact(ast, optimisationResult.script, code, debug);
 }
 
 export function compileFile(codeFile: PathLike): Artifact {
diff --git a/packages/cashc/test/valid-contract-files/multiline_statements.cash b/packages/cashc/test/valid-contract-files/multiline_statements.cash
index 5800941b..814ae571 100644
--- a/packages/cashc/test/valid-contract-files/multiline_statements.cash
+++ b/packages/cashc/test/valid-contract-files/multiline_statements.cash
@@ -1,8 +1,8 @@
-contract Test(
+contract MultilineStatements(
     int x,
     string y
 ) {
-    function hello(
+    function spend(
         int a,
         string b
     ) {
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index b45a100c..a5a267e3 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -9,6 +9,7 @@ import {
 } from '@bitauth/libauth';
 import OptimisationsEquivFile from './cashproof-optimisations.js';
 import { optimisationReplacements } from './optimisations.js';
+import { FullLocationData, PositionHint, SingleLocationData } from './types.js';
 
 export const Op = OpcodesBch2023;
 export type Op = number;
@@ -146,16 +147,26 @@ export function generateRedeemScript(baseScript: Script, encodedConstructorArgs:
   return [...encodedConstructorArgs.slice().reverse(), ...baseScript];
 }
 
-export function optimiseBytecode(script: Script, runs: number = 1000): Script {
+interface OptimiseBytecodeResult {
+  script: Script;
+  locationData: FullLocationData;
+}
+
+export function optimiseBytecode(
+  script: Script, locationData: FullLocationData, runs: number = 1000,
+): OptimiseBytecodeResult {
   for (let i = 0; i < runs; i += 1) {
     const oldScript = script;
-    script = replaceOps(script, optimisationReplacements);
+    const { script: newScript, locationData: newLocationData } = replaceOps(script, locationData, optimisationReplacements);
 
     // Break on fixed point
-    if (scriptToAsm(oldScript) === scriptToAsm(script)) break;
+    if (scriptToAsm(oldScript) === scriptToAsm(newScript)) break;
+
+    script = newScript;
+    locationData = newLocationData;
   }
 
-  return script;
+  return { script, locationData };
 }
 
 export function optimiseBytecodeOld(script: Script, runs: number = 1000): Script {
@@ -209,14 +220,113 @@ function replaceOpsOld(script: Script, optimisations: string[][]): Script {
   return asmToScript(asm);
 }
 
-function replaceOps(script: Script, optimisations: string[][]): Script {
+interface ReplaceOpsResult {
+  script: Script;
+  locationData: FullLocationData;
+}
+
+function replaceOps(script: Script, locationData: FullLocationData, optimisations: string[][]): ReplaceOpsResult {
   let asm = scriptToAsm(script);
+  let newLocationData = [...locationData];
 
   optimisations.forEach(([pattern, replacement]) => {
-    asm = asm.replace(new RegExp(pattern, 'g'), replacement);
+    let processedAsm = '';
+    let asmToSearch = asm;
+
+    const regex = new RegExp(pattern, 'g');
+
+    let matchIndex = asmToSearch.search(regex);
+    while (matchIndex !== -1) {
+      // We add the part before the match to the processed asm
+      processedAsm += asmToSearch.slice(0, matchIndex);
+
+      // We count the number of spaces in the processed asm + 1, which is equal to the script index
+      // We do the same thing to calculate the number of opcodes in the pattern and replacement
+      const scriptIndex = processedAsm === '' ? 0 : [...processedAsm.trim().matchAll(/\s+/g)].length + 1;
+      const patternLength = [...pattern.matchAll(/\s+/g)].length + 1;
+      const replacementLength = replacement === '' ? 0 : [...replacement.matchAll(/\s+/g)].length + 1;
+
+      // We get the locationdata entries for every opcode in the pattern
+      const patternLocations = newLocationData.slice(scriptIndex, scriptIndex + patternLength);
+
+      // We get the lowest start location and highest end location of the pattern
+      const lowestStart = getLowestStartLocation(patternLocations);
+      const highestEnd = getHighestEndLocation(patternLocations);
+
+      // If any of the pattern locations have a position hint of END, we use that as the position hint
+      const positionHint = patternLocations.some((location) => location.positionHint === PositionHint.END)
+        ? PositionHint.END
+        : PositionHint.START;
+
+      // We merge the lowest start and highest end locations into a single location data entry
+      const mergedLocation = {
+        location: {
+          start: lowestStart.location.start,
+          end: highestEnd.location.end,
+        },
+        positionHint,
+      };
+
+      // We replace the pattern locations with the merged location
+      // (note that every opcode in the replacement has the same location)
+      const replacementLocations = new Array<SingleLocationData>(replacementLength).fill(mergedLocation);
+      newLocationData.splice(scriptIndex, patternLength, ...replacementLocations);
+
+      // We add the replacement to the processed asm
+      processedAsm += replacement;
+
+      // We do not add the matched pattern anywhere since it gets replaced
+
+      // We set the asmToSearch to the part after the match
+      asmToSearch = asmToSearch.slice(matchIndex + pattern.length);
+
+      // Find the next match
+      matchIndex = asmToSearch.search(regex);
+    }
+
+    // We add the remaining asm to the processed asm
+    processedAsm += asmToSearch;
+
+    // We replace the original asm with the processed asm so that the next optimisation can use the updated asm
+    asm = processedAsm;
   });
 
   asm = asm.replace(/\s+/g, ' ').trim();
 
-  return asmToScript(asm);
+  return {
+    script: asmToScript(asm),
+    locationData: newLocationData,
+  };
 }
+
+const getHighestEndLocation = (locations: SingleLocationData[]): SingleLocationData => {
+  return locations.reduce((highest, current) => {
+    if (current.location.end.line > highest.location.end.line) {
+      return current;
+    }
+
+    if (highest.location.end.line === current.location.end.line) {
+      if (current.location.end.column > highest.location.end.column) {
+        return current;
+      }
+    }
+
+    return highest;
+  }, locations[0]);
+};
+
+const getLowestStartLocation = (locations: SingleLocationData[]): SingleLocationData => {
+  return locations.reduce((lowest, current) => {
+    if (current.location.start.line < lowest.location.start.line) {
+      return current;
+    }
+
+    if (lowest.location.start.line === current.location.start.line) {
+      if (current.location.start.column < lowest.location.start.column) {
+        return current;
+      }
+    }
+
+    return lowest;
+  }, locations[0]);
+};

From 09d48873bef62d418ef199c41372ed97a7c337da Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 25 Apr 2025 11:13:52 +0200
Subject: [PATCH 228/267] Fix issue with JestExtensions expect().toLog()
 loggerSpy reuse

---
 packages/cashscript/src/test/JestExtensions.ts | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/cashscript/src/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
index 804e7ca5..657e479e 100644
--- a/packages/cashscript/src/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -27,8 +27,12 @@ expect.extend({
   ): Promise<SyncExpectationResult> {
     const loggerSpy = jest.spyOn(console, 'log');
 
+    // Clear any previous calls (if spy reused accidentally)
+    loggerSpy.mockClear();
+
     // silence actual stdout output
     loggerSpy.mockImplementation(() => { });
+
     try { await transaction.debug(); } catch { }
 
     // We concatenate all the logs into a single string - if no logs are present, we set received to undefined
@@ -46,7 +50,8 @@ expect.extend({
       return { message, pass: false };
     }
 
-    loggerSpy.mockClear();
+    // Restore the original console.log implementation
+    loggerSpy.mockRestore();
 
     return { message, pass: true };
   },

From d3413829bcfdd93d979d2962245019ec77c64be2 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Fri, 25 Apr 2025 11:54:03 +0200
Subject: [PATCH 229/267] Start updating log/require IP when optimising
 bytecode

- optimiseBytecode now takes logs,requires,constructorParamLength as
  arguments that get passed down to replaceOps and are used to update
  the IP of log/require statements
- We calculate the length diff between the matched pattern and
  replacement and use that difference to update the IP of any
  log/require statements that occur within or after the matched pattern
- Update NULLFAIL require case now that OP_CHECKSIG and OP_VERIFY get
  merged into OP_CHECKSIGVERIFY
- Add a console.log test case for a contract with many constructor params
- Update stack cleanup handling because OP_DROP/OP_2DROP can now also
  occur in the stack cleanup of a function
---
 packages/cashc/src/compiler.ts                | 14 +++-
 packages/cashscript/src/debugging.ts          | 29 ++++---
 packages/cashscript/test/debugging.test.ts    | 19 +++++
 .../fixture/debugging/debugging_contracts.ts  | 26 +++++++
 packages/utils/src/script.ts                  | 76 ++++++++++++++++++-
 5 files changed, 147 insertions(+), 17 deletions(-)

diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index 3cd4b8be..ad240d3a 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -26,9 +26,17 @@ export function compileString(code: string): Artifact {
   const traversal = new GenerateTargetTraversal();
   ast = ast.accept(traversal) as Ast;
 
+  const constructorParamLength = ast.contract.parameters.length;
+
   // Bytecode optimisation
   const optimisedBytecodeOld = optimiseBytecodeOld(traversal.output);
-  const optimisationResult = optimiseBytecode(traversal.output, sourceMapToLocationData(traversal.sourceMap));
+  const optimisationResult = optimiseBytecode(
+    traversal.output,
+    sourceMapToLocationData(traversal.sourceMap),
+    traversal.consoleLogs,
+    traversal.requires,
+    constructorParamLength,
+  );
 
   if (scriptToAsm(optimisedBytecodeOld) !== scriptToAsm(optimisationResult.script)) {
     console.error(scriptToAsm(optimisedBytecodeOld));
@@ -41,8 +49,8 @@ export function compileString(code: string): Artifact {
     bytecode: binToHex(scriptToBytecode(optimisationResult.script)),
     sourceMap: generateSourceMap(optimisationResult.locationData),
     // sourceMap: traversal.sourceMap,
-    logs: traversal.consoleLogs,
-    requires: traversal.requires,
+    logs: optimisationResult.logs,
+    requires: optimisationResult.requires,
   };
 
   return generateArtifact(ast, optimisationResult.script, code, debug);
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 01147160..37b04721 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -50,7 +50,7 @@ const debugSingleScenario = (
     .filter((debugStep) => debugStep.controlStack.every(item => item === true));
 
   const executedLogs = (artifact.debug?.logs ?? [])
-    .filter((debugStep) => executedDebugSteps.some((log) => log.ip === debugStep.ip));
+    .filter((log) => executedDebugSteps.some((debugStep) => log.ip === debugStep.ip));
 
   for (const log of executedLogs) {
     logConsoleLogStatement(log, executedDebugSteps, artifact);
@@ -64,13 +64,16 @@ const debugSingleScenario = (
     // caused the error (in other words the OP_VERIFY). We need to decrement the instruction pointer to get the correct
     // failing instruction.
     const failingIp = lastExecutedDebugStep.ip - 1;
-
-    // Generally speaking, an error is thrown by the OP_VERIFY opcode, but for NULLFAIL, the error is thrown in the
-    // preceding OP_CHECKSIG opcode. The error message is registered in the next instruction, so we need to increment
-    // the instruction pointer to get the correct error message from the require messages in the artifact.
-    // Note that we do NOT use this adjusted IP when passing the failing IP into the FailedRequireError
+    const failingInstruction = lastExecutedDebugStep.instructions[failingIp];
+
+    // With optimisations, the OP_CHECKSIG and OP_VERIFY instructions are merged into a single opcode (OP_CHECKSIGVERIFY).
+    // However, for the final verify, the OP_VERIFY is not present. In most cases, the implicit final VERIFY is checked
+    // later in the code. However, for NULLFAIL, the error is thrown in the OP_CHECKSIG opcode, rather than in the
+    // implicit final VERIFY. The error message is registered in the next instruction, so we need to increment the
+    // instruction pointer to get the correct error message from the require messages in the artifact.
+    // Note that we do NOT use this adjusted IP when passing the failing IP into the FailedRequireError.
     const isNullFail = lastExecutedDebugStep.error.includes(AuthenticationErrorCommon.nonNullSignatureFailure);
-    const requireStatementIp = failingIp + (isNullFail ? 1 : 0);
+    const requireStatementIp = failingIp + (isNullFail && isSignatureCheckWithoutVerify(failingInstruction) ? 1 : 0);
 
     const requireStatement = (artifact.debug?.requires ?? [])
       .find((statement) => statement.ip === requireStatementIp);
@@ -212,9 +215,11 @@ const failedFinalVerify = (evaluationResult: string | true): evaluationResult is
 };
 
 const calculateCleanupSize = (instructions: Array<AuthenticationInstruction | undefined>): number => {
-  // OP_NIP is used for cleanup at the end of a function, OP_ENDIF and OP_ELSE are the end of branches
-  // We need to remove all of these to get to the actual last executed instruction of a function
-  const cleanupOpcodes = [Op.OP_ENDIF, Op.OP_NIP, Op.OP_ELSE];
+  // OP_NIP (or OP_DROP/OP_2DROP in optimised bytecode) is used for cleanup at the end of a function,
+  // OP_ENDIF and OP_ELSE are the end of branches. We need to remove all of these to get to the actual last
+  // executed instruction of a function
+  // TODO: What about OP_1??
+  const cleanupOpcodes = [Op.OP_ENDIF, Op.OP_NIP, Op.OP_ELSE, Op.OP_DROP, Op.OP_2DROP];
 
   let cleanupSize = 0;
   for (const instruction of [...instructions].reverse()) {
@@ -277,3 +282,7 @@ const verifyFullTransaction = (template: WalletTemplate): void => {
     throw new FailedTransactionError(verificationResult, getBitauthUri(template));
   }
 };
+
+const isSignatureCheckWithoutVerify = (instruction: AuthenticationInstruction): boolean => {
+  return [Op.OP_CHECKSIG, Op.OP_CHECKMULTISIG, Op.OP_CHECKDATASIG].includes(instruction.opcode);
+};
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 88ed600a..b90fcd2d 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -4,6 +4,7 @@ import '../src/test/JestExtensions.js';
 import { randomUtxo } from '../src/utils.js';
 import { AuthenticationErrorCommon, binToHex, hexToBin } from '@bitauth/libauth';
 import {
+  artifactTestMultipleConstructorParameters,
   artifactTestLogs,
   artifactTestConsecutiveLogs,
   artifactTestMultipleLogs,
@@ -60,6 +61,24 @@ describe('Debugging tests', () => {
       await expect(transaction).not.toLog(/Hello First Function/);
     });
 
+    it('should only log console.log statements from the called function when there are many constructor parameters', async () => {
+      const contractTestMultipleConstructorParameters = new Contract(
+        artifactTestMultipleConstructorParameters,
+        [alicePub, 1000n, 2000n, 3000n, 4000n, 5000n],
+        { provider },
+      );
+
+      const utxo = randomUtxo();
+      provider.addUtxo(contractTestMultipleConstructorParameters.address, utxo);
+
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(utxo, contractTestMultipleConstructorParameters.unlock.secondFunction())
+        .addOutput({ to: contractTestMultipleConstructorParameters.address, amount: 10000n });
+
+      await expect(transaction).toLog(new RegExp('^Test.cash:20 Hello Second Function$'));
+      await expect(transaction).not.toLog(/Hello First Function/);
+    });
+
     it('should only log console.log statements from the chosen branch in if-statement', async () => {
       const transaction1 = new TransactionBuilder({ provider })
         .addInput(contractUtxo, contractTestLogs.unlock.functionWithIfStatement(1n))
diff --git a/packages/cashscript/test/fixture/debugging/debugging_contracts.ts b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
index ef1c04c8..79de636a 100644
--- a/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
+++ b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
@@ -270,6 +270,31 @@ contract Test(pubkey owner) {
 }
 `;
 
+const CONTRACT_TEST_MULTIPLE_CONSTRUCTOR_PARAMETERS = `
+contract Test(pubkey owner, int num, int num2, int num3, int num4, int num5) {
+  function transfer(sig ownerSig) {
+    console.log('Hello First Function');
+    require(checkSig(ownerSig, owner));
+
+    bytes2 beef = 0xbeef;
+    require(beef != 0xfeed);
+
+    console.log(ownerSig, owner, num, num2, beef, 1, "test", true);
+
+    require(num == 1000);
+    require(num2 == 2000);
+    require(num3 == 3000);
+    require(num4 == 4000);
+    require(num5 == 5000);
+  }
+
+  function secondFunction() {
+    console.log("Hello Second Function");
+    require(1 == 1);
+  }
+}
+`;
+
 export const artifactTestRequires = compileString(CONTRACT_TEST_REQUIRES);
 export const artifactTestSingleFunction = compileString(CONTRACT_TEST_REQUIRE_SINGLE_FUNCTION);
 export const artifactTestMultilineRequires = compileString(CONTRACT_TEST_MULTILINE_REQUIRES);
@@ -277,3 +302,4 @@ export const artifactTestZeroHandling = compileString(CONTRACT_TEST_ZERO_HANDLIN
 export const artifactTestLogs = compileString(CONTRACT_TEST_LOGS);
 export const artifactTestConsecutiveLogs = compileString(CONTRACT_TEST_CONSECUTIVE_LOGS);
 export const artifactTestMultipleLogs = compileString(CONTRACT_TEST_MULTPLE_LOGS);
+export const artifactTestMultipleConstructorParameters = compileString(CONTRACT_TEST_MULTIPLE_CONSTRUCTOR_PARAMETERS);
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index a5a267e3..ec63b009 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -10,6 +10,7 @@ import {
 import OptimisationsEquivFile from './cashproof-optimisations.js';
 import { optimisationReplacements } from './optimisations.js';
 import { FullLocationData, PositionHint, SingleLocationData } from './types.js';
+import { LogEntry, RequireStatement } from './artifact.js';
 
 export const Op = OpcodesBch2023;
 export type Op = number;
@@ -150,23 +151,37 @@ export function generateRedeemScript(baseScript: Script, encodedConstructorArgs:
 interface OptimiseBytecodeResult {
   script: Script;
   locationData: FullLocationData;
+  logs: LogEntry[];
+  requires: RequireStatement[];
 }
 
 export function optimiseBytecode(
-  script: Script, locationData: FullLocationData, runs: number = 1000,
+  script: Script,
+  locationData: FullLocationData,
+  logs: LogEntry[],
+  requires: RequireStatement[],
+  constructorParamLength: number,
+  runs: number = 1000,
 ): OptimiseBytecodeResult {
   for (let i = 0; i < runs; i += 1) {
     const oldScript = script;
-    const { script: newScript, locationData: newLocationData } = replaceOps(script, locationData, optimisationReplacements);
+    const {
+      script: newScript,
+      locationData: newLocationData,
+      logs: newLogs,
+      requires: newRequires,
+    } = replaceOps(script, locationData, logs, requires, constructorParamLength, optimisationReplacements);
 
     // Break on fixed point
     if (scriptToAsm(oldScript) === scriptToAsm(newScript)) break;
 
     script = newScript;
     locationData = newLocationData;
+    logs = newLogs;
+    requires = newRequires;
   }
 
-  return { script, locationData };
+  return { script, locationData, logs, requires };
 }
 
 export function optimiseBytecodeOld(script: Script, runs: number = 1000): Script {
@@ -223,11 +238,22 @@ function replaceOpsOld(script: Script, optimisations: string[][]): Script {
 interface ReplaceOpsResult {
   script: Script;
   locationData: FullLocationData;
+  logs: LogEntry[];
+  requires: RequireStatement[];
 }
 
-function replaceOps(script: Script, locationData: FullLocationData, optimisations: string[][]): ReplaceOpsResult {
+function replaceOps(
+  script: Script,
+  locationData: FullLocationData,
+  logs: LogEntry[],
+  requires: RequireStatement[],
+  constructorParamLength: number,
+  optimisations: string[][],
+): ReplaceOpsResult {
   let asm = scriptToAsm(script);
   let newLocationData = [...locationData];
+  let newLogs = [...logs];
+  let newRequires = [...requires];
 
   optimisations.forEach(([pattern, replacement]) => {
     let processedAsm = '';
@@ -272,6 +298,46 @@ function replaceOps(script: Script, locationData: FullLocationData, optimisation
       const replacementLocations = new Array<SingleLocationData>(replacementLength).fill(mergedLocation);
       newLocationData.splice(scriptIndex, patternLength, ...replacementLocations);
 
+      const lengthDiff = patternLength - replacementLength; // 2 or 1
+
+      // The IP of an opcode in the script is its index within the script + the constructor parameters, because
+      // the constructor parameters still have to get added to the front of the script when a new Contract is created.
+      const scriptIp = scriptIndex + constructorParamLength;
+
+      newRequires = newRequires.map((require) => {
+        // We calculate the new ip of the require by subtracting the length diff between the matched pattern and replacement
+        const newCalculatedRequireIp = require.ip - lengthDiff;
+
+        return {
+          ...require,
+          // If the require is within the pattern, we want to make sure that the new ip is at least the scriptIp
+          // Note that this is impossible for the current set of optimisations, but future proofs the code
+          ip: require.ip >= scriptIp ? Math.max(scriptIp, newCalculatedRequireIp) : require.ip,
+        };
+      });
+
+      newLogs = newLogs.map((log) => {
+        // We calculate the new ip of the log by subtracting the length diff between the matched pattern and replacement
+        const newCalculatedLogIp = log.ip - lengthDiff;
+
+        return {
+          // If the log is within the pattern, we want to make sure that the new ip is at least the scriptIp
+          ip: log.ip >= scriptIp ? Math.max(scriptIp, newCalculatedLogIp) : log.ip,
+          line: log.line,
+          data: log.data.map((data) => {
+            if (typeof data === 'string') return data;
+
+            const newCalculatedDataIp = data.ip - lengthDiff;
+
+            return {
+              ...data,
+              // If the log is within the pattern, we want to make sure that the new ip is at least the scriptIp
+              ip: data.ip >= scriptIp ? Math.max(scriptIp, newCalculatedDataIp) : data.ip,
+            };
+          }),
+        };
+      });
+
       // We add the replacement to the processed asm
       processedAsm += replacement;
 
@@ -296,6 +362,8 @@ function replaceOps(script: Script, locationData: FullLocationData, optimisation
   return {
     script: asmToScript(asm),
     locationData: newLocationData,
+    logs: newLogs,
+    requires: newRequires,
   };
 }
 

From f4a0d1e48df0686457422050b9f54d6df0c03313 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 30 Apr 2025 13:01:10 +0200
Subject: [PATCH 230/267] Add 'transformations' logic to console.log statements

- Add 'transformations' field to StackItem interface
- When a StackItem is "within" an optimisation, we move it to the front
  of the optimsation, and add all opcodes between the start and the
  original location to the 'transformations'
- Inside logConsoleLogStatement, we apply these transformations *before*
  running the existing "log" logic
- Improve matching and replacement logic to fix whitespace bugs
- Add explicit 'OP_SWAP OP_(NUM)EQUALVERIFY' optimisations
- Add some extra tests and fixtures
---
 packages/cashc/test/generation/fixtures.ts    | 65 +++++++++++++++++++
 .../log_intermediate_results.cash             |  8 +++
 packages/cashscript/src/debugging.ts          | 35 +++++++++-
 packages/cashscript/test/debugging.test.ts    | 10 +++
 .../fixture/debugging/debugging_contracts.ts  | 11 +++-
 packages/utils/src/artifact.ts                |  7 ++
 packages/utils/src/optimisations.ts           |  4 ++
 packages/utils/src/script.ts                  | 39 +++++++----
 8 files changed, 164 insertions(+), 15 deletions(-)
 create mode 100644 packages/cashc/test/valid-contract-files/log_intermediate_results.cash

diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index e328e816..4dbf8148 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -760,4 +760,69 @@ export const fixtures: Fixture[] = [
       updatedAt: '',
     },
   },
+  {
+    fn: 'multiline_statements.cash',
+    artifact: {
+      contractName: 'MultilineStatements',
+      constructorInputs: [{ name: 'x', type: 'int' }, { name: 'y', type: 'string' }],
+      abi: [{ name: 'spend', inputs: [{ name: 'a', type: 'int' }, { name: 'b', type: 'string' }] }],
+      bytecode: 'OP_ROT OP_SWAP OP_2 OP_SUB OP_NUMEQUAL OP_2 OP_PICK OP_2 OP_PICK OP_EQUAL OP_BOOLAND OP_IF OP_0 OP_VERIFY OP_ELSE OP_OVER 48656c6c6f20 OP_2 OP_PICK OP_CAT OP_EQUAL OP_IF OP_DUP 576f726c64 OP_EQUALVERIFY OP_ELSE OP_1 OP_0 OP_NOT OP_NOT OP_NOT OP_EQUALVERIFY OP_ENDIF OP_ENDIF OP_2DROP OP_1',
+      debug: {
+        bytecode: '7b7c52949c52795279879a63006967780648656c6c6f2052797e87637605576f726c64886751009191918868686d51',
+        logs: [],
+        requires: [
+          { ip: 15, line: 11 },
+          { ip: 26, line: 14 },
+          { ip: 33, line: 18 },
+        ],
+        sourceMap: '9:12:9:13;:17::18;:21::22;:17:::1;:12;10::10:13:0;;:17::18;;:12:::1;9;10:20:12:9:0;11::11:25;:12::27:1;12:15:19:9:0;:19:12:20;:24::32;13:10:13:11;;12:24:::1;:19;13:13:17:9:0;15:16:15:17;:21::28;14:12:16:14:1;17:15:19:9:0;18:20:18:24;:31::36;:30:::1;:29;:28;:12::38;17:15:19:9;12;5:4:20:5;',
+      },
+      source: fs.readFileSync(new URL('../valid-contract-files/multiline_statements.cash', import.meta.url), { encoding: 'utf-8' }),
+      compiler: {
+        name: 'cashc',
+        version,
+      },
+      updatedAt: '',
+    },
+  },
+  {
+    fn: 'log_intermediate_results.cash',
+    artifact: {
+      contractName: 'LogIntermediateResults',
+      constructorInputs: [{ name: 'owner', type: 'pubkey' }],
+      abi: [{ name: 'test_log_intermediate_result', inputs: [] }],
+      bytecode: 'OP_HASH256 OP_SIZE OP_NIP 20 OP_NUMEQUAL',
+      debug: {
+        bytecode: 'aa827701209c',
+        sourceMap: '3:29:5:47:1;6:16:6:33;;:37::39:0;:16:::1',
+        logs: [
+          {
+            ip: 1,
+            line: 4,
+            data: [
+              {
+                stackIndex: 0,
+                type: 'bytes32 singleHash',
+                ip: 1,
+                transformations: 'OP_SHA256',
+              },
+            ],
+          },
+        ],
+        requires: [
+          {
+            ip: 6,
+            line: 6,
+            message: 'doubleHash should be 32 bytes',
+          },
+        ],
+      },
+      source: fs.readFileSync(new URL('../valid-contract-files/log_intermediate_results.cash', import.meta.url), { encoding: 'utf-8' }),
+      compiler: {
+        name: 'cashc',
+        version,
+      },
+      updatedAt: '',
+    },
+  },
 ];
diff --git a/packages/cashc/test/valid-contract-files/log_intermediate_results.cash b/packages/cashc/test/valid-contract-files/log_intermediate_results.cash
new file mode 100644
index 00000000..d14e096a
--- /dev/null
+++ b/packages/cashc/test/valid-contract-files/log_intermediate_results.cash
@@ -0,0 +1,8 @@
+contract LogIntermediateResults(pubkey owner) {
+    function test_log_intermediate_result() {
+        bytes32 singleHash = sha256(owner);
+        console.log(singleHash);
+        bytes32 doubleHash = sha256(singleHash);
+        require(doubleHash.length == 32, "doubleHash should be 32 bytes");
+    }
+}
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 37b04721..6ba5716a 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -1,5 +1,5 @@
-import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, WalletTemplateScriptUnlocking, binToHex, createCompiler, createVirtualMachineBch2025, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
-import { Artifact, LogEntry, Op, PrimitiveType, StackItem, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
+import { AuthenticationErrorCommon, AuthenticationInstruction, AuthenticationProgramCommon, AuthenticationProgramStateCommon, AuthenticationVirtualMachine, ResolvedTransactionCommon, WalletTemplate, WalletTemplateScriptUnlocking, binToHex, createCompiler, createVirtualMachineBch2025, decodeAuthenticationInstructions, encodeAuthenticationInstruction, walletTemplateToCompilerConfiguration } from '@bitauth/libauth';
+import { Artifact, LogEntry, Op, PrimitiveType, StackItem, asmToBytecode, bytecodeToAsm, decodeBool, decodeInt, decodeString } from '@cashscript/utils';
 import { findLastIndex, toRegExp } from './utils.js';
 import { FailedRequireError, FailedTransactionError, FailedTransactionEvaluationError } from './Errors.js';
 import { getBitauthUri } from './LibauthTemplate.js';
@@ -180,11 +180,40 @@ const logConsoleLogStatement = (
     if (typeof element === 'string') return element;
 
     const debugStep = debugSteps.find((step) => step.ip === element.ip)!;
-    return decodeStackItem(element, debugStep.stack);
+    const transformedDebugStep = applyStackItemTransformations(element, debugStep);
+    return decodeStackItem(element, transformedDebugStep.stack);
   });
   console.log(`${line} ${decodedData.join(' ')}`);
 };
 
+const applyStackItemTransformations = (
+  element: StackItem,
+  debugStep: AuthenticationProgramStateCommon,
+): AuthenticationProgramStateCommon => {
+  if (!element.transformations) return debugStep;
+
+  const transformationsBytecode = asmToBytecode(element.transformations);
+  const transformationsAuthenticationInstructions = decodeAuthenticationInstructions(transformationsBytecode);
+
+  const transformationsStartState: AuthenticationProgramStateCommon = {
+    alternateStack: [...debugStep.alternateStack],
+    controlStack: [],
+    ip: 0,
+    lastCodeSeparator: -1,
+    metrics: {} as any,
+    stack: [...debugStep.stack],
+    operationCount: 0,
+    instructions: transformationsAuthenticationInstructions,
+    signedMessages: [],
+    program: { ...debugStep.program },
+  };
+
+  const vm = createVirtualMachineBch2025();
+  const transformationsEndState = vm.stateEvaluate(transformationsStartState);
+
+  return transformationsEndState;
+};
+
 const decodeStackItem = (element: StackItem, stack: Uint8Array[]): any => {
   // Reversed since stack is in reverse order
   const stackItem = [...stack].reverse()[element.stackIndex];
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index b90fcd2d..13712087 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -13,6 +13,7 @@ import {
   artifactTestMultilineRequires,
   artifactTestZeroHandling,
 } from './fixture/debugging/debugging_contracts.js';
+import { sha256 } from '@cashscript/utils';
 
 describe('Debugging tests', () => {
   describe('console.log statements', () => {
@@ -132,6 +133,15 @@ describe('Debugging tests', () => {
       const expectedSecondLog = new RegExp('^Test.cash:11 0xbeef 1 test true$');
       await expect(transaction).toLog(expectedSecondLog);
     });
+
+    it('should log intermediate results that get optimised out', async () => {
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contractTestLogs.unlock.test_log_intermediate_result())
+        .addOutput({ to: contractTestLogs.address, amount: 10000n });
+
+      const expectedHash = binToHex(sha256(alicePub));
+      await expect(transaction).toLog(new RegExp(`^Test.cash:43 0x${expectedHash}$`));
+    });
   });
 
   describe('require statements', () => {
diff --git a/packages/cashscript/test/fixture/debugging/debugging_contracts.ts b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
index 79de636a..6a11bd24 100644
--- a/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
+++ b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
@@ -234,6 +234,15 @@ contract Test(pubkey owner) {
   function noLogs() {
     require(1 == 1);
   }
+
+  function test_log_intermediate_result() {
+    bytes32 singleHash = sha256(owner);
+    console.log(singleHash);
+
+    bytes32 doubleHash = sha256(singleHash);
+
+    require(doubleHash.length == 32, "doubleHash should be 32 bytes");
+  }
 }
 `;
 
@@ -257,7 +266,7 @@ const CONTRACT_TEST_MULTPLE_LOGS = `
 contract Test(pubkey owner) {
   function transfer(sig ownerSig, int num) {
     require(checkSig(ownerSig, owner));
-    
+
     console.log(ownerSig, owner, num);
 
     bytes2 beef = 0xbeef;
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index 7cba4b3a..7cb1567e 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -22,9 +22,16 @@ export interface LogEntry {
 }
 
 export interface StackItem {
+  // Type of the variable
   type: string;
+  // Index of the variable on the stack (at the time of the specified instruction pointer)
   stackIndex: number;
+  // Instruction pointer at which we can access the logged variable
   ip: number;
+  // Operations to apply to the debug state at the specified instruction pointer to make sure that the variable is
+  // on the correct position on the stack. This is used when we're optimising bytecode where the logged variable is
+  // an intermediate result that existed in the unoptimised bytecode, but no longer exists in the optimised bytecode.
+  transformations?: string;
 }
 
 export type LogData = StackItem | string;
diff --git a/packages/utils/src/optimisations.ts b/packages/utils/src/optimisations.ts
index b30b6f00..84f51c84 100644
--- a/packages/utils/src/optimisations.ts
+++ b/packages/utils/src/optimisations.ts
@@ -49,7 +49,11 @@ const provableOptimisations = [
 
   // Remove/replace extraneous OP_SWAP
   ['OP_SWAP OP_ADD', 'OP_ADD'],
+  // This was added to keep the old behaviour while explicitly disallowing partial matches in the optimisation regex
+  ['OP_SWAP OP_EQUALVERIFY', 'OP_EQUALVERIFY'],
   ['OP_SWAP OP_EQUAL', 'OP_EQUAL'],
+  // This was added to keep the old behaviour while explicitly disallowing partial matches in the optimisation regex
+  ['OP_SWAP OP_NUMEQUALVERIFY', 'OP_NUMEQUALVERIFY'],
   ['OP_SWAP OP_NUMEQUAL', 'OP_NUMEQUAL'],
   ['OP_SWAP OP_NUMNOTEQUAL', 'OP_NUMNOTEQUAL'],
   ['OP_SWAP OP_GREATERTHANOREQUAL', 'OP_LESSTHANOREQUAL'],
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index ec63b009..1491e3cd 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -259,16 +259,18 @@ function replaceOps(
     let processedAsm = '';
     let asmToSearch = asm;
 
-    const regex = new RegExp(pattern, 'g');
+    // We add a space or end of string to the end of the pattern to ensure that we match the whole pattern
+    // (no partial matches)
+    const regex = new RegExp(`${pattern}(\\s|$)`, 'g');
 
     let matchIndex = asmToSearch.search(regex);
     while (matchIndex !== -1) {
       // We add the part before the match to the processed asm
-      processedAsm += asmToSearch.slice(0, matchIndex);
+      processedAsm = mergeAsm(processedAsm, asmToSearch.slice(0, matchIndex));
 
       // We count the number of spaces in the processed asm + 1, which is equal to the script index
       // We do the same thing to calculate the number of opcodes in the pattern and replacement
-      const scriptIndex = processedAsm === '' ? 0 : [...processedAsm.trim().matchAll(/\s+/g)].length + 1;
+      const scriptIndex = processedAsm === '' ? 0 : [...processedAsm.matchAll(/\s+/g)].length + 1;
       const patternLength = [...pattern.matchAll(/\s+/g)].length + 1;
       const replacementLength = replacement === '' ? 0 : [...replacement.matchAll(/\s+/g)].length + 1;
 
@@ -327,38 +329,47 @@ function replaceOps(
           data: log.data.map((data) => {
             if (typeof data === 'string') return data;
 
-            const newCalculatedDataIp = data.ip - lengthDiff;
+            // If the log is completely before the pattern, we don't need to change anything
+            if (data.ip <= scriptIp) return data;
+
+            // If the log is completely after the pattern, we just need to offset the ip by the length diff
+            if (data.ip >= scriptIp + patternLength) {
+              const newCalculatedDataIp = data.ip - lengthDiff;
+              return { ...data, ip: newCalculatedDataIp };
+            }
+
+            const addedTransformationsCount = data.ip - scriptIp;
+            const addedTransformations = [...pattern.split(/\s+/g)].slice(0, addedTransformationsCount).join(' ');
+            const newTransformations = data.transformations ? `${addedTransformations} ${data.transformations}` : addedTransformations;
 
             return {
               ...data,
-              // If the log is within the pattern, we want to make sure that the new ip is at least the scriptIp
-              ip: data.ip >= scriptIp ? Math.max(scriptIp, newCalculatedDataIp) : data.ip,
+              ip: scriptIp,
+              transformations: newTransformations,
             };
           }),
         };
       });
 
       // We add the replacement to the processed asm
-      processedAsm += replacement;
+      processedAsm = mergeAsm(processedAsm, replacement);
 
       // We do not add the matched pattern anywhere since it gets replaced
 
       // We set the asmToSearch to the part after the match
-      asmToSearch = asmToSearch.slice(matchIndex + pattern.length);
+      asmToSearch = asmToSearch.slice(matchIndex + pattern.length).trim();
 
       // Find the next match
       matchIndex = asmToSearch.search(regex);
     }
 
     // We add the remaining asm to the processed asm
-    processedAsm += asmToSearch;
+    processedAsm = mergeAsm(processedAsm, asmToSearch);
 
     // We replace the original asm with the processed asm so that the next optimisation can use the updated asm
     asm = processedAsm;
   });
 
-  asm = asm.replace(/\s+/g, ' ').trim();
-
   return {
     script: asmToScript(asm),
     locationData: newLocationData,
@@ -398,3 +409,9 @@ const getLowestStartLocation = (locations: SingleLocationData[]): SingleLocation
     return lowest;
   }, locations[0]);
 };
+
+const mergeAsm = (asm1: string, asm2: string): string => {
+  // We merge two ASM strings by adding a space between them, and removing any duplicate spaces
+  // or trailing/leading spaces, which might have been introduced due to regex matching / replacements / empty asm strings
+  return `${asm1} ${asm2}`.replace(/\s+/g, ' ').trim();
+};

From dc0754dc43d660705c8082f3b42bc09a5d87c4ab Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 30 Apr 2025 13:19:53 +0200
Subject: [PATCH 231/267] Update docs for new optimised bytecode debugging

---
 website/docs/guides/debugging.md       | 4 ----
 website/docs/guides/optimization.md    | 2 +-
 website/docs/releases/release-notes.md | 5 ++++-
 3 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 8ad63f24..2018d7b1 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -52,10 +52,6 @@ const uri = await transactionBuilder.bitauthUri();
 It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
 :::
 
-:::note
-Currently the raw BCH Script you see in the Bitauth IDE is what the script looks like **before** any optimizations happen for the compiled output. This means you might spot some inefficiencies but those will likely not be present in the final compiled bytecode.
-:::
-
 The Bitauth IDE will show you the two-way mapping between the CashScript contract code generated opcodes. Here is [a Bitauth IDE link][BitauthIDE] for the basic `TransferWithTimeout` contract as an example:
 
 ```js
diff --git a/website/docs/guides/optimization.md b/website/docs/guides/optimization.md
index bfa81976..213b5fab 100644
--- a/website/docs/guides/optimization.md
+++ b/website/docs/guides/optimization.md
@@ -147,7 +147,7 @@ It's worth considering whether hand-optimizing the contract is necessary at all.
 
 ### Optimizing with the BitauthIDE
 
-When optimizing the bytecode of your contract you'll likely want to use the [BitauthIDE](https://ide.bitauth.com) so you can see the stack changes of each OpCode. It's important to realize that `transactionBuilder.bitauthUri()` will show the two-wap mapping to the **un-optimized** bytecode, so this is not the final resulting bytecode produced by the compiler. The compiler will perform a bunch of optimizations already, so you should look at the `Artifact bytecode` if you want to further optimize the compiled contract bytecode.
+When optimizing the bytecode of your contract to ensure it is the smallest possible bytesize you'll likely want to use the [BitauthIDE](https://ide.bitauth.com) so you can see the stack changes for each executed OpCode. Low-level understanding can also give good intuition about the [optimization tips](#optimization-tips) for the CashScript code.
 
 ### Overwriting the Artifact
 
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index b774c678..68952734 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,7 +2,7 @@
 title: Release Notes
 ---
 
-## v0.11.0-next.3
+## v0.11.0-next.4
 
 This update adds CashScript support for the new BCH 2025 network upgrade. To read more about the upgrade, see [this blog post](https://blog.bitjson.com/2025-chips/).
 
@@ -11,16 +11,19 @@ This release also contains several breaking changes, please refer to the [migrat
 #### cashc compiler
 - :hammer_and_wrench: Remove warning for opcount and update warning for byte size to match new limits.
 - :boom: **BREAKING**: `tx.age` was renamed to `this.age` to better reflect that it enforces a UTXO-level locktime check (*not* transaction-level).
+- :boom: **BREAKING**: The entire `debug` object on the artifact is reworked to enable debugging the optimised contract bytecode.
 
 #### CashScript SDK
 - :sparkles: Add debugging capabilities to the `TransactionBuilder`.
   - `transaction.debug()` & `transaction.bitauthUri()`
   - Output BitAuth IDE URI for debugging when transaction is rejected.
   - Libauth template generation and debugging for multi-contract transactions
+- :sparkles: Debugging now supports using the optimised contract bytecode (when compiled with `cashc@0.11.0` or later).
 - :hammer_and_wrench: Deprecate the simple transaction builder. You can still use the simple transaction builder with the current SDK, but this support will be removed in a future release.
 - :hammer_and_wrench: Update debug tooling to use the new `BCH_2025_05` instruction set.
 - :boom: **BREAKING**: Remove support for custom Clusters from `ElectrumNetworkProvider` and added a configuration object to the constructor.
 - :boom: **BREAKING**: Remove support for old contracts compiled with CashScript v0.6.x or earlier.
+- :bug: Fix bug where `JestExtensions` `expect().toLog()` would detect logs from different tests.
 
 #### @cashscript/utils
 - :boom: **BREAKING**: Remove `importArtifact` and `exportArtifact` helper functions. If you want to import or export artifacts, use `'fs'` to read and write files directly.

From 9f011a58759fa892ab4d7009a660b81c2cc5c3c0 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 30 Apr 2025 13:27:12 +0200
Subject: [PATCH 232/267] Bump version to 0.11.0-next.4

---
 examples/package.json               | 6 +++---
 examples/testing-suite/package.json | 6 +++---
 packages/cashc/package.json         | 4 ++--
 packages/cashc/src/index.ts         | 2 +-
 packages/cashscript/package.json    | 4 ++--
 packages/utils/package.json         | 2 +-
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index cddc0296..b28398b7 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.11.0-next.3",
+  "version": "0.11.0-next.4",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
     "@types/node": "^22.10.7",
-    "cashc": "^0.11.0-next.3",
-    "cashscript": "^0.11.0-next.3",
+    "cashc": "^0.11.0-next.4",
+    "cashscript": "^0.11.0-next.4",
     "eslint": "^8.56.0",
     "typescript": "^5.7.3"
   }
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 397f08e0..3cd0627c 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.11.0-next.3",
+  "version": "0.11.0-next.4",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -26,8 +26,8 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "cashc": "^0.11.0-next.3",
-    "cashscript": "^0.11.0-next.3",
+    "cashc": "^0.11.0-next.4",
+    "cashscript": "^0.11.0-next.4",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index 57d24e4f..fbde0be2 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.11.0-next.3",
+  "version": "0.11.0-next.4",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -52,7 +52,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.3",
+    "@cashscript/utils": "^0.11.0-next.4",
     "antlr4": "^4.13.2",
     "commander": "^13.1.0",
     "semver": "^7.6.3"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 1210a864..0b81e25a 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.11.0-next.3';
+export const version = '0.11.0-next.4';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 0cf91d22..2a340940 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.11.0-next.3",
+  "version": "0.11.0-next.4",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -46,7 +46,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.3",
+    "@cashscript/utils": "^0.11.0-next.4",
     "@electrum-cash/network": "^4.1.1",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "delay": "^6.0.0",
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 251e93bf..19954ae5 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.11.0-next.3",
+  "version": "0.11.0-next.4",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",

From 37d6a8693dc14c5816cd9a6e63ec36a24f67b628 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 30 Apr 2025 21:00:06 +0200
Subject: [PATCH 233/267] update cashc generation fixtures after sourcemap &
 debug changes

---
 packages/cashc/test/generation/fixtures.ts | 208 ++++++++++-----------
 1 file changed, 104 insertions(+), 104 deletions(-)

diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index 4dbf8148..04721cea 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -21,13 +21,13 @@ export const fixtures: Fixture[] = [
         // require(checkSig(s, pk))
         + 'OP_CHECKSIG',
       debug: {
-        bytecode: '5179a9517a8769517a517aac',
+        bytecode: '78a988ac',
         logs: [],
         requires: [
-          { ip: 7, line: 3 },
-          { ip: 13, line: 4 },
+          { ip: 3, line: 3 },
+          { ip: 5, line: 4 },
         ],
-        sourceMap: '3:24:3:26;;:16::27:1;:31::34:0;;:16:::1;:8::36;4:25:4:26:0;;:28::30;;:16::31:1',
+        sourceMap: '3:24:3:26;:16::27:1;:8::36;4:16:4:31',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/p2pkh.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -60,14 +60,14 @@ export const fixtures: Fixture[] = [
         + 'OP_ROT OP_ROT OP_CHECKSIG '
         + 'OP_NIP',
       debug: {
-        bytecode: '5a54940114517a529793007a517aa0690b48656c6c6f20576f726c640079527a7e5279a6517aa68769527a527aac77',
+        bytecode: '5a549401147c5297939f690b48656c6c6f20576f726c64767b7e5279a67ca6887b7bac77',
         logs: [],
         requires: [
-          { ip: 16, line: 5 },
-          { ip: 30, line: 10 },
-          { ip: 36, line: 11 },
+          { ip: 11, line: 5 },
+          { ip: 21, line: 10 },
+          { ip: 25, line: 11 },
         ],
-        sourceMap: '3:25:3:27;:30::31;:25:::1;4:30:4:32:0;:35::45;;:48::49;:35:::1;:30;5:16:5:31:0;;:34::35;;:16:::1;:8::37;7:20:7:33:0;8:13:8:15;;:18::19;;:13:::1;10:26:10:28:0;;:16::29:1;:43::45:0;;:33::46:1;:16;:8::48;11:25:11:26:0;;:28::30;;:16::31:1;2:4:12:5',
+        sourceMap: '3:25:3:27;:30::31;:25:::1;4:30:4:32:0;:35::45;:48::49;:35:::1;:30;5:16:5:35;:8::37;7:20:7:33:0;8:13:8:15;:18::19;:13:::1;10:26:10:28:0;;:16::29:1;:43::45:0;:33::46:1;:8::48;11:25:11:26:0;:28::30;:16::31:1;2:4:12:5',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/reassignment.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -106,14 +106,14 @@ export const fixtures: Fixture[] = [
         + 'OP_3 OP_ROLL OP_NUMEQUAL '
         + 'OP_NIP OP_NIP OP_NIP',
       debug: {
-        bytecode: '527954799300795479940079537a52949c6300795579935479517993527a757c00795279a0697567007954799c69680079547a93007a537a9c777777',
+        bytecode: '70937654799476537a52949c6376557993547978937b757c6e9f6975677654799d6876547a93537a9c777777',
         logs: [],
         requires: [
-          { ip: 39, line: 8 },
-          { ip: 47, line: 10 },
-          { ip: 59, line: 13 },
+          { ip: 28, line: 8 },
+          { ip: 34, line: 10 },
+          { ip: 43, line: 13 },
         ],
-        sourceMap: '3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22;;;;8:20:8:21:0;;:24::25;;:20:::1;:12::27;5:24:9:9;9:15:11::0;10:20:10:21;;:25::26;;:20:::1;:12::28;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;2:4:14:5;;',
+        sourceMap: '3:16:3:21;::::1;4:12:4:13:0;:16::17;;:12:::1;5::5:13:0;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;:24::25;;:20:::1;7:16:7:17:0;;:20::21;:16:::1;:12::22;;;8:20:8:25:0;::::1;:12::27;5:24:9:9;9:15:11::0;10:20:10:21;:25::26;;:12::28:1;9:15:11:9;12:12:12:13:0;:16::17;;:12:::1;13:21:13:22:0;;:16:::1;2:4:14:5;;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/if_statement.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -146,14 +146,14 @@ export const fixtures: Fixture[] = [
         + 'OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_2DROP OP_1 '
         + 'OP_ENDIF',
       debug: {
-        bytecode: '5379009c63547a527aac77777767537a519c69537a517aac69517ab175517768',
+        bytecode: '5379009c63547a7bac77777767537a519d537a7cad7cb16d5168',
         logs: [],
         requires: [
-          { ip: 13, line: 7 },
-          { ip: 27, line: 11 },
-          { ip: 30, line: 12 },
+          { ip: 12, line: 7 },
+          { ip: 23, line: 11 },
+          { ip: 25, line: 12 },
         ],
-        sourceMap: '6:4:8:5;;;;;7:25:7:37;;:39::48;;:16::49:1;6:4:8:5;;;;10::13::0;;;;;11:25:11:34;;:36::42;;:16::43:1;:8::45;12:27:12:34:0;;:8::36:1;;10:4:13:5;;1:0:14:1',
+        sourceMap: '6:4:8:5;;;;;7:25:7:37;;:39::48;:16::49:1;6:4:8:5;;;;10::13::0;;;;11:25:11:34;;:36::42;:8::45:1;12:27:12:34:0;:8::36:1;10:4:13:5;;1:0:14:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/multifunction.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -217,15 +217,15 @@ export const fixtures: Fixture[] = [
         + 'OP_2SWAP OP_NUMEQUAL '
         + 'OP_NIP OP_NIP OP_ENDIF',
       debug: {
-        bytecode: '5279009c63537955799300795579940079537a9c6300795679935579517993527a757c00795279a06975675479517a75680079557a93007a537a9c69517777777767527a519c695279007952930079537a9c6300795479930079527993527a757c00795279a0697568537a007a537a9c777768',
+        bytecode: '5279009c6353795579937655799476537a9c6376567993557978937b757c6e9f6975675479776876557a93537a9d6d6d51677b519d527976529376537a9c63765479936e937b757c6e9f697568729c777768',
         logs: [],
         requires: [
-          { ip: 42, line: 8 },
-          { ip: 61, line: 13 },
-          { ip: 104, line: 22 },
-          { ip: 114, line: 25 },
+          { ip: 34, line: 8 },
+          { ip: 47, line: 13 },
+          { ip: 76, line: 22 },
+          { ip: 81, line: 25 },
         ],
-        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;;:16::17;;:12:::1;5::5:13:0;;:17::18;;:12:::1;:20:9:9:0;6::6:21;;:24::25;;:20:::1;7:16:7:17:0;;:20::21;;:16:::1;:12::22;;;;8:20:8:21:0;;:24::25;;:20:::1;:12::27;5:20:9:9;9:15:11::0;10:16:10:17;;:12::18:1;;;9:15:11:9;12:12:12:13:0;;:16::17;;:12:::1;13:16:13::0;;:21::22;;:16:::1;:8::24;2:4:14:5;;;;;;16::26::0;;;;;17:16:17:17;;18:12:18:13;;:16::17;:12:::1;19::19:13:0;;:17::18;;:12:::1;:20:23:9:0;20::20:21;;:24::25;;:20:::1;21:16:21:17:0;;:20::21;;:16:::1;:12::22;;;;22:20:22:21:0;;:24::25;;:20:::1;:12::27;19:20:23:9;;24:12:24:13:0;;25:16:25:17;;:21::22;;:16:::1;16:4:26:5;;1:0:27:1',
+        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;:16::17;;:12:::1;5::5:13:0;:17::18;;:12:::1;:20:9:9:0;6::6:21;:24::25;;:20:::1;7:16:7:17:0;;:20::21;:16:::1;:12::22;;;8:20:8:25:0;::::1;:12::27;5:20:9:9;9:15:11::0;10:16:10:17;;:12::18:1;9:15:11:9;12:12:12:13:0;:16::17;;:12:::1;13:21:13:22:0;;:8::24:1;2:4:14:5;;;;16::26::0;;;17:16:17:17;;18:12:18:13;:16::17;:12:::1;19::19:13:0;:17::18;;:12:::1;:20:23:9:0;20::20:21;:24::25;;:20:::1;21:16:21:21:0;::::1;:12::22;;;22:20:22:25:0;::::1;:12::27;19:20:23:9;;24:12:25:22:0;25:16:::1;16:4:26:5;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/multifunction_if_statements.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -245,10 +245,10 @@ export const fixtures: Fixture[] = [
         // require(checkMultiSig([s1, s2], [pk1, pk2, pk3]))
         'OP_0 OP_2ROT OP_SWAP OP_2 OP_2ROT OP_SWAP OP_6 OP_ROLL OP_3 OP_CHECKMULTISIG',
       debug: {
-        bytecode: '00547a557a52547a557a567a53ae',
+        bytecode: '00717c52717c567a53ae',
         logs: [],
-        requires: [{ ip: 17, line: 3 }],
-        sourceMap: '3:12:3:52;:27::29;;:31::33;;:26::34:1;:37::40:0;;:42::45;;:47::50;;:36::51:1;:12::52',
+        requires: [{ ip: 13, line: 3 }],
+        sourceMap: '3:12:3:52;:27::33;;:26::34:1;:37::45:0;;:47::50;;:36::51:1;:12::52',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/2_of_3_multisig.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -272,13 +272,13 @@ export const fixtures: Fixture[] = [
         // bytes x = b.split(b.length / 2)[1]
         + 'OP_SWAP OP_4 OP_SPLIT OP_DROP OP_EQUAL OP_NOT',
       debug: {
-        bytecode: '00795179827752967f7700795279879169517a547f75517a8791',
+        bytecode: '7676827752967f776e8791697c547f758791',
         logs: [],
         requires: [
-          { ip: 17, line: 4 },
-          { ip: 27, line: 5 },
+          { ip: 12, line: 4 },
+          { ip: 19, line: 5 },
         ],
-        sourceMap: '3:18:3:19;;:26::27;;:::34:1;;:37::38:0;:26:::1;:18::39;:::42;4:16:4:17:0;;:21::22;;:16:::1;;:8::24;5:16:5:17:0;;:24::25;:16::26:1;:::29;:33::34:0;;:16:::1;',
+        sourceMap: '3:18:3:27;;:26::34:1;;:37::38:0;:26:::1;:18::39;:::42;4:16:4:22:0;::::1;;:8::24;5:16:5:17:0;:24::25;:16::26:1;:::29;:::34;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/split_size.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -300,13 +300,13 @@ export const fixtures: Fixture[] = [
         // require(checkSig(s, pk));
         + 'OP_CHECKSIG',
       debug: {
-        bytecode: '0079a600a98751918769517a517aac',
+        bytecode: '76a600a987519188ac',
         logs: [],
         requires: [
-          { ip: 9, line: 3 },
-          { ip: 15, line: 4 },
+          { ip: 7, line: 3 },
+          { ip: 9, line: 4 },
         ],
-        sourceMap: '3:33:3:35;;:17::37:1;:49::51:0;:41::52:1;:17;:57::61:0;:56:::1;:17;:8::64;4:25:4:26:0;;:28::30;;:16::31:1',
+        sourceMap: '3:33:3:35;:17::37:1;:49::51:0;:41::52:1;:17;:57::61:0;:56:::1;:8::64;4:16:4:31',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/cast_hash_checksig.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -354,16 +354,16 @@ export const fixtures: Fixture[] = [
         // require(checkSig(ownerSig, ownerPk));
         + 'OP_CHECKSIG',
       debug: {
-        bytecode: '5679547f517a81517a815179557aa269517ab175007a537aa269537a547a537aba69517a517aac',
+        bytecode: '5679547f7c817c8178557aa2697cb175537aa269537a547a537abbac',
         logs: [],
         requires: [
-          { ip: 19, line: 19 },
-          { ip: 22, line: 20 },
-          { ip: 29, line: 23 },
-          { ip: 37, line: 26 },
-          { ip: 43, line: 31 },
+          { ip: 16, line: 19 },
+          { ip: 18, line: 20 },
+          { ip: 23, line: 23 },
+          { ip: 30, line: 26 },
+          { ip: 32, line: 31 },
         ],
-        sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;;:26::45:1;16:24:16:32:0;;:20::33:1;19:16:19:27:0;;:31::39;;:16:::1;:8::41;20:27:20:38:0;;:8::40:1;;23:16:23:21:0;;:25::36;;:16:::1;:8::38;27:12:27:21:0;;28::28:25;;29::29:20;;26:16:30:9:1;:8::11;31:25:31:33:0;;:35::42;;:16::43:1',
+        sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;27:12:27:21:0;;28::28:25;;29::29:20;;26:8:30:11:1;31:16:31:43',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/hodl_vault.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -392,10 +392,10 @@ export const fixtures: Fixture[] = [
         + 'OP_2ROT OP_5 OP_ROLL OP_ADD OP_4 OP_ROLL OP_ADD '
         + 'OP_3 OP_ROLL OP_ADD OP_ROT OP_ADD OP_GREATERTHAN',
       debug: {
-        bytecode: '5152535455565579539f6353567a757c6b7c6b7c6b7c6b7c6c6c6c6c68557a557a557a93547a93537a93527a93a0',
+        bytecode: '5152535455565579539f6353567a757c6b7c6b7c6b7c6b7c6c6c6c6c6871557a93547a93537a937b93a0',
         logs: [],
-        requires: [{ ip: 46, line: 14 }],
-        sourceMap: '3:16:3:17;4::4;5::5;6::6;7::7;8::8;10:12:10:13;;:16::17;:12:::1;:19:12:9:0;11:16:11:17;:12::18:1;;;;;;;;;;;;;;;;10:19:12:9;14:16:14:17:0;;:20::21;;:24::25;;:20:::1;:28::29:0;;:20:::1;:32::33:0;;:20:::1;:36::37:0;;:20:::1;:16',
+        requires: [{ ip: 42, line: 14 }],
+        sourceMap: '3:16:3:17;4::4;5::5;6::6;7::7;8::8;10:12:10:13;;:16::17;:12:::1;:19:12:9:0;11:16:11:17;:12::18:1;;;;;;;;;;;;;;;;10:19:12:9;14:16:14:21:0;:24::25;;:20:::1;:28::29:0;;:20:::1;:32::33:0;;:20:::1;:36::37:0;:20:::1;:16',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/deep_replace.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -413,10 +413,10 @@ export const fixtures: Fixture[] = [
       abi: [{ name: 'spend', inputs: [{ name: 'b', type: 'bytes4' }, { name: 'i', type: 'int' }] }],
       bytecode: 'OP_SWAP OP_4 OP_NUM2BIN OP_EQUAL', // require(b == bytes4(i))
       debug: {
-        bytecode: '007a517a548087',
+        bytecode: '7c548087',
         logs: [],
-        requires: [{ ip: 7, line: 3 }],
-        sourceMap: '3:16:3:17;;:28::29;;:21::30:1;;:16',
+        requires: [{ ip: 4, line: 3 }],
+        sourceMap: '3:28:3:29;:21::30:1;;:16',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/bounded_bytes.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -443,13 +443,13 @@ export const fixtures: Fixture[] = [
         // require(tx.bytecode == 0x00)
         + 'OP_ACTIVEBYTECODE 00 OP_EQUAL',
       debug: {
-        bytecode: 'c2517a9c69c1010087',
+        bytecode: 'c29dc1010087',
         logs: [],
         requires: [
-          { ip: 5, line: 3 },
-          { ip: 9, line: 4 },
+          { ip: 2, line: 3 },
+          { ip: 6, line: 4 },
         ],
-        sourceMap: '3:16:3:26;:30::45;;:16:::1;:8::47;4:16:4:35:0;:39::43;:16:::1',
+        sourceMap: '3:16:3:26;:8::47:1;4:16:4:35:0;:39::43;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/covenant.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -507,31 +507,31 @@ export const fixtures: Fixture[] = [
         // require(tx.outputs[0].tokenAmount == 100);
         + 'OP_0 OP_OUTPUTTOKENAMOUNT 64 OP_NUMEQUAL',
       debug: {
-        bytecode: 'c2529c69c5009c69c3519c69c4519c69c0009c69c18277022c019c6900c60210279c6900c782770210279c6900c8200000000000000000000000000000000000000000000000000000000000000000876900c9009c6900ca827701649c6900cb009c6900cc0210279c6900cd827701649c6900ce200000000000000000000000000000000000000000000000000000000000000000876900cf0100876900d001649c6900d1200000000000000000000000000000000000000000000000000000000000000000876900d20100876900d301649c',
+        bytecode: 'c2529dc5009dc3519dc4519dc0009dc18277022c019d00c60210279d00c782770210279d00c82000000000000000000000000000000000000000000000000000000000000000008800c9009d00ca827701649d00cb009d00cc0210279d00cd827701649d00ce2000000000000000000000000000000000000000000000000000000000000000008800cf01008800d001649d00d12000000000000000000000000000000000000000000000000000000000000000008800d201008800d301649c',
         logs: [],
         requires: [
-          { ip: 3, line: 3 },
-          { ip: 7, line: 4 },
-          { ip: 11, line: 5 },
-          { ip: 15, line: 6 },
-          { ip: 19, line: 7 },
-          { ip: 25, line: 8 },
-          { ip: 30, line: 9 },
-          { ip: 37, line: 10 },
-          { ip: 42, line: 11 },
-          { ip: 47, line: 12 },
-          { ip: 54, line: 13 },
-          { ip: 59, line: 14 },
-          { ip: 64, line: 15 },
-          { ip: 71, line: 16 },
-          { ip: 76, line: 17 },
-          { ip: 81, line: 18 },
-          { ip: 86, line: 19 },
-          { ip: 91, line: 20 },
-          { ip: 96, line: 21 },
-          { ip: 101, line: 22 },
+          { ip: 2, line: 3 },
+          { ip: 5, line: 4 },
+          { ip: 8, line: 5 },
+          { ip: 11, line: 6 },
+          { ip: 14, line: 7 },
+          { ip: 19, line: 8 },
+          { ip: 23, line: 9 },
+          { ip: 29, line: 10 },
+          { ip: 33, line: 11 },
+          { ip: 37, line: 12 },
+          { ip: 43, line: 13 },
+          { ip: 47, line: 14 },
+          { ip: 51, line: 15 },
+          { ip: 57, line: 16 },
+          { ip: 61, line: 17 },
+          { ip: 65, line: 18 },
+          { ip: 69, line: 19 },
+          { ip: 73, line: 20 },
+          { ip: 77, line: 21 },
+          { ip: 82, line: 22 },
         ],
-        sourceMap: '3:16:3:26;:30::31;:16:::1;:8::33;4:16:4:27:0;:31::32;:16:::1;:8::34;5:16:5:32:0;:36::37;:16:::1;:8::39;6:16:6:33:0;:37::38;:16:::1;:8::40;7:16:7:37:0;:41::42;:16:::1;:8::44;8:16:8:35:0;:::42:1;;:46::49:0;:16:::1;:8::51;9:26:9:27:0;:16::34:1;:38::43:0;:16:::1;:8::45;10:26:10:27:0;:16::44:1;:::51;;:55::60:0;:16:::1;:8::62;11:26:11:27:0;:16::52:1;:56::121:0;:16:::1;:8::123;12:26:12:27:0;:16::42:1;:46::47:0;:16:::1;:8::49;13:26:13:27:0;:16::46:1;:::53;;:57::60:0;:16:::1;:8::62;14:26:14:27:0;:16::43:1;:47::48:0;:16:::1;:8::50;15:27:15:28:0;:16::35:1;:39::44:0;:16:::1;:8::46;16:27:16:28:0;:16::45:1;:::52;;:56::59:0;:16:::1;:8::61;17:26:17:27:0;:16::42:1;:46::111:0;:16:::1;:8::113;18:26:18:27:0;:16::42:1;:46::50:0;:16:::1;:8::52;19:26:19:27:0;:16::40:1;:44::47:0;:16:::1;:8::49;20:27:20:28:0;:16::43:1;:47::112:0;:16:::1;:8::114;21:27:21:28:0;:16::43:1;:47::51:0;:16:::1;:8::53;22:27:22:28:0;:16::41:1;:45::48:0;:16:::1',
+        sourceMap: '3:16:3:26;:30::31;:8::33:1;4:16:4:27:0;:31::32;:8::34:1;5:16:5:32:0;:36::37;:8::39:1;6:16:6:33:0;:37::38;:8::40:1;7:16:7:37:0;:41::42;:8::44:1;8:16:8:35:0;:::42:1;;:46::49:0;:8::51:1;9:26:9:27:0;:16::34:1;:38::43:0;:8::45:1;10:26:10:27:0;:16::44:1;:::51;;:55::60:0;:8::62:1;11:26:11:27:0;:16::52:1;:56::121:0;:8::123:1;12:26:12:27:0;:16::42:1;:46::47:0;:8::49:1;13:26:13:27:0;:16::46:1;:::53;;:57::60:0;:8::62:1;14:26:14:27:0;:16::43:1;:47::48:0;:8::50:1;15:27:15:28:0;:16::35:1;:39::44:0;:8::46:1;16:27:16:28:0;:16::45:1;:::52;;:56::59:0;:8::61:1;17:26:17:27:0;:16::42:1;:46::111:0;:8::113:1;18:26:18:27:0;:16::42:1;:46::50:0;:8::52:1;19:26:19:27:0;:16::40:1;:44::47:0;:8::49:1;20:27:20:28:0;:16::43:1;:47::112:0;:8::114:1;21:27:21:28:0;:16::43:1;:47::51:0;:8::53:1;22:27:22:28:0;:16::41:1;:45::48:0;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/covenant_all_fields.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -593,19 +593,19 @@ export const fixtures: Fixture[] = [
         // Cleanup
         + 'OP_NIP OP_NIP OP_NIP OP_ENDIF',
       debug: {
-        bytecode: '5479009c63537ab27500cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767547a519c695479a9527a8769547a547aac77777768',
+        bytecode: '5479009c63537ab27500cd0376a9147b7e0288ac7e8802e803c0c676547994527994765579547993a16300cc707c949d6700cc55799d51cdc0c78851cc789d686d6d6d5167547a519d5479a97b88547a547aac77777768',
         logs: [],
         requires: [
           { ip: 11, line: 3 },
-          { ip: 22, line: 6 },
-          { ip: 51, line: 15 },
-          { ip: 58, line: 17 },
-          { ip: 64, line: 18 },
-          { ip: 70, line: 19 },
-          { ip: 91, line: 24 },
-          { ip: 97, line: 25 },
+          { ip: 20, line: 6 },
+          { ip: 44, line: 15 },
+          { ip: 50, line: 17 },
+          { ip: 55, line: 18 },
+          { ip: 59, line: 19 },
+          { ip: 74, line: 24 },
+          { ip: 80, line: 25 },
         ],
-        sourceMap: '2:4:21:5;;;;;3:28:3:34;;:8::36:1;;6:27:6:28:0;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;8:23:8:27:0;9:37:9:58;:27::65:1;10:26:10:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;16:15:20:9:0;17:31:17:32;:20::39:1;:43::49:0;;:20:::1;:12::51;18:31:18:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;19:31:19:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;16:15:20:9;2:4:21:5;;;;;;;;23::26::0;;;;;24:24:24:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
+        sourceMap: '2:4:21:5;;;;;3:28:3:34;;:8::36:1;;6:27:6:28:0;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;8:23:8:27:0;9:37:9:58;:27::65:1;10:26:10:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39:1;:43::66:0;;::::1;:12::68;16:15:20:9:0;17:31:17:32;:20::39:1;:43::49:0;;:12::51:1;18:31:18:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;19:31:19:32:0;:20::39:1;:43::54:0;:12::56:1;16:15:20:9;2:4:21:5;;;;;23::26::0;;;;24:24:24:26;;:16::27:1;:31::37:0;:8::39:1;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/mecenas.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -647,15 +647,15 @@ export const fixtures: Fixture[] = [
         // Stack clean-up
         + 'OP_DROP OP_1',
       debug: {
-        bytecode: '016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009c6900cd517a876902e803c0c65179940079527aa26351cdc0c7876951cc51799c69685177',
+        bytecode: '016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009d00cd8802e803c0c67894767ba26351cdc0c78851cc789d687551',
         logs: [],
         requires: [
-          { ip: 23, line: 16 },
-          { ip: 29, line: 17 },
-          { ip: 47, line: 24 },
-          { ip: 53, line: 25 },
+          { ip: 22, line: 16 },
+          { ip: 25, line: 17 },
+          { ip: 39, line: 24 },
+          { ip: 43, line: 25 },
         ],
-        sourceMap: '10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:16:::1;:8::42;17:27:17:28:0;:16::45:1;:49::61:0;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;;:20:::1;:12::57;23:38:26:9;8:4:27:5;',
+        sourceMap: '10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:8::42:1;17:27:17:28:0;:16::45:1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;:27:::1;23:12:23:24:0;:28::36;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;:12::57:1;23:38:26:9;8:4:27:5;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/announcement.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -675,10 +675,10 @@ export const fixtures: Fixture[] = [
       ],
       bytecode: 'OP_DUP OP_REVERSEBYTES OP_EQUAL',
       debug: {
-        bytecode: '0079bc517a87',
+        bytecode: '76bc87',
         logs: [],
-        requires: [{ ip: 6, line: 3 }],
-        sourceMap: '3:16:3:26;;:::36:1;:40::50:0;;:16:::1',
+        requires: [{ ip: 3, line: 3 }],
+        sourceMap: '3:16:3:26;:::36:1;:::50',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/p2palindrome.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -698,10 +698,10 @@ export const fixtures: Fixture[] = [
       ],
       bytecode: 'OP_10 OP_SWAP OP_NUM2BIN OP_BIN2NUM OP_10 OP_NUMEQUAL',
       debug: {
-        bytecode: '5a517a80007a815a9c',
+        bytecode: '5a7c80815a9c',
         logs: [],
-        requires: [{ ip: 9, line: 4 }],
-        sourceMap: '3:28:3:30;:32::36;;:22::37:1;4:20:4:25:0;;:16::26:1;:30::32:0;:16:::1',
+        requires: [{ ip: 6, line: 4 }],
+        sourceMap: '3:28:3:30;:32::36;:22::37:1;4:16:4:26;:30::32:0;:16:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/num2bin_variable.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -721,13 +721,13 @@ export const fixtures: Fixture[] = [
       ],
       bytecode: 'OP_DUP OP_1 OP_NUMEQUALVERIFY OP_1ADD OP_2 OP_NUMEQUAL',
       debug: {
-        bytecode: '0079519c69007a5193529c',
+        bytecode: '76519d8b529c',
         logs: [
-          { data: [{ stackIndex: 0, type: 'int', ip: 5 }, 'test'], ip: 5, line: 4 },
-          { data: [{ stackIndex: 0, type: 'int', ip: 5 }, 'test2'], ip: 5, line: 5 },
+          { data: [{ stackIndex: 0, type: 'int', ip: 3 }, 'test'], ip: 3, line: 4 },
+          { data: [{ stackIndex: 0, type: 'int', ip: 3 }, 'test2'], ip: 3, line: 5 },
         ],
-        requires: [{ ip: 4, line: 3, message: 'Wrong value passed' }, { ip: 11, line: 6, message: 'Sum doesn\'t work' }],
-        sourceMap: '3:12:3:17;;:21::22;:12:::1;:4::46;6:12:6:17:0;;:20::21;:12:::1;:25::26:0;:12:::1',
+        requires: [{ ip: 2, line: 3, message: 'Wrong value passed' }, { ip: 6, line: 6, message: 'Sum doesn\'t work' }],
+        sourceMap: '3:12:3:17;:21::22;:4::46:1;6:12:6:21;:25::26:0;:12:::1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/debug_messages.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -747,10 +747,10 @@ export const fixtures: Fixture[] = [
       ],
       bytecode: '0010a5d4e800 0010a5d4e800 0010a5d4e800 0010a5d4e800 0010a5d4e800 OP_4 OP_ROLL OP_OVER OP_NUMEQUALVERIFY OP_3 OP_ROLL OP_OVER OP_NUMEQUALVERIFY OP_ROT OP_OVER OP_NUMEQUALVERIFY OP_NUMEQUAL',
       debug: {
-        bytecode: '060010a5d4e800060010a5d4e800060010a5d4e800060010a5d4e800060010a5d4e800547a51799c69537a51799c69527a51799c69517a517a9c',
+        bytecode: '060010a5d4e800060010a5d4e800060010a5d4e800060010a5d4e800060010a5d4e800547a789d537a789d7b789d9c',
         logs: [],
-        requires: [{ ip: 10, line: 10 }, { ip: 16, line: 11 }, { ip: 22, line: 12 }, { ip: 28, line: 13 }],
-        sourceMap: '3:26:3:30;4::4;5::5:43;6:23:6:30;8:22:8:35;10:16:10:27;;:31::38;;:16:::1;:8::40;11:16:11:27:0;;:31::38;;:16:::1;:8::40;12:16:12:27:0;;:31::38;;:16:::1;:8::40;13:16:13:24:0;;:28::35;;:16:::1',
+        requires: [{ ip: 8, line: 10 }, { ip: 12, line: 11 }, { ip: 15, line: 12 }, { ip: 17, line: 13 }],
+        sourceMap: '3:26:3:30;4::4;5::5:43;6:23:6:30;8:22:8:35;10:16:10:27;;:31::38;:8::40:1;11:16:11:27:0;;:31::38;:8::40:1;12:16:12:27:0;:31::38;:8::40:1;13:16:13:35',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/integer_formatting.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {

From df277da68c7899c21f116b0646f223d07e15e136 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 1 May 2025 10:46:13 +0200
Subject: [PATCH 234/267] Fix issue where variable name was included in type
 string in StackIndex

---
 packages/cashc/src/generation/GenerateTargetTraversal.ts | 4 ++--
 packages/cashc/test/generation/fixtures.ts               | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index ed4b0159..d4357f15 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -333,7 +333,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
         }
 
         // If the variable is on the stack, we add the stack index and type to the console log
-        const type = typeof symbol.type === 'string' ? symbol.type : symbol.toString();
+        const type = symbol.type.toString();
         return { stackIndex, type, ip };
       }
 
@@ -572,7 +572,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     if (this.isOpRoll(node)) {
       const symbol = node.definition!;
       this.finalStackUsage[node.name] = {
-        type:  typeof symbol.type === 'string' ? symbol.type : symbol.toString(),
+        type: symbol.type.toString(),
         stackIndex,
         ip: this.getMostRecentInstructionPointer(),
       };
diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index 04721cea..03cfde43 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -802,7 +802,7 @@ export const fixtures: Fixture[] = [
             data: [
               {
                 stackIndex: 0,
-                type: 'bytes32 singleHash',
+                type: 'bytes32',
                 ip: 1,
                 transformations: 'OP_SHA256',
               },

From 68cdf30db455e3eef448a4feacfff0f5f26a36a7 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 1 May 2025 11:07:17 +0200
Subject: [PATCH 235/267] Update utils fixtures after sourcemap optimisations

---
 packages/utils/test/bitauth-script.test.ts    |   3 +-
 .../test/fixtures/bitauth-script.fixture.ts   | 288 +++++++++---------
 2 files changed, 146 insertions(+), 145 deletions(-)

diff --git a/packages/utils/test/bitauth-script.test.ts b/packages/utils/test/bitauth-script.test.ts
index b883a916..06cf04eb 100644
--- a/packages/utils/test/bitauth-script.test.ts
+++ b/packages/utils/test/bitauth-script.test.ts
@@ -9,9 +9,10 @@ describe('Libauth Script formatting', () => {
       const scriptBytecode = asmToScript(fixture.asmBytecode);
 
       // Note: this also tests the compiler (but the compiler is tested much more thoroughly in its own test suite)
-      it('should generate a correct source map from freshly compiled source code', () => {
+      it('should generate a correct source map and bytecode from freshly compiled source code', () => {
         const artifact = compileString(fixture.sourceCode);
         expect(artifact.debug?.sourceMap).toEqual(fixture.sourceMap);
+        expect(artifact.bytecode).toEqual(fixture.asmBytecode);
       });
 
       it('should build a line-to-opcodes map', () => {
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index 48714a52..bf11736c 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -33,58 +33,58 @@ contract TransferWithTimeout(bytes20 senderPkh, bytes20 recipientPkh, int timeou
     require(tx.time >= timeout);
   }
 }`,
-    asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_5 OP_ROLL OP_5 OP_PICK OP_CHECKSIG OP_VERIFY OP_4 OP_ROLL OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY OP_0 OP_PICK deadbeef OP_EQUAL OP_VERIFY OP_2 OP_PICK OP_3 OP_PICK OP_NUMEQUAL OP_VERIFY OP_4 OP_PICK OP_5 OP_PICK OP_EQUAL OP_VERIFY OP_3 OP_PICK OP_4 OP_PICK OP_EQUAL OP_VERIFY OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIG OP_VERIFY OP_3 OP_ROLL OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP OP_1 OP_NIP OP_ENDIF',
-    sourceMap: '3:2:6:3;;;;;4:21:4:22;;:24::33;;:12::34:1;:4::36;5:20:5:29:0;;:12::30:1;:34::46:0;;:12:::1;3:2:6:3;;;;8::16::0;;;;;9:12:9:21;;:25::35;:12:::1;:4::37;10:12:10:19:0;;:23::30;;:12:::1;:4::32;11:12:11:13:0;;:17::18;;:12:::1;:4::20;12:12:12:21:0;;:25::34;;:12:::1;:4::36;13:21:13:22:0;;:24::33;;:12::34:1;:4::36;14:20:14:29:0;;:12::30:1;:34::43:0;;:12:::1;:4::45;15:23:15:30:0;;:4::32:1;;8:2:16:3;;2:0:17:1',
+    asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_5 OP_ROLL OP_5 OP_PICK OP_CHECKSIGVERIFY OP_4 OP_ROLL OP_HASH160 OP_ROT OP_EQUAL OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_DUP deadbeef OP_EQUALVERIFY OP_2 OP_PICK OP_3 OP_PICK OP_NUMEQUALVERIFY OP_4 OP_PICK OP_5 OP_PICK OP_EQUALVERIFY OP_3 OP_PICK OP_4 OP_PICK OP_EQUALVERIFY OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIGVERIFY OP_3 OP_ROLL OP_HASH160 OP_EQUALVERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_2DROP OP_1 OP_ENDIF',
+    sourceMap: '3:2:6:3;;;;;4:21:4:22;;:24::33;;:4::36:1;5:20:5:29:0;;:12::30:1;:34::46:0;:12:::1;3:2:6:3;;;;8::16::0;;;;9:12:9:21;:25::35;:4::37:1;10:12:10:19:0;;:23::30;;:4::32:1;11:12:11:13:0;;:17::18;;:4::20:1;12:12:12:21:0;;:25::34;;:4::36:1;13:21:13:22:0;;:24::33;;:4::36:1;14:20:14:29:0;;:12::30:1;:4::45;15:23:15:30:0;:4::32:1;8:2:16:3;;2:0:17:1',
     expectedLineToOpcodeMap: {
       3: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
-      4: [Op.OP_5, Op.OP_ROLL, Op.OP_5, Op.OP_PICK, Op.OP_CHECKSIG, Op.OP_VERIFY],
-      5: [Op.OP_4, Op.OP_ROLL, Op.OP_HASH160, Op.OP_2, Op.OP_ROLL, Op.OP_EQUAL],
+      4: [Op.OP_5, Op.OP_ROLL, Op.OP_5, Op.OP_PICK, Op.OP_CHECKSIGVERIFY],
+      5: [Op.OP_4, Op.OP_ROLL, Op.OP_HASH160, Op.OP_ROT, Op.OP_EQUAL],
       6: [Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_ELSE],
-      8: [Op.OP_3, Op.OP_ROLL, Op.OP_1, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      9: [new Uint8Array([]), Op.OP_PICK, new Uint8Array([0xde, 0xad, 0xbe, 0xef]), Op.OP_EQUAL, Op.OP_VERIFY],
-      10: [Op.OP_2, Op.OP_PICK, Op.OP_3, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      11: [Op.OP_4, Op.OP_PICK, Op.OP_5, Op.OP_PICK, Op.OP_EQUAL, Op.OP_VERIFY],
-      12: [Op.OP_3, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_EQUAL, Op.OP_VERIFY],
-      13: [Op.OP_4, Op.OP_ROLL, Op.OP_4, Op.OP_PICK, Op.OP_CHECKSIG, Op.OP_VERIFY],
-      14: [Op.OP_3, Op.OP_ROLL, Op.OP_HASH160, Op.OP_1, Op.OP_ROLL, Op.OP_EQUAL, Op.OP_VERIFY],
-      15: [Op.OP_1, Op.OP_ROLL, Op.OP_CHECKLOCKTIMEVERIFY, Op.OP_DROP],
-      16: [Op.OP_1, Op.OP_NIP],
+      8: [Op.OP_3, Op.OP_ROLL, Op.OP_1, Op.OP_NUMEQUALVERIFY],
+      9: [Op.OP_DUP, new Uint8Array([0xde, 0xad, 0xbe, 0xef]), Op.OP_EQUALVERIFY],
+      10: [Op.OP_2, Op.OP_PICK, Op.OP_3, Op.OP_PICK, Op.OP_NUMEQUALVERIFY],
+      11: [Op.OP_4, Op.OP_PICK, Op.OP_5, Op.OP_PICK, Op.OP_EQUALVERIFY],
+      12: [Op.OP_3, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_EQUALVERIFY],
+      13: [Op.OP_4, Op.OP_ROLL, Op.OP_4, Op.OP_PICK, Op.OP_CHECKSIGVERIFY],
+      14: [Op.OP_3, Op.OP_ROLL, Op.OP_HASH160, Op.OP_EQUALVERIFY],
+      15: [Op.OP_SWAP, Op.OP_CHECKLOCKTIMEVERIFY],
+      16: [Op.OP_2DROP, Op.OP_1],
       17: [Op.OP_ENDIF],
     },
     expectedLineToAsmMap: {
       3: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF',
-      4: 'OP_5 OP_ROLL OP_5 OP_PICK OP_CHECKSIG OP_VERIFY',
-      5: 'OP_4 OP_ROLL OP_HASH160 OP_2 OP_ROLL OP_EQUAL',
+      4: 'OP_5 OP_ROLL OP_5 OP_PICK OP_CHECKSIGVERIFY',
+      5: 'OP_4 OP_ROLL OP_HASH160 OP_ROT OP_EQUAL',
       6: 'OP_NIP OP_NIP OP_NIP OP_ELSE',
-      8: 'OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY',
-      9: 'OP_0 OP_PICK <0xdeadbeef> OP_EQUAL OP_VERIFY',
-      10: 'OP_2 OP_PICK OP_3 OP_PICK OP_NUMEQUAL OP_VERIFY',
-      11: 'OP_4 OP_PICK OP_5 OP_PICK OP_EQUAL OP_VERIFY',
-      12: 'OP_3 OP_PICK OP_4 OP_PICK OP_EQUAL OP_VERIFY',
-      13: 'OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIG OP_VERIFY',
-      14: 'OP_3 OP_ROLL OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY',
-      15: 'OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP',
-      16: 'OP_1 OP_NIP',
+      8: 'OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY',
+      9: 'OP_DUP <0xdeadbeef> OP_EQUALVERIFY',
+      10: 'OP_2 OP_PICK OP_3 OP_PICK OP_NUMEQUALVERIFY',
+      11: 'OP_4 OP_PICK OP_5 OP_PICK OP_EQUALVERIFY',
+      12: 'OP_3 OP_PICK OP_4 OP_PICK OP_EQUALVERIFY',
+      13: 'OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIGVERIFY',
+      14: 'OP_3 OP_ROLL OP_HASH160 OP_EQUALVERIFY',
+      15: 'OP_SWAP OP_CHECKLOCKTIMEVERIFY',
+      16: 'OP_2DROP OP_1',
       17: 'OP_ENDIF',
     },
     expectedBitAuthScript: `
-                                                        /*                                                                                      */
-                                                        /* contract TransferWithTimeout(bytes20 senderPkh, bytes20 recipientPkh, int timeout) { */
-OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*   function transfer(pubkey signingPk, sig s) {                                       */
-OP_5 OP_ROLL OP_5 OP_PICK OP_CHECKSIG OP_VERIFY         /*     require(checkSig(s, signingPk));                                                 */
-OP_4 OP_ROLL OP_HASH160 OP_2 OP_ROLL OP_EQUAL           /*     require(hash160(signingPk) == recipientPkh);                                     */
-OP_NIP OP_NIP OP_NIP OP_ELSE                            /*   }                                                                                  */
-                                                        /*                                                                                      */
-OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                 /*   function timeout(pubkey signingPk, sig s) {                                        */
-OP_0 OP_PICK <0xdeadbeef> OP_EQUAL OP_VERIFY            /*     require(senderPkh == 0xdeadbeef);                                                */
-OP_2 OP_PICK OP_3 OP_PICK OP_NUMEQUAL OP_VERIFY         /*     require(timeout == timeout);                                                     */
-OP_4 OP_PICK OP_5 OP_PICK OP_EQUAL OP_VERIFY            /*     require(s == s);                                                                 */
-OP_3 OP_PICK OP_4 OP_PICK OP_EQUAL OP_VERIFY            /*     require(signingPk == signingPk);                                                 */
-OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIG OP_VERIFY         /*     require(checkSig(s, signingPk));                                                 */
-OP_3 OP_ROLL OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*     require(hash160(signingPk) == senderPkh);                                        */
-OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP             /*     require(tx.time >= timeout);                                                     */
-OP_1 OP_NIP                                             /*   }                                                                                  */
-OP_ENDIF                                                /* }                                                                                    */
+                                            /*                                                                                      */
+                                            /* contract TransferWithTimeout(bytes20 senderPkh, bytes20 recipientPkh, int timeout) { */
+OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF         /*   function transfer(pubkey signingPk, sig s) {                                       */
+OP_5 OP_ROLL OP_5 OP_PICK OP_CHECKSIGVERIFY /*     require(checkSig(s, signingPk));                                                 */
+OP_4 OP_ROLL OP_HASH160 OP_ROT OP_EQUAL     /*     require(hash160(signingPk) == recipientPkh);                                     */
+OP_NIP OP_NIP OP_NIP OP_ELSE                /*   }                                                                                  */
+                                            /*                                                                                      */
+OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY         /*   function timeout(pubkey signingPk, sig s) {                                        */
+OP_DUP <0xdeadbeef> OP_EQUALVERIFY          /*     require(senderPkh == 0xdeadbeef);                                                */
+OP_2 OP_PICK OP_3 OP_PICK OP_NUMEQUALVERIFY /*     require(timeout == timeout);                                                     */
+OP_4 OP_PICK OP_5 OP_PICK OP_EQUALVERIFY    /*     require(s == s);                                                                 */
+OP_3 OP_PICK OP_4 OP_PICK OP_EQUALVERIFY    /*     require(signingPk == signingPk);                                                 */
+OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIGVERIFY /*     require(checkSig(s, signingPk));                                                 */
+OP_3 OP_ROLL OP_HASH160 OP_EQUALVERIFY      /*     require(hash160(signingPk) == senderPkh);                                        */
+OP_SWAP OP_CHECKLOCKTIMEVERIFY              /*     require(tx.time >= timeout);                                                     */
+OP_2DROP OP_1                               /*   }                                                                                  */
+OP_ENDIF                                    /* }                                                                                    */
 `.replace(/^\n+/, '').replace(/\n+$/, ''),
   },
   {
@@ -124,83 +124,83 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
         require(checkSig(s, pk));
     }
 }`.replace(/^\n+/, '').replace(/\n+$/, ''),
-    asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_2 OP_ROLL OP_CAT 88ac OP_CAT OP_EQUAL OP_VERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY OP_ENDIF OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
-    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
+    asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
+    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::66:0;;::::1;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:12::51:1;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;:12::56:1;23:15:27:9;9:4:28:5;;;;;30::33::0;;;;31:24:31:26;;:16::27:1;:31::37:0;:8::39:1;32:25:32:30:0;:16::31:1;30:4:33:5;;8:0:34:1',
     expectedLineToOpcodeMap: {
       9: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
-      13: [new Uint8Array([]), Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_2, Op.OP_ROLL, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUAL, Op.OP_VERIFY],
+      13: [new Uint8Array([]), Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_ROT, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUALVERIFY],
       15: [hexToBin('e803')],
       16: [Op.OP_INPUTINDEX, Op.OP_UTXOVALUE],
-      17: [new Uint8Array([]), Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_2, Op.OP_PICK, Op.OP_SUB],
-      21: [new Uint8Array([]), Op.OP_PICK, Op.OP_5, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_ADD, Op.OP_LESSTHANOREQUAL, Op.OP_IF],
-      22: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_2, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      17: [Op.OP_DUP, Op.OP_4, Op.OP_PICK, Op.OP_SUB, Op.OP_2, Op.OP_PICK, Op.OP_SUB],
+      21: [Op.OP_DUP, Op.OP_5, Op.OP_PICK, Op.OP_4, Op.OP_PICK, Op.OP_ADD, Op.OP_LESSTHANOREQUAL, Op.OP_IF],
+      22: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_2OVER, Op.OP_SWAP, Op.OP_SUB, Op.OP_NUMEQUALVERIFY],
       23: [Op.OP_ELSE],
-      24: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_5, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      25: [Op.OP_1, Op.OP_OUTPUTBYTECODE, Op.OP_INPUTINDEX, Op.OP_UTXOBYTECODE, Op.OP_EQUAL, Op.OP_VERIFY],
-      26: [Op.OP_1, Op.OP_OUTPUTVALUE, Op.OP_1, Op.OP_PICK, Op.OP_NUMEQUAL, Op.OP_VERIFY],
+      24: [new Uint8Array([]), Op.OP_OUTPUTVALUE, Op.OP_5, Op.OP_PICK, Op.OP_NUMEQUALVERIFY],
+      25: [Op.OP_1, Op.OP_OUTPUTBYTECODE, Op.OP_INPUTINDEX, Op.OP_UTXOBYTECODE, Op.OP_EQUALVERIFY],
+      26: [Op.OP_1, Op.OP_OUTPUTVALUE, Op.OP_OVER, Op.OP_NUMEQUALVERIFY],
       27: [Op.OP_ENDIF],
-      28: [Op.OP_1, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_NIP, Op.OP_ELSE],
-      30: [Op.OP_3, Op.OP_ROLL, Op.OP_1, Op.OP_NUMEQUAL, Op.OP_VERIFY],
-      31: [Op.OP_3, Op.OP_PICK, Op.OP_HASH160, Op.OP_2, Op.OP_ROLL, Op.OP_EQUAL, Op.OP_VERIFY],
-      32: [Op.OP_3, Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_CHECKSIG],
+      28: [Op.OP_2DROP, Op.OP_2DROP, Op.OP_2DROP, Op.OP_1, Op.OP_ELSE],
+      30: [Op.OP_3, Op.OP_ROLL, Op.OP_1, Op.OP_NUMEQUALVERIFY],
+      31: [Op.OP_3, Op.OP_PICK, Op.OP_HASH160, Op.OP_ROT, Op.OP_EQUALVERIFY],
+      32: [Op.OP_2SWAP, Op.OP_CHECKSIG],
       33: [Op.OP_NIP, Op.OP_NIP],
       34: [Op.OP_ENDIF],
     },
     expectedLineToAsmMap: {
       9: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF',
-      13: 'OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY',
+      13: 'OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_ROT OP_CAT <0x88ac> OP_CAT OP_EQUALVERIFY',
       15: '<0xe803>',
       16: 'OP_INPUTINDEX OP_UTXOVALUE',
-      17: 'OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB',
-      21: 'OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF',
-      22: 'OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY',
+      17: 'OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB',
+      21: 'OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF',
+      22: 'OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY',
       23: 'OP_ELSE',
-      24: 'OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY',
-      25: 'OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY',
-      26: 'OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY',
+      24: 'OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY',
+      25: 'OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY',
+      26: 'OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY',
       27: 'OP_ENDIF',
-      28: 'OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE',
-      30: 'OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY',
-      31: 'OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY',
-      32: 'OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG',
+      28: 'OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE',
+      30: 'OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY',
+      31: 'OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY',
+      32: 'OP_2SWAP OP_CHECKSIG',
       33: 'OP_NIP OP_NIP',
       34: 'OP_ENDIF',
     },
     expectedBitAuthScript: `
-                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */
-                                                                                         /*                                                                                                                    */
-                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */
-                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */
-                                                                                         /*  * of covenants in CashScript.                                                                                     */
-                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */
-                                                                                         /*  *\\/                                                                                                               */
-                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */
-OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */
-                                                                                         /*         // require(this.age >= period);                                                                            */
-                                                                                         /*                                                                                                                    */
-                                                                                         /*         // Check that the first output sends to the recipient                                                      */
-OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */
-                                                                                         /*                                                                                                                    */
-<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */
-OP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */
-OP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */
-                                                                                         /*                                                                                                                    */
-                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */
-                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */
-OP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */
-OP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */
-OP_ELSE                                                                                  /*         } else {                                                                                                   */
-OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */
-OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */
-OP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */
-OP_ENDIF                                                                                 /*         }                                                                                                          */
-OP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */
-                                                                                         /*                                                                                                                    */
-OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */
-OP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */
-OP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */
-OP_NIP OP_NIP                                                                            /*     }                                                                                                              */
-OP_ENDIF                                                                                 /* }                                                                                                                  */
+                                                                               /* pragma cashscript >=0.8.0;                                                                                         */
+                                                                               /*                                                                                                                    */
+                                                                               /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */
+                                                                               /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */
+                                                                               /*  * of covenants in CashScript.                                                                                     */
+                                                                               /*  * The time checking has been removed so it can be tested without time requirements.                               */
+                                                                               /*  *\\/                                                                                                               */
+                                                                               /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */
+OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                            /*     function receive() {                                                                                           */
+                                                                               /*         // require(this.age >= period);                                                                            */
+                                                                               /*                                                                                                                    */
+                                                                               /*         // Check that the first output sends to the recipient                                                      */
+OP_0 OP_OUTPUTBYTECODE <0x76a914> OP_ROT OP_CAT <0x88ac> OP_CAT OP_EQUALVERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */
+                                                                               /*                                                                                                                    */
+<0xe803>                                                                       /*         int minerFee = 1000;                                                                                       */
+OP_INPUTINDEX OP_UTXOVALUE                                                     /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */
+OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                 /*         int changeValue = currentValue - pledge - minerFee;                                                        */
+                                                                               /*                                                                                                                    */
+                                                                               /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */
+                                                                               /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */
+OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF               /*         if (changeValue <= pledge + minerFee) {                                                                    */
+OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY                  /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */
+OP_ELSE                                                                        /*         } else {                                                                                                   */
+OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY                             /*             require(tx.outputs[0].value == pledge);                                                                */
+OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY            /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */
+OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY                                  /*             require(tx.outputs[1].value == changeValue);                                                           */
+OP_ENDIF                                                                       /*         }                                                                                                          */
+OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE                                        /*     }                                                                                                              */
+                                                                               /*                                                                                                                    */
+OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY                                            /*     function reclaim(pubkey pk, sig s) {                                                                           */
+OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY                                  /*         require(hash160(pk) == funder);                                                                            */
+OP_2SWAP OP_CHECKSIG                                                           /*         require(checkSig(s, pk));                                                                                  */
+OP_NIP OP_NIP                                                                  /*     }                                                                                                              */
+OP_ENDIF                                                                       /* }                                                                                                                  */
 `.replace(/^\n+/, '').replace(/\n+$/, ''),
   },
   {
@@ -236,58 +236,58 @@ contract HodlVault(
     }
 }
 `.replace(/^\n+/, '').replace(/\n+$/, ''),
-    asmBytecode: 'OP_6 OP_PICK OP_4 OP_SPLIT OP_1 OP_ROLL OP_BIN2NUM OP_1 OP_ROLL OP_BIN2NUM OP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP OP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY OP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG',
-    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;;:26::45:1;16:24:16:32:0;;:20::33:1;19:16:19:27:0;;:31::39;;:16:::1;:8::41;20:27:20:38:0;;:8::40:1;;23:16:23:21:0;;:25::36;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:16::64:1;:8::66;27:25:27:33:0;;:35::42;;:16::43:1',
+    asmBytecode: 'OP_6 OP_PICK OP_4 OP_SPLIT OP_SWAP OP_BIN2NUM OP_SWAP OP_BIN2NUM OP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY OP_CHECKSIG',
+    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:8::66:1;27:16:27:43',
     expectedLineToOpcodeMap: {
       14: [Op.OP_6, Op.OP_PICK, Op.OP_4, Op.OP_SPLIT],
-      15: [Op.OP_1, Op.OP_ROLL, Op.OP_BIN2NUM],
-      16: [Op.OP_1, Op.OP_ROLL, Op.OP_BIN2NUM],
-      19: [Op.OP_1, Op.OP_PICK, Op.OP_5, Op.OP_ROLL, Op.OP_GREATERTHANOREQUAL, Op.OP_VERIFY],
-      20: [Op.OP_1, Op.OP_ROLL, Op.OP_CHECKLOCKTIMEVERIFY, Op.OP_DROP],
-      23: [new Uint8Array([]), Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_GREATERTHANOREQUAL, Op.OP_VERIFY],
-      26: [Op.OP_3, Op.OP_ROLL, Op.OP_4, Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_CHECKDATASIG, Op.OP_VERIFY],
-      27: [Op.OP_1, Op.OP_ROLL, Op.OP_1, Op.OP_ROLL, Op.OP_CHECKSIG],
+      15: [Op.OP_SWAP, Op.OP_BIN2NUM],
+      16: [Op.OP_SWAP, Op.OP_BIN2NUM],
+      19: [Op.OP_OVER, Op.OP_5, Op.OP_ROLL, Op.OP_GREATERTHANOREQUAL, Op.OP_VERIFY],
+      20: [Op.OP_SWAP, Op.OP_CHECKLOCKTIMEVERIFY, Op.OP_DROP],
+      23: [Op.OP_3, Op.OP_ROLL, Op.OP_GREATERTHANOREQUAL, Op.OP_VERIFY],
+      26: [Op.OP_3, Op.OP_ROLL, Op.OP_4, Op.OP_ROLL, Op.OP_3, Op.OP_ROLL, Op.OP_CHECKDATASIGVERIFY],
+      27: [Op.OP_CHECKSIG],
     },
     expectedLineToAsmMap: {
       14: 'OP_6 OP_PICK OP_4 OP_SPLIT',
-      15: 'OP_1 OP_ROLL OP_BIN2NUM',
-      16: 'OP_1 OP_ROLL OP_BIN2NUM',
-      19: 'OP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY',
-      20: 'OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP',
-      23: 'OP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY',
-      26: 'OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY',
-      27: 'OP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG',
+      15: 'OP_SWAP OP_BIN2NUM',
+      16: 'OP_SWAP OP_BIN2NUM',
+      19: 'OP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY',
+      20: 'OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP',
+      23: 'OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY',
+      26: 'OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY',
+      27: 'OP_CHECKSIG',
     },
     expectedBitAuthScript: `
-                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */
-                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */
-                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */
-                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */
-                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */
-                                                                 /* contract HodlVault(                                                                                                    */
-                                                                 /*     pubkey ownerPk,                                                                                                    */
-                                                                 /*     pubkey oraclePk,                                                                                                   */
-                                                                 /*     int minBlock,                                                                                                      */
-                                                                 /*     int priceTarget                                                                                                    */
-                                                                 /* ) {                                                                                                                    */
-                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */
-                                                                 /*         // message: { blockHeight, price }                                                                             */
-OP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */
-OP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */
-OP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */
-                                                                 /*                                                                                                                        */
-                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */
-OP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */
-OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */
-                                                                 /*                                                                                                                        */
-                                                                 /*         // Check that current price is at least priceTarget                                                            */
-OP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */
-                                                                 /*                                                                                                                        */
-                                                                 /*         // Handle necessary signature checks                                                                           */
-OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */
-OP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */
-                                                                 /*     }                                                                                                                  */
-                                                                 /* }                                                                                                                      */
+                                                             /* // This contract forces HODLing until a certain price target has been reached                                          */
+                                                             /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */
+                                                             /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */
+                                                             /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */
+                                                             /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */
+                                                             /* contract HodlVault(                                                                                                    */
+                                                             /*     pubkey ownerPk,                                                                                                    */
+                                                             /*     pubkey oraclePk,                                                                                                   */
+                                                             /*     int minBlock,                                                                                                      */
+                                                             /*     int priceTarget                                                                                                    */
+                                                             /* ) {                                                                                                                    */
+                                                             /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */
+                                                             /*         // message: { blockHeight, price }                                                                             */
+OP_6 OP_PICK OP_4 OP_SPLIT                                   /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */
+OP_SWAP OP_BIN2NUM                                           /*         int blockHeight = int(blockHeightBin);                                                                         */
+OP_SWAP OP_BIN2NUM                                           /*         int price = int(priceBin);                                                                                     */
+                                                             /*                                                                                                                        */
+                                                             /*         // Check that blockHeight is after minBlock and not in the future                                              */
+OP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY         /*         require(blockHeight >= minBlock);                                                                              */
+OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP                       /*         require(tx.time >= blockHeight);                                                                               */
+                                                             /*                                                                                                                        */
+                                                             /*         // Check that current price is at least priceTarget                                                            */
+OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY                 /*         require(price >= priceTarget);                                                                                 */
+                                                             /*                                                                                                                        */
+                                                             /*         // Handle necessary signature checks                                                                           */
+OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */
+OP_CHECKSIG                                                  /*         require(checkSig(ownerSig, ownerPk));                                                                          */
+                                                             /*     }                                                                                                                  */
+                                                             /* }                                                                                                                      */
 `.replace(/^\n+/, '').replace(/\n+$/, ''),
   },
 ];

From babb6f977d7f90fbf43a1f80148a899c1d70eb2c Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 2 May 2025 11:05:10 +0200
Subject: [PATCH 236/267] add updated 'TransferWithTimeout' BitauthIDE example
 to docs

---
 website/docs/guides/debugging.md | 39 ++++++++++++++++----------------
 1 file changed, 20 insertions(+), 19 deletions(-)

diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index 2018d7b1..fda72d5a 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -56,26 +56,27 @@ The Bitauth IDE will show you the two-way mapping between the CashScript contrac
 
 ```js
 // "TransferWithTimeout" contract constructor parameters
-<timeout> // int = <0x07>
-<recipient> // pubkey = <0x0262f5c18adf3d9800c18b5e63fa6505ec8eb1d49c65855d62aea698425a39966e>
-<sender> // pubkey = <0x0262f5c18adf3d9800c18b5e63fa6505ec8eb1d49c65855d62aea698425a39966e>
+<timeout> // int = <0x90d003>
+<recipient> // pubkey = <0x038f55548d7f3d183cebb8ee77036feeb408f4a5030fb486717659bb944fe5eb4c>
+<sender> // pubkey = <0x0218d4166169298d42c1f763e243e4b5bc3df8e11690aa953b17a6e02902625f90>
 
 // bytecode
-                                                /* pragma cashscript >= 0.11.0;                                                  */
-                                                /*                                                                              */
-                                                /* contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) { */
-                                                /*     // Require recipient's signature to match                                */
-OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                    */
-OP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                          */
-OP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                        */
-                                                /*                                                                              */
-                                                /*     // Require timeout time to be reached and sender's signature to match    */
-OP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                        */
-OP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                                */
-OP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                         */
-OP_1 OP_NIP                                     /*     }                                                                        */
-OP_ENDIF                                        /* }                                                                            */
-                                                /*
+                                       /* pragma cashscript ~0.11.0;                                                   */
+                                       /*                                                                              */
+                                       /* contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) { */
+                                       /*     // Require recipient's signature to match                                */
+OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                    */
+OP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                          */
+OP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                        */
+                                       /*                                                                              */
+                                       /*     // Require timeout time to be reached and sender's signature to match    */
+OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                        */
+OP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                                */
+OP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                         */
+OP_2DROP OP_1                          /*     }                                                                        */
+OP_ENDIF                               /* }                                                                            */
+          
 ```
 
-[BitauthIDE]: https://ide.bitauth.com/import-template/eJzVWG1v2zYQ_isCMWBJ4drUG21lbYAmcRsjaZIl6YqhDgyKomItNuVRVJbA8H_fUe9-qeF06Yfxg0WRvLvnjs9RR8_RLwkb8ylFB2is1Cw56HSigLf9SNFUjdssnnZ0hwsVMaqiWLxVfDqbUMXfPuJ2Ltv-K4kFaqGAJ0xGM70K1A2ms1gqHhihjKcGo8k4n4WFgk45rLiVVCQhl18jNb6NpjxO9WSSznJBdPANHR2fjixs2SPsorsWeuQyybTjFtKQVMQTdDBHMypBpYJZ_baM4zgWSlKmDCZ55oFBBYBKBcteGqIVsKWxXFei0Uxi9gAjqdCdUfamQVEZUX-SI5GcRbMIsI2S6H4dzLBecBPdD1Ft3ojDGtQQqSI2Q1TDaorCqHqe6dEz_owWAJOLgMtNFvOZVVtqHCUGK2JT2yjUVNq_0smEqxOqqDZSIdjq2Y6mamXfsaYKTmywVUztaElV5Npopwz7KALfn9bN3WT9eneyZYaKDf7EWap4bWhF00Z70Bqkmi-xKaNykvCMbfyRTlJItFGpVZOtMJQLVeyEkU5niTWbCD4U75boqdNXxFLqvqAqlbwNOEcQqVmqkkMDVMLMUAwF9Fa8j0QVZ1C77HcmGQllvDfe4cOhqFIG3MpzCCJQ-qufkbi_zQM1s5KxbdUB3ejlhnMDHGZVnsciUTJlKpbLzhc0WIL3hLuHzbhkk7PUf-DPxbxFrNBlZo8GoR14PYyh77uc2CElLnY563HfDByPEbfnugGxKKfE6zmWS23PI4Rr_Xla_Rzl2fb4z4qzOOBDYbywdd4YM0nvp7RxRhuH7w3c7rXxby_VZhhvOj-E4VXbD2KoKLSBYXvFvuU72Sq3sSJOK6NUQbF9Y_5f4gD7ec3_TiPJa_2_JkaVpvrsmVLFxrvE4fJqZBvwczU4PtNPrH8uvnzu__7lw7nuDz5uwlDle3mm7IF5o_kJ0k7u0AoMjjZ1fXmembSaL8en_eOzm8GndQy6yTwQe1BpsAewuteE0KoB7e9v4WqB4WJwZaw9-uc3_U0yBYbFLj7u0v7HeZE9ak4WJM-emoq-pimFDQqy0irPkO_ytcnJkgLmKif_6F8PPv65iqHmZJGTmpK5ud35uBXDGidrLNs4WWFoFXC2snEJw7rZ88vjs9vB535hF4ZPri-vmnFoYlBP7Wwf4MQuD5_dD-0mBp0Ou7SfkRc6DS9OVg6i7RhezX6J4aUyr5-bKK8MuYALRZzVhuslIAwWpVG_mFu7eH0QUJhSuKRxo5DXKfPPmOtE1AVy8Y3Pq9e8RNQ1Z1tr0iUq2CjLCd0vbxboNeoVtHSJeC2V1U1BK-yi9ZIeYV1zslRKsHukq8pTHt2PQcJaHtZfe3Rgds1e1_QcDLPwlc_vmDJ6hHCfFa8rFz3EnYAwSrnjmbbj-TYLzSBgVkg8jK0uDT3sU9-1AuZzjwQMRm2XEmb1HOLTrk1Qdi_IPra02upI6EocLgNzpKvyGEqMQe6Q2apGbmuZU6jgAItHHdMnNMDEcmyn1w2xF1oEguoHDrFcn1gcez4Ofdt1Qs58gu3ANonjEerYZtDTFTccL1wwfpFOfb35juXBdBd-y2IeivajiiXfUDKJFbpb3OWVvcrCaGGX2FaOtPRjTXS-0FfoScpvqIoT4Cc4hzFetHZb27U9Z9H8a8DSSRSnkvHLbWZLxGsKe8TrLu5gN_4FON-z9w==
+[BitauthIDE]: https://ide.bitauth.com/import-template/eJzFWAtv2zYQ_isCN2BJ4drUW8raAK3jNkbSJEvcFUMdGBR1stXakidRWYIg--07SrIk23LgDhlGBKEiHu-7x3fUMY_k55TPYMHIEZkJsUyPer3Qh64XCpaJWZfHi558gEiEnIkwjl4LWCznTMDrO9ot9na_pXFEOsSHlCfhUkqhuuFiGScCfCVI4oXCWTorVlEwYgtAiT6-u8nfKR8hgoRJ6RPwsuk0jKbKqATCDWm2LJSRo6_kff90olHNnFCT3HbIHSRpjkg7RJopQkjJ0SMZJSxKA0i-hGI2ChcQZ2ISRstM0MmSJWiBwI1ScN3sfhyJhHGh8ARyhxUWoQ9ZxPM_GlsrP1qQlIMcSvmJHkrzc_2pNL7NqnnMv6NU25JYNzyLclnpNUtC5s0LV1OIfEhuwum2O-N6cUxq65U4qH0akxJmTGqnap0dIh6W8tUZPJCnTrmyG2oTR8zCVOFlWDcBau1f2HwO4oQJJkES4OEyxHy24VSLe0LVynaglf63YVWh2QtppWgHzirkmE8f7rfhymqoMpOLKSJW4B54lpdCCbShqRUPR4N77RXRTjAUXrI0hZ2U3dgGd2yeyVK93YxEWyHgaq_XZF1beY2jNxUF5TkTxUkyScNpxESWQBfdnOBeVJ1O5HMm7uP0WEG9KDOOxhE-bYQxjKqEofL1AOY7w0gob5U36vFYnmZFKNL2-i5q9qm9aFchlDMeZKMiM0stnenas6fGVoRaZDBavDqi4igVScZFnKxHroxs0yt671KfUh2de1PVQy6wzLzv8FDIUN0JTNM0HN8OdF91dA6e5wDYNtWtAMAzqBMYzKQ6DTzDsWzVtkzX81zDCMDEZX5cJW5buaY6vqFalmq5mouPGlcD29JBM3QwPNPjuh84oOIyZcw1dU-1mQVUc6lmaWbg0uMys96DAB77MI6U_UbvlbJM2HTBGh8i5W_aVdUu_XVPHc3xqvcj0C86fgy64koLlQ7K5BTp6qxyVbGjk3On5NKh8vgvvMZcXcOfWZhArfaXVKnqWJ5tCyb4bB-vL68muoK_rob9MzlT-evi86fBb5_fncvn4YcGdFX9ovT8AFFrK_BYkS7tMUpoQyJcX56fF_NITv3TQf_sZvhxw2s5ksLtA-yQ-HcEO2gid2o7Dg-f4V8JfTG8UramwfnNYDvgT_t4tK_Xe4r-vwzPp5pmq--OnCW7PMk8hlnw80au4PpOCjZptsq12qTZ74Pr4Yc_GtA1zcqikiyrvlx7UmwX9M2Xd1dNnpXoz9Gsgu6UVjxLsDXoNbTzy_7ZaPhpUDvcDHgTWtx382Afv63Oiv2P1BJaO7m-vCqCvXP8FwyXdXRxUpwbzwyEfjHYFfSeoi9fXKRoCyHCK0S8b2NYdXgoXjYwg_JV26dFaW3_1pvddxG2tQzveKCU2mUZ_TUDWZOyvS4_00XvW3SHsiftSk2ywUVTVo1AfQtCxS_RaZC1Kwh5ic6INO4ZZNWOke1LAVFlY8mzJEHs97KJPIVwOsNd2vprGWtypNqGhViaa3QIfr7zhC6T8A4zc1b-2bgfEstwLddjhqepaJvuO6pl2hq1uUZdz0HjTUvXLIeCYXsAGmO2a_HA9j3K8YfbJL9V5N9UxotMPpI8yfKy8EhkUx5j3zAsnEGjVm9G9Z5TbMLQFgBuBa5lqrYWcNc3HGrqAQ-Au6aqqtRmjgm6r_nUU33VBWmyjUmjlu5z3fAC2S_jIQQRh4ts4cnkGxgH17LzaBQdPHbg7yuWfCXpPBbk9gkvKnJR5CHUTIqjsHTlx9ZWYlvMVQ1HM1Xug61xmfvA9wPbMTBArmcyZpgOhs-2ASzHYTLjkthww0ScIqMxWdRFpKfmvy00WY1xlnC4fA5-ZXmbSsNxnm4xL_8AUE0PwQ==
+

From 357774905ce086e6fa4f028d6223310c2fd7abd3 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Fri, 2 May 2025 11:46:53 +0200
Subject: [PATCH 237/267] improve getting started & add note to infrastructure
 docs

---
 website/docs/basics/getting-started.md | 36 ++++++++++++++++----------
 website/docs/guides/infrastructure.md  |  4 +++
 2 files changed, 26 insertions(+), 14 deletions(-)

diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 1e18b833..740aafbd 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -6,18 +6,20 @@ title: Getting Started
 
 To get started with writing CashScript smart contracts quickly, it is recommended to try out the [CashScript Playground](https://playground.cashscript.org/), a web application which lets you easily write and create contracts!
 
-The Playground supports 'Mocknet', allowing you to create virtual UTXOs for development without having to get Testnet coins and set up a Testnet wallet.
+The Playground has a code-editor and CashScript compiler easily accesible, without any prerequisites. Further, the playground allows to easily create contracts, wallets and build transactions.
 
 :::tip
-The [CashScript Playground](https://playground.cashscript.org/) is a great way to get started without doing any JavaScript/TypeScript coding to set up wallets, fetch balances and invoke contract functions. This way you can focus on learning just CashScript!
+The [CashScript Playground](https://playground.cashscript.org/) is a great way to get started without doing any JavaScript/TypeScript coding, this way you can focus on learning just CashScript!
 :::
 
+The Playground supports 'Mocknet', this is the recommended way to get started developing. This way you can create virtual UTXOs for testing without having to get Testnet coins and set up a Testnet wallet.
+
 Here are the 5 simple steps for creating your first smart contract transaction with the Playground:
 1. Compile a contract, for example the default `TransferWithTimeout` contract.
 2. Create a new contract in the 'New Contract' tab by providing the contract arguments.
-3. Add UTXOs to the smart contract address and the wallets used for testing.
-4. Next, go to the TransactionBuilder select the contract and the function to invoke
-5. Finally, specify the in- and outputs for the transaction and click 'Send'!
+3. Add mock UTXOs to the smart contract address and the wallets used for testing.
+4. Next, go to the TransactionBuilder select the contract UTXO and the function to invoke on it
+5. Finally, specify the in- and outputs for the transaction and click 'Evaluate'!
 
 ## Creating a CashScript Contract
 
@@ -104,12 +106,16 @@ npm install cashscript
 
 ### Initialising a Contract
 
-Now to initialise a contract we will import the `ElectrumNetworkProvider` and `Contract` classes from the CashScript SDK. We also need to import the contract artifact. Lastly, we need public keys from a generated key-pair to use as arguments for contract initialisation.
+To initialise a contract with the SDK we will need 3 things: the contract artifact, the contract constructor arguments and a NetworkProvider.
+
+To do this, we import the `ElectrumNetworkProvider` and `Contract` classes from the CashScript SDK. We also need to import the contract artifact. Lastly, we need public keys from a generated key-pair to use as contract constructor arguments.
 
 :::tip
 For a code example of how to generate key-pairs with Libauth, see the [CashScript Examples' `common.ts`](https://github.com/CashScript/cashscript/blob/master/examples/common.ts) file where Alice and Bob's key-pairs are created.
 :::
 
+With the instantiated contract, we can now get the contract address and get the contract balance and UTXOs in the following way:
+
 
 ```javascript
 import { ElectrumNetworkProvider, Contract } from 'cashscript';
@@ -129,7 +135,9 @@ console.log("Contract balance: " + await contract.getBalance());
 console.log("Contract UTXOs: " + await contract.getUtxos());
 ```
 
-Next, to spend from the smart contract we've initialised, you need to make sure there is an actual contract balance on the smart contract address. Later you'll learn to use the `MockNetworkProvider` so you can simulate transactions in a 'mock' network environment.
+Next, to spend from the smart contract we've initialised, you would need to make sure there is an actual contract balance on the smart contract address.
+
+To make development easier we'll use the `MockNetworkProvider` instead so you can simulate transactions in a 'mock' network environment.
 
 ### Creating a Transaction
 
@@ -138,27 +146,27 @@ Finally to create a transaction spending from the smart contract UTXO we use the
 To spend from an input you specify the `UTXO` together with an `Unlocker` to actually provide the 'unlock' script matching the input's locking bytecode. For the initialized smart contract the `Unlockers` are available as methods on the `Contract` instance. Below we will invoke the `transfer` function on the contract utxo through `contract.unlock.transfer(...)`.
 
 ```javascript
-import { ElectrumNetworkProvider, Contract, SignatureTemplate, TransactionBuilder } from 'cashscript';
+import { MockNetworkProvider, Contract, SignatureTemplate, TransactionBuilder, randomUtxo } from 'cashscript';
 import { alicePub, bobPriv, bobPub } from './keys.js';
 import artifact from './TransferWithTimeout.json' with { type: 'json' };
 
-// Initialise a network provider for network operations
-const provider = new ElectrumNetworkProvider('chipnet');
+// Initialise a mocknetwork provider for easy testing
+const provider = new MockNetworkProvider();
 
 // Instantiate a new TransferWithTimeout contract
 const contractArguments = [alicePub, bobPub, 100000n];
 const contract = new Contract(artifact, contractArguments, {provider});
 
-// Specify the contract UTXO
-const contractUtxos = await contract.getUtxos();
-const selectedContractUtxo = contractUtxos[0]
+// Create a mocknet UTXO for testing
+const contractMockUtxo = randomUtxo()
+provider.addUtxo(contract.address, contractMockUtxo);
 
 // Create the signatureTemplate for bob to sign the contract input
 const bobSignatureTemplate = new SignatureTemplate(bobPriv)
 
 // Start building the transaction
 const transferDetails = await new TransactionBuilder({ provider })
-  .addInput(selectedContractUtxo, contract.unlock.transfer(bobSignatureTemplate))
+  .addInput(contractMockUtxo, contract.unlock.transfer(bobSignatureTemplate))
   .addOutput({
     to: 'bitcoincash:qrhea03074073ff3zv9whh0nggxc7k03ssh8jv9mkx',
     amount: 10000n
diff --git a/website/docs/guides/infrastructure.md b/website/docs/guides/infrastructure.md
index 16da93f4..208f83b6 100644
--- a/website/docs/guides/infrastructure.md
+++ b/website/docs/guides/infrastructure.md
@@ -32,6 +32,10 @@ Different applications like Tapswap and Cauldron have also started posting the `
 To store contract details on-chain, start the `OP_RETURN` data with an easily recognizable identifier, this way you can find all your smart contract UTXOs by checking the transactions including that identifier in the `OP_RETURN`.
 :::
 
+:::note
+The maximum `OP_RETURN` data size is 220 bytes which might be limiting for contracts with many large `constructor` arguments. You can read more about the transaction limits [here](/docs/compiler/script-limits).
+:::
+
 ## Transaction server
 
 When your smart contracts depend on "automatic settlement" or any events where transactions are invoked without the user being involved, you will need a transaction server to create and broadcast those transactions. Smart contracts on BCH are never self-executing, someone is always needed to invoke functionality on a smart contract by creating a transaction.

From 14a0a5b40ac9236d7748bb2b7c08dd134d88b8d6 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Sat, 3 May 2025 10:03:53 +0200
Subject: [PATCH 238/267] improve docs

---
 website/docs/compiler/compiler.md       |  5 ++++
 website/docs/compiler/script-limits.md  | 36 ++++++++++++++-----------
 website/docs/guides/infrastructure.md   |  2 +-
 website/docs/sdk/instantiation.md       | 17 ++++++------
 website/docs/sdk/signature-templates.md | 33 ++++++++++++++---------
 5 files changed, 56 insertions(+), 37 deletions(-)

diff --git a/website/docs/compiler/compiler.md b/website/docs/compiler/compiler.md
index ee3baac8..24079b5c 100644
--- a/website/docs/compiler/compiler.md
+++ b/website/docs/compiler/compiler.md
@@ -37,6 +37,11 @@ Options:
 To have the best TypeScript integration, we recommend generating the artifact in the `.ts` format and importing it into your TypeScript project from that `.ts` file.
 :::
 
+#### Example
+```bash
+cashc ./Contract.cash --output ./artifact.ts --format ts
+```
+
 ## JavaScript Compilation
 Generally CashScript contracts are compiled to an Artifact JSON file using the CLI compiler. As an alternative to this, CashScript contracts can be compiled from within JavaScript apps using the `cashc` package. This package exports two compilation functions.
 
diff --git a/website/docs/compiler/script-limits.md b/website/docs/compiler/script-limits.md
index c83c6718..414e5fea 100644
--- a/website/docs/compiler/script-limits.md
+++ b/website/docs/compiler/script-limits.md
@@ -3,16 +3,19 @@ title: BCH Script & Transaction Limits
 sidebar_label: Script & Transaction Limits
 ---
 
-Bitcoin Cash imposes various constraints on scripts and transactions to ensure efficient contract execution and network stability. We'll categorize these limits into two types:
+Bitcoin Cash imposes various constraints on scripts and transactions to ensure efficient contract execution and network stability. We'll categorize these limits into 2 types: 'Contract-related limits' and 'General transaction limits'.
 
-1. Contract-related limits
-2. General transaction limits
+:::note
+Some of the limits below are hard BCH consensus rules, others are standardness relay rules which are still present significant practical barriers. These relay rules however are only enforced on network propagation. You can read more about the [BCH standarness rules here][standard-outputs-docs].
+:::
 
 ## Contract-related limits
 
 ### Maximum contract size
 
-The Bitcoin Cash VM limits contract bytecode to **1,650 bytes**. While typical contracts stay well below this, complex contracts with extensive logic might need adjustments to fit within this constraint.
+The Bitcoin Cash limits contract bytecode to **1,650 bytes** in the standardness rules. Transactions with contract bytecode won't be relayed by most nodes.
+
+While typical contracts stay well below this, complex contracts with extensive logic might need adjustments to fit within this constraint.
 
 #### Modular contract design
 
@@ -48,15 +51,15 @@ function maxOperationCost(unlockingBytecodeLength) {
 
 ## General transaction limits
 
-In addition to contract-related limits, Bitcoin Cash also enforces general transaction limits, which are network-level policies.
+In addition to contract-related limits, Bitcoin Cash also enforces general transaction limits.
 
 ### Maximum transaction size
 
-Bitcoin Cash transactions must not exceed 100,000 bytes to be considered standard. Transactions above this size may not be relayed by most nodes.
+Bitcoin Cash transactions must not exceed 100,000 bytes (100KB) to be considered standard. Transactions above this size won't be relayed by most nodes. The consensus limit for the maximum transaction size is 1MB.
 
 ### Data output size limit
 
-Bitcoin Cash allows multiple OP_RETURN outputs, but the total size of all data outputs in a transaction must not exceed 220 bytes of data payload (223 bytes total).
+Bitcoin Cash allows multiple OP_RETURN outputs, but the total size of all data outputs in a transaction must not exceed 220 bytes of data payload (223 bytes total). Transactions with larger data outputs won't be relayed by most nodes. You can read more about the [BCH standarness rules here][standard-outputs-docs].
 
 ### Dust threshold
 
@@ -88,16 +91,17 @@ The `lockingbytecode` standardness rules can be important for smart contract dev
 
 | Limit type | Constraint |
 |------------|-------------|
-| Max contract size | 1,650 bytes |
-| NFT commitment length | 40 bytes |
-| Operation cost limit | Based on script length |
-| Max stack element size | 10,000 bytes |
-| Max transaction size | 100,000 bytes |
-| Max OP_RETURN data size | 220 bytes data payload |
-| Dust threshold | based on output size (commonly 1,000 sats is used as dust) |
+| Max contract size | 1,650 bytes (standardness) |
+| NFT commitment length | 40 bytes (consensus) |
+| Operation cost limit | Based on script length (consensus) |
+| Max stack element size | 10,000 bytes (consensus) |
+| Max transaction size | 100,000 bytes for standardness (1MB for consensus) |
+| Max OP_RETURN data size | 220 bytes data payload  (standardness) |
+| Dust threshold | based on output size (standardness) - commonly 1,000 sats is used as dust |
 | Output Standardness | `P2PKH`, `P2SH` (incl. `P2SH20` & `P2SH32`), `P2MS` and `OP_RETURN` data-outputs|
 
-For further details on transaction validation and standardness rules, see the [documentation on BCH transaction validation](https://documentation.cash/protocol/blockchain/transaction-validation.html).
+For further details on transaction validation and standardness rules, see the [documentation on BCH transaction validation][standard-outputs-docs].
 
 [op-cost-table]: https://github.com/bitjson/bch-vm-limits/blob/master/operation-costs.md
-[standard-outputs-docs]: https://documentation.cash/protocol/blockchain/transaction/locking-script.html
+[standardness-docs]: https://documentation.cash/protocol/blockchain/transaction-validation/network-level-validation-rules#standard-transactions.html
+[standard-outputs-docs]: https://documentation.cash/protocol/blockchain/transaction/locking-script.html
\ No newline at end of file
diff --git a/website/docs/guides/infrastructure.md b/website/docs/guides/infrastructure.md
index 208f83b6..534a27db 100644
--- a/website/docs/guides/infrastructure.md
+++ b/website/docs/guides/infrastructure.md
@@ -33,7 +33,7 @@ To store contract details on-chain, start the `OP_RETURN` data with an easily re
 :::
 
 :::note
-The maximum `OP_RETURN` data size is 220 bytes which might be limiting for contracts with many large `constructor` arguments. You can read more about the transaction limits [here](/docs/compiler/script-limits).
+The `OP_RETURN` data has a maximum standardness size of 220 bytes which might be limiting for contracts with many large `constructor` arguments. You can read more about the transaction limits [here](/docs/compiler/script-limits).
 :::
 
 ## Transaction server
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index 06c3c57f..e7db99ac 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -84,16 +84,16 @@ A contract's token-supporting address can be retrieved through the `tokenAddress
 console.log(contract.tokenAddress)
 ```
 
-### opcount
+### bytecode
 ```ts
-contract.opcount: number
+contract.bytecode: string
 ```
 
-The number of opcodes in the contract's bytecode can be retrieved through the `opcount` member field.
+Returns the contract's redeem script encoded as a hex string.
 
 #### Example
 ```ts
-console.log(contract.opcount)
+console.log(contract.bytecode)
 ```
 
 ### bytesize
@@ -109,19 +109,20 @@ The size outputs of the `cashc` compiler are based on the bytecode without const
 
 #### Example
 ```ts
+// make sure the contract bytesize is within standarness limits
 assert(contract.bytesize <= 1650)
 ```
 
-### bytecode
+### opcount
 ```ts
-contract.bytecode: string
+contract.opcount: number
 ```
 
-Returns the contract's redeem script encoded as a hex string.
+The number of opcodes in the contract's bytecode can be retrieved through the `opcount` member field.
 
 #### Example
 ```ts
-console.log(contract.bytecode)
+console.log(contract.opcount)
 ```
 
 ## Contract Methods
diff --git a/website/docs/sdk/signature-templates.md b/website/docs/sdk/signature-templates.md
index 090a400e..88d906d5 100644
--- a/website/docs/sdk/signature-templates.md
+++ b/website/docs/sdk/signature-templates.md
@@ -3,7 +3,11 @@ title: Signature Templates
 ---
 
 When a contract function has a `sig` parameter, it needs a cryptographic signature from a private key for the spending transaction. 
-In place of a signature, a `SignatureTemplate` can be passed, which will automatically generate the correct signature once the transaction is built.
+In place of a signature, a `SignatureTemplate` can be passed, which will generate the correct signature when the transaction is built.
+
+:::tip
+`SignatureTemplate` can be used with a `Contract` as function argument to generate a signature automatically, or can be used in the `TransactionBuilder` to create an `Unlocker` for a P2PKH UTXO.
+:::
 
 ## SignatureTemplate
 
@@ -17,7 +21,7 @@ new SignatureTemplate(
 )
 ```
 
-In place of a signature, a `SignatureTemplate` can be passed, which will automatically generate the correct signature using the `signer` parameter. This signer can be any representation of a private key, including [WIF strings][wif], [BCHJS' `ECPair`][ecpair], [bitcore-lib-cash' `PrivateKey`][privatekey], or binary private keys represented as `Uint8Array`. This ensures that `SignatureTemplate` can be used with any BCH library.
+In place of a signature, a `SignatureTemplate` can be passed, which will generate the correct signature using the `signer` parameter. This signer can be any representation of a private key, including [WIF strings][wif], [BCHJS' `ECPair`][ecpair], [bitcore-lib-cash' `PrivateKey`][privatekey], or binary private keys represented as `Uint8Array`. This ensures that `SignatureTemplate` can be used with any BCH library.
 
 #### Example
 ```ts
@@ -37,32 +41,37 @@ The `hashtype` and `signatureAlgorithm` options are covered under ['Advanced Usa
 
 ## SignatureTemplate Methods
 
-### getPublicKey()
+### unlockP2PKH()
+
+Importantly the `SignatureTemplate` can also be used to generate the `Unlocker` for a P2PKH UTXO in the following way:
+
 ```ts
-signatureTemplate.getPublicKey(): Uint8Array
+signatureTemplate.unlockP2PKH(): Unlocker
 ```
 
 #### Example
 ```ts
-import { aliceTemplate } from './somewhere.js';
+import { aliceTemplate, aliceAddress, transactionBuilder } from './somewhere.js';
 
-const alicePublicKey = aliceTemplate.getPublicKey()
+const aliceUtxos = await provider.getUtxos(aliceAddress);
+transactionBuilder.addInput(aliceUtxos[0], aliceTemplate.unlockP2PKH());
 ```
 
-### unlockP2PKH()
+### getPublicKey()
+
+The `SignatureTemplate` also had a helper method to get the matching PublicKey in the following way:
+
 ```ts
-signatureTemplate.unlockP2PKH(): Unlocker
+signatureTemplate.getPublicKey(): Uint8Array
 ```
 
 #### Example
 ```ts
-import { aliceTemplate, aliceAddress, transactionBuilder } from './somewhere.js';
+import { aliceTemplate } from './somewhere.js';
 
-const aliceUtxos = await provider.getUtxos(aliceAddress);
-transactionBuilder.addInput(aliceUtxos[0], aliceTemplate.unlockP2PKH());
+const alicePublicKey = aliceTemplate.getPublicKey()
 ```
 
-
 ## Advanced Usage
 
 ### HashType

From 853fa535ebaaed9fcc98b50a803c28164ceabbdb Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Sat, 3 May 2025 11:07:52 +0200
Subject: [PATCH 239/267] add to cashscript showcase

---
 website/docs/showcase.md        |  36 ++++++++++++++++++++++++--------
 website/static/img/bch-pump.jpg | Bin 0 -> 243161 bytes
 website/static/img/paytaca.png  | Bin 0 -> 53294 bytes
 3 files changed, 27 insertions(+), 9 deletions(-)
 create mode 100644 website/static/img/bch-pump.jpg
 create mode 100644 website/static/img/paytaca.png

diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index b061a7ee..131e1193 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -60,14 +60,6 @@ BCH Guru is a non-custodial price-prediction platform and a collectible NFT proj
 
 The CashTokens Studio is an application for creating CashTokens and for their managing metadata updates and reserved supply. The CashTokens Studio uses CashScript to lock the AuthUTXO in an AuthGuard contract to prevent accidentally spending the authority to be able to update the token's metadata or release reserved supply.
 
-## Badgers.cash
-
-<div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
-    <a href="https://badgers.cash/" target="_blank"><img style={{borderRadius: '100%'}} src="/img/badgers.png" /></a>
-</div>
-
-BadgerCoin is a fungible CashToken using a novel distribution mechanism. BadgerCoins are earned through staking Bitcoin Cash in the Badgers Smart Contract. The staking duration is predetermined, and depending on the stake amount and period you earn tokens. The website allows for anyone to invoke contract unlocks.
-
 ## FundMe.cash
 
 <div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
@@ -78,6 +70,14 @@ BadgerCoin is a fungible CashToken using a novel distribution mechanism. BadgerC
 
 FundMe is a new BCH crowdfunding platform using WalletConnect. Fundme campaigns have revocable and refundable pledges through the use of CashTokens receipts. By using receipts, Fundme does not have a maximum limit on the number of participants in a campaign.
 
+## Badgers.cash
+
+<div style={{textAlign: 'center', width: '35%', margin: 'auto', marginBottom: '20px'}}>
+    <a href="https://badgers.cash/" target="_blank"><img style={{borderRadius: '100%'}} src="/img/badgers.png" /></a>
+</div>
+
+BadgerCoin is a fungible CashToken using a novel distribution mechanism. BadgerCoins are earned through staking Bitcoin Cash in the Badgers Smart Contract. The staking duration is predetermined, and depending on the stake amount and period you earn tokens. The website allows for anyone to invoke contract unlocks.
+
 ## Zapit P2P Exchange
 
 <div style={{textAlign: 'center', width: '50%', margin: 'auto', marginBottom: '20px'}}>
@@ -86,7 +86,25 @@ FundMe is a new BCH crowdfunding platform using WalletConnect. Fundme campaigns
     </a>
 </div>
 
-The Zapit wallet has a built-in P2P Exchange which allows user to buy or sell Bitcoin Cash directly without a custodial middleman. The P2P exchange works with an escrow smart contract which is written in CashScript. The P2P exchange contract has already processed hundreds of BCH in volume.
+The Zapit wallet has a built-in P2P Exchange which allows user to buy or sell Bitcoin Cash directly without a custodial middleman. The P2P exchange works with an escrow smart contract written in CashScript. The P2P exchange contract has already processed hundreds of BCH in volume.
+
+## Paytaca P2P Exchange
+
+<div style={{textAlign: 'center', width: '50%', margin: 'auto', marginBottom: '20px'}}>
+    <a href="https://www.paytaca.com/" target="_blank">
+        <img src="/img/paytaca.png" style={{width: '100%', margin: "50px 0"}} />
+    </a>
+</div>
+
+The Paytaca wallet has a built-in P2P Exchange which allows user to buy or sell Bitcoin Cash with fiat currency directly without a custodial middleman. The P2P exchange works with an escrow smart contract written in CashScript.
+
+## BCH PUMP
+
+<div style={{textAlign: 'center', width: '40%', margin: 'auto', marginBottom: '20px'}}>
+    <a href="https://bchpump.cash/" target="_blank"><img src="/img/bch-pump.jpg" /></a>
+</div>
+
+BCH Pump is a CashTokens Launchpad inspired by the 'pump.fun' mechanism to bootstrap tokens on a bonding curve. The pools are migrated to Cauldron DEX once the bonding process is completed. The BCH Pump contracts are written with CashScript and use a multi-contract and multisetp-setup in its design.
 
 ## Unspent Phi
 
diff --git a/website/static/img/bch-pump.jpg b/website/static/img/bch-pump.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..7965da3baf116a7c8efc196937a909b06e804254
GIT binary patch
literal 243161
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%0Avt`=^A)5M5!x5vRv
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%0D-Ei;~EO)H2U++R@{<<9_71E
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%0AmcKy|;2&u*P1lnzm`Y#r9w|5T~
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

literal 0
HcmV?d00001

diff --git a/website/static/img/paytaca.png b/website/static/img/paytaca.png
new file mode 100644
index 0000000000000000000000000000000000000000..088a8296badfa783870664727851a79356de21e2
GIT binary patch
literal 53294
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%0D;
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
ReMbTQNj;Vq%NNmo`F{)V`^EqO

literal 0
HcmV?d00001


From d09fcf7a491168b4af1592128b79fcca6a837f48 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 7 May 2025 10:55:07 +0200
Subject: [PATCH 240/267] small additions & fixes to docs

---
 website/docs/compiler/script-limits.md | 18 ++++++++++++------
 website/docs/language/examples.md      |  4 +++-
 website/docs/language/globals.md       |  2 +-
 3 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/website/docs/compiler/script-limits.md b/website/docs/compiler/script-limits.md
index 414e5fea..353a3c28 100644
--- a/website/docs/compiler/script-limits.md
+++ b/website/docs/compiler/script-limits.md
@@ -6,7 +6,7 @@ sidebar_label: Script & Transaction Limits
 Bitcoin Cash imposes various constraints on scripts and transactions to ensure efficient contract execution and network stability. We'll categorize these limits into 2 types: 'Contract-related limits' and 'General transaction limits'.
 
 :::note
-Some of the limits below are hard BCH consensus rules, others are standardness relay rules which are still present significant practical barriers. These relay rules however are only enforced on network propagation. You can read more about the [BCH standarness rules here][standard-outputs-docs].
+Some of the limits below are hard BCH consensus rules, others are standardness relay rules which are still present significant practical barriers. These relay rules however are only enforced on network propagation. You can read more about the [BCH standardness rules here][standardness-docs].
 :::
 
 ## Contract-related limits
@@ -59,11 +59,11 @@ Bitcoin Cash transactions must not exceed 100,000 bytes (100KB) to be considered
 
 ### Data output size limit
 
-Bitcoin Cash allows multiple OP_RETURN outputs, but the total size of all data outputs in a transaction must not exceed 220 bytes of data payload (223 bytes total). Transactions with larger data outputs won't be relayed by most nodes. You can read more about the [BCH standarness rules here][standard-outputs-docs].
+Bitcoin Cash allows multiple OP_RETURN outputs, but the total size of all data outputs in a transaction must not exceed 220 bytes of data payload (223 bytes total). Transactions with larger data outputs won't be relayed by most nodes. You can read more about the [BCH standardness rules here][standard-outputs-docs].
 
 ### Dust threshold
 
-Bitcoin Cash defines a "dust" threshold for output value. Outputs below this threshold are considered dust and will not be relayed by standard nodes.
+Bitcoin Cash defines a "dust" threshold for output value. Outputs below this threshold are considered dust and will not be relayed by standard nodes. Provably unspendable outputs (OP_RETURN outputs) are exempt from this rule.
 
 The dust threshold is calculated as:
 
@@ -75,7 +75,12 @@ function calculateDust(outputSize: number): number {
 ```
 
 Before CashTokens `546` bytes was often used as good default value, however with tokenData outputs have become larger in size.
-For ease of development, it is standard practice to use 1,000 satoshis as dust to outputs. Provably unspendable outputs (OP_RETURN outputs) are exempt from this rule.
+For ease of development, it is standard practice to use 1,000 satoshis as dust to outputs. 
+
+:::note
+The standard practice of 1,000 satoshis as dust amount for outputs is only considering `P2PH`, `P2SH` and `P2PK` output types.
+For `P2MS` (raw multisig) a higher dust limits may be required, you can [find more info here][info-dust-limit]
+:::
 
 ### Output Standardness
 
@@ -100,8 +105,9 @@ The `lockingbytecode` standardness rules can be important for smart contract dev
 | Dust threshold | based on output size (standardness) - commonly 1,000 sats is used as dust |
 | Output Standardness | `P2PKH`, `P2SH` (incl. `P2SH20` & `P2SH32`), `P2MS` and `OP_RETURN` data-outputs|
 
-For further details on transaction validation and standardness rules, see the [documentation on BCH transaction validation][standard-outputs-docs].
+For further details on transaction validation and standardness rules, see the [documentation on BCH transaction validation][standardness-docs].
 
 [op-cost-table]: https://github.com/bitjson/bch-vm-limits/blob/master/operation-costs.md
 [standardness-docs]: https://documentation.cash/protocol/blockchain/transaction-validation/network-level-validation-rules#standard-transactions.html
-[standard-outputs-docs]: https://documentation.cash/protocol/blockchain/transaction/locking-script.html
\ No newline at end of file
+[standard-outputs-docs]: https://documentation.cash/protocol/blockchain/transaction/locking-script.html
+[info-dust-limit]: https://bitcoincashresearch.org/t/friday-night-challenge-worst-case-dust/1181/2
\ No newline at end of file
diff --git a/website/docs/language/examples.md b/website/docs/language/examples.md
index a007754c..a84c1391 100644
--- a/website/docs/language/examples.md
+++ b/website/docs/language/examples.md
@@ -92,7 +92,7 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge, int period) {
 
 AMM DEX contract based on [the Cauldron DEX contract](https://www.cauldron.quest/_files/ugd/ae85be_b1dc04d2b6b94ab5a200e3d8cd197aa3.pdf), you can read more details about the contract design there.
 
-Compared to the manually written and hand-optimized opcodes version of the contract, the CashScript compiled bytecode has just 5 extra opcodes overhead (7 extra bytes).
+The CashScript contract code has the big advantage of abstracting away any stack management, having variable names, explicit types and a logical order of operations (compared to the 'reverse Polish notation' of raw script).
 
 ```solidity
 pragma cashscript ^0.11.0;
@@ -135,4 +135,6 @@ contract DexContract(bytes20 poolOwnerPkh) {
 }
 ```
 
+Compared to the manually written and hand-optimized opcodes version of the contract, the CashScript compiled bytecode has just 5 extra opcodes overhead (7 extra bytes). Furthermore, even contracts with hand-optimized bytecode can still be used with the CashScript SDK, [find out more in the optimization guide][/docs/guides/optimization#hand-optimizing-bytecode].
+
 More advanced examples on covenants, using NFTs to keep local state and issuing NFTs as receipts can be found in the [Covenants & Introspection Guide](/docs/guides/covenants).
diff --git a/website/docs/language/globals.md b/website/docs/language/globals.md
index 62365591..d979dbb0 100644
--- a/website/docs/language/globals.md
+++ b/website/docs/language/globals.md
@@ -282,6 +282,6 @@ require(1 weeks == 7 days);
 
 [bip68]: https://github.com/bitcoin/bips/blob/master/bip-0068.mediawiki
 [addInput()]: /docs/sdk/transaction-builder#addinput
-[setLocktime()]: docs/sdk/transaction-builder#setlocktime
+[setLocktime()]: /docs/sdk/transaction-builder#setlocktime
 [covenants-guide]: /docs/guides/covenants
 [tx.time]: #txtime

From 1450ec9868debe5134761de9f8087f272762f996 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 7 May 2025 10:55:27 +0200
Subject: [PATCH 241/267] add to the getting started docs

---
 website/docs/basics/getting-started.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 740aafbd..657a54b7 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -48,11 +48,9 @@ npm install -g cashc
 
 ### Writing your first contract
 
-Open your code editor to start writing your first CashScript smart contract.
-We can start from a basic `TransferWithTimeout` smart contract. Create a new file `TransferWithTimeout.cash`.
-
-The `TransferWithTimeout` contract takes in 3 contract arguments and has 2 contract functions: `transfer` and `timeout`.
+We can start from a basic `TransferWithTimeout` smart contract, a simple contract for tips which allows the recipient to claim their gift at any time, but if they don't claim within some time, the sender can reclaim it.
 
+Open your code editor to start writing your first CashScript smart contract. Then create a new file `TransferWithTimeout.cash` and copy over the smart contracts code from below.
 ```solidity
 pragma cashscript ^0.11.0;
 
@@ -70,6 +68,11 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 }
 ```
 
+Let's take some time to understand the contract structure.
+At the top, the smart contract declares the CashScript language version it's using with `pragma`.
+Then a `TransferWithTimeout` is declare which takes in 3 contract arguments and has 2 contract functions: `transfer` and `timeout`.
+These contract functions both have `require` statements necessary to be met to be able to spend BCH from the contract.
+
 :::tip
 There are some other examples available on the [Examples page](/docs/language/examples) that can be used to take inspiration from. Further examples of the TypeScript and JavaScript integration can be found on [GitHub](https://github.com/CashScript/cashscript/tree/master/examples).
 :::

From 9ff89cf4c01cf69baeb8cfd36952d37847cb3b74 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 8 May 2025 12:04:44 +0200
Subject: [PATCH 242/267] add info about constructor & function arguments to
 docs

---
 website/docs/language/contracts.md | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index addc554c..a39b62ee 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -29,13 +29,16 @@ contract HTLC(pubkey sender, pubkey recipient, int expiration, bytes32 hash) {
 }
 ```
 
+### Constructor Arguments
+
+The constructor arguments are provided when initializing a specific instance of a smart contract. The provided constructor arguments are added to the start of the contract's script before the opcode logic. Because the constructor arguments are part of the full smart contract script, they are conceptually similar to hard-coded constants in your contract logic. Constructor arguments are a way to create 'global constants' accesible from different functions inside your contract.
+
 :::info
 The typings for the constructor arguments are only semantic and used when initilaizing the contract with the SDK. This means when not using the SDK you could still pass a different byte length item to `bytes32 hash`.
 :::
 
-
 :::note
-Upon initialization of the contract, constructor parameters are encoded and added to the contract's bytecode in the reversed order of their declaration. This can be important when manually constructing the contract locking script for debugging purposes.
+Upon initialization of the contract, constructor parameters are encoded and added to the contract's bytecode in the reversed order of their declaration. This can be important when manually constructing the contract locking script for debugging or optimization purposes.
 :::
 
 ## Functions
@@ -56,12 +59,18 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 }
 ```
 
+### Function Arguments
+
+The function arguments are provided when attempting to spend from the contract. This means that these arguments can be crafted in a specific way by anyone to see if they can exploit the contract logic. Because of this it is important to realize these are 'untrusted arguments'. 
+
+In CashScript the types for the function arguments are **not** enforced automatically at the contract level. This can be especially relevant for types like `bool`, `bytesX` and other semantic bytes types. Instead this type information is only used by the SDK to check whether these arguments match the expected type during transaction building.
+
 :::caution
 The typings for the function arguments are only semantic, this means the length of bounded bytes types like `bytes20` are **not** contract enforced automatically. Instead add an explicit length check `require(item.length == 20)`.
 :::
 
 :::note
-Function parameters are passed in the reversed order of their declaration. This can be important when debugging or when creating transactions manually.
+Function parameters are passed in the reversed order of their declaration. This can be important when debugging, optimizing or when creating transactions manually.
 :::
 
 ## Statements

From 1159cfa59bfb39cc6ab776289e273fd1b0d39ba8 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 8 May 2025 13:20:41 +0200
Subject: [PATCH 243/267] remove dockerfile

---
 Dockerfile | 30 ------------------------------
 1 file changed, 30 deletions(-)
 delete mode 100644 Dockerfile

diff --git a/Dockerfile b/Dockerfile
deleted file mode 100644
index 08352cb2..00000000
--- a/Dockerfile
+++ /dev/null
@@ -1,30 +0,0 @@
-# BUILD IMAGE
-FROM node:10 as build
-
-WORKDIR /app
-
-# Invalidate cache
-ADD "http://worldtimeapi.org/api/timezone/Europe/Amsterdam.txt" skipCache
-
-# Add app
-COPY website /app
-RUN yarn
-
-# Remove potentially cached Docusaurus files
-RUN rm -rf /app/.docusaurus
-RUN rm -rf /app/build
-
-# Generate build
-RUN yarn build
-
-# ###############################################################################
-
-# PROD IMAGE
-FROM nginx:1.17.0-alpine
-
-# Invalidate cache
-ADD "http://worldtimeapi.org/api/timezone/Europe/Amsterdam.txt" skipCache
-
-# Copy build artifacts from the 'build environment'
-RUN rm -rf /usr/share/nginx/html/**
-COPY --from=build /app/build /usr/share/nginx/html

From 85c66a3b2f9f83edb989d8ad40e58c4bd288f79f Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 21 May 2025 10:23:25 +0200
Subject: [PATCH 244/267] Update fixture artifacts after sourcemap changes

---
 .../cashscript/test/fixture/Bar.artifact.ts   | 18 +++++++--------
 packages/cashscript/test/fixture/Bar.json     | 18 +++++++--------
 .../cashscript/test/fixture/Foo.artifact.ts   | 12 +++++-----
 packages/cashscript/test/fixture/Foo.json     | 12 +++++-----
 .../test/fixture/announcement.artifact.ts     | 16 +++++++-------
 .../cashscript/test/fixture/announcement.json | 16 +++++++-------
 .../test/fixture/bigint.artifact.ts           | 12 +++++-----
 packages/cashscript/test/fixture/bigint.json  | 12 +++++-----
 .../test/fixture/bounded_bytes.artifact.ts    | 10 ++++-----
 .../test/fixture/bounded_bytes.json           | 10 ++++-----
 .../test/fixture/hodl_vault.artifact.ts       | 18 +++++++--------
 .../cashscript/test/fixture/hodl_vault.json   | 18 +++++++--------
 .../test/fixture/mecenas.artifact.ts          | 22 +++++++++----------
 packages/cashscript/test/fixture/mecenas.json | 22 +++++++++----------
 .../test/fixture/p2palindrome.artifact.ts     | 10 ++++-----
 .../cashscript/test/fixture/p2palindrome.json | 10 ++++-----
 .../cashscript/test/fixture/p2pkh.artifact.ts | 12 +++++-----
 packages/cashscript/test/fixture/p2pkh.json   | 12 +++++-----
 .../token_category_comparison.artifact.ts     |  4 ++--
 .../fixture/token_category_comparison.json    |  4 ++--
 .../fixture/transfer_with_timeout.artifact.ts | 14 ++++++------
 .../test/fixture/transfer_with_timeout.json   | 14 ++++++------
 22 files changed, 148 insertions(+), 148 deletions(-)

diff --git a/packages/cashscript/test/fixture/Bar.artifact.ts b/packages/cashscript/test/fixture/Bar.artifact.ts
index 0b7cfeec..2a832ac7 100644
--- a/packages/cashscript/test/fixture/Bar.artifact.ts
+++ b/packages/cashscript/test/fixture/Bar.artifact.ts
@@ -32,11 +32,11 @@ export default {
   bytecode: 'OP_OVER OP_0 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_OVER OP_1 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_SWAP OP_2 OP_NUMEQUALVERIFY OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG OP_ENDIF OP_ENDIF',
   source: 'pragma cashscript >=0.10.2;\n\ncontract Bar(bytes20 pkh_bar) {\n    function funcA() {\n        require(2==2);\n    }\n\n    function funcB() {\n        require(2==2);\n    }\n\n    function execute(pubkey pk, sig s) {\n        console.log(\'Bar \'execute\' function called.\');\n        require(hash160(pk) == pkh_bar);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
-    bytecode: '5179009c6352529c7777675179519c6352529c777767517a529c695179a9517a8769517a517aac6868',
-    sourceMap: '4:4:6:5;;;;;5:16:5:17;:19::20;:16:::1;4:4:6:5;;;8::10::0;;;;;9:16:9:17;:19::20;:16:::1;8:4:10:5;;;12::16::0;;;;;14:24:14:26;;:16::27:1;:31::38:0;;:16:::1;:8::40;15:25:15:26:0;;:28::30;;:16::31:1;3:0:17:1;',
+    bytecode: '78009c6352529c77776778519c6352529c7777677c529d78a988ac6868',
+    sourceMap: '4:4:6:5;;;;5:16:5:17;:19::20;:16:::1;4:4:6:5;;;8::10::0;;;;9:16:9:17;:19::20;:16:::1;8:4:10:5;;;12::16::0;;;14:24:14:26;:16::27:1;:8::40;15:16:15:31;3:0:17:1;',
     logs: [
       {
-        ip: 28,
+        ip: 24,
         line: 13,
         data: [
           'Bar \'execute\' function called.',
@@ -45,26 +45,26 @@ export default {
     ],
     requires: [
       {
-        ip: 9,
+        ip: 8,
         line: 5,
       },
       {
-        ip: 20,
+        ip: 18,
         line: 9,
       },
       {
-        ip: 34,
+        ip: 26,
         line: 14,
       },
       {
-        ip: 40,
+        ip: 28,
         line: 15,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.0',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2025-02-18T09:30:48.653Z',
+  updatedAt: '2025-05-11T10:02:25.811Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/Bar.json b/packages/cashscript/test/fixture/Bar.json
index 67db2a67..9240be6f 100644
--- a/packages/cashscript/test/fixture/Bar.json
+++ b/packages/cashscript/test/fixture/Bar.json
@@ -32,11 +32,11 @@
   "bytecode": "OP_OVER OP_0 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_OVER OP_1 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_SWAP OP_2 OP_NUMEQUALVERIFY OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG OP_ENDIF OP_ENDIF",
   "source": "pragma cashscript >=0.10.2;\n\ncontract Bar(bytes20 pkh_bar) {\n    function funcA() {\n        require(2==2);\n    }\n\n    function funcB() {\n        require(2==2);\n    }\n\n    function execute(pubkey pk, sig s) {\n        console.log(\"Bar 'execute' function called.\");\n        require(hash160(pk) == pkh_bar);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
-    "bytecode": "5179009c6352529c7777675179519c6352529c777767517a529c695179a9517a8769517a517aac6868",
-    "sourceMap": "4:4:6:5;;;;;5:16:5:17;:19::20;:16:::1;4:4:6:5;;;8::10::0;;;;;9:16:9:17;:19::20;:16:::1;8:4:10:5;;;12::16::0;;;;;14:24:14:26;;:16::27:1;:31::38:0;;:16:::1;:8::40;15:25:15:26:0;;:28::30;;:16::31:1;3:0:17:1;",
+    "bytecode": "78009c6352529c77776778519c6352529c7777677c529d78a988ac6868",
+    "sourceMap": "4:4:6:5;;;;5:16:5:17;:19::20;:16:::1;4:4:6:5;;;8::10::0;;;;9:16:9:17;:19::20;:16:::1;8:4:10:5;;;12::16::0;;;14:24:14:26;:16::27:1;:8::40;15:16:15:31;3:0:17:1;",
     "logs": [
       {
-        "ip": 28,
+        "ip": 24,
         "line": 13,
         "data": [
           "Bar 'execute' function called."
@@ -45,26 +45,26 @@
     ],
     "requires": [
       {
-        "ip": 9,
+        "ip": 8,
         "line": 5
       },
       {
-        "ip": 20,
+        "ip": 18,
         "line": 9
       },
       {
-        "ip": 34,
+        "ip": 26,
         "line": 14
       },
       {
-        "ip": 40,
+        "ip": 28,
         "line": 15
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.0"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-02-18T09:30:48.363Z"
+  "updatedAt": "2025-05-11T10:02:25.571Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/Foo.artifact.ts b/packages/cashscript/test/fixture/Foo.artifact.ts
index 1cb3af77..37925f5a 100644
--- a/packages/cashscript/test/fixture/Foo.artifact.ts
+++ b/packages/cashscript/test/fixture/Foo.artifact.ts
@@ -24,8 +24,8 @@ export default {
   bytecode: 'OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG',
   source: 'pragma cashscript >=0.10.2;\n\ncontract Foo(bytes20 pkh_foo) {\n    // Require pk to match stored pkh and signature to match\n    function execute(pubkey pk, sig s) {\n        console.log(\'Foo \'execute\' function called.\');\n        require(hash160(pk) == pkh_foo);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
-    bytecode: '5179a9517a8769517a517aac',
-    sourceMap: '7:24:7:26;;:16::27:1;:31::38:0;;:16:::1;:8::40;8:25:8:26:0;;:28::30;;:16::31:1',
+    bytecode: '78a988ac',
+    sourceMap: '7:24:7:26;:16::27:1;:8::40;8:16:8:31',
     logs: [
       {
         ip: 1,
@@ -37,18 +37,18 @@ export default {
     ],
     requires: [
       {
-        ip: 7,
+        ip: 3,
         line: 7,
       },
       {
-        ip: 13,
+        ip: 5,
         line: 8,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.0',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2025-02-18T09:30:49.147Z',
+  updatedAt: '2025-05-11T10:02:26.288Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/Foo.json b/packages/cashscript/test/fixture/Foo.json
index 210d45bf..e658fbd9 100644
--- a/packages/cashscript/test/fixture/Foo.json
+++ b/packages/cashscript/test/fixture/Foo.json
@@ -24,8 +24,8 @@
   "bytecode": "OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG",
   "source": "pragma cashscript >=0.10.2;\n\ncontract Foo(bytes20 pkh_foo) {\n    // Require pk to match stored pkh and signature to match\n    function execute(pubkey pk, sig s) {\n        console.log(\"Foo 'execute' function called.\");\n        require(hash160(pk) == pkh_foo);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
-    "bytecode": "5179a9517a8769517a517aac",
-    "sourceMap": "7:24:7:26;;:16::27:1;:31::38:0;;:16:::1;:8::40;8:25:8:26:0;;:28::30;;:16::31:1",
+    "bytecode": "78a988ac",
+    "sourceMap": "7:24:7:26;:16::27:1;:8::40;8:16:8:31",
     "logs": [
       {
         "ip": 1,
@@ -37,18 +37,18 @@
     ],
     "requires": [
       {
-        "ip": 7,
+        "ip": 3,
         "line": 7
       },
       {
-        "ip": 13,
+        "ip": 5,
         "line": 8
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.0"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-02-18T09:30:48.900Z"
+  "updatedAt": "2025-05-11T10:02:26.046Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/announcement.artifact.ts b/packages/cashscript/test/fixture/announcement.artifact.ts
index 2c9548ce..dbae5976 100644
--- a/packages/cashscript/test/fixture/announcement.artifact.ts
+++ b/packages/cashscript/test/fixture/announcement.artifact.ts
@@ -10,31 +10,31 @@ export default {
   bytecode: '6a 6d02 OP_SIZE OP_SWAP OP_CAT OP_CAT 4120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e OP_SIZE OP_DUP 4b OP_GREATERTHAN OP_IF 4c OP_SWAP OP_CAT OP_ENDIF OP_SWAP OP_CAT OP_CAT OP_0 OP_OUTPUTVALUE OP_0 OP_NUMEQUALVERIFY OP_0 OP_OUTPUTBYTECODE OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_OVER OP_SUB OP_DUP OP_ROT OP_GREATERTHANOREQUAL OP_IF OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_DROP OP_1',
   source: 'pragma cashscript >=0.8.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an \'announcement\' on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes(\'A contract may not injure a human being or, through inaction, allow a human being to come to harm.\')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there\'s enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n',
   debug: {
-    bytecode: '016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009c6900cd517a876902e803c0c65179940079527aa26351cdc0c7876951cc51799c69685177',
-    sourceMap: '10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:16:::1;:8::42;17:27:17:28:0;:16::45:1;:49::61:0;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;;:20:::1;:12::57;23:38:26:9;8:4:27:5;',
+    bytecode: '016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009d00cd8802e803c0c67894767ba26351cdc0c78851cc789d687551',
+    sourceMap: '10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:8::42:1;17:27:17:28:0;:16::45:1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;:27:::1;23:12:23:24:0;:28::36;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;:12::57:1;23:38:26:9;8:4:27:5;',
     logs: [],
     requires: [
       {
-        ip: 23,
+        ip: 22,
         line: 16,
       },
       {
-        ip: 29,
+        ip: 25,
         line: 17,
       },
       {
-        ip: 47,
+        ip: 39,
         line: 24,
       },
       {
-        ip: 53,
+        ip: 43,
         line: 25,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.4',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2024-12-03T13:57:07.764Z',
+  updatedAt: '2025-05-11T10:02:25.333Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/announcement.json b/packages/cashscript/test/fixture/announcement.json
index 55d6005d..b2e56928 100644
--- a/packages/cashscript/test/fixture/announcement.json
+++ b/packages/cashscript/test/fixture/announcement.json
@@ -10,31 +10,31 @@
   "bytecode": "6a 6d02 OP_SIZE OP_SWAP OP_CAT OP_CAT 4120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e OP_SIZE OP_DUP 4b OP_GREATERTHAN OP_IF 4c OP_SWAP OP_CAT OP_ENDIF OP_SWAP OP_CAT OP_CAT OP_0 OP_OUTPUTVALUE OP_0 OP_NUMEQUALVERIFY OP_0 OP_OUTPUTBYTECODE OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_OVER OP_SUB OP_DUP OP_ROT OP_GREATERTHANOREQUAL OP_IF OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_DROP OP_1",
   "source": "pragma cashscript >=0.8.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an \"announcement\" on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes('A contract may not injure a human being or, through inaction, allow a human being to come to harm.')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there's enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n",
   "debug": {
-    "bytecode": "016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009c6900cd517a876902e803c0c65179940079527aa26351cdc0c7876951cc51799c69685177",
-    "sourceMap": "10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:16:::1;:8::42;17:27:17:28:0;:16::45:1;:49::61:0;;:16:::1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;;:27:::1;23:12:23:24:0;;:28::36;;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;;:20:::1;:12::57;23:38:26:9;8:4:27:5;",
+    "bytecode": "016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009d00cd8802e803c0c67894767ba26351cdc0c78851cc789d687551",
+    "sourceMap": "10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:8::42:1;17:27:17:28:0;:16::45:1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;:27:::1;23:12:23:24:0;:28::36;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;:12::57:1;23:38:26:9;8:4:27:5;",
     "logs": [],
     "requires": [
       {
-        "ip": 23,
+        "ip": 22,
         "line": 16
       },
       {
-        "ip": 29,
+        "ip": 25,
         "line": 17
       },
       {
-        "ip": 47,
+        "ip": 39,
         "line": 24
       },
       {
-        "ip": 53,
+        "ip": 43,
         "line": 25
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.4"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2024-12-03T13:57:07.512Z"
+  "updatedAt": "2025-05-11T10:02:25.092Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.artifact.ts b/packages/cashscript/test/fixture/bigint.artifact.ts
index 0a9f7957..76c6283c 100644
--- a/packages/cashscript/test/fixture/bigint.artifact.ts
+++ b/packages/cashscript/test/fixture/bigint.artifact.ts
@@ -19,23 +19,23 @@ export default {
   bytecode: '000000000000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL',
   source: 'contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt64PlusOne = 9223372036854775808;\n        require(x >= maxInt64PlusOne);\n        require(x * y >= maxInt64PlusOne);\n    }\n}\n',
   debug: {
-    bytecode: '0900000000000000800051795179a269517a527a95517aa2',
-    sourceMap: '3:30:3:49;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1',
+    bytecode: '090000000000000080006ea2697c7b95a1',
+    sourceMap: '3:30:3:49;4:16:4:36;::::1;:8::38;5:16:5:17:0;:20::21;:16:::1;:::40',
     logs: [],
     requires: [
       {
-        ip: 6,
+        ip: 3,
         line: 4,
       },
       {
-        ip: 15,
+        ip: 8,
         line: 5,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.1',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2025-03-04T09:20:05.977Z',
+  updatedAt: '2025-05-11T10:02:24.855Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index 507f9a8a..3ddce027 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -19,23 +19,23 @@
   "bytecode": "000000000000008000 OP_2DUP OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_ROT OP_MUL OP_LESSTHANOREQUAL",
   "source": "contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt64PlusOne = 9223372036854775808;\n        require(x >= maxInt64PlusOne);\n        require(x * y >= maxInt64PlusOne);\n    }\n}\n",
   "debug": {
-    "bytecode": "0900000000000000800051795179a269517a527a95517aa2",
-    "sourceMap": "3:30:3:49;4:16:4:17;;:21::36;;:16:::1;:8::38;5:16:5:17:0;;:20::21;;:16:::1;:25::40:0;;:16:::1",
+    "bytecode": "090000000000000080006ea2697c7b95a1",
+    "sourceMap": "3:30:3:49;4:16:4:36;::::1;:8::38;5:16:5:17:0;:20::21;:16:::1;:::40",
     "logs": [],
     "requires": [
       {
-        "ip": 6,
+        "ip": 3,
         "line": 4
       },
       {
-        "ip": 15,
+        "ip": 8,
         "line": 5
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.1"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-03-04T09:20:05.760Z"
+  "updatedAt": "2025-05-11T10:02:24.621Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bounded_bytes.artifact.ts b/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
index 7a9015c7..b4b7d907 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
+++ b/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
@@ -19,19 +19,19 @@ export default {
   bytecode: 'OP_SWAP OP_4 OP_NUM2BIN OP_EQUAL',
   source: 'contract BoundedBytes() {\n    function spend(bytes4 b, int i) {\n        require(b == bytes4(i));\n    }\n}\n',
   debug: {
-    bytecode: '007a517a548087',
-    sourceMap: '3:16:3:17;;:28::29;;:21::30:1;;:16',
+    bytecode: '7c548087',
+    sourceMap: '3:28:3:29;:21::30:1;;:16',
     logs: [],
     requires: [
       {
-        ip: 7,
+        ip: 4,
         line: 3,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.4',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2024-12-03T13:57:09.177Z',
+  updatedAt: '2025-05-11T10:02:27.812Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index fa55c742..0cd8cfed 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -19,19 +19,19 @@
   "bytecode": "OP_SWAP OP_4 OP_NUM2BIN OP_EQUAL",
   "source": "contract BoundedBytes() {\n    function spend(bytes4 b, int i) {\n        require(b == bytes4(i));\n    }\n}\n",
   "debug": {
-    "bytecode": "007a517a548087",
-    "sourceMap": "3:16:3:17;;:28::29;;:21::30:1;;:16",
+    "bytecode": "7c548087",
+    "sourceMap": "3:28:3:29;:21::30:1;;:16",
     "logs": [],
     "requires": [
       {
-        "ip": 7,
+        "ip": 4,
         "line": 3
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.4"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2024-12-03T13:57:08.944Z"
+  "updatedAt": "2025-05-11T10:02:27.596Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/hodl_vault.artifact.ts b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
index 39a46307..9deb25b1 100644
--- a/packages/cashscript/test/fixture/hodl_vault.artifact.ts
+++ b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
@@ -40,35 +40,35 @@ export default {
   bytecode: 'OP_6 OP_PICK OP_4 OP_SPLIT OP_SWAP OP_BIN2NUM OP_SWAP OP_BIN2NUM OP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY OP_CHECKSIG',
   source: '// This contract forces HODLing until a certain price target has been reached\n// A minimum block is provided to ensure that oracle price entries from before this block are disregarded\n// i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used.\n// Instead, a message with a block number and price from after the minBlock needs to be passed.\n// This contract serves as a simple example for checkDataSig-based contracts.\ncontract HodlVault(\n    pubkey ownerPk,\n    pubkey oraclePk,\n    int minBlock,\n    int priceTarget\n) {\n    function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {\n        // message: { blockHeight, price }\n        bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);\n        int blockHeight = int(blockHeightBin);\n        int price = int(priceBin);\n\n        // Check that blockHeight is after minBlock and not in the future\n        require(blockHeight >= minBlock);\n        require(tx.time >= blockHeight);\n\n        // Check that current price is at least priceTarget\n        require(price >= priceTarget);\n\n        // Handle necessary signature checks\n        require(checkDataSig(oracleSig, oracleMessage, oraclePk));\n        require(checkSig(ownerSig, ownerPk));\n    }\n}\n',
   debug: {
-    bytecode: '5679547f517a81517a815179557aa269517ab175007a537aa269537a547a537aba69517a517aac',
-    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;;:26::45:1;16:24:16:32:0;;:20::33:1;19:16:19:27:0;;:31::39;;:16:::1;:8::41;20:27:20:38:0;;:8::40:1;;23:16:23:21:0;;:25::36;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:16::64:1;:8::66;27:25:27:33:0;;:35::42;;:16::43:1',
+    bytecode: '5679547f7c817c8178557aa2697cb175537aa269537a547a537abbac',
+    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:8::66:1;27:16:27:43',
     logs: [],
     requires: [
       {
-        ip: 19,
+        ip: 16,
         line: 19,
       },
       {
-        ip: 22,
+        ip: 18,
         line: 20,
       },
       {
-        ip: 29,
+        ip: 23,
         line: 23,
       },
       {
-        ip: 37,
+        ip: 30,
         line: 26,
       },
       {
-        ip: 43,
+        ip: 32,
         line: 27,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.4',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2024-12-03T13:57:08.243Z',
+  updatedAt: '2025-05-11T10:02:26.850Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index 36ba6880..803ebc23 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -40,35 +40,35 @@
   "bytecode": "OP_6 OP_PICK OP_4 OP_SPLIT OP_SWAP OP_BIN2NUM OP_SWAP OP_BIN2NUM OP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY OP_CHECKSIG",
   "source": "// This contract forces HODLing until a certain price target has been reached\n// A minimum block is provided to ensure that oracle price entries from before this block are disregarded\n// i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used.\n// Instead, a message with a block number and price from after the minBlock needs to be passed.\n// This contract serves as a simple example for checkDataSig-based contracts.\ncontract HodlVault(\n    pubkey ownerPk,\n    pubkey oraclePk,\n    int minBlock,\n    int priceTarget\n) {\n    function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {\n        // message: { blockHeight, price }\n        bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);\n        int blockHeight = int(blockHeightBin);\n        int price = int(priceBin);\n\n        // Check that blockHeight is after minBlock and not in the future\n        require(blockHeight >= minBlock);\n        require(tx.time >= blockHeight);\n\n        // Check that current price is at least priceTarget\n        require(price >= priceTarget);\n\n        // Handle necessary signature checks\n        require(checkDataSig(oracleSig, oracleMessage, oraclePk));\n        require(checkSig(ownerSig, ownerPk));\n    }\n}\n",
   "debug": {
-    "bytecode": "5679547f517a81517a815179557aa269517ab175007a537aa269537a547a537aba69517a517aac",
-    "sourceMap": "14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;;:26::45:1;16:24:16:32:0;;:20::33:1;19:16:19:27:0;;:31::39;;:16:::1;:8::41;20:27:20:38:0;;:8::40:1;;23:16:23:21:0;;:25::36;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:16::64:1;:8::66;27:25:27:33:0;;:35::42;;:16::43:1",
+    "bytecode": "5679547f7c817c8178557aa2697cb175537aa269537a547a537abbac",
+    "sourceMap": "14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:8::66:1;27:16:27:43",
     "logs": [],
     "requires": [
       {
-        "ip": 19,
+        "ip": 16,
         "line": 19
       },
       {
-        "ip": 22,
+        "ip": 18,
         "line": 20
       },
       {
-        "ip": 29,
+        "ip": 23,
         "line": 23
       },
       {
-        "ip": 37,
+        "ip": 30,
         "line": 26
       },
       {
-        "ip": 43,
+        "ip": 32,
         "line": 27
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.4"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2024-12-03T13:57:07.996Z"
+  "updatedAt": "2025-05-11T10:02:26.630Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/mecenas.artifact.ts b/packages/cashscript/test/fixture/mecenas.artifact.ts
index 9d157e82..c95fc9da 100644
--- a/packages/cashscript/test/fixture/mecenas.artifact.ts
+++ b/packages/cashscript/test/fixture/mecenas.artifact.ts
@@ -36,43 +36,43 @@ export default {
   bytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
   source: 'pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho\'s Mecenas contract. It is\n * not compatible with Licho\'s EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(this.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
-    bytecode: '5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768',
-    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1',
+    bytecode: '5379009c6300cd0376a9147b7e0288ac7e8802e803c0c676547994527994765579547993a16300cc707c949d6700cc55799d51cdc0c78851cc789d686d6d6d5167537a519d5379a97b8872ac777768',
+    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::66:0;;::::1;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:12::51:1;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;:12::56:1;23:15:27:9;9:4:28:5;;;;;30::33::0;;;;31:24:31:26;;:16::27:1;:31::37:0;:8::39:1;32:25:32:30:0;:16::31:1;30:4:33:5;;8:0:34:1',
     logs: [],
     requires: [
       {
-        ip: 17,
+        ip: 15,
         line: 13,
       },
       {
-        ip: 46,
+        ip: 39,
         line: 22,
       },
       {
-        ip: 53,
+        ip: 45,
         line: 24,
       },
       {
-        ip: 59,
+        ip: 50,
         line: 25,
       },
       {
-        ip: 65,
+        ip: 54,
         line: 26,
       },
       {
-        ip: 86,
+        ip: 69,
         line: 31,
       },
       {
-        ip: 92,
+        ip: 72,
         line: 32,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.1',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2025-03-04T09:20:10.767Z',
+  updatedAt: '2025-05-11T10:02:29.858Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index 1e3edb89..4a4d14d1 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -36,43 +36,43 @@
   "bytecode": "OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF",
   "source": "pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(this.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
-    "bytecode": "5379009c6300cd0376a914527a7e0288ac7e876902e803c0c6007954799452799400795579547993a16300cc52795479949c696700cc55799c6951cdc0c7876951cc51799c69685177777777777767537a519c695379a9527a8769537a537aac777768",
-    "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;;:49::84:1;;;:16;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::55:0;;:58::66;;:43:::1;:20;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:20:::1;:12::51;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:20;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;;:20:::1;:12::56;23:15:27:9;9:4:28:5;;;;;;;;30::33::0;;;;;31:24:31:26;;:16::27:1;:31::37:0;;:16:::1;:8::39;32:25:32:26:0;;:28::30;;:16::31:1;30:4:33:5;;8:0:34:1",
+    "bytecode": "5379009c6300cd0376a9147b7e0288ac7e8802e803c0c676547994527994765579547993a16300cc707c949d6700cc55799d51cdc0c78851cc789d686d6d6d5167537a519d5379a97b8872ac777768",
+    "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::66:0;;::::1;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:12::51:1;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;:12::56:1;23:15:27:9;9:4:28:5;;;;;30::33::0;;;;31:24:31:26;;:16::27:1;:31::37:0;:8::39:1;32:25:32:30:0;:16::31:1;30:4:33:5;;8:0:34:1",
     "logs": [],
     "requires": [
       {
-        "ip": 17,
+        "ip": 15,
         "line": 13
       },
       {
-        "ip": 46,
+        "ip": 39,
         "line": 22
       },
       {
-        "ip": 53,
+        "ip": 45,
         "line": 24
       },
       {
-        "ip": 59,
+        "ip": 50,
         "line": 25
       },
       {
-        "ip": 65,
+        "ip": 54,
         "line": 26
       },
       {
-        "ip": 86,
+        "ip": 69,
         "line": 31
       },
       {
-        "ip": 92,
+        "ip": 72,
         "line": 32
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.1"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-03-04T09:20:10.424Z"
+  "updatedAt": "2025-05-11T10:02:29.610Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2palindrome.artifact.ts b/packages/cashscript/test/fixture/p2palindrome.artifact.ts
index e80b5ea5..59b9c41a 100644
--- a/packages/cashscript/test/fixture/p2palindrome.artifact.ts
+++ b/packages/cashscript/test/fixture/p2palindrome.artifact.ts
@@ -15,19 +15,19 @@ export default {
   bytecode: 'OP_DUP OP_REVERSEBYTES OP_EQUAL',
   source: 'contract P2Palindrome() {\n    function spend(string palindrome) {\n        require(palindrome.reverse() == palindrome);\n    }\n}\n',
   debug: {
-    bytecode: '0079bc517a87',
-    sourceMap: '3:16:3:26;;:::36:1;:40::50:0;;:16:::1',
+    bytecode: '76bc87',
+    sourceMap: '3:16:3:26;:::36:1;:::50',
     logs: [],
     requires: [
       {
-        ip: 6,
+        ip: 3,
         line: 3,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.4',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2024-12-03T13:57:08.710Z',
+  updatedAt: '2025-05-11T10:02:27.355Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index 0c389308..b6115e9f 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -15,19 +15,19 @@
   "bytecode": "OP_DUP OP_REVERSEBYTES OP_EQUAL",
   "source": "contract P2Palindrome() {\n    function spend(string palindrome) {\n        require(palindrome.reverse() == palindrome);\n    }\n}\n",
   "debug": {
-    "bytecode": "0079bc517a87",
-    "sourceMap": "3:16:3:26;;:::36:1;:40::50:0;;:16:::1",
+    "bytecode": "76bc87",
+    "sourceMap": "3:16:3:26;:::36:1;:::50",
     "logs": [],
     "requires": [
       {
-        "ip": 6,
+        "ip": 3,
         "line": 3
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.4"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2024-12-03T13:57:08.472Z"
+  "updatedAt": "2025-05-11T10:02:27.126Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2pkh.artifact.ts b/packages/cashscript/test/fixture/p2pkh.artifact.ts
index b45bc7c2..08d70e3b 100644
--- a/packages/cashscript/test/fixture/p2pkh.artifact.ts
+++ b/packages/cashscript/test/fixture/p2pkh.artifact.ts
@@ -24,23 +24,23 @@ export default {
   bytecode: 'OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG',
   source: 'contract P2PKH(bytes20 pkh) {\n    // Require pk to match stored pkh and signature to match\n    function spend(pubkey pk, sig s) {\n        require(hash160(pk) == pkh);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
-    bytecode: '5179a9517a8769517a517aac',
-    sourceMap: '4:24:4:26;;:16::27:1;:31::34:0;;:16:::1;:8::36;5:25:5:26:0;;:28::30;;:16::31:1',
+    bytecode: '78a988ac',
+    sourceMap: '4:24:4:26;:16::27:1;:8::36;5:16:5:31',
     logs: [],
     requires: [
       {
-        ip: 7,
+        ip: 3,
         line: 4,
       },
       {
-        ip: 13,
+        ip: 5,
         line: 5,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.4',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2024-12-03T13:57:11.056Z',
+  updatedAt: '2025-05-11T10:02:29.364Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index c39a82cb..8fd2a72a 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -24,23 +24,23 @@
   "bytecode": "OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG",
   "source": "contract P2PKH(bytes20 pkh) {\n    // Require pk to match stored pkh and signature to match\n    function spend(pubkey pk, sig s) {\n        require(hash160(pk) == pkh);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
-    "bytecode": "5179a9517a8769517a517aac",
-    "sourceMap": "4:24:4:26;;:16::27:1;:31::34:0;;:16:::1;:8::36;5:25:5:26:0;;:28::30;;:16::31:1",
+    "bytecode": "78a988ac",
+    "sourceMap": "4:24:4:26;:16::27:1;:8::36;5:16:5:31",
     "logs": [],
     "requires": [
       {
-        "ip": 7,
+        "ip": 3,
         "line": 4
       },
       {
-        "ip": 13,
+        "ip": 5,
         "line": 5
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.4"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2024-12-03T13:57:10.827Z"
+  "updatedAt": "2025-05-11T10:02:29.115Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/token_category_comparison.artifact.ts b/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
index 043b507f..a9612b1b 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
+++ b/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
@@ -22,7 +22,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.4',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2024-12-03T13:57:10.582Z',
+  updatedAt: '2025-05-11T10:02:28.885Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/token_category_comparison.json b/packages/cashscript/test/fixture/token_category_comparison.json
index 0d1ed087..b2a607f6 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.json
+++ b/packages/cashscript/test/fixture/token_category_comparison.json
@@ -22,7 +22,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.4"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2024-12-03T13:57:10.355Z"
+  "updatedAt": "2025-05-11T10:02:28.558Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
index 4c738201..32deb1ec 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
@@ -37,27 +37,27 @@ export default {
   bytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_ROLL OP_ROT OP_CHECKSIG OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_2DROP OP_1 OP_ENDIF',
   source: 'contract TransferWithTimeout(\n    pubkey sender,\n    pubkey recipient,\n    int timeout\n) {\n    // Require recipient\'s signature to match\n    function transfer(sig recipientSig) {\n        require(checkSig(recipientSig, recipient));\n    }\n\n    // Require timeout time to be reached and sender\'s signature to match\n    function timeout(sig senderSig) {\n        require(checkSig(senderSig, sender));\n        require(tx.time >= timeout);\n    }\n}\n',
   debug: {
-    bytecode: '5379009c63547a527aac77777767537a519c69537a517aac69517ab175517768',
-    sourceMap: '7:4:9:5;;;;;8:25:8:37;;:39::48;;:16::49:1;7:4:9:5;;;;12::15::0;;;;;13:25:13:34;;:36::42;;:16::43:1;:8::45;14:27:14:34:0;;:8::36:1;;12:4:15:5;;1:0:16:1',
+    bytecode: '5379009c63547a7bac77777767537a519d537a7cad7cb16d5168',
+    sourceMap: '7:4:9:5;;;;;8:25:8:37;;:39::48;:16::49:1;7:4:9:5;;;;12::15::0;;;;13:25:13:34;;:36::42;:8::45:1;14:27:14:34:0;:8::36:1;12:4:15:5;;1:0:16:1',
     logs: [],
     requires: [
       {
-        ip: 13,
+        ip: 12,
         line: 8,
       },
       {
-        ip: 27,
+        ip: 23,
         line: 13,
       },
       {
-        ip: 30,
+        ip: 25,
         line: 14,
       },
     ],
   },
   compiler: {
     name: 'cashc',
-    version: '0.10.4',
+    version: '0.11.0-next.4',
   },
-  updatedAt: '2024-12-03T13:57:10.112Z',
+  updatedAt: '2025-05-11T10:02:28.290Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index 82ff4488..940c9728 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -37,27 +37,27 @@
   "bytecode": "OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_4 OP_ROLL OP_ROT OP_CHECKSIG OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_2DROP OP_1 OP_ENDIF",
   "source": "contract TransferWithTimeout(\n    pubkey sender,\n    pubkey recipient,\n    int timeout\n) {\n    // Require recipient's signature to match\n    function transfer(sig recipientSig) {\n        require(checkSig(recipientSig, recipient));\n    }\n\n    // Require timeout time to be reached and sender's signature to match\n    function timeout(sig senderSig) {\n        require(checkSig(senderSig, sender));\n        require(tx.time >= timeout);\n    }\n}\n",
   "debug": {
-    "bytecode": "5379009c63547a527aac77777767537a519c69537a517aac69517ab175517768",
-    "sourceMap": "7:4:9:5;;;;;8:25:8:37;;:39::48;;:16::49:1;7:4:9:5;;;;12::15::0;;;;;13:25:13:34;;:36::42;;:16::43:1;:8::45;14:27:14:34:0;;:8::36:1;;12:4:15:5;;1:0:16:1",
+    "bytecode": "5379009c63547a7bac77777767537a519d537a7cad7cb16d5168",
+    "sourceMap": "7:4:9:5;;;;;8:25:8:37;;:39::48;:16::49:1;7:4:9:5;;;;12::15::0;;;;13:25:13:34;;:36::42;:8::45:1;14:27:14:34:0;:8::36:1;12:4:15:5;;1:0:16:1",
     "logs": [],
     "requires": [
       {
-        "ip": 13,
+        "ip": 12,
         "line": 8
       },
       {
-        "ip": 27,
+        "ip": 23,
         "line": 13
       },
       {
-        "ip": 30,
+        "ip": 25,
         "line": 14
       }
     ]
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.10.4"
+    "version": "0.11.0-next.4"
   },
-  "updatedAt": "2024-12-03T13:57:09.878Z"
+  "updatedAt": "2025-05-11T10:02:28.047Z"
 }
\ No newline at end of file

From c1c44f9ac70d49176f3e63daea711ce83bc130f8 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 21 May 2025 10:24:43 +0200
Subject: [PATCH 245/267] Small docs updates

---
 website/docs/releases/migration-notes.md | 4 ++--
 website/docs/sdk/testing-setup.md        | 3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/website/docs/releases/migration-notes.md b/website/docs/releases/migration-notes.md
index 40e7e25a..f7644f0b 100644
--- a/website/docs/releases/migration-notes.md
+++ b/website/docs/releases/migration-notes.md
@@ -10,7 +10,7 @@ There are several breaking changes to the compiler and SDK in this release. They
 
 `tx.age` was renamed to `this.age` to better reflect that it enforces a UTXO-level locktime check (*not* transaction-level). To migrate, replace all occurrences of `tx.age` with `this.age`.
 
-### CashScript SDK (Transaction Builder)
+### SDK: Transaction Builder
 
 The 'Simple Transaction builder' has been marked as deprecated and the 'Advanced Transaction Builder' is now simply referred to as the CashScript `Transaction Builder`, as there is only one supported for the future.
 
@@ -75,7 +75,7 @@ const txDetails = await new TransactionBuilder({ provider })
 
 With the new transaction builder, all inputs and outputs are explicitly specified. This means that there are no automatic change outputs added (for BCH or tokens). This means that there are also no `.withMinChange()`, `.withoutChange()`, `.withoutTokenChange()`, `withHardcodedFee()`, or `.withFeePerByte()` methods. The developer is responsible for manually adding change outputs. There is still an option to use `.setMaxFee()` as a security measure to prevent the transaction from being too expensive.
 
-### CashScript SDK (ElectrumNetworkProvider)
+### SDK: ElectrumNetworkProvider
 
 The underlying `electrum-cash` library has been migrated to the new `@electrum-cash/network` package. This drops support for electrum cluster functionality. We reworked the second parameter of the `ElectrumNetworkProvider` constructor to be an options object, which can contain a custom electrum client or a custom hostname.
 
diff --git a/website/docs/sdk/testing-setup.md b/website/docs/sdk/testing-setup.md
index 875100ee..6eac6b57 100644
--- a/website/docs/sdk/testing-setup.md
+++ b/website/docs/sdk/testing-setup.md
@@ -55,6 +55,7 @@ Logging is only available in debug evaluation of a transaction. It has no impact
 ```ts
 describe('Example contract', () => {
   it('should log the passed parameter', async () => {
+    const provider = new MockNetworkProvider();
     const contract = new Contract(artifact, [], { provider });
     const contractUtxo = provider.addUtxo(contract.address, randomUtxo());
 
@@ -76,6 +77,7 @@ Similar to `console.log`, the error message in a `require` statement is only ava
 
 ```ts
 describe('Example contract', () => {
+  const provider = new MockNetworkProvider();
   const contract = new Contract(artifact, [], { provider });
   const contractUtxo = provider.addUtxo(contract.address, randomUtxo());
 
@@ -117,7 +119,6 @@ describe('Example contract', () => {
   const contractUtxo = provider.addUtxo(contract.address, randomUtxo());
 
   it('should log the passed parameter', async () => {
-    const contract = new Contract(artifact, [], { provider });
     const transaction = new TransactionBuilder({ provider })
       .addInput(contractUtxo, contract.unlock.exampleFunction(1000n))
       .addOutput({ to: contract.address, amount: 10000n })

From bb74ff04cb5cd39ff10371eaa0d0989cbb5238b4 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Wed, 21 May 2025 11:16:15 +0200
Subject: [PATCH 246/267] Update debug() compatibility message to use semver
 and make transactionbuilder debug() sync

---
 examples/testing-suite/test/example.test.ts   |   6 +-
 packages/cashscript/src/Transaction.ts        |   5 +-
 packages/cashscript/src/TransactionBuilder.ts |  15 +-
 .../cashscript/src/test/JestExtensions.ts     |  47 +++-
 packages/cashscript/test/debugging.test.ts    | 240 +++++++++---------
 website/docs/sdk/testing-setup.md             |  12 +-
 website/docs/sdk/transaction-builder.md       |   2 +-
 7 files changed, 186 insertions(+), 141 deletions(-)

diff --git a/examples/testing-suite/test/example.test.ts b/examples/testing-suite/test/example.test.ts
index f4972490..866e2a9f 100644
--- a/examples/testing-suite/test/example.test.ts
+++ b/examples/testing-suite/test/example.test.ts
@@ -14,13 +14,15 @@ describe('test example contract functions', () => {
     const transactionWrongValuePassed = new TransactionBuilder({ provider })
       .addInput(contractUtxo, contract.unlock.test(0n))
       .addOutput({ to: contract.address, amount: 10000n });
-    await (expect(transactionWrongValuePassed)).toLog(/0 test/);
-    await (expect(transactionWrongValuePassed)).toFailRequireWith(/Wrong value passed/);
+
+    expect(transactionWrongValuePassed).toLog(/0 test/);
+    expect(transactionWrongValuePassed).toFailRequireWith(/Wrong value passed/);
 
     const transactionRightValuePassed = new TransactionBuilder({ provider })
       .addInput(contractUtxo, contract.unlock.test(1n))
       .addOutput({ to: contract.address, amount: 10000n })
       .send();
+
     await expect(transactionRightValuePassed).resolves.not.toThrow();
   });
 });
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index c277a64f..063045d4 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -41,6 +41,7 @@ import { buildTemplate, getBitauthUri } from './LibauthTemplate.js';
 import { debugTemplate, DebugResults } from './debugging.js';
 import { EncodedFunctionArgument } from './Argument.js';
 import { FailedTransactionError } from './Errors.js';
+import semver from 'semver';
 
 export class Transaction {
   public inputs: Utxo[] = [];
@@ -186,8 +187,8 @@ export class Transaction {
 
   // method to debug the transaction with libauth VM, throws upon evaluation error
   async debug(): Promise<DebugResults> {
-    if (!this.contract.artifact.debug) {
-      console.warn('No debug information found in artifact. Recompile with cashc version 0.10.0 or newer to get better debugging information.');
+    if (!semver.satisfies(this.contract.artifact.compiler.version, '>=0.11.0-next.4', { includePrerelease: true })) {
+      console.warn('For the best debugging experience, please recompile your contract with cashc version 0.11.0 or newer.');
     }
 
     const template = await this.getLibauthTemplate();
diff --git a/packages/cashscript/src/TransactionBuilder.ts b/packages/cashscript/src/TransactionBuilder.ts
index 30c36f01..c435e8c0 100644
--- a/packages/cashscript/src/TransactionBuilder.ts
+++ b/packages/cashscript/src/TransactionBuilder.ts
@@ -27,6 +27,7 @@ import { FailedTransactionError } from './Errors.js';
 import { DebugResults } from './debugging.js';
 import { getBitauthUri } from './LibauthTemplate.js';
 import { debugLibauthTemplate, getLibauthTemplates } from './advanced/LibauthTemplate.js';
+import semver from 'semver';
 
 export interface TransactionBuilderOptions {
   provider: NetworkProvider;
@@ -157,9 +158,15 @@ export class TransactionBuilder {
     return binToHex(encodeTransaction(transaction));
   }
 
-  // method to debug the transaction with libauth VM, throws upon evaluation error
-  // TODO: Remove the async in the future (this currently breaks our debugging tests)
-  async debug(): Promise<DebugResults> {
+  debug(): DebugResults {
+    const contractVersions = this.inputs
+      .map((input) => 'contract' in input.unlocker ? input.unlocker.contract.artifact.compiler.version : null)
+      .filter((version) => version !== null);
+
+    if (!contractVersions.every((version) => semver.satisfies(version, '>=0.11.0-next.4', { includePrerelease: true }))) {
+      console.warn('For the best debugging experience, please recompile your contract with cashc version 0.11.0 or newer.');
+    }
+
     return debugLibauthTemplate(this.getLibauthTemplate(), this);
   }
 
@@ -178,7 +185,7 @@ export class TransactionBuilder {
     const tx = this.build();
 
     // Debug the transaction locally before sending so any errors are caught early
-    await this.debug();
+    this.debug();
 
     try {
       const txid = await this.provider.sendRawTransaction(tx);
diff --git a/packages/cashscript/src/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
index 657e479e..b0c16ce4 100644
--- a/packages/cashscript/src/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -16,15 +16,15 @@ declare global {
 }
 
 interface Debuggable {
-  debug(): Promise<DebugResults>;
+  debug(): DebugResults | Promise<DebugResults>;
 }
 
 expect.extend({
-  async toLog(
+  toLog(
     this: MatcherContext,
     transaction: Debuggable,
     match?: RegExp | string,
-  ): Promise<SyncExpectationResult> {
+  ): SyncExpectationResult {
     const loggerSpy = jest.spyOn(console, 'log');
 
     // Clear any previous calls (if spy reused accidentally)
@@ -33,7 +33,11 @@ expect.extend({
     // silence actual stdout output
     loggerSpy.mockImplementation(() => { });
 
-    try { await transaction.debug(); } catch { }
+    try {
+      executeDebug(transaction);
+    } catch (error) {
+      if (error instanceof OldTransactionBuilderError) throw error;
+    }
 
     // We concatenate all the logs into a single string - if no logs are present, we set received to undefined
     const receivedBase = loggerSpy.mock.calls.reduce((acc, [log]) => `${acc}\n${log}`, '').trim();
@@ -58,18 +62,20 @@ expect.extend({
 });
 
 expect.extend({
-  async toFailRequireWith(
+  toFailRequireWith(
     this: MatcherContext,
     transaction: Debuggable,
     match: RegExp | string,
-  ): Promise<SyncExpectationResult> {
+  ): SyncExpectationResult {
     try {
-      await transaction.debug();
+      executeDebug(transaction);
 
       const matcherHint = this.utils.matcherHint('.toFailRequireWith', undefined, match.toString(), { isNot: this.isNot });
       const message = (): string => `${matcherHint}\n\nContract function did not fail a require statement.`;
       return { message, pass: false };
     } catch (transactionError: any) {
+      if (transactionError instanceof OldTransactionBuilderError) throw transactionError;
+
       const matcherHint = this.utils.matcherHint('toFailRequireWith', 'received', 'expected', { isNot: this.isNot });
       const expectedText = `Expected pattern: ${this.isNot ? 'not ' : ''}${this.utils.printExpected(match)}`;
       const receivedText = `Received string: ${this.utils.printReceived(transactionError?.message ?? '')}`;
@@ -83,18 +89,39 @@ expect.extend({
       }
     }
   },
-  async toFailRequire(
+  toFailRequire(
     this: MatcherContext,
     transaction: Debuggable,
-  ): Promise<SyncExpectationResult> {
+  ): SyncExpectationResult {
     try {
-      await transaction.debug();
+      executeDebug(transaction);
       const message = (): string => 'Contract function did not fail a require statement.';
       return { message, pass: false };
     } catch (transactionError: any) {
+      if (transactionError instanceof OldTransactionBuilderError) throw transactionError;
+
       const receivedText = `Received string: ${this.utils.printReceived(transactionError?.message ?? '')}`;
       const message = (): string => `Contract function failed a require statement.\n${receivedText}`;
       return { message, pass: true };
     }
   },
 });
+
+
+// Wrapper function with custom error in case people use it with the old transaction builder
+// This is a temporary solution until we fully remove the old transaction builder from the SDK
+const executeDebug = (transaction: Debuggable): void => {
+  const debugResults = transaction.debug();
+
+  if (debugResults instanceof Promise) {
+    debugResults.catch(() => { });
+    throw new OldTransactionBuilderError();
+  }
+};
+
+class OldTransactionBuilderError extends Error {
+  constructor() {
+    super('The CashScript JestExtensions do not support the old transaction builder since v0.11.0. Please use the new TransactionBuilder class.');
+    this.name = 'OldTransactionBuilderError';
+  }
+}
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 13712087..18c7ed48 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -1,5 +1,5 @@
 import { Contract, MockNetworkProvider, SignatureAlgorithm, SignatureTemplate, TransactionBuilder } from '../src/index.js';
-import { alicePriv, alicePub, bobPriv, bobPub } from './fixture/vars.js';
+import { aliceAddress, alicePriv, alicePub, bobPriv, bobPub } from './fixture/vars.js';
 import '../src/test/JestExtensions.js';
 import { randomUtxo } from '../src/utils.js';
 import { AuthenticationErrorCommon, binToHex, hexToBin } from '@bitauth/libauth';
@@ -29,7 +29,7 @@ describe('Debugging tests', () => {
 
       // console.log(ownerSig, owner, num, beef, 1, "test", true);
       const expectedLog = new RegExp(`^Test.cash:10 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
-      await expect(transaction).toLog(expectedLog);
+      expect(transaction).toLog(expectedLog);
     });
 
     it('should log when logging happens before a failing require statement', async () => {
@@ -40,7 +40,7 @@ describe('Debugging tests', () => {
 
       // console.log(ownerSig, owner, num, beef, 1, "test", true);
       const expectedLog = new RegExp(`^Test.cash:10 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100 0xbeef 1 test true$`);
-      await expect(transaction).toLog(expectedLog);
+      expect(transaction).toLog(expectedLog);
     });
 
     it('should not log when logging happens after a failing require statement', async () => {
@@ -50,7 +50,7 @@ describe('Debugging tests', () => {
         .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
       const expectedLog = new RegExp(`^Test.cash:10 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 1000 0xbeef 1 test true$`);
-      await expect(transaction).not.toLog(expectedLog);
+      expect(transaction).not.toLog(expectedLog);
     });
 
     it('should only log console.log statements from the called function', async () => {
@@ -58,8 +58,8 @@ describe('Debugging tests', () => {
         .addInput(contractUtxo, contractTestLogs.unlock.secondFunction())
         .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
-      await expect(transaction).toLog(new RegExp('^Test.cash:16 Hello Second Function$'));
-      await expect(transaction).not.toLog(/Hello First Function/);
+      expect(transaction).toLog(new RegExp('^Test.cash:16 Hello Second Function$'));
+      expect(transaction).not.toLog(/Hello First Function/);
     });
 
     it('should only log console.log statements from the called function when there are many constructor parameters', async () => {
@@ -76,8 +76,8 @@ describe('Debugging tests', () => {
         .addInput(utxo, contractTestMultipleConstructorParameters.unlock.secondFunction())
         .addOutput({ to: contractTestMultipleConstructorParameters.address, amount: 10000n });
 
-      await expect(transaction).toLog(new RegExp('^Test.cash:20 Hello Second Function$'));
-      await expect(transaction).not.toLog(/Hello First Function/);
+      expect(transaction).toLog(new RegExp('^Test.cash:20 Hello Second Function$'));
+      expect(transaction).not.toLog(/Hello First Function/);
     });
 
     it('should only log console.log statements from the chosen branch in if-statement', async () => {
@@ -85,19 +85,19 @@ describe('Debugging tests', () => {
         .addInput(contractUtxo, contractTestLogs.unlock.functionWithIfStatement(1n))
         .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
-      await expect(transaction1).toLog(new RegExp('^Test.cash:24 a is 1$'));
-      await expect(transaction1).toLog(new RegExp('^Test.cash:31 a equals 1$'));
-      await expect(transaction1).toLog(new RegExp('^Test.cash:32 b equals 1$'));
-      await expect(transaction1).not.toLog(/a is not 1/);
+      expect(transaction1).toLog(new RegExp('^Test.cash:24 a is 1$'));
+      expect(transaction1).toLog(new RegExp('^Test.cash:31 a equals 1$'));
+      expect(transaction1).toLog(new RegExp('^Test.cash:32 b equals 1$'));
+      expect(transaction1).not.toLog(/a is not 1/);
 
       const transaction2 = new TransactionBuilder({ provider })
         .addInput(contractUtxo, contractTestLogs.unlock.functionWithIfStatement(2n))
         .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
-      await expect(transaction2).toLog(new RegExp('^Test.cash:27 a is not 1$'));
-      await expect(transaction2).toLog(new RegExp('^Test.cash:31 a equals 2$'));
-      await expect(transaction2).toLog(new RegExp('^Test.cash:32 b equals 2$'));
-      await expect(transaction2).not.toLog(/a is 1/);
+      expect(transaction2).toLog(new RegExp('^Test.cash:27 a is not 1$'));
+      expect(transaction2).toLog(new RegExp('^Test.cash:31 a equals 2$'));
+      expect(transaction2).toLog(new RegExp('^Test.cash:32 b equals 2$'));
+      expect(transaction2).not.toLog(/a is 1/);
     });
 
     it('should log multiple consecutive console.log statements on separate lines', async () => {
@@ -111,9 +111,9 @@ describe('Debugging tests', () => {
         .addOutput({ to: contractTestConsecutiveLogs.address, amount: 10000n });
 
       // console.log(ownerSig, owner, num, beef);
-      await expect(transaction).toLog(new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100$`));
+      expect(transaction).toLog(new RegExp(`^Test.cash:9 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100$`));
       // console.log(1, "test", true)
-      await expect(transaction).toLog(new RegExp('^Test.cash:10 0xbeef 1 test true$'));
+      expect(transaction).toLog(new RegExp('^Test.cash:10 0xbeef 1 test true$'));
     });
 
     it('should log multiple console.log statements with other statements in between', async () => {
@@ -128,10 +128,10 @@ describe('Debugging tests', () => {
 
       // console.log(ownerSig, owner, num);
       const expectedFirstLog = new RegExp(`^Test.cash:6 0x[0-9a-f]{130} 0x${binToHex(alicePub)} 100$`);
-      await expect(transaction).toLog(expectedFirstLog);
+      expect(transaction).toLog(expectedFirstLog);
 
       const expectedSecondLog = new RegExp('^Test.cash:11 0xbeef 1 test true$');
-      await expect(transaction).toLog(expectedSecondLog);
+      expect(transaction).toLog(expectedSecondLog);
     });
 
     it('should log intermediate results that get optimised out', async () => {
@@ -140,7 +140,7 @@ describe('Debugging tests', () => {
         .addOutput({ to: contractTestLogs.address, amount: 10000n });
 
       const expectedHash = binToHex(sha256(alicePub));
-      await expect(transaction).toLog(new RegExp(`^Test.cash:43 0x${expectedHash}$`));
+      expect(transaction).toLog(new RegExp(`^Test.cash:43 0x${expectedHash}$`));
     });
   });
 
@@ -160,8 +160,8 @@ describe('Debugging tests', () => {
         .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_require())
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:13 Require statement failed at input 0 in contract Test.cash at line 13 with the following message: 1 should equal 2.');
-      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
+      expect(transaction).toFailRequireWith('Test.cash:13 Require statement failed at input 0 in contract Test.cash at line 13 with the following message: 1 should equal 2.');
+      expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
     });
 
     // test_require_single_function
@@ -175,8 +175,8 @@ describe('Debugging tests', () => {
         .addOutput({ to: contractSingleFunction.address, amount: 1000n })
         .addOutput({ to: contractSingleFunction.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:4 Require statement failed at input 0 in contract Test.cash at line 4 with the following message: should have 1 output.');
-      await expect(transaction).toFailRequireWith('Failing statement: require(tx.outputs.length == 1, "should have 1 output")');
+      expect(transaction).toFailRequireWith('Test.cash:4 Require statement failed at input 0 in contract Test.cash at line 4 with the following message: should have 1 output.');
+      expect(transaction).toFailRequireWith('Failing statement: require(tx.outputs.length == 1, "should have 1 output")');
     });
 
     // test_multiple_require_statements
@@ -185,9 +185,9 @@ describe('Debugging tests', () => {
         .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_multiple_require_statements())
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:21 Require statement failed at input 0 in contract Test.cash at line 21 with the following message: 1 should equal 2.');
-      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
-      await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
+      expect(transaction).toFailRequireWith('Test.cash:21 Require statement failed at input 0 in contract Test.cash at line 21 with the following message: 1 should equal 2.');
+      expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
+      expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
     // test_multiple_require_statements_final_fails
@@ -196,9 +196,9 @@ describe('Debugging tests', () => {
         .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_multiple_require_statements_final_fails())
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:27 Require statement failed at input 0 in contract Test.cash at line 27 with the following message: 1 should equal 2.');
-      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
-      await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
+      expect(transaction).toFailRequireWith('Test.cash:27 Require statement failed at input 0 in contract Test.cash at line 27 with the following message: 1 should equal 2.');
+      expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
+      expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
     it('should not fail if no require statements fail', async () => {
@@ -206,7 +206,7 @@ describe('Debugging tests', () => {
         .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_require_no_failure())
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transaction).not.toFailRequire();
+      expect(transaction).not.toFailRequire();
     });
 
     // test_multiple_require_statements_no_message_final
@@ -215,9 +215,9 @@ describe('Debugging tests', () => {
         .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_multiple_require_statements_no_message_final())
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:32 Require statement failed at input 0 in contract Test.cash at line 32.');
-      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2)');
-      await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
+      expect(transaction).toFailRequireWith('Test.cash:32 Require statement failed at input 0 in contract Test.cash at line 32.');
+      expect(transaction).toFailRequireWith('Failing statement: require(1 == 2)');
+      expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
     // test_timeops_as_final_require
@@ -226,9 +226,9 @@ describe('Debugging tests', () => {
         .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_timeops_as_final_require())
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:37 Require statement failed at input 0 in contract Test.cash at line 37 with the following message: time should be HUGE.');
-      await expect(transaction).toFailRequireWith('Failing statement: require(tx.time >= 100000000, "time should be HUGE")');
-      await expect(transaction).not.toFailRequireWith(/1 should equal 1/);
+      expect(transaction).toFailRequireWith('Test.cash:37 Require statement failed at input 0 in contract Test.cash at line 37 with the following message: time should be HUGE.');
+      expect(transaction).toFailRequireWith('Failing statement: require(tx.time >= 100000000, "time should be HUGE")');
+      expect(transaction).not.toFailRequireWith(/1 should equal 1/);
     });
 
     // test_final_require_in_if_statement
@@ -237,22 +237,22 @@ describe('Debugging tests', () => {
         .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_final_require_in_if_statement(1n))
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transactionIfBranch).toFailRequireWith('Test.cash:43 Require statement failed at input 0 in contract Test.cash at line 43 with the following message: 1 should equal 2.');
-      await expect(transactionIfBranch).toFailRequireWith('Failing statement: require(1 == a, "1 should equal 2")');
+      expect(transactionIfBranch).toFailRequireWith('Test.cash:43 Require statement failed at input 0 in contract Test.cash at line 43 with the following message: 1 should equal 2.');
+      expect(transactionIfBranch).toFailRequireWith('Failing statement: require(1 == a, "1 should equal 2")');
 
       const transactionElseIfBranch = new TransactionBuilder({ provider })
         .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_final_require_in_if_statement(2n))
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transactionElseIfBranch).toFailRequireWith('Test.cash:46 Require statement failed at input 0 in contract Test.cash at line 46 with the following message: 1 should equal 3.');
-      await expect(transactionElseIfBranch).toFailRequireWith('Failing statement: require(1 == b, "1 should equal 3")');
+      expect(transactionElseIfBranch).toFailRequireWith('Test.cash:46 Require statement failed at input 0 in contract Test.cash at line 46 with the following message: 1 should equal 3.');
+      expect(transactionElseIfBranch).toFailRequireWith('Failing statement: require(1 == b, "1 should equal 3")');
 
       const transactionElseBranch = new TransactionBuilder({ provider })
         .addInput(contractTestRequiresUtxo, contractTestRequires.unlock.test_final_require_in_if_statement(3n))
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transactionElseBranch).toFailRequireWith('Test.cash:49 Require statement failed at input 0 in contract Test.cash at line 49 with the following message: switch should equal 4.');
-      await expect(transactionElseBranch).toFailRequireWith('Failing statement: require(switch == c, "switch should equal 4")');
+      expect(transactionElseBranch).toFailRequireWith('Test.cash:49 Require statement failed at input 0 in contract Test.cash at line 49 with the following message: switch should equal 4.');
+      expect(transactionElseBranch).toFailRequireWith('Failing statement: require(switch == c, "switch should equal 4")');
     });
 
     // test_final_require_in_if_statement_with_deep_reassignment
@@ -264,8 +264,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:62 Require statement failed at input 0 in contract Test.cash at line 62 with the following message: sum should equal 10.');
-      await expect(transaction).toFailRequireWith('Failing statement: require(a + b + c + d + e == 10, "sum should equal 10")');
+      expect(transaction).toFailRequireWith('Test.cash:62 Require statement failed at input 0 in contract Test.cash at line 62 with the following message: sum should equal 10.');
+      expect(transaction).toFailRequireWith('Failing statement: require(a + b + c + d + e == 10, "sum should equal 10")');
     });
 
     // test_fail_checksig
@@ -277,8 +277,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(checkSigTransaction).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
-      await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
+      expect(checkSigTransaction).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
+      expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
 
       const checkSigTransactionNullSignature = new TransactionBuilder({ provider })
         .addInput(
@@ -287,8 +287,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(checkSigTransactionNullSignature).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
-      await expect(checkSigTransactionNullSignature).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
+      expect(checkSigTransactionNullSignature).toFailRequireWith('Test.cash:77 Require statement failed at input 0 in contract Test.cash at line 77 with the following message: Signatures do not match.');
+      expect(checkSigTransactionNullSignature).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
     });
 
     // test_fail_checksig_final_verify
@@ -300,8 +300,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(checkSigTransaction).toFailRequireWith('Test.cash:82 Require statement failed at input 0 in contract Test.cash at line 82 with the following message: Signatures do not match.');
-      await expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
+      expect(checkSigTransaction).toFailRequireWith('Test.cash:82 Require statement failed at input 0 in contract Test.cash at line 82 with the following message: Signatures do not match.');
+      expect(checkSigTransaction).toFailRequireWith('Failing statement: require(checkSig(s, pk), "Signatures do not match")');
     });
 
     // test_fail_checkdatasig
@@ -313,8 +313,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(checkDataSigTransaction).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
-      await expect(checkDataSigTransaction).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
+      expect(checkDataSigTransaction).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
+      expect(checkDataSigTransaction).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
 
       const checkDataSigTransactionWrongMessage = new TransactionBuilder({ provider })
         .addInput(
@@ -323,8 +323,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
-      await expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
+      expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Test.cash:86 Require statement failed at input 0 in contract Test.cash at line 86 with the following message: Data Signatures do not match.');
+      expect(checkDataSigTransactionWrongMessage).toFailRequireWith('Failing statement: require(checkDataSig(s, message, pk), "Data Signatures do not match")');
     });
 
     // test_fail_checkmultisig
@@ -341,8 +341,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(checkmultiSigTransaction).toFailRequireWith('Test.cash:90 Require statement failed at input 0 in contract Test.cash at line 90 with the following message: Multi Signatures do not match.');
-      await expect(checkmultiSigTransaction).toFailRequireWith('Failing statement: require(checkMultiSig([s1, s2], [pk1, pk2]), "Multi Signatures do not match")');
+      expect(checkmultiSigTransaction).toFailRequireWith('Test.cash:90 Require statement failed at input 0 in contract Test.cash at line 90 with the following message: Multi Signatures do not match.');
+      expect(checkmultiSigTransaction).toFailRequireWith('Failing statement: require(checkMultiSig([s1, s2], [pk1, pk2]), "Multi Signatures do not match")');
     });
 
     // test_fail_large_cleanup
@@ -354,8 +354,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:22 Require statement failed at input 0 in contract Test.cash at line 22 with the following message: 1 should equal 2.');
-      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
+      expect(transaction).toFailRequireWith('Test.cash:22 Require statement failed at input 0 in contract Test.cash at line 22 with the following message: 1 should equal 2.');
+      expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
     });
 
     // test_fail_multiline_require
@@ -367,8 +367,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:26 Require statement failed at input 0 in contract Test.cash at line 26 with the following message: 1 should equal 2.');
-      await expect(transaction).toFailRequireWith(`Failing statement: require(
+      expect(transaction).toFailRequireWith('Test.cash:26 Require statement failed at input 0 in contract Test.cash at line 26 with the following message: 1 should equal 2.');
+      expect(transaction).toFailRequireWith(`Failing statement: require(
       1 == 2,
       "1 should equal 2"
     );`);
@@ -383,8 +383,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:36 Require statement failed at input 0 in contract Test.cash at line 36 with the following message: 1 should equal 2.');
-      await expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
+      expect(transaction).toFailRequireWith('Test.cash:36 Require statement failed at input 0 in contract Test.cash at line 36 with the following message: 1 should equal 2.');
+      expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
     });
 
     // test_multiline_require_with_unary_op
@@ -397,8 +397,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:51 Require statement failed at input 0 in contract Test.cash at line 51.');
-      await expect(transaction).toFailRequireWith(`Failing statement: require(
+      expect(transaction).toFailRequireWith('Test.cash:51 Require statement failed at input 0 in contract Test.cash at line 51.');
+      expect(transaction).toFailRequireWith(`Failing statement: require(
       !(
         0x000000
         .reverse()
@@ -422,8 +422,8 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      await expect(transaction).toFailRequireWith('Test.cash:69 Require statement failed at input 0 in contract Test.cash at line 69.');
-      await expect(transaction).toFailRequireWith(`Failing statement: require(
+      expect(transaction).toFailRequireWith('Test.cash:69 Require statement failed at input 0 in contract Test.cash at line 69.');
+      expect(transaction).toFailRequireWith(`Failing statement: require(
       new LockingBytecodeP2PKH(
         hash160(0x000000)
       )
@@ -449,49 +449,46 @@ describe('Debugging tests', () => {
 
     // test_invalid_split_range
     it('should fail with correct error message when an invalid OP_SPLIT range is used', async () => {
-      const transactionPromise = new TransactionBuilder({ provider })
+      const transaction = new TransactionBuilder({ provider })
         .addInput(
           contractTestRequiresUtxo,
           contractTestRequires.unlock.test_invalid_split_range(),
         )
-        .addOutput({ to: contractTestRequires.address, amount: 1000n })
-        .debug();
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transactionPromise).rejects.toThrow('Test.cash:68 Error in transaction at input 0 in contract Test.cash at line 68.');
-      await expect(transactionPromise).rejects.toThrow('Failing statement: test.split(4)');
-      await expect(transactionPromise).rejects.toThrow(`Reason: ${AuthenticationErrorCommon.invalidSplitIndex}`);
+      expect(() => transaction.debug()).toThrow('Test.cash:68 Error in transaction at input 0 in contract Test.cash at line 68.');
+      expect(() => transaction.debug()).toThrow('Failing statement: test.split(4)');
+      expect(() => transaction.debug()).toThrow(`Reason: ${AuthenticationErrorCommon.invalidSplitIndex}`);
     });
 
     // test_invalid_input_index
     it('should fail with correct error message when an invalid input index is used', async () => {
-      const transactionPromise = new TransactionBuilder({ provider })
+      const transaction = new TransactionBuilder({ provider })
         .addInput(
           contractTestRequiresUtxo,
           contractTestRequires.unlock.test_invalid_input_index(),
         )
-        .addOutput({ to: contractTestRequires.address, amount: 1000n })
-        .debug();
+        .addOutput({ to: contractTestRequires.address, amount: 1000n });
 
-      await expect(transactionPromise).rejects.toThrow('Test.cash:73 Error in transaction at input 0 in contract Test.cash at line 73.');
-      await expect(transactionPromise).rejects.toThrow('Failing statement: tx.inputs[5].value');
-      await expect(transactionPromise).rejects.toThrow(`Reason: ${AuthenticationErrorCommon.invalidTransactionUtxoIndex}`);
+      expect(() => transaction.debug()).toThrow('Test.cash:73 Error in transaction at input 0 in contract Test.cash at line 73.');
+      expect(() => transaction.debug()).toThrow('Failing statement: tx.inputs[5].value');
+      expect(() => transaction.debug()).toThrow(`Reason: ${AuthenticationErrorCommon.invalidTransactionUtxoIndex}`);
     });
 
     // test_multiline_non_require_error
     it('should fail with correct error message and statement when a multiline non-require statement fails', async () => {
-      const transactionPromise = new TransactionBuilder({ provider })
+      const transaction = new TransactionBuilder({ provider })
         .addInput(
           contractTestMultiLineRequiresUtxo,
           contractTestMultiLineRequires.unlock.test_multiline_non_require_error(),
         )
-        .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n })
-        .debug();
+        .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      await expect(transactionPromise).rejects.toThrow('Test.cash:43 Error in transaction at input 0 in contract Test.cash at line 43.');
-      await expect(transactionPromise).rejects.toThrow(`Failing statement: tx.outputs[
+      expect(() => transaction.debug()).toThrow('Test.cash:43 Error in transaction at input 0 in contract Test.cash at line 43.');
+      expect(() => transaction.debug()).toThrow(`Failing statement: tx.outputs[
         5
       ].value`);
-      await expect(transactionPromise).rejects.toThrow(`Reason: ${AuthenticationErrorCommon.invalidTransactionOutputIndex}`);
+      expect(() => transaction.debug()).toThrow(`Reason: ${AuthenticationErrorCommon.invalidTransactionOutputIndex}`);
     });
   });
 
@@ -508,7 +505,7 @@ describe('Debugging tests', () => {
         .addInput(contractUtxo, contract.unlock.test_zero_handling(0n))
         .addOutput({ to: contract.address, amount: 1000n });
 
-      await expect(transaction).not.toFailRequire();
+      expect(transaction).not.toFailRequire();
     });
   });
 
@@ -528,10 +525,9 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
-      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
-      await expect(
-        expect(transaction).toLog('^This is definitely not the log$'),
-      ).rejects.toThrow(/Expected: .*This is definitely not the log.*\nReceived: (.|\n)*?Test.cash:4 Hello World/);
+      expect(
+        () => expect(transaction).toLog('^This is definitely not the log$'),
+      ).toThrow(/Expected: .*This is definitely not the log.*\nReceived: (.|\n)*?Test.cash:4 Hello World/);
     });
 
     it('should fail the JestExtensions test if a log is logged that is NOT expected', async () => {
@@ -542,14 +538,13 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
-      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
-      await expect(
-        expect(transaction).not.toLog('^Test.cash:4 Hello World$'),
-      ).rejects.toThrow(/Expected: not .*Test.cash:4 Hello World.*\nReceived: (.|\n)*?Test.cash:4 Hello World/);
+      expect(
+        () => expect(transaction).not.toLog('^Test.cash:4 Hello World$'),
+      ).toThrow(/Expected: not .*Test.cash:4 Hello World.*\nReceived: (.|\n)*?Test.cash:4 Hello World/);
 
-      await expect(
-        expect(transaction).not.toLog(),
-      ).rejects.toThrow(/Expected: not .*undefined.*\nReceived: (.|\n)*?Test.cash:4 Hello World/);
+      expect(
+        () => expect(transaction).not.toLog(),
+      ).toThrow(/Expected: not .*undefined.*\nReceived: (.|\n)*?Test.cash:4 Hello World/);
     });
 
     it('should fail the JestExtensions test if a log is expected where no log is logged', async () => {
@@ -560,10 +555,9 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
-      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
-      await expect(
-        expect(transaction).toLog('Hello World'),
-      ).rejects.toThrow(/Expected: .*Hello World.*\nReceived: (.|\n)*?undefined/);
+      expect(
+        () => expect(transaction).toLog('Hello World'),
+      ).toThrow(/Expected: .*Hello World.*\nReceived: (.|\n)*?undefined/);
     });
 
     it('should fail the JestExtensions test if an incorrect require error message is expected', async () => {
@@ -574,10 +568,9 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
-      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
-      await expect(
-        expect(transaction).toFailRequireWith('1 should equal 3'),
-      ).rejects.toThrow(/Expected pattern: .*1 should equal 3.*\nReceived string: (.|\n)*?1 should equal 2/);
+      expect(
+        () => expect(transaction).toFailRequireWith('1 should equal 3'),
+      ).toThrow(/Expected pattern: .*1 should equal 3.*\nReceived string: (.|\n)*?1 should equal 2/);
     });
 
     it('should fail the JestExtensions test if a require error message is expected where no error is thrown', async () => {
@@ -588,10 +581,9 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
-      // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
-      await expect(
-        expect(transaction).toFailRequireWith('1 should equal 3'),
-      ).rejects.toThrow(/Contract function did not fail a require statement/);
+      expect(
+        () => expect(transaction).toFailRequireWith('1 should equal 3'),
+      ).toThrow(/Contract function did not fail a require statement/);
     });
 
     it('should fail the JestExtensions test if an error is thrown where it is NOT expected', async () => {
@@ -602,14 +594,30 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestRequires.address, amount: 10000n });
 
+      expect(
+        () => expect(transaction).not.toFailRequireWith('1 should equal 2'),
+      ).toThrow(/Expected pattern: not .*1 should equal 2.*\nReceived string: (.|\n)*?1 should equal 2/);
+
+      expect(
+        () => expect(transaction).not.toFailRequire(),
+      ).toThrow(/Contract function failed a require statement\.*\nReceived string: (.|\n)*?1 should equal 2/);
+    });
+
+    it('should throw an error if the old transaction builder is used', async () => {
+      const transaction = contractTestRequires.functions.test_require().to(aliceAddress, 1000n);
+
       // Note: We're wrapping the expect call in another expect, since we expect the inner expect to throw
-      await expect(
-        expect(transaction).not.toFailRequireWith('1 should equal 2'),
-      ).rejects.toThrow(/Expected pattern: not .*1 should equal 2.*\nReceived string: (.|\n)*?1 should equal 2/);
+      expect(
+        () => expect(transaction).toFailRequire(),
+      ).toThrow('The CashScript JestExtensions do not support the old transaction builder since v0.11.0. Please use the new TransactionBuilder class.');
+
+      expect(
+        () => expect(transaction).toFailRequireWith('1 should equal 2'),
+      ).toThrow('The CashScript JestExtensions do not support the old transaction builder since v0.11.0. Please use the new TransactionBuilder class.');
 
-      await expect(
-        expect(transaction).not.toFailRequire(),
-      ).rejects.toThrow(/Contract function failed a require statement\.*\nReceived string: (.|\n)*?1 should equal 2/);
+      expect(
+        () => expect(transaction).toLog('Hello World'),
+      ).toThrow('The CashScript JestExtensions do not support the old transaction builder since v0.11.0. Please use the new TransactionBuilder class.');
     });
   });
 });
diff --git a/website/docs/sdk/testing-setup.md b/website/docs/sdk/testing-setup.md
index 6eac6b57..f627c73c 100644
--- a/website/docs/sdk/testing-setup.md
+++ b/website/docs/sdk/testing-setup.md
@@ -62,7 +62,7 @@ describe('Example contract', () => {
     const transaction = new TransactionBuilder({ provider })
       .addInput(contractUtxo, contract.unlock.exampleFunction(1000n))
       .addOutput({ to: contract.address, amount: 10000n })
-    await expect(transaction).toLog('passed parameter: 1000');
+    expect(transaction).toLog('passed parameter: 1000');
   });
 });
 ```
@@ -85,14 +85,14 @@ describe('Example contract', () => {
     const transaction = new TransactionBuilder({ provider })
       .addInput(contractUtxo, contract.unlock.exampleFunction(999n))
       .addOutput({ to: contract.address, amount: 10000n })
-    await expect(transaction).toFailRequireWith('passed parameter is not 1000');
+    expect(transaction).toFailRequireWith('passed parameter is not 1000');
   });
 
   it('should pass require statement when correct parameter is passed', async () => {
     const transaction = new TransactionBuilder({ provider })
       .addInput(contractUtxo, contract.unlock.exampleFunction(999n))
       .addOutput({ to: contract.address, amount: 10000n })
-    await expect(transaction).not.toFailRequire();
+    expect(transaction).not.toFailRequire();
   });
 });
 ```
@@ -122,21 +122,21 @@ describe('Example contract', () => {
     const transaction = new TransactionBuilder({ provider })
       .addInput(contractUtxo, contract.unlock.exampleFunction(1000n))
       .addOutput({ to: contract.address, amount: 10000n })
-    await expect(transaction).toLog('passed parameter: 1000');
+    expect(transaction).toLog('passed parameter: 1000');
   });
 
   it('should fail require statement when incorrect parameter is passed', async () => {
     const transaction = new TransactionBuilder({ provider })
       .addInput(contractUtxo, contract.unlock.exampleFunction(999n))
       .addOutput({ to: contract.address, amount: 10000n })
-    await expect(transaction).toFailRequireWith('passed parameter is not 1000');
+    expect(transaction).toFailRequireWith('passed parameter is not 1000');
   });
 
   it('should pass require statement when correct parameter is passed', async () => {
     const transaction = new TransactionBuilder({ provider })
       .addInput(contractUtxo, contract.unlock.exampleFunction(1000n))
       .addOutput({ to: contract.address, amount: 10000n })
-    await expect(transaction).not.toFailRequire();
+    expect(transaction).not.toFailRequire();
   });
 });
 
diff --git a/website/docs/sdk/transaction-builder.md b/website/docs/sdk/transaction-builder.md
index 64b1d23b..2b4a06ba 100644
--- a/website/docs/sdk/transaction-builder.md
+++ b/website/docs/sdk/transaction-builder.md
@@ -233,7 +233,7 @@ const txHex = new TransactionBuilder({ provider })
 
 ### debug()
 ```ts
-async transactionBuilder.debug(): Promise<DebugResult>
+transactionBuilder.debug(): DebugResult
 ```
 
 If you want to debug a transaction locally instead of sending it to the network, you can call the `debug()` function on the transaction. This will return intermediate values and the final result of the transaction. It will also show any logged values and `require` error messages.

From a11cd26216090fe39af18c8301893a63f7180143 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Wed, 21 May 2025 15:50:08 +0200
Subject: [PATCH 247/267] docs improvements

---
 website/docs/basics/about-bch.md   | 14 ++++++++++++--
 website/docs/compiler/artifacts.md | 11 +++++++++--
 website/docs/language/examples.md  |  2 +-
 3 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/website/docs/basics/about-bch.md b/website/docs/basics/about-bch.md
index b490c558..083b266a 100644
--- a/website/docs/basics/about-bch.md
+++ b/website/docs/basics/about-bch.md
@@ -5,12 +5,18 @@ sidebar_label: About Bitcoin Cash
 
 Bitcoin Cash (ticker BCH) is one of the biggest cryptocurrencies. Bitcoin Cash is a fork of Bitcoin started in 2017 because of differences in vision for the future of the Bitcoin project.
 
-Bitcoin Cash shares many of the same fundamentals as Bitcoin (BTC) like the *Proof-of-Work* consensus algorithm and the *UTXO data-model*. However regarding smart contract programmability, Bitcoin Cash has significantly diverged from Bitcoin (BTC). We will first cover the UTXO data model and then delve into the smart contract capabilities of Bitcoin Cash.
+Bitcoin Cash shares many of the same fundamentals as Bitcoin (BTC) like the *Proof-of-Work* consensus algorithm and the *UTXO data-model*. However regarding smart contract programmability, Bitcoin Cash has significantly diverged from Bitcoin (BTC). We will go over the main differences between BCH and BTC, and then delve into the smart contract capabilities of Bitcoin Cash!
 
 :::info
-To learn more about the Bitcoin Basics refer to the book ['Mastering Bitcoin'](https://github.com/bitcoinbook/bitcoinbook). There is also a modified version for BCH specifically called ['Mastering Bitcoin Cash'](https://github.com/Bitcoin-com/mastering-bitcoin-cash).
+To learn more about the Bitcoin Basics refer to the book ['Mastering Bitcoin'](https://github.com/bitcoinbook/bitcoinbook). The core of Bitcoin's design is still very much the same in Bitcoin Cash.
 :::
 
+## How BCH differs from BTC
+
+Although BCH and BTC share the same Bitcoin fundamentals, both projects have significantly diverged in some ereas since 2017. For example, Bitcoin Cash does not have Segwit or Taproot, instead Bitcoin Cash has had multiple upgrades specifically focused on improving the smart contract capabilities. Bitcoin Cash has re-enabled many useful opcodes, has introduce native introspection, has added CashTokens, has reworked the script limits and introduced BigInts.
+
+So part that **has** significantly diverged between BTC and BCH is the *virual machine* (VM), the environment in which smart contracts are evaluated. So the greatly improved VM specifically is what makes it possible to write powerful smart contracts on BCH in the first place!
+
 ## UTXO model
 Bitcoin Cash transactions work with in- and outputs. All current balances are so called *Unspent Transaction Outputs (UTXOs)*, which simply means they can be used as inputs for future spending transactions.
 
@@ -45,3 +51,7 @@ The locking and unlocking scripts of regular transactions and smart contracts on
 CashScript is a high-level programming language for smart contracts on Bitcoin Cash that offers a strong abstraction for a smoother development experience. CashScript fully abstracts the management of items on the 'stack' from developers, allowing them to focus on their application logic instead of low-level details.
 
 The CashScript syntax is based on Ethereum's smart contract language Solidity, but its functionality is very different since smart contracts on Bitcoin Cash differ greatly from smart contracts on Ethereum.
+
+:::info
+Bitcoin's "Local State" versus Ethereum's "Global State" requires a very different mental model and way to structure smart contract applications!
+:::
diff --git a/website/docs/compiler/artifacts.md b/website/docs/compiler/artifacts.md
index 3db42ff4..f6a3b144 100644
--- a/website/docs/compiler/artifacts.md
+++ b/website/docs/compiler/artifacts.md
@@ -42,10 +42,17 @@ interface AbiFunction {
 interface LogEntry {
   ip: number; // instruction pointer
   line: number; // line in the source code
-  data: Array<{ stackIndex: number, type: string } | string>; // data to be logged
+  data: Array<StackItem | string>; // data to be logged
 }
 
-interface RequireMessage {
+interface StackItem {
+  type: string; // Type of the variable
+  stackIndex: number; // Index of the variable on the stack
+  ip: number; // Instruction pointer at which we can access the logged variable
+  transformations?: string; // Transformations needed to obtain the logged item
+}
+
+interface RequireStatement {
   ip: number; // instruction pointer
   line: number; // line in the source code
   message: string; // custom message for failing `require` statement
diff --git a/website/docs/language/examples.md b/website/docs/language/examples.md
index a84c1391..434f2981 100644
--- a/website/docs/language/examples.md
+++ b/website/docs/language/examples.md
@@ -135,6 +135,6 @@ contract DexContract(bytes20 poolOwnerPkh) {
 }
 ```
 
-Compared to the manually written and hand-optimized opcodes version of the contract, the CashScript compiled bytecode has just 5 extra opcodes overhead (7 extra bytes). Furthermore, even contracts with hand-optimized bytecode can still be used with the CashScript SDK, [find out more in the optimization guide][/docs/guides/optimization#hand-optimizing-bytecode].
+Compared to the manually written and hand-optimized opcodes version of the contract, the CashScript compiled bytecode has just 5 extra opcodes overhead (7 extra bytes). Furthermore, even contracts with hand-optimized bytecode can still be used with the CashScript SDK, [find out more in the optimization guide](/docs/guides/optimization#hand-optimizing-bytecode).
 
 More advanced examples on covenants, using NFTs to keep local state and issuing NFTs as receipts can be found in the [Covenants & Introspection Guide](/docs/guides/covenants).

From 8138d017c2aa9a098b5487887e127d6034913c27 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 26 May 2025 16:11:18 +0200
Subject: [PATCH 248/267] Update fixtures after sourcemap optimisations

---
 .../test/fixture/libauth-template/fixtures.ts | 16 ++++++++--------
 .../multi-contract-fixtures.ts                | 19 ++++++++++---------
 .../fixture/libauth-template/old-fixtures.ts  | 16 ++++++++--------
 .../libauth-template/LibauthTemplate.test.ts  |  8 ++++----
 .../LibauthTemplateMultiContract.test.ts      |  4 ++--
 5 files changed, 32 insertions(+), 31 deletions(-)

diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index f8cdf04f..5f843938 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -85,7 +85,7 @@ export const fixtures: Fixture[] = [
         'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
-          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
         },
       },
       'scenarios': {
@@ -219,7 +219,7 @@ export const fixtures: Fixture[] = [
         'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
-          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
         },
       },
       'scenarios': {
@@ -352,7 +352,7 @@ export const fixtures: Fixture[] = [
         'Mecenas_lock': {
           'lockingType': 'p2sh32',
           'name': 'Mecenas',
-          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(this.age >= period);                                                                            */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
+          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                               /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                               /*                                                                                                                    */\n                                                                               /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                               /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                               /*  * of covenants in CashScript.                                                                                     */\n                                                                               /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                               /*  *\\/                                                                                                               */\n                                                                               /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                            /*     function receive() {                                                                                           */\n                                                                               /*         // require(this.age >= period);                                                                            */\n                                                                               /*                                                                                                                    */\n                                                                               /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_ROT OP_CAT <0x88ac> OP_CAT OP_EQUALVERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                               /*                                                                                                                    */\n<0xe803>                                                                       /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                     /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                 /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                               /*                                                                                                                    */\n                                                                               /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                               /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF               /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY                  /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                        /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY                             /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY            /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY                                  /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                       /*         }                                                                                                          */\nOP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE                                        /*     }                                                                                                              */\n                                                                               /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY                                            /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_2SWAP OP_CHECKSIG                                                           /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                  /*     }                                                                                                              */\nOP_ENDIF                                                                       /* }                                                                                                                  */\n                                                                               /*                                                                                                                    */",
         },
       },
       'scenarios': {
@@ -508,7 +508,7 @@ export const fixtures: Fixture[] = [
         'P2PKH_lock': {
           'lockingType': 'p2sh32',
           'name': 'P2PKH',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
         },
         'P2PKH_spend_input1_unlock': {
           'passes': [
@@ -768,7 +768,7 @@ export const fixtures: Fixture[] = [
         'P2PKH_lock': {
           'lockingType': 'p2sh32',
           'name': 'P2PKH',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
         },
       },
       'scenarios': {
@@ -917,7 +917,7 @@ export const fixtures: Fixture[] = [
         'P2PKH_lock': {
           'lockingType': 'p2sh32',
           'name': 'P2PKH',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
         },
         'P2PKH_spend_input1_unlock': {
           'passes': [
@@ -1217,7 +1217,7 @@ export const fixtures: Fixture[] = [
         'HodlVault_lock': {
           'lockingType': 'p2sh32',
           'name': 'HodlVault',
-          'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
+          'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                             /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                             /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                             /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                             /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                             /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                             /* contract HodlVault(                                                                                                    */\n                                                             /*     pubkey ownerPk,                                                                                                    */\n                                                             /*     pubkey oraclePk,                                                                                                   */\n                                                             /*     int minBlock,                                                                                                      */\n                                                             /*     int priceTarget                                                                                                    */\n                                                             /* ) {                                                                                                                    */\n                                                             /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                             /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                   /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_SWAP OP_BIN2NUM                                           /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_SWAP OP_BIN2NUM                                           /*         int price = int(priceBin);                                                                                     */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY         /*         require(blockHeight >= minBlock);                                                                              */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP                       /*         require(tx.time >= blockHeight);                                                                               */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that current price is at least priceTarget                                                            */\nOP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY                 /*         require(price >= priceTarget);                                                                                 */\n                                                             /*                                                                                                                        */\n                                                             /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_CHECKSIG                                                  /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                             /*     }                                                                                                                  */\n                                                             /* }                                                                                                                      */\n                                                             /*                                                                                                                        */',
         },
       },
       'scenarios': {
@@ -1406,7 +1406,7 @@ export const fixtures: Fixture[] = [
         'P2PKH_lock': {
           'lockingType': 'p2sh20',
           'name': 'P2PKH',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
         },
         'p2pkh_placeholder_unlock_0': {
           'name': 'P2PKH Unlock (input #0)',
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index f4442f36..32dd9e0d 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -220,7 +220,7 @@ export const fixtures: Fixture[] = [
         'Bar_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
-          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
+          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log('Bar 'execute' function called.'); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
         },
         'Bar_execute_input4_unlock': {
           'passes': [
@@ -241,7 +241,7 @@ export const fixtures: Fixture[] = [
         'Foo_lock': {
           'lockingType': 'p2sh32',
           'name': 'Foo',
-          'script': "// \"Foo\" contract constructor parameters\n<pkh_foo> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                                  */\n                                                        /*                                                              */\n                                                        /* contract Foo(bytes20 pkh_foo) {                              */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function execute(pubkey pk, sig s) {                     */\n                                                        /*         console.log('Foo 'execute' function called.');       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_foo);                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */",
+          'script': "// \"Foo\" contract constructor parameters\n<pkh_foo> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                                  */\n                                  /*                                                              */\n                                  /* contract Foo(bytes20 pkh_foo) {                              */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function execute(pubkey pk, sig s) {                     */\n                                  /*         console.log('Foo 'execute' function called.');       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_foo);                     */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */",
         },
         'Bar_funcB_input6_unlock': {
           'passes': [
@@ -895,7 +895,7 @@ export const fixtures: Fixture[] = [
                     'bytecode': {
                       'function_index': '1',
                       'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
-                  
+
                     },
                     'keys': {
                       'privateKeys': {},
@@ -1132,7 +1132,8 @@ export const fixtures: Fixture[] = [
                   'overrides': {
                     'bytecode': {
                       'pk': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
-                      'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0'                    },
+                      'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
+                    },
                     'keys': {
                       'privateKeys': {
                         's': '71080d8b52ec7b12adaec909ed54cd989b682ce2c35647eec219a16f5f90c528',
@@ -1332,7 +1333,7 @@ export const fixtures: Fixture[] = [
         'Bar_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
-          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
+          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log('Bar 'execute' function called.'); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
         },
       },
       'scenarios': {
@@ -1513,7 +1514,7 @@ export const fixtures: Fixture[] = [
         'HodlVault_lock': {
           'lockingType': 'p2sh32',
           'name': 'HodlVault',
-          'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
+          'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                             /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                             /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                             /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                             /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                             /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                             /* contract HodlVault(                                                                                                    */\n                                                             /*     pubkey ownerPk,                                                                                                    */\n                                                             /*     pubkey oraclePk,                                                                                                   */\n                                                             /*     int minBlock,                                                                                                      */\n                                                             /*     int priceTarget                                                                                                    */\n                                                             /* ) {                                                                                                                    */\n                                                             /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                             /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                   /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_SWAP OP_BIN2NUM                                           /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_SWAP OP_BIN2NUM                                           /*         int price = int(priceBin);                                                                                     */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY         /*         require(blockHeight >= minBlock);                                                                              */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP                       /*         require(tx.time >= blockHeight);                                                                               */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that current price is at least priceTarget                                                            */\nOP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY                 /*         require(price >= priceTarget);                                                                                 */\n                                                             /*                                                                                                                        */\n                                                             /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_CHECKSIG                                                  /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                             /*     }                                                                                                                  */\n                                                             /* }                                                                                                                      */\n                                                             /*                                                                                                                        */',
         },
         'TransferWithTimeout_timeout_input1_unlock': {
           'passes': [
@@ -1526,7 +1527,7 @@ export const fixtures: Fixture[] = [
         'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
-          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
         },
       },
       'scenarios': {
@@ -1905,7 +1906,7 @@ export const fixtures: Fixture[] = [
         'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
-          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
         },
         'TransferWithTimeout_timeout_input1_unlock': {
           'passes': [
@@ -2668,7 +2669,7 @@ export const fixtures: Fixture[] = [
         'Bar_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
-          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* pragma cashscript >=0.10.2;                            */\n                                                        /*                                                        */\n                                                        /* contract Bar(bytes20 pkh_bar) {                        */\nOP_1 OP_PICK OP_0 OP_NUMEQUAL OP_IF                     /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_PICK OP_1 OP_NUMEQUAL OP_IF                     /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL                                   /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE                                   /*     }                                                  */\n                                                        /*                                                        */\nOP_1 OP_ROLL OP_2 OP_NUMEQUAL OP_VERIFY                 /*     function execute(pubkey pk, sig s) {               */\n                                                        /*         console.log('Bar 'execute' function called.'); */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                      */\n                                                        /*     }                                                  */\nOP_ENDIF OP_ENDIF                                       /* }                                                      */\n                                                        /*                                                        */",
+          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log('Bar 'execute' function called.'); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
         },
         'Bar_execute_input1_unlock': {
           'passes': [
diff --git a/packages/cashscript/test/fixture/libauth-template/old-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/old-fixtures.ts
index 21ddb1e6..ed6ef42a 100644
--- a/packages/cashscript/test/fixture/libauth-template/old-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/old-fixtures.ts
@@ -85,7 +85,7 @@ export const fixtures: Fixture[] = [
         'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout_lock',
-          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
         },
       },
       'scenarios': {
@@ -209,7 +209,7 @@ export const fixtures: Fixture[] = [
         'TransferWithTimeout_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout_lock',
-          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                /* contract TransferWithTimeout(                                             */\n                                                /*     pubkey sender,                                                        */\n                                                /*     pubkey recipient,                                                     */\n                                                /*     int timeout                                                           */\n                                                /* ) {                                                                       */\n                                                /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF             /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_2 OP_ROLL OP_CHECKSIG           /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE                    /*     }                                                                     */\n                                                /*                                                                           */\n                                                /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY         /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG OP_VERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP     /*         require(tx.time >= timeout);                                      */\nOP_1 OP_NIP                                     /*     }                                                                     */\nOP_ENDIF                                        /* }                                                                         */\n                                                /*                                                                           */",
+          'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
         },
       },
       'scenarios': {
@@ -328,7 +328,7 @@ export const fixtures: Fixture[] = [
         'Mecenas_lock': {
           'lockingType': 'p2sh32',
           'name': 'Mecenas_lock',
-          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                                         /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                                         /*                                                                                                                    */\n                                                                                         /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                                         /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                                         /*  * of covenants in CashScript.                                                                                     */\n                                                                                         /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                                         /*  *\\/                                                                                                               */\n                                                                                         /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                                      /*     function receive() {                                                                                           */\n                                                                                         /*         // require(this.age >= period);                                                                            */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_2 OP_ROLL OP_CAT <0x88ac> OP_CAT OP_EQUAL OP_VERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                                         /*                                                                                                                    */\n<0xe803>                                                                                 /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                               /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_0 OP_PICK OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                     /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                                         /*                                                                                                                    */\n                                                                                         /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                                         /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_0 OP_PICK OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF                   /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2 OP_PICK OP_4 OP_PICK OP_SUB OP_NUMEQUAL OP_VERIFY               /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                                  /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUAL OP_VERIFY                  /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_1 OP_PICK OP_NUMEQUAL OP_VERIFY                                   /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                                 /*         }                                                                                                          */\nOP_1 OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_NIP OP_ELSE                                   /*     }                                                                                                              */\n                                                                                         /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUAL OP_VERIFY                                                  /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_2 OP_ROLL OP_EQUAL OP_VERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_3 OP_ROLL OP_3 OP_ROLL OP_CHECKSIG                                                    /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                            /*     }                                                                                                              */\nOP_ENDIF                                                                                 /* }                                                                                                                  */\n                                                                                         /*                                                                                                                    */",
+          'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                               /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                               /*                                                                                                                    */\n                                                                               /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                               /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                               /*  * of covenants in CashScript.                                                                                     */\n                                                                               /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                               /*  *\\/                                                                                                               */\n                                                                               /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                            /*     function receive() {                                                                                           */\n                                                                               /*         // require(this.age >= period);                                                                            */\n                                                                               /*                                                                                                                    */\n                                                                               /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_ROT OP_CAT <0x88ac> OP_CAT OP_EQUALVERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                               /*                                                                                                                    */\n<0xe803>                                                                       /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                     /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                 /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                               /*                                                                                                                    */\n                                                                               /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                               /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF               /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY                  /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                        /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY                             /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY            /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY                                  /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                       /*         }                                                                                                          */\nOP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE                                        /*     }                                                                                                              */\n                                                                               /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY                                            /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_2SWAP OP_CHECKSIG                                                           /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                  /*     }                                                                                                              */\nOP_ENDIF                                                                       /* }                                                                                                                  */\n                                                                               /*                                                                                                                    */",
         },
       },
       'scenarios': {
@@ -452,7 +452,7 @@ export const fixtures: Fixture[] = [
         'P2PKH_lock': {
           'lockingType': 'p2sh32',
           'name': 'P2PKH_lock',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
         },
       },
       'scenarios': {
@@ -592,7 +592,7 @@ export const fixtures: Fixture[] = [
         'P2PKH_lock': {
           'lockingType': 'p2sh32',
           'name': 'P2PKH_lock',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
         },
       },
       'scenarios': {
@@ -715,7 +715,7 @@ export const fixtures: Fixture[] = [
         'P2PKH_lock': {
           'lockingType': 'p2sh32',
           'name': 'P2PKH_lock',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
         },
       },
       'scenarios': {
@@ -883,7 +883,7 @@ export const fixtures: Fixture[] = [
         'HodlVault_lock': {
           'lockingType': 'p2sh32',
           'name': 'HodlVault_lock',
-          'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                                 /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                                 /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                                 /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                                 /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                                 /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                                 /* contract HodlVault(                                                                                                    */\n                                                                 /*     pubkey ownerPk,                                                                                                    */\n                                                                 /*     pubkey oraclePk,                                                                                                   */\n                                                                 /*     int minBlock,                                                                                                      */\n                                                                 /*     int priceTarget                                                                                                    */\n                                                                 /* ) {                                                                                                                    */\n                                                                 /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                                 /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                       /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_1 OP_ROLL OP_BIN2NUM                                          /*         int price = int(priceBin);                                                                                     */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_1 OP_PICK OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(blockHeight >= minBlock);                                                                              */\nOP_1 OP_ROLL OP_CHECKLOCKTIMEVERIFY OP_DROP                      /*         require(tx.time >= blockHeight);                                                                               */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Check that current price is at least priceTarget                                                            */\nOP_0 OP_ROLL OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY        /*         require(price >= priceTarget);                                                                                 */\n                                                                 /*                                                                                                                        */\n                                                                 /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIG OP_VERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                            /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                                 /*     }                                                                                                                  */\n                                                                 /* }                                                                                                                      */\n                                                                 /*                                                                                                                        */',
+          'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                             /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                             /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                             /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                             /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                             /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                             /* contract HodlVault(                                                                                                    */\n                                                             /*     pubkey ownerPk,                                                                                                    */\n                                                             /*     pubkey oraclePk,                                                                                                   */\n                                                             /*     int minBlock,                                                                                                      */\n                                                             /*     int priceTarget                                                                                                    */\n                                                             /* ) {                                                                                                                    */\n                                                             /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                             /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                   /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_SWAP OP_BIN2NUM                                           /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_SWAP OP_BIN2NUM                                           /*         int price = int(priceBin);                                                                                     */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY         /*         require(blockHeight >= minBlock);                                                                              */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP                       /*         require(tx.time >= blockHeight);                                                                               */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that current price is at least priceTarget                                                            */\nOP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY                 /*         require(price >= priceTarget);                                                                                 */\n                                                             /*                                                                                                                        */\n                                                             /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_CHECKSIG                                                  /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                             /*     }                                                                                                                  */\n                                                             /* }                                                                                                                      */\n                                                             /*                                                                                                                        */',
         },
       },
       'scenarios': {
@@ -1048,7 +1048,7 @@ export const fixtures: Fixture[] = [
         'P2PKH_lock': {
           'lockingType': 'p2sh20',
           'name': 'P2PKH_lock',
-          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                        /* contract P2PKH(bytes20 pkh) {                                */\n                                                        /*     // Require pk to match stored pkh and signature to match */\n                                                        /*     function spend(pubkey pk, sig s) {                       */\nOP_1 OP_PICK OP_HASH160 OP_1 OP_ROLL OP_EQUAL OP_VERIFY /*         require(hash160(pk) == pkh);                         */\nOP_1 OP_ROLL OP_1 OP_ROLL OP_CHECKSIG                   /*         require(checkSig(s, pk));                            */\n                                                        /*     }                                                        */\n                                                        /* }                                                            */\n                                                        /*                                                              */',
+          'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
         },
         'p2pkh_placeholder_unlock_0': {
           'name': 'p2pkh_placeholder_unlock_0',
diff --git a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
index 7abdb0e9..fce99dc7 100644
--- a/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
+++ b/packages/cashscript/test/libauth-template/LibauthTemplate.test.ts
@@ -5,8 +5,8 @@ describe('Libauth Template generation tests (single-contract)', () => {
   fixtures.forEach((fixture) => {
     it(`should generate a valid libauth template for ${fixture.name}`, () => {
       const generatedTemplate = fixture.transaction.getLibauthTemplate();
-      // console.log(JSON.stringify(generatedTemplate, null, 2));
-      // console.log(fixture.transaction.bitauthUri());
+      // console.warn(JSON.stringify(generatedTemplate, null, 2));
+      // console.warn(fixture.transaction.bitauthUri());
       expect(generatedTemplate).toEqual(fixture.template);
     });
   });
@@ -14,8 +14,8 @@ describe('Libauth Template generation tests (single-contract)', () => {
   oldFixtures.forEach((fixture) => {
     it(`should generate a valid libauth template for old-fixture ${fixture.name}`, async () => {
       const generatedTemplate = await fixture.transaction.getLibauthTemplate();
-      // console.log(JSON.stringify(generatedTemplate, null, 2));
-      // console.log(fixture.transaction.bitauthUri());
+      // console.warn(JSON.stringify(generatedTemplate, null, 2));
+      // console.warn(fixture.transaction.bitauthUri());
       expect(generatedTemplate).toEqual(fixture.template);
     });
   });
diff --git a/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts b/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts
index ee1e33a6..438c1b30 100644
--- a/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts
+++ b/packages/cashscript/test/libauth-template/LibauthTemplateMultiContract.test.ts
@@ -5,8 +5,8 @@ describe('Libauth Template generation tests (multi-contract)', () => {
     it(`should generate a valid libauth template for ${fixture.name}`, async () => {
       const builder = await fixture.transaction;
       const generatedTemplate = builder.getLibauthTemplate();
-      // console.log(builder.bitauthUri());
-      // console.log(JSON.stringify(generatedTemplate, null, 2));
+      // console.warn(JSON.stringify(generatedTemplate, null, 2));
+      // console.warn(builder.bitauthUri());
       expect(generatedTemplate).toEqual(fixture.template);
     });
   });

From 34f864777d64cbe249fce35c8ccbbc8506e09ab3 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 26 May 2025 16:41:23 +0200
Subject: [PATCH 249/267] Add 1 multicontract debugging test and fix a name
 collision bug

- Add a debugging test with 2 instances of the same contract with
  different constructor parameters
- Fix a bug where 2 instances of the same contract with different
  constructor parameters show as a single locking script in Bitauth
- Add a bunch of TODO debugging tests
- Update fixtures after changes
---
 .../src/advanced/LibauthTemplate.ts           |  70 +++++----
 packages/cashscript/test/debugging.test.ts    |   2 +
 .../multicontract_debugging_contracts.ts      |  15 ++
 .../test/fixture/libauth-template/fixtures.ts |  84 +++++-----
 .../multi-contract-fixtures.ts                | 148 +++++++++---------
 .../test/multi-contract-debugging.test.ts     |  55 ++++++-
 6 files changed, 222 insertions(+), 152 deletions(-)
 create mode 100644 packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts

diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index 72ccfa29..3a28fcd5 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -1,5 +1,6 @@
 import {
   binToHex,
+  decodeCashAddress,
   TransactionBch,
   WalletTemplate,
   WalletTemplateEntity,
@@ -21,7 +22,6 @@ import { EncodedConstructorArgument, EncodedFunctionArgument, encodeFunctionArgu
 import { Contract } from '../Contract.js';
 import { DebugResults, debugTemplate } from '../debugging.js';
 import {
-  AddressType,
   ContractUnlocker,
   UnlockableUtxo,
   Utxo,
@@ -82,26 +82,26 @@ export const generateTemplateEntitiesP2PKH = (
  *
  */
 export const generateTemplateEntitiesP2SH = (
-  artifact: Artifact,
+  contract: Contract,
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedFunctionArgument[],
   inputIndex: number,
 ): WalletTemplate['entities'] => {
   const entities = {
-    [artifact.contractName + '_input' + inputIndex + '_parameters']: {
+    [contract.artifact.contractName + '_input' + inputIndex + '_parameters']: {
       description: 'Contract creation and function parameters',
-      name: `${artifact.contractName} (input #${inputIndex})`,
+      name: `${contract.artifact.contractName} (input #${inputIndex})`,
       scripts: [
-        artifact.contractName + '_lock',
-        artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock',
+        getLockScriptName(contract),
+        getUnlockScriptName(contract, abiFunction, inputIndex),
       ],
-      variables: createWalletTemplateVariables(artifact, abiFunction, encodedFunctionArgs),
+      variables: createWalletTemplateVariables(contract.artifact, abiFunction, encodedFunctionArgs),
     },
   };
 
   // function_index is a special variable that indicates the function to execute
-  if (artifact.abi.length > 1) {
-    entities[artifact.contractName + '_input' + inputIndex + '_parameters'].variables.function_index = {
+  if (contract.artifact.abi.length > 1) {
+    entities[contract.artifact.contractName + '_input' + inputIndex + '_parameters'].variables.function_index = {
       description: 'Script function index to execute',
       name: 'function_index',
       type: 'WalletData',
@@ -186,20 +186,19 @@ export const generateTemplateScriptsP2PKH = (
  *
  */
 export const generateTemplateScriptsP2SH = (
-  artifact: Artifact,
-  addressType: AddressType,
+  contract: Contract,
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedFunctionArgument[],
   encodedConstructorArgs: EncodedConstructorArgument[],
   inputIndex: number,
 ): WalletTemplate['scripts'] => {
   // definition of locking scripts and unlocking scripts with their respective bytecode
-  const unlockingScriptName = artifact.contractName + '_' + abiFunction.name + '_input' + inputIndex + '_unlock';
-  const lockingScriptName = artifact.contractName + '_lock';
+  const unlockingScriptName = getUnlockScriptName(contract, abiFunction, inputIndex);
+  const lockingScriptName = getLockScriptName(contract);
 
   return {
-    [unlockingScriptName]: generateTemplateUnlockScript(artifact, abiFunction, encodedFunctionArgs, inputIndex),
-    [lockingScriptName]: generateTemplateLockScript(artifact, addressType, encodedConstructorArgs),
+    [unlockingScriptName]: generateTemplateUnlockScript(contract, abiFunction, encodedFunctionArgs, inputIndex),
+    [lockingScriptName]: generateTemplateLockScript(contract, encodedConstructorArgs),
   };
 };
 
@@ -211,19 +210,18 @@ export const generateTemplateScriptsP2SH = (
  *
  */
 const generateTemplateLockScript = (
-  artifact: Artifact,
-  addressType: AddressType,
+  contract: Contract,
   constructorArguments: EncodedFunctionArgument[],
 ): WalletTemplateScriptLocking => {
   return {
-    lockingType: addressType,
-    name: artifact.contractName,
+    lockingType: contract.addressType,
+    name: contract.artifact.contractName,
     script: [
-      `// "${artifact.contractName}" contract constructor parameters`,
-      formatParametersForDebugging(artifact.constructorInputs, constructorArguments),
+      `// "${contract.artifact.contractName}" contract constructor parameters`,
+      formatParametersForDebugging(contract.artifact.constructorInputs, constructorArguments),
       '',
       '// bytecode',
-      formatBytecodeForDebugging(artifact),
+      formatBytecodeForDebugging(contract.artifact),
     ].join('\n'),
   };
 };
@@ -236,15 +234,15 @@ const generateTemplateLockScript = (
  *
  */
 const generateTemplateUnlockScript = (
-  artifact: Artifact,
+  contract: Contract,
   abiFunction: AbiFunction,
   encodedFunctionArgs: EncodedFunctionArgument[],
   inputIndex: number,
 ): WalletTemplateScriptUnlocking => {
-  const scenarioIdentifier = `${artifact.contractName}_${abiFunction.name}_input${inputIndex}_evaluate`;
-  const functionIndex = artifact.abi.findIndex((func) => func.name === abiFunction.name);
+  const scenarioIdentifier = `${contract.artifact.contractName}_${abiFunction.name}_input${inputIndex}_evaluate`;
+  const functionIndex = contract.artifact.abi.findIndex((func) => func.name === abiFunction.name);
 
-  const functionIndexString = artifact.abi.length > 1
+  const functionIndexString = contract.artifact.abi.length > 1
     ? ['// function index in contract', `<function_index> // int = <${functionIndex}>`, '']
     : [];
 
@@ -258,7 +256,7 @@ const generateTemplateUnlockScript = (
       '',
       ...functionIndexString,
     ].join('\n'),
-    unlocks: artifact.contractName + '_lock',
+    unlocks: getLockScriptName(contract),
   };
 };
 
@@ -440,7 +438,7 @@ export const getLibauthTemplates = (
 
       // Generate entities for this contract input
       const entity = generateTemplateEntitiesP2SH(
-        contract.artifact,
+        contract,
         abiFunction,
         encodedArgs,
         inputIndex,
@@ -448,8 +446,7 @@ export const getLibauthTemplates = (
 
       // Generate scripts for this contract input
       const script = generateTemplateScriptsP2SH(
-        contract.artifact,
-        contract.addressType,
+        contract,
         abiFunction,
         encodedArgs,
         contract.encodedConstructorArgs,
@@ -590,7 +587,7 @@ export const generateUnlockingScriptParams = (
   const encodedFunctionArgs = encodeFunctionArguments(abiFunction, csInput.unlocker.params);
 
   return {
-    script: `${csInput.unlocker.contract.name}_${abiFunction.name}_input${inputIndex}_unlock`,
+    script: getUnlockScriptName(contract, abiFunction, inputIndex),
     overrides: {
       // encode values for the variables defined above in `entities` property
       bytecode: {
@@ -604,3 +601,14 @@ export const generateUnlockingScriptParams = (
     },
   };
 };
+
+const getLockScriptName = (contract: Contract): string => {
+  const result = decodeCashAddress(contract.address);
+  if (typeof result === 'string') throw new Error(result);
+
+  return `${contract.artifact.contractName}_${binToHex(result.payload)}_lock`;
+};
+
+const getUnlockScriptName = (contract: Contract, abiFunction: AbiFunction, inputIndex: number): string => {
+  return `${contract.artifact.contractName}_${abiFunction.name}_input${inputIndex}_unlock`;
+};
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 18c7ed48..82ed3508 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -142,6 +142,8 @@ describe('Debugging tests', () => {
       const expectedHash = binToHex(sha256(alicePub));
       expect(transaction).toLog(new RegExp(`^Test.cash:43 0x${expectedHash}$`));
     });
+
+    it.todo('intermediate results that is more complex than the test above');
   });
 
   describe('require statements', () => {
diff --git a/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts b/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts
new file mode 100644
index 00000000..aafa01c3
--- /dev/null
+++ b/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts
@@ -0,0 +1,15 @@
+import { compileString } from 'cashc';
+
+const SAME_NAME_DIFFERENT_PATH = `
+contract SameNameDifferentPath(int a) {
+  function function_1(int b) {
+    if (a == 0) {
+      require(b == 0, "b should be 0");
+    } else {
+      require(b != 0, "b should not be 0");
+    }
+  }
+}
+`;
+
+export const ARTIFACT_SAME_NAME_DIFFERENT_PATH = compileString(SAME_NAME_DIFFERENT_PATH);
diff --git a/packages/cashscript/test/fixture/libauth-template/fixtures.ts b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
index 5f843938..de27e2b3 100644
--- a/packages/cashscript/test/fixture/libauth-template/fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/fixtures.ts
@@ -41,7 +41,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #0)',
           'scripts': [
-            'TransferWithTimeout_lock',
+            'TransferWithTimeout_3f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b1_lock',
             'TransferWithTimeout_transfer_input0_unlock',
           ],
           'variables': {
@@ -80,9 +80,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'transfer (input #0)',
           'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'TransferWithTimeout_lock',
+          'unlocks': 'TransferWithTimeout_3f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b1_lock',
         },
-        'TransferWithTimeout_lock': {
+        'TransferWithTimeout_3f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b1_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
@@ -122,7 +122,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'TransferWithTimeout_lock',
+                  'script': 'TransferWithTimeout_3f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b1_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
@@ -175,7 +175,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #0)',
           'scripts': [
-            'TransferWithTimeout_lock',
+            'TransferWithTimeout_3f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b1_lock',
             'TransferWithTimeout_timeout_input0_unlock',
           ],
           'variables': {
@@ -214,9 +214,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'timeout (input #0)',
           'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'TransferWithTimeout_lock',
+          'unlocks': 'TransferWithTimeout_3f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b1_lock',
         },
-        'TransferWithTimeout_lock': {
+        'TransferWithTimeout_3f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b1_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<sender> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
@@ -256,7 +256,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'TransferWithTimeout_lock',
+                  'script': 'TransferWithTimeout_3f567c4556a3b1fe2d6dd250ee07a939c54f22ce4cb87fb0581800063eaca0b1_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
@@ -313,7 +313,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'Mecenas (input #0)',
           'scripts': [
-            'Mecenas_lock',
+            'Mecenas_9c6c87b192226fa02ed3834607a94a6ea040acc59df983c49a648406c695816b_lock',
             'Mecenas_receive_input0_unlock',
           ],
           'variables': {
@@ -347,9 +347,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'receive (input #0)',
           'script': '// "receive" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'Mecenas_lock',
+          'unlocks': 'Mecenas_9c6c87b192226fa02ed3834607a94a6ea040acc59df983c49a648406c695816b_lock',
         },
-        'Mecenas_lock': {
+        'Mecenas_9c6c87b192226fa02ed3834607a94a6ea040acc59df983c49a648406c695816b_lock': {
           'lockingType': 'p2sh32',
           'name': 'Mecenas',
           'script': "// \"Mecenas\" contract constructor parameters\n<pledge> // int = <0x1027>\n<funder> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n<recipient> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                                                               /* pragma cashscript >=0.8.0;                                                                                         */\n                                                                               /*                                                                                                                    */\n                                                                               /* \\/* This is an unofficial CashScript port of Licho's Mecenas contract. It is                                       */\n                                                                               /*  * not compatible with Licho's EC plugin, but rather meant as a demonstration                                      */\n                                                                               /*  * of covenants in CashScript.                                                                                     */\n                                                                               /*  * The time checking has been removed so it can be tested without time requirements.                               */\n                                                                               /*  *\\/                                                                                                               */\n                                                                               /* contract Mecenas(bytes20 recipient, bytes20 funder, int pledge\\/*, int period *\\/) {                               */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF                                            /*     function receive() {                                                                                           */\n                                                                               /*         // require(this.age >= period);                                                                            */\n                                                                               /*                                                                                                                    */\n                                                                               /*         // Check that the first output sends to the recipient                                                      */\nOP_0 OP_OUTPUTBYTECODE <0x76a914> OP_ROT OP_CAT <0x88ac> OP_CAT OP_EQUALVERIFY /*         require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));                             */\n                                                                               /*                                                                                                                    */\n<0xe803>                                                                       /*         int minerFee = 1000;                                                                                       */\nOP_INPUTINDEX OP_UTXOVALUE                                                     /*         int currentValue = tx.inputs[this.activeInputIndex].value;                                                 */\nOP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB                                 /*         int changeValue = currentValue - pledge - minerFee;                                                        */\n                                                                               /*                                                                                                                    */\n                                                                               /*         // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient */\n                                                                               /*         // Otherwise we send the remainder to the recipient and the change back to the contract                    */\nOP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF               /*         if (changeValue <= pledge + minerFee) {                                                                    */\nOP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY                  /*             require(tx.outputs[0].value == currentValue - minerFee);                                               */\nOP_ELSE                                                                        /*         } else {                                                                                                   */\nOP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY                             /*             require(tx.outputs[0].value == pledge);                                                                */\nOP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY            /*             require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);            */\nOP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY                                  /*             require(tx.outputs[1].value == changeValue);                                                           */\nOP_ENDIF                                                                       /*         }                                                                                                          */\nOP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE                                        /*     }                                                                                                              */\n                                                                               /*                                                                                                                    */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY                                            /*     function reclaim(pubkey pk, sig s) {                                                                           */\nOP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY                                  /*         require(hash160(pk) == funder);                                                                            */\nOP_2SWAP OP_CHECKSIG                                                           /*         require(checkSig(s, pk));                                                                                  */\nOP_NIP OP_NIP                                                                  /*     }                                                                                                              */\nOP_ENDIF                                                                       /* }                                                                                                                  */\n                                                                               /*                                                                                                                    */",
@@ -391,7 +391,7 @@ export const fixtures: Fixture[] = [
               },
               {
                 'lockingBytecode': {
-                  'script': 'Mecenas_lock',
+                  'script': 'Mecenas_9c6c87b192226fa02ed3834607a94a6ea040acc59df983c49a648406c695816b_lock',
                   'overrides': {
                     'bytecode': {
                       'recipient': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -449,7 +449,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #0)',
           'scripts': [
-            'P2PKH_lock',
+            'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
             'P2PKH_spend_input0_unlock',
           ],
           'variables': {
@@ -474,7 +474,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #1)',
           'scripts': [
-            'P2PKH_lock',
+            'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
             'P2PKH_spend_input1_unlock',
           ],
           'variables': {
@@ -503,9 +503,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'P2PKH_lock',
+          'unlocks': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
         },
-        'P2PKH_lock': {
+        'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock': {
           'lockingType': 'p2sh32',
           'name': 'P2PKH',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
@@ -516,7 +516,7 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'spend (input #1)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'P2PKH_lock',
+          'unlocks': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
         },
       },
       'scenarios': {
@@ -570,7 +570,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'P2PKH_lock',
+                  'script': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -595,7 +595,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'P2PKH_lock',
+                'script': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -660,7 +660,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'P2PKH_lock',
+                  'script': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -679,7 +679,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'P2PKH_lock',
+                'script': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -734,7 +734,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #0)',
           'scripts': [
-            'P2PKH_lock',
+            'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
             'P2PKH_spend_input0_unlock',
           ],
           'variables': {
@@ -763,9 +763,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<s> // sig = <0x65f72c5cce773383b45032a3f9f9255814e3d53ee260056e3232cd89e91a0a84278b35daf8938d47047e7d3bd3407fe90b07dfabf4407947af6fb09730a34c0b61>\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'P2PKH_lock',
+          'unlocks': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
         },
-        'P2PKH_lock': {
+        'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock': {
           'lockingType': 'p2sh32',
           'name': 'P2PKH',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
@@ -802,7 +802,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'P2PKH_lock',
+                  'script': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -858,7 +858,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #0)',
           'scripts': [
-            'P2PKH_lock',
+            'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
             'P2PKH_spend_input0_unlock',
           ],
           'variables': {
@@ -883,7 +883,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #1)',
           'scripts': [
-            'P2PKH_lock',
+            'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
             'P2PKH_spend_input1_unlock',
           ],
           'variables': {
@@ -912,9 +912,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'P2PKH_lock',
+          'unlocks': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
         },
-        'P2PKH_lock': {
+        'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock': {
           'lockingType': 'p2sh32',
           'name': 'P2PKH',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
@@ -925,7 +925,7 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'spend (input #1)',
           'script': '// "spend" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'P2PKH_lock',
+          'unlocks': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
         },
       },
       'scenarios': {
@@ -979,7 +979,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'P2PKH_lock',
+                  'script': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1008,7 +1008,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'P2PKH_lock',
+                'script': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1077,7 +1077,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'P2PKH_lock',
+                  'script': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1100,7 +1100,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'P2PKH_lock',
+                'script': 'P2PKH_34d9ffce86b4d136ca74e9db6f6433d3548966a6be064052e728a4c1d16aa3a5_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1163,7 +1163,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'HodlVault (input #0)',
           'scripts': [
-            'HodlVault_lock',
+            'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock',
             'HodlVault_spend_input0_unlock',
           ],
           'variables': {
@@ -1212,9 +1212,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<oracleMessage> // bytes8 = <0xa086010030750000>\n<oracleSig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<ownerSig.schnorr_signature.all_outputs_all_utxos> // sig\n',
-          'unlocks': 'HodlVault_lock',
+          'unlocks': 'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock',
         },
-        'HodlVault_lock': {
+        'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock': {
           'lockingType': 'p2sh32',
           'name': 'HodlVault',
           'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                             /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                             /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                             /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                             /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                             /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                             /* contract HodlVault(                                                                                                    */\n                                                             /*     pubkey ownerPk,                                                                                                    */\n                                                             /*     pubkey oraclePk,                                                                                                   */\n                                                             /*     int minBlock,                                                                                                      */\n                                                             /*     int priceTarget                                                                                                    */\n                                                             /* ) {                                                                                                                    */\n                                                             /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                             /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                   /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_SWAP OP_BIN2NUM                                           /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_SWAP OP_BIN2NUM                                           /*         int price = int(priceBin);                                                                                     */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY         /*         require(blockHeight >= minBlock);                                                                              */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP                       /*         require(tx.time >= blockHeight);                                                                               */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that current price is at least priceTarget                                                            */\nOP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY                 /*         require(price >= priceTarget);                                                                                 */\n                                                             /*                                                                                                                        */\n                                                             /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_CHECKSIG                                                  /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                             /*     }                                                                                                                  */\n                                                             /* }                                                                                                                      */\n                                                             /*                                                                                                                        */',
@@ -1256,7 +1256,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'HodlVault_lock',
+                  'script': 'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock',
                   'overrides': {
                     'bytecode': {
                       'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
@@ -1342,7 +1342,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'P2PKH (input #1)',
           'scripts': [
-            'P2PKH_lock',
+            'P2PKH_eae136efb95be487872bfe03984fc1eb80b23361_lock',
             'P2PKH_spend_input1_unlock',
           ],
           'variables': {
@@ -1401,9 +1401,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'spend (input #1)',
           'script': '// "spend" function parameters\n<s.ecdsa_signature.no_outputs> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n',
-          'unlocks': 'P2PKH_lock',
+          'unlocks': 'P2PKH_eae136efb95be487872bfe03984fc1eb80b23361_lock',
         },
-        'P2PKH_lock': {
+        'P2PKH_eae136efb95be487872bfe03984fc1eb80b23361_lock': {
           'lockingType': 'p2sh20',
           'name': 'P2PKH',
           'script': '// "P2PKH" contract constructor parameters\n<pkh> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* contract P2PKH(bytes20 pkh) {                                */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function spend(pubkey pk, sig s) {                       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh);                         */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */',
@@ -1491,7 +1491,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'P2PKH_lock',
+                  'script': 'P2PKH_eae136efb95be487872bfe03984fc1eb80b23361_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index 32dd9e0d..4b7296e7 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -71,7 +71,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #3)',
           'scripts': [
-            'Bar_lock',
+            'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
             'Bar_funcA_input3_unlock',
           ],
           'variables': {
@@ -91,7 +91,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #4)',
           'scripts': [
-            'Bar_lock',
+            'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
             'Bar_execute_input4_unlock',
           ],
           'variables': {
@@ -121,7 +121,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'Foo (input #5)',
           'scripts': [
-            'Foo_lock',
+            'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock',
             'Foo_execute_input5_unlock',
           ],
           'variables': {
@@ -146,7 +146,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #6)',
           'scripts': [
-            'Bar_lock',
+            'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
             'Bar_funcB_input6_unlock',
           ],
           'variables': {
@@ -215,9 +215,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'funcA (input #3)',
           'script': '// "funcA" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'Bar_lock',
+          'unlocks': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
         },
-        'Bar_lock': {
+        'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
           'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log('Bar 'execute' function called.'); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
@@ -228,7 +228,7 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'execute (input #4)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// function index in contract\n<function_index> // int = <2>\n',
-          'unlocks': 'Bar_lock',
+          'unlocks': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
         },
         'Foo_execute_input5_unlock': {
           'passes': [
@@ -236,9 +236,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'execute (input #5)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n',
-          'unlocks': 'Foo_lock',
+          'unlocks': 'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock',
         },
-        'Foo_lock': {
+        'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock': {
           'lockingType': 'p2sh32',
           'name': 'Foo',
           'script': "// \"Foo\" contract constructor parameters\n<pkh_foo> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                                  */\n                                  /*                                                              */\n                                  /* contract Foo(bytes20 pkh_foo) {                              */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function execute(pubkey pk, sig s) {                     */\n                                  /*         console.log('Foo 'execute' function called.');       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_foo);                     */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */",
@@ -249,7 +249,7 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'funcB (input #6)',
           'script': '// "funcB" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'Bar_lock',
+          'unlocks': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
         },
         'p2pkh_placeholder_unlock_0': {
           'name': 'P2PKH Unlock (input #0)',
@@ -413,7 +413,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'Foo_lock',
+                  'script': 'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -497,7 +497,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -508,7 +508,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Foo_lock',
+                'script': 'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -519,7 +519,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -661,7 +661,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'Foo_lock',
+                  'script': 'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -739,7 +739,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -756,7 +756,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Foo_lock',
+                'script': 'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -767,7 +767,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -909,7 +909,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'Foo_lock',
+                  'script': 'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -987,7 +987,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -998,7 +998,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1015,7 +1015,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1156,7 +1156,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'Foo_lock',
+                  'script': 'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -1234,7 +1234,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1245,7 +1245,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1256,7 +1256,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Foo_lock',
+                'script': 'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_foo': '0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0',
@@ -1304,7 +1304,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #0)',
           'scripts': [
-            'Bar_lock',
+            'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
             'Bar_funcA_input0_unlock',
           ],
           'variables': {
@@ -1328,9 +1328,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'funcA (input #0)',
           'script': '// "funcA" function parameters\n// none\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'Bar_lock',
+          'unlocks': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
         },
-        'Bar_lock': {
+        'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
           'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log('Bar 'execute' function called.'); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
@@ -1366,7 +1366,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'Bar_lock',
+                  'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -1425,7 +1425,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'HodlVault (input #0)',
           'scripts': [
-            'HodlVault_lock',
+            'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock',
             'HodlVault_spend_input0_unlock',
           ],
           'variables': {
@@ -1470,7 +1470,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #1)',
           'scripts': [
-            'TransferWithTimeout_lock',
+            'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
             'TransferWithTimeout_timeout_input1_unlock',
           ],
           'variables': {
@@ -1509,9 +1509,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'spend (input #0)',
           'script': '// "spend" function parameters\n<oracleMessage> // bytes8 = <0xa086010030750000>\n<oracleSig> // datasig = <0x569e137142ebdb96127b727787d605e427a858e8b17dc0605092d0019e5fc9d58810ee74c8ba9f9a5605268c9913e50f780f4c3780e06aea7f50766829895b4b>\n<ownerSig.schnorr_signature.all_outputs_all_utxos> // sig\n',
-          'unlocks': 'HodlVault_lock',
+          'unlocks': 'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock',
         },
-        'HodlVault_lock': {
+        'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock': {
           'lockingType': 'p2sh32',
           'name': 'HodlVault',
           'script': '// "HodlVault" contract constructor parameters\n<priceTarget> // int = <0x3075>\n<minBlock> // int = <0xb88201>\n<oraclePk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n<ownerPk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// bytecode\n                                                             /* // This contract forces HODLing until a certain price target has been reached                                          */\n                                                             /* // A minimum block is provided to ensure that oracle price entries from before this block are disregarded              */\n                                                             /* // i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used. */\n                                                             /* // Instead, a message with a block number and price from after the minBlock needs to be passed.                        */\n                                                             /* // This contract serves as a simple example for checkDataSig-based contracts.                                          */\n                                                             /* contract HodlVault(                                                                                                    */\n                                                             /*     pubkey ownerPk,                                                                                                    */\n                                                             /*     pubkey oraclePk,                                                                                                   */\n                                                             /*     int minBlock,                                                                                                      */\n                                                             /*     int priceTarget                                                                                                    */\n                                                             /* ) {                                                                                                                    */\n                                                             /*     function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {                                            */\n                                                             /*         // message: { blockHeight, price }                                                                             */\nOP_6 OP_PICK OP_4 OP_SPLIT                                   /*         bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);                                               */\nOP_SWAP OP_BIN2NUM                                           /*         int blockHeight = int(blockHeightBin);                                                                         */\nOP_SWAP OP_BIN2NUM                                           /*         int price = int(priceBin);                                                                                     */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that blockHeight is after minBlock and not in the future                                              */\nOP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY         /*         require(blockHeight >= minBlock);                                                                              */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP                       /*         require(tx.time >= blockHeight);                                                                               */\n                                                             /*                                                                                                                        */\n                                                             /*         // Check that current price is at least priceTarget                                                            */\nOP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY                 /*         require(price >= priceTarget);                                                                                 */\n                                                             /*                                                                                                                        */\n                                                             /*         // Handle necessary signature checks                                                                           */\nOP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY /*         require(checkDataSig(oracleSig, oracleMessage, oraclePk));                                                     */\nOP_CHECKSIG                                                  /*         require(checkSig(ownerSig, ownerPk));                                                                          */\n                                                             /*     }                                                                                                                  */\n                                                             /* }                                                                                                                      */\n                                                             /*                                                                                                                        */',
@@ -1522,9 +1522,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'timeout (input #1)',
           'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'TransferWithTimeout_lock',
+          'unlocks': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
         },
-        'TransferWithTimeout_lock': {
+        'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
@@ -1588,7 +1588,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'HodlVault_lock',
+                  'script': 'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock',
                   'overrides': {
                     'bytecode': {
                       'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
@@ -1612,7 +1612,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -1681,7 +1681,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'HodlVault_lock',
+                  'script': 'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock',
                   'overrides': {
                     'bytecode': {
                       'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
@@ -1699,7 +1699,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'HodlVault_lock',
+                'script': 'HodlVault_2b9369ac73606fc710cb756d82807e45e283bbf2a642df014bfce7a1c749c5e0_lock',
                 'overrides': {
                   'bytecode': {
                     'ownerPk': '0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088',
@@ -1757,7 +1757,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #0)',
           'scripts': [
-            'TransferWithTimeout_lock',
+            'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
             'TransferWithTimeout_timeout_input0_unlock',
           ],
           'variables': {
@@ -1792,7 +1792,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #1)',
           'scripts': [
-            'TransferWithTimeout_lock',
+            'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
             'TransferWithTimeout_timeout_input1_unlock',
           ],
           'variables': {
@@ -1827,7 +1827,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #2)',
           'scripts': [
-            'TransferWithTimeout_lock',
+            'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
             'TransferWithTimeout_transfer_input2_unlock',
           ],
           'variables': {
@@ -1862,7 +1862,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'TransferWithTimeout (input #3)',
           'scripts': [
-            'TransferWithTimeout_lock',
+            'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
             'TransferWithTimeout_transfer_input3_unlock',
           ],
           'variables': {
@@ -1901,9 +1901,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'timeout (input #0)',
           'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'TransferWithTimeout_lock',
+          'unlocks': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
         },
-        'TransferWithTimeout_lock': {
+        'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock': {
           'lockingType': 'p2sh32',
           'name': 'TransferWithTimeout',
           'script': "// \"TransferWithTimeout\" contract constructor parameters\n<timeout> // int = <0xa08601>\n<recipient> // pubkey = <0x0260e6133d3432b4555a387e5ed82c448019f0c0d39b5a6324c3a586c4c3590c90>\n<sender> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// bytecode\n                                       /* contract TransferWithTimeout(                                             */\n                                       /*     pubkey sender,                                                        */\n                                       /*     pubkey recipient,                                                     */\n                                       /*     int timeout                                                           */\n                                       /* ) {                                                                       */\n                                       /*     // Require recipient's signature to match                             */\nOP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF    /*     function transfer(sig recipientSig) {                                 */\nOP_4 OP_ROLL OP_ROT OP_CHECKSIG        /*         require(checkSig(recipientSig, recipient));                       */\nOP_NIP OP_NIP OP_NIP OP_ELSE           /*     }                                                                     */\n                                       /*                                                                           */\n                                       /*     // Require timeout time to be reached and sender's signature to match */\nOP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY    /*     function timeout(sig senderSig) {                                     */\nOP_3 OP_ROLL OP_SWAP OP_CHECKSIGVERIFY /*         require(checkSig(senderSig, sender));                             */\nOP_SWAP OP_CHECKLOCKTIMEVERIFY         /*         require(tx.time >= timeout);                                      */\nOP_2DROP OP_1                          /*     }                                                                     */\nOP_ENDIF                               /* }                                                                         */\n                                       /*                                                                           */",
@@ -1914,7 +1914,7 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'timeout (input #1)',
           'script': '// "timeout" function parameters\n<senderSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <1>\n',
-          'unlocks': 'TransferWithTimeout_lock',
+          'unlocks': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
         },
         'TransferWithTimeout_transfer_input2_unlock': {
           'passes': [
@@ -1922,7 +1922,7 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'transfer (input #2)',
           'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'TransferWithTimeout_lock',
+          'unlocks': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
         },
         'TransferWithTimeout_transfer_input3_unlock': {
           'passes': [
@@ -1930,7 +1930,7 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'transfer (input #3)',
           'script': '// "transfer" function parameters\n<recipientSig.schnorr_signature.all_outputs_all_utxos> // sig\n\n// function index in contract\n<function_index> // int = <0>\n',
-          'unlocks': 'TransferWithTimeout_lock',
+          'unlocks': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
         },
       },
       'scenarios': {
@@ -2030,7 +2030,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'TransferWithTimeout_lock',
+                  'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2053,7 +2053,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2066,7 +2066,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2079,7 +2079,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2188,7 +2188,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'TransferWithTimeout_lock',
+                  'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2205,7 +2205,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2224,7 +2224,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2237,7 +2237,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2346,7 +2346,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'TransferWithTimeout_lock',
+                  'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2363,7 +2363,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2376,7 +2376,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2395,7 +2395,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2504,7 +2504,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'TransferWithTimeout_lock',
+                  'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                   'overrides': {
                     'bytecode': {
                       'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2521,7 +2521,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2534,7 +2534,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2547,7 +2547,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'TransferWithTimeout_lock',
+                'script': 'TransferWithTimeout_f4836cd5e0e75562307c44a7f57e626f5b625d79c312ac7b15270d47d813cf68_lock',
                 'overrides': {
                   'bytecode': {
                     'sender': '0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38',
@@ -2600,7 +2600,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #0)',
           'scripts': [
-            'Bar_lock',
+            'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
             'Bar_execute_input0_unlock',
           ],
           'variables': {
@@ -2630,7 +2630,7 @@ export const fixtures: Fixture[] = [
           'description': 'Contract creation and function parameters',
           'name': 'Bar (input #1)',
           'scripts': [
-            'Bar_lock',
+            'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
             'Bar_execute_input1_unlock',
           ],
           'variables': {
@@ -2664,9 +2664,9 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'execute (input #0)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x0373cc07b54c22da627b572a387a20ea190c9382e5e6d48c1d5b89c5cea2c4c088>\n\n// function index in contract\n<function_index> // int = <2>\n',
-          'unlocks': 'Bar_lock',
+          'unlocks': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
         },
-        'Bar_lock': {
+        'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
           'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log('Bar 'execute' function called.'); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
@@ -2677,7 +2677,7 @@ export const fixtures: Fixture[] = [
           ],
           'name': 'execute (input #1)',
           'script': '// "execute" function parameters\n<s.schnorr_signature.all_outputs_all_utxos> // sig\n<pk> // pubkey = <0x028f1219c918234d6bb06b4782354ff0759bd73036f3c849b88020c79fe013cd38>\n\n// function index in contract\n<function_index> // int = <2>\n',
-          'unlocks': 'Bar_lock',
+          'unlocks': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
         },
       },
       'scenarios': {
@@ -2733,7 +2733,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'Bar_lock',
+                  'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -2754,7 +2754,7 @@ export const fixtures: Fixture[] = [
             },
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -2817,7 +2817,7 @@ export const fixtures: Fixture[] = [
             'outputs': [
               {
                 'lockingBytecode': {
-                  'script': 'Bar_lock',
+                  'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                   'overrides': {
                     'bytecode': {
                       'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
@@ -2832,7 +2832,7 @@ export const fixtures: Fixture[] = [
           'sourceOutputs': [
             {
               'lockingBytecode': {
-                'script': 'Bar_lock',
+                'script': 'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock',
                 'overrides': {
                   'bytecode': {
                     'pkh_bar': '0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970',
diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index 7a8bda66..64752961 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -15,14 +15,24 @@ import {
 import p2pkhArtifact from './fixture/p2pkh.artifact.js';
 import bigintArtifact from './fixture/bigint.artifact.js';
 import '../src/test/JestExtensions.js';
+import { ARTIFACT_SAME_NAME_DIFFERENT_PATH } from './fixture/debugging/multicontract_debugging_contracts.js';
 
 const bobSignatureTemplate = new SignatureTemplate(bobPriv);
 
 const provider = new MockNetworkProvider();
 
 describe('Multi-Contract-Debugging tests', () => {
+  describe('console.log statements', () => {
+    it.todo('should log all executed console.log statements across all contracts');
+    it.todo('should not log statements that are not executed');
+    it.todo('should log console.log statements in the correct order (by input index)');
+    it.todo('should be able to log correct input bytecode for other contracts');
+    it.todo('should be able to log correct output bytecode for other contracts');
+    it.todo('should still work with different instances of the same contract, with different paths due to different contract parameter values');
+  });
+
   describe('require statements', () => {
-    it('it should not throw an error if no require statement fails', async () => {
+    it('should not throw an error if no require statement fails', async () => {
       const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
       const bigintContract = new Contract(bigintArtifact, [], { provider });
 
@@ -48,7 +58,7 @@ describe('Multi-Contract-Debugging tests', () => {
       await expect(transaction).not.toFailRequire();
     });
 
-    it('it should fail with correct error message if a require statement fails in contract 1', async () => {
+    it('should fail with correct error message if a require statement fails in contract 1', async () => {
       const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
       const bigintContract = new Contract(bigintArtifact, [], { provider });
 
@@ -77,7 +87,7 @@ describe('Multi-Contract-Debugging tests', () => {
       await expect(transaction).toFailRequireWith('P2PKH.cash:4 Require statement failed at input 0 in contract P2PKH.cash at line 4.');
     });
 
-    it('it should fail with correct error message if a require statement in contract 2', async () => {
+    it('should fail with correct error message if a require statement in contract 2', async () => {
       const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
       const bigintContract = new Contract(bigintArtifact, [], { provider });
 
@@ -103,7 +113,7 @@ describe('Multi-Contract-Debugging tests', () => {
       await expect(transaction).toFailRequireWith('BigInt.cash:4 Require statement failed at input 1 in contract BigInt.cash at line 4.');
     });
 
-    it('it should fail with correct error message when a final verify fails in contract 1', async () => {
+    it('should fail with correct error message when a final verify fails in contract 1', async () => {
       const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
       const bigintContract = new Contract(bigintArtifact, [], { provider });
 
@@ -131,7 +141,7 @@ describe('Multi-Contract-Debugging tests', () => {
       await expect(transaction).toFailRequireWith('P2PKH.cash:5 Require statement failed at input 0 in contract P2PKH.cash at line 5');
     });
 
-    it('it should fail with correct error message when a final verify fails in contract 2', async () => {
+    it('should fail with correct error message when a final verify fails in contract 2', async () => {
       const p2pkhContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
       const bigintContract = new Contract(bigintArtifact, [], { provider });
 
@@ -158,5 +168,40 @@ describe('Multi-Contract-Debugging tests', () => {
 
       await expect(transaction).toFailRequireWith('BigInt.cash');
     });
+
+    it.todo('should fail with correct error message when introspected output bytecode of a different contract does not match');
+    it.todo('should fail with correct error message when introspected input bytecode of a different contract does not match');
+    it.todo('should still work if contracts have the same name');
+    it.todo('should still work if contract or function parameters have the same name across contracts');
+    it.todo('should still work with duplicate custom require messages across contracts');
+
+    it('should still work with different instances of the same contract, with different paths due to different constructor parameter values', () => {
+      const p2pkhContract1 = new Contract(ARTIFACT_SAME_NAME_DIFFERENT_PATH, [0n], { provider });
+      const p2pkhContract2 = new Contract(ARTIFACT_SAME_NAME_DIFFERENT_PATH, [1n], { provider });
+
+      const contract1Utxo = randomUtxo();
+      const contract2Utxo = randomUtxo();
+
+      provider.addUtxo(p2pkhContract1.address, contract1Utxo);
+      provider.addUtxo(p2pkhContract2.address, contract2Utxo);
+
+      const transaction1 = new TransactionBuilder({ provider })
+        .addInput(contract1Utxo, p2pkhContract1.unlock.function_1(0n))
+        .addInput(contract2Utxo, p2pkhContract2.unlock.function_1(0n))
+        .addOutput({ to: p2pkhContract1.address, amount: 10000n });
+
+      expect(transaction1).toFailRequireWith('SameNameDifferentPath.cash:7 Require statement failed at input 1 in contract SameNameDifferentPath.cash at line 7 with the following message: b should not be 0.');
+
+      const transaction2 = new TransactionBuilder({ provider })
+        .addInput(contract1Utxo, p2pkhContract1.unlock.function_1(1n))
+        .addInput(contract2Utxo, p2pkhContract2.unlock.function_1(1n))
+        .addOutput({ to: p2pkhContract1.address, amount: 10000n });
+
+      expect(transaction2).toFailRequireWith('SameNameDifferentPath.cash:5 Require statement failed at input 0 in contract SameNameDifferentPath.cash at line 5 with the following message: b should be 0.');
+    });
+  });
+
+  describe('Non-require error messages', () => {
+    it.todo('should fail with correct error message and statement when a multiline non-require statement fails');
   });
 });

From 5ad8f1a2abc50b634290b232d5112579f30440d5 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 26 May 2025 17:24:34 +0200
Subject: [PATCH 250/267] Add some name collision tests

- Add tests for function / parameter name collisions
- Add check to disallow contract name collisions and add test for that
---
 packages/cashscript/src/debugging.ts          | 11 +++++
 .../multicontract_debugging_contracts.ts      | 30 ++++++++++++
 .../test/multi-contract-debugging.test.ts     | 47 +++++++++++++++++--
 3 files changed, 85 insertions(+), 3 deletions(-)

diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index 6ba5716a..ab040e0b 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -9,6 +9,17 @@ export type DebugResults = Record<string, DebugResult>;
 
 // debugs the template, optionally logging the execution data
 export const debugTemplate = (template: WalletTemplate, artifacts: Artifact[]): DebugResults => {
+  // If a contract has the same name, but a different bytecode, then it is considered a name collision
+  const hasArtifactNameCollision = artifacts.some(
+    (artifact) => (
+      artifacts.some((other) => other.contractName === artifact.contractName && other.bytecode !== artifact.bytecode)
+    ),
+  );
+
+  if (hasArtifactNameCollision) {
+    throw new Error('There are multiple artifacts with the same contractName. Please make sure that all artifacts have unique names.');
+  }
+
   const results: DebugResults = {};
   const unlockingScriptIds = Object.keys(template.scripts).filter((key) => 'unlocks' in template.scripts[key]);
 
diff --git a/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts b/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts
index aafa01c3..1399e106 100644
--- a/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts
+++ b/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts
@@ -12,4 +12,34 @@ contract SameNameDifferentPath(int a) {
 }
 `;
 
+const NAME_COLLISION = `
+contract NameCollision(int a) {
+  function name_collision(int b) {
+    require(a == 0, "a should be 0");
+    require(b == 0, "b should be 0");
+  }
+}
+`;
+
+const CONTRACT_NAME_COLLISION = `
+contract NameCollision(int a) {
+  function name_collision(int b) {
+    require(b == 1, "b should be 1");
+    require(a == 1, "a should be 1");
+  }
+}
+`;
+
+const FUNCTION_NAME_COLLISION = `
+contract FunctionNameCollision(int a) {
+  function name_collision(int b) {
+    require(b == 1, "b should be 1");
+    require(a == 1, "a should be 1");
+  }
+}
+`;
+
 export const ARTIFACT_SAME_NAME_DIFFERENT_PATH = compileString(SAME_NAME_DIFFERENT_PATH);
+export const ARTIFACT_NAME_COLLISION = compileString(NAME_COLLISION);
+export const ARTIFACT_CONTRACT_NAME_COLLISION = compileString(CONTRACT_NAME_COLLISION);
+export const ARTIFACT_FUNCTION_NAME_COLLISION = compileString(FUNCTION_NAME_COLLISION);
diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index 64752961..f3e0621d 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -15,7 +15,7 @@ import {
 import p2pkhArtifact from './fixture/p2pkh.artifact.js';
 import bigintArtifact from './fixture/bigint.artifact.js';
 import '../src/test/JestExtensions.js';
-import { ARTIFACT_SAME_NAME_DIFFERENT_PATH } from './fixture/debugging/multicontract_debugging_contracts.js';
+import { ARTIFACT_FUNCTION_NAME_COLLISION, ARTIFACT_NAME_COLLISION, ARTIFACT_CONTRACT_NAME_COLLISION, ARTIFACT_SAME_NAME_DIFFERENT_PATH } from './fixture/debugging/multicontract_debugging_contracts.js';
 
 const bobSignatureTemplate = new SignatureTemplate(bobPriv);
 
@@ -171,10 +171,33 @@ describe('Multi-Contract-Debugging tests', () => {
 
     it.todo('should fail with correct error message when introspected output bytecode of a different contract does not match');
     it.todo('should fail with correct error message when introspected input bytecode of a different contract does not match');
-    it.todo('should still work if contracts have the same name');
-    it.todo('should still work if contract or function parameters have the same name across contracts');
     it.todo('should still work with duplicate custom require messages across contracts');
 
+    it('should still work if contract or function parameters have the same name across contracts', () => {
+      const nameCollision = new Contract(ARTIFACT_NAME_COLLISION, [0n], { provider });
+      const functionNameCollision = new Contract(ARTIFACT_FUNCTION_NAME_COLLISION, [1n], { provider });
+
+      const nameCollisionUtxo = randomUtxo();
+      const functionNameCollisionUtxo = randomUtxo();
+
+      provider.addUtxo(nameCollision.address, nameCollisionUtxo);
+      provider.addUtxo(functionNameCollision.address, functionNameCollisionUtxo);
+
+      const transaction1 = new TransactionBuilder({ provider })
+        .addInput(nameCollisionUtxo, nameCollision.unlock.name_collision(0n))
+        .addInput(functionNameCollisionUtxo, functionNameCollision.unlock.name_collision(0n))
+        .addOutput({ to: nameCollision.address, amount: 10000n });
+
+      expect(transaction1).toFailRequireWith('FunctionNameCollision.cash:4 Require statement failed at input 1 in contract FunctionNameCollision.cash at line 4 with the following message: b should be 1.');
+
+      const transaction2 = new TransactionBuilder({ provider })
+        .addInput(nameCollisionUtxo, nameCollision.unlock.name_collision(1n))
+        .addInput(functionNameCollisionUtxo, functionNameCollision.unlock.name_collision(1n))
+        .addOutput({ to: nameCollision.address, amount: 10000n });
+
+      expect(transaction2).toFailRequireWith('NameCollision.cash:5 Require statement failed at input 0 in contract NameCollision.cash at line 5 with the following message: b should be 0.');
+    });
+
     it('should still work with different instances of the same contract, with different paths due to different constructor parameter values', () => {
       const p2pkhContract1 = new Contract(ARTIFACT_SAME_NAME_DIFFERENT_PATH, [0n], { provider });
       const p2pkhContract2 = new Contract(ARTIFACT_SAME_NAME_DIFFERENT_PATH, [1n], { provider });
@@ -202,6 +225,24 @@ describe('Multi-Contract-Debugging tests', () => {
   });
 
   describe('Non-require error messages', () => {
+    it('should fail with the correct error message when there are name collisions on the contractName', () => {
+      const nameCollision = new Contract(ARTIFACT_NAME_COLLISION, [0n], { provider });
+      const contractNameCollision = new Contract(ARTIFACT_CONTRACT_NAME_COLLISION, [1n], { provider });
+
+      const nameCollisionUtxo = randomUtxo();
+      const contractNameCollisionUtxo = randomUtxo();
+
+      provider.addUtxo(nameCollision.address, nameCollisionUtxo);
+      provider.addUtxo(contractNameCollision.address, contractNameCollisionUtxo);
+
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(nameCollisionUtxo, nameCollision.unlock.name_collision(0n))
+        .addInput(contractNameCollisionUtxo, contractNameCollision.unlock.name_collision(0n))
+        .addOutput({ to: nameCollision.address, amount: 10000n });
+
+      expect(() => transaction.debug()).toThrow('There are multiple artifacts with the same contractName. Please make sure that all artifacts have unique names.');
+    });
+
     it.todo('should fail with correct error message and statement when a multiline non-require statement fails');
   });
 });

From 6fc7981ed5d1cdc702c6e4bc87ecf604ed066228 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Thu, 29 May 2025 09:56:51 +0200
Subject: [PATCH 251/267] add to type docs & release notes

---
 website/docs/language/types.md         |  4 +++-
 website/docs/releases/release-notes.md | 14 ++++++++++----
 2 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index 76029f1a..3422a14d 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -27,7 +27,7 @@ Operators:
 - Comparisons: `<=`, `<`, `==`, `!=`, `>=`, `>` (all evaluate to `bool`)
 - Arithmetic operators: `+`, `-`, unary `-`, `*`, `/`, `%` (modulo).
 
-Note the lack of the `**` (exponentiation) operator as well as any bitwise operators.
+Note the lack of the `**` (exponentiation) operator as well as any shifting operators.
 
 #### Number Formatting
 
@@ -83,6 +83,8 @@ Operators:
 - `|` (bitwise OR)
 - `^` (bitwise XOR)
 
+Note the lack of the bitshift operators (`<<` and `>>`) as well as bitwise INVERT (`~`).
+
 Members:
 
 - `length`: Number of bytes in the sequence.
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 68952734..c92e2677 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -19,8 +19,14 @@ This release also contains several breaking changes, please refer to the [migrat
   - Output BitAuth IDE URI for debugging when transaction is rejected.
   - Libauth template generation and debugging for multi-contract transactions
 - :sparkles: Debugging now supports using the optimised contract bytecode (when compiled with `cashc@0.11.0` or later).
-- :hammer_and_wrench: Deprecate the simple transaction builder. You can still use the simple transaction builder with the current SDK, but this support will be removed in a future release.
+- :sparkles: Config-free usage of the CashScript SDK with Vite or Webpack
 - :hammer_and_wrench: Update debug tooling to use the new `BCH_2025_05` instruction set.
+- :hammer_and_wrench: Deprecate the simple transaction builder. You can still use the simple transaction builder with the current SDK, but this support will be removed in a future release.
+- :boom: **BREAKING**: the Jest utilities for automated testing are now synchronous and no longer work with the deprecated simple transaction builder
+  * `expect(transaction).toLog(message)`
+  * `expect(transaction).toFailRequire()`
+  * `expect(transaction).toFailRequireWith(message)`
+- :boom: **BREAKING**: Rework the `Unlocker` type to be a union of `ContractUnlocker | P2PKHUnlocker` 
 - :boom: **BREAKING**: Remove support for custom Clusters from `ElectrumNetworkProvider` and added a configuration object to the constructor.
 - :boom: **BREAKING**: Remove support for old contracts compiled with CashScript v0.6.x or earlier.
 - :bug: Fix bug where `JestExtensions` `expect().toLog()` would detect logs from different tests.
@@ -81,9 +87,9 @@ Thanks [mainnet_pat](https://x.com/mainnet_pat) for the initiative and significa
 - :sparkles: Add `MockNetworkProvider` to simulate network interaction for debugging and testing.
   - Add `randomUtxo()`, `randomToken()` and `randomNft()` functions to generate dummy UTXOs for testing.
 - :sparkles: Add CashScript Jest utilities for automated testing.
-  * `expect(transaction).toLog(message)`
-  * `expect(transaction).toFailRequire()`
-  * `expect(transaction).toFailRequireWith(message)`
+  * `await expect(transaction).toLog(message)`
+  * `await expect(transaction).toFailRequire()`
+  * `await expect(transaction).toFailRequireWith(message)`
 - :bug: Fix bug with type exports.
 - :hammer_and_wrench: Update visibility of several classes.
   - Make `artifact`, `networkProvider`, `addressType` and `encodedConstructorArgs` public on `Contract` class.

From 7eb032ef0ba31b4b4399d903661120d879728309 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 10 Jun 2025 11:19:25 +0200
Subject: [PATCH 252/267] Fix bug where source map was incorrect in optimised
 NOTIF statement

---
 packages/cashscript/src/advanced/LibauthTemplate.ts   |  2 +-
 packages/cashscript/test/debugging.test.ts            | 10 ++++++++++
 .../test/fixture/debugging/debugging_contracts.ts     |  9 +++++++++
 packages/utils/src/script.ts                          | 11 +++++++----
 4 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index 3a28fcd5..a85615f2 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -402,7 +402,7 @@ export const getLibauthTemplates = (
     // If template exists on the input, it indicates this is a P2PKH (Pay to Public Key Hash) input
     if ('template' in input.unlocker) {
       // @ts-ignore TODO: Remove UtxoP2PKH type and only use UnlockableUtxo in Libaith Template generation
-      input.template = input.unlocker?.template;  // Added to support P2PKH inputs in buildTemplate
+      input.template = input.unlocker?.template; // Added to support P2PKH inputs in buildTemplate
       Object.assign(p2pkhEntities, generateTemplateEntitiesP2PKH(inputIndex));
       Object.assign(p2pkhScripts, generateTemplateScriptsP2PKH(input.unlocker.template, inputIndex));
 
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 82ed3508..aa757a66 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -134,6 +134,16 @@ describe('Debugging tests', () => {
       expect(transaction).toLog(expectedSecondLog);
     });
 
+    // This is an edge case because of optimisationn position hint merging
+    it('should log the correct variable value inside a notif statement', async () => {
+      const transaction = new TransactionBuilder({ provider })
+        .addInput(contractUtxo, contractTestLogs.unlock.test_log_inside_notif_statement(false))
+        .addOutput({ to: contractTestLogs.address, amount: contractUtxo.satoshis - 1000n });
+
+      expect(transaction).toLog(new RegExp(`^Test.cash:52 before: ${contractUtxo.satoshis}$`));
+      expect(transaction).toLog(new RegExp(`^Test.cash:54 after: ${contractUtxo.satoshis}$`));
+    });
+
     it('should log intermediate results that get optimised out', async () => {
       const transaction = new TransactionBuilder({ provider })
         .addInput(contractUtxo, contractTestLogs.unlock.test_log_intermediate_result())
diff --git a/packages/cashscript/test/fixture/debugging/debugging_contracts.ts b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
index 6a11bd24..3544b7d7 100644
--- a/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
+++ b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
@@ -243,6 +243,15 @@ contract Test(pubkey owner) {
 
     require(doubleHash.length == 32, "doubleHash should be 32 bytes");
   }
+
+  function test_log_inside_notif_statement(bool isLastScriptHash) {
+    int inputValue = tx.inputs[this.activeInputIndex].value;
+    console.log('before:', inputValue);
+    if (!isLastScriptHash) {
+      console.log('after:', inputValue);
+      require(tx.outputs[this.activeInputIndex].value == inputValue - 1000);
+    }
+  }
 }
 `;
 
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index 1491e3cd..3f48393f 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -281,10 +281,13 @@ function replaceOps(
       const lowestStart = getLowestStartLocation(patternLocations);
       const highestEnd = getHighestEndLocation(patternLocations);
 
-      // If any of the pattern locations have a position hint of END, we use that as the position hint
-      const positionHint = patternLocations.some((location) => location.positionHint === PositionHint.END)
-        ? PositionHint.END
-        : PositionHint.START;
+      // Initially we set the position hint to END if any of the pattern locations have a position hint of END
+      // It turned out that this was not the correct approach in the case of OP_NOT OP_IF => OP_NOTIF,
+      // because OP_IF and OP_NOTIF are START opcodes, and OP_NOT is an END opcode.
+      // After reviewing the entire list of optimisations, we set the position hint to the last location's position hint
+      // which we believe to be the correct approach, but it is hard to reason about.
+      // We've also consulted with AI (o3-max) to help us reason about this, and it seems to be the correct approach.
+      const positionHint = patternLocations.at(-1)?.positionHint ?? PositionHint.START;
 
       // We merge the lowest start and highest end locations into a single location data entry
       const mergedLocation = {

From 17a8cd233e555e552f14343f9bae2ae3ef39e09b Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Tue, 10 Jun 2025 12:09:13 +0200
Subject: [PATCH 253/267] Add tests for sibling introspection

---
 .../cashscript/test/e2e/MultiContract.test.ts | 58 +++++++++++++++-
 .../fixture/SiblingIntrospection.artifact.ts  | 68 +++++++++++++++++++
 .../test/fixture/SiblingIntrospection.cash    | 13 ++++
 .../test/fixture/SiblingIntrospection.json    | 68 +++++++++++++++++++
 .../test/multi-contract-debugging.test.ts     | 60 +++++++++++++++-
 5 files changed, 261 insertions(+), 6 deletions(-)
 create mode 100644 packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
 create mode 100644 packages/cashscript/test/fixture/SiblingIntrospection.cash
 create mode 100644 packages/cashscript/test/fixture/SiblingIntrospection.json

diff --git a/packages/cashscript/test/e2e/MultiContract.test.ts b/packages/cashscript/test/e2e/MultiContract.test.ts
index 933a1639..db7d1ced 100644
--- a/packages/cashscript/test/e2e/MultiContract.test.ts
+++ b/packages/cashscript/test/e2e/MultiContract.test.ts
@@ -7,6 +7,9 @@ import {
   TransactionBuilder,
 } from '../../src/index.js';
 import {
+  alicePkh,
+  alicePriv,
+  alicePub,
   bobAddress,
   bobPkh,
   bobPriv,
@@ -16,16 +19,18 @@ import {
   carolPub,
 } from '../fixture/vars.js';
 import { Network } from '../../src/interfaces.js';
-import { randomUtxo } from '../../src/utils.js';
+import { addressToLockScript, randomUtxo } from '../../src/utils.js';
 import p2pkhArtifact from '../fixture/p2pkh.artifact.js';
 import twtArtifact from '../fixture/transfer_with_timeout.artifact.js';
 import { getTxOutputs } from '../test-util.js';
+import SiblingIntrospectionArtifact from '../fixture/SiblingIntrospection.artifact.js';
 
 describe('Multi Contract', () => {
   const provider = process.env.TESTS_USE_MOCKNET
     ? new MockNetworkProvider()
     : new ElectrumNetworkProvider(Network.CHIPNET);
 
+  const aliceSignatureTemplate = new SignatureTemplate(alicePriv);
   const bobSignatureTemplate = new SignatureTemplate(bobPriv);
   const carolSignatureTemplate = new SignatureTemplate(carolPriv);
 
@@ -200,8 +205,55 @@ describe('Multi Contract', () => {
       const txOutputs = getTxOutputs(tx);
       expect(txOutputs).toEqual(expect.arrayContaining(outputs));
     });
+  });
+
+  describe('Sibling introspection', () => {
+    const correctContract = new Contract(p2pkhArtifact, [alicePkh], { provider });
+    const incorrectContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
+
+    const correctLockingBytecode = addressToLockScript(correctContract.address);
+    const siblingIntrospectionContract = new Contract(SiblingIntrospectionArtifact, [correctLockingBytecode], { provider });
 
+    const correctContractUtxo = randomUtxo();
+    const incorrectContractUtxo = randomUtxo();
+    const siblingIntrospectionUtxo = randomUtxo();
+
+    (provider as any).addUtxo?.(correctContract.address, correctContractUtxo);
+    (provider as any).addUtxo?.(incorrectContract.address, incorrectContractUtxo);
+    (provider as any).addUtxo?.(siblingIntrospectionContract.address, siblingIntrospectionUtxo);
+
+    it('should succeed when introspecting correct sibling UTXOs', async () => {
+      // given
+      const tx = await new TransactionBuilder({ provider })
+        .addInput(siblingIntrospectionUtxo, siblingIntrospectionContract.unlock.spend())
+        .addInput(correctContractUtxo, correctContract.unlock.spend(alicePub, aliceSignatureTemplate))
+        .addOutput({ to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis })
+        .addOutput({ to: correctContract.address, amount: correctContractUtxo.satoshis - 2000n })
+        .send();
+
+      // then
+      const txOutputs = getTxOutputs(tx);
+      expect(txOutputs).toEqual(
+        expect.arrayContaining([
+          { to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis },
+          { to: correctContract.address, amount: correctContractUtxo.satoshis - 2000n },
+        ]),
+      );
+    });
+
+    it('should fail when introspecting incorrect sibling UTXOs', async () => {
+      // given
+      const txPromise = new TransactionBuilder({ provider })
+        .addInput(siblingIntrospectionUtxo, siblingIntrospectionContract.unlock.spend())
+        .addInput(incorrectContractUtxo, incorrectContract.unlock.spend(bobPub, bobSignatureTemplate))
+        .addOutput({ to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis })
+        .addOutput({ to: incorrectContract.address, amount: incorrectContractUtxo.satoshis - 2000n })
+        .send();
+
+      // then
+      await expect(txPromise).rejects.toThrow(FailedRequireError);
+      await expect(txPromise).rejects.toThrow('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: input bytecode should match.');
+      await expect(txPromise).rejects.toThrow("Failing statement: require(inputBytecode == expectedLockingBytecode, 'input bytecode should match')");
+    });
   });
 });
-
-// TODO: Add test that introspects "sibling" UTXOs
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
new file mode 100644
index 00000000..e9f962cf
--- /dev/null
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
@@ -0,0 +1,68 @@
+export default {
+  contractName: 'SiblingIntrospection',
+  constructorInputs: [
+    {
+      name: 'expectedLockingBytecode',
+      type: 'bytes',
+    },
+  ],
+  abi: [
+    {
+      name: 'spend',
+      inputs: [],
+    },
+  ],
+  bytecode: 'OP_INPUTINDEX OP_0 OP_NUMEQUALVERIFY OP_1 OP_UTXOBYTECODE OP_OVER OP_EQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_EQUAL',
+  source: 'contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log(\'inputBytecode:\', inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\');\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log(\'outputBytecode:\', outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, \'output bytecode should match\');\n    }\n}\n',
+  debug: {
+    bytecode: 'c0009d51c7788851cd87',
+    sourceMap: '3:16:3:37;:41::42;:8::44:1;5:40:5:41:0;:30::58:1;7:33:7:56:0;:8::89:1;9:42:9:43:0;:31::60:1;11:16:11:57',
+    logs: [
+      {
+        ip: 6,
+        line: 6,
+        data: [
+          'inputBytecode:',
+          {
+            stackIndex: 0,
+            type: 'bytes',
+            ip: 6,
+          },
+        ],
+      },
+      {
+        ip: 10,
+        line: 10,
+        data: [
+          'outputBytecode:',
+          {
+            stackIndex: 0,
+            type: 'bytes',
+            ip: 10,
+          },
+        ],
+      },
+    ],
+    requires: [
+      {
+        ip: 3,
+        line: 3,
+      },
+      {
+        ip: 7,
+        line: 7,
+        message: 'input bytecode should match',
+      },
+      {
+        ip: 11,
+        line: 11,
+        message: 'output bytecode should match',
+      },
+    ],
+  },
+  compiler: {
+    name: 'cashc',
+    version: '0.11.0-next.4',
+  },
+  updatedAt: '2025-06-10T10:02:43.222Z',
+} as const;
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.cash b/packages/cashscript/test/fixture/SiblingIntrospection.cash
new file mode 100644
index 00000000..21ed5955
--- /dev/null
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.cash
@@ -0,0 +1,13 @@
+contract SiblingIntrospection(bytes expectedLockingBytecode) {
+    function spend() {
+        require(this.activeInputIndex == 0);
+
+        bytes inputBytecode = tx.inputs[1].lockingBytecode;
+        console.log("inputBytecode:", inputBytecode);
+        require(inputBytecode == expectedLockingBytecode, "input bytecode should match");
+
+        bytes outputBytecode = tx.outputs[1].lockingBytecode;
+        console.log("outputBytecode:", outputBytecode);
+        require(outputBytecode == expectedLockingBytecode, "output bytecode should match");
+    }
+}
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.json b/packages/cashscript/test/fixture/SiblingIntrospection.json
new file mode 100644
index 00000000..6f12f6f8
--- /dev/null
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.json
@@ -0,0 +1,68 @@
+{
+  "contractName": "SiblingIntrospection",
+  "constructorInputs": [
+    {
+      "name": "expectedLockingBytecode",
+      "type": "bytes"
+    }
+  ],
+  "abi": [
+    {
+      "name": "spend",
+      "inputs": []
+    }
+  ],
+  "bytecode": "OP_INPUTINDEX OP_0 OP_NUMEQUALVERIFY OP_1 OP_UTXOBYTECODE OP_OVER OP_EQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_EQUAL",
+  "source": "contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log(\"inputBytecode:\", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, \"input bytecode should match\");\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log(\"outputBytecode:\", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, \"output bytecode should match\");\n    }\n}\n",
+  "debug": {
+    "bytecode": "c0009d51c7788851cd87",
+    "sourceMap": "3:16:3:37;:41::42;:8::44:1;5:40:5:41:0;:30::58:1;7:33:7:56:0;:8::89:1;9:42:9:43:0;:31::60:1;11:16:11:57",
+    "logs": [
+      {
+        "ip": 6,
+        "line": 6,
+        "data": [
+          "inputBytecode:",
+          {
+            "stackIndex": 0,
+            "type": "bytes",
+            "ip": 6
+          }
+        ]
+      },
+      {
+        "ip": 10,
+        "line": 10,
+        "data": [
+          "outputBytecode:",
+          {
+            "stackIndex": 0,
+            "type": "bytes",
+            "ip": 10
+          }
+        ]
+      }
+    ],
+    "requires": [
+      {
+        "ip": 3,
+        "line": 3
+      },
+      {
+        "ip": 7,
+        "line": 7,
+        "message": "input bytecode should match"
+      },
+      {
+        "ip": 11,
+        "line": 11,
+        "message": "output bytecode should match"
+      }
+    ]
+  },
+  "compiler": {
+    "name": "cashc",
+    "version": "0.11.0-next.4"
+  },
+  "updatedAt": "2025-06-10T10:02:42.898Z"
+}
\ No newline at end of file
diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index f3e0621d..9bafdf4e 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -4,8 +4,10 @@ import {
   randomUtxo,
   SignatureTemplate,
   TransactionBuilder,
-} from './../src/index.js';
+} from '../src/index.js';
 import {
+  alicePkh,
+  alicePriv,
   alicePub,
   bobAddress,
   bobPkh,
@@ -16,6 +18,8 @@ import p2pkhArtifact from './fixture/p2pkh.artifact.js';
 import bigintArtifact from './fixture/bigint.artifact.js';
 import '../src/test/JestExtensions.js';
 import { ARTIFACT_FUNCTION_NAME_COLLISION, ARTIFACT_NAME_COLLISION, ARTIFACT_CONTRACT_NAME_COLLISION, ARTIFACT_SAME_NAME_DIFFERENT_PATH } from './fixture/debugging/multicontract_debugging_contracts.js';
+import { addressToLockScript } from '../src/utils.js';
+import SiblingIntrospectionArtifact from './fixture/SiblingIntrospection.artifact.js';
 
 const bobSignatureTemplate = new SignatureTemplate(bobPriv);
 
@@ -169,8 +173,58 @@ describe('Multi-Contract-Debugging tests', () => {
       await expect(transaction).toFailRequireWith('BigInt.cash');
     });
 
-    it.todo('should fail with correct error message when introspected output bytecode of a different contract does not match');
-    it.todo('should fail with correct error message when introspected input bytecode of a different contract does not match');
+    describe('Sibling introspection', () => {
+      const correctContract = new Contract(p2pkhArtifact, [alicePkh], { provider });
+      const incorrectContract = new Contract(p2pkhArtifact, [bobPkh], { provider });
+
+      const correctLockingBytecode = addressToLockScript(correctContract.address);
+      const siblingIntrospectionContract = new Contract(
+        SiblingIntrospectionArtifact,
+        [correctLockingBytecode],
+        { provider },
+      );
+
+      const correctContractUtxo = randomUtxo();
+      const incorrectContractUtxo = randomUtxo();
+      const siblingIntrospectionUtxo = randomUtxo();
+
+      (provider as any).addUtxo?.(correctContract.address, correctContractUtxo);
+      (provider as any).addUtxo?.(incorrectContract.address, incorrectContractUtxo);
+      (provider as any).addUtxo?.(siblingIntrospectionContract.address, siblingIntrospectionUtxo);
+
+      it('should not throw fail any require statements when introspecting correct sibling UTXOs', () => {
+        const tx = new TransactionBuilder({ provider })
+          .addInput(siblingIntrospectionUtxo, siblingIntrospectionContract.unlock.spend())
+          .addInput(correctContractUtxo, correctContract.unlock.spend(alicePub, new SignatureTemplate(alicePriv)))
+          .addOutput({ to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis })
+          .addOutput({ to: correctContract.address, amount: correctContractUtxo.satoshis - 2000n });
+
+        expect(tx).not.toFailRequire();
+      });
+
+      it('should fail with correct error message when introspected input bytecode of a sibling UTXO does not match', () => {
+        const tx = new TransactionBuilder({ provider })
+          .addInput(siblingIntrospectionUtxo, siblingIntrospectionContract.unlock.spend())
+          .addInput(incorrectContractUtxo, incorrectContract.unlock.spend(bobPub, bobSignatureTemplate))
+          .addOutput({ to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis })
+          .addOutput({ to: correctContract.address, amount: incorrectContractUtxo.satoshis - 2000n });
+
+        expect(tx).toFailRequireWith('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: input bytecode should match.');
+        expect(tx).toFailRequireWith('Failing statement: require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\')');
+      });
+
+      it('should fail with correct error message when introspected output bytecode of a sibling UTXO does not match', () => {
+        const tx = new TransactionBuilder({ provider })
+          .addInput(siblingIntrospectionUtxo, siblingIntrospectionContract.unlock.spend())
+          .addInput(correctContractUtxo, correctContract.unlock.spend(alicePub, new SignatureTemplate(alicePriv)))
+          .addOutput({ to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis })
+          .addOutput({ to: incorrectContract.address, amount: correctContractUtxo.satoshis - 2000n });
+
+        expect(tx).toFailRequireWith('SiblingIntrospection.cash:11 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 11 with the following message: output bytecode should match.');
+        expect(tx).toFailRequireWith('Failing statement: require(outputBytecode == expectedLockingBytecode, "output bytecode should match")');
+      });
+    });
+
     it.todo('should still work with duplicate custom require messages across contracts');
 
     it('should still work if contract or function parameters have the same name across contracts', () => {

From 921f921a9de6961fe88df1df150f90ee3ca7af2f Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 10 Jun 2025 16:16:21 +0200
Subject: [PATCH 254/267] add setBlockHeight to MockNetworkProvider

---
 packages/cashscript/src/network/MockNetworkProvider.ts | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/cashscript/src/network/MockNetworkProvider.ts b/packages/cashscript/src/network/MockNetworkProvider.ts
index de771e95..3f6603a3 100644
--- a/packages/cashscript/src/network/MockNetworkProvider.ts
+++ b/packages/cashscript/src/network/MockNetworkProvider.ts
@@ -13,6 +13,7 @@ export default class MockNetworkProvider implements NetworkProvider {
   private utxoMap: Record<string, Utxo[]> = {};
   private transactionMap: Record<string, string> = {};
   public network: Network = Network.MOCKNET;
+  public blockHeight: number = 133700;
 
   constructor() {
     for (let i = 0; i < 3; i += 1) {
@@ -27,8 +28,12 @@ export default class MockNetworkProvider implements NetworkProvider {
     return this.utxoMap[lockingBytecode] ?? [];
   }
 
+  setBlockHeight(newBlockHeight: number): void {
+    this.blockHeight = newBlockHeight;
+  }
+
   async getBlockHeight(): Promise<number> {
-    return 133700;
+    return this.blockHeight;
   }
 
   async getRawTransaction(txid: string): Promise<string> {

From 89e580da1ca17cf03b7cb4ad980a5d8164ca52d4 Mon Sep 17 00:00:00 2001
From: Mathieu Geukens <mr-zwets@protonmail.com>
Date: Tue, 10 Jun 2025 16:18:25 +0200
Subject: [PATCH 255/267] improve docs MockNetworkProvider

---
 website/docs/guides/debugging.md            | 2 +-
 website/docs/releases/release-notes.md      | 1 +
 website/docs/sdk/other-network-providers.md | 7 +++++--
 website/docs/sdk/testing-setup.md           | 6 ++++--
 website/docs/sdk/transaction-builder.md     | 2 +-
 website/docs/sdk/transactions.md            | 2 +-
 6 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/website/docs/guides/debugging.md b/website/docs/guides/debugging.md
index fda72d5a..fe4d7de8 100644
--- a/website/docs/guides/debugging.md
+++ b/website/docs/guides/debugging.md
@@ -49,7 +49,7 @@ const uri = await transactionBuilder.bitauthUri();
 ```
 
 :::caution
-It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
+It is unsafe to debug transactions on mainnet using the BitAuth IDE as private keys will be exposed to BitAuth IDE and transmitted over the network.
 :::
 
 The Bitauth IDE will show you the two-way mapping between the CashScript contract code generated opcodes. Here is [a Bitauth IDE link][BitauthIDE] for the basic `TransferWithTimeout` contract as an example:
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index c92e2677..4e7864dd 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -19,6 +19,7 @@ This release also contains several breaking changes, please refer to the [migrat
   - Output BitAuth IDE URI for debugging when transaction is rejected.
   - Libauth template generation and debugging for multi-contract transactions
 - :sparkles: Debugging now supports using the optimised contract bytecode (when compiled with `cashc@0.11.0` or later).
+- :sparkles: Add `setBlockHeight()` method to `MockNetworkProvider`
 - :sparkles: Config-free usage of the CashScript SDK with Vite or Webpack
 - :hammer_and_wrench: Update debug tooling to use the new `BCH_2025_05` instruction set.
 - :hammer_and_wrench: Deprecate the simple transaction builder. You can still use the simple transaction builder with the current SDK, but this support will be removed in a future release.
diff --git a/website/docs/sdk/other-network-providers.md b/website/docs/sdk/other-network-providers.md
index 3d8b0295..6c9817c1 100644
--- a/website/docs/sdk/other-network-providers.md
+++ b/website/docs/sdk/other-network-providers.md
@@ -9,7 +9,10 @@ The CashScript SDK needs to connect to the BCH network to perform certain operat
 new MockNetworkProvider()
 ```
 
-The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. You can read more about the `MockNetworkProvider` and automated tests on the [testing setup](/docs/sdk/testing-setup) page.
+The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. 
+
+The `MockNetworkProvider` has extra methods to enable this local emulation such as `.addUtxo()` and `.setBlockHeight()`.
+You can read more about the `MockNetworkProvider` and automated tests on the [testing setup](/docs/sdk/testing-setup) page.
 
 #### Example
 ```ts
@@ -18,7 +21,7 @@ const newUtxo = randomUtxo({satoshis: 10_000n})
 provider.addUtxo(contractAddress, newUtxo);
 ```
 
-The network type of the `MockNetworkProvider`.
+The network type of the `MockNetworkProvider` is `'mocknet'`.
 
 ## Other NetworkProviders
 
diff --git a/website/docs/sdk/testing-setup.md b/website/docs/sdk/testing-setup.md
index f627c73c..b639278b 100644
--- a/website/docs/sdk/testing-setup.md
+++ b/website/docs/sdk/testing-setup.md
@@ -10,7 +10,9 @@ For a quick start with a CashScript testing setup, check out the [example testin
 
 ## MockNetworkProvider
 
-The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally. To create a new virtual UTXO use `provider.addUtxo()`.
+The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally.
+
+To create a new virtual UTXO use `provider.addUtxo(address, uxto)`. You can use the helper functions `randomUtxo()`, `randomToken()` and `randomNFT()` to generate random partial Utxo info which you can be overwritten with custom values. 
 
 #### Example
 
@@ -27,7 +29,7 @@ const aliceUtxo = provider.addUtxo(aliceAddress, randomUtxo({
 ```
 
 :::note
-The `MockNetworkProvider` only evaluates the transactions locally, so any UTXOs added to a transaction still count as "unspent", even after mocking a `sendTransaction` using the provider.
+The `MockNetworkProvider` evaluates transactions locally but does not process the transaction updates. This means no UTXOs are consumed and no new UTXOs are created when mocking a transaction `send` using the provider.
 :::
 
 ## Automated testing
diff --git a/website/docs/sdk/transaction-builder.md b/website/docs/sdk/transaction-builder.md
index 2b4a06ba..6080d662 100644
--- a/website/docs/sdk/transaction-builder.md
+++ b/website/docs/sdk/transaction-builder.md
@@ -247,7 +247,7 @@ If you prefer a lower-level debugging experience, you can call the `bitauthUri()
 You can read more about debugging transactions on the [debugging page](/docs/guides/debugging).
 
 :::caution
-It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
+It is unsafe to debug transactions on mainnet using the BitAuth IDE as private keys will be exposed to BitAuth IDE and transmitted over the network.
 :::
 
 ## Transaction errors
diff --git a/website/docs/sdk/transactions.md b/website/docs/sdk/transactions.md
index 5ffb08b7..96cdee17 100644
--- a/website/docs/sdk/transactions.md
+++ b/website/docs/sdk/transactions.md
@@ -257,7 +257,7 @@ If you prefer a lower-level debugging experience, you can call the `bitauthUri()
 You can read more about debugging transactions on the [debugging page](/docs/guides/debugging).
 
 :::caution
-It is unsafe to debug transactions on mainnet as private keys will be exposed to BitAuth IDE and transmitted over the network.
+It is unsafe to debug transactions on mainnet using the BitAuth IDE as private keys will be exposed to BitAuth IDE and transmitted over the network.
 :::
 
 ## Transaction errors

From b4a28e942001058cb8f65b04cbde649fe8fec9c8 Mon Sep 17 00:00:00 2001
From: mr-zwets <53938059+mr-zwets@users.noreply.github.com>
Date: Sat, 14 Jun 2025 14:05:05 +0200
Subject: [PATCH 256/267] Keep old Unlocker type, introduce 'StandardUnlocker'
 (#314)

Co-authored-by: Rosco Kalis <roscokalis@gmail.com>
---
 packages/cashscript/src/Contract.ts           |  7 ++---
 packages/cashscript/src/SignatureTemplate.ts  |  4 +--
 packages/cashscript/src/TransactionBuilder.ts | 16 ++++++++--
 .../src/advanced/LibauthTemplate.ts           | 23 +++++++++------
 packages/cashscript/src/interfaces.ts         | 29 +++++++++++++++----
 website/docs/releases/release-notes.md        |  1 -
 6 files changed, 56 insertions(+), 24 deletions(-)

diff --git a/packages/cashscript/src/Contract.ts b/packages/cashscript/src/Contract.ts
index 5b8115ab..e2baf3d2 100644
--- a/packages/cashscript/src/Contract.ts
+++ b/packages/cashscript/src/Contract.ts
@@ -15,8 +15,7 @@ import {
   ConstructorArgument, encodeFunctionArgument, encodeConstructorArguments, encodeFunctionArguments, FunctionArgument,
 } from './Argument.js';
 import {
-  Unlocker, ContractOptions, GenerateUnlockingBytecodeOptions, Utxo,
-  AddressType,
+  Unlocker, ContractOptions, GenerateUnlockingBytecodeOptions, Utxo, AddressType, ContractUnlocker,
 } from './interfaces.js';
 import NetworkProvider from './network/NetworkProvider.js';
 import {
@@ -147,7 +146,7 @@ export class Contract<
     };
   }
 
-  private createUnlocker(abiFunction: AbiFunction, selector?: number): ContractUnlocker {
+  private createUnlocker(abiFunction: AbiFunction, selector?: number): ContractFunctionUnlocker {
     return (...args: FunctionArgument[]) => {
       if (abiFunction.inputs.length !== args.length) {
         throw new Error(`Incorrect number of arguments passed to function ${abiFunction.name}. Expected ${abiFunction.inputs.length} arguments (${abiFunction.inputs.map((input) => input.type)}) but got ${args.length}`);
@@ -182,4 +181,4 @@ export class Contract<
 }
 
 export type ContractFunction = (...args: FunctionArgument[]) => Transaction;
-export type ContractUnlocker = (...args: FunctionArgument[]) => Unlocker;
+type ContractFunctionUnlocker = (...args: FunctionArgument[]) => ContractUnlocker;
diff --git a/packages/cashscript/src/SignatureTemplate.ts b/packages/cashscript/src/SignatureTemplate.ts
index 5593d192..e834a32b 100644
--- a/packages/cashscript/src/SignatureTemplate.ts
+++ b/packages/cashscript/src/SignatureTemplate.ts
@@ -1,10 +1,10 @@
 import { decodePrivateKeyWif, secp256k1, SigningSerializationFlag } from '@bitauth/libauth';
 import { hash256, scriptToBytecode } from '@cashscript/utils';
 import {
-  Unlocker,
   GenerateUnlockingBytecodeOptions,
   HashType,
   SignatureAlgorithm,
+  P2PKHUnlocker,
 } from './interfaces.js';
 import { createSighashPreimage, publicKeyToP2PKHLockingBytecode } from './utils.js';
 
@@ -47,7 +47,7 @@ export default class SignatureTemplate {
     return secp256k1.derivePublicKeyCompressed(this.privateKey) as Uint8Array;
   }
 
-  unlockP2PKH(): Unlocker {
+  unlockP2PKH(): P2PKHUnlocker {
     const publicKey = this.getPublicKey();
     const prevOutScript = publicKeyToP2PKHLockingBytecode(publicKey);
     const hashtype = this.getHashType();
diff --git a/packages/cashscript/src/TransactionBuilder.ts b/packages/cashscript/src/TransactionBuilder.ts
index c435e8c0..fa30087d 100644
--- a/packages/cashscript/src/TransactionBuilder.ts
+++ b/packages/cashscript/src/TransactionBuilder.ts
@@ -15,6 +15,8 @@ import {
   Utxo,
   InputOptions,
   isUnlockableUtxo,
+  isStandardUnlockableUtxo,
+  StandardUnlockableUtxo,
 } from './interfaces.js';
 import { NetworkProvider } from './network/index.js';
 import {
@@ -159,7 +161,12 @@ export class TransactionBuilder {
   }
 
   debug(): DebugResults {
-    const contractVersions = this.inputs
+    if (this.inputs.some((input) => !isStandardUnlockableUtxo(input))) {
+      throw new Error('Cannot debug a transaction with custom unlocker');
+    }
+
+    // We can typecast this because we check that all inputs are standard unlockable in the check above
+    const contractVersions = (this.inputs as StandardUnlockableUtxo[])
       .map((input) => 'contract' in input.unlocker ? input.unlocker.contract.artifact.compiler.version : null)
       .filter((version) => version !== null);
 
@@ -184,8 +191,11 @@ export class TransactionBuilder {
   async send(raw?: true): Promise<TransactionDetails | string> {
     const tx = this.build();
 
-    // Debug the transaction locally before sending so any errors are caught early
-    this.debug();
+    // If all inputs are standard unlockable, we can debug the transaction locally
+    // before sending so any errors are caught early
+    if (this.inputs.every((input) => isStandardUnlockableUtxo(input))) {
+      this.debug();
+    }
 
     try {
       const txid = await this.provider.sendRawTransaction(tx);
diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index a85615f2..0704b0bf 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -22,8 +22,9 @@ import { EncodedConstructorArgument, EncodedFunctionArgument, encodeFunctionArgu
 import { Contract } from '../Contract.js';
 import { DebugResults, debugTemplate } from '../debugging.js';
 import {
-  ContractUnlocker,
-  UnlockableUtxo,
+  isP2PKHUnlocker,
+  isStandardUnlockableUtxo,
+  StandardUnlockableUtxo,
   Utxo,
 } from '../interfaces.js';
 import {
@@ -371,6 +372,10 @@ const createCSTransaction = (txn: TransactionBuilder) => {
 export const getLibauthTemplates = (
   txn: TransactionBuilder,
 ): WalletTemplate => {
+  if (txn.inputs.some((input) => !isStandardUnlockableUtxo(input))) {
+    throw new Error('Cannot use debugging functionality with a transaction that contains custom unlockers');
+  }
+
   const libauthTransaction = txn.buildLibauthTransaction();
   const csTransaction = createCSTransaction(txn);
 
@@ -398,7 +403,8 @@ export const getLibauthTemplates = (
   const unlockingBytecodeToLockingBytecodeParams: Record<string, WalletTemplateScenarioBytecode> = {};
   const lockingBytecodeToLockingBytecodeParams: Record<string, WalletTemplateScenarioBytecode> = {};
 
-  for (const [inputIndex, input] of txn.inputs.entries()) {
+  // We can typecast this because we check that all inputs are standard unlockable at the top of this function
+  for (const [inputIndex, input] of (txn.inputs as StandardUnlockableUtxo[]).entries()) {
     // If template exists on the input, it indicates this is a P2PKH (Pay to Public Key Hash) input
     if ('template' in input.unlocker) {
       // @ts-ignore TODO: Remove UtxoP2PKH type and only use UnlockableUtxo in Libaith Template generation
@@ -536,10 +542,10 @@ export const debugLibauthTemplate = (template: WalletTemplate, transaction: Tran
 
 const generateLockingScriptParams = (
   contract: Contract,
-  csInput: UnlockableUtxo,
+  { unlocker }: StandardUnlockableUtxo,
   lockScriptName: string,
 ): WalletTemplateScenarioBytecode => {
-  if (('template' in csInput.unlocker)) {
+  if (isP2PKHUnlocker(unlocker)) {
     return {
       script: lockScriptName,
     };
@@ -548,9 +554,8 @@ const generateLockingScriptParams = (
   const constructorParamsEntries = contract.artifact.constructorInputs
     .map(({ name }, index) => [
       name,
-      // TODO: For some reason, typescript forgets that the unlocker is a ContractUnlocker
       addHexPrefixExceptEmpty(
-        binToHex((csInput.unlocker as ContractUnlocker).contract.encodedConstructorArgs[index]),
+        binToHex(unlocker.contract.encodedConstructorArgs[index]),
       ),
     ]);
 
@@ -565,11 +570,11 @@ const generateLockingScriptParams = (
 };
 
 export const generateUnlockingScriptParams = (
-  csInput: UnlockableUtxo,
+  csInput: StandardUnlockableUtxo,
   p2pkhScriptNameTemplate: string,
   inputIndex: number,
 ): WalletTemplateScenarioBytecode => {
-  if (('template' in csInput.unlocker)) {
+  if (isP2PKHUnlocker(csInput.unlocker)) {
     return {
       script: `${p2pkhScriptNameTemplate}_${inputIndex}`,
       overrides: {
diff --git a/packages/cashscript/src/interfaces.ts b/packages/cashscript/src/interfaces.ts
index 65b01c28..22d9a66a 100644
--- a/packages/cashscript/src/interfaces.ts
+++ b/packages/cashscript/src/interfaces.ts
@@ -17,10 +17,18 @@ export interface UnlockableUtxo extends Utxo {
   options?: InputOptions;
 }
 
+export interface StandardUnlockableUtxo extends UnlockableUtxo {
+  unlocker: StandardUnlocker;
+}
+
 export function isUnlockableUtxo(utxo: Utxo): utxo is UnlockableUtxo {
   return 'unlocker' in utxo;
 }
 
+export function isStandardUnlockableUtxo(utxo: UnlockableUtxo): utxo is StandardUnlockableUtxo {
+  return isStandardUnlocker(utxo.unlocker);
+}
+
 export interface InputOptions {
   sequence?: number;
 }
@@ -31,23 +39,34 @@ export interface GenerateUnlockingBytecodeOptions {
   inputIndex: number;
 }
 
-// TODO: Change this type when we understand the requirements better
-export interface BaseUnlocker {
+export interface Unlocker {
   generateLockingBytecode: () => Uint8Array;
   generateUnlockingBytecode: (options: GenerateUnlockingBytecodeOptions) => Uint8Array;
 }
 
-export interface ContractUnlocker extends BaseUnlocker {
+export interface ContractUnlocker extends Unlocker {
   contract: Contract;
   params: FunctionArgument[];
   abiFunction: AbiFunction;
 }
 
-export interface P2PKHUnlocker extends BaseUnlocker {
+export interface P2PKHUnlocker extends Unlocker {
   template: SignatureTemplate;
 }
 
-export type Unlocker = ContractUnlocker | P2PKHUnlocker;
+export type StandardUnlocker = ContractUnlocker | P2PKHUnlocker;
+
+export function isContractUnlocker(unlocker: Unlocker): unlocker is ContractUnlocker {
+  return 'contract' in unlocker;
+}
+
+export function isP2PKHUnlocker(unlocker: Unlocker): unlocker is P2PKHUnlocker {
+  return 'template' in unlocker;
+}
+
+export function isStandardUnlocker(unlocker: Unlocker): unlocker is StandardUnlocker {
+  return isContractUnlocker(unlocker) || isP2PKHUnlocker(unlocker);
+}
 
 export interface UtxoP2PKH extends Utxo {
   template: SignatureTemplate;
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 4e7864dd..2d53003d 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -27,7 +27,6 @@ This release also contains several breaking changes, please refer to the [migrat
   * `expect(transaction).toLog(message)`
   * `expect(transaction).toFailRequire()`
   * `expect(transaction).toFailRequireWith(message)`
-- :boom: **BREAKING**: Rework the `Unlocker` type to be a union of `ContractUnlocker | P2PKHUnlocker` 
 - :boom: **BREAKING**: Remove support for custom Clusters from `ElectrumNetworkProvider` and added a configuration object to the constructor.
 - :boom: **BREAKING**: Remove support for old contracts compiled with CashScript v0.6.x or earlier.
 - :bug: Fix bug where `JestExtensions` `expect().toLog()` would detect logs from different tests.

From 4839354d2701fc85d049bcc18b87be5ebf019340 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Sat, 14 Jun 2025 14:30:55 +0200
Subject: [PATCH 257/267] Add warning about private key leakage when
 using/logging the bitauth URI

---
 packages/cashscript/src/Errors.ts             | 3 ++-
 packages/cashscript/src/LibauthTemplate.ts    | 3 ++-
 packages/cashscript/src/Transaction.ts        | 1 +
 packages/cashscript/src/TransactionBuilder.ts | 1 +
 4 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index 744c53e4..5b6029b8 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -38,7 +38,8 @@ export class NoDebugInformationInArtifactError extends Error {
 
 export class FailedTransactionError extends Error {
   constructor(public reason: string, public bitauthUri?: string) {
-    super(`${reason}${bitauthUri ? `\n\nBitauth URI: ${bitauthUri}` : ''}`);
+    const warning = 'WARNING: it is unsafe to use this Bitauth URI when using real private keys as they are included in the transaction template';
+    super(`${reason}${bitauthUri ? `\n\n${warning}\n\nBitauth URI: ${bitauthUri}` : ''}`);
   }
 }
 
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 4f5cb0c2..70f60ab5 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -34,6 +34,7 @@ import {
   SignatureAlgorithm,
   HashType,
   isUnlockableUtxo,
+  isStandardUnlockableUtxo,
 } from './interfaces.js';
 import SignatureTemplate from './SignatureTemplate.js';
 import { Transaction } from './Transaction.js';
@@ -372,7 +373,7 @@ export const generateTemplateScenarioBytecode = (
     };
   }
 
-  if (isUnlockableUtxo(input)) {
+  if (isUnlockableUtxo(input) && isStandardUnlockableUtxo(input)) {
     return generateUnlockingScriptParams(input, p2pkhScriptNameTemplate, inputIndex);
   }
 
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 063045d4..9a30b668 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -196,6 +196,7 @@ export class Transaction {
   }
 
   async bitauthUri(): Promise<string> {
+    console.warn('WARNING: it is unsafe to use this Bitauth URI when using real private keys as they are included in the transaction template');
     const template = await this.getLibauthTemplate();
     return getBitauthUri(template);
   }
diff --git a/packages/cashscript/src/TransactionBuilder.ts b/packages/cashscript/src/TransactionBuilder.ts
index fa30087d..e84ba5c1 100644
--- a/packages/cashscript/src/TransactionBuilder.ts
+++ b/packages/cashscript/src/TransactionBuilder.ts
@@ -178,6 +178,7 @@ export class TransactionBuilder {
   }
 
   bitauthUri(): string {
+    console.warn('WARNING: it is unsafe to use this Bitauth URI when using real private keys as they are included in the transaction template');
     return getBitauthUri(this.getLibauthTemplate());
   }
 

From 704a116aa966bb612c220f5e56d0619b707c4c24 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 16 Jun 2025 16:49:49 +0200
Subject: [PATCH 258/267] Fix TypeScript artifact format encoding

---
 packages/cashscript/test/e2e/MultiContract.test.ts        | 2 +-
 packages/cashscript/test/fixture/Bar.artifact.ts          | 4 ++--
 packages/cashscript/test/fixture/Foo.artifact.ts          | 4 ++--
 .../test/fixture/SiblingIntrospection.artifact.ts         | 4 ++--
 packages/cashscript/test/fixture/announcement.artifact.ts | 4 ++--
 .../fixture/libauth-template/multi-contract-fixtures.ts   | 8 ++++----
 packages/cashscript/test/multi-contract-debugging.test.ts | 2 +-
 packages/utils/src/artifact.ts                            | 5 +++--
 8 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/packages/cashscript/test/e2e/MultiContract.test.ts b/packages/cashscript/test/e2e/MultiContract.test.ts
index db7d1ced..e75d0ffb 100644
--- a/packages/cashscript/test/e2e/MultiContract.test.ts
+++ b/packages/cashscript/test/e2e/MultiContract.test.ts
@@ -253,7 +253,7 @@ describe('Multi Contract', () => {
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
       await expect(txPromise).rejects.toThrow('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: input bytecode should match.');
-      await expect(txPromise).rejects.toThrow("Failing statement: require(inputBytecode == expectedLockingBytecode, 'input bytecode should match')");
+      await expect(txPromise).rejects.toThrow('Failing statement: require(inputBytecode == expectedLockingBytecode, "input bytecode should match")');
     });
   });
 });
diff --git a/packages/cashscript/test/fixture/Bar.artifact.ts b/packages/cashscript/test/fixture/Bar.artifact.ts
index 2a832ac7..7f03bfcd 100644
--- a/packages/cashscript/test/fixture/Bar.artifact.ts
+++ b/packages/cashscript/test/fixture/Bar.artifact.ts
@@ -30,7 +30,7 @@ export default {
     },
   ],
   bytecode: 'OP_OVER OP_0 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_OVER OP_1 OP_NUMEQUAL OP_IF OP_2 OP_2 OP_NUMEQUAL OP_NIP OP_NIP OP_ELSE OP_SWAP OP_2 OP_NUMEQUALVERIFY OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG OP_ENDIF OP_ENDIF',
-  source: 'pragma cashscript >=0.10.2;\n\ncontract Bar(bytes20 pkh_bar) {\n    function funcA() {\n        require(2==2);\n    }\n\n    function funcB() {\n        require(2==2);\n    }\n\n    function execute(pubkey pk, sig s) {\n        console.log(\'Bar \'execute\' function called.\');\n        require(hash160(pk) == pkh_bar);\n        require(checkSig(s, pk));\n    }\n}\n',
+  source: 'pragma cashscript >=0.10.2;\n\ncontract Bar(bytes20 pkh_bar) {\n    function funcA() {\n        require(2==2);\n    }\n\n    function funcB() {\n        require(2==2);\n    }\n\n    function execute(pubkey pk, sig s) {\n        console.log("Bar \'execute\' function called.");\n        require(hash160(pk) == pkh_bar);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
     bytecode: '78009c6352529c77776778519c6352529c7777677c529d78a988ac6868',
     sourceMap: '4:4:6:5;;;;5:16:5:17;:19::20;:16:::1;4:4:6:5;;;8::10::0;;;;9:16:9:17;:19::20;:16:::1;8:4:10:5;;;12::16::0;;;14:24:14:26;:16::27:1;:8::40;15:16:15:31;3:0:17:1;',
@@ -66,5 +66,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:25.811Z',
+  updatedAt: '2025-06-16T14:40:54.432Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/Foo.artifact.ts b/packages/cashscript/test/fixture/Foo.artifact.ts
index 37925f5a..d90d83e7 100644
--- a/packages/cashscript/test/fixture/Foo.artifact.ts
+++ b/packages/cashscript/test/fixture/Foo.artifact.ts
@@ -22,7 +22,7 @@ export default {
     },
   ],
   bytecode: 'OP_OVER OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG',
-  source: 'pragma cashscript >=0.10.2;\n\ncontract Foo(bytes20 pkh_foo) {\n    // Require pk to match stored pkh and signature to match\n    function execute(pubkey pk, sig s) {\n        console.log(\'Foo \'execute\' function called.\');\n        require(hash160(pk) == pkh_foo);\n        require(checkSig(s, pk));\n    }\n}\n',
+  source: 'pragma cashscript >=0.10.2;\n\ncontract Foo(bytes20 pkh_foo) {\n    // Require pk to match stored pkh and signature to match\n    function execute(pubkey pk, sig s) {\n        console.log("Foo \'execute\' function called.");\n        require(hash160(pk) == pkh_foo);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
     bytecode: '78a988ac',
     sourceMap: '7:24:7:26;:16::27:1;:8::40;8:16:8:31',
@@ -50,5 +50,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:26.288Z',
+  updatedAt: '2025-06-16T14:40:54.992Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
index e9f962cf..fc7d9982 100644
--- a/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
@@ -13,7 +13,7 @@ export default {
     },
   ],
   bytecode: 'OP_INPUTINDEX OP_0 OP_NUMEQUALVERIFY OP_1 OP_UTXOBYTECODE OP_OVER OP_EQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_EQUAL',
-  source: 'contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log(\'inputBytecode:\', inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\');\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log(\'outputBytecode:\', outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, \'output bytecode should match\');\n    }\n}\n',
+  source: 'contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log("inputBytecode:", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, "input bytecode should match");\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log("outputBytecode:", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, "output bytecode should match");\n    }\n}\n',
   debug: {
     bytecode: 'c0009d51c7788851cd87',
     sourceMap: '3:16:3:37;:41::42;:8::44:1;5:40:5:41:0;:30::58:1;7:33:7:56:0;:8::89:1;9:42:9:43:0;:31::60:1;11:16:11:57',
@@ -64,5 +64,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-06-10T10:02:43.222Z',
+  updatedAt: '2025-06-16T14:40:53.951Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/announcement.artifact.ts b/packages/cashscript/test/fixture/announcement.artifact.ts
index dbae5976..26063082 100644
--- a/packages/cashscript/test/fixture/announcement.artifact.ts
+++ b/packages/cashscript/test/fixture/announcement.artifact.ts
@@ -8,7 +8,7 @@ export default {
     },
   ],
   bytecode: '6a 6d02 OP_SIZE OP_SWAP OP_CAT OP_CAT 4120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e OP_SIZE OP_DUP 4b OP_GREATERTHAN OP_IF 4c OP_SWAP OP_CAT OP_ENDIF OP_SWAP OP_CAT OP_CAT OP_0 OP_OUTPUTVALUE OP_0 OP_NUMEQUALVERIFY OP_0 OP_OUTPUTBYTECODE OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_OVER OP_SUB OP_DUP OP_ROT OP_GREATERTHANOREQUAL OP_IF OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_DROP OP_1',
-  source: 'pragma cashscript >=0.8.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an \'announcement\' on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes(\'A contract may not injure a human being or, through inaction, allow a human being to come to harm.\')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there\'s enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n',
+  source: 'pragma cashscript >=0.8.0;\n\n/* This is a contract showcasing covenants outside of regular transactional use.\n * It enforces the contract to make an "announcement" on Memo.cash, and send the\n * remainder of contract funds back to the contract.\n */\ncontract Announcement() {\n    function announce() {\n        // Create the memo.cash announcement output\n        bytes announcement = new LockingBytecodeNullData([\n            0x6d02,\n            bytes(\'A contract may not injure a human being or, through inaction, allow a human being to come to harm.\')\n        ]);\n\n        // Check that the first tx output matches the announcement\n        require(tx.outputs[0].value == 0);\n        require(tx.outputs[0].lockingBytecode == announcement);\n\n        // Calculate leftover money after fee (1000 sats)\n        // Check that the second tx output sends the change back if there\'s enough leftover for another announcement\n        int minerFee = 1000;\n        int changeAmount = tx.inputs[this.activeInputIndex].value - minerFee;\n        if (changeAmount >= minerFee) {\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeAmount);\n        }\n    }\n}\n',
   debug: {
     bytecode: '016a026d02827c7e7e4c624120636f6e7472616374206d6179206e6f7420696e6a75726520612068756d616e206265696e67206f722c207468726f75676820696e616374696f6e2c20616c6c6f7720612068756d616e206265696e6720746f20636f6d6520746f206861726d2e8276014ba063014c7c7e687c7e7e00cc009d00cd8802e803c0c67894767ba26351cdc0c78851cc789d687551',
     sourceMap: '10:29:13:10;11:12:11:18;::::1;;;;12:18:12:118:0;:12::119:1;;;;;;;;;;;;16:27:16:28:0;:16::35:1;:39::40:0;:8::42:1;17:27:17:28:0;:16::45:1;:8::63;21:23:21:27:0;22:37:22:58;:27::65:1;:68::76:0;:27:::1;23:12:23:24:0;:28::36;:12:::1;:38:26:9:0;24:31:24:32;:20::49:1;:63::84:0;:53::101:1;:12::103;25:31:25:32:0;:20::39:1;:43::55:0;:12::57:1;23:38:26:9;8:4:27:5;',
@@ -36,5 +36,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:25.333Z',
+  updatedAt: '2025-06-16T14:40:53.438Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
index 4b7296e7..1631b1dc 100644
--- a/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
+++ b/packages/cashscript/test/fixture/libauth-template/multi-contract-fixtures.ts
@@ -220,7 +220,7 @@ export const fixtures: Fixture[] = [
         'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
-          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log('Bar 'execute' function called.'); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
+          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log(\"Bar 'execute' function called.\"); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
         },
         'Bar_execute_input4_unlock': {
           'passes': [
@@ -241,7 +241,7 @@ export const fixtures: Fixture[] = [
         'Foo_432c93902a8a8e49ef246028e707cddaa67a39af46b2b3c11c196cd09c931746_lock': {
           'lockingType': 'p2sh32',
           'name': 'Foo',
-          'script': "// \"Foo\" contract constructor parameters\n<pkh_foo> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                                  */\n                                  /*                                                              */\n                                  /* contract Foo(bytes20 pkh_foo) {                              */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function execute(pubkey pk, sig s) {                     */\n                                  /*         console.log('Foo 'execute' function called.');       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_foo);                     */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */",
+          'script': "// \"Foo\" contract constructor parameters\n<pkh_foo> // bytes20 = <0xb40a2013337edb0dfe307f0a57d5dec5bfe60dd0>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                                  */\n                                  /*                                                              */\n                                  /* contract Foo(bytes20 pkh_foo) {                              */\n                                  /*     // Require pk to match stored pkh and signature to match */\n                                  /*     function execute(pubkey pk, sig s) {                     */\n                                  /*         console.log(\"Foo 'execute' function called.\");       */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_foo);                     */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                            */\n                                  /*     }                                                        */\n                                  /* }                                                            */\n                                  /*                                                              */",
         },
         'Bar_funcB_input6_unlock': {
           'passes': [
@@ -1333,7 +1333,7 @@ export const fixtures: Fixture[] = [
         'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
-          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log('Bar 'execute' function called.'); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
+          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log(\"Bar 'execute' function called.\"); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
         },
       },
       'scenarios': {
@@ -2669,7 +2669,7 @@ export const fixtures: Fixture[] = [
         'Bar_dfa9a690eb3692ca0655d91a1bebf908bd27f73faf31ec7fe316bde6c0fbed2e_lock': {
           'lockingType': 'p2sh32',
           'name': 'Bar',
-          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log('Bar 'execute' function called.'); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
+          'script': "// \"Bar\" contract constructor parameters\n<pkh_bar> // bytes20 = <0x512dbb2c8c02efbac8d92431aa0ac33f6b0bf970>\n\n// bytecode\n                                  /* pragma cashscript >=0.10.2;                            */\n                                  /*                                                        */\n                                  /* contract Bar(bytes20 pkh_bar) {                        */\nOP_OVER OP_0 OP_NUMEQUAL OP_IF    /*     function funcA() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_OVER OP_1 OP_NUMEQUAL OP_IF    /*     function funcB() {                                 */\nOP_2 OP_2 OP_NUMEQUAL             /*         require(2==2);                                 */\nOP_NIP OP_NIP OP_ELSE             /*     }                                                  */\n                                  /*                                                        */\nOP_SWAP OP_2 OP_NUMEQUALVERIFY    /*     function execute(pubkey pk, sig s) {               */\n                                  /*         console.log(\"Bar 'execute' function called.\"); */\nOP_OVER OP_HASH160 OP_EQUALVERIFY /*         require(hash160(pk) == pkh_bar);               */\nOP_CHECKSIG                       /*         require(checkSig(s, pk));                      */\n                                  /*     }                                                  */\nOP_ENDIF OP_ENDIF                 /* }                                                      */\n                                  /*                                                        */",
         },
         'Bar_execute_input1_unlock': {
           'passes': [
diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index 9bafdf4e..dbd0b6d9 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -210,7 +210,7 @@ describe('Multi-Contract-Debugging tests', () => {
           .addOutput({ to: correctContract.address, amount: incorrectContractUtxo.satoshis - 2000n });
 
         expect(tx).toFailRequireWith('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: input bytecode should match.');
-        expect(tx).toFailRequireWith('Failing statement: require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\')');
+        expect(tx).toFailRequireWith('Failing statement: require(inputBytecode == expectedLockingBytecode, "input bytecode should match")');
       });
 
       it('should fail with correct error message when introspected output bytecode of a sibling UTXO does not match', () => {
diff --git a/packages/utils/src/artifact.ts b/packages/utils/src/artifact.ts
index 7cb1567e..9d1a463e 100644
--- a/packages/utils/src/artifact.ts
+++ b/packages/utils/src/artifact.ts
@@ -69,9 +69,10 @@ export function formatArtifact(artifact: Artifact, format: 'json' | 'ts'): strin
 const indent = (level: number): string => '  '.repeat(level);
 
 function stringifyAsTs(obj: any, indentationLevel: number = 1): string {
-  // For strings, we use JSON.stringify, but we convert double quotes to single quotes
+  // For strings we use JSON.stringify to handle escaping, but we want to use single quotes instead of double quotes
+  // around string values inside objects, to match regular TS style
   if (typeof obj === 'string') {
-    return JSON.stringify(obj).replace(/'/g, "\\'").replace(/"/g, "'");
+    return `'${JSON.stringify(obj).replace(/'/g, "\\'").replace(/\\"/g, '"').slice(1, -1)}'`;
   }
 
   // Numbers and booleans are just converted to strings

From ce1a0ada6498fe6741a1ff9d101d15414347da60 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 16 Jun 2025 17:26:02 +0200
Subject: [PATCH 259/267] Fix 'reconstructed' require message bug

---
 .../cashc/src/generation/GenerateTargetTraversal.ts   |  8 +++++++-
 packages/cashscript/src/Errors.ts                     | 11 +----------
 packages/cashscript/test/debugging.test.ts            |  7 +++++--
 packages/cashscript/test/e2e/MultiContract.test.ts    |  2 +-
 packages/cashscript/test/fixture/Bar.artifact.ts      |  4 ++--
 packages/cashscript/test/fixture/Bar.json             |  4 ++--
 packages/cashscript/test/fixture/Foo.artifact.ts      |  4 ++--
 packages/cashscript/test/fixture/Foo.json             |  4 ++--
 .../test/fixture/SiblingIntrospection.artifact.ts     |  6 +++---
 .../cashscript/test/fixture/SiblingIntrospection.cash |  4 ++--
 .../cashscript/test/fixture/SiblingIntrospection.json |  6 +++---
 packages/cashscript/test/fixture/bigint.artifact.ts   |  4 ++--
 packages/cashscript/test/fixture/bigint.json          |  4 ++--
 .../cashscript/test/fixture/bounded_bytes.artifact.ts |  4 ++--
 packages/cashscript/test/fixture/bounded_bytes.json   |  4 ++--
 .../cashscript/test/fixture/hodl_vault.artifact.ts    |  4 ++--
 packages/cashscript/test/fixture/hodl_vault.json      |  4 ++--
 packages/cashscript/test/fixture/mecenas.artifact.ts  |  4 ++--
 packages/cashscript/test/fixture/mecenas.json         |  4 ++--
 .../cashscript/test/fixture/p2palindrome.artifact.ts  |  4 ++--
 packages/cashscript/test/fixture/p2palindrome.json    |  4 ++--
 packages/cashscript/test/fixture/p2pkh.artifact.ts    |  4 ++--
 packages/cashscript/test/fixture/p2pkh.json           |  4 ++--
 .../fixture/token_category_comparison.artifact.ts     |  4 ++--
 .../test/fixture/token_category_comparison.json       |  4 ++--
 .../test/fixture/transfer_with_timeout.artifact.ts    |  4 ++--
 .../test/fixture/transfer_with_timeout.json           |  4 ++--
 .../cashscript/test/multi-contract-debugging.test.ts  |  4 ++--
 28 files changed, 64 insertions(+), 64 deletions(-)

diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index d4357f15..add64e94 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -199,7 +199,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
     // "OP_VERIFY", "OP_CHECK{LOCKTIME|SEQUENCE}VERIFY OP_DROP" or "OP_ENDIF"
 
     const finalOp = this.output.pop() as Op;
-    const { location } = this.locationData.pop()!;
+    const { location, positionHint } = this.locationData.pop()!;
 
     // If the final op is OP_VERIFY and the stack size is less than 4 we remove it from the script
     // - We have the stack size check because it is more efficient to use 2DROP rather than NIP
@@ -208,6 +208,12 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
       // Since the final value is no longer popped from the stack by OP_VERIFY,
       // we add it back to the stack
       this.pushToStack('(value)');
+
+      // Replace the location data of the final check (e.g. (x == 1)) with the location data of the
+      // full require statement including the removed OP_VERIFY (e.g. require(x == 1)), because
+      // the check opcode (e.g. OP_EQUAL) now represents the entire require statement (incl implicit OP_VERIFY)
+      this.locationData.pop();
+      this.locationData.push({ location, positionHint });
     } else {
       this.emit(finalOp, { location, positionHint: PositionHint.END });
 
diff --git a/packages/cashscript/src/Errors.ts b/packages/cashscript/src/Errors.ts
index 5b6029b8..ca03fec7 100644
--- a/packages/cashscript/src/Errors.ts
+++ b/packages/cashscript/src/Errors.ts
@@ -71,16 +71,7 @@ export class FailedRequireError extends FailedTransactionError {
     public bitauthUri: string,
     public libauthErrorMessage?: string,
   ) {
-    let { statement, lineNumber } = getLocationDataForInstructionPointer(artifact, failingInstructionPointer);
-
-    if (!statement.includes('require')) {
-      statement = requireStatement.message
-        ? `require(${statement}, "${requireStatement.message}")`
-        : `require(${statement})`;
-
-      // Sometimes in reconstructed multiline require statements, we get double commas
-      statement = statement.replace(/,,/g, ',');
-    }
+    const { statement, lineNumber } = getLocationDataForInstructionPointer(artifact, failingInstructionPointer);
 
     const baseMessage = `${artifact.contractName}.cash:${lineNumber} Require statement failed at input ${inputIndex} in contract ${artifact.contractName}.cash at line ${lineNumber}`;
     const baseMessageWithRequireMessage = `${baseMessage} with the following message: ${requireStatement.message}`;
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index aa757a66..7aaa3071 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -395,8 +395,11 @@ describe('Debugging tests', () => {
         )
         .addOutput({ to: contractTestMultiLineRequires.address, amount: 1000n });
 
-      expect(transaction).toFailRequireWith('Test.cash:36 Require statement failed at input 0 in contract Test.cash at line 36 with the following message: 1 should equal 2.');
-      expect(transaction).toFailRequireWith('Failing statement: require(1 == 2, "1 should equal 2")');
+      expect(transaction).toFailRequireWith('Test.cash:35 Require statement failed at input 0 in contract Test.cash at line 35 with the following message: 1 should equal 2.');
+      expect(transaction).toFailRequireWith(`Failing statement: require(
+      1 == 2,
+      "1 should equal 2"
+    );`);
     });
 
     // test_multiline_require_with_unary_op
diff --git a/packages/cashscript/test/e2e/MultiContract.test.ts b/packages/cashscript/test/e2e/MultiContract.test.ts
index e75d0ffb..c6d37613 100644
--- a/packages/cashscript/test/e2e/MultiContract.test.ts
+++ b/packages/cashscript/test/e2e/MultiContract.test.ts
@@ -253,7 +253,7 @@ describe('Multi Contract', () => {
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
       await expect(txPromise).rejects.toThrow('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: input bytecode should match.');
-      await expect(txPromise).rejects.toThrow('Failing statement: require(inputBytecode == expectedLockingBytecode, "input bytecode should match")');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\')');
     });
   });
 });
diff --git a/packages/cashscript/test/fixture/Bar.artifact.ts b/packages/cashscript/test/fixture/Bar.artifact.ts
index 7f03bfcd..ed92e583 100644
--- a/packages/cashscript/test/fixture/Bar.artifact.ts
+++ b/packages/cashscript/test/fixture/Bar.artifact.ts
@@ -33,7 +33,7 @@ export default {
   source: 'pragma cashscript >=0.10.2;\n\ncontract Bar(bytes20 pkh_bar) {\n    function funcA() {\n        require(2==2);\n    }\n\n    function funcB() {\n        require(2==2);\n    }\n\n    function execute(pubkey pk, sig s) {\n        console.log("Bar \'execute\' function called.");\n        require(hash160(pk) == pkh_bar);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
     bytecode: '78009c6352529c77776778519c6352529c7777677c529d78a988ac6868',
-    sourceMap: '4:4:6:5;;;;5:16:5:17;:19::20;:16:::1;4:4:6:5;;;8::10::0;;;;9:16:9:17;:19::20;:16:::1;8:4:10:5;;;12::16::0;;;14:24:14:26;:16::27:1;:8::40;15:16:15:31;3:0:17:1;',
+    sourceMap: '4:4:6:5;;;;5:16:5:17;:19::20;:8::22:1;4:4:6:5;;;8::10::0;;;;9:16:9:17;:19::20;:8::22:1;8:4:10:5;;;12::16::0;;;14:24:14:26;:16::27:1;:8::40;15::15:33;3:0:17:1;',
     logs: [
       {
         ip: 24,
@@ -66,5 +66,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-06-16T14:40:54.432Z',
+  updatedAt: '2025-06-16T15:05:54.204Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/Bar.json b/packages/cashscript/test/fixture/Bar.json
index 9240be6f..fbf1f61a 100644
--- a/packages/cashscript/test/fixture/Bar.json
+++ b/packages/cashscript/test/fixture/Bar.json
@@ -33,7 +33,7 @@
   "source": "pragma cashscript >=0.10.2;\n\ncontract Bar(bytes20 pkh_bar) {\n    function funcA() {\n        require(2==2);\n    }\n\n    function funcB() {\n        require(2==2);\n    }\n\n    function execute(pubkey pk, sig s) {\n        console.log(\"Bar 'execute' function called.\");\n        require(hash160(pk) == pkh_bar);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
     "bytecode": "78009c6352529c77776778519c6352529c7777677c529d78a988ac6868",
-    "sourceMap": "4:4:6:5;;;;5:16:5:17;:19::20;:16:::1;4:4:6:5;;;8::10::0;;;;9:16:9:17;:19::20;:16:::1;8:4:10:5;;;12::16::0;;;14:24:14:26;:16::27:1;:8::40;15:16:15:31;3:0:17:1;",
+    "sourceMap": "4:4:6:5;;;;5:16:5:17;:19::20;:8::22:1;4:4:6:5;;;8::10::0;;;;9:16:9:17;:19::20;:8::22:1;8:4:10:5;;;12::16::0;;;14:24:14:26;:16::27:1;:8::40;15::15:33;3:0:17:1;",
     "logs": [
       {
         "ip": 24,
@@ -66,5 +66,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:25.571Z"
+  "updatedAt": "2025-06-16T15:05:53.940Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/Foo.artifact.ts b/packages/cashscript/test/fixture/Foo.artifact.ts
index d90d83e7..81fc5221 100644
--- a/packages/cashscript/test/fixture/Foo.artifact.ts
+++ b/packages/cashscript/test/fixture/Foo.artifact.ts
@@ -25,7 +25,7 @@ export default {
   source: 'pragma cashscript >=0.10.2;\n\ncontract Foo(bytes20 pkh_foo) {\n    // Require pk to match stored pkh and signature to match\n    function execute(pubkey pk, sig s) {\n        console.log("Foo \'execute\' function called.");\n        require(hash160(pk) == pkh_foo);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
     bytecode: '78a988ac',
-    sourceMap: '7:24:7:26;:16::27:1;:8::40;8:16:8:31',
+    sourceMap: '7:24:7:26;:16::27:1;:8::40;8::8:33',
     logs: [
       {
         ip: 1,
@@ -50,5 +50,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-06-16T14:40:54.992Z',
+  updatedAt: '2025-06-16T15:05:54.732Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/Foo.json b/packages/cashscript/test/fixture/Foo.json
index e658fbd9..4e3e6bcc 100644
--- a/packages/cashscript/test/fixture/Foo.json
+++ b/packages/cashscript/test/fixture/Foo.json
@@ -25,7 +25,7 @@
   "source": "pragma cashscript >=0.10.2;\n\ncontract Foo(bytes20 pkh_foo) {\n    // Require pk to match stored pkh and signature to match\n    function execute(pubkey pk, sig s) {\n        console.log(\"Foo 'execute' function called.\");\n        require(hash160(pk) == pkh_foo);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
     "bytecode": "78a988ac",
-    "sourceMap": "7:24:7:26;:16::27:1;:8::40;8:16:8:31",
+    "sourceMap": "7:24:7:26;:16::27:1;:8::40;8::8:33",
     "logs": [
       {
         "ip": 1,
@@ -50,5 +50,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:26.046Z"
+  "updatedAt": "2025-06-16T15:05:54.487Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
index fc7d9982..3a3bcdb5 100644
--- a/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
@@ -13,10 +13,10 @@ export default {
     },
   ],
   bytecode: 'OP_INPUTINDEX OP_0 OP_NUMEQUALVERIFY OP_1 OP_UTXOBYTECODE OP_OVER OP_EQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_EQUAL',
-  source: 'contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log("inputBytecode:", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, "input bytecode should match");\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log("outputBytecode:", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, "output bytecode should match");\n    }\n}\n',
+  source: 'contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log("inputBytecode:", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\');\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log("outputBytecode:", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, \'output bytecode should match\');\n    }\n}\n',
   debug: {
     bytecode: 'c0009d51c7788851cd87',
-    sourceMap: '3:16:3:37;:41::42;:8::44:1;5:40:5:41:0;:30::58:1;7:33:7:56:0;:8::89:1;9:42:9:43:0;:31::60:1;11:16:11:57',
+    sourceMap: '3:16:3:37;:41::42;:8::44:1;5:40:5:41:0;:30::58:1;7:33:7:56:0;:8::89:1;9:42:9:43:0;:31::60:1;11:8:11:91',
     logs: [
       {
         ip: 6,
@@ -64,5 +64,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-06-16T14:40:53.951Z',
+  updatedAt: '2025-06-16T15:05:53.699Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.cash b/packages/cashscript/test/fixture/SiblingIntrospection.cash
index 21ed5955..5707f9bf 100644
--- a/packages/cashscript/test/fixture/SiblingIntrospection.cash
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.cash
@@ -4,10 +4,10 @@ contract SiblingIntrospection(bytes expectedLockingBytecode) {
 
         bytes inputBytecode = tx.inputs[1].lockingBytecode;
         console.log("inputBytecode:", inputBytecode);
-        require(inputBytecode == expectedLockingBytecode, "input bytecode should match");
+        require(inputBytecode == expectedLockingBytecode, 'input bytecode should match');
 
         bytes outputBytecode = tx.outputs[1].lockingBytecode;
         console.log("outputBytecode:", outputBytecode);
-        require(outputBytecode == expectedLockingBytecode, "output bytecode should match");
+        require(outputBytecode == expectedLockingBytecode, 'output bytecode should match');
     }
 }
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.json b/packages/cashscript/test/fixture/SiblingIntrospection.json
index 6f12f6f8..0dc23c9c 100644
--- a/packages/cashscript/test/fixture/SiblingIntrospection.json
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.json
@@ -13,10 +13,10 @@
     }
   ],
   "bytecode": "OP_INPUTINDEX OP_0 OP_NUMEQUALVERIFY OP_1 OP_UTXOBYTECODE OP_OVER OP_EQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_EQUAL",
-  "source": "contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log(\"inputBytecode:\", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, \"input bytecode should match\");\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log(\"outputBytecode:\", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, \"output bytecode should match\");\n    }\n}\n",
+  "source": "contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log(\"inputBytecode:\", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, 'input bytecode should match');\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log(\"outputBytecode:\", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, 'output bytecode should match');\n    }\n}\n",
   "debug": {
     "bytecode": "c0009d51c7788851cd87",
-    "sourceMap": "3:16:3:37;:41::42;:8::44:1;5:40:5:41:0;:30::58:1;7:33:7:56:0;:8::89:1;9:42:9:43:0;:31::60:1;11:16:11:57",
+    "sourceMap": "3:16:3:37;:41::42;:8::44:1;5:40:5:41:0;:30::58:1;7:33:7:56:0;:8::89:1;9:42:9:43:0;:31::60:1;11:8:11:91",
     "logs": [
       {
         "ip": 6,
@@ -64,5 +64,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-06-10T10:02:42.898Z"
+  "updatedAt": "2025-06-16T15:05:53.452Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bigint.artifact.ts b/packages/cashscript/test/fixture/bigint.artifact.ts
index 76c6283c..804a9c4b 100644
--- a/packages/cashscript/test/fixture/bigint.artifact.ts
+++ b/packages/cashscript/test/fixture/bigint.artifact.ts
@@ -20,7 +20,7 @@ export default {
   source: 'contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt64PlusOne = 9223372036854775808;\n        require(x >= maxInt64PlusOne);\n        require(x * y >= maxInt64PlusOne);\n    }\n}\n',
   debug: {
     bytecode: '090000000000000080006ea2697c7b95a1',
-    sourceMap: '3:30:3:49;4:16:4:36;::::1;:8::38;5:16:5:17:0;:20::21;:16:::1;:::40',
+    sourceMap: '3:30:3:49;4:16:4:36;::::1;:8::38;5:16:5:17:0;:20::21;:16:::1;:8::42',
     logs: [],
     requires: [
       {
@@ -37,5 +37,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:24.855Z',
+  updatedAt: '2025-06-16T15:05:52.713Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index 3ddce027..82048fac 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -20,7 +20,7 @@
   "source": "contract BigInt() {\n    function proofOfBigInt(int x, int y) {\n        int maxInt64PlusOne = 9223372036854775808;\n        require(x >= maxInt64PlusOne);\n        require(x * y >= maxInt64PlusOne);\n    }\n}\n",
   "debug": {
     "bytecode": "090000000000000080006ea2697c7b95a1",
-    "sourceMap": "3:30:3:49;4:16:4:36;::::1;:8::38;5:16:5:17:0;:20::21;:16:::1;:::40",
+    "sourceMap": "3:30:3:49;4:16:4:36;::::1;:8::38;5:16:5:17:0;:20::21;:16:::1;:8::42",
     "logs": [],
     "requires": [
       {
@@ -37,5 +37,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:24.621Z"
+  "updatedAt": "2025-06-16T15:05:52.485Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/bounded_bytes.artifact.ts b/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
index b4b7d907..dea3fcbb 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
+++ b/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
@@ -20,7 +20,7 @@ export default {
   source: 'contract BoundedBytes() {\n    function spend(bytes4 b, int i) {\n        require(b == bytes4(i));\n    }\n}\n',
   debug: {
     bytecode: '7c548087',
-    sourceMap: '3:28:3:29;:21::30:1;;:16',
+    sourceMap: '3:28:3:29;:21::30:1;;:8::32',
     logs: [],
     requires: [
       {
@@ -33,5 +33,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:27.812Z',
+  updatedAt: '2025-06-16T15:05:56.281Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index 0cd8cfed..5925cff3 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -20,7 +20,7 @@
   "source": "contract BoundedBytes() {\n    function spend(bytes4 b, int i) {\n        require(b == bytes4(i));\n    }\n}\n",
   "debug": {
     "bytecode": "7c548087",
-    "sourceMap": "3:28:3:29;:21::30:1;;:16",
+    "sourceMap": "3:28:3:29;:21::30:1;;:8::32",
     "logs": [],
     "requires": [
       {
@@ -33,5 +33,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:27.596Z"
+  "updatedAt": "2025-06-16T15:05:56.024Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/hodl_vault.artifact.ts b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
index 9deb25b1..5ea474b1 100644
--- a/packages/cashscript/test/fixture/hodl_vault.artifact.ts
+++ b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
@@ -41,7 +41,7 @@ export default {
   source: '// This contract forces HODLing until a certain price target has been reached\n// A minimum block is provided to ensure that oracle price entries from before this block are disregarded\n// i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used.\n// Instead, a message with a block number and price from after the minBlock needs to be passed.\n// This contract serves as a simple example for checkDataSig-based contracts.\ncontract HodlVault(\n    pubkey ownerPk,\n    pubkey oraclePk,\n    int minBlock,\n    int priceTarget\n) {\n    function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {\n        // message: { blockHeight, price }\n        bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);\n        int blockHeight = int(blockHeightBin);\n        int price = int(priceBin);\n\n        // Check that blockHeight is after minBlock and not in the future\n        require(blockHeight >= minBlock);\n        require(tx.time >= blockHeight);\n\n        // Check that current price is at least priceTarget\n        require(price >= priceTarget);\n\n        // Handle necessary signature checks\n        require(checkDataSig(oracleSig, oracleMessage, oraclePk));\n        require(checkSig(ownerSig, ownerPk));\n    }\n}\n',
   debug: {
     bytecode: '5679547f7c817c8178557aa2697cb175537aa269537a547a537abbac',
-    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:8::66:1;27:16:27:43',
+    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:8::66:1;27::27:45',
     logs: [],
     requires: [
       {
@@ -70,5 +70,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:26.850Z',
+  updatedAt: '2025-06-16T15:05:55.227Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index 803ebc23..b82703a5 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -41,7 +41,7 @@
   "source": "// This contract forces HODLing until a certain price target has been reached\n// A minimum block is provided to ensure that oracle price entries from before this block are disregarded\n// i.e. when the BCH price was $1000 in the past, an oracle entry with the old block number and price can not be used.\n// Instead, a message with a block number and price from after the minBlock needs to be passed.\n// This contract serves as a simple example for checkDataSig-based contracts.\ncontract HodlVault(\n    pubkey ownerPk,\n    pubkey oraclePk,\n    int minBlock,\n    int priceTarget\n) {\n    function spend(sig ownerSig, datasig oracleSig, bytes8 oracleMessage) {\n        // message: { blockHeight, price }\n        bytes4 blockHeightBin, bytes4 priceBin = oracleMessage.split(4);\n        int blockHeight = int(blockHeightBin);\n        int price = int(priceBin);\n\n        // Check that blockHeight is after minBlock and not in the future\n        require(blockHeight >= minBlock);\n        require(tx.time >= blockHeight);\n\n        // Check that current price is at least priceTarget\n        require(price >= priceTarget);\n\n        // Handle necessary signature checks\n        require(checkDataSig(oracleSig, oracleMessage, oraclePk));\n        require(checkSig(ownerSig, ownerPk));\n    }\n}\n",
   "debug": {
     "bytecode": "5679547f7c817c8178557aa2697cb175537aa269537a547a537abbac",
-    "sourceMap": "14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:8::66:1;27:16:27:43",
+    "sourceMap": "14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:8::66:1;27::27:45",
     "logs": [],
     "requires": [
       {
@@ -70,5 +70,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:26.630Z"
+  "updatedAt": "2025-06-16T15:05:54.980Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/mecenas.artifact.ts b/packages/cashscript/test/fixture/mecenas.artifact.ts
index c95fc9da..dff019a7 100644
--- a/packages/cashscript/test/fixture/mecenas.artifact.ts
+++ b/packages/cashscript/test/fixture/mecenas.artifact.ts
@@ -37,7 +37,7 @@ export default {
   source: 'pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho\'s Mecenas contract. It is\n * not compatible with Licho\'s EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(this.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
     bytecode: '5379009c6300cd0376a9147b7e0288ac7e8802e803c0c676547994527994765579547993a16300cc707c949d6700cc55799d51cdc0c78851cc789d686d6d6d5167537a519d5379a97b8872ac777768',
-    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::66:0;;::::1;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:12::51:1;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;:12::56:1;23:15:27:9;9:4:28:5;;;;;30::33::0;;;;31:24:31:26;;:16::27:1;:31::37:0;:8::39:1;32:25:32:30:0;:16::31:1;30:4:33:5;;8:0:34:1',
+    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::66:0;;::::1;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:12::51:1;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;:12::56:1;23:15:27:9;9:4:28:5;;;;;30::33::0;;;;31:24:31:26;;:16::27:1;:31::37:0;:8::39:1;32:25:32:30:0;:8::33:1;30:4:33:5;;8:0:34:1',
     logs: [],
     requires: [
       {
@@ -74,5 +74,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:29.858Z',
+  updatedAt: '2025-06-16T15:05:58.336Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index 4a4d14d1..0265e4e2 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -37,7 +37,7 @@
   "source": "pragma cashscript >=0.8.0;\n\n/* This is an unofficial CashScript port of Licho's Mecenas contract. It is\n * not compatible with Licho's EC plugin, but rather meant as a demonstration\n * of covenants in CashScript.\n * The time checking has been removed so it can be tested without time requirements.\n */\ncontract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */) {\n    function receive() {\n        // require(this.age >= period);\n\n        // Check that the first output sends to the recipient\n        require(tx.outputs[0].lockingBytecode == new LockingBytecodeP2PKH(recipient));\n\n        int minerFee = 1000;\n        int currentValue = tx.inputs[this.activeInputIndex].value;\n        int changeValue = currentValue - pledge - minerFee;\n\n        // If there is not enough left for *another* pledge after this one, we send the remainder to the recipient\n        // Otherwise we send the remainder to the recipient and the change back to the contract\n        if (changeValue <= pledge + minerFee) {\n            require(tx.outputs[0].value == currentValue - minerFee);\n        } else {\n            require(tx.outputs[0].value == pledge);\n            require(tx.outputs[1].lockingBytecode == tx.inputs[this.activeInputIndex].lockingBytecode);\n            require(tx.outputs[1].value == changeValue);\n        }\n    }\n\n    function reclaim(pubkey pk, sig s) {\n        require(hash160(pk) == funder);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
     "bytecode": "5379009c6300cd0376a9147b7e0288ac7e8802e803c0c676547994527994765579547993a16300cc707c949d6700cc55799d51cdc0c78851cc789d686d6d6d5167537a519d5379a97b8872ac777768",
-    "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::66:0;;::::1;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:12::51:1;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;:12::56:1;23:15:27:9;9:4:28:5;;;;;30::33::0;;;;31:24:31:26;;:16::27:1;:31::37:0;:8::39:1;32:25:32:30:0;:16::31:1;30:4:33:5;;8:0:34:1",
+    "sourceMap": "9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::66:0;;::::1;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:12::51:1;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;:12::56:1;23:15:27:9;9:4:28:5;;;;;30::33::0;;;;31:24:31:26;;:16::27:1;:31::37:0;:8::39:1;32:25:32:30:0;:8::33:1;30:4:33:5;;8:0:34:1",
     "logs": [],
     "requires": [
       {
@@ -74,5 +74,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:29.610Z"
+  "updatedAt": "2025-06-16T15:05:58.078Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2palindrome.artifact.ts b/packages/cashscript/test/fixture/p2palindrome.artifact.ts
index 59b9c41a..bd39a87d 100644
--- a/packages/cashscript/test/fixture/p2palindrome.artifact.ts
+++ b/packages/cashscript/test/fixture/p2palindrome.artifact.ts
@@ -16,7 +16,7 @@ export default {
   source: 'contract P2Palindrome() {\n    function spend(string palindrome) {\n        require(palindrome.reverse() == palindrome);\n    }\n}\n',
   debug: {
     bytecode: '76bc87',
-    sourceMap: '3:16:3:26;:::36:1;:::50',
+    sourceMap: '3:16:3:26;:::36:1;:8::52',
     logs: [],
     requires: [
       {
@@ -29,5 +29,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:27.355Z',
+  updatedAt: '2025-06-16T15:05:55.718Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index b6115e9f..c891aeed 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -16,7 +16,7 @@
   "source": "contract P2Palindrome() {\n    function spend(string palindrome) {\n        require(palindrome.reverse() == palindrome);\n    }\n}\n",
   "debug": {
     "bytecode": "76bc87",
-    "sourceMap": "3:16:3:26;:::36:1;:::50",
+    "sourceMap": "3:16:3:26;:::36:1;:8::52",
     "logs": [],
     "requires": [
       {
@@ -29,5 +29,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:27.126Z"
+  "updatedAt": "2025-06-16T15:05:55.464Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/p2pkh.artifact.ts b/packages/cashscript/test/fixture/p2pkh.artifact.ts
index 08d70e3b..4997312b 100644
--- a/packages/cashscript/test/fixture/p2pkh.artifact.ts
+++ b/packages/cashscript/test/fixture/p2pkh.artifact.ts
@@ -25,7 +25,7 @@ export default {
   source: 'contract P2PKH(bytes20 pkh) {\n    // Require pk to match stored pkh and signature to match\n    function spend(pubkey pk, sig s) {\n        require(hash160(pk) == pkh);\n        require(checkSig(s, pk));\n    }\n}\n',
   debug: {
     bytecode: '78a988ac',
-    sourceMap: '4:24:4:26;:16::27:1;:8::36;5:16:5:31',
+    sourceMap: '4:24:4:26;:16::27:1;:8::36;5::5:33',
     logs: [],
     requires: [
       {
@@ -42,5 +42,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:29.364Z',
+  updatedAt: '2025-06-16T15:05:57.831Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index 8fd2a72a..771e3500 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -25,7 +25,7 @@
   "source": "contract P2PKH(bytes20 pkh) {\n    // Require pk to match stored pkh and signature to match\n    function spend(pubkey pk, sig s) {\n        require(hash160(pk) == pkh);\n        require(checkSig(s, pk));\n    }\n}\n",
   "debug": {
     "bytecode": "78a988ac",
-    "sourceMap": "4:24:4:26;:16::27:1;:8::36;5:16:5:31",
+    "sourceMap": "4:24:4:26;:16::27:1;:8::36;5::5:33",
     "logs": [],
     "requires": [
       {
@@ -42,5 +42,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:29.115Z"
+  "updatedAt": "2025-06-16T15:05:57.597Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/token_category_comparison.artifact.ts b/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
index a9612b1b..210a5830 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
+++ b/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
@@ -11,7 +11,7 @@ export default {
   source: 'contract Test() {\n    function send() {\n        require(tx.inputs[1].tokenCategory == 0x);\n    }\n}\n',
   debug: {
     bytecode: '51ce0087',
-    sourceMap: '3:26:3:27;:16::42:1;:46::48:0;:16:::1',
+    sourceMap: '3:26:3:27;:16::42:1;:46::48:0;:8::50:1',
     logs: [],
     requires: [
       {
@@ -24,5 +24,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:28.885Z',
+  updatedAt: '2025-06-16T15:05:57.354Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/token_category_comparison.json b/packages/cashscript/test/fixture/token_category_comparison.json
index b2a607f6..fac09bdd 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.json
+++ b/packages/cashscript/test/fixture/token_category_comparison.json
@@ -11,7 +11,7 @@
   "source": "contract Test() {\n    function send() {\n        require(tx.inputs[1].tokenCategory == 0x);\n    }\n}\n",
   "debug": {
     "bytecode": "51ce0087",
-    "sourceMap": "3:26:3:27;:16::42:1;:46::48:0;:16:::1",
+    "sourceMap": "3:26:3:27;:16::42:1;:46::48:0;:8::50:1",
     "logs": [],
     "requires": [
       {
@@ -24,5 +24,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:28.558Z"
+  "updatedAt": "2025-06-16T15:05:57.130Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
index 32deb1ec..8151e93b 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
@@ -38,7 +38,7 @@ export default {
   source: 'contract TransferWithTimeout(\n    pubkey sender,\n    pubkey recipient,\n    int timeout\n) {\n    // Require recipient\'s signature to match\n    function transfer(sig recipientSig) {\n        require(checkSig(recipientSig, recipient));\n    }\n\n    // Require timeout time to be reached and sender\'s signature to match\n    function timeout(sig senderSig) {\n        require(checkSig(senderSig, sender));\n        require(tx.time >= timeout);\n    }\n}\n',
   debug: {
     bytecode: '5379009c63547a7bac77777767537a519d537a7cad7cb16d5168',
-    sourceMap: '7:4:9:5;;;;;8:25:8:37;;:39::48;:16::49:1;7:4:9:5;;;;12::15::0;;;;13:25:13:34;;:36::42;:8::45:1;14:27:14:34:0;:8::36:1;12:4:15:5;;1:0:16:1',
+    sourceMap: '7:4:9:5;;;;;8:25:8:37;;:39::48;:8::51:1;7:4:9:5;;;;12::15::0;;;;13:25:13:34;;:36::42;:8::45:1;14:27:14:34:0;:8::36:1;12:4:15:5;;1:0:16:1',
     logs: [],
     requires: [
       {
@@ -59,5 +59,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-05-11T10:02:28.290Z',
+  updatedAt: '2025-06-16T15:05:56.888Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index 940c9728..57499245 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -38,7 +38,7 @@
   "source": "contract TransferWithTimeout(\n    pubkey sender,\n    pubkey recipient,\n    int timeout\n) {\n    // Require recipient's signature to match\n    function transfer(sig recipientSig) {\n        require(checkSig(recipientSig, recipient));\n    }\n\n    // Require timeout time to be reached and sender's signature to match\n    function timeout(sig senderSig) {\n        require(checkSig(senderSig, sender));\n        require(tx.time >= timeout);\n    }\n}\n",
   "debug": {
     "bytecode": "5379009c63547a7bac77777767537a519d537a7cad7cb16d5168",
-    "sourceMap": "7:4:9:5;;;;;8:25:8:37;;:39::48;:16::49:1;7:4:9:5;;;;12::15::0;;;;13:25:13:34;;:36::42;:8::45:1;14:27:14:34:0;:8::36:1;12:4:15:5;;1:0:16:1",
+    "sourceMap": "7:4:9:5;;;;;8:25:8:37;;:39::48;:8::51:1;7:4:9:5;;;;12::15::0;;;;13:25:13:34;;:36::42;:8::45:1;14:27:14:34:0;:8::36:1;12:4:15:5;;1:0:16:1",
     "logs": [],
     "requires": [
       {
@@ -59,5 +59,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-05-11T10:02:28.047Z"
+  "updatedAt": "2025-06-16T15:05:56.646Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index dbd0b6d9..ab9d44f1 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -210,7 +210,7 @@ describe('Multi-Contract-Debugging tests', () => {
           .addOutput({ to: correctContract.address, amount: incorrectContractUtxo.satoshis - 2000n });
 
         expect(tx).toFailRequireWith('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: input bytecode should match.');
-        expect(tx).toFailRequireWith('Failing statement: require(inputBytecode == expectedLockingBytecode, "input bytecode should match")');
+        expect(tx).toFailRequireWith('Failing statement: require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\')');
       });
 
       it('should fail with correct error message when introspected output bytecode of a sibling UTXO does not match', () => {
@@ -221,7 +221,7 @@ describe('Multi-Contract-Debugging tests', () => {
           .addOutput({ to: incorrectContract.address, amount: correctContractUtxo.satoshis - 2000n });
 
         expect(tx).toFailRequireWith('SiblingIntrospection.cash:11 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 11 with the following message: output bytecode should match.');
-        expect(tx).toFailRequireWith('Failing statement: require(outputBytecode == expectedLockingBytecode, "output bytecode should match")');
+        expect(tx).toFailRequireWith('Failing statement: require(outputBytecode == expectedLockingBytecode, \'output bytecode should match\')');
       });
     });
 

From 0362f210df998a165ae3f7d6202c91a76815e0c2 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 16 Jun 2025 17:26:14 +0200
Subject: [PATCH 260/267] Update release notes for latest bug fixes

---
 website/docs/releases/release-notes.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 2d53003d..58c6ceaa 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -9,6 +9,7 @@ This update adds CashScript support for the new BCH 2025 network upgrade. To rea
 This release also contains several breaking changes, please refer to the [migration notes](/docs/releases/migration-notes) for more information.
 
 #### cashc compiler
+- :bug: Fix bug where source code in `--format ts` artifacts used incorrect quotation marks.
 - :hammer_and_wrench: Remove warning for opcount and update warning for byte size to match new limits.
 - :boom: **BREAKING**: `tx.age` was renamed to `this.age` to better reflect that it enforces a UTXO-level locktime check (*not* transaction-level).
 - :boom: **BREAKING**: The entire `debug` object on the artifact is reworked to enable debugging the optimised contract bytecode.
@@ -22,7 +23,7 @@ This release also contains several breaking changes, please refer to the [migrat
 - :sparkles: Add `setBlockHeight()` method to `MockNetworkProvider`
 - :sparkles: Config-free usage of the CashScript SDK with Vite or Webpack
 - :hammer_and_wrench: Update debug tooling to use the new `BCH_2025_05` instruction set.
-- :hammer_and_wrench: Deprecate the simple transaction builder. You can still use the simple transaction builder with the current SDK, but this support will be removed in a future release.
+- :hammer_and_wrench: Deprecate the simple transaction builder. You can still use the simple transaction builder with the current SDK, but this support will be removed in a future release
 - :boom: **BREAKING**: the Jest utilities for automated testing are now synchronous and no longer work with the deprecated simple transaction builder
   * `expect(transaction).toLog(message)`
   * `expect(transaction).toFailRequire()`
@@ -30,6 +31,7 @@ This release also contains several breaking changes, please refer to the [migrat
 - :boom: **BREAKING**: Remove support for custom Clusters from `ElectrumNetworkProvider` and added a configuration object to the constructor.
 - :boom: **BREAKING**: Remove support for old contracts compiled with CashScript v0.6.x or earlier.
 - :bug: Fix bug where `JestExtensions` `expect().toLog()` would detect logs from different tests.
+- :bug: Fix bug where certain edge cases in require statements caused the `FailedRequireError` message to be slightly different from the original error message.
 
 #### @cashscript/utils
 - :boom: **BREAKING**: Remove `importArtifact` and `exportArtifact` helper functions. If you want to import or export artifacts, use `'fs'` to read and write files directly.

From 607cfb5df92f38f5a88961a9886ea1606e953cb6 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 16 Jun 2025 18:18:08 +0200
Subject: [PATCH 261/267] Allow expect().toLog() to check across multiple logs
 in a single check + add loggerSpy cleanup to 'finally {}'

---
 .../cashscript/src/test/JestExtensions.ts     | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/packages/cashscript/src/test/JestExtensions.ts b/packages/cashscript/src/test/JestExtensions.ts
index b0c16ce4..929bda94 100644
--- a/packages/cashscript/src/test/JestExtensions.ts
+++ b/packages/cashscript/src/test/JestExtensions.ts
@@ -49,14 +49,21 @@ expect.extend({
     const message = (): string => `${matcherHint}\n\n${expectedText}\n${receivedText}`;
 
     try {
-      expect(loggerSpy).toBeCalledWith(match ? expect.stringMatching(match) : expect.anything());
-    } catch (e) {
-      return { message, pass: false };
+      // We first check if the expected string is present in any of the individual console.log calls
+      expect(loggerSpy).toHaveBeenCalledWith(match ? expect.stringMatching(match) : expect.anything());
+    } catch {
+      try {
+        // We add this extra check to allow expect().toLog() to check multiple console.log calls in a single test
+        // (e.g. for log ordering), which would fail the first check because that compares the individual console.log calls
+        expect(receivedBase).toMatch(match ? match : expect.anything());
+      } catch {
+        return { message, pass: false };
+      }
+    } finally {
+      // Restore the original console.log implementation
+      loggerSpy.mockRestore();
     }
 
-    // Restore the original console.log implementation
-    loggerSpy.mockRestore();
-
     return { message, pass: true };
   },
 });

From 81602c335e8af0a452beac7dfdeaf0f55bd1949d Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Mon, 16 Jun 2025 18:18:57 +0200
Subject: [PATCH 262/267] Add more multicontract debugging tests and slight
 updates to SiblingIntrospection.cash

---
 .../cashscript/test/e2e/MultiContract.test.ts |  4 +-
 .../fixture/SiblingIntrospection.artifact.ts  | 18 +++---
 .../test/fixture/SiblingIntrospection.cash    |  8 +--
 .../test/fixture/SiblingIntrospection.json    | 18 +++---
 .../test/multi-contract-debugging.test.ts     | 59 ++++++++++++++++---
 5 files changed, 74 insertions(+), 33 deletions(-)

diff --git a/packages/cashscript/test/e2e/MultiContract.test.ts b/packages/cashscript/test/e2e/MultiContract.test.ts
index c6d37613..451fb580 100644
--- a/packages/cashscript/test/e2e/MultiContract.test.ts
+++ b/packages/cashscript/test/e2e/MultiContract.test.ts
@@ -252,8 +252,8 @@ describe('Multi Contract', () => {
 
       // then
       await expect(txPromise).rejects.toThrow(FailedRequireError);
-      await expect(txPromise).rejects.toThrow('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: input bytecode should match.');
-      await expect(txPromise).rejects.toThrow('Failing statement: require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\')');
+      await expect(txPromise).rejects.toThrow('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: output bytecode should match.');
+      await expect(txPromise).rejects.toThrow('Failing statement: require(outputBytecode == expectedLockingBytecode, \'output bytecode should match\')');
     });
   });
 });
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
index 3a3bcdb5..722cbacc 100644
--- a/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
@@ -12,17 +12,17 @@ export default {
       inputs: [],
     },
   ],
-  bytecode: 'OP_INPUTINDEX OP_0 OP_NUMEQUALVERIFY OP_1 OP_UTXOBYTECODE OP_OVER OP_EQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_EQUAL',
-  source: 'contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log("inputBytecode:", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\');\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log("outputBytecode:", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, \'output bytecode should match\');\n    }\n}\n',
+  bytecode: 'OP_INPUTINDEX OP_0 OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_OVER OP_EQUALVERIFY OP_1 OP_UTXOBYTECODE OP_EQUAL',
+  source: 'contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log("outputBytecode:", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, \'output bytecode should match\');\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log("inputBytecode:", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\');\n    }\n}\n',
   debug: {
-    bytecode: 'c0009d51c7788851cd87',
-    sourceMap: '3:16:3:37;:41::42;:8::44:1;5:40:5:41:0;:30::58:1;7:33:7:56:0;:8::89:1;9:42:9:43:0;:31::60:1;11:8:11:91',
+    bytecode: 'c0009d51cd788851c787',
+    sourceMap: '3:16:3:37;:41::42;:8::44:1;5:42:5:43:0;:31::60:1;7:34:7:57:0;:8::91:1;9:40:9:41:0;:30::58:1;11:8:11:89',
     logs: [
       {
         ip: 6,
         line: 6,
         data: [
-          'inputBytecode:',
+          'outputBytecode:',
           {
             stackIndex: 0,
             type: 'bytes',
@@ -34,7 +34,7 @@ export default {
         ip: 10,
         line: 10,
         data: [
-          'outputBytecode:',
+          'inputBytecode:',
           {
             stackIndex: 0,
             type: 'bytes',
@@ -51,12 +51,12 @@ export default {
       {
         ip: 7,
         line: 7,
-        message: 'input bytecode should match',
+        message: 'output bytecode should match',
       },
       {
         ip: 11,
         line: 11,
-        message: 'output bytecode should match',
+        message: 'input bytecode should match',
       },
     ],
   },
@@ -64,5 +64,5 @@ export default {
     name: 'cashc',
     version: '0.11.0-next.4',
   },
-  updatedAt: '2025-06-16T15:05:53.699Z',
+  updatedAt: '2025-06-16T16:07:30.092Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.cash b/packages/cashscript/test/fixture/SiblingIntrospection.cash
index 5707f9bf..bfef1692 100644
--- a/packages/cashscript/test/fixture/SiblingIntrospection.cash
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.cash
@@ -2,12 +2,12 @@ contract SiblingIntrospection(bytes expectedLockingBytecode) {
     function spend() {
         require(this.activeInputIndex == 0);
 
-        bytes inputBytecode = tx.inputs[1].lockingBytecode;
-        console.log("inputBytecode:", inputBytecode);
-        require(inputBytecode == expectedLockingBytecode, 'input bytecode should match');
-
         bytes outputBytecode = tx.outputs[1].lockingBytecode;
         console.log("outputBytecode:", outputBytecode);
         require(outputBytecode == expectedLockingBytecode, 'output bytecode should match');
+
+        bytes inputBytecode = tx.inputs[1].lockingBytecode;
+        console.log("inputBytecode:", inputBytecode);
+        require(inputBytecode == expectedLockingBytecode, 'input bytecode should match');
     }
 }
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.json b/packages/cashscript/test/fixture/SiblingIntrospection.json
index 0dc23c9c..9479547b 100644
--- a/packages/cashscript/test/fixture/SiblingIntrospection.json
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.json
@@ -12,17 +12,17 @@
       "inputs": []
     }
   ],
-  "bytecode": "OP_INPUTINDEX OP_0 OP_NUMEQUALVERIFY OP_1 OP_UTXOBYTECODE OP_OVER OP_EQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_EQUAL",
-  "source": "contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log(\"inputBytecode:\", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, 'input bytecode should match');\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log(\"outputBytecode:\", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, 'output bytecode should match');\n    }\n}\n",
+  "bytecode": "OP_INPUTINDEX OP_0 OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_OVER OP_EQUALVERIFY OP_1 OP_UTXOBYTECODE OP_EQUAL",
+  "source": "contract SiblingIntrospection(bytes expectedLockingBytecode) {\n    function spend() {\n        require(this.activeInputIndex == 0);\n\n        bytes outputBytecode = tx.outputs[1].lockingBytecode;\n        console.log(\"outputBytecode:\", outputBytecode);\n        require(outputBytecode == expectedLockingBytecode, 'output bytecode should match');\n\n        bytes inputBytecode = tx.inputs[1].lockingBytecode;\n        console.log(\"inputBytecode:\", inputBytecode);\n        require(inputBytecode == expectedLockingBytecode, 'input bytecode should match');\n    }\n}\n",
   "debug": {
-    "bytecode": "c0009d51c7788851cd87",
-    "sourceMap": "3:16:3:37;:41::42;:8::44:1;5:40:5:41:0;:30::58:1;7:33:7:56:0;:8::89:1;9:42:9:43:0;:31::60:1;11:8:11:91",
+    "bytecode": "c0009d51cd788851c787",
+    "sourceMap": "3:16:3:37;:41::42;:8::44:1;5:42:5:43:0;:31::60:1;7:34:7:57:0;:8::91:1;9:40:9:41:0;:30::58:1;11:8:11:89",
     "logs": [
       {
         "ip": 6,
         "line": 6,
         "data": [
-          "inputBytecode:",
+          "outputBytecode:",
           {
             "stackIndex": 0,
             "type": "bytes",
@@ -34,7 +34,7 @@
         "ip": 10,
         "line": 10,
         "data": [
-          "outputBytecode:",
+          "inputBytecode:",
           {
             "stackIndex": 0,
             "type": "bytes",
@@ -51,12 +51,12 @@
       {
         "ip": 7,
         "line": 7,
-        "message": "input bytecode should match"
+        "message": "output bytecode should match"
       },
       {
         "ip": 11,
         "line": 11,
-        "message": "output bytecode should match"
+        "message": "input bytecode should match"
       }
     ]
   },
@@ -64,5 +64,5 @@
     "name": "cashc",
     "version": "0.11.0-next.4"
   },
-  "updatedAt": "2025-06-16T15:05:53.452Z"
+  "updatedAt": "2025-06-16T16:07:29.693Z"
 }
\ No newline at end of file
diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index ab9d44f1..156979e5 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -27,11 +27,52 @@ const provider = new MockNetworkProvider();
 
 describe('Multi-Contract-Debugging tests', () => {
   describe('console.log statements', () => {
-    it.todo('should log all executed console.log statements across all contracts');
-    it.todo('should not log statements that are not executed');
-    it.todo('should log console.log statements in the correct order (by input index)');
-    it.todo('should be able to log correct input bytecode for other contracts');
-    it.todo('should be able to log correct output bytecode for other contracts');
+    describe('Sibling introspection', () => {
+      const sameNameDifferentPathContract = new Contract(ARTIFACT_SAME_NAME_DIFFERENT_PATH, [0n], { provider });
+
+      const expectedLockingBytecode = addressToLockScript(sameNameDifferentPathContract.address);
+      const siblingIntrospectionContract = new Contract(
+        SiblingIntrospectionArtifact,
+        [expectedLockingBytecode],
+        { provider },
+      );
+
+      const sameNameDifferentPathContractUtxo = randomUtxo();
+      const siblingIntrospectionUtxo = randomUtxo();
+
+      (provider as any).addUtxo?.(sameNameDifferentPathContract.address, sameNameDifferentPathContractUtxo);
+      (provider as any).addUtxo?.(siblingIntrospectionContract.address, siblingIntrospectionUtxo);
+
+      it('should log correct data in all executed console.log statements across all contracts in the correct order by input index', () => {
+        const tx = new TransactionBuilder({ provider })
+          .addInput(siblingIntrospectionUtxo, siblingIntrospectionContract.unlock.spend())
+          .addInput(sameNameDifferentPathContractUtxo, sameNameDifferentPathContract.unlock.function_1(0n))
+          .addOutput({ to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis })
+          .addOutput({
+            to: sameNameDifferentPathContract.address,
+            amount: sameNameDifferentPathContractUtxo.satoshis - 2000n,
+          });
+
+        expect(tx).toLog('SiblingIntrospection.cash:6 outputBytecode: 0xaa2092e16594dd458916b3aa6cae4bf41352d1b3b39658698e8cddbeedd687efec7587\nSiblingIntrospection.cash:10 inputBytecode: 0xaa2092e16594dd458916b3aa6cae4bf41352d1b3b39658698e8cddbeedd687efec7587\nSameNameDifferentPath.cash:5 a is 0');
+      });
+
+      it('should log correct data for the reached console.log statements if a require statement fails, and not log unreached console.log statements', () => {
+        const tx = new TransactionBuilder({ provider })
+          .addInput(siblingIntrospectionUtxo, siblingIntrospectionContract.unlock.spend())
+          .addInput(sameNameDifferentPathContractUtxo, sameNameDifferentPathContract.unlock.function_1(1n))
+          .addOutput({ to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis })
+          .addOutput({
+            to: siblingIntrospectionContract.address,
+            amount: sameNameDifferentPathContractUtxo.satoshis - 2000n,
+          });
+
+        expect(tx).toLog('SiblingIntrospection.cash:6 outputBytecode: 0xaa20d510df1721debb0d678d8e424b5f64f04f820005f017cb4731f7be94cd63755787');
+        expect(tx).not.toLog('SiblingIntrospection.cash:10 inputBytecode: 0xaa2092e16594dd458916b3aa6cae4bf41352d1b3b39658698e8cddbeedd687efec7587');
+        expect(tx).not.toLog('SameNameDifferentPath.cash:5 a is 0');
+      });
+    });
+
+    it.todo('should not log statements that are not executed'); // Maybe this is already included in tests above
     it.todo('should still work with different instances of the same contract, with different paths due to different contract parameter values');
   });
 
@@ -209,7 +250,7 @@ describe('Multi-Contract-Debugging tests', () => {
           .addOutput({ to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis })
           .addOutput({ to: correctContract.address, amount: incorrectContractUtxo.satoshis - 2000n });
 
-        expect(tx).toFailRequireWith('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: input bytecode should match.');
+        expect(tx).toFailRequireWith('SiblingIntrospection.cash:11 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 11 with the following message: input bytecode should match.');
         expect(tx).toFailRequireWith('Failing statement: require(inputBytecode == expectedLockingBytecode, \'input bytecode should match\')');
       });
 
@@ -220,7 +261,7 @@ describe('Multi-Contract-Debugging tests', () => {
           .addOutput({ to: siblingIntrospectionContract.address, amount: siblingIntrospectionUtxo.satoshis })
           .addOutput({ to: incorrectContract.address, amount: correctContractUtxo.satoshis - 2000n });
 
-        expect(tx).toFailRequireWith('SiblingIntrospection.cash:11 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 11 with the following message: output bytecode should match.');
+        expect(tx).toFailRequireWith('SiblingIntrospection.cash:7 Require statement failed at input 0 in contract SiblingIntrospection.cash at line 7 with the following message: output bytecode should match.');
         expect(tx).toFailRequireWith('Failing statement: require(outputBytecode == expectedLockingBytecode, \'output bytecode should match\')');
       });
     });
@@ -267,14 +308,14 @@ describe('Multi-Contract-Debugging tests', () => {
         .addInput(contract2Utxo, p2pkhContract2.unlock.function_1(0n))
         .addOutput({ to: p2pkhContract1.address, amount: 10000n });
 
-      expect(transaction1).toFailRequireWith('SameNameDifferentPath.cash:7 Require statement failed at input 1 in contract SameNameDifferentPath.cash at line 7 with the following message: b should not be 0.');
+      expect(transaction1).toFailRequireWith('SameNameDifferentPath.cash:9 Require statement failed at input 1 in contract SameNameDifferentPath.cash at line 9 with the following message: b should not be 0.');
 
       const transaction2 = new TransactionBuilder({ provider })
         .addInput(contract1Utxo, p2pkhContract1.unlock.function_1(1n))
         .addInput(contract2Utxo, p2pkhContract2.unlock.function_1(1n))
         .addOutput({ to: p2pkhContract1.address, amount: 10000n });
 
-      expect(transaction2).toFailRequireWith('SameNameDifferentPath.cash:5 Require statement failed at input 0 in contract SameNameDifferentPath.cash at line 5 with the following message: b should be 0.');
+      expect(transaction2).toFailRequireWith('SameNameDifferentPath.cash:6 Require statement failed at input 0 in contract SameNameDifferentPath.cash at line 6 with the following message: b should be 0.');
     });
   });
 

From 735fefaa785ebea8c9e8913ea5385ce46f2f38f0 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 19 Jun 2025 08:18:36 +0200
Subject: [PATCH 263/267] Add more multicontract debugging tests

---
 .../multicontract_debugging_contracts.ts      |  2 ++
 .../test/multi-contract-debugging.test.ts     | 20 +++++++++++++++++--
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts b/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts
index 1399e106..412a7b42 100644
--- a/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts
+++ b/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts
@@ -4,8 +4,10 @@ const SAME_NAME_DIFFERENT_PATH = `
 contract SameNameDifferentPath(int a) {
   function function_1(int b) {
     if (a == 0) {
+      console.log("a is 0");
       require(b == 0, "b should be 0");
     } else {
+      console.log("a is not 0");
       require(b != 0, "b should not be 0");
     }
   }
diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index 156979e5..0a1c8fbc 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -72,8 +72,24 @@ describe('Multi-Contract-Debugging tests', () => {
       });
     });
 
-    it.todo('should not log statements that are not executed'); // Maybe this is already included in tests above
-    it.todo('should still work with different instances of the same contract, with different paths due to different contract parameter values');
+    it('should still work with different instances of the same contract, with different paths due to different contract parameter values', () => {
+      const sameNameDifferentPathContract1 = new Contract(ARTIFACT_SAME_NAME_DIFFERENT_PATH, [0n], { provider });
+      const sameNameDifferentPathContract2 = new Contract(ARTIFACT_SAME_NAME_DIFFERENT_PATH, [1n], { provider });
+
+      const sameNameDifferentPathContract1Utxo = randomUtxo();
+      const sameNameDifferentPathContract2Utxo = randomUtxo();
+
+      (provider as any)?.addUtxo(sameNameDifferentPathContract1.address, sameNameDifferentPathContract1Utxo);
+      (provider as any)?.addUtxo(sameNameDifferentPathContract2.address, sameNameDifferentPathContract2Utxo);
+
+      const tx = new TransactionBuilder({ provider })
+        .addInput(sameNameDifferentPathContract1Utxo, sameNameDifferentPathContract1.unlock.function_1(0n))
+        .addInput(sameNameDifferentPathContract2Utxo, sameNameDifferentPathContract2.unlock.function_1(1n))
+        .addOutput({ to: sameNameDifferentPathContract1.address, amount: sameNameDifferentPathContract1Utxo.satoshis })
+        .addOutput({ to: sameNameDifferentPathContract2.address, amount: sameNameDifferentPathContract2Utxo.satoshis });
+
+      expect(tx).toLog('SameNameDifferentPath.cash:5 a is 0\nSameNameDifferentPath.cash:8 a is not 0');
+    });
   });
 
   describe('require statements', () => {

From adec88b326ea14c325b8a5b4ae89ad84213ce114 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 19 Jun 2025 08:29:34 +0200
Subject: [PATCH 264/267] Update fixtures after sourcemap changes

---
 packages/cashc/test/generation/fixtures.ts    | 38 +++++++++----------
 .../test/fixtures/bitauth-script.fixture.ts   |  6 +--
 2 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/packages/cashc/test/generation/fixtures.ts b/packages/cashc/test/generation/fixtures.ts
index 03cfde43..4f050b3e 100644
--- a/packages/cashc/test/generation/fixtures.ts
+++ b/packages/cashc/test/generation/fixtures.ts
@@ -27,7 +27,7 @@ export const fixtures: Fixture[] = [
           { ip: 3, line: 3 },
           { ip: 5, line: 4 },
         ],
-        sourceMap: '3:24:3:26;:16::27:1;:8::36;4:16:4:31',
+        sourceMap: '3:24:3:26;:16::27:1;:8::36;4::4:33',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/p2pkh.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -67,7 +67,7 @@ export const fixtures: Fixture[] = [
           { ip: 21, line: 10 },
           { ip: 25, line: 11 },
         ],
-        sourceMap: '3:25:3:27;:30::31;:25:::1;4:30:4:32:0;:35::45;:48::49;:35:::1;:30;5:16:5:35;:8::37;7:20:7:33:0;8:13:8:15;:18::19;:13:::1;10:26:10:28:0;;:16::29:1;:43::45:0;:33::46:1;:8::48;11:25:11:26:0;:28::30;:16::31:1;2:4:12:5',
+        sourceMap: '3:25:3:27;:30::31;:25:::1;4:30:4:32:0;:35::45;:48::49;:35:::1;:30;5:16:5:35;:8::37;7:20:7:33:0;8:13:8:15;:18::19;:13:::1;10:26:10:28:0;;:16::29:1;:43::45:0;:33::46:1;:8::48;11:25:11:26:0;:28::30;:8::33:1;2:4:12:5',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/reassignment.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -113,7 +113,7 @@ export const fixtures: Fixture[] = [
           { ip: 34, line: 10 },
           { ip: 43, line: 13 },
         ],
-        sourceMap: '3:16:3:21;::::1;4:12:4:13:0;:16::17;;:12:::1;5::5:13:0;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;:24::25;;:20:::1;7:16:7:17:0;;:20::21;:16:::1;:12::22;;;8:20:8:25:0;::::1;:12::27;5:24:9:9;9:15:11::0;10:20:10:21;:25::26;;:12::28:1;9:15:11:9;12:12:12:13:0;:16::17;;:12:::1;13:21:13:22:0;;:16:::1;2:4:14:5;;',
+        sourceMap: '3:16:3:21;::::1;4:12:4:13:0;:16::17;;:12:::1;5::5:13:0;:17::18;;:21::22;:17:::1;:12;:24:9:9:0;6:20:6:21;:24::25;;:20:::1;7:16:7:17:0;;:20::21;:16:::1;:12::22;;;8:20:8:25:0;::::1;:12::27;5:24:9:9;9:15:11::0;10:20:10:21;:25::26;;:12::28:1;9:15:11:9;12:12:12:13:0;:16::17;;:12:::1;13:21:13:22:0;;:8::24:1;2:4:14:5;;',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/if_statement.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -153,7 +153,7 @@ export const fixtures: Fixture[] = [
           { ip: 23, line: 11 },
           { ip: 25, line: 12 },
         ],
-        sourceMap: '6:4:8:5;;;;;7:25:7:37;;:39::48;:16::49:1;6:4:8:5;;;;10::13::0;;;;11:25:11:34;;:36::42;:8::45:1;12:27:12:34:0;:8::36:1;10:4:13:5;;1:0:14:1',
+        sourceMap: '6:4:8:5;;;;;7:25:7:37;;:39::48;:8::51:1;6:4:8:5;;;;10::13::0;;;;11:25:11:34;;:36::42;:8::45:1;12:27:12:34:0;:8::36:1;10:4:13:5;;1:0:14:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/multifunction.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -225,7 +225,7 @@ export const fixtures: Fixture[] = [
           { ip: 76, line: 22 },
           { ip: 81, line: 25 },
         ],
-        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;:16::17;;:12:::1;5::5:13:0;:17::18;;:12:::1;:20:9:9:0;6::6:21;:24::25;;:20:::1;7:16:7:17:0;;:20::21;:16:::1;:12::22;;;8:20:8:25:0;::::1;:12::27;5:20:9:9;9:15:11::0;10:16:10:17;;:12::18:1;9:15:11:9;12:12:12:13:0;:16::17;;:12:::1;13:21:13:22:0;;:8::24:1;2:4:14:5;;;;16::26::0;;;17:16:17:17;;18:12:18:13;:16::17;:12:::1;19::19:13:0;:17::18;;:12:::1;:20:23:9:0;20::20:21;:24::25;;:20:::1;21:16:21:21:0;::::1;:12::22;;;22:20:22:25:0;::::1;:12::27;19:20:23:9;;24:12:25:22:0;25:16:::1;16:4:26:5;;1:0:27:1',
+        sourceMap: '2:4:14:5;;;;;3:16:3:17;;:20::21;;:16:::1;4:12:4:13:0;:16::17;;:12:::1;5::5:13:0;:17::18;;:12:::1;:20:9:9:0;6::6:21;:24::25;;:20:::1;7:16:7:17:0;;:20::21;:16:::1;:12::22;;;8:20:8:25:0;::::1;:12::27;5:20:9:9;9:15:11::0;10:16:10:17;;:12::18:1;9:15:11:9;12:12:12:13:0;:16::17;;:12:::1;13:21:13:22:0;;:8::24:1;2:4:14:5;;;;16::26::0;;;17:16:17:17;;18:12:18:13;:16::17;:12:::1;19::19:13:0;:17::18;;:12:::1;:20:23:9:0;20::20:21;:24::25;;:20:::1;21:16:21:21:0;::::1;:12::22;;;22:20:22:25:0;::::1;:12::27;19:20:23:9;;24:12:25:22:0;25:8::24:1;16:4:26:5;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/multifunction_if_statements.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -248,7 +248,7 @@ export const fixtures: Fixture[] = [
         bytecode: '00717c52717c567a53ae',
         logs: [],
         requires: [{ ip: 13, line: 3 }],
-        sourceMap: '3:12:3:52;:27::33;;:26::34:1;:37::45:0;;:47::50;;:36::51:1;:12::52',
+        sourceMap: '3:12:3:52;:27::33;;:26::34:1;:37::45:0;;:47::50;;:36::51:1;:4::54',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/2_of_3_multisig.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -278,7 +278,7 @@ export const fixtures: Fixture[] = [
           { ip: 12, line: 4 },
           { ip: 19, line: 5 },
         ],
-        sourceMap: '3:18:3:27;;:26::34:1;;:37::38:0;:26:::1;:18::39;:::42;4:16:4:22:0;::::1;;:8::24;5:16:5:17:0;:24::25;:16::26:1;:::29;:::34;',
+        sourceMap: '3:18:3:27;;:26::34:1;;:37::38:0;:26:::1;:18::39;:::42;4:16:4:22:0;::::1;;:8::24;5:16:5:17:0;:24::25;:16::26:1;:::29;:::34;:8::36',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/split_size.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -306,7 +306,7 @@ export const fixtures: Fixture[] = [
           { ip: 7, line: 3 },
           { ip: 9, line: 4 },
         ],
-        sourceMap: '3:33:3:35;:17::37:1;:49::51:0;:41::52:1;:17;:57::61:0;:56:::1;:8::64;4:16:4:31',
+        sourceMap: '3:33:3:35;:17::37:1;:49::51:0;:41::52:1;:17;:57::61:0;:56:::1;:8::64;4::4:33',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/cast_hash_checksig.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -363,7 +363,7 @@ export const fixtures: Fixture[] = [
           { ip: 30, line: 26 },
           { ip: 32, line: 31 },
         ],
-        sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;27:12:27:21:0;;28::28:25;;29::29:20;;26:8:30:11:1;31:16:31:43',
+        sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;27:12:27:21:0;;28::28:25;;29::29:20;;26:8:30:11:1;31::31:45',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/hodl_vault.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -395,7 +395,7 @@ export const fixtures: Fixture[] = [
         bytecode: '5152535455565579539f6353567a757c6b7c6b7c6b7c6b7c6c6c6c6c6871557a93547a93537a937b93a0',
         logs: [],
         requires: [{ ip: 42, line: 14 }],
-        sourceMap: '3:16:3:17;4::4;5::5;6::6;7::7;8::8;10:12:10:13;;:16::17;:12:::1;:19:12:9:0;11:16:11:17;:12::18:1;;;;;;;;;;;;;;;;10:19:12:9;14:16:14:21:0;:24::25;;:20:::1;:28::29:0;;:20:::1;:32::33:0;;:20:::1;:36::37:0;:20:::1;:16',
+        sourceMap: '3:16:3:17;4::4;5::5;6::6;7::7;8::8;10:12:10:13;;:16::17;:12:::1;:19:12:9:0;11:16:11:17;:12::18:1;;;;;;;;;;;;;;;;10:19:12:9;14:16:14:21:0;:24::25;;:20:::1;:28::29:0;;:20:::1;:32::33:0;;:20:::1;:36::37:0;:20:::1;:8::39',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/deep_replace.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -416,7 +416,7 @@ export const fixtures: Fixture[] = [
         bytecode: '7c548087',
         logs: [],
         requires: [{ ip: 4, line: 3 }],
-        sourceMap: '3:28:3:29;:21::30:1;;:16',
+        sourceMap: '3:28:3:29;:21::30:1;;:8::32',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/bounded_bytes.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -449,7 +449,7 @@ export const fixtures: Fixture[] = [
           { ip: 2, line: 3 },
           { ip: 6, line: 4 },
         ],
-        sourceMap: '3:16:3:26;:8::47:1;4:16:4:35:0;:39::43;:16:::1',
+        sourceMap: '3:16:3:26;:8::47:1;4:16:4:35:0;:39::43;:8::45:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/covenant.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -531,7 +531,7 @@ export const fixtures: Fixture[] = [
           { ip: 77, line: 21 },
           { ip: 82, line: 22 },
         ],
-        sourceMap: '3:16:3:26;:30::31;:8::33:1;4:16:4:27:0;:31::32;:8::34:1;5:16:5:32:0;:36::37;:8::39:1;6:16:6:33:0;:37::38;:8::40:1;7:16:7:37:0;:41::42;:8::44:1;8:16:8:35:0;:::42:1;;:46::49:0;:8::51:1;9:26:9:27:0;:16::34:1;:38::43:0;:8::45:1;10:26:10:27:0;:16::44:1;:::51;;:55::60:0;:8::62:1;11:26:11:27:0;:16::52:1;:56::121:0;:8::123:1;12:26:12:27:0;:16::42:1;:46::47:0;:8::49:1;13:26:13:27:0;:16::46:1;:::53;;:57::60:0;:8::62:1;14:26:14:27:0;:16::43:1;:47::48:0;:8::50:1;15:27:15:28:0;:16::35:1;:39::44:0;:8::46:1;16:27:16:28:0;:16::45:1;:::52;;:56::59:0;:8::61:1;17:26:17:27:0;:16::42:1;:46::111:0;:8::113:1;18:26:18:27:0;:16::42:1;:46::50:0;:8::52:1;19:26:19:27:0;:16::40:1;:44::47:0;:8::49:1;20:27:20:28:0;:16::43:1;:47::112:0;:8::114:1;21:27:21:28:0;:16::43:1;:47::51:0;:8::53:1;22:27:22:28:0;:16::41:1;:45::48:0;:16:::1',
+        sourceMap: '3:16:3:26;:30::31;:8::33:1;4:16:4:27:0;:31::32;:8::34:1;5:16:5:32:0;:36::37;:8::39:1;6:16:6:33:0;:37::38;:8::40:1;7:16:7:37:0;:41::42;:8::44:1;8:16:8:35:0;:::42:1;;:46::49:0;:8::51:1;9:26:9:27:0;:16::34:1;:38::43:0;:8::45:1;10:26:10:27:0;:16::44:1;:::51;;:55::60:0;:8::62:1;11:26:11:27:0;:16::52:1;:56::121:0;:8::123:1;12:26:12:27:0;:16::42:1;:46::47:0;:8::49:1;13:26:13:27:0;:16::46:1;:::53;;:57::60:0;:8::62:1;14:26:14:27:0;:16::43:1;:47::48:0;:8::50:1;15:27:15:28:0;:16::35:1;:39::44:0;:8::46:1;16:27:16:28:0;:16::45:1;:::52;;:56::59:0;:8::61:1;17:26:17:27:0;:16::42:1;:46::111:0;:8::113:1;18:26:18:27:0;:16::42:1;:46::50:0;:8::52:1;19:26:19:27:0;:16::40:1;:44::47:0;:8::49:1;20:27:20:28:0;:16::43:1;:47::112:0;:8::114:1;21:27:21:28:0;:16::43:1;:47::51:0;:8::53:1;22:27:22:28:0;:16::41:1;:45::48:0;:8::50:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/covenant_all_fields.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -605,7 +605,7 @@ export const fixtures: Fixture[] = [
           { ip: 74, line: 24 },
           { ip: 80, line: 25 },
         ],
-        sourceMap: '2:4:21:5;;;;;3:28:3:34;;:8::36:1;;6:27:6:28:0;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;8:23:8:27:0;9:37:9:58;:27::65:1;10:26:10:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39:1;:43::66:0;;::::1;:12::68;16:15:20:9:0;17:31:17:32;:20::39:1;:43::49:0;;:12::51:1;18:31:18:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;19:31:19:32:0;:20::39:1;:43::54:0;:12::56:1;16:15:20:9;2:4:21:5;;;;;23::26::0;;;;24:24:24:26;;:16::27:1;:31::37:0;:8::39:1;25:25:25:26:0;;:28::30;;:16::31:1;23:4:26:5;;;1:0:27:1',
+        sourceMap: '2:4:21:5;;;;;3:28:3:34;;:8::36:1;;6:27:6:28:0;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;8:23:8:27:0;9:37:9:58;:27::65:1;10:26:10:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;14:12:14:23:0;:27::33;;:36::44;;:27:::1;:12;:46:16:9:0;15:31:15:32;:20::39:1;:43::66:0;;::::1;:12::68;16:15:20:9:0;17:31:17:32;:20::39:1;:43::49:0;;:12::51:1;18:31:18:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;19:31:19:32:0;:20::39:1;:43::54:0;:12::56:1;16:15:20:9;2:4:21:5;;;;;23::26::0;;;;24:24:24:26;;:16::27:1;:31::37:0;:8::39:1;25:25:25:26:0;;:28::30;;:8::33:1;23:4:26:5;;;1:0:27:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/mecenas.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -678,7 +678,7 @@ export const fixtures: Fixture[] = [
         bytecode: '76bc87',
         logs: [],
         requires: [{ ip: 3, line: 3 }],
-        sourceMap: '3:16:3:26;:::36:1;:::50',
+        sourceMap: '3:16:3:26;:::36:1;:8::52',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/p2palindrome.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -701,7 +701,7 @@ export const fixtures: Fixture[] = [
         bytecode: '5a7c80815a9c',
         logs: [],
         requires: [{ ip: 6, line: 4 }],
-        sourceMap: '3:28:3:30;:32::36;:22::37:1;4:16:4:26;:30::32:0;:16:::1',
+        sourceMap: '3:28:3:30;:32::36;:22::37:1;4:16:4:26;:30::32:0;:8::34:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/num2bin_variable.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -727,7 +727,7 @@ export const fixtures: Fixture[] = [
           { data: [{ stackIndex: 0, type: 'int', ip: 3 }, 'test2'], ip: 3, line: 5 },
         ],
         requires: [{ ip: 2, line: 3, message: 'Wrong value passed' }, { ip: 6, line: 6, message: 'Sum doesn\'t work' }],
-        sourceMap: '3:12:3:17;:21::22;:4::46:1;6:12:6:21;:25::26:0;:12:::1',
+        sourceMap: '3:12:3:17;:21::22;:4::46:1;6:12:6:21;:25::26:0;:4::48:1',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/debug_messages.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -750,7 +750,7 @@ export const fixtures: Fixture[] = [
         bytecode: '060010a5d4e800060010a5d4e800060010a5d4e800060010a5d4e800060010a5d4e800547a789d537a789d7b789d9c',
         logs: [],
         requires: [{ ip: 8, line: 10 }, { ip: 12, line: 11 }, { ip: 15, line: 12 }, { ip: 17, line: 13 }],
-        sourceMap: '3:26:3:30;4::4;5::5:43;6:23:6:30;8:22:8:35;10:16:10:27;;:31::38;:8::40:1;11:16:11:27:0;;:31::38;:8::40:1;12:16:12:27:0;:31::38;:8::40:1;13:16:13:35',
+        sourceMap: '3:26:3:30;4::4;5::5:43;6:23:6:30;8:22:8:35;10:16:10:27;;:31::38;:8::40:1;11:16:11:27:0;;:31::38;:8::40:1;12:16:12:27:0;:31::38;:8::40:1;13::13:37',
       },
       source: fs.readFileSync(new URL('../valid-contract-files/integer_formatting.cash', import.meta.url), { encoding: 'utf-8' }),
       compiler: {
@@ -794,7 +794,7 @@ export const fixtures: Fixture[] = [
       bytecode: 'OP_HASH256 OP_SIZE OP_NIP 20 OP_NUMEQUAL',
       debug: {
         bytecode: 'aa827701209c',
-        sourceMap: '3:29:5:47:1;6:16:6:33;;:37::39:0;:16:::1',
+        sourceMap: '3:29:5:47:1;6:16:6:33;;:37::39:0;:8::74:1',
         logs: [
           {
             ip: 1,
diff --git a/packages/utils/test/fixtures/bitauth-script.fixture.ts b/packages/utils/test/fixtures/bitauth-script.fixture.ts
index bf11736c..fca556f7 100644
--- a/packages/utils/test/fixtures/bitauth-script.fixture.ts
+++ b/packages/utils/test/fixtures/bitauth-script.fixture.ts
@@ -34,7 +34,7 @@ contract TransferWithTimeout(bytes20 senderPkh, bytes20 recipientPkh, int timeou
   }
 }`,
     asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_5 OP_ROLL OP_5 OP_PICK OP_CHECKSIGVERIFY OP_4 OP_ROLL OP_HASH160 OP_ROT OP_EQUAL OP_NIP OP_NIP OP_NIP OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_DUP deadbeef OP_EQUALVERIFY OP_2 OP_PICK OP_3 OP_PICK OP_NUMEQUALVERIFY OP_4 OP_PICK OP_5 OP_PICK OP_EQUALVERIFY OP_3 OP_PICK OP_4 OP_PICK OP_EQUALVERIFY OP_4 OP_ROLL OP_4 OP_PICK OP_CHECKSIGVERIFY OP_3 OP_ROLL OP_HASH160 OP_EQUALVERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_2DROP OP_1 OP_ENDIF',
-    sourceMap: '3:2:6:3;;;;;4:21:4:22;;:24::33;;:4::36:1;5:20:5:29:0;;:12::30:1;:34::46:0;:12:::1;3:2:6:3;;;;8::16::0;;;;9:12:9:21;:25::35;:4::37:1;10:12:10:19:0;;:23::30;;:4::32:1;11:12:11:13:0;;:17::18;;:4::20:1;12:12:12:21:0;;:25::34;;:4::36:1;13:21:13:22:0;;:24::33;;:4::36:1;14:20:14:29:0;;:12::30:1;:4::45;15:23:15:30:0;:4::32:1;8:2:16:3;;2:0:17:1',
+    sourceMap: '3:2:6:3;;;;;4:21:4:22;;:24::33;;:4::36:1;5:20:5:29:0;;:12::30:1;:34::46:0;:4::48:1;3:2:6:3;;;;8::16::0;;;;9:12:9:21;:25::35;:4::37:1;10:12:10:19:0;;:23::30;;:4::32:1;11:12:11:13:0;;:17::18;;:4::20:1;12:12:12:21:0;;:25::34;;:4::36:1;13:21:13:22:0;;:24::33;;:4::36:1;14:20:14:29:0;;:12::30:1;:4::45;15:23:15:30:0;:4::32:1;8:2:16:3;;2:0:17:1',
     expectedLineToOpcodeMap: {
       3: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
       4: [Op.OP_5, Op.OP_ROLL, Op.OP_5, Op.OP_PICK, Op.OP_CHECKSIGVERIFY],
@@ -125,7 +125,7 @@ contract Mecenas(bytes20 recipient, bytes20 funder, int pledge/*, int period */)
     }
 }`.replace(/^\n+/, '').replace(/\n+$/, ''),
     asmBytecode: 'OP_3 OP_PICK OP_0 OP_NUMEQUAL OP_IF OP_0 OP_OUTPUTBYTECODE 76a914 OP_ROT OP_CAT 88ac OP_CAT OP_EQUALVERIFY e803 OP_INPUTINDEX OP_UTXOVALUE OP_DUP OP_4 OP_PICK OP_SUB OP_2 OP_PICK OP_SUB OP_DUP OP_5 OP_PICK OP_4 OP_PICK OP_ADD OP_LESSTHANOREQUAL OP_IF OP_0 OP_OUTPUTVALUE OP_2OVER OP_SWAP OP_SUB OP_NUMEQUALVERIFY OP_ELSE OP_0 OP_OUTPUTVALUE OP_5 OP_PICK OP_NUMEQUALVERIFY OP_1 OP_OUTPUTBYTECODE OP_INPUTINDEX OP_UTXOBYTECODE OP_EQUALVERIFY OP_1 OP_OUTPUTVALUE OP_OVER OP_NUMEQUALVERIFY OP_ENDIF OP_2DROP OP_2DROP OP_2DROP OP_1 OP_ELSE OP_3 OP_ROLL OP_1 OP_NUMEQUALVERIFY OP_3 OP_PICK OP_HASH160 OP_ROT OP_EQUALVERIFY OP_2SWAP OP_CHECKSIG OP_NIP OP_NIP OP_ENDIF',
-    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::66:0;;::::1;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:12::51:1;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;:12::56:1;23:15:27:9;9:4:28:5;;;;;30::33::0;;;;31:24:31:26;;:16::27:1;:31::37:0;:8::39:1;32:25:32:30:0;:16::31:1;30:4:33:5;;8:0:34:1',
+    sourceMap: '9:4:28:5;;;;;13:27:13:28;:16::45:1;:49::84:0;:74::83;:49::84:1;;;:8::86;15:23:15:27:0;16:37:16:58;:27::65:1;17:26:17:38:0;:41::47;;:26:::1;:50::58:0;;:26:::1;21:12:21:23:0;:27::33;;:36::44;;:27:::1;:12;:46:23:9:0;22:31:22:32;:20::39:1;:43::66:0;;::::1;:12::68;23:15:27:9:0;24:31:24:32;:20::39:1;:43::49:0;;:12::51:1;25:31:25:32:0;:20::49:1;:63::84:0;:53::101:1;:12::103;26:31:26:32:0;:20::39:1;:43::54:0;:12::56:1;23:15:27:9;9:4:28:5;;;;;30::33::0;;;;31:24:31:26;;:16::27:1;:31::37:0;:8::39:1;32:25:32:30:0;:8::33:1;30:4:33:5;;8:0:34:1',
     expectedLineToOpcodeMap: {
       9: [Op.OP_3, Op.OP_PICK, new Uint8Array([]), Op.OP_NUMEQUAL, Op.OP_IF],
       13: [new Uint8Array([]), Op.OP_OUTPUTBYTECODE, hexToBin('76a914'), Op.OP_ROT, Op.OP_CAT, hexToBin('88ac'), Op.OP_CAT, Op.OP_EQUALVERIFY],
@@ -237,7 +237,7 @@ contract HodlVault(
 }
 `.replace(/^\n+/, '').replace(/\n+$/, ''),
     asmBytecode: 'OP_6 OP_PICK OP_4 OP_SPLIT OP_SWAP OP_BIN2NUM OP_SWAP OP_BIN2NUM OP_OVER OP_5 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_SWAP OP_CHECKLOCKTIMEVERIFY OP_DROP OP_3 OP_ROLL OP_GREATERTHANOREQUAL OP_VERIFY OP_3 OP_ROLL OP_4 OP_ROLL OP_3 OP_ROLL OP_CHECKDATASIGVERIFY OP_CHECKSIG',
-    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:8::66:1;27:16:27:43',
+    sourceMap: '14:49:14:62;;:69::70;:49::71:1;15:30:15:44:0;:26::45:1;16:24:16:32:0;:20::33:1;19:16:19:27:0;:31::39;;:16:::1;:8::41;20:27:20:38:0;:8::40:1;;23:25:23:36:0;;:16:::1;:8::38;26:29:26::0;;:40::53;;:55::63;;:8::66:1;27::27:45',
     expectedLineToOpcodeMap: {
       14: [Op.OP_6, Op.OP_PICK, Op.OP_4, Op.OP_SPLIT],
       15: [Op.OP_SWAP, Op.OP_BIN2NUM],

From 3d0512aee8475553b9348c22b4becbd22c759406 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 19 Jun 2025 08:42:25 +0200
Subject: [PATCH 265/267] Fix spellcheck

---
 .cspell.json                                         |  8 ++++++++
 examples/transfer_with_timeout.ts                    |  4 ++--
 .../cashc/src/generation/GenerateTargetTraversal.ts  |  2 +-
 packages/cashscript/src/advanced/LibauthTemplate.ts  |  2 +-
 packages/cashscript/test/TransactionBuilder.test.ts  |  2 +-
 packages/cashscript/test/debugging.test.ts           |  2 +-
 .../test/fixture/debugging/debugging_contracts.ts    |  4 ++--
 ...acts.ts => multi_contract_debugging_contracts.ts} |  0
 .../cashscript/test/multi-contract-debugging.test.ts |  2 +-
 packages/utils/src/optimisations.ts                  |  2 +-
 packages/utils/src/script.ts                         |  2 +-
 website/docs/basics/about-bch.md                     |  6 +++---
 website/docs/basics/getting-started.md               |  4 ++--
 website/docs/compiler/script-limits.md               | 12 ++++++------
 website/docs/guides/walletconnect.md                 |  6 +++---
 website/docs/language/contracts.md                   |  6 +++---
 website/docs/language/types.md                       |  6 +++---
 website/docs/sdk/instantiation.md                    |  4 ++--
 website/docs/sdk/testing-setup.md                    |  2 +-
 website/docs/showcase.md                             |  2 +-
 20 files changed, 43 insertions(+), 35 deletions(-)
 rename packages/cashscript/test/fixture/debugging/{multicontract_debugging_contracts.ts => multi_contract_debugging_contracts.ts} (100%)

diff --git a/.cspell.json b/.cspell.json
index 43f004e9..565a20cc 100644
--- a/.cspell.json
+++ b/.cspell.json
@@ -23,6 +23,7 @@
         "bitcore",
         "bitfield",
         "bitfield's",
+        "bitshift",
         "blackie",
         "blockbook",
         "booland",
@@ -82,6 +83,8 @@
         "INPUTINDEX",
         "INPUTSEQUENCENUMBER",
         "ints",
+        "introspected",
+        "introspecting",
         "kalis",
         "keypair",
         "keypairs",
@@ -138,6 +141,7 @@
         "prevouts",
         "priv",
         "pubkey",
+        "pubkeys",
         "pubkeytype",
         "pushbytes",
         "pushdata",
@@ -155,6 +159,7 @@
         "scripthash",
         "sdks",
         "secp",
+        "segwit",
         "setup",
         "sig",
         "sighash",
@@ -185,6 +190,7 @@
         "unary",
         "unlocker",
         "unlockers",
+        "unreached",
         "utxo",
         "utxo's",
         "UTXOBYTECODE",
@@ -217,6 +223,7 @@
         "getrawtransaction",
         "hardhat",
         "hodlvault",
+        "incl",
         "infima",
         "jedex",
         "lichos",
@@ -227,6 +234,7 @@
         "outputnulldata",
         "outputp",
         "pako",
+        "paytaca",
         "popd",
         "pushd",
         "sendrawtransaction",
diff --git a/examples/transfer_with_timeout.ts b/examples/transfer_with_timeout.ts
index caf22ae3..12a55918 100644
--- a/examples/transfer_with_timeout.ts
+++ b/examples/transfer_with_timeout.ts
@@ -58,8 +58,8 @@ const transferTx = await transactionBuilder.send();
 console.log('transfer transaction details:', stringify(transferTx));
 
 // Select a 2nd contract UTXO to spend from
-const updatecContractUtxos = await contract.getUtxos();
-const contractInputUtxo2 = updatecContractUtxos.find(utxo => utxo.satoshis > 5_000n);
+const updateContractUtxos = await contract.getUtxos();
+const contractInputUtxo2 = updateContractUtxos.find(utxo => utxo.satoshis > 5_000n);
 if (!contractInputUtxo2) throw new Error('No contract UTXO with enough satoshis found');
 const inputAmount2 = contractInputUtxo2.satoshis;
 
diff --git a/packages/cashc/src/generation/GenerateTargetTraversal.ts b/packages/cashc/src/generation/GenerateTargetTraversal.ts
index add64e94..44730dba 100644
--- a/packages/cashc/src/generation/GenerateTargetTraversal.ts
+++ b/packages/cashc/src/generation/GenerateTargetTraversal.ts
@@ -211,7 +211,7 @@ export default class GenerateTargetTraversalWithLocation extends AstTraversal {
 
       // Replace the location data of the final check (e.g. (x == 1)) with the location data of the
       // full require statement including the removed OP_VERIFY (e.g. require(x == 1)), because
-      // the check opcode (e.g. OP_EQUAL) now represents the entire require statement (incl implicit OP_VERIFY)
+      // the check opcode (e.g. OP_EQUAL) now represents the entire require statement (including implicit OP_VERIFY)
       this.locationData.pop();
       this.locationData.push({ location, positionHint });
     } else {
diff --git a/packages/cashscript/src/advanced/LibauthTemplate.ts b/packages/cashscript/src/advanced/LibauthTemplate.ts
index 0704b0bf..c1b7f587 100644
--- a/packages/cashscript/src/advanced/LibauthTemplate.ts
+++ b/packages/cashscript/src/advanced/LibauthTemplate.ts
@@ -407,7 +407,7 @@ export const getLibauthTemplates = (
   for (const [inputIndex, input] of (txn.inputs as StandardUnlockableUtxo[]).entries()) {
     // If template exists on the input, it indicates this is a P2PKH (Pay to Public Key Hash) input
     if ('template' in input.unlocker) {
-      // @ts-ignore TODO: Remove UtxoP2PKH type and only use UnlockableUtxo in Libaith Template generation
+      // @ts-ignore TODO: Remove UtxoP2PKH type and only use UnlockableUtxo in Libauth Template generation
       input.template = input.unlocker?.template; // Added to support P2PKH inputs in buildTemplate
       Object.assign(p2pkhEntities, generateTemplateEntitiesP2PKH(inputIndex));
       Object.assign(p2pkhScripts, generateTemplateScriptsP2PKH(input.unlocker.template, inputIndex));
diff --git a/packages/cashscript/test/TransactionBuilder.test.ts b/packages/cashscript/test/TransactionBuilder.test.ts
index 8e8738a4..fc8ee52c 100644
--- a/packages/cashscript/test/TransactionBuilder.test.ts
+++ b/packages/cashscript/test/TransactionBuilder.test.ts
@@ -212,7 +212,7 @@ describe('Transaction Builder', () => {
 
   // TODO: Consider improving error messages checked below to also include the input/output index
 
-  it('should fail when trying to send to invalid addres', async () => {
+  it('should fail when trying to send to invalid address', async () => {
     const p2pkhUtxos = (await p2pkhInstance.getUtxos()).filter(isNonTokenUtxo).sort(utxoComparator).reverse();
 
     expect(() => {
diff --git a/packages/cashscript/test/debugging.test.ts b/packages/cashscript/test/debugging.test.ts
index 7aaa3071..cc9cbf28 100644
--- a/packages/cashscript/test/debugging.test.ts
+++ b/packages/cashscript/test/debugging.test.ts
@@ -134,7 +134,7 @@ describe('Debugging tests', () => {
       expect(transaction).toLog(expectedSecondLog);
     });
 
-    // This is an edge case because of optimisationn position hint merging
+    // This is an edge case because of optimisation position hint merging
     it('should log the correct variable value inside a notif statement', async () => {
       const transaction = new TransactionBuilder({ provider })
         .addInput(contractUtxo, contractTestLogs.unlock.test_log_inside_notif_statement(false))
diff --git a/packages/cashscript/test/fixture/debugging/debugging_contracts.ts b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
index 3544b7d7..34aba269 100644
--- a/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
+++ b/packages/cashscript/test/fixture/debugging/debugging_contracts.ts
@@ -271,7 +271,7 @@ contract Test(pubkey owner) {
 }
 `;
 
-const CONTRACT_TEST_MULTPLE_LOGS = `
+const CONTRACT_TEST_MULTIPLE_LOGS = `
 contract Test(pubkey owner) {
   function transfer(sig ownerSig, int num) {
     require(checkSig(ownerSig, owner));
@@ -319,5 +319,5 @@ export const artifactTestMultilineRequires = compileString(CONTRACT_TEST_MULTILI
 export const artifactTestZeroHandling = compileString(CONTRACT_TEST_ZERO_HANDLING);
 export const artifactTestLogs = compileString(CONTRACT_TEST_LOGS);
 export const artifactTestConsecutiveLogs = compileString(CONTRACT_TEST_CONSECUTIVE_LOGS);
-export const artifactTestMultipleLogs = compileString(CONTRACT_TEST_MULTPLE_LOGS);
+export const artifactTestMultipleLogs = compileString(CONTRACT_TEST_MULTIPLE_LOGS);
 export const artifactTestMultipleConstructorParameters = compileString(CONTRACT_TEST_MULTIPLE_CONSTRUCTOR_PARAMETERS);
diff --git a/packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts b/packages/cashscript/test/fixture/debugging/multi_contract_debugging_contracts.ts
similarity index 100%
rename from packages/cashscript/test/fixture/debugging/multicontract_debugging_contracts.ts
rename to packages/cashscript/test/fixture/debugging/multi_contract_debugging_contracts.ts
diff --git a/packages/cashscript/test/multi-contract-debugging.test.ts b/packages/cashscript/test/multi-contract-debugging.test.ts
index 0a1c8fbc..b770f988 100644
--- a/packages/cashscript/test/multi-contract-debugging.test.ts
+++ b/packages/cashscript/test/multi-contract-debugging.test.ts
@@ -17,7 +17,7 @@ import {
 import p2pkhArtifact from './fixture/p2pkh.artifact.js';
 import bigintArtifact from './fixture/bigint.artifact.js';
 import '../src/test/JestExtensions.js';
-import { ARTIFACT_FUNCTION_NAME_COLLISION, ARTIFACT_NAME_COLLISION, ARTIFACT_CONTRACT_NAME_COLLISION, ARTIFACT_SAME_NAME_DIFFERENT_PATH } from './fixture/debugging/multicontract_debugging_contracts.js';
+import { ARTIFACT_FUNCTION_NAME_COLLISION, ARTIFACT_NAME_COLLISION, ARTIFACT_CONTRACT_NAME_COLLISION, ARTIFACT_SAME_NAME_DIFFERENT_PATH } from './fixture/debugging/multi_contract_debugging_contracts.js';
 import { addressToLockScript } from '../src/utils.js';
 import SiblingIntrospectionArtifact from './fixture/SiblingIntrospection.artifact.js';
 
diff --git a/packages/utils/src/optimisations.ts b/packages/utils/src/optimisations.ts
index 84f51c84..b05dbcde 100644
--- a/packages/utils/src/optimisations.ts
+++ b/packages/utils/src/optimisations.ts
@@ -136,5 +136,5 @@ const unprovableOptimisations = [
 ] as [string, string][];
 
 // Note: we moved these optimisations into a single file, but kept the exact same order as before,
-// because the order in which oprimisations are applied can impact the output.
+// because the order in which optimisations are applied can impact the output.
 export const optimisationReplacements = [...provableOptimisations, ...unprovableOptimisations];
diff --git a/packages/utils/src/script.ts b/packages/utils/src/script.ts
index 3f48393f..9519dedc 100644
--- a/packages/utils/src/script.ts
+++ b/packages/utils/src/script.ts
@@ -274,7 +274,7 @@ function replaceOps(
       const patternLength = [...pattern.matchAll(/\s+/g)].length + 1;
       const replacementLength = replacement === '' ? 0 : [...replacement.matchAll(/\s+/g)].length + 1;
 
-      // We get the locationdata entries for every opcode in the pattern
+      // We get the locationData entries for every opcode in the pattern
       const patternLocations = newLocationData.slice(scriptIndex, scriptIndex + patternLength);
 
       // We get the lowest start location and highest end location of the pattern
diff --git a/website/docs/basics/about-bch.md b/website/docs/basics/about-bch.md
index 083b266a..23434ff1 100644
--- a/website/docs/basics/about-bch.md
+++ b/website/docs/basics/about-bch.md
@@ -13,9 +13,9 @@ To learn more about the Bitcoin Basics refer to the book ['Mastering Bitcoin'](h
 
 ## How BCH differs from BTC
 
-Although BCH and BTC share the same Bitcoin fundamentals, both projects have significantly diverged in some ereas since 2017. For example, Bitcoin Cash does not have Segwit or Taproot, instead Bitcoin Cash has had multiple upgrades specifically focused on improving the smart contract capabilities. Bitcoin Cash has re-enabled many useful opcodes, has introduce native introspection, has added CashTokens, has reworked the script limits and introduced BigInts.
+Although BCH and BTC share the same Bitcoin fundamentals, both projects have significantly diverged in some areas since 2017. For example, Bitcoin Cash does not have Segwit or Taproot, instead Bitcoin Cash has had multiple upgrades specifically focused on improving the smart contract capabilities. Bitcoin Cash has re-enabled many useful opcodes, has introduce native introspection, has added CashTokens, has reworked the script limits and introduced BigInts.
 
-So part that **has** significantly diverged between BTC and BCH is the *virual machine* (VM), the environment in which smart contracts are evaluated. So the greatly improved VM specifically is what makes it possible to write powerful smart contracts on BCH in the first place!
+So part that **has** significantly diverged between BTC and BCH is the *virtual machine* (VM), the environment in which smart contracts are evaluated. So the greatly improved VM specifically is what makes it possible to write powerful smart contracts on BCH in the first place!
 
 ## UTXO model
 Bitcoin Cash transactions work with in- and outputs. All current balances are so called *Unspent Transaction Outputs (UTXOs)*, which simply means they can be used as inputs for future spending transactions.
@@ -26,7 +26,7 @@ UTXOs are locked using a locking script that specifies the conditions to spend t
 
 ## P2PKH transactions
 
-The most used locking/unlocking script pattern is called *Pay-to-Public-Key-Hash (P2PKH)*, where the locking script contains the hash of a public key and expects the unlocking script to contain a public key and transaction signature. The locking script then checks that the provided public key matches the stored hash, and that the transaction signature is valid. 
+The most used locking/unlocking script pattern is called *Pay-to-Public-Key-Hash (P2PKH)*, where the locking script contains the hash of a public key and expects the unlocking script to contain a public key and transaction signature. The locking script then checks that the provided public key matches the stored hash, and that the transaction signature is valid.
 
 The P2PKH pattern is used in regular Bitcoin Cash wallets. These wallets only know how to spend from inputs with this pattern, where the public-key-hash in question is the owners' public key. The user's wallet balance then is simply the sum of all UTXOs that can be spent by the user's public keys.
 
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index 657a54b7..ebd9b557 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -6,7 +6,7 @@ title: Getting Started
 
 To get started with writing CashScript smart contracts quickly, it is recommended to try out the [CashScript Playground](https://playground.cashscript.org/), a web application which lets you easily write and create contracts!
 
-The Playground has a code-editor and CashScript compiler easily accesible, without any prerequisites. Further, the playground allows to easily create contracts, wallets and build transactions.
+The Playground has a code-editor and CashScript compiler easily accessible, without any prerequisites. Further, the playground allows to easily create contracts, wallets and build transactions.
 
 :::tip
 The [CashScript Playground](https://playground.cashscript.org/) is a great way to get started without doing any JavaScript/TypeScript coding, this way you can focus on learning just CashScript!
@@ -153,7 +153,7 @@ import { MockNetworkProvider, Contract, SignatureTemplate, TransactionBuilder, r
 import { alicePub, bobPriv, bobPub } from './keys.js';
 import artifact from './TransferWithTimeout.json' with { type: 'json' };
 
-// Initialise a mocknetwork provider for easy testing
+// Initialise a mock network provider for easy testing
 const provider = new MockNetworkProvider();
 
 // Instantiate a new TransferWithTimeout contract
diff --git a/website/docs/compiler/script-limits.md b/website/docs/compiler/script-limits.md
index 353a3c28..d4548c95 100644
--- a/website/docs/compiler/script-limits.md
+++ b/website/docs/compiler/script-limits.md
@@ -38,8 +38,8 @@ Bitcoin Cash enforces an operation cost limit (op-cost) per transaction input. T
 Since longer input scripts allow for a larger compute budget, some contracts use zero-padding (adding non-functional bytes) to "buy" more computation power without changing logic. You can find the exact op-cost per operation in the [op-cost-table][op-cost-table].
 
 ```ts
-function maxOperationCost(unlockingBytecodeLength) {  
-  return (41n + unlockingBytecodeLength) * 800n;  
+function maxOperationCost(unlockingBytecodeLength) {
+  return (41n + unlockingBytecodeLength) * 800n;
 }
 ```
 
@@ -75,7 +75,7 @@ function calculateDust(outputSize: number): number {
 ```
 
 Before CashTokens `546` bytes was often used as good default value, however with tokenData outputs have become larger in size.
-For ease of development, it is standard practice to use 1,000 satoshis as dust to outputs. 
+For ease of development, it is standard practice to use 1,000 satoshis as dust to outputs.
 
 :::note
 The standard practice of 1,000 satoshis as dust amount for outputs is only considering `P2PH`, `P2SH` and `P2PK` output types.
@@ -84,12 +84,12 @@ For `P2MS` (raw multisig) a higher dust limits may be required, you can [find mo
 
 ### Output Standardness
 
-Bitcoin Cash only allows a few types of `lockingbytecode` scripts for outputs in the normal network relay rules. These are called 'standard outputs', contrasted to 'non-standard outputs' which cause the transaction not to relay on the network.
+Bitcoin Cash only allows a few types of `lockingBytecode` scripts for outputs in the normal network relay rules. These are called 'standard outputs', contrasted to 'non-standard outputs' which cause the transaction not to relay on the network.
 
 There's 4 types of standard output types: `P2PKH`, `P2SH` (which includes `P2SH20` & `P2SH32`), `P2MS` and `OP_RETURN` data-outputs. For more details see the [standard outputs documentation][standard-outputs-docs].
 
 :::caution
-The `lockingbytecode` standardness rules can be important for smart contract developers, and is why CashScript has helpers like `LockingBytecodeP2PKH`, `LockingBytecodeP2SH32` and `LockingBytecodeNullData`.
+The `lockingBytecode` standardness rules can be important for smart contract developers, and is why CashScript has helpers like `LockingBytecodeP2PKH`, `LockingBytecodeP2SH32` and `LockingBytecodeNullData`.
 :::
 
 ## Summary table
@@ -110,4 +110,4 @@ For further details on transaction validation and standardness rules, see the [d
 [op-cost-table]: https://github.com/bitjson/bch-vm-limits/blob/master/operation-costs.md
 [standardness-docs]: https://documentation.cash/protocol/blockchain/transaction-validation/network-level-validation-rules#standard-transactions.html
 [standard-outputs-docs]: https://documentation.cash/protocol/blockchain/transaction/locking-script.html
-[info-dust-limit]: https://bitcoincashresearch.org/t/friday-night-challenge-worst-case-dust/1181/2
\ No newline at end of file
+[info-dust-limit]: https://bitcoincashresearch.org/t/friday-night-challenge-worst-case-dust/1181/2
diff --git a/website/docs/guides/walletconnect.md b/website/docs/guides/walletconnect.md
index c4c6d207..7cca98a9 100644
--- a/website/docs/guides/walletconnect.md
+++ b/website/docs/guides/walletconnect.md
@@ -59,7 +59,7 @@ async function proposeWcTransaction(){
   // use the CashScript SDK to build a transaction
   const transactionBuilder = new TransactionBuilder({provider: store.provider})
   transactionBuilder.addInputs(userInputUtxos, placeholderUnlocker)
-  transactionBuilder.addOpReturnOutput(opreturnData)
+  transactionBuilder.addOpReturnOutput(opReturnData)
   transactionBuilder.addOutput(contractOutput)
   if(changeAmount > 550n) transactionBuilder.addOutput(changeOutput)
 
@@ -71,7 +71,7 @@ async function proposeWcTransaction(){
   // construct SourceOutputs from transaction input, see source code
   const sourceOutputs = generateSourceOutputs(transactionBuilder.inputs)
 
-  // we don't need to add the contractInfo to the wcSourceOutputs here  
+  // we don't need to add the contractInfo to the wcSourceOutputs here
   const wcSourceOutputs = sourceOutputs.map((sourceOutput, index) => {
     return { ...sourceOutput, ...decodedTransaction.inputs[index] }
   })
@@ -100,7 +100,7 @@ import { Contract } from "cashscript";
 import { hexToBin, decodeTransaction } from "@bitauth/libauth";
 
 async function unlockHodlVault(){
-  // create a placeholdes for the unlocking arguments
+  // create a placeholder for the unlocking arguments
   const placeholderSig = Uint8Array.from(Array(65))
   const placeholderPubKey = Uint8Array.from(Array(33));
 
diff --git a/website/docs/language/contracts.md b/website/docs/language/contracts.md
index a39b62ee..9cb0c75d 100644
--- a/website/docs/language/contracts.md
+++ b/website/docs/language/contracts.md
@@ -31,10 +31,10 @@ contract HTLC(pubkey sender, pubkey recipient, int expiration, bytes32 hash) {
 
 ### Constructor Arguments
 
-The constructor arguments are provided when initializing a specific instance of a smart contract. The provided constructor arguments are added to the start of the contract's script before the opcode logic. Because the constructor arguments are part of the full smart contract script, they are conceptually similar to hard-coded constants in your contract logic. Constructor arguments are a way to create 'global constants' accesible from different functions inside your contract.
+The constructor arguments are provided when initializing a specific instance of a smart contract. The provided constructor arguments are added to the start of the contract's script before the opcode logic. Because the constructor arguments are part of the full smart contract script, they are conceptually similar to hard-coded constants in your contract logic. Constructor arguments are a way to create 'global constants' accessible from different functions inside your contract.
 
 :::info
-The typings for the constructor arguments are only semantic and used when initilaizing the contract with the SDK. This means when not using the SDK you could still pass a different byte length item to `bytes32 hash`.
+The typings for the constructor arguments are only semantic and used when initializing the contract with the SDK. This means when not using the SDK you could still pass a different byte length item to `bytes32 hash`.
 :::
 
 :::note
@@ -61,7 +61,7 @@ contract TransferWithTimeout(pubkey sender, pubkey recipient, int timeout) {
 
 ### Function Arguments
 
-The function arguments are provided when attempting to spend from the contract. This means that these arguments can be crafted in a specific way by anyone to see if they can exploit the contract logic. Because of this it is important to realize these are 'untrusted arguments'. 
+The function arguments are provided when attempting to spend from the contract. This means that these arguments can be crafted in a specific way by anyone to see if they can exploit the contract logic. Because of this it is important to realize these are 'untrusted arguments'.
 
 In CashScript the types for the function arguments are **not** enforced automatically at the contract level. This can be especially relevant for types like `bool`, `bytesX` and other semantic bytes types. Instead this type information is only used by the SDK to check whether these arguments match the expected type during transaction building.
 
diff --git a/website/docs/language/types.md b/website/docs/language/types.md
index 3422a14d..66fae27e 100644
--- a/website/docs/language/types.md
+++ b/website/docs/language/types.md
@@ -144,7 +144,7 @@ string answer = question.split(15)[0].split(8)[1]; // Answer is "Cash"
 ```
 
 :::note
-It is not supported to use a variable for the tupleIndex. Instead you can assign both sides of the tuple as shown below and use either element conditional on the value of the variable. 
+It is not supported to use a variable for the tupleIndex. Instead you can assign both sides of the tuple as shown below and use either element conditional on the value of the variable.
 :::
 
 It is also possible to assign both sides of the tuple at once with a destructuring syntax:
@@ -183,11 +183,11 @@ See the following table for information on which types can be cast to other whic
 When casting integer types to bytes of a certain size, the integer value is padded with zeros, e.g. `bytes4(0) == 0x00000000`. It is also possible to pad with a variable number of zeros by passing in a `size` parameter, which indicates the size of the output, e.g. `bytes(0, 4 - 2) == 0x0000`.
 
 :::tip
-Using `bytes20 placeholderPkh= bytes20(0)` will generate a 20 byte zero-array programmatically, whereas 
+Using `bytes20 placeholderPkh= bytes20(0)` will generate a 20 byte zero-array programmatically, whereas
 `bytes20 placeholderPkh= 0x0000000000000000000000000000000000000000` will actually take 20 bytes of space in your contract.
 :::
 
-Casting an integer to a fixed-size byte-length can be a very important when storing local state in an nftCommitment. When casting a script number to bytes, developers need to consider what the preferable fixed-size length is for each indivual case depending on the interger range. Below we add a table with info on the maximum integer size for common cases:
+Casting an integer to a fixed-size byte-length can be a very important when storing local state in an nftCommitment. When casting a script number to bytes, developers need to consider what the preferable fixed-size length is for each individual case depending on the integer range. Below we add a table with info on the maximum integer size for common cases:
 
 | Integer Type    | Max integer value                  | Max Byte Size in Script Number Format  |
 | --------------  | -----------------------------------| ---------------------------------------|
diff --git a/website/docs/sdk/instantiation.md b/website/docs/sdk/instantiation.md
index e7db99ac..13cd1f12 100644
--- a/website/docs/sdk/instantiation.md
+++ b/website/docs/sdk/instantiation.md
@@ -109,7 +109,7 @@ The size outputs of the `cashc` compiler are based on the bytecode without const
 
 #### Example
 ```ts
-// make sure the contract bytesize is within standarness limits
+// make sure the contract bytesize is within standardness limits
 assert(contract.bytesize <= 1650)
 ```
 
@@ -181,4 +181,4 @@ transactionBuilder.addInput(contractUtxos[0], contract.unlock.spend());
 
 :::tip
 If the contract artifact is generated using the `cashc` CLI with the `--format ts` option, you will get explicit types and type checking for the function name and arguments.
-:::
\ No newline at end of file
+:::
diff --git a/website/docs/sdk/testing-setup.md b/website/docs/sdk/testing-setup.md
index b639278b..4bd77d07 100644
--- a/website/docs/sdk/testing-setup.md
+++ b/website/docs/sdk/testing-setup.md
@@ -12,7 +12,7 @@ For a quick start with a CashScript testing setup, check out the [example testin
 
 The `MockNetworkProvider` is a special network provider that allows you to evaluate transactions locally without interacting with the Bitcoin Cash network. This is useful when writing automated tests for your contracts, or when debugging your contract locally.
 
-To create a new virtual UTXO use `provider.addUtxo(address, uxto)`. You can use the helper functions `randomUtxo()`, `randomToken()` and `randomNFT()` to generate random partial Utxo info which you can be overwritten with custom values. 
+To create a new virtual UTXO use `provider.addUtxo(address, utxo)`. You can use the helper functions `randomUtxo()`, `randomToken()` and `randomNFT()` to generate random partial Utxo info which you can be overwritten with custom values.
 
 #### Example
 
diff --git a/website/docs/showcase.md b/website/docs/showcase.md
index 131e1193..37674167 100644
--- a/website/docs/showcase.md
+++ b/website/docs/showcase.md
@@ -104,7 +104,7 @@ The Paytaca wallet has a built-in P2P Exchange which allows user to buy or sell
     <a href="https://bchpump.cash/" target="_blank"><img src="/img/bch-pump.jpg" /></a>
 </div>
 
-BCH Pump is a CashTokens Launchpad inspired by the 'pump.fun' mechanism to bootstrap tokens on a bonding curve. The pools are migrated to Cauldron DEX once the bonding process is completed. The BCH Pump contracts are written with CashScript and use a multi-contract and multisetp-setup in its design.
+BCH Pump is a CashTokens Launchpad inspired by the 'pump.fun' mechanism to bootstrap tokens on a bonding curve. The pools are migrated to Cauldron DEX once the bonding process is completed. The BCH Pump contracts are written with CashScript and use a multi-contract and multi-step setup in its design.
 
 ## Unspent Phi
 

From 221deefc0a4bfebefecc829ae7ec751e0298ea4b Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 19 Jun 2025 09:56:24 +0200
Subject: [PATCH 266/267] Clean up TODOs / comments before release

---
 packages/cashc/src/compiler.ts                |  3 +--
 packages/cashscript/src/LibauthTemplate.ts    | 15 ---------------
 packages/cashscript/src/Transaction.ts        |  2 +-
 packages/cashscript/src/TransactionBuilder.ts |  4 +---
 packages/cashscript/src/debugging.ts          |  5 ++++-
 website/docs/basics/getting-started.md        |  2 +-
 website/docs/releases/release-notes.md        |  2 +-
 7 files changed, 9 insertions(+), 24 deletions(-)

diff --git a/packages/cashc/src/compiler.ts b/packages/cashc/src/compiler.ts
index ad240d3a..2840accd 100644
--- a/packages/cashc/src/compiler.ts
+++ b/packages/cashc/src/compiler.ts
@@ -41,14 +41,13 @@ export function compileString(code: string): Artifact {
   if (scriptToAsm(optimisedBytecodeOld) !== scriptToAsm(optimisationResult.script)) {
     console.error(scriptToAsm(optimisedBytecodeOld));
     console.error(scriptToAsm(optimisationResult.script));
-    throw new Error('New bytecode optimisation is not backwards compatible');
+    throw new Error('New bytecode optimisation is not backwards compatible, please report this issue to the CashScript team');
   }
 
   // Attach debug information
   const debug = {
     bytecode: binToHex(scriptToBytecode(optimisationResult.script)),
     sourceMap: generateSourceMap(optimisationResult.locationData),
-    // sourceMap: traversal.sourceMap,
     logs: optimisationResult.logs,
     requires: optimisationResult.requires,
   };
diff --git a/packages/cashscript/src/LibauthTemplate.ts b/packages/cashscript/src/LibauthTemplate.ts
index 70f60ab5..dc4ae1e0 100644
--- a/packages/cashscript/src/LibauthTemplate.ts
+++ b/packages/cashscript/src/LibauthTemplate.ts
@@ -321,21 +321,6 @@ export const generateTemplateScenarioTransactionOutputLockingBytecode = (
   return binToHex(addressToLockScript(csOutput.to));
 };
 
-/**
- * Generates source outputs for a BitAuth template scenario
- *
- * @param csTransaction - The CashScript transaction to generate source outputs for
- * @returns An array of BitAuth template scenario outputs with locking scripts and values
- *
- * For each input in the transaction:
- * - Generates appropriate locking bytecode (P2PKH or contract)
- * - Includes the input value in satoshis
- * - Includes any token details if present
- *
- * The slotIndex tracks which input is the contract input vs P2PKH inputs
- * to properly generate the locking scripts.
- */
-// TODO: This looks like it needs some refactor to work with the new stuff
 const generateTemplateScenarioSourceOutputs = (
   csTransaction: Transaction,
 ): Array<WalletTemplateScenarioOutput<true>> => {
diff --git a/packages/cashscript/src/Transaction.ts b/packages/cashscript/src/Transaction.ts
index 9a30b668..276d041e 100644
--- a/packages/cashscript/src/Transaction.ts
+++ b/packages/cashscript/src/Transaction.ts
@@ -187,7 +187,7 @@ export class Transaction {
 
   // method to debug the transaction with libauth VM, throws upon evaluation error
   async debug(): Promise<DebugResults> {
-    if (!semver.satisfies(this.contract.artifact.compiler.version, '>=0.11.0-next.4', { includePrerelease: true })) {
+    if (!semver.satisfies(this.contract.artifact.compiler.version, '>=0.11.0')) {
       console.warn('For the best debugging experience, please recompile your contract with cashc version 0.11.0 or newer.');
     }
 
diff --git a/packages/cashscript/src/TransactionBuilder.ts b/packages/cashscript/src/TransactionBuilder.ts
index e84ba5c1..497287c5 100644
--- a/packages/cashscript/src/TransactionBuilder.ts
+++ b/packages/cashscript/src/TransactionBuilder.ts
@@ -170,7 +170,7 @@ export class TransactionBuilder {
       .map((input) => 'contract' in input.unlocker ? input.unlocker.contract.artifact.compiler.version : null)
       .filter((version) => version !== null);
 
-    if (!contractVersions.every((version) => semver.satisfies(version, '>=0.11.0-next.4', { includePrerelease: true }))) {
+    if (!contractVersions.every((version) => semver.satisfies(version, '>=0.11.0'))) {
       console.warn('For the best debugging experience, please recompile your contract with cashc version 0.11.0 or newer.');
     }
 
@@ -186,7 +186,6 @@ export class TransactionBuilder {
     return getLibauthTemplates(this);
   }
 
-  // TODO: see if we can merge with Transaction.ts
   async send(): Promise<TransactionDetails>;
   async send(raw: true): Promise<string>;
   async send(raw?: true): Promise<TransactionDetails | string> {
@@ -207,7 +206,6 @@ export class TransactionBuilder {
     }
   }
 
-  // TODO: see if we can merge with Transaction.ts
   private async getTxDetails(txid: string): Promise<TransactionDetails>;
   private async getTxDetails(txid: string, raw: true): Promise<string>;
   private async getTxDetails(txid: string, raw?: true): Promise<TransactionDetails | string> {
diff --git a/packages/cashscript/src/debugging.ts b/packages/cashscript/src/debugging.ts
index ab040e0b..bc7a1270 100644
--- a/packages/cashscript/src/debugging.ts
+++ b/packages/cashscript/src/debugging.ts
@@ -258,7 +258,10 @@ const calculateCleanupSize = (instructions: Array<AuthenticationInstruction | un
   // OP_NIP (or OP_DROP/OP_2DROP in optimised bytecode) is used for cleanup at the end of a function,
   // OP_ENDIF and OP_ELSE are the end of branches. We need to remove all of these to get to the actual last
   // executed instruction of a function
-  // TODO: What about OP_1??
+  // Note that in the case where we re-add OP_1 because we cannot optimise the final explicit VERIFY into an implicit one
+  // (like when dealing with if-statements, or with CHECKLOCKTIMEVERIFY), it is impossible to run into an implicit final
+  // verify failure. That is why OP_1 does not need to be included in the cleanup opcodes.
+  // TODO: Perhaps we also do not need to add OP_DROP/OP_2DROP either, because they only occur together with OP_1
   const cleanupOpcodes = [Op.OP_ENDIF, Op.OP_NIP, Op.OP_ELSE, Op.OP_DROP, Op.OP_2DROP];
 
   let cleanupSize = 0;
diff --git a/website/docs/basics/getting-started.md b/website/docs/basics/getting-started.md
index ebd9b557..31778f86 100644
--- a/website/docs/basics/getting-started.md
+++ b/website/docs/basics/getting-started.md
@@ -31,7 +31,7 @@ To write CashScript smart contracts locally you use a code editor. For the best
 
 :::note prerequisites
 - Basic familiarity with the command line
-- Node.js installed (v20 or newer)
+- Node.js installed (v22 or newer)
 - A code editor (VS Code recommended)
 :::
 
diff --git a/website/docs/releases/release-notes.md b/website/docs/releases/release-notes.md
index 58c6ceaa..e202e940 100644
--- a/website/docs/releases/release-notes.md
+++ b/website/docs/releases/release-notes.md
@@ -2,7 +2,7 @@
 title: Release Notes
 ---
 
-## v0.11.0-next.4
+## v0.11.0
 
 This update adds CashScript support for the new BCH 2025 network upgrade. To read more about the upgrade, see [this blog post](https://blog.bitjson.com/2025-chips/).
 

From 24bab8f5d898b4cab9d0fa9fe8c64883fa7901f4 Mon Sep 17 00:00:00 2001
From: Rosco Kalis <roscokalis@gmail.com>
Date: Thu, 19 Jun 2025 09:58:39 +0200
Subject: [PATCH 267/267] Bump version to 0.11.0

---
 examples/package.json                                       | 6 +++---
 examples/testing-suite/artifacts/example.artifact.ts        | 2 +-
 examples/testing-suite/package.json                         | 6 +++---
 packages/cashc/package.json                                 | 4 ++--
 packages/cashc/src/index.ts                                 | 2 +-
 packages/cashscript/package.json                            | 4 ++--
 packages/cashscript/test/fixture/Bar.artifact.ts            | 2 +-
 packages/cashscript/test/fixture/Bar.json                   | 4 ++--
 packages/cashscript/test/fixture/Foo.artifact.ts            | 2 +-
 packages/cashscript/test/fixture/Foo.json                   | 4 ++--
 .../test/fixture/SiblingIntrospection.artifact.ts           | 2 +-
 packages/cashscript/test/fixture/SiblingIntrospection.json  | 4 ++--
 packages/cashscript/test/fixture/announcement.artifact.ts   | 2 +-
 packages/cashscript/test/fixture/announcement.json          | 4 ++--
 packages/cashscript/test/fixture/bigint.artifact.ts         | 2 +-
 packages/cashscript/test/fixture/bigint.json                | 4 ++--
 packages/cashscript/test/fixture/bounded_bytes.artifact.ts  | 2 +-
 packages/cashscript/test/fixture/bounded_bytes.json         | 4 ++--
 packages/cashscript/test/fixture/hodl_vault.artifact.ts     | 2 +-
 packages/cashscript/test/fixture/hodl_vault.json            | 4 ++--
 packages/cashscript/test/fixture/mecenas.artifact.ts        | 2 +-
 packages/cashscript/test/fixture/mecenas.json               | 4 ++--
 packages/cashscript/test/fixture/p2palindrome.artifact.ts   | 2 +-
 packages/cashscript/test/fixture/p2palindrome.json          | 4 ++--
 packages/cashscript/test/fixture/p2pkh.artifact.ts          | 2 +-
 packages/cashscript/test/fixture/p2pkh.json                 | 4 ++--
 .../test/fixture/token_category_comparison.artifact.ts      | 2 +-
 .../cashscript/test/fixture/token_category_comparison.json  | 4 ++--
 .../test/fixture/transfer_with_timeout.artifact.ts          | 2 +-
 packages/cashscript/test/fixture/transfer_with_timeout.json | 4 ++--
 packages/utils/package.json                                 | 2 +-
 31 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/examples/package.json b/examples/package.json
index b28398b7..4562e047 100644
--- a/examples/package.json
+++ b/examples/package.json
@@ -1,7 +1,7 @@
 {
   "name": "cashscript-examples",
   "private": true,
-  "version": "0.11.0-next.4",
+  "version": "0.11.0",
   "description": "Usage examples of the CashScript SDK",
   "main": "p2pkh.js",
   "type": "module",
@@ -13,8 +13,8 @@
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
     "@types/node": "^22.10.7",
-    "cashc": "^0.11.0-next.4",
-    "cashscript": "^0.11.0-next.4",
+    "cashc": "^0.11.0",
+    "cashscript": "^0.11.0",
     "eslint": "^8.56.0",
     "typescript": "^5.7.3"
   }
diff --git a/examples/testing-suite/artifacts/example.artifact.ts b/examples/testing-suite/artifacts/example.artifact.ts
index 8897869f..6670b71d 100644
--- a/examples/testing-suite/artifacts/example.artifact.ts
+++ b/examples/testing-suite/artifacts/example.artifact.ts
@@ -41,7 +41,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.3',
+    version: '0.11.0',
   },
   updatedAt: '2025-04-11T09:08:09.750Z',
 } as const;
diff --git a/examples/testing-suite/package.json b/examples/testing-suite/package.json
index 3cd0627c..089e7587 100644
--- a/examples/testing-suite/package.json
+++ b/examples/testing-suite/package.json
@@ -1,6 +1,6 @@
 {
   "name": "testing-suite",
-  "version": "0.11.0-next.4",
+  "version": "0.11.0",
   "description": "Example project to develop and test CashScript contracts",
   "main": "index.js",
   "type": "module",
@@ -26,8 +26,8 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "cashc": "^0.11.0-next.4",
-    "cashscript": "^0.11.0-next.4",
+    "cashc": "^0.11.0",
+    "cashscript": "^0.11.0",
     "url-join": "^5.0.0"
   },
   "devDependencies": {
diff --git a/packages/cashc/package.json b/packages/cashc/package.json
index fbde0be2..f903c87c 100644
--- a/packages/cashc/package.json
+++ b/packages/cashc/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashc",
-  "version": "0.11.0-next.4",
+  "version": "0.11.0",
   "description": "Compile Bitcoin Cash contracts to Bitcoin Cash Script or artifacts",
   "keywords": [
     "bitcoin",
@@ -52,7 +52,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.4",
+    "@cashscript/utils": "^0.11.0",
     "antlr4": "^4.13.2",
     "commander": "^13.1.0",
     "semver": "^7.6.3"
diff --git a/packages/cashc/src/index.ts b/packages/cashc/src/index.ts
index 0b81e25a..b6530ab2 100644
--- a/packages/cashc/src/index.ts
+++ b/packages/cashc/src/index.ts
@@ -2,4 +2,4 @@ export * from './Errors.js';
 export * as utils from '@cashscript/utils';
 export { compileFile, compileString } from './compiler.js';
 
-export const version = '0.11.0-next.4';
+export const version = '0.11.0';
diff --git a/packages/cashscript/package.json b/packages/cashscript/package.json
index 2a340940..791f556c 100644
--- a/packages/cashscript/package.json
+++ b/packages/cashscript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cashscript",
-  "version": "0.11.0-next.4",
+  "version": "0.11.0",
   "description": "Easily write and interact with Bitcoin Cash contracts",
   "keywords": [
     "bitcoin cash",
@@ -46,7 +46,7 @@
   },
   "dependencies": {
     "@bitauth/libauth": "^3.1.0-next.2",
-    "@cashscript/utils": "^0.11.0-next.4",
+    "@cashscript/utils": "^0.11.0",
     "@electrum-cash/network": "^4.1.1",
     "@mr-zwets/bchn-api-wrapper": "^1.0.1",
     "delay": "^6.0.0",
diff --git a/packages/cashscript/test/fixture/Bar.artifact.ts b/packages/cashscript/test/fixture/Bar.artifact.ts
index ed92e583..407ef1cf 100644
--- a/packages/cashscript/test/fixture/Bar.artifact.ts
+++ b/packages/cashscript/test/fixture/Bar.artifact.ts
@@ -64,7 +64,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:54.204Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/Bar.json b/packages/cashscript/test/fixture/Bar.json
index fbf1f61a..2e899afc 100644
--- a/packages/cashscript/test/fixture/Bar.json
+++ b/packages/cashscript/test/fixture/Bar.json
@@ -64,7 +64,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:53.940Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/Foo.artifact.ts b/packages/cashscript/test/fixture/Foo.artifact.ts
index 81fc5221..94635a15 100644
--- a/packages/cashscript/test/fixture/Foo.artifact.ts
+++ b/packages/cashscript/test/fixture/Foo.artifact.ts
@@ -48,7 +48,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:54.732Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/Foo.json b/packages/cashscript/test/fixture/Foo.json
index 4e3e6bcc..0333d286 100644
--- a/packages/cashscript/test/fixture/Foo.json
+++ b/packages/cashscript/test/fixture/Foo.json
@@ -48,7 +48,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:54.487Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
index 722cbacc..ee356881 100644
--- a/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.artifact.ts
@@ -62,7 +62,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T16:07:30.092Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/SiblingIntrospection.json b/packages/cashscript/test/fixture/SiblingIntrospection.json
index 9479547b..08d2104e 100644
--- a/packages/cashscript/test/fixture/SiblingIntrospection.json
+++ b/packages/cashscript/test/fixture/SiblingIntrospection.json
@@ -62,7 +62,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T16:07:29.693Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/announcement.artifact.ts b/packages/cashscript/test/fixture/announcement.artifact.ts
index 26063082..86e132bd 100644
--- a/packages/cashscript/test/fixture/announcement.artifact.ts
+++ b/packages/cashscript/test/fixture/announcement.artifact.ts
@@ -34,7 +34,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T14:40:53.438Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/announcement.json b/packages/cashscript/test/fixture/announcement.json
index b2e56928..5a9a2d17 100644
--- a/packages/cashscript/test/fixture/announcement.json
+++ b/packages/cashscript/test/fixture/announcement.json
@@ -34,7 +34,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-05-11T10:02:25.092Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/bigint.artifact.ts b/packages/cashscript/test/fixture/bigint.artifact.ts
index 804a9c4b..214d68a9 100644
--- a/packages/cashscript/test/fixture/bigint.artifact.ts
+++ b/packages/cashscript/test/fixture/bigint.artifact.ts
@@ -35,7 +35,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:52.713Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/bigint.json b/packages/cashscript/test/fixture/bigint.json
index 82048fac..904d7499 100644
--- a/packages/cashscript/test/fixture/bigint.json
+++ b/packages/cashscript/test/fixture/bigint.json
@@ -35,7 +35,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:52.485Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/bounded_bytes.artifact.ts b/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
index dea3fcbb..811d4fd7 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
+++ b/packages/cashscript/test/fixture/bounded_bytes.artifact.ts
@@ -31,7 +31,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:56.281Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/bounded_bytes.json b/packages/cashscript/test/fixture/bounded_bytes.json
index 5925cff3..5b6a8a36 100644
--- a/packages/cashscript/test/fixture/bounded_bytes.json
+++ b/packages/cashscript/test/fixture/bounded_bytes.json
@@ -31,7 +31,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:56.024Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/hodl_vault.artifact.ts b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
index 5ea474b1..92ed0243 100644
--- a/packages/cashscript/test/fixture/hodl_vault.artifact.ts
+++ b/packages/cashscript/test/fixture/hodl_vault.artifact.ts
@@ -68,7 +68,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:55.227Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/hodl_vault.json b/packages/cashscript/test/fixture/hodl_vault.json
index b82703a5..ac7eebbc 100644
--- a/packages/cashscript/test/fixture/hodl_vault.json
+++ b/packages/cashscript/test/fixture/hodl_vault.json
@@ -68,7 +68,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:54.980Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/mecenas.artifact.ts b/packages/cashscript/test/fixture/mecenas.artifact.ts
index dff019a7..5d72fe62 100644
--- a/packages/cashscript/test/fixture/mecenas.artifact.ts
+++ b/packages/cashscript/test/fixture/mecenas.artifact.ts
@@ -72,7 +72,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:58.336Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/mecenas.json b/packages/cashscript/test/fixture/mecenas.json
index 0265e4e2..0e86e989 100644
--- a/packages/cashscript/test/fixture/mecenas.json
+++ b/packages/cashscript/test/fixture/mecenas.json
@@ -72,7 +72,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:58.078Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/p2palindrome.artifact.ts b/packages/cashscript/test/fixture/p2palindrome.artifact.ts
index bd39a87d..67e321b2 100644
--- a/packages/cashscript/test/fixture/p2palindrome.artifact.ts
+++ b/packages/cashscript/test/fixture/p2palindrome.artifact.ts
@@ -27,7 +27,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:55.718Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/p2palindrome.json b/packages/cashscript/test/fixture/p2palindrome.json
index c891aeed..87fb9103 100644
--- a/packages/cashscript/test/fixture/p2palindrome.json
+++ b/packages/cashscript/test/fixture/p2palindrome.json
@@ -27,7 +27,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:55.464Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/p2pkh.artifact.ts b/packages/cashscript/test/fixture/p2pkh.artifact.ts
index 4997312b..8b197a2a 100644
--- a/packages/cashscript/test/fixture/p2pkh.artifact.ts
+++ b/packages/cashscript/test/fixture/p2pkh.artifact.ts
@@ -40,7 +40,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:57.831Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/p2pkh.json b/packages/cashscript/test/fixture/p2pkh.json
index 771e3500..0d52d36c 100644
--- a/packages/cashscript/test/fixture/p2pkh.json
+++ b/packages/cashscript/test/fixture/p2pkh.json
@@ -40,7 +40,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:57.597Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/token_category_comparison.artifact.ts b/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
index 210a5830..8809e2c8 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
+++ b/packages/cashscript/test/fixture/token_category_comparison.artifact.ts
@@ -22,7 +22,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:57.354Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/token_category_comparison.json b/packages/cashscript/test/fixture/token_category_comparison.json
index fac09bdd..d5c0d54e 100644
--- a/packages/cashscript/test/fixture/token_category_comparison.json
+++ b/packages/cashscript/test/fixture/token_category_comparison.json
@@ -22,7 +22,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:57.130Z"
-}
\ No newline at end of file
+}
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
index 8151e93b..b42aa6d6 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.artifact.ts
@@ -57,7 +57,7 @@ export default {
   },
   compiler: {
     name: 'cashc',
-    version: '0.11.0-next.4',
+    version: '0.11.0',
   },
   updatedAt: '2025-06-16T15:05:56.888Z',
 } as const;
diff --git a/packages/cashscript/test/fixture/transfer_with_timeout.json b/packages/cashscript/test/fixture/transfer_with_timeout.json
index 57499245..78311a54 100644
--- a/packages/cashscript/test/fixture/transfer_with_timeout.json
+++ b/packages/cashscript/test/fixture/transfer_with_timeout.json
@@ -57,7 +57,7 @@
   },
   "compiler": {
     "name": "cashc",
-    "version": "0.11.0-next.4"
+    "version": "0.11.0"
   },
   "updatedAt": "2025-06-16T15:05:56.646Z"
-}
\ No newline at end of file
+}
diff --git a/packages/utils/package.json b/packages/utils/package.json
index 19954ae5..0a672343 100644
--- a/packages/utils/package.json
+++ b/packages/utils/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@cashscript/utils",
-  "version": "0.11.0-next.4",
+  "version": "0.11.0",
   "description": "CashScript utilities and types",
   "keywords": [
     "bitcoin cash",