@hardkas/artifacts 0.8.5-alpha → 0.8.9-alpha

package/dist/index.d.ts

@@ -807,18 +807,30 @@ declare const TxPlanSchema: z.ZodObject<{
             index: number;
         }>;
         amountSompi: z.ZodString;
+        address: z.ZodOptional<z.ZodString>;
+        scriptPublicKey: z.ZodOptional<z.ZodString>;
+        blockDaaScore: z.ZodOptional<z.ZodString>;
+        isCoinbase: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         amountSompi: string;
         outpoint: {
             transactionId: string;
             index: number;
         };
+        address?: string | undefined;
+        scriptPublicKey?: string | undefined;
+        blockDaaScore?: string | undefined;
+        isCoinbase?: boolean | undefined;
     }, {
         amountSompi: string;
         outpoint: {
             transactionId: string;
             index: number;
         };
+        address?: string | undefined;
+        scriptPublicKey?: string | undefined;
+        blockDaaScore?: string | undefined;
+        isCoinbase?: boolean | undefined;
     }>, "many">;
     outputs: z.ZodArray<z.ZodObject<{
         address: z.ZodString;
@@ -872,6 +884,10 @@ declare const TxPlanSchema: z.ZodObject<{
             transactionId: string;
             index: number;
         };
+        address?: string | undefined;
+        scriptPublicKey?: string | undefined;
+        blockDaaScore?: string | undefined;
+        isCoinbase?: boolean | undefined;
     }[];
     outputs: {
         address: string;
@@ -935,6 +951,10 @@ declare const TxPlanSchema: z.ZodObject<{
             transactionId: string;
             index: number;
         };
+        address?: string | undefined;
+        scriptPublicKey?: string | undefined;
+        blockDaaScore?: string | undefined;
+        isCoinbase?: boolean | undefined;
     }[];
     outputs: {
         address: string;
@@ -2868,13 +2888,15 @@ interface DeploymentSummary {
 }
 
 declare const SEMANTIC_EXCLUSIONS: Set<string>;
+declare const V4_SEMANTIC_EXCLUSIONS: Set<string>;
 /**
  * Current canonicalization version.
  * v1: BigInt(123) -> "123" (Collision with String "123")
  * v2: BigInt(123) -> "n:123" (Distinguishable)
  * v3: String normalization (\r\n -> \n, NFC) for cross-platform stability.
+ * v4: Strict Metadata Integrity (includes lineage, parentArtifactId, signatureMetadata, etc in the hash).
  */
-declare const CURRENT_HASH_VERSION = 3;
+declare const CURRENT_HASH_VERSION = 4;
 declare const STRICT_PATH_KEYS: Set<string>;
 /**
  * Deterministically stringifies an object by sorting keys recursively.
@@ -2928,12 +2950,12 @@ declare function sortUtxosByOutpoint<T>(utxos: T[]): T[];
  * Verifies an artifact's integrity synchronously.
  * Can take a raw object or a file path.
  */
-declare function verifyArtifactIntegritySync(artifactOrPath: unknown): ArtifactVerificationResult;
+declare function verifyArtifactIntegritySync(artifactOrPath: unknown, context?: VerificationContext): ArtifactVerificationResult;
 /**
  * Verifies an artifact's integrity asynchronously.
  * Can take a raw object or a file path.
  */
-declare function verifyArtifactIntegrity(artifactOrPath: unknown): Promise<ArtifactVerificationResult>;
+declare function verifyArtifactIntegrity(artifactOrPath: unknown, context?: VerificationContext): Promise<ArtifactVerificationResult>;
 /**
  * Verifies an artifact's semantic and economic validity.
  */
@@ -3383,6 +3405,17 @@ interface LineageOptions {
  * Validates the lineage relationship between an artifact and its parent.
  */
 declare function verifyLineage(artifact: any, parent?: any, options?: LineageOptions): LineageValidationResult;
+/**
+ * Creates a valid lineage transition object for a new child artifact based on its parent.
+ * This should be attached to the child artifact before calculating its final hash.
+ */
+declare function createLineageTransition(parent: any, childType: string): {
+    artifactId: string;
+    lineageId: string;
+    parentArtifactId: string;
+    rootArtifactId: string;
+    sequence: number;
+};
 
 interface DiffEntry {
     path: string;
@@ -3425,4 +3458,23 @@ declare function listDeployments(rootDir: string, networkId?: string): Promise<D
 declare function updateDeployment(rootDir: string, networkId: string, label: string, update: Partial<DeploymentRecord>): Promise<DeploymentRecord>;
 declare function deleteDeployment(rootDir: string, networkId: string, label: string): Promise<boolean>;
 
-export { ARTIFACT_SCHEMAS, ARTIFACT_VERSION, AccountRefSchema, type ArtifactDiff, type ArtifactExplanation, ArtifactLineageSchema, type ArtifactLookup, type ArtifactPayload, type ArtifactValidationResult, type ArtifactVerificationResult, type Assumption, type AssumptionArtifact, type AssumptionLevel, AssumptionSchema, type BaseArtifact, BaseArtifactSchema, BasicCorrelationInvariant, BasicLineageInvariant, CURRENT_HASH_VERSION, type Clock, type CreateTxPlanArtifactOptions, type DagContext, DagContextSchema, type DeploymentIndex, type DeploymentRecord, type DeploymentSummary, type DiffEntry, type DraftArtifact, type FeeAuditResult, HARDKAS_VERSION, type HardkasArtifactBase, type HardkasArtifactMode, type HardkasArtifactSchema, HashInvariant, type IgraSignedTxArtifact, type IgraTxPlanArtifact, type IgraTxReceiptArtifact, type IgraTxRequestArtifact, type Invariant, type InvariantContext, type InvariantViolation, InvariantWatcher, LifecycleInvariant, type LineageOptions, type LineageValidationResult, LocalnetUtxoSchemaV2, type MigrationReceipt, type MigrationReceiptArtifact, MigrationReceiptSchema, MigrationRequiredError, type MigrationResult, type MigrationStep, NetworkInvariant, type NetworkProfile, type NetworkProfileArtifact, NetworkProfileSchema, type Policy, type PolicyArtifact, PolicySchema, ReplayInvariant, type RuntimeSession, RuntimeSessionSchema, SEMANTIC_EXCLUSIONS, STRICT_PATH_KEYS, SchemaInvariant, type ScriptCapability, ScriptCapabilitySchema, ScriptMetadataSchema, SignatureEntrySchema, SignatureMetadataEntrySchema, type SignedTx, type SignedTxArtifact, type SignedTxArtifactV1, SignedTxSchema, type Snapshot, type SnapshotArtifact, SnapshotSchema, type TxOutputArtifact, type TxPlan, type TxPlanArtifact, type TxPlanArtifactV1, TxPlanSchema, type TxReceipt, type TxReceiptArtifact, type TxReceiptArtifactV1, TxReceiptSchema, type TxTrace, type TxTraceArtifact, type TxTraceArtifactV1, TxTraceSchema, type UtxoArtifact, type VerificationContext, type VerificationIssue, type VerificationSeverity, type WatcherOptions, type Workflow, type WorkflowArtifact, WorkflowSchema, assertDecimalBigIntString, assertEvmAddress, assertEvmTxHash, assertHexData, assertValidIgraSignedTxArtifact, assertValidIgraTxPlanArtifact, assertValidIgraTxReceiptArtifact, assertValidSignedTxArtifact, assertValidTxPlanArtifact, assertValidTxReceiptArtifact, bigIntReplacer, calculateContentHash, canMigrate, canonicalStringify, createDeploymentRecord, createIgraDeployPlanId, createIgraPlanId, createIgraSignedId, createSimulatedSignedTxArtifact, createSimulatedTxReceipt, createTxPlanArtifact, defaultClock, deleteDeployment, detectArtifactVersion, diffArtifacts, explainArtifact, formatSignedTxArtifact, formatTxPlanArtifact, formatTxReceiptArtifact, generateMigrationReceipt, getBroadcastableSignedTransaction, getDefaultL2ReceiptsDir, getDefaultReceiptPath, getL2ReceiptPath, getMigrationPath, getRegisteredMigrationSteps, isIgraTxPlanArtifact, listDeployments, listIgraTxReceiptArtifacts, loadDeployment, loadIgraTxReceiptArtifact, migrateArtifactPayload, migrateToCanonical, readArtifact, readSignedTxArtifact, readTxPlanArtifact, readTxReceiptArtifact, recomputeMass, registerMigrationStep, saveDeployment, saveIgraTxReceiptArtifact, sortUtxosByOutpoint, txOutputFromArtifact, txOutputToArtifact, updateDeployment, updateDeploymentStatus, utxoFromArtifact, utxoToArtifact, validateArtifact, validateIgraSignedTxArtifact, validateIgraTxPlanArtifact, validateIgraTxReceiptArtifact, validateSignedTxArtifact, validateTxPlanArtifact, validateTxReceiptArtifact, verifyArtifact, verifyArtifactFile, verifyArtifactIntegrity, verifyArtifactIntegritySync, verifyArtifactReplay, verifyArtifactSemantics, verifyFeeSemantics, verifyLineage, writeArtifact };
+/**
+ * Interface for external wallets and signers.
+ * HardKAS uses this to delegate transaction signing to secure enclaves,
+ * hardware wallets, or official Kaspa SDK backends, ensuring it does not
+ * need to hold or manage private keys natively.
+ */
+interface ExternalHardkasSigner {
+    /**
+     * Retrieves the public Kaspa address managed by this signer.
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Signs a prepared transaction plan.
+     * @param txPlan The transaction plan artifact to sign.
+     * @returns A signed transaction artifact.
+     */
+    signTransaction(txPlan: TxPlanArtifact): Promise<SignedTxArtifact>;
+}
+
+export { ARTIFACT_SCHEMAS, ARTIFACT_VERSION, AccountRefSchema, type ArtifactDiff, type ArtifactExplanation, ArtifactLineageSchema, type ArtifactLookup, type ArtifactPayload, type ArtifactValidationResult, type ArtifactVerificationResult, type Assumption, type AssumptionArtifact, type AssumptionLevel, AssumptionSchema, type BaseArtifact, BaseArtifactSchema, BasicCorrelationInvariant, BasicLineageInvariant, CURRENT_HASH_VERSION, type Clock, type CreateTxPlanArtifactOptions, type DagContext, DagContextSchema, type DeploymentIndex, type DeploymentRecord, type DeploymentSummary, type DiffEntry, type DraftArtifact, type ExternalHardkasSigner, type FeeAuditResult, HARDKAS_VERSION, type HardkasArtifactBase, type HardkasArtifactMode, type HardkasArtifactSchema, HashInvariant, type IgraSignedTxArtifact, type IgraTxPlanArtifact, type IgraTxReceiptArtifact, type IgraTxRequestArtifact, type Invariant, type InvariantContext, type InvariantViolation, InvariantWatcher, LifecycleInvariant, type LineageOptions, type LineageValidationResult, LocalnetUtxoSchemaV2, type MigrationReceipt, type MigrationReceiptArtifact, MigrationReceiptSchema, MigrationRequiredError, type MigrationResult, type MigrationStep, NetworkInvariant, type NetworkProfile, type NetworkProfileArtifact, NetworkProfileSchema, type Policy, type PolicyArtifact, PolicySchema, ReplayInvariant, type RuntimeSession, RuntimeSessionSchema, SEMANTIC_EXCLUSIONS, STRICT_PATH_KEYS, SchemaInvariant, type ScriptCapability, ScriptCapabilitySchema, ScriptMetadataSchema, SignatureEntrySchema, SignatureMetadataEntrySchema, type SignedTx, type SignedTxArtifact, type SignedTxArtifactV1, SignedTxSchema, type Snapshot, type SnapshotArtifact, SnapshotSchema, type TxOutputArtifact, type TxPlan, type TxPlanArtifact, type TxPlanArtifactV1, TxPlanSchema, type TxReceipt, type TxReceiptArtifact, type TxReceiptArtifactV1, TxReceiptSchema, type TxTrace, type TxTraceArtifact, type TxTraceArtifactV1, TxTraceSchema, type UtxoArtifact, V4_SEMANTIC_EXCLUSIONS, type VerificationContext, type VerificationIssue, type VerificationSeverity, type WatcherOptions, type Workflow, type WorkflowArtifact, WorkflowSchema, assertDecimalBigIntString, assertEvmAddress, assertEvmTxHash, assertHexData, assertValidIgraSignedTxArtifact, assertValidIgraTxPlanArtifact, assertValidIgraTxReceiptArtifact, assertValidSignedTxArtifact, assertValidTxPlanArtifact, assertValidTxReceiptArtifact, bigIntReplacer, calculateContentHash, canMigrate, canonicalStringify, createDeploymentRecord, createIgraDeployPlanId, createIgraPlanId, createIgraSignedId, createLineageTransition, createSimulatedSignedTxArtifact, createSimulatedTxReceipt, createTxPlanArtifact, defaultClock, deleteDeployment, detectArtifactVersion, diffArtifacts, explainArtifact, formatSignedTxArtifact, formatTxPlanArtifact, formatTxReceiptArtifact, generateMigrationReceipt, getBroadcastableSignedTransaction, getDefaultL2ReceiptsDir, getDefaultReceiptPath, getL2ReceiptPath, getMigrationPath, getRegisteredMigrationSteps, isIgraTxPlanArtifact, listDeployments, listIgraTxReceiptArtifacts, loadDeployment, loadIgraTxReceiptArtifact, migrateArtifactPayload, migrateToCanonical, readArtifact, readSignedTxArtifact, readTxPlanArtifact, readTxReceiptArtifact, recomputeMass, registerMigrationStep, saveDeployment, saveIgraTxReceiptArtifact, sortUtxosByOutpoint, txOutputFromArtifact, txOutputToArtifact, updateDeployment, updateDeploymentStatus, utxoFromArtifact, utxoToArtifact, validateArtifact, validateIgraSignedTxArtifact, validateIgraTxPlanArtifact, validateIgraTxReceiptArtifact, validateSignedTxArtifact, validateTxPlanArtifact, validateTxReceiptArtifact, verifyArtifact, verifyArtifactFile, verifyArtifactIntegrity, verifyArtifactIntegritySync, verifyArtifactReplay, verifyArtifactSemantics, verifyFeeSemantics, verifyLineage, writeArtifact };

package/dist/index.js

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "@hardkas/artifacts",
-  version: "0.8.5-alpha",
+  version: "0.8.9-alpha",
   type: "module",
   license: "MIT",
   author: "Javier Rodriguez",
@@ -234,7 +234,44 @@ var SEMANTIC_EXCLUSIONS = /* @__PURE__ */ new Set([
   "workflowId",
   "signatureMetadata"
 ]);
-var CURRENT_HASH_VERSION = 3;
+var V4_SEMANTIC_EXCLUSIONS = /* @__PURE__ */ new Set([
+  // Core Hash Identity
+  "contentHash",
+  "artifactId",
+  "planId",
+  "signedId",
+  "hashVersion",
+  // Runtime/Display fields (user requested)
+  "filePath",
+  "file_path",
+  "workspacePath",
+  "debug",
+  "logs",
+  "uiHints",
+  "cache",
+  "lastViewedAt",
+  // Other runtime fields that must not break hash
+  "createdAt",
+  "events",
+  "status",
+  "submittedAt",
+  "confirmedAt",
+  "dagContext",
+  "executionId",
+  "deployedAt",
+  "tracePath",
+  "receiptPath",
+  "sourceSignedId",
+  "workflowId",
+  "signatureMetadata",
+  "rpcHost",
+  "rpcUrl",
+  "latencyMs",
+  "indexedAt",
+  "file_mtime_ms",
+  "hardkasVersion"
+]);
+var CURRENT_HASH_VERSION = 4;
 var STRICT_PATH_KEYS = /* @__PURE__ */ new Set([
   "file_path",
   "sandboxSnapshotPath",
@@ -288,8 +325,9 @@ function canonicalStringify(obj, version = CURRENT_HASH_VERSION, keyName, isRoot
   if (proto !== Object.prototype && proto !== null) {
     throw new Error("Non-plain object encountered in canonicalizer.");
   }
+  const exclusions = version >= 4 ? V4_SEMANTIC_EXCLUSIONS : SEMANTIC_EXCLUSIONS;
   const sortedKeys = Object.keys(obj).filter(
-    (key) => !SEMANTIC_EXCLUSIONS.has(key) && obj[key] !== void 0
+    (key) => !exclusions.has(key) && obj[key] !== void 0
   ).sort(deterministicCompare);
   const result = sortedKeys.map((key) => {
     const value = obj[key];
@@ -405,7 +443,11 @@ var TxPlanSchema = BaseArtifactSchema.extend({
         transactionId: z.string(),
         index: z.number()
       }),
-      amountSompi: z.string()
+      amountSompi: z.string(),
+      address: z.string().optional(),
+      scriptPublicKey: z.string().optional(),
+      blockDaaScore: z.string().optional(),
+      isCoinbase: z.boolean().optional()
     })
   ),
   outputs: z.array(
@@ -790,6 +832,13 @@ function verifyLineage(artifact, parent, options = {}) {
       const allowed = validTransitions[parent.schema] || [];
       isValidTransition = allowed.includes(artifact.schema);
     }
+    if (!isValidTransition) {
+      const parentBase = parent.schema?.replace(/\.v1$/, "");
+      const childBase = artifact.schema?.replace(/\.v1$/, "");
+      if (parentBase && childBase && parentBase === childBase) {
+        isValidTransition = true;
+      }
+    }
     if (!isValidTransition) {
       addIssue(
         "INVALID_TRANSITION",
@@ -802,6 +851,18 @@ function verifyLineage(artifact, parent, options = {}) {
     issues
   };
 }
+function createLineageTransition(parent, childType) {
+  const parentLineage = parent.lineage || {};
+  const parentId = parent.contentHash || parent.artifactId || parent.planId || parent.signedId || "0".repeat(64);
+  return {
+    artifactId: "",
+    // To be computed after the rest of the artifact is hashed
+    lineageId: parentLineage.lineageId || parentId,
+    parentArtifactId: parentId,
+    rootArtifactId: parentLineage.rootArtifactId || parentId,
+    sequence: (parentLineage.sequence || 0) + 1
+  };
+}
 
 // src/verify.ts
 var defaultClock = {
@@ -822,7 +883,7 @@ function sortUtxosByOutpoint(utxos) {
     return deterministicCompare2(aId, bId);
   });
 }
-function verifyArtifactIntegritySync(artifactOrPath) {
+function verifyArtifactIntegritySync(artifactOrPath, context = {}) {
   const result = {
     ok: false,
     errors: [],
@@ -881,6 +942,19 @@ function verifyArtifactIntegritySync(artifactOrPath) {
         "HASH_MISMATCH",
         `Hash mismatch: expected ${v.contentHash}, got ${actualHash}`
       );
+    } else if (hashVersion < 4) {
+      if (context.strict) {
+        addError(
+          "LEGACY_HASH_VERSION_UNSAFE",
+          `Artifact uses legacy hash version ${hashVersion}. Migration to v4 is required for strict pipelines.`
+        );
+      } else {
+        result.issues.push({
+          code: "LEGACY_VALID",
+          severity: "info",
+          message: `Artifact uses legacy hash version ${hashVersion} (valid but unsafe for strict mode).`
+        });
+      }
     }
     let schema;
     switch (v.schema) {
@@ -918,9 +992,19 @@ function verifyArtifactIntegritySync(artifactOrPath) {
     if (schema) {
       const validation = schema.safeParse(v);
       if (!validation.success) {
+        const zodSeverity = hashVersion < 4 && !context.strict ? "warning" : "error";
         validation.error.issues.forEach((e) => {
           const pathStr = e.path.join(".");
-          addError("ARTIFACT_SCHEMA_INVALID", `${pathStr}: ${e.message}`, pathStr);
+          if (zodSeverity === "warning") {
+            result.issues.push({
+              code: "ARTIFACT_SCHEMA_INVALID",
+              severity: zodSeverity,
+              message: `${pathStr}: ${e.message}`,
+              ...pathStr ? { path: pathStr } : {}
+            });
+          } else {
+            addError("ARTIFACT_SCHEMA_INVALID", `${pathStr}: ${e.message}`, pathStr);
+          }
         });
       }
     } else {
@@ -944,8 +1028,8 @@ function verifyArtifactIntegritySync(artifactOrPath) {
     return result;
   }
 }
-async function verifyArtifactIntegrity(artifactOrPath) {
-  return verifyArtifactIntegritySync(artifactOrPath);
+async function verifyArtifactIntegrity(artifactOrPath, context = {}) {
+  return verifyArtifactIntegritySync(artifactOrPath, context);
 }
 function findFileByHash(hash, dirs) {
   const shortHash = hash.startsWith("plan-") || hash.startsWith("signed-") ? hash : hash.slice(0, 16);
@@ -1039,7 +1123,7 @@ function verifyArtifactSemantics(artifact, context = {}) {
         });
       } else {
         try {
-          const integrity = verifyArtifactIntegritySync(refObj);
+          const integrity = verifyArtifactIntegritySync(refObj, context);
           if (!integrity.ok) {
             addIssue({
               code: "REFERENCE_HASH_MISMATCH",
@@ -1106,7 +1190,7 @@ function verifyArtifactSemantics(artifact, context = {}) {
         });
       } else {
         try {
-          const integrity = verifyArtifactIntegritySync(refObj);
+          const integrity = verifyArtifactIntegritySync(refObj, context);
           if (!integrity.ok) {
             addIssue({
               code: "REFERENCE_HASH_MISMATCH",
@@ -1149,7 +1233,7 @@ function verifyArtifactSemantics(artifact, context = {}) {
         });
       } else {
         try {
-          const integrity = verifyArtifactIntegritySync(refObj);
+          const integrity = verifyArtifactIntegritySync(refObj, context);
           if (!integrity.ok) {
             addIssue({
               code: "REFERENCE_HASH_MISMATCH",
@@ -1307,11 +1391,11 @@ function verifyArtifactSemantics(artifact, context = {}) {
     if (addr && typeof addr === "string") {
       let mismatch = false;
       if (networkIdStr === "mainnet") {
-        mismatch = !addr.startsWith("kaspa:") || addr.startsWith("kaspa:sim_");
+        mismatch = !addr.startsWith("kaspa:") || addr.startsWith("kaspasim:") || addr.startsWith("kaspa:sim_");
       } else if (networkIdStr.startsWith("testnet")) {
         mismatch = !addr.startsWith("kaspatest:");
       } else {
-        mismatch = !addr.startsWith("kaspa:sim_");
+        mismatch = !addr.startsWith("kaspasim:") && !addr.startsWith("kaspa:sim_");
       }
       if (mismatch) {
         addIssue({
@@ -1689,10 +1773,18 @@ function migrateArtifactPayload(artifact, targetVersion = ARTIFACT_VERSION, opti
     const migratedLineage = current.lineage;
     if (migratedLineage && typeof migratedLineage === "object") {
       migratedLineage.rootArtifactId = originalLineage.rootArtifactId;
+      if (originalContentHash) {
+        migratedLineage.parentArtifactId = originalContentHash;
+      }
     }
   }
   current.hashVersion = CURRENT_HASH_VERSION;
-  current.contentHash = calculateContentHash(current, CURRENT_HASH_VERSION);
+  let hash = calculateContentHash(current, CURRENT_HASH_VERSION);
+  if (current.lineage && typeof current.lineage === "object") {
+    current.lineage.artifactId = hash;
+    hash = calculateContentHash(current, CURRENT_HASH_VERSION);
+  }
+  current.contentHash = hash;
   return {
     artifact: current,
     migrated: true,
@@ -1734,18 +1826,6 @@ function generateMigrationReceipt(oldArtifact, newArtifact, migrationId) {
   };
   receipt.contentHash = calculateContentHash(receipt, CURRENT_HASH_VERSION);
   receipt.lineage.artifactId = receipt.contentHash;
-  if (!newArtifact.lineage) {
-    newArtifact.lineage = {
-      artifactId: newHash,
-      lineageId: receipt.lineage.lineageId,
-      parentArtifactId: receipt.contentHash,
-      rootArtifactId: receipt.lineage.rootArtifactId
-    };
-  } else {
-    newArtifact.lineage.parentArtifactId = receipt.contentHash;
-  }
-  newArtifact.contentHash = calculateContentHash(newArtifact, CURRENT_HASH_VERSION);
-  newArtifact.lineage.artifactId = newArtifact.contentHash;
   return receipt;
 }
 
@@ -1979,7 +2059,11 @@ function createTxPlanArtifact(options) {
         transactionId: i.outpoint.transactionId,
         index: i.outpoint.index
       },
-      amountSompi: i.amountSompi.toString()
+      amountSompi: i.amountSompi.toString(),
+      address: i.address,
+      scriptPublicKey: i.scriptPublicKey,
+      ...i.blockDaaScore !== void 0 ? { blockDaaScore: i.blockDaaScore.toString() } : {},
+      ...i.isCoinbase !== void 0 ? { isCoinbase: i.isCoinbase } : {}
     })),
     outputs: options.plan.outputs.map((o) => ({
       address: o.address,
@@ -2006,16 +2090,13 @@ function createTxPlanArtifact(options) {
   artifact.planId = `plan-${hash.slice(0, 16)}`;
   artifact.contentHash = hash;
   if (artifact.lineage) {
-    artifact.lineage.lineageId = artifact.contentHash;
-    artifact.lineage.artifactId = artifact.contentHash;
-    artifact.lineage.parentArtifactId = artifact.contentHash;
-    artifact.lineage.rootArtifactId = artifact.contentHash;
+    artifact.lineage.lineageId = hash;
+    artifact.lineage.parentArtifactId = hash;
+    artifact.lineage.rootArtifactId = hash;
     const finalHash = calculateContentHash(artifact, CURRENT_HASH_VERSION);
     artifact.planId = `plan-${finalHash.slice(0, 16)}`;
     artifact.contentHash = finalHash;
     artifact.lineage.artifactId = finalHash;
-    artifact.lineage.parentArtifactId = finalHash;
-    artifact.lineage.rootArtifactId = finalHash;
   }
   return artifact;
 }
@@ -2041,13 +2122,7 @@ function createSimulatedSignedTxArtifact(plan, payload, ctx) {
       format: "simulated",
       payload
     },
-    lineage: {
-      artifactId: "",
-      lineageId: plan.lineage?.lineageId || plan.contentHash || "0".repeat(64),
-      parentArtifactId: plan.contentHash || "0".repeat(64),
-      rootArtifactId: plan.lineage?.rootArtifactId || plan.contentHash || "0".repeat(64),
-      sequence: (plan.lineage?.sequence || 0) + 1
-    },
+    lineage: createLineageTransition(plan, "hardkas.signedTx"),
     ...plan.workflowId ? { workflowId: plan.workflowId } : {}
   };
   const hash = calculateContentHash(artifact, CURRENT_HASH_VERSION);
@@ -2081,21 +2156,16 @@ function createSimulatedTxReceipt(plan, txId, ctx, extra) {
     preStateHash: extra?.preStateHash,
     postStateHash: extra?.postStateHash,
     dagContext: extra?.dagContext,
-    lineage: {
-      artifactId: "",
-      lineageId: plan.lineage?.lineageId || plan.contentHash || "0".repeat(64),
-      parentArtifactId: "0".repeat(64),
-      // Will set to contentHash of signedTx later
-      rootArtifactId: plan.lineage?.rootArtifactId || plan.contentHash || "0".repeat(64),
-      sequence: (plan.lineage?.sequence || 1) + 1
-    },
+    lineage: createLineageTransition(plan, "hardkas.txReceipt"),
     ...plan.workflowId ? { workflowId: plan.workflowId } : {}
   };
+  if (artifact.lineage) {
+    artifact.lineage.parentArtifactId = extra?.preStateHash || txId.replace("simulated-", "").replace("-tx", "").padEnd(64, "0").slice(0, 64);
+  }
   const hash = calculateContentHash(artifact, CURRENT_HASH_VERSION);
   artifact.contentHash = hash;
   if (artifact.lineage) {
     artifact.lineage.artifactId = hash;
-    artifact.lineage.parentArtifactId = extra?.preStateHash || txId.replace("simulated-", "").replace("-tx", "").padEnd(64, "0").slice(0, 64);
   }
   return artifact;
 }
@@ -2579,6 +2649,7 @@ export {
   TxPlanSchema,
   TxReceiptSchema,
   TxTraceSchema,
+  V4_SEMANTIC_EXCLUSIONS,
   WorkflowSchema,
   assertDecimalBigIntString,
   assertEvmAddress,
@@ -2598,6 +2669,7 @@ export {
   createIgraDeployPlanId,
   createIgraPlanId,
   createIgraSignedId,
+  createLineageTransition,
   createSimulatedSignedTxArtifact,
   createSimulatedTxReceipt,
   createTxPlanArtifact,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/artifacts",
-  "version": "0.8.5-alpha",
+  "version": "0.8.9-alpha",
   "type": "module",
   "license": "MIT",
   "author": "Javier Rodriguez",
@@ -28,8 +28,8 @@
   "types": "./dist/index.d.ts",
   "dependencies": {
     "zod": "^3.24.1",
-    "@hardkas/core": "0.8.5-alpha",
-    "@hardkas/tx-builder": "0.8.5-alpha"
+    "@hardkas/core": "0.8.9-alpha",
+    "@hardkas/tx-builder": "0.8.9-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",