@hardkas/sdk 0.8.1-alpha → 0.8.3-alpha

package/dist/index.d.ts

@@ -63,9 +63,12 @@ declare class HardkasTx {
     plan(options: {
         from: string | HardkasAccount;
         to: string | HardkasAccount;
-        amount: string | bigint;
+        amount: string | number | bigint;
         feeRate?: bigint;
         workflowId?: string;
+        policy?: string;
+        networkProfile?: string;
+        assumption?: string;
     }): Promise<TxPlanArtifact>;
     /**
      * Signs a transaction plan.
@@ -304,11 +307,7 @@ declare class HardkasArtifactsManager {
      * Cryptographically verifies the determinism and integrity of an artifact.
      * Throws an error with details if corruption or mismatch is found.
      */
-    verify(target: string | {
-        schema?: string;
-        artifactId?: string;
-        contentHash?: string;
-    }, options?: {
+    verify(target: any, options?: {
         throwOnInvalid?: boolean;
     }): Promise<any>;
 }

package/dist/index.js

@@ -153,7 +153,7 @@ var HardkasTx = class {
       throw new Error(`From account ${fromAccount.name} has no address.`);
     if (!toAccount.address)
       throw new Error(`To account ${toAccount.name} has no address.`);
-    const amountSompi = typeof options.amount === "string" ? parseKasToSompi(options.amount) : typeof options.amount === "number" ? BigInt(options.amount) : options.amount;
+    const amountSompi = typeof options.amount === "string" ? parseKasToSompi(options.amount) : typeof options.amount === "number" ? parseKasToSompi(options.amount.toString()) : options.amount;
     if (amountSompi === 0n) {
       throw new Error("Kaspa value-transfer outputs require amount > 0.\nFor metadata/notary/DID marker transactions use --amount 1.\nFuture: hardkas tx anchor.");
     }
@@ -200,7 +200,7 @@ var HardkasTx = class {
       feeRateSompiPerMass: options.feeRate ?? 1n
     });
     const isSimulated = activeNetwork === "simulated" || this.sdk.config.config.networks?.[activeNetwork]?.kind === "simulated";
-    return createTxPlanArtifact({
+    const basePlan = createTxPlanArtifact({
       networkId: activeNetwork,
       mode: isSimulated ? "simulated" : "real",
       from: {
@@ -216,11 +216,52 @@ var HardkasTx = class {
       plan: builderPlan,
       ctx: options.workflowId ? { ...systemRuntimeContext, workflowId: options.workflowId } : systemRuntimeContext
     });
+    if (options.policy) {
+      try {
+        const pol = await this.sdk.artifacts.read(options.policy);
+        basePlan.policyRef = pol.contentHash || pol.artifactId || options.policy;
+      } catch (e) {
+        basePlan.policyRef = options.policy;
+      }
+    }
+    if (options.networkProfile) {
+      try {
+        const net = await this.sdk.artifacts.read(options.networkProfile);
+        basePlan.networkProfileRef = net.contentHash || net.artifactId || options.networkProfile;
+      } catch (e) {
+        basePlan.networkProfileRef = options.networkProfile;
+      }
+    }
+    if (options.assumption) {
+      try {
+        const asm = await this.sdk.artifacts.read(options.assumption);
+        basePlan.assumptionRef = asm.contentHash || asm.artifactId || options.assumption;
+      } catch (e) {
+        basePlan.assumptionRef = options.assumption;
+      }
+    }
+    const { CURRENT_HASH_VERSION: CURRENT_HASH_VERSION2, calculateContentHash: calculateContentHash2 } = await import("@hardkas/artifacts");
+    const newHash = calculateContentHash2(basePlan, CURRENT_HASH_VERSION2);
+    basePlan.contentHash = newHash;
+    if (basePlan.lineage) {
+      basePlan.lineage.artifactId = newHash;
+      basePlan.lineage.parentArtifactId = newHash;
+      basePlan.lineage.rootArtifactId = newHash;
+      const finalHash = calculateContentHash2(basePlan, CURRENT_HASH_VERSION2);
+      basePlan.contentHash = finalHash;
+      basePlan.lineage.artifactId = finalHash;
+      basePlan.lineage.parentArtifactId = finalHash;
+      basePlan.lineage.rootArtifactId = finalHash;
+    }
+    return basePlan;
   }
   /**
    * Signs a transaction plan.
    */
   async sign(plan, account, options) {
+    if (typeof plan === "object" && plan !== null && plan.contentHash) {
+      await this.sdk.artifacts.verify(plan, { throwOnInvalid: true });
+    }
     let resolvedAccount;
     if (typeof account === "string") {
       resolvedAccount = await this.sdk.accounts.resolve(account);
@@ -298,7 +339,7 @@ var HardkasTx = class {
         lineage: {
           artifactId: "",
           // To be computed from contentHash
-          lineageId: partialTx.lineage?.lineageId || `lineage-${Math.random().toString(36).slice(2, 10)}`,
+          lineageId: partialTx.lineage?.lineageId || partialTx.contentHash || "0".repeat(64),
           parentArtifactId: partialTx.contentHash || partialTx.signedId,
           rootArtifactId: partialTx.lineage?.rootArtifactId || partialTx.sourcePlanId
         }
@@ -382,7 +423,7 @@ var HardkasTx = class {
           lineage: {
             artifactId: "",
             // To be computed
-            lineageId: plan.lineage?.lineageId || `lineage-${Math.random().toString(36).slice(2, 10)}`,
+            lineageId: plan.lineage?.lineageId || plan.contentHash || "0".repeat(64),
             parentArtifactId: plan.contentHash || plan.planId,
             rootArtifactId: plan.contentHash || plan.planId
           },
@@ -401,6 +442,9 @@ var HardkasTx = class {
         if (draft.lineage) draft.lineage.artifactId = draft.signedId;
         signedArtifact = draft;
       } else {
+        if (resolvedAccount.address !== plan.from.address) {
+          throw new Error(`Signer account '${resolvedAccount.address}' is not authorized to sign for '${plan.from.address}'.`);
+        }
         signedArtifact = await signTxPlanArtifact({
           planArtifact: plan,
           account: resolvedAccount,
@@ -437,6 +481,9 @@ var HardkasTx = class {
    * Modifies the local deterministic state and outputs receipt/trace artifacts.
    */
   async simulate(target, options = {}) {
+    if (typeof target === "object" && target !== null && target.contentHash) {
+      await this.sdk.artifacts.verify(target, { throwOnInvalid: true });
+    }
     const persist = options.persist ?? true;
     const {
       loadOrCreateLocalnetState,
@@ -537,9 +584,22 @@ var HardkasTx = class {
       submittedAt: simResult.receipt.createdAt,
       confirmedAt: simResult.receipt.createdAt,
       rpcUrl: "simulated://local",
-      tracePath
+      tracePath,
+      lineage: {
+        artifactId: "",
+        // To be computed
+        lineageId: targetObj.lineage?.lineageId || targetObj.contentHash || "0".repeat(64),
+        parentArtifactId: targetObj.contentHash || "0".repeat(64),
+        rootArtifactId: targetObj.lineage?.rootArtifactId || "0".repeat(64),
+        sequence: (targetObj.lineage?.sequence || 1) + 1
+      }
     };
     receiptBase.contentHash = calculateContentHash(receiptBase, CURRENT_HASH_VERSION);
+    if (receiptBase.lineage) {
+      receiptBase.lineage.artifactId = receiptBase.contentHash;
+      receiptBase.contentHash = calculateContentHash(receiptBase, CURRENT_HASH_VERSION);
+      receiptBase.lineage.artifactId = receiptBase.contentHash;
+    }
     const receipt = Object.freeze(receiptBase);
     const traceSteps = events.map((ev) => ({
       phase: ev.phase || ev.message || "unknown",
@@ -596,6 +656,9 @@ var HardkasTx = class {
    * Sends a signed transaction to the real RPC network.
    */
   async send(signedArtifact, urlOrOptions) {
+    if (typeof signedArtifact === "object" && signedArtifact !== null && signedArtifact.contentHash) {
+      await this.sdk.artifacts.verify(signedArtifact, { throwOnInvalid: true });
+    }
     const verification = verifySignedTxSemantics(signedArtifact);
     if (!verification.ok) {
       throw new Error(
@@ -675,12 +738,26 @@ var HardkasTx = class {
       feeSompi: signedArtifact.metadata?.estimatedFeeSompi || "0",
       submittedAt: (/* @__PURE__ */ new Date()).toISOString(),
       ...url ? { rpcUrl: url } : {},
-      ...signedArtifact.workflowId ? { workflowId: signedArtifact.workflowId } : {}
+      ...signedArtifact.workflowId ? { workflowId: signedArtifact.workflowId } : {},
+      tracePath: void 0,
+      lineage: {
+        artifactId: "",
+        // To be computed
+        lineageId: signedArtifact.lineage?.lineageId || signedArtifact.contentHash || "0".repeat(64),
+        parentArtifactId: signedArtifact.contentHash || "0".repeat(64),
+        rootArtifactId: signedArtifact.lineage?.rootArtifactId || "0".repeat(64),
+        sequence: (signedArtifact.lineage?.sequence || 1) + 1
+      }
     };
     realReceiptBase.contentHash = calculateContentHash(
       realReceiptBase,
       CURRENT_HASH_VERSION
     );
+    if (realReceiptBase.lineage) {
+      realReceiptBase.lineage.artifactId = realReceiptBase.contentHash;
+      realReceiptBase.contentHash = calculateContentHash(realReceiptBase, CURRENT_HASH_VERSION);
+      realReceiptBase.lineage.artifactId = realReceiptBase.contentHash;
+    }
     const receipt = realReceiptBase;
     const receiptPath = getDefaultReceiptPath(receipt.txId, this.sdk.config.cwd);
     await writeArtifact(receiptPath, receipt);
@@ -985,6 +1062,21 @@ var HardkasReplay = class {
    * against the mathematically reconstructed localnet state.
    */
   async verify(targetOrOptions, options) {
+    const throwOnInvalid = options?.throwOnInvalid !== false;
+    if (typeof targetOrOptions === "object" && targetOrOptions !== null && targetOrOptions.contentHash) {
+      const verifyRes = await this.sdk.artifacts.verify(targetOrOptions, { throwOnInvalid });
+      if (!verifyRes.valid && !throwOnInvalid) {
+        return {
+          passed: false,
+          artifactsScanned: 1,
+          lineage: "invalid",
+          determinism: "failed",
+          contamination: "clean",
+          report: null,
+          error: `Artifact verification failed: ${verifyRes.reason}`
+        };
+      }
+    }
     let opts = options || {};
     if (typeof targetOrOptions === "string") {
       opts.path = targetOrOptions;
@@ -1368,29 +1460,38 @@ var HardkasArtifactsManager = class {
    */
   async verify(target, options = {}) {
     const throwOnInvalid = options.throwOnInvalid ?? true;
-    const id = typeof target === "string" ? target : target.artifactId || target.contentHash || "";
-    if (!id) {
-      if (throwOnInvalid) throw new Error("No artifact target provided for verification.");
-      return { valid: false, reason: "unknown", message: "No artifact target provided for verification." };
-    }
     let artifact;
-    try {
-      artifact = await this.read(id);
-    } catch (e) {
-      if (throwOnInvalid) throw e;
-      return { valid: false, reason: "missing_artifact", message: e.message, artifactId: id };
+    let id;
+    if (typeof target === "string") {
+      id = target;
+      if (!id) {
+        if (throwOnInvalid) throw new Error("No artifact target provided for verification.");
+        return { valid: false, reason: "unknown", message: "No artifact target provided for verification." };
+      }
+      try {
+        artifact = await this.read(id);
+      } catch (e) {
+        if (throwOnInvalid) throw e;
+        return { valid: false, reason: "missing_artifact", message: e.message, artifactId: id };
+      }
+    } else {
+      artifact = target;
+      id = artifact.artifactId || artifact.contentHash || "";
     }
     const { verifyArtifactIntegrity: verifyArtifactIntegrity2 } = await import("@hardkas/artifacts");
     const result = await verifyArtifactIntegrity2(artifact);
     if (!result.ok) {
+      const mappedReason = result.issues[0]?.code === "HASH_MISMATCH" ? "content_hash_mismatch" : result.issues[0]?.code === "MISSING_CONTENT_HASH" ? "missing_content_hash" : result.issues[0]?.code === "MISSING_SIGNATURE" ? "missing_signature" : "schema_invalid";
       if (throwOnInvalid) {
         throw new Error(`Artifact ${id} corrupted or invalid: ` + JSON.stringify(result.issues, null, 2));
       }
       return {
         valid: false,
-        reason: result.issues[0]?.code === "HASH_MISMATCH" ? "hash_mismatch" : result.issues[0]?.code === "MISSING_SIGNATURE" ? "missing_signature" : "schema_invalid",
+        reason: mappedReason,
         message: result.issues.map((i) => i.message).join(", "),
         artifactId: id,
+        expected: result.expectedHash,
+        actual: result.actualHash,
         details: result.issues
       };
     }
@@ -1733,8 +1834,8 @@ var Hardkas = class _Hardkas {
   resolveRpcUrl() {
     const networkId = this.config.config.defaultNetwork || "simnet";
     const target = this.config.config.networks?.[networkId];
-    if (target && (target.kind === "kaspa-rpc" || target.kind === "igra" || target.kind === "kaspa-node")) {
-      return target.rpcUrl || "ws://127.0.0.1:18210";
+    if (target && "rpcUrl" in target && typeof target.rpcUrl === "string") {
+      return target.rpcUrl;
     }
     return "ws://127.0.0.1:18210";
   }

package/package.json

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