@hardkas/sdk 0.8.0-alpha → 0.8.2-alpha

package/dist/index.d.ts

@@ -63,7 +63,7 @@ declare class HardkasTx {
     plan(options: {
         from: string | HardkasAccount;
         to: string | HardkasAccount;
-        amount: string | bigint;
+        amount: string | number | bigint;
         feeRate?: bigint;
         workflowId?: string;
     }): Promise<TxPlanArtifact>;
@@ -304,11 +304,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.");
     }
@@ -221,6 +221,9 @@ var HardkasTx = class {
    * 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);
@@ -401,6 +404,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 +443,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,
@@ -596,6 +605,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(
@@ -985,6 +997,9 @@ var HardkasReplay = class {
    * against the mathematically reconstructed localnet state.
    */
   async verify(targetOrOptions, options) {
+    if (typeof targetOrOptions === "object" && targetOrOptions !== null && targetOrOptions.contentHash) {
+      await this.sdk.artifacts.verify(targetOrOptions, { throwOnInvalid: true });
+    }
     let opts = options || {};
     if (typeof targetOrOptions === "string") {
       opts.path = targetOrOptions;
@@ -1368,29 +1383,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
       };
     }

package/package.json

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