@hardkas/testing 0.12.0-rc.21 → 0.12.0-rc.23

package/README.md

@@ -1,65 +1,65 @@
-# @hardkas/testing
-
-The `@hardkas/testing` package provides the `scenario` engine to write fully deterministic, artifact-driven tests and scenarios for HardKAS projects using [Vitest](https://vitest.dev/).
-
-## Your first scenario
-
-Writing a scenario is just like writing a normal Vitest test, but using the `scenario` bridge. The engine automatically provisions a fully configured `HardkasEnvironment` (`hk`) for your test, complete with funded simulated accounts and artifact tracing.
-
-```typescript
-import { scenario, expect } from "@hardkas/testing/scenarios";
-
-scenario("my first payment", async ({ hk }) => {
-  // 1. Resolve accounts
-  const alice = await hk.accounts.resolve("alice");
-  const bob = await hk.accounts.resolve("bob");
-  
-  const beforeBob = await hk.accounts.balance(bob.address);
-
-  // 2. Transact
-  const plan = await hk.tx.plan({
-    from: alice.address,
-    to: bob.address,
-    amount: "10" // 10 KAS
-  });
-
-  const signed = await hk.tx.sign(plan);
-  const result = await hk.tx.send(signed);
-
-  // 3. Verify
-  const afterBob = await hk.accounts.balance(bob.address);
-  expect(afterBob.sompi - beforeBob.sompi).toBe(10n * 100000000n);
-});
-```
-
-## Scenario Result Artifacts
-
-Whenever a scenario finishes running, it produces a `ScenarioResultV1` artifact, saving the outcome inside your project's `.hardkas/artifacts/` folder:
-
-```json
-{
-  "schema": "hardkas.scenarioResult.v1",
-  "scenarioName": "my first payment",
-  "status": "passed",
-  "artifactsGenerated": [
-    "simulated-plan-4d7c...",
-    "signedTx-89799cd..."
-  ]
-}
-```
-
-If your test fails, the engine safely extracts the assertion error and logs a `failed` scenario result, capturing the state of the failure natively without dumping raw stack traces into the JSON.
-
-## Parallel Execution
-Localnet state currently defaults to a shared state across scenarios. To avoid state corruption, make sure you configure your `vitest.config.ts` to execute sequentially:
-
-```typescript
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    fileParallelism: false,
-    pool: "forks"
-  }
-});
-```
+# @hardkas/testing
+
+The `@hardkas/testing` package provides the `scenario` engine to write fully deterministic, artifact-driven tests and scenarios for HardKAS projects using [Vitest](https://vitest.dev/).
+
+## Your first scenario
+
+Writing a scenario is just like writing a normal Vitest test, but using the `scenario` bridge. The engine automatically provisions a fully configured `HardkasEnvironment` (`hk`) for your test, complete with funded simulated accounts and artifact tracing.
+
+```typescript
+import { scenario, expect } from "@hardkas/testing/scenarios";
+
+scenario("my first payment", async ({ hk }) => {
+  // 1. Resolve accounts
+  const alice = await hk.accounts.resolve("alice");
+  const bob = await hk.accounts.resolve("bob");
+  
+  const beforeBob = await hk.accounts.balance(bob.address);
+
+  // 2. Transact
+  const plan = await hk.tx.plan({
+    from: alice.address,
+    to: bob.address,
+    amount: "10" // 10 KAS
+  });
+
+  const signed = await hk.tx.sign(plan);
+  const result = await hk.tx.send(signed);
+
+  // 3. Verify
+  const afterBob = await hk.accounts.balance(bob.address);
+  expect(afterBob.sompi - beforeBob.sompi).toBe(10n * 100000000n);
+});
+```
+
+## Scenario Result Artifacts
+
+Whenever a scenario finishes running, it produces a `ScenarioResultV1` artifact, saving the outcome inside your project's `.hardkas/artifacts/` folder:
+
+```json
+{
+  "schema": "hardkas.scenarioResult.v1",
+  "scenarioName": "my first payment",
+  "status": "passed",
+  "artifactsGenerated": [
+    "simulated-plan-4d7c...",
+    "signedTx-89799cd..."
+  ]
+}
+```
+
+If your test fails, the engine safely extracts the assertion error and logs a `failed` scenario result, capturing the state of the failure natively without dumping raw stack traces into the JSON.
+
+## Parallel Execution
+Localnet state currently defaults to a shared state across scenarios. To avoid state corruption, make sure you configure your `vitest.config.ts` to execute sequentially:
+
+```typescript
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    fileParallelism: false,
+    pool: "forks"
+  }
+});
+```

package/dist/adversarial-fixtures.js

@@ -1,6 +1,6 @@
 import {
   AdversarialFixtures
-} from "./chunk-FTTKPLMQ.js";
+} from "./chunk-LALAYTVL.js";
 import "./chunk-3RG5ZIWI.js";
 export {
   AdversarialFixtures

package/dist/{chunk-FTTKPLMQ.js → chunk-LALAYTVL.js}

@@ -9,23 +9,19 @@ var AdversarialFixtures = {
    * Circular lineage: A -> B -> A
    */
   circularLineage() {
+    const bodyA = { schema: "hardkas.txPlan", version: ARTIFACT_VERSION, hashVersion: 3, networkId: "simnet", mode: "simulator", nonce: "A" };
+    const bodyB = { schema: "hardkas.txPlan", version: ARTIFACT_VERSION, hashVersion: 3, networkId: "simnet", mode: "simulator", nonce: "B" };
+    const hashA = calculateContentHash(bodyA, 3);
+    const hashB = calculateContentHash(bodyB, 3);
     const artifactA = {
-      schema: "hardkas.txPlan",
-      version: ARTIFACT_VERSION,
-      artifactId: "art-a",
-      contentHash: "hash-a",
-      networkId: "simnet",
-      mode: "simulator",
-      lineage: { parentArtifactId: "art-b" }
+      ...bodyA,
+      contentHash: hashA,
+      lineage: { artifactId: hashA, lineageId: hashB, parentArtifactId: hashB, rootArtifactId: hashB, sequence: 2 }
     };
     const artifactB = {
-      schema: "hardkas.txPlan",
-      version: ARTIFACT_VERSION,
-      artifactId: "art-b",
-      contentHash: "hash-b",
-      networkId: "simnet",
-      mode: "simulator",
-      lineage: { parentArtifactId: "art-a" }
+      ...bodyB,
+      contentHash: hashB,
+      lineage: { artifactId: hashB, lineageId: hashA, parentArtifactId: hashA, rootArtifactId: hashA, sequence: 2 }
     };
     return { artifactA, artifactB };
   },
@@ -60,25 +56,29 @@ var AdversarialFixtures = {
     const parent = {
       schema: "hardkas.txPlan",
       version: ARTIFACT_VERSION,
-      artifactId: "parent-mainnet",
-      contentHash: "hash-mainnet",
+      hashVersion: CURRENT_HASH_VERSION,
       networkId: "mainnet",
-      mode: "l1-rpc"
+      mode: "l1-rpc",
+      lineage: { artifactId: "", sequence: 1 }
     };
+    parent.contentHash = calculateContentHash(parent, CURRENT_HASH_VERSION);
+    parent.lineage.artifactId = parent.contentHash;
     const child = {
       schema: "hardkas.signedTx",
       version: ARTIFACT_VERSION,
-      artifactId: "child-simnet",
-      contentHash: "hash-simnet",
+      hashVersion: CURRENT_HASH_VERSION,
       networkId: "simnet",
       mode: "simulator",
       lineage: {
-        artifactId: "hash-simnet",
-        parentArtifactId: "parent-mainnet",
-        lineageId: "b".repeat(64),
-        rootArtifactId: "c".repeat(64)
+        artifactId: "",
+        parentArtifactId: parent.contentHash,
+        lineageId: parent.contentHash,
+        rootArtifactId: parent.contentHash,
+        sequence: 2
       }
     };
+    child.contentHash = calculateContentHash(child, CURRENT_HASH_VERSION);
+    child.lineage.artifactId = child.contentHash;
     return { parent, child };
   },
   /**

package/dist/{chunk-J7YJZ3SC.js → chunk-LAUXD45S.js}

@@ -16,10 +16,10 @@ var hardKasMatchers = {
   },
   toHaveValidTxId(received) {
     const txId = received?.txId || (typeof received === "string" ? received : "");
-    const pass = typeof txId === "string" && (txId.startsWith("simtx_") || /^[0-9a-fA-F]{64}$/.test(txId));
+    const pass = typeof txId === "string" && (/^synthetic-[0-9a-f]{64}$/.test(txId) || /^[0-9a-fA-F]{64}$/.test(txId));
     return {
       pass,
-      message: () => pass ? `Expected "${txId}" NOT to be a valid txId` : `Expected "${txId}" to be a valid txId (starts with "simtx_" or is 64-char hex)`
+      message: () => pass ? `Expected "${txId}" NOT to be a valid txId` : `Expected "${txId}" to be a valid txId (synthetic-<64 hex> or 64-char hex)`
     };
   },
   toHaveValidContentHash(received) {

package/dist/{chunk-67IMLFOT.js → chunk-Q4NLRRZC.js}

@@ -3,8 +3,9 @@ import {
 } from "./chunk-AHS4TIKV.js";
 
 // src/reproducibility.ts
-import { calculateContentHash, HARDKAS_VERSION } from "@hardkas/artifacts";
+import { calculateContentHash, CURRENT_HASH_VERSION, HARDKAS_VERSION } from "@hardkas/artifacts";
 import { runLinearChain, runWideDag, profileMass } from "@hardkas/simulator";
+var digestCurrent = (value) => calculateContentHash(value, CURRENT_HASH_VERSION);
 function generateReproducibilityReport() {
   const l1Plan = {
     schema: "hardkas.txPlan",
@@ -85,30 +86,30 @@ function generateReproducibilityReport() {
     proofVersion: "repro-v0",
     hardkasVersion: HARDKAS_VERSION,
     artifacts: {
-      l1Plan: calculateContentHash(l1Plan),
-      l1Signed: calculateContentHash(l1Signed),
-      igraPlan: calculateContentHash(igraPlan),
-      dagLinearScenario: calculateContentHash({
+      l1Plan: digestCurrent(l1Plan),
+      l1Signed: digestCurrent(l1Signed),
+      igraPlan: digestCurrent(igraPlan),
+      dagLinearScenario: digestCurrent({
         totalBlocks: linearResult.metrics.totalBlocks,
         blueBlocks: linearResult.metrics.blueBlocks,
         redBlocks: linearResult.metrics.redBlocks,
         redRatioPpm: linearRedPpm,
         selectedChainLength: linearResult.metrics.selectedChainLength
       }),
-      dagWideScenario: calculateContentHash({
+      dagWideScenario: digestCurrent({
         totalBlocks: wideResult.metrics.totalBlocks,
         blueBlocks: wideResult.metrics.blueBlocks,
         redBlocks: wideResult.metrics.redBlocks,
         redRatioPpm: wideRedPpm
       }),
-      massProfile: calculateContentHash({
+      massProfile: digestCurrent({
         totalMass: massResult.totalMass.toString(),
         inputMass: massResult.inputMass.toString(),
         outputMass: massResult.outputMass.toString(),
         estimatedFeeSompi: massResult.estimatedFeeSompi.toString()
       }),
-      canonicalNested: calculateContentHash(nestedObj),
-      simulatedTxReceipt: txResult.ok ? calculateContentHash({
+      canonicalNested: digestCurrent(nestedObj),
+      simulatedTxReceipt: txResult.ok ? digestCurrent({
         status: txResult.receipt.status,
         txId: txResult.receipt.txId
       }) : "TX_FAILED"

package/dist/index.d.ts

@@ -27,7 +27,7 @@ interface HardKasMatchers<R = void> {
     toBeAccepted(): R;
     /** Assert a receipt has status "failed". */
     toBeFailed(): R;
-    /** Assert a receipt contains a valid txId (starts with "simtx_" or is 64-char hex). */
+    /** Assert a receipt contains a valid txId (`synthetic-<64 hex>` or 64-char hex). */
     toHaveValidTxId(): R;
     /** Assert an artifact has a valid contentHash (64-char hex). */
     toHaveValidContentHash(): R;
@@ -100,21 +100,58 @@ declare const hardKasMatchers: {
 };
 
 /**
- * Deterministic fixture signer for Docker testing on simnet.
+ * Domain tag under which the registry keys below are computed. Publicly known
+ * dev-only marker: any key computed under it is by construction NOT a production
+ * key and MUST NOT hold real funds. Bumping this string is a breaking change to
+ * every fixture address and requires updating the registry values in lockstep.
+ */
+declare const HARDKAS_FIXTURE_DERIVATION_DOMAIN = "hardkas-dev-fixture:v1";
+/**
+ * The exhaustive, auditable set of HardKAS development fixture names.
+ * Extending this set is a repo-visible change (add a name + its derived hex).
+ * Anything not in this set fails closed at signer construction — HardKAS does
+ * NOT expose a general "name → private key" derivation API to external callers.
+ */
+declare const HARDKAS_FIXTURE_NAMES: readonly ["default", "alice", "bob", "carol", "dave", "erin"];
+type HardkasFixtureName = (typeof HARDKAS_FIXTURE_NAMES)[number];
+/**
+ * Read-only registry of fixture name → 32-byte private-key hex. Values are
+ * derived once from the domain above and frozen. Consumers can audit each
+ * entry by recomputing `sha256("hardkas-dev-fixture:v1\0<name>")`.
+ */
+declare const HARDKAS_FIXTURE_REGISTRY: Readonly<Record<HardkasFixtureName, string>>;
+/**
+ * Return the private-key hex for a registered fixture name.
+ * Throws HARDKAS_UNKNOWN_FIXTURE when the name is not in the registry.
+ */
+declare function getHardkasFixtureKey(fixtureName: HardkasFixtureName | string): string;
+/**
+ * Deterministic fixture signer for HardKAS development on simnet/testnet.
  * Never to be used with real funds or mainnet.
+ *
+ * Historical note (rc.22 audit DEF-14 + Wave 0):
+ * - Pre-Wave 0: a single RFC 6979 test-vector key was hard-coded; every
+ *   fixture-named account collapsed to one identity.
+ * - Wave 0 first pass: switched to arbitrary-name sha256 derivation.
+ * - Wave 0 design review: rejected the arbitrary-name API — HardKAS does not
+ *   introduce a general "human name → private key" scheme merely to solve test
+ *   fixtures. The registry above is the entire fixture identity surface.
  */
 declare class HardkasFixtureSigner implements ExternalHardkasSigner {
-    private networkId;
-    private readonly FIXTURE_PK;
-    constructor(networkId?: string);
+    readonly networkId: string;
+    readonly fixtureName: HardkasFixtureName;
+    private cachedPrivateKeyHex;
+    constructor(networkId?: string, fixtureName?: HardkasFixtureName | string);
+    private privateKeyHex;
     private loadKaspa;
     getAddress(): Promise<string>;
     signTransaction(plan: TxPlanArtifact): Promise<SignedTxArtifact>;
 }
 
 /**
- * Simulated signer for simnet development.
- * Produces deterministic signatures without real private keys.
+ * Synthetic authorizer for simnet development (Wave 1.4 · IC-6′.4).
+ * Produces no signature: it authorizes the plan by its identity, deterministically,
+ * without private keys. The txId is the single synthetic scheme `synthetic-<planArtifactId>`.
  */
 declare class SimulatedTxPlanSigner implements HardkasTxPlanSigner {
     kind: HardkasSignerKind;
@@ -194,4 +231,4 @@ declare class TortureInvariantError extends Error {
     constructor(message: string, code: string, severity?: "info" | "warning" | "critical" | "catastrophic");
 }
 
-export { type FixtureDefinition, type HardKasMatchers, HardkasFixtureSigner, LcgPrng, SimulatedTxPlanSigner, TestHarness, type TortureBucket, type TortureBucketContext, type TortureCaseResult, TortureInvariantError, createFixture, getAllTortureBuckets, getTortureBucket, hardKasMatchers };
+export { type FixtureDefinition, HARDKAS_FIXTURE_DERIVATION_DOMAIN, HARDKAS_FIXTURE_NAMES, HARDKAS_FIXTURE_REGISTRY, type HardKasMatchers, type HardkasFixtureName, HardkasFixtureSigner, LcgPrng, SimulatedTxPlanSigner, TestHarness, type TortureBucket, type TortureBucketContext, type TortureCaseResult, TortureInvariantError, createFixture, getAllTortureBuckets, getHardkasFixtureKey, getTortureBucket, hardKasMatchers };

package/dist/index.js

@@ -1,9 +1,9 @@
 import {
   AdversarialFixtures
-} from "./chunk-FTTKPLMQ.js";
+} from "./chunk-LALAYTVL.js";
 import {
   generateReproducibilityReport
-} from "./chunk-67IMLFOT.js";
+} from "./chunk-Q4NLRRZC.js";
 import {
   clearMassRecords,
   createTestHarness,
@@ -13,7 +13,7 @@ import {
 } from "./chunk-AHS4TIKV.js";
 import {
   hardKasMatchers
-} from "./chunk-J7YJZ3SC.js";
+} from "./chunk-LAUXD45S.js";
 import {
   __require
 } from "./chunk-3RG5ZIWI.js";
@@ -39,6 +39,7 @@ function createFixture(def) {
 }
 
 // src/fixture-signer.ts
+import { createHash } from "crypto";
 import {
   calculateContentHash,
   HARDKAS_VERSION,
@@ -52,22 +53,74 @@ import {
   planOutputsWithChange,
   toWasmScriptPublicKey
 } from "@hardkas/accounts";
+var HARDKAS_FIXTURE_DERIVATION_DOMAIN = "hardkas-dev-fixture:v1";
+var HARDKAS_FIXTURE_NAMES = [
+  "default",
+  "alice",
+  "bob",
+  "carol",
+  "dave",
+  "erin"
+];
+function internalDeriveFixtureKeyHex(name) {
+  const material = `${HARDKAS_FIXTURE_DERIVATION_DOMAIN}\0${name}`;
+  const hex = createHash("sha256").update(material, "utf8").digest("hex");
+  if (/^0+$/.test(hex)) {
+    throw new Error("FIXTURE_DERIVATION_DEGENERATE: derived key is zero (astronomically improbable).");
+  }
+  return hex;
+}
+var HARDKAS_FIXTURE_REGISTRY = Object.freeze(
+  HARDKAS_FIXTURE_NAMES.reduce(
+    (acc, name) => {
+      acc[name] = internalDeriveFixtureKeyHex(name);
+      return acc;
+    },
+    {}
+  )
+);
+function getHardkasFixtureKey(fixtureName) {
+  if (!(fixtureName in HARDKAS_FIXTURE_REGISTRY)) {
+    const known = HARDKAS_FIXTURE_NAMES.join(", ");
+    const err = new Error(
+      `HARDKAS_UNKNOWN_FIXTURE: '${fixtureName}' is not a registered dev fixture. Known fixtures: ${known}. HardKAS does not derive keys from arbitrary names; use 'hardkas accounts real generate' to create a fresh keypair with any name.`
+    );
+    err.code = "HARDKAS_UNKNOWN_FIXTURE";
+    throw err;
+  }
+  return HARDKAS_FIXTURE_REGISTRY[fixtureName];
+}
 var HardkasFixtureSigner = class {
   networkId;
-  // A deterministic, known private key exclusively for Docker tests.
-  FIXTURE_PK = "b7e151628aed2a6abf7158809cf4f3c762e7160f38b4da56a784d9045190cfef";
-  constructor(networkId = "simnet") {
+  fixtureName;
+  cachedPrivateKeyHex;
+  constructor(networkId = "simnet", fixtureName = "default") {
     this.networkId = networkId;
     if (networkId === "mainnet") {
       throw new Error("FixtureSigner cannot be used on mainnet.");
     }
+    if (!(fixtureName in HARDKAS_FIXTURE_REGISTRY)) {
+      const known = HARDKAS_FIXTURE_NAMES.join(", ");
+      const err = new Error(
+        `HARDKAS_UNKNOWN_FIXTURE: '${fixtureName}' is not a registered dev fixture. Known fixtures: ${known}. HardKAS does not derive keys from arbitrary names; use 'hardkas accounts real generate' to create a fresh keypair with any name.`
+      );
+      err.code = "HARDKAS_UNKNOWN_FIXTURE";
+      throw err;
+    }
+    this.fixtureName = fixtureName;
+  }
+  privateKeyHex() {
+    if (!this.cachedPrivateKeyHex) {
+      this.cachedPrivateKeyHex = HARDKAS_FIXTURE_REGISTRY[this.fixtureName];
+    }
+    return this.cachedPrivateKeyHex;
   }
   async loadKaspa() {
     return loadKaspaWasm();
   }
   async getAddress() {
     const kaspa = await this.loadKaspa();
-    const privKey = new kaspa.PrivateKey(this.FIXTURE_PK);
+    const privKey = new kaspa.PrivateKey(this.privateKeyHex());
     return privKey.toKeypair().toAddress(this.networkId).toString();
   }
   async signTransaction(plan) {
@@ -75,7 +128,7 @@ var HardkasFixtureSigner = class {
       throw new Error("FixtureSigner refuses to sign mainnet transactions.");
     }
     const kaspa = await this.loadKaspa();
-    const privateKey = new kaspa.PrivateKey(this.FIXTURE_PK);
+    const privateKey = new kaspa.PrivateKey(this.privateKeyHex());
     const utxos = plan.inputs.map((u) => {
       if (!u.outpoint.transactionId || u.outpoint.index === void 0) {
         throw new Error(`UTXO is missing transactionId or index. Re-run tx plan.`);
@@ -154,17 +207,20 @@ var HardkasFixtureSigner = class {
 };
 
 // src/simulated-tx-plan-signer.ts
+import { SYNTHETIC_AUTHORIZATION_FORMAT, syntheticTxIdFor } from "@hardkas/artifacts";
 var SimulatedTxPlanSigner = class {
   kind = "synthetic";
   async signTxPlan(input) {
     const { planArtifact } = input;
     const plan = planArtifact;
+    const planArtifactId = typeof plan.contentHash === "string" ? plan.contentHash : "";
     return {
       signatureKind: "synthetic",
       signerAddress: plan.from.address,
+      .../^[0-9a-f]{64}$/.test(planArtifactId) ? { txId: syntheticTxIdFor(planArtifactId) } : {},
       signedTransaction: {
-        format: "simulated",
-        payload: `simulated-signed-tx:${plan.planId}`
+        format: SYNTHETIC_AUTHORIZATION_FORMAT,
+        payload: planArtifactId
       }
     };
   }
@@ -267,7 +323,7 @@ registerTortureBucket({
       for (let i = 0; i < artifactCount; i++) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -361,7 +417,7 @@ registerTortureBucket({
     try {
       const payload = {
         schema: "hardkas.txPlan",
-        hardkasVersion: "0.12.0-rc.21",
+        hardkasVersion: "0.12.0-rc.23",
         version: ARTIFACT_VERSION2,
         networkId: "simnet",
         mode: "simulator",
@@ -441,7 +497,7 @@ registerTortureBucket({
     const orderA = prngA.shuffle(["alice", "bob", "carol", "dave"]);
     const payloadA = {
       schema: "hardkas.txPlan",
-      version: "0.12.0-rc.21",
+      version: "0.12.0-rc.23",
       networkId: "simnet",
       mode: "simulator",
       amountSompi: amountSompiA,
@@ -455,7 +511,7 @@ registerTortureBucket({
     const orderB = prngB.shuffle(["alice", "bob", "carol", "dave"]);
     const payloadB = {
       schema: "hardkas.txPlan",
-      version: "0.12.0-rc.21",
+      version: "0.12.0-rc.23",
       networkId: "simnet",
       mode: "simulator",
       amountSompi: amountSompiB,
@@ -487,7 +543,7 @@ registerTortureBucket({
     try {
       const payloadV1 = {
         schema: "hardkas.txPlan",
-        hardkasVersion: "0.12.0-rc.21",
+        hardkasVersion: "0.12.0-rc.23",
         version: ARTIFACT_VERSION2,
         networkId: "simnet",
         mode: "simulator",
@@ -588,7 +644,7 @@ registerTortureBucket({
       }
       const planArtifact = {
         schema: "hardkas.txPlan",
-        hardkasVersion: "0.12.0-rc.21",
+        hardkasVersion: "0.12.0-rc.23",
         version: ARTIFACT_VERSION2,
         networkId: "simnet",
         mode: "simulator",
@@ -645,7 +701,7 @@ registerTortureBucket({
       }
       const receiptArtifact = {
         schema: "hardkas.txReceipt",
-        hardkasVersion: "0.12.0-rc.21",
+        hardkasVersion: "0.12.0-rc.23",
         version: ARTIFACT_VERSION2,
         networkId: "simnet",
         mode: "simulator",
@@ -712,7 +768,7 @@ registerTortureBucket({
       const planId = `plan-mock-${ctx.caseId}-${ctx.caseSeed}`;
       const payload = {
         schema: "hardkas.txPlan",
-        hardkasVersion: "0.12.0-rc.21",
+        hardkasVersion: "0.12.0-rc.23",
         version: ARTIFACT_VERSION2,
         networkId: "simnet",
         mode: "simulator",
@@ -801,7 +857,7 @@ registerTortureBucket({
         case 8: {
           const orphanReceipt = {
             schema: "hardkas.txReceipt",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -925,7 +981,7 @@ registerTortureBucket({
         const pId = `plan-race-${i}-${ctx.caseSeed}`;
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -1010,7 +1066,7 @@ registerTortureBucket({
       const planId = `plan-stale-${ctx.caseSeed}`;
       const payload = {
         schema: "hardkas.txPlan",
-        hardkasVersion: "0.12.0-rc.21",
+        hardkasVersion: "0.12.0-rc.23",
         version: ARTIFACT_VERSION2,
         networkId: "simnet",
         mode: "simulator",
@@ -1165,7 +1221,7 @@ registerTortureBucket({
       for (let i = 0; i < 10; i++) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -1252,7 +1308,7 @@ registerTortureBucket({
       const traverseArtId = "../../traversal-escape";
       const payload = {
         schema: "hardkas.txPlan",
-        hardkasVersion: "0.12.0-rc.21",
+        hardkasVersion: "0.12.0-rc.23",
         version: ARTIFACT_VERSION2,
         networkId: "simnet",
         mode: "simulator",
@@ -1620,7 +1676,7 @@ registerTortureBucket({
           const idx = generatedIds.length;
           const payload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -1771,7 +1827,7 @@ registerTortureBucket({
             for (let i = 0; i < artifactsPerWorker; i++) {
               const payload = {
                 schema: "hardkas.txPlan",
-                hardkasVersion: "0.12.0-rc.21",
+                hardkasVersion: "0.12.0-rc.23",
                 version: ARTIFACT_VERSION2,
                 networkId: "simnet",
                 mode: "simulator",
@@ -2061,7 +2117,7 @@ registerTortureBucket({
       const backend = new SqliteQueryBackend(store);
       const payload = {
         schema: "hardkas.txPlan",
-        hardkasVersion: "0.12.0-rc.21",
+        hardkasVersion: "0.12.0-rc.23",
         version: ARTIFACT_VERSION2,
         networkId: "simnet",
         mode: "simulator",
@@ -2124,7 +2180,7 @@ registerTortureBucket({
         case 1: {
           const payload1 = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2207,7 +2263,7 @@ registerTortureBucket({
           }
           const safePayload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2255,7 +2311,7 @@ registerTortureBucket({
         case 3: {
           const payload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2320,7 +2376,7 @@ registerTortureBucket({
           }
           const payload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2384,7 +2440,7 @@ registerTortureBucket({
         case 5: {
           const payloadWithCRLF = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2435,7 +2491,7 @@ registerTortureBucket({
         case 6: {
           const payload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2519,7 +2575,7 @@ registerTortureBucket({
           const nfdString = "e\u0301";
           const payload1 = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2571,7 +2627,7 @@ registerTortureBucket({
           const emoji = ctx.prng.pick(emojiStrings);
           const payload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2638,7 +2694,7 @@ registerTortureBucket({
           const invisible = ctx.prng.pick(invisibleChars);
           const payload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2692,7 +2748,7 @@ registerTortureBucket({
           const cyrillicAddr = "kaspa:sim_address_with_\u0430";
           const payloadLatin = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2764,7 +2820,7 @@ registerTortureBucket({
           const mixedString = "caf\xE9 re\u0301sume\u0301";
           const payload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -2833,7 +2889,7 @@ registerTortureBucket({
       let writeArtifact2 = function(suffix, amount) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -2957,7 +3013,7 @@ registerTortureBucket({
           fs.utimesSync(filePath, oldTime, oldTime);
           const newPayload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -3032,7 +3088,7 @@ registerTortureBucket({
       for (let i = 0; i < artifactCount; i++) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -3131,7 +3187,7 @@ registerTortureBucket({
           for (let i = 0; i < extraCount; i++) {
             const payload = {
               schema: "hardkas.txPlan",
-              hardkasVersion: "0.12.0-rc.21",
+              hardkasVersion: "0.12.0-rc.23",
               version: ARTIFACT_VERSION2,
               networkId: "simnet",
               mode: "simulator",
@@ -3201,7 +3257,7 @@ registerTortureBucket({
       for (let i = 0; i < 5; i++) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -3311,7 +3367,7 @@ registerTortureBucket({
         case 5: {
           const phantomPayload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -3380,7 +3436,7 @@ registerTortureBucket({
       let writePlan2 = function(id, amount) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -3559,7 +3615,7 @@ registerTortureBucket({
     const outsideFile = path.join(outsideDir, "outside-artifact.json");
     const outsidePayload = {
       schema: "hardkas.txPlan",
-      hardkasVersion: "0.12.0-rc.21",
+      hardkasVersion: "0.12.0-rc.23",
       version: ARTIFACT_VERSION2,
       networkId: "simnet",
       mode: "simulator",
@@ -3598,7 +3654,7 @@ registerTortureBucket({
       let writePlan2 = function(id, amount) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -3707,7 +3763,7 @@ registerTortureBucket({
             }
             const payload = {
               schema: "hardkas.txPlan",
-              hardkasVersion: "0.12.0-rc.21",
+              hardkasVersion: "0.12.0-rc.23",
               version: ARTIFACT_VERSION2,
               networkId: "simnet",
               mode: "simulator",
@@ -3824,7 +3880,7 @@ registerTortureBucket({
       let writePlan2 = function(id, amount) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -3956,7 +4012,7 @@ registerTortureBucket({
       let writePlan2 = function(id, amount) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -4115,7 +4171,7 @@ registerTortureBucket({
       let writePlan2 = function(id, amount) {
         const payload = {
           schema: "hardkas.txPlan",
-          hardkasVersion: "0.12.0-rc.21",
+          hardkasVersion: "0.12.0-rc.23",
           version: ARTIFACT_VERSION2,
           networkId: "simnet",
           mode: "simulator",
@@ -4160,7 +4216,7 @@ registerTortureBucket({
           await new Promise((resolve) => setTimeout(resolve, 20));
           const payload = {
             schema: "hardkas.txPlan",
-            hardkasVersion: "0.12.0-rc.21",
+            hardkasVersion: "0.12.0-rc.23",
             version: ARTIFACT_VERSION2,
             networkId: "simnet",
             mode: "simulator",
@@ -4478,6 +4534,9 @@ registerTortureBucket({
 });
 export {
   AdversarialFixtures,
+  HARDKAS_FIXTURE_DERIVATION_DOMAIN,
+  HARDKAS_FIXTURE_NAMES,
+  HARDKAS_FIXTURE_REGISTRY,
   HardkasFixtureSigner,
   LcgPrng,
   SimulatedTxPlanSigner,
@@ -4489,6 +4548,7 @@ export {
   enableMassTracking,
   generateReproducibilityReport,
   getAllTortureBuckets,
+  getHardkasFixtureKey,
   getMassRecords,
   getTortureBucket,
   hardKasMatchers

package/dist/reproducibility.js

@@ -1,6 +1,6 @@
 import {
   generateReproducibilityReport
-} from "./chunk-67IMLFOT.js";
+} from "./chunk-Q4NLRRZC.js";
 import "./chunk-AHS4TIKV.js";
 import "./chunk-3RG5ZIWI.js";
 export {

package/dist/scenarios.js

@@ -94,7 +94,7 @@ var scenario = isVitest ? vitestTest.extend({
       const safeScenarioName2 = task.name.replace(/[^a-z0-9]/gi, "_").toLowerCase();
       const scenarioResult = {
         schema: HardkasSchemas.ScenarioResultV1 || "hardkas.scenarioResult.v1",
-        hardkasVersion: "0.12.0-rc.21",
+        hardkasVersion: "0.12.0-rc.23",
         version: "1.0.0-alpha",
         networkId: hardkas.network || "simnet",
         mode: "agent",

package/dist/setup.js

@@ -1,6 +1,6 @@
 import {
   hardKasMatchers
-} from "./chunk-J7YJZ3SC.js";
+} from "./chunk-LAUXD45S.js";
 import "./chunk-3RG5ZIWI.js";
 
 // src/setup.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/testing",
-  "version": "0.12.0-rc.21",
+  "version": "0.12.0-rc.23",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -37,16 +37,16 @@
     }
   },
   "dependencies": {
-    "@hardkas/accounts": "0.12.0-rc.21",
-    "@hardkas/artifacts": "0.12.0-rc.21",
-    "@hardkas/node-runner": "0.12.0-rc.21",
-    "@hardkas/kaspa-rpc": "0.12.0-rc.21",
-    "@hardkas/localnet": "0.12.0-rc.21",
-    "@hardkas/core": "0.12.0-rc.21",
-    "@hardkas/query-store": "0.12.0-rc.21",
-    "@hardkas/simulator": "0.12.0-rc.21",
-    "@hardkas/sdk": "0.12.0-rc.21",
-    "@hardkas/tx-builder": "0.12.0-rc.21"
+    "@hardkas/accounts": "0.12.0-rc.23",
+    "@hardkas/kaspa-rpc": "0.12.0-rc.23",
+    "@hardkas/artifacts": "0.12.0-rc.23",
+    "@hardkas/node-runner": "0.12.0-rc.23",
+    "@hardkas/localnet": "0.12.0-rc.23",
+    "@hardkas/query-store": "0.12.0-rc.23",
+    "@hardkas/core": "0.12.0-rc.23",
+    "@hardkas/sdk": "0.12.0-rc.23",
+    "@hardkas/simulator": "0.12.0-rc.23",
+    "@hardkas/tx-builder": "0.12.0-rc.23"
   },
   "devDependencies": {
     "execa": "^9.5.2",