@hardkas/sdk 0.8.5-alpha → 0.8.9-alpha

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import * as _hardkas_config from '@hardkas/config';
 import { LoadedHardkasConfig } from '@hardkas/config';
 export { defineHardkasConfig } from '@hardkas/config';
+import { TxPlanArtifact, SignedTxArtifact, TxReceiptArtifact, HardkasArtifactBase, WorkflowArtifact, ExternalHardkasSigner } from '@hardkas/artifacts';
+export { ARTIFACT_SCHEMAS, HARDKAS_VERSION, SignedTxArtifact, TxPlanArtifact, TxReceiptArtifact, TxTraceArtifact, createTxPlanArtifact, writeArtifact } from '@hardkas/artifacts';
 import { KaspaRpcClient } from '@hardkas/kaspa-rpc';
 import { EventEnvelope, NetworkId } from '@hardkas/core';
 export { ArtifactId, HardkasError, KaspaAddress, LineageId, NetworkId, SOMPI_PER_KAS, TxId, formatSompi, parseKasToSompi } from '@hardkas/core';
-import { TxPlanArtifact, SignedTxArtifact, TxReceiptArtifact, HardkasArtifactBase, WorkflowArtifact } from '@hardkas/artifacts';
-export { ARTIFACT_SCHEMAS, HARDKAS_VERSION, SignedTxArtifact, TxPlanArtifact, TxReceiptArtifact, TxTraceArtifact, createTxPlanArtifact, writeArtifact } from '@hardkas/artifacts';
 import { HardkasAccount } from '@hardkas/accounts';
 export { signTxPlanArtifact } from '@hardkas/accounts';
 import { L2NetworkProfile } from '@hardkas/l2';
@@ -320,6 +320,13 @@ declare class HardkasArtifactsManager {
         strict?: boolean;
         enforceMetadata?: boolean;
     }): Promise<any>;
+    /**
+     * Migrates a legacy artifact to v4 using a migration receipt.
+     */
+    migrate(target: any, migrationId: string): Promise<{
+        migrated: any;
+        receipt: any;
+    }>;
 }
 
 interface WorkflowRunOptions {
@@ -361,6 +368,7 @@ interface HardkasOptions {
     mode?: "developer" | "agent";
     network?: string;
     autoBootstrap?: boolean;
+    signer?: ExternalHardkasSigner;
     logger?: {
         info: (msg: string) => void;
         warn: (msg: string) => void;
@@ -393,6 +401,7 @@ declare class Hardkas {
     readonly replay: HardkasReplay;
     readonly lineage: HardkasLineage;
     readonly workflow: HardkasWorkflow;
+    readonly signer?: ExternalHardkasSigner | undefined;
     readonly mode: "developer" | "agent";
     readonly policy: Required<NonNullable<HardkasOptions["policy"]>>;
     readonly rpc: KaspaRpcClient;

package/dist/index.js

@@ -94,15 +94,16 @@ import {
   verifySignedTxSemantics
 } from "@hardkas/tx-builder";
 import {
-  HARDKAS_VERSION,
   ARTIFACT_SCHEMAS,
-  ARTIFACT_VERSION,
   CURRENT_HASH_VERSION,
-  getBroadcastableSignedTransaction,
-  writeArtifact,
+  calculateContentHash,
   getDefaultReceiptPath,
+  writeArtifact,
+  createLineageTransition,
   createTxPlanArtifact,
-  calculateContentHash
+  HARDKAS_VERSION,
+  ARTIFACT_VERSION,
+  getBroadcastableSignedTransaction
 } from "@hardkas/artifacts";
 import { coreEvents } from "@hardkas/core";
 import { signTxPlanArtifact } from "@hardkas/accounts";
@@ -252,14 +253,12 @@ var HardkasTx = class {
     const newHash = calculateContentHash2(basePlan, CURRENT_HASH_VERSION2);
     basePlan.contentHash = newHash;
     if (basePlan.lineage) {
-      basePlan.lineage.artifactId = newHash;
+      basePlan.lineage.lineageId = 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;
     }
     this.sdk.artifacts.cacheArtifact(basePlan);
     if (basePlan.policyRefs && basePlan.policyRefs.length > 0) {
@@ -274,6 +273,29 @@ var HardkasTx = class {
     if (typeof plan === "object" && plan !== null && plan.contentHash) {
       await this.sdk.artifacts.verify(plan, { throwOnInvalid: true, strict: true, enforceMetadata: false });
     }
+    if (this.sdk.signer && plan.schema === "hardkas.txPlan") {
+      const signedArtifact2 = await this.sdk.signer.signTransaction(plan);
+      const { absolutePath: absolutePath2 } = await this.sdk.artifacts.write(signedArtifact2);
+      const { coreEvents: coreEvents3 } = await import("@hardkas/core");
+      const signedRecord2 = signedArtifact2;
+      const artifactId2 = signedRecord2.artifactId || signedArtifact2.signedId || signedRecord2.contentHash;
+      coreEvents3.normalizeAndEmit({
+        kind: "artifact.created",
+        schema: signedArtifact2.schema,
+        artifactId: artifactId2,
+        network: signedArtifact2.networkId,
+        mode: signedArtifact2.mode,
+        path: absolutePath2
+      });
+      coreEvents3.normalizeAndEmit({
+        kind: "tx.signed",
+        txId: signedArtifact2.txId || artifactId2,
+        network: signedArtifact2.networkId,
+        mode: signedArtifact2.mode,
+        amountSompi: signedArtifact2.amountSompi
+      });
+      return signedArtifact2;
+    }
     let resolvedAccount;
     if (typeof account === "string") {
       resolvedAccount = await this.sdk.accounts.resolve(account);
@@ -348,13 +370,7 @@ var HardkasTx = class {
           signatures: newSignatures
         },
         signatureMetadata: newMeta,
-        lineage: {
-          artifactId: "",
-          // To be computed from contentHash
-          lineageId: partialTx.lineage?.lineageId || partialTx.contentHash || "0".repeat(64),
-          parentArtifactId: partialTx.contentHash || partialTx.signedId,
-          rootArtifactId: partialTx.lineage?.rootArtifactId || partialTx.sourcePlanId
-        }
+        lineage: createLineageTransition(partialTx, "hardkas.signedTx")
       };
       if (thresholdReached) {
         draft.signedTransaction = {
@@ -432,13 +448,7 @@ var HardkasTx = class {
             signatures
           },
           signatureMetadata,
-          lineage: {
-            artifactId: "",
-            // To be computed
-            lineageId: plan.lineage?.lineageId || plan.contentHash || "0".repeat(64),
-            parentArtifactId: plan.contentHash || plan.planId,
-            rootArtifactId: plan.contentHash || plan.planId
-          },
+          lineage: createLineageTransition(plan, "hardkas.signedTx"),
           ...plan.workflowId ? { workflowId: plan.workflowId } : {}
         };
         if (thresholdReached) {
@@ -448,10 +458,15 @@ var HardkasTx = class {
           };
           draft.txId = `simulated-${plan.planId}-tx`;
         }
-        const hash = calculateContentHash(draft, CURRENT_HASH_VERSION2);
+        let hash = calculateContentHash(draft, CURRENT_HASH_VERSION2);
         draft.signedId = `signed-${hash.slice(0, 16)}`;
         draft.contentHash = hash;
-        if (draft.lineage) draft.lineage.artifactId = hash;
+        if (draft.lineage) {
+          draft.lineage.artifactId = hash;
+          hash = calculateContentHash(draft, CURRENT_HASH_VERSION2);
+          draft.contentHash = hash;
+          draft.lineage.artifactId = hash;
+        }
         signedArtifact = draft;
       } else {
         if (resolvedAccount.address !== plan.from.address) {
@@ -694,7 +709,8 @@ var HardkasTx = class {
       );
     }
     const activeNetwork = this.sdk.config.config.defaultNetwork || "simnet";
-    const isSimulated = activeNetwork === "simulated" || this.sdk.config.config.networks?.[activeNetwork]?.kind === "simulated";
+    const isExplicitRpc = typeof urlOrOptions === "string" && (urlOrOptions.startsWith("ws://") || urlOrOptions.startsWith("http://") || urlOrOptions.startsWith("wss://") || urlOrOptions.startsWith("https://"));
+    const isSimulated = !isExplicitRpc && (activeNetwork === "simulated" || this.sdk.config.config.networks?.[activeNetwork]?.kind === "simulated");
     if (isSimulated) {
       const persistOpt = typeof urlOrOptions === "object" ? urlOrOptions.persist : true;
       const simOpts = persistOpt !== void 0 ? { persist: persistOpt } : {};
@@ -768,14 +784,7 @@ var HardkasTx = class {
       ...url ? { rpcUrl: url } : {},
       ...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
-      }
+      lineage: createLineageTransition(signedArtifact, "hardkas.txReceipt")
     };
     realReceiptBase.contentHash = calculateContentHash(
       realReceiptBase,
@@ -1368,6 +1377,10 @@ var HardkasArtifactsManager = class {
    */
   async write(artifact, options = {}) {
     const record = artifact;
+    if (!record.hashVersion) {
+      const { CURRENT_HASH_VERSION: CURRENT_HASH_VERSION2 } = await import("@hardkas/artifacts");
+      record.hashVersion = CURRENT_HASH_VERSION2;
+    }
     const hash = record.contentHash || "unknown";
     if (record.planId) this.cache.set(record.planId, artifact);
     if (record.signedId) this.cache.set(record.signedId, artifact);
@@ -1455,17 +1468,15 @@ var HardkasArtifactsManager = class {
             const shortId = id.startsWith("plan-") || id.startsWith("signed-") ? id : id.slice(0, 16);
             for (const file of files) {
               if (!file.endsWith(".json")) continue;
-              if (file.includes(id) || file.includes(shortId) || file.includes(id.slice(0, 8))) {
-                const fp = path3.join(this.workspace.artifactsDir, file);
-                try {
-                  const content = fs3.readFileSync(fp, "utf-8");
-                  const obj = JSON.parse(content);
-                  if (obj.contentHash === id || obj.artifactId === id || obj.planId === id || obj.signedId === id || obj.txId === id) {
-                    found = file;
-                    break;
-                  }
-                } catch {
+              const fp = path3.join(this.workspace.artifactsDir, file);
+              try {
+                const content = fs3.readFileSync(fp, "utf-8");
+                const obj = JSON.parse(content);
+                if (obj.contentHash === id || obj.artifactId === id || obj.planId === id || obj.signedId === id || obj.txId === id) {
+                  found = file;
+                  break;
                 }
+              } catch {
               }
             }
           }
@@ -1554,7 +1565,7 @@ var HardkasArtifactsManager = class {
       }
     }
     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" : result.issues[0]?.code === "REFERENCE_MISSING" ? "reference_missing" : result.issues[0]?.code === "REFERENCE_HASH_MISMATCH" ? "reference_hash_mismatch" : result.issues[0]?.code === "POLICY_VIOLATION" ? "policy_violation" : result.issues[0]?.code === "PARENT_MISSING" ? "parent_missing" : "schema_invalid";
+      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" : result.issues[0]?.code === "REFERENCE_MISSING" ? "reference_missing" : result.issues[0]?.code === "REFERENCE_HASH_MISMATCH" ? "reference_hash_mismatch" : result.issues[0]?.code === "POLICY_VIOLATION" ? "policy_violation" : result.issues[0]?.code === "LEGACY_HASH_VERSION_UNSAFE" ? "legacy_hash_version_unsafe" : result.issues[0]?.code === "PARENT_MISSING" ? "parent_missing" : "schema_invalid";
       if (throwOnInvalid) {
         throw new Error(`Artifact ${id} corrupted or invalid: ` + JSON.stringify(result.issues, null, 2));
       }
@@ -1573,6 +1584,26 @@ var HardkasArtifactsManager = class {
     }
     return result;
   }
+  /**
+   * Migrates a legacy artifact to v4 using a migration receipt.
+   */
+  async migrate(target, migrationId) {
+    let artifact;
+    if (typeof target === "string") {
+      artifact = await this.read(target);
+    } else {
+      artifact = target;
+    }
+    const { migrateArtifactPayload, generateMigrationReceipt } = await import("@hardkas/artifacts");
+    const result = migrateArtifactPayload(artifact, void 0, { strictPolicy: false });
+    if (!result.migrated) {
+      throw new Error(`Artifact ${artifact.artifactId || artifact.contentHash} is already at the target version or cannot be migrated.`);
+    }
+    const receipt = generateMigrationReceipt(artifact, result.artifact, migrationId);
+    await this.write(result.artifact);
+    await this.write(receipt);
+    return { migrated: result.artifact, receipt };
+  }
 };
 
 // src/workflow.ts
@@ -1885,6 +1916,7 @@ var Hardkas = class _Hardkas {
     this.tx = new HardkasTx(this);
     this.l2 = new HardkasL2();
     this.query = new HardkasQuery(this);
+    this.signer = options?.signer;
     this.localnet = new HardkasLocalnet(this);
     this.replay = new HardkasReplay(this);
     this.lineage = new HardkasLineage(this);
@@ -1901,6 +1933,7 @@ var Hardkas = class _Hardkas {
   replay;
   lineage;
   workflow;
+  signer;
   mode;
   policy;
   rpc;

package/package.json

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