@hardkas/localnet 0.7.3-alpha → 0.7.5-alpha

package/dist/{chunk-M5T6T465.js → chunk-2YOFWE4E.js}

@@ -2,6 +2,9 @@
 import fs from "fs/promises";
 import path from "path";
 import { existsSync } from "fs";
+import {
+  ARTIFACT_SCHEMAS
+} from "@hardkas/artifacts";
 import { writeFileAtomic } from "@hardkas/core";
 import { deterministicCompare } from "@hardkas/core";
 function getDefaultReceiptsDir(cwd = process.cwd()) {
@@ -22,7 +25,9 @@ async function saveSimulatedReceipt(receipt, options) {
     await fs.mkdir(dir, { recursive: true });
   }
   const filePath = getReceiptPath(receipt.txId, options?.cwd);
-  await writeFileAtomic(filePath, JSON.stringify(receipt, null, 2), { encoding: "utf-8" });
+  await writeFileAtomic(filePath, JSON.stringify(receipt, null, 2), {
+    encoding: "utf-8"
+  });
   return filePath;
 }
 async function loadSimulatedReceipt(txId, options) {
@@ -45,7 +50,9 @@ async function listSimulatedReceipts(options) {
       try {
         const txId = path.basename(file, ".json");
         const receipt = await loadSimulatedReceipt(txId, options);
-        receipts.push(receipt);
+        if (receipt.schema === ARTIFACT_SCHEMAS.TX_RECEIPT) {
+          receipts.push(receipt);
+        }
       } catch (e) {
       }
     }

package/dist/index.d.ts

@@ -372,7 +372,7 @@ declare function moveSink(dag: SimulatedDag, newSinkId: string, txProvider: (txI
     inputs: string[];
 } | undefined): SimulatedDag;
 /**
- * Deterministic Conflict Resolution (Approximation for 0.7.3-alpha)
+ * Deterministic Conflict Resolution (Approximation for 0.7.5-alpha)
  * Priority:
  * 1. sink ancestry priority (is part of selectedPathToSink?)
  * 2. deterministic block order (daaScore then block ID)

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   listSimulatedReceipts,
   loadSimulatedReceipt,
   saveSimulatedReceipt
-} from "./chunk-M5T6T465.js";
+} from "./chunk-2YOFWE4E.js";
 import {
   getDefaultTracesDir,
   getTracePath,
@@ -101,7 +101,7 @@ var SimulatedKaspaChain = class {
   }
   /**
    * Creates a snapshot of the current chain state.
-   * Snapshot IDs use Date.now() and are intended for session-based 
+   * Snapshot IDs use Date.now() and are intended for session-based
    * debugging and restore points, not for canonical identity.
    */
   snapshot() {
@@ -135,7 +135,10 @@ async function startSimulatedDevnet(input) {
 
 // src/state.ts
 import { SOMPI_PER_KAS } from "@hardkas/core";
-import { HARDKAS_VERSION, ARTIFACT_SCHEMAS } from "@hardkas/artifacts";
+import {
+  HARDKAS_VERSION,
+  ARTIFACT_SCHEMAS
+} from "@hardkas/artifacts";
 function createInitialLocalnetState(options = {}) {
   const accountCount = options.accounts ?? 5;
   const initialBalanceSompi = options.initialBalanceSompi ?? 1000n * SOMPI_PER_KAS;
@@ -206,7 +209,9 @@ async function saveLocalnetState(state, filePath) {
   const targetPath = filePath ?? getDefaultLocalnetStatePath();
   const dir = path.dirname(targetPath);
   await fs.mkdir(dir, { recursive: true });
-  await writeFileAtomic(targetPath, JSON.stringify(state, null, 2), { encoding: "utf-8" });
+  await writeFileAtomic(targetPath, JSON.stringify(state, null, 2), {
+    encoding: "utf-8"
+  });
 }
 async function loadLocalnetState(filePath) {
   const targetPath = filePath ?? getDefaultLocalnetStatePath();
@@ -284,7 +289,9 @@ function calculateUtxoSetHash(utxos) {
   return calculateContentHash(sorted);
 }
 function calculateAccountsHash(accounts) {
-  const sorted = [...accounts || []].sort((a, b) => deterministicCompare(a.address, b.address));
+  const sorted = [...accounts || []].sort(
+    (a, b) => deterministicCompare(a.address, b.address)
+  );
   return calculateContentHash(sorted);
 }
 function calculateStateHash(state) {
@@ -329,20 +336,32 @@ function verifySnapshot(snapshot) {
   const errors = [];
   const currentContentHash = calculateContentHash(snapshot);
   const contentMatch = snapshot.contentHash === currentContentHash;
-  if (!contentMatch) errors.push(`Content hash mismatch: expected ${snapshot.contentHash}, got ${currentContentHash}`);
+  if (!contentMatch)
+    errors.push(
+      `Content hash mismatch: expected ${snapshot.contentHash}, got ${currentContentHash}`
+    );
   const currentAccountsHash = calculateAccountsHash(snapshot.accounts);
   const accountsMatch = snapshot.accountsHash === currentAccountsHash;
-  if (!accountsMatch) errors.push(`Accounts hash mismatch: expected ${snapshot.accountsHash}, got ${currentAccountsHash}`);
+  if (!accountsMatch)
+    errors.push(
+      `Accounts hash mismatch: expected ${snapshot.accountsHash}, got ${currentAccountsHash}`
+    );
   const currentUtxoSetHash = calculateUtxoSetHash(snapshot.utxos);
   const utxoSetMatch = snapshot.utxoSetHash === currentUtxoSetHash;
-  if (!utxoSetMatch) errors.push(`UTXO set hash mismatch: expected ${snapshot.utxoSetHash}, got ${currentUtxoSetHash}`);
+  if (!utxoSetMatch)
+    errors.push(
+      `UTXO set hash mismatch: expected ${snapshot.utxoSetHash}, got ${currentUtxoSetHash}`
+    );
   const currentStateHash = calculateContentHash({
     daaScore: snapshot.daaScore,
     accountsHash: currentAccountsHash,
     utxoSetHash: currentUtxoSetHash
   });
   const stateMatch = snapshot.stateHash === currentStateHash;
-  if (!stateMatch) errors.push(`State hash mismatch: expected ${snapshot.stateHash}, got ${currentStateHash}`);
+  if (!stateMatch)
+    errors.push(
+      `State hash mismatch: expected ${snapshot.stateHash}, got ${currentStateHash}`
+    );
   return {
     ok: errors.length === 0,
     hashes: {
@@ -430,7 +449,7 @@ function applySimulatedPayment(state, input, ctx) {
     }
     const unspent = getSpendableUtxos(state, fromAddress);
     if (unspent.length === 0) {
-      throw new Error(`Insufficient funds: no unspent UTXOs for ${fromAddress}`);
+      throw new Error("insufficient simulated funds");
     }
     const availableUtxos = unspent.map((u) => {
       const parts = u.id.split(":");
@@ -449,15 +468,17 @@ function applySimulatedPayment(state, input, ctx) {
       availableUtxos,
       feeRateSompiPerMass
     });
-    const spentUtxoIds = plan.inputs.map((i) => `${i.outpoint.transactionId}:${i.outpoint.index}`);
+    const spentUtxoIds = plan.inputs.map(
+      (i) => `${i.outpoint.transactionId}:${i.outpoint.index}`
+    );
     const uniqueSpentIds = new Set(spentUtxoIds);
     if (uniqueSpentIds.size !== spentUtxoIds.length) {
       throw new Error("Duplicate inputs detected in transaction plan");
     }
     for (const id of spentUtxoIds) {
       const utxo = state.utxos.find((u) => u.id === id);
-      if (!utxo) throw new Error(`UTXO not found: ${id}`);
-      if (utxo.spent) throw new Error(`UTXO already spent: ${id}`);
+      if (!utxo) throw new Error("missing simulated UTXO");
+      if (utxo.spent) throw new Error("invalid simulated input");
     }
     const planArtifact = createTxPlanArtifact({
       networkId: state.networkId || "simnet",
@@ -558,11 +579,13 @@ function applySimulatedPlan(state, planArtifact, ctx, options) {
   const errors = [];
   const preStateHash = calculateStateHash(state);
   try {
-    const spentUtxoIds = planArtifact.inputs.map((i) => `${i.outpoint.transactionId}:${i.outpoint.index}`);
+    const spentUtxoIds = planArtifact.inputs.map(
+      (i) => `${i.outpoint.transactionId}:${i.outpoint.index}`
+    );
     for (const id of spentUtxoIds) {
       const utxo = state.utxos.find((u) => u.id === id);
-      if (!utxo) throw new Error(`UTXO not found: ${id}`);
-      if (utxo.spent) throw new Error(`UTXO already spent: ${id}`);
+      if (!utxo) throw new Error("missing simulated UTXO");
+      if (utxo.spent) throw new Error("invalid simulated input");
     }
     const nextDaaScore = (BigInt(state.daaScore) + 1n).toString();
     const txId = options?.txId || generateDeterministicTxId(planArtifact, preStateHash, nextDaaScore);
@@ -595,7 +618,11 @@ function applySimulatedPlan(state, planArtifact, ctx, options) {
       nextUtxos.push(changeUtxo);
       createdUtxoIds.push(changeUtxo.id);
     }
-    const nextState = { ...state, daaScore: nextDaaScore, utxos: nextUtxos };
+    const nextState = {
+      ...state,
+      daaScore: nextDaaScore,
+      utxos: nextUtxos
+    };
     const postStateHash = calculateStateHash(nextState);
     const receipt = createSimulatedTxReceipt(planArtifact, txId, ctx, {
       spentUtxoIds,
@@ -648,7 +675,11 @@ function verifyReplay(state, originalPlan, originalReceipt, ctx) {
     planOk = false;
     const errorMsg = `TxPlan contentHash mismatch: expected ${originalPlan.contentHash}, got ${currentPlanHash}`;
     errors.push(errorMsg);
-    reportDivergences.push({ path: "plan.contentHash", expected: originalPlan.contentHash, actual: currentPlanHash });
+    reportDivergences.push({
+      path: "plan.contentHash",
+      expected: originalPlan.contentHash,
+      actual: currentPlanHash
+    });
   }
   const originalPreState = originalReceipt.preStateHash;
   if (originalPreState) {
@@ -670,7 +701,9 @@ function verifyReplay(state, originalPlan, originalReceipt, ctx) {
       severity: "warning"
     });
   }
-  const result = applySimulatedPlan(state, originalPlan, ctx, { txId: originalReceipt.txId });
+  const result = applySimulatedPlan(state, originalPlan, ctx, {
+    txId: originalReceipt.txId
+  });
   const replayReceipt = result.receipt;
   const diff = diffArtifacts(originalReceipt, replayReceipt);
   if (!diff.identical) {
@@ -680,7 +713,9 @@ function verifyReplay(state, originalPlan, originalReceipt, ctx) {
         expected: entry.left,
         actual: entry.right
       });
-      errors.push(`Receipt divergence at ${entry.path}: expected ${JSON.stringify(entry.left)}, got ${JSON.stringify(entry.right)}`);
+      errors.push(
+        `Receipt divergence at ${entry.path}: expected ${JSON.stringify(entry.left)}, got ${JSON.stringify(entry.right)}`
+      );
     }
   }
   for (const div of reportDivergences) {
@@ -717,7 +752,7 @@ function verifyReplay(state, originalPlan, originalReceipt, ctx) {
   };
 }
 async function getSimulatedReplaySummary(txId, options = {}) {
-  const { loadSimulatedReceipt: loadSimulatedReceipt2 } = await import("./receipts-7RMJMXXG.js");
+  const { loadSimulatedReceipt: loadSimulatedReceipt2 } = await import("./receipts-IEHNHM4Q.js");
   const { loadSimulatedTrace: loadSimulatedTrace2 } = await import("./traces-ZUBWSXYB.js");
   const receipt = await loadSimulatedReceipt2(txId, options);
   const trace = await loadSimulatedTrace2(txId, options);
@@ -1072,7 +1107,9 @@ async function forkFromNetwork(rpc, opts) {
   const networkId = info.networkId || opts.network;
   const targetDaaScore = opts.atDaaScore;
   if (!targetDaaScore) {
-    throw new Error(`[CRITICAL SEMANTIC ERROR] Implicit 'latest' resolution forbidden. You must explicitly provide atDaaScore.`);
+    throw new Error(
+      `[CRITICAL SEMANTIC ERROR] Implicit 'latest' resolution forbidden. You must explicitly provide atDaaScore.`
+    );
   }
   const utxos = [];
   for (const address of opts.addresses) {

package/dist/{receipts-7RMJMXXG.js → receipts-IEHNHM4Q.js}

@@ -4,7 +4,7 @@ import {
   listSimulatedReceipts,
   loadSimulatedReceipt,
   saveSimulatedReceipt
-} from "./chunk-M5T6T465.js";
+} from "./chunk-2YOFWE4E.js";
 export {
   getDefaultReceiptsDir,
   getReceiptPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/localnet",
-  "version": "0.7.3-alpha",
+  "version": "0.7.5-alpha",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -8,12 +8,12 @@
     ".": "./dist/index.js"
   },
   "dependencies": {
-    "@hardkas/artifacts": "0.7.3-alpha",
-    "@hardkas/query": "0.7.3-alpha",
-    "@hardkas/core": "0.7.3-alpha",
-    "@hardkas/simulator": "0.7.3-alpha",
-    "@hardkas/tx-builder": "0.7.3-alpha",
-    "@hardkas/kaspa-rpc": "0.7.3-alpha"
+    "@hardkas/artifacts": "0.7.5-alpha",
+    "@hardkas/core": "0.7.5-alpha",
+    "@hardkas/simulator": "0.7.5-alpha",
+    "@hardkas/kaspa-rpc": "0.7.5-alpha",
+    "@hardkas/query": "0.7.5-alpha",
+    "@hardkas/tx-builder": "0.7.5-alpha"
   },
   "devDependencies": {
     "fast-check": "^4.8.0",