@hardkas/sdk 0.7.11-alpha → 0.7.13-alpha

package/dist/index.d.ts

@@ -287,11 +287,15 @@ declare class HardkasArtifactsManager {
     /**
      * Reads an artifact by path or ID/hash from the workspace.
      */
-    read(id: string): Promise<any>;
+    read(id: string, options?: {
+        expectedSchema?: string;
+    }): Promise<any>;
     /**
      * Alias for read().
      */
-    get(id: string): Promise<any>;
+    get(id: string, options?: {
+        expectedSchema?: string;
+    }): Promise<any>;
     /**
      * Lists all artifacts in the workspace.
      */

package/dist/index.js

@@ -107,6 +107,37 @@ import {
 import { coreEvents } from "@hardkas/core";
 import { signTxPlanArtifact } from "@hardkas/accounts";
 import { parseKasToSompi } from "@hardkas/core";
+function normalizeSimulatedPlanInput(target, fallbackId) {
+  if (target.schema === ARTIFACT_SCHEMAS.TX_PLAN && Array.isArray(target.inputs)) {
+    return target;
+  }
+  if (target.from && target.to && target.amountSompi) {
+    if (target.mode !== "simulated") {
+      throw new Error("Cannot simulate real signed artifact without parent plan. Missing plan inputs data.");
+    }
+    return {
+      schema: ARTIFACT_SCHEMAS.TX_PLAN,
+      planId: target.planId || target.sourcePlanId || fallbackId,
+      networkId: target.networkId || "simnet",
+      mode: "simulated",
+      from: target.from,
+      to: target.to,
+      amountSompi: target.amountSompi,
+      estimatedFeeSompi: "0",
+      estimatedMass: "0",
+      inputs: [],
+      outputs: [{ address: target.to.address, amountSompi: target.amountSompi || "0" }],
+      plan: {
+        inputs: [],
+        outputs: [{ address: target.to.address, amountSompi: BigInt(target.amountSompi || 0) }],
+        feeSompi: 0n,
+        mass: 0n,
+        changeSompi: 0n
+      }
+    };
+  }
+  throw new Error("Cannot simulate signed artifact without parent plan or embedded plan data.");
+}
 var HardkasTx = class {
   constructor(sdk) {
     this.sdk = sdk;
@@ -428,7 +459,7 @@ var HardkasTx = class {
     let targetObj = target;
     if (typeof target === "string") {
       try {
-        targetObj = await this.sdk.artifacts.read(target);
+        targetObj = await this.sdk.artifacts.read(target, { expectedSchema: ARTIFACT_SCHEMAS.TX_PLAN });
       } catch (e) {
         throw new Error(`Artifact '${target}' not found. If you already have an in-memory artifact, pass the object directly to tx.simulate(artifact).`);
       }
@@ -438,30 +469,9 @@ var HardkasTx = class {
       sourcePlanId = targetObj.sourcePlanId || "unknown";
       txId = targetObj.txId || `simulated-${sourcePlanId}-tx`;
       try {
-        planArtifact = await this.sdk.artifacts.read(sourcePlanId);
+        planArtifact = await this.sdk.artifacts.read(sourcePlanId, { expectedSchema: ARTIFACT_SCHEMAS.TX_PLAN });
       } catch (e) {
-        if (targetObj.from && targetObj.to && targetObj.amountSompi) {
-          planArtifact = {
-            schema: "hardkas.txPlan",
-            planId: sourcePlanId,
-            from: targetObj.from,
-            to: targetObj.to,
-            amountSompi: targetObj.amountSompi,
-            estimatedFeeSompi: "0",
-            estimatedMass: "0",
-            inputs: [],
-            outputs: [{ address: targetObj.to.address, amountSompi: targetObj.amountSompi || "0" }],
-            plan: {
-              inputs: [],
-              outputs: [{ address: targetObj.to.address, amountSompi: BigInt(targetObj.amountSompi || 0) }],
-              feeSompi: 0n,
-              mass: 0n,
-              changeSompi: 0n
-            }
-          };
-        } else {
-          throw new Error(`Cannot simulate signed artifact: source plan '${sourcePlanId}' not found in workspace and artifact lacks details.`);
-        }
+        planArtifact = targetObj;
       }
     } else {
       planArtifact = targetObj;
@@ -472,9 +482,10 @@ var HardkasTx = class {
         sourcePlanId = planArtifact.planId || "unknown";
       }
     }
+    const normalizedPlan = normalizeSimulatedPlanInput(planArtifact, sourcePlanId);
     const simResult = applySimulatedPlan(
       state,
-      planArtifact,
+      normalizedPlan,
       systemRuntimeContext,
       { txId }
     );
@@ -596,7 +607,34 @@ var HardkasTx = class {
     if (isSimulated) {
       const persistOpt = typeof urlOrOptions === "object" ? urlOrOptions.persist : true;
       const simOpts = persistOpt !== void 0 ? { persist: persistOpt } : {};
-      const simResult = await this.simulate(signedArtifact, simOpts);
+      let simResult;
+      try {
+        simResult = await this.simulate(signedArtifact, simOpts);
+      } catch (e) {
+        if (e.message && e.message.includes("invalid simulated input")) {
+          try {
+            const { loadSimulatedReceipt, getReceiptPath } = await import("@hardkas/localnet");
+            const txIdToLoad = signedArtifact.txId || `simulated-${signedArtifact.sourcePlanId}-tx`;
+            const existingReceipt = await loadSimulatedReceipt(txIdToLoad, { cwd: this.sdk.workspace.root });
+            if (existingReceipt) {
+              if (existingReceipt.schema === ARTIFACT_SCHEMAS.TX_RECEIPT && (existingReceipt.status === "confirmed" || existingReceipt.status === "accepted")) {
+                return {
+                  mode: "simulated",
+                  simulated: true,
+                  submitted: false,
+                  txId: existingReceipt.txId,
+                  artifactId: existingReceipt.txId,
+                  // simulated receipts use txId as artifactId
+                  receipt: existingReceipt,
+                  receiptPath: getReceiptPath(existingReceipt.txId, this.sdk.workspace.root)
+                };
+              }
+            }
+          } catch (err) {
+          }
+        }
+        throw e;
+      }
       const result2 = {
         mode: "simulated",
         simulated: true,
@@ -1256,9 +1294,13 @@ var HardkasArtifactsManager = class {
   /**
    * Reads an artifact by path or ID/hash from the workspace.
    */
-  async read(id) {
+  async read(id, options) {
     if (this.cache.has(id)) {
-      return this.cache.get(id);
+      const cached = this.cache.get(id);
+      if (options?.expectedSchema && cached.schema !== options.expectedSchema) {
+        throw new Error(`Artifact ${id} has schema '${cached.schema}' but expected '${options.expectedSchema}'`);
+      }
+      return cached;
     }
     const { readArtifact } = await import("@hardkas/artifacts");
     let filePath = id;
@@ -1276,7 +1318,7 @@ var HardkasArtifactsManager = class {
       if (!fs3.existsSync(filePath)) {
         if (fs3.existsSync(this.workspace.artifactsDir)) {
           const files = fs3.readdirSync(this.workspace.artifactsDir);
-          const found = files.find((f) => f.includes(id) || f.endsWith(`${id}.json`));
+          const found = files.find((f) => f === `${id}.json` || f.startsWith(`${id}-`) || f.startsWith(`${id}.`));
           if (found) {
             filePath = path3.join(this.workspace.artifactsDir, found);
           } else {
@@ -1287,13 +1329,17 @@ var HardkasArtifactsManager = class {
         }
       }
     }
-    return readArtifact(filePath);
+    const artifact = await readArtifact(filePath);
+    if (options?.expectedSchema && artifact.schema !== options.expectedSchema) {
+      throw new Error(`Artifact ${id} has schema '${artifact.schema}' but expected '${options.expectedSchema}'`);
+    }
+    return artifact;
   }
   /**
    * Alias for read().
    */
-  async get(id) {
-    return this.read(id);
+  async get(id, options) {
+    return this.read(id, options);
   }
   /**
    * Lists all artifacts in the workspace.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/sdk",
-  "version": "0.7.11-alpha",
+  "version": "0.7.13-alpha",
   "type": "module",
   "files": [
     "dist",
@@ -23,18 +23,18 @@
     }
   },
   "dependencies": {
-    "@hardkas/accounts": "0.7.11-alpha",
-    "@hardkas/artifacts": "0.7.11-alpha",
-    "@hardkas/core": "0.7.11-alpha",
-    "@hardkas/config": "0.7.11-alpha",
-    "@hardkas/kaspa-rpc": "0.7.11-alpha",
-    "@hardkas/localnet": "0.7.11-alpha",
-    "@hardkas/l2": "0.7.11-alpha",
-    "@hardkas/simulator": "0.7.11-alpha",
-    "@hardkas/query": "0.7.11-alpha",
-    "@hardkas/tx-builder": "0.7.11-alpha",
-    "@hardkas/wallet-adapter": "0.7.11-alpha",
-    "@hardkas/query-store": "0.7.11-alpha"
+    "@hardkas/accounts": "0.7.13-alpha",
+    "@hardkas/core": "0.7.13-alpha",
+    "@hardkas/artifacts": "0.7.13-alpha",
+    "@hardkas/config": "0.7.13-alpha",
+    "@hardkas/l2": "0.7.13-alpha",
+    "@hardkas/kaspa-rpc": "0.7.13-alpha",
+    "@hardkas/query": "0.7.13-alpha",
+    "@hardkas/simulator": "0.7.13-alpha",
+    "@hardkas/tx-builder": "0.7.13-alpha",
+    "@hardkas/wallet-adapter": "0.7.13-alpha",
+    "@hardkas/localnet": "0.7.13-alpha",
+    "@hardkas/query-store": "0.7.13-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",