@hardkas/artifacts 0.5.4-alpha → 0.6.0-alpha

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { ArtifactType, NetworkId, ExecutionMode, ContentHash, WorkflowId, ArtifactId, LineageId, EventSequence, TxId, KaspaAddress, CorruptionCode, CorruptionSeverity, EventEnvelope } from '@hardkas/core';
+import { ArtifactType, NetworkId, ExecutionMode, ContentHash, WorkflowId, ArtifactId, LineageId, EventSequence, TxId, KaspaAddress, CorruptionCode, CorruptionSeverity, EventEnvelope, RuntimeContext } from '@hardkas/core';
 import { z } from 'zod';
 import { TxOutput, Utxo, TxPlan as TxPlan$1 } from '@hardkas/tx-builder';
 
-declare const HARDKAS_VERSION = "0.5.4-alpha";
+declare const HARDKAS_VERSION: string;
 declare const ARTIFACT_SCHEMAS: {
     readonly LOCALNET_STATE: "hardkas.localnetState.v1";
     readonly REAL_ACCOUNT_STORE: "hardkas.realAccountStore.v1";
@@ -19,6 +19,7 @@ type HardkasArtifactSchema = typeof ARTIFACT_SCHEMAS[keyof typeof ARTIFACT_SCHEM
 type HardkasArtifactMode = "simulated" | "node" | "rpc" | "l2-rpc" | "real";
 
 declare const ARTIFACT_VERSION = "1.0.0-alpha";
+type DraftArtifact<TFinal, THashFields extends keyof TFinal> = Omit<TFinal, THashFields> & Partial<Pick<TFinal, THashFields>>;
 declare const ArtifactLineageSchema: z.ZodObject<{
     artifactId: z.ZodString;
     lineageId: z.ZodString;
@@ -43,7 +44,7 @@ declare const BaseArtifactSchema: z.ZodObject<{
     hardkasVersion: z.ZodString;
     version: z.ZodLiteral<"1.0.0-alpha">;
     hashVersion: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
-    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet"]>;
+    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet", "simulated"]>;
     mode: z.ZodEnum<["simulated", "real", "readonly"]>;
     contentHash: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
@@ -70,7 +71,7 @@ declare const BaseArtifactSchema: z.ZodObject<{
     schema: string;
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     hashVersion?: string | number | undefined;
@@ -86,7 +87,7 @@ declare const BaseArtifactSchema: z.ZodObject<{
     schema: string;
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     hashVersion?: string | number | undefined;
@@ -139,7 +140,7 @@ declare const TxPlanSchema: z.ZodObject<{
     }>>;
 } & {
     schema: z.ZodLiteral<"hardkas.txPlan">;
-    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet"]>;
+    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet", "simulated"]>;
     mode: z.ZodEnum<["simulated", "real", "readonly"]>;
     planId: z.ZodString;
     from: z.ZodObject<{
@@ -221,7 +222,7 @@ declare const TxPlanSchema: z.ZodObject<{
     schema: "hardkas.txPlan";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     planId: string;
@@ -267,7 +268,7 @@ declare const TxPlanSchema: z.ZodObject<{
     schema: "hardkas.txPlan";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     planId: string;
@@ -381,7 +382,7 @@ declare const SnapshotSchema: z.ZodObject<{
     hardkasVersion: z.ZodString;
     version: z.ZodLiteral<"1.0.0-alpha">;
     hashVersion: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
-    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet"]>;
+    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet", "simulated"]>;
     mode: z.ZodEnum<["simulated", "real", "readonly"]>;
     contentHash: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
@@ -444,7 +445,7 @@ declare const SnapshotSchema: z.ZodObject<{
     schema: "hardkas.snapshot";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     daaScore: string;
@@ -476,7 +477,7 @@ declare const SnapshotSchema: z.ZodObject<{
     schema: "hardkas.snapshot";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     daaScore: string;
@@ -535,7 +536,7 @@ declare const TxReceiptSchema: z.ZodObject<{
     txId: z.ZodString;
     status: z.ZodEnum<["pending", "submitted", "accepted", "confirmed", "failed"]>;
     mode: z.ZodEnum<["simulated", "real", "readonly"]>;
-    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet"]>;
+    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet", "simulated"]>;
     from: z.ZodObject<{
         address: z.ZodString;
         accountName: z.ZodOptional<z.ZodString>;
@@ -624,13 +625,14 @@ declare const TxReceiptSchema: z.ZodObject<{
     tracePath: z.ZodOptional<z.ZodString>;
     rpcUrl: z.ZodOptional<z.ZodString>;
     sourceSignedId: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     metadata: z.ZodOptional<z.ZodAny>;
 }, "strip", z.ZodTypeAny, {
     status: "pending" | "submitted" | "accepted" | "confirmed" | "failed";
     schema: "hardkas.txReceipt";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     from: {
@@ -681,13 +683,14 @@ declare const TxReceiptSchema: z.ZodObject<{
     } | undefined;
     tracePath?: string | undefined;
     sourceSignedId?: string | undefined;
+    errors?: string[] | undefined;
     metadata?: any;
 }, {
     status: "pending" | "submitted" | "accepted" | "confirmed" | "failed";
     schema: "hardkas.txReceipt";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     from: {
@@ -738,6 +741,7 @@ declare const TxReceiptSchema: z.ZodObject<{
     } | undefined;
     tracePath?: string | undefined;
     sourceSignedId?: string | undefined;
+    errors?: string[] | undefined;
     metadata?: any;
 }>;
 declare const SignedTxSchema: z.ZodObject<{
@@ -770,7 +774,7 @@ declare const SignedTxSchema: z.ZodObject<{
     status: z.ZodLiteral<"signed">;
     signedId: z.ZodString;
     sourcePlanId: z.ZodString;
-    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet"]>;
+    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet", "simulated"]>;
     mode: z.ZodEnum<["simulated", "real", "readonly"]>;
     from: z.ZodObject<{
         address: z.ZodString;
@@ -816,7 +820,7 @@ declare const SignedTxSchema: z.ZodObject<{
     schema: "hardkas.signedTx";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     from: {
@@ -852,7 +856,7 @@ declare const SignedTxSchema: z.ZodObject<{
     schema: "hardkas.signedTx";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     from: {
@@ -912,7 +916,7 @@ declare const TxTraceSchema: z.ZodObject<{
 } & {
     schema: z.ZodLiteral<"hardkas.txTrace">;
     txId: z.ZodString;
-    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet"]>;
+    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet", "simulated"]>;
     mode: z.ZodEnum<["simulated", "real", "readonly"]>;
     steps: z.ZodArray<z.ZodObject<{
         phase: z.ZodString;
@@ -982,7 +986,7 @@ declare const TxTraceSchema: z.ZodObject<{
     schema: "hardkas.txTrace";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     txId: string;
@@ -1019,7 +1023,7 @@ declare const TxTraceSchema: z.ZodObject<{
     schema: "hardkas.txTrace";
     hardkasVersion: string;
     version: "1.0.0-alpha";
-    networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
     txId: string;
@@ -1053,12 +1057,218 @@ declare const TxTraceSchema: z.ZodObject<{
         nonSelectedContext?: boolean | undefined;
     } | undefined;
 }>;
+declare const WorkflowSchema: z.ZodObject<{
+    hardkasVersion: z.ZodString;
+    version: z.ZodLiteral<"1.0.0-alpha">;
+    hashVersion: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    networkId: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet", "simulated"]>;
+    mode: z.ZodEnum<["simulated", "real", "readonly"]>;
+    contentHash: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lineage: z.ZodOptional<z.ZodObject<{
+        artifactId: z.ZodString;
+        lineageId: z.ZodString;
+        parentArtifactId: z.ZodOptional<z.ZodString>;
+        rootArtifactId: z.ZodString;
+        sequence: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        artifactId: string;
+        lineageId: string;
+        rootArtifactId: string;
+        parentArtifactId?: string | undefined;
+        sequence?: number | undefined;
+    }, {
+        artifactId: string;
+        lineageId: string;
+        rootArtifactId: string;
+        parentArtifactId?: string | undefined;
+        sequence?: number | undefined;
+    }>>;
+} & {
+    schema: z.ZodLiteral<"hardkas.workflow.v1">;
+    workflowId: z.ZodString;
+    status: z.ZodEnum<["pending", "running", "completed", "failed"]>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    steps: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        status: z.ZodEnum<["pending", "success", "failed", "skipped"]>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        completedAt: z.ZodOptional<z.ZodString>;
+        producedArtifactId: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        status: "pending" | "failed" | "success" | "skipped";
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+        producedArtifactId?: string | undefined;
+        error?: string | undefined;
+    }, {
+        type: string;
+        status: "pending" | "failed" | "success" | "skipped";
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+        producedArtifactId?: string | undefined;
+        error?: string | undefined;
+    }>, "many">;
+    parentArtifacts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    producedArtifacts: z.ZodArray<z.ZodString, "many">;
+    generationRange: z.ZodOptional<z.ZodObject<{
+        start: z.ZodOptional<z.ZodString>;
+        end: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        start?: string | undefined;
+        end?: string | undefined;
+    }, {
+        start?: string | undefined;
+        end?: string | undefined;
+    }>>;
+    policy: z.ZodOptional<z.ZodObject<{
+        allowNetwork: z.ZodBoolean;
+        allowMainnet: z.ZodBoolean;
+        allowExternalWallet: z.ZodBoolean;
+        requireDryRun: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        allowNetwork: boolean;
+        allowMainnet: boolean;
+        allowExternalWallet: boolean;
+        requireDryRun: boolean;
+    }, {
+        allowNetwork: boolean;
+        allowMainnet: boolean;
+        allowExternalWallet: boolean;
+        requireDryRun: boolean;
+    }>>;
+    generationId: z.ZodOptional<z.ZodString>;
+    replayResult: z.ZodOptional<z.ZodObject<{
+        verified: z.ZodBoolean;
+        stateHash: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        verified: boolean;
+        stateHash?: string | undefined;
+    }, {
+        verified: boolean;
+        stateHash?: string | undefined;
+    }>>;
+    errorEnvelope: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        redacted: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        redacted: boolean;
+    }, {
+        code: string;
+        message: string;
+        redacted: boolean;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "failed" | "running" | "completed";
+    schema: "hardkas.workflow.v1";
+    hardkasVersion: string;
+    version: "1.0.0-alpha";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    mode: "simulated" | "real" | "readonly";
+    createdAt: string;
+    steps: {
+        type: string;
+        status: "pending" | "failed" | "success" | "skipped";
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+        producedArtifactId?: string | undefined;
+        error?: string | undefined;
+    }[];
+    workflowId: string;
+    producedArtifacts: string[];
+    hashVersion?: string | number | undefined;
+    contentHash?: string | undefined;
+    lineage?: {
+        artifactId: string;
+        lineageId: string;
+        rootArtifactId: string;
+        parentArtifactId?: string | undefined;
+        sequence?: number | undefined;
+    } | undefined;
+    inputs?: Record<string, any> | undefined;
+    parentArtifacts?: string[] | undefined;
+    generationRange?: {
+        start?: string | undefined;
+        end?: string | undefined;
+    } | undefined;
+    policy?: {
+        allowNetwork: boolean;
+        allowMainnet: boolean;
+        allowExternalWallet: boolean;
+        requireDryRun: boolean;
+    } | undefined;
+    generationId?: string | undefined;
+    replayResult?: {
+        verified: boolean;
+        stateHash?: string | undefined;
+    } | undefined;
+    errorEnvelope?: {
+        code: string;
+        message: string;
+        redacted: boolean;
+    } | undefined;
+}, {
+    status: "pending" | "failed" | "running" | "completed";
+    schema: "hardkas.workflow.v1";
+    hardkasVersion: string;
+    version: "1.0.0-alpha";
+    networkId: "simulated" | "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
+    mode: "simulated" | "real" | "readonly";
+    createdAt: string;
+    steps: {
+        type: string;
+        status: "pending" | "failed" | "success" | "skipped";
+        startedAt?: string | undefined;
+        completedAt?: string | undefined;
+        producedArtifactId?: string | undefined;
+        error?: string | undefined;
+    }[];
+    workflowId: string;
+    producedArtifacts: string[];
+    hashVersion?: string | number | undefined;
+    contentHash?: string | undefined;
+    lineage?: {
+        artifactId: string;
+        lineageId: string;
+        rootArtifactId: string;
+        parentArtifactId?: string | undefined;
+        sequence?: number | undefined;
+    } | undefined;
+    inputs?: Record<string, any> | undefined;
+    parentArtifacts?: string[] | undefined;
+    generationRange?: {
+        start?: string | undefined;
+        end?: string | undefined;
+    } | undefined;
+    policy?: {
+        allowNetwork: boolean;
+        allowMainnet: boolean;
+        allowExternalWallet: boolean;
+        requireDryRun: boolean;
+    } | undefined;
+    generationId?: string | undefined;
+    replayResult?: {
+        verified: boolean;
+        stateHash?: string | undefined;
+    } | undefined;
+    errorEnvelope?: {
+        code: string;
+        message: string;
+        redacted: boolean;
+    } | undefined;
+}>;
 type TxPlan = z.infer<typeof TxPlanSchema>;
 type Snapshot = z.infer<typeof SnapshotSchema>;
 type TxReceipt = z.infer<typeof TxReceiptSchema>;
 type SignedTx = z.infer<typeof SignedTxSchema>;
 type TxTrace = z.infer<typeof TxTraceSchema>;
 type DagContext$1 = z.infer<typeof DagContextSchema>;
+type Workflow = z.infer<typeof WorkflowSchema>;
 
 interface ArtifactValidationResult {
     ok: boolean;
@@ -1133,10 +1343,10 @@ declare function validateIgraSignedTxArtifact(value: unknown): ArtifactValidatio
 declare function assertValidIgraSignedTxArtifact(value: unknown): asserts value is IgraSignedTxArtifact;
 declare function validateIgraTxReceiptArtifact(value: unknown): ArtifactValidationResult;
 declare function assertValidIgraTxReceiptArtifact(value: unknown): asserts value is IgraTxReceiptArtifact;
-declare function assertDecimalBigIntString(value: any, field: string, errors: string[]): void;
-declare function assertHexData(value: any, field: string, errors: string[]): void;
-declare function assertEvmAddress(value: any, field: string, errors: string[]): void;
-declare function assertEvmTxHash(value: any, field: string, errors: string[]): void;
+declare function assertDecimalBigIntString(value: unknown, field: string, errors: string[]): void;
+declare function assertHexData(value: unknown, field: string, errors: string[]): void;
+declare function assertEvmAddress(value: unknown, field: string, errors: string[]): void;
+declare function assertEvmTxHash(value: unknown, field: string, errors: string[]): void;
 declare function createIgraPlanId(hash: string): string;
 declare function createIgraSignedId(hash: string): string;
 declare function createIgraDeployPlanId(hash: string): string;
@@ -1386,6 +1596,41 @@ interface TxTraceArtifact extends BaseArtifact<"txTrace"> {
     dagContext?: DagContext | undefined;
 }
 
+interface WorkflowArtifact extends BaseArtifact<"workflow.v1"> {
+    workflowId: WorkflowId;
+    status: "pending" | "running" | "completed" | "failed";
+    inputs?: Record<string, any>;
+    steps: Array<{
+        type: string;
+        status: "pending" | "success" | "failed" | "skipped";
+        startedAt?: string;
+        completedAt?: string;
+        producedArtifactId?: string;
+        error?: string;
+    }>;
+    parentArtifacts?: string[];
+    producedArtifacts: string[];
+    generationRange?: {
+        start?: string;
+        end?: string;
+    };
+    policy?: {
+        allowNetwork: boolean;
+        allowMainnet: boolean;
+        allowExternalWallet: boolean;
+        requireDryRun: boolean;
+    };
+    generationId?: string;
+    replayResult?: {
+        verified: boolean;
+        stateHash?: string;
+    };
+    errorEnvelope?: {
+        code: string;
+        message: string;
+        redacted: boolean;
+    };
+}
 interface DeploymentRecord extends HardkasArtifactBase {
     schema: "hardkas.deployment.v1";
     /** Human-readable label (e.g., "initial-funding", "vault-covenant-v1") */
@@ -1444,12 +1689,12 @@ declare const CURRENT_HASH_VERSION = 3;
  * Excludes fields in SEMANTIC_EXCLUSIONS during serialization.
  * Skips keys with undefined values (matching JSON.stringify behavior).
  */
-declare function canonicalStringify(obj: any, version?: number): string;
+declare function canonicalStringify(obj: unknown, version?: number): string;
 /**
  * Calculates a SHA-256 hash of the canonical JSON representation.
  * Always excludes fields in SEMANTIC_EXCLUSIONS from the calculation.
  */
-declare function calculateContentHash(obj: any, version?: number): string;
+declare function calculateContentHash(obj: unknown, version?: number): string;
 
 interface Clock {
     now(): number;
@@ -1635,10 +1880,10 @@ declare class InvariantWatcher {
  */
 declare function migrateToCanonical(v1Artifact: any): any;
 
-declare const bigIntReplacer: (_key: string, value: any) => any;
+declare const bigIntReplacer: (_key: string, value: unknown) => unknown;
 declare function writeArtifact(filePath: string, artifact: unknown): Promise<void>;
 declare function getDefaultReceiptPath(txId: string, cwd?: string): string;
-declare function readArtifact(filePath: string): Promise<any>;
+declare function readArtifact(filePath: string): Promise<unknown>;
 declare function readTxPlanArtifact(filePath: string): Promise<TxPlan>;
 declare function readSignedTxArtifact(filePath: string): Promise<SignedTx>;
 declare function readTxReceiptArtifact(filePath: string): Promise<TxReceipt>;
@@ -1688,6 +1933,7 @@ interface CreateTxPlanArtifactOptions {
     amountSompi: bigint;
     plan: TxPlan$1;
     rpcUrl?: string;
+    ctx: RuntimeContext;
 }
 /**
  * Creates a canonical TxPlan artifact from a TxBuilder plan.
@@ -1697,11 +1943,11 @@ declare function createTxPlanArtifact(options: CreateTxPlanArtifactOptions): TxP
 /**
  * Creates a canonical simulated signed transaction artifact.
  */
-declare function createSimulatedSignedTxArtifact(plan: TxPlan, payload: string): SignedTx;
+declare function createSimulatedSignedTxArtifact(plan: TxPlan, payload: string, ctx: RuntimeContext): SignedTx;
 /**
  * Creates a canonical simulated receipt.
  */
-declare function createSimulatedTxReceipt(plan: TxPlan, txId: string, extra?: {
+declare function createSimulatedTxReceipt(plan: TxPlan, txId: string, ctx: RuntimeContext, extra?: {
     spentUtxoIds?: string[];
     createdUtxoIds?: string[];
     daaScore?: string;
@@ -1766,7 +2012,7 @@ interface ArtifactExplanation {
 /**
  * Generates a deep operational explanation of a HardKAS artifact.
  */
-declare function explainArtifact(artifact: any): Promise<ArtifactExplanation>;
+declare function explainArtifact(artifactUnknown: unknown): Promise<ArtifactExplanation>;
 
 declare function getDefaultL2ReceiptsDir(cwd?: string): string;
 declare function getL2ReceiptPath(txHash: string, options?: {
@@ -1854,4 +2100,4 @@ 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 ArtifactValidationResult, type ArtifactVerificationResult, type AssumptionLevel, type BaseArtifact, BaseArtifactSchema, BasicCorrelationInvariant, BasicLineageInvariant, CURRENT_HASH_VERSION, type Clock, type CreateTxPlanArtifactOptions, type DagContext, DagContextSchema, type DeploymentIndex, type DeploymentRecord, type DeploymentSummary, type DiffEntry, 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, NetworkInvariant, ReplayInvariant, SEMANTIC_EXCLUSIONS, SchemaInvariant, 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, assertDecimalBigIntString, assertEvmAddress, assertEvmTxHash, assertHexData, assertValidIgraSignedTxArtifact, assertValidIgraTxPlanArtifact, assertValidIgraTxReceiptArtifact, assertValidSignedTxArtifact, assertValidTxPlanArtifact, assertValidTxReceiptArtifact, bigIntReplacer, calculateContentHash, canonicalStringify, createDeploymentRecord, createIgraDeployPlanId, createIgraPlanId, createIgraSignedId, createSimulatedSignedTxArtifact, createSimulatedTxReceipt, createTxPlanArtifact, defaultClock, deleteDeployment, diffArtifacts, explainArtifact, formatSignedTxArtifact, formatTxPlanArtifact, formatTxReceiptArtifact, getBroadcastableSignedTransaction, getDefaultL2ReceiptsDir, getDefaultReceiptPath, getL2ReceiptPath, isIgraTxPlanArtifact, listDeployments, listIgraTxReceiptArtifacts, loadDeployment, loadIgraTxReceiptArtifact, migrateToCanonical, readArtifact, readSignedTxArtifact, readTxPlanArtifact, readTxReceiptArtifact, recomputeMass, saveDeployment, saveIgraTxReceiptArtifact, sortUtxosByOutpoint, txOutputFromArtifact, txOutputToArtifact, updateDeployment, updateDeploymentStatus, utxoFromArtifact, utxoToArtifact, validateArtifact, validateIgraSignedTxArtifact, validateIgraTxPlanArtifact, validateIgraTxReceiptArtifact, validateSignedTxArtifact, validateTxPlanArtifact, validateTxReceiptArtifact, verifyArtifact, verifyArtifactFile, verifyArtifactIntegrity, verifyArtifactReplay, verifyArtifactSemantics, verifyFeeSemantics, verifyLineage, writeArtifact };
+export { ARTIFACT_SCHEMAS, ARTIFACT_VERSION, AccountRefSchema, type ArtifactDiff, type ArtifactExplanation, ArtifactLineageSchema, type ArtifactLookup, type ArtifactValidationResult, type ArtifactVerificationResult, type AssumptionLevel, 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, NetworkInvariant, ReplayInvariant, SEMANTIC_EXCLUSIONS, SchemaInvariant, 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, canonicalStringify, createDeploymentRecord, createIgraDeployPlanId, createIgraPlanId, createIgraSignedId, createSimulatedSignedTxArtifact, createSimulatedTxReceipt, createTxPlanArtifact, defaultClock, deleteDeployment, diffArtifacts, explainArtifact, formatSignedTxArtifact, formatTxPlanArtifact, formatTxReceiptArtifact, getBroadcastableSignedTransaction, getDefaultL2ReceiptsDir, getDefaultReceiptPath, getL2ReceiptPath, isIgraTxPlanArtifact, listDeployments, listIgraTxReceiptArtifacts, loadDeployment, loadIgraTxReceiptArtifact, migrateToCanonical, readArtifact, readSignedTxArtifact, readTxPlanArtifact, readTxReceiptArtifact, recomputeMass, saveDeployment, saveIgraTxReceiptArtifact, sortUtxosByOutpoint, txOutputFromArtifact, txOutputToArtifact, updateDeployment, updateDeploymentStatus, utxoFromArtifact, utxoToArtifact, validateArtifact, validateIgraSignedTxArtifact, validateIgraTxPlanArtifact, validateIgraTxReceiptArtifact, validateSignedTxArtifact, validateTxPlanArtifact, validateTxReceiptArtifact, verifyArtifact, verifyArtifactFile, verifyArtifactIntegrity, verifyArtifactReplay, verifyArtifactSemantics, verifyFeeSemantics, verifyLineage, writeArtifact };

package/dist/index.js

@@ -1,5 +1,48 @@
+// package.json
+var package_default = {
+  name: "@hardkas/artifacts",
+  version: "0.6.0-alpha",
+  type: "module",
+  license: "MIT",
+  author: "Javier Rodriguez",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/KasLabDevs/HardKas.git",
+    directory: "packages/artifacts"
+  },
+  homepage: "https://github.com/KasLabDevs/HardKas/tree/main/packages/artifacts#readme",
+  bugs: {
+    url: "https://github.com/KasLabDevs/HardKas/issues"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  exports: {
+    ".": "./dist/index.js"
+  },
+  types: "./dist/index.d.ts",
+  scripts: {
+    build: "tsup src/index.ts --format esm --dts --clean",
+    dev: "tsup src/index.ts --format esm --watch --dts",
+    test: "vitest run",
+    lint: "tsc --noEmit"
+  },
+  dependencies: {
+    "@hardkas/core": "workspace:*",
+    "@hardkas/tx-builder": "workspace:*",
+    zod: "^3.24.1"
+  },
+  devDependencies: {
+    tsup: "^8.3.5",
+    typescript: "^5.6.3",
+    vitest: "^2.1.4"
+  }
+};
+
 // src/constants.ts
-var HARDKAS_VERSION = "0.5.4-alpha";
+var HARDKAS_VERSION = package_default.version;
 var ARTIFACT_SCHEMAS = {
   LOCALNET_STATE: "hardkas.localnetState.v1",
   REAL_ACCOUNT_STORE: "hardkas.realAccountStore.v1",
@@ -133,6 +176,7 @@ function createIgraDeployPlanId(hash) {
 
 // src/canonical.ts
 import { createHash } from "crypto";
+import { deterministicCompare } from "@hardkas/core";
 var SEMANTIC_EXCLUSIONS = /* @__PURE__ */ new Set([
   "contentHash",
   "artifactId",
@@ -140,6 +184,8 @@ var SEMANTIC_EXCLUSIONS = /* @__PURE__ */ new Set([
   "lineage",
   "createdAt",
   "rpcUrl",
+  "rpcHost",
+  "latencyMs",
   "indexedAt",
   "file_path",
   "file_mtime_ms",
@@ -148,7 +194,15 @@ var SEMANTIC_EXCLUSIONS = /* @__PURE__ */ new Set([
   // Exclude hash version from hash
   "parentArtifactId",
   "signedId",
-  "deployedAt"
+  "deployedAt",
+  "tracePath",
+  "receiptPath",
+  "events",
+  "status",
+  "sourceSignedId",
+  "submittedAt",
+  "confirmedAt",
+  "dagContext"
 ]);
 var CURRENT_HASH_VERSION = 3;
 function canonicalStringify(obj, version = CURRENT_HASH_VERSION) {
@@ -168,9 +222,22 @@ function canonicalStringify(obj, version = CURRENT_HASH_VERSION) {
   if (Array.isArray(obj)) {
     return "[" + obj.map((item) => canonicalStringify(item, version)).join(",") + "]";
   }
+  if (obj instanceof Map) {
+    throw new Error("Map is not canonicalizable. Use a plain object.");
+  }
+  if (obj instanceof Set) {
+    throw new Error("Set is not canonicalizable. Use an array.");
+  }
+  if (obj instanceof Date) {
+    throw new Error("Date must be serialized explicitly.");
+  }
+  const proto = Object.getPrototypeOf(obj);
+  if (proto !== Object.prototype && proto !== null) {
+    throw new Error("Non-plain object encountered in canonicalizer.");
+  }
   const sortedKeys = Object.keys(obj).filter(
     (key) => !SEMANTIC_EXCLUSIONS.has(key) && obj[key] !== void 0
-  ).sort();
+  ).sort(deterministicCompare);
   const result = sortedKeys.map((key) => {
     const value = obj[key];
     return JSON.stringify(key) + ":" + canonicalStringify(value, version);
@@ -293,6 +360,7 @@ var TxReceiptSchema = BaseArtifactSchema.extend({
   tracePath: z.string().optional(),
   rpcUrl: z.string().optional(),
   sourceSignedId: z.string().optional(),
+  errors: z.array(z.string()).optional(),
   metadata: z.any().optional()
 });
 var SignedTxSchema = BaseArtifactSchema.extend({
@@ -325,6 +393,42 @@ var TxTraceSchema = BaseArtifactSchema.extend({
   })),
   dagContext: DagContextSchema.optional()
 });
+var WorkflowSchema = BaseArtifactSchema.extend({
+  schema: z.literal("hardkas.workflow.v1"),
+  workflowId: z.string(),
+  status: z.enum(["pending", "running", "completed", "failed"]),
+  inputs: z.record(z.any()).optional(),
+  steps: z.array(z.object({
+    type: z.string(),
+    status: z.enum(["pending", "success", "failed", "skipped"]),
+    startedAt: z.string().datetime().optional(),
+    completedAt: z.string().datetime().optional(),
+    producedArtifactId: z.string().optional(),
+    error: z.string().optional()
+  })),
+  parentArtifacts: z.array(z.string()).optional(),
+  producedArtifacts: z.array(z.string()),
+  generationRange: z.object({
+    start: z.string().optional(),
+    end: z.string().optional()
+  }).optional(),
+  policy: z.object({
+    allowNetwork: z.boolean(),
+    allowMainnet: z.boolean(),
+    allowExternalWallet: z.boolean(),
+    requireDryRun: z.boolean()
+  }).optional(),
+  generationId: z.string().optional(),
+  replayResult: z.object({
+    verified: z.boolean(),
+    stateHash: z.string().optional()
+  }).optional(),
+  errorEnvelope: z.object({
+    code: z.string(),
+    message: z.string(),
+    redacted: z.boolean()
+  }).optional()
+});
 
 // src/verify.ts
 import fs from "fs";
@@ -414,8 +518,11 @@ function verifyLineage(artifact, parent, options = {}) {
   };
   const lineage = artifact.lineage;
   if (!lineage) {
-    const severity = options.strict ? "error" : "warning";
-    addIssue("MISSING_LINEAGE", "Artifact has no lineage metadata", severity);
+    const isWorkflow = artifact.schema === "hardkas.workflow.v1";
+    const severity = options.strict && !isWorkflow ? "error" : "warning";
+    if (!isWorkflow || options.strict) {
+      addIssue("MISSING_LINEAGE", "Artifact has no lineage metadata", severity);
+    }
     return {
       ok: issues.every((i) => i.severity !== "error"),
       issues
@@ -489,11 +596,18 @@ function verifyLineage(artifact, parent, options = {}) {
 var defaultClock = {
   now: () => Date.now()
 };
+function deterministicCompare2(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
 function sortUtxosByOutpoint(utxos) {
   return [...utxos].sort((a, b) => {
-    const aId = a.id || (a.outpoint ? `${a.outpoint.transactionId}:${a.outpoint.index}` : "");
-    const bId = b.id || (b.outpoint ? `${b.outpoint.transactionId}:${b.outpoint.index}` : "");
-    return aId.localeCompare(bId);
+    const aRec = a;
+    const bRec = b;
+    const aOutpoint = aRec.outpoint;
+    const bOutpoint = bRec.outpoint;
+    const aId = aRec.id || (aOutpoint ? `${aOutpoint.transactionId}:${aOutpoint.index}` : "");
+    const bId = bRec.id || (bOutpoint ? `${bOutpoint.transactionId}:${bOutpoint.index}` : "");
+    return deterministicCompare2(aId, bId);
   });
 }
 async function verifyArtifactIntegrity(artifactOrPath) {
@@ -525,6 +639,10 @@ async function verifyArtifactIntegrity(artifactOrPath) {
     result.artifactType = v.schema;
     result.version = v.version;
     result.expectedHash = v.contentHash;
+    if (v.schema === "hardkas.replayReport.v1") {
+      result.ok = true;
+      return result;
+    }
     if (!v.version || !v.schema) {
       addError("ARTIFACT_SCHEMA_MISSING", "Missing version or schema (Artifact might be v1 or legacy)");
       return result;
@@ -560,6 +678,9 @@ async function verifyArtifactIntegrity(artifactOrPath) {
       case "hardkas.signedTx":
         schema = SignedTxSchema;
         break;
+      case "hardkas.workflow.v1":
+        schema = WorkflowSchema;
+        break;
     }
     if (schema) {
       const validation = schema.safeParse(v);
@@ -577,8 +698,10 @@ async function verifyArtifactIntegrity(artifactOrPath) {
   } catch (e) {
     if (e instanceof SyntaxError) {
       addError("ARTIFACT_JSON_INVALID", `Invalid JSON: ${e.message}`);
-    } else {
+    } else if (e instanceof Error) {
       addError("ARTIFACT_ID_INVALID", `Unexpected verification error: ${e.message}`);
+    } else {
+      addError("ARTIFACT_ID_INVALID", `Unexpected verification error: ${String(e)}`);
     }
     return result;
   }
@@ -626,19 +749,19 @@ function verifyArtifactSemantics(artifact, context = {}) {
     }
   }
   const lineageAudit = verifyLineage(v, context.parent, { strict });
-  if (!lineageAudit.ok || strict && !v.lineage) {
+  if (!lineageAudit.ok || strict && !v.lineage && v.schema !== "hardkas.workflow.v1") {
     lineageAudit.issues.forEach((issue) => {
       addIssue(issue);
     });
   }
   if (strict) {
     if (!v.workflowId) addIssue({ code: "MISSING_WORKFLOW_ID", severity: "error", message: "Strict mode requires workflowId" });
-    if (!v.assumptionLevel) addIssue({ code: "MISSING_ASSUMPTION_LEVEL", severity: "error", message: "Strict mode requires assumptionLevel" });
-    if (!v.executionMode) addIssue({ code: "MISSING_EXECUTION_MODE", severity: "error", message: "Strict mode requires executionMode" });
+    if (!v.assumptionLevel && v.schema !== "hardkas.workflow.v1") addIssue({ code: "MISSING_ASSUMPTION_LEVEL", severity: "error", message: "Strict mode requires assumptionLevel" });
+    if (!v.executionMode && !v.mode) addIssue({ code: "MISSING_EXECUTION_MODE", severity: "error", message: "Strict mode requires executionMode" });
   } else {
     if (!v.workflowId) addIssue({ code: "MISSING_WORKFLOW_ID", severity: "warning", message: "Missing workflowId" });
-    if (!v.assumptionLevel) addIssue({ code: "MISSING_ASSUMPTION_LEVEL", severity: "warning", message: "Missing assumptionLevel" });
-    if (!v.executionMode) addIssue({ code: "MISSING_EXECUTION_MODE", severity: "warning", message: "Missing executionMode" });
+    if (!v.assumptionLevel && v.schema !== "hardkas.workflow.v1") addIssue({ code: "MISSING_ASSUMPTION_LEVEL", severity: "warning", message: "Missing assumptionLevel" });
+    if (!v.executionMode && !v.mode) addIssue({ code: "MISSING_EXECUTION_MODE", severity: "warning", message: "Missing executionMode" });
   }
   const networkId = context.networkId || v.networkId;
   const networkIdStr = networkId;
@@ -800,7 +923,7 @@ var ReplayInvariant = class {
 };
 
 // src/invariants/watcher.ts
-import { createEventEnvelope } from "@hardkas/core";
+import { createEventEnvelope, asWorkflowId, asCorrelationId, asNetworkId, asEventSequence } from "@hardkas/core";
 var InvariantWatcher = class {
   invariants;
   eventBus;
@@ -853,9 +976,12 @@ var InvariantWatcher = class {
     const integrityEvent = createEventEnvelope({
       kind: "integrity.violation",
       domain: "integrity",
-      workflowId: sourceEvent.workflowId,
-      correlationId: sourceEvent.correlationId,
-      networkId: sourceEvent.networkId,
+      workflowId: asWorkflowId("system-watcher"),
+      correlationId: asCorrelationId(sourceEvent.correlationId),
+      networkId: asNetworkId(sourceEvent.networkId),
+      sequenceNumber: asEventSequence(0),
+      // Root event for watcher
+      sourceSubsystem: "artifact_watcher",
       payload: {
         violationCode: violation.code,
         severity: violation.severity,
@@ -968,6 +1094,17 @@ function formatTxPlanArtifact(artifact) {
   lines.push(`Outputs:      ${artifact.outputs.length}`);
   lines.push(`Fee:          ${formatSompi(BigInt(artifact.estimatedFeeSompi))}`);
   lines.push(`Mass:         ${artifact.estimatedMass}`);
+  lines.push("");
+  lines.push("Deterministic Planning Specifications:");
+  lines.push("  Coin Selection:");
+  lines.push("    deterministic canonical ordering enabled");
+  lines.push("  Input Ordering:");
+  lines.push("    amountSompi ASC");
+  lines.push("    txid ASC");
+  lines.push("    index ASC");
+  lines.push("  Output Ordering:");
+  lines.push("    amountSompi ASC");
+  lines.push("    address ASC");
   return lines.join("\n");
 }
 function formatTxReceiptArtifact(artifact) {
@@ -1006,40 +1143,30 @@ function formatSignedTxArtifact(artifact) {
 
 // src/conversions.ts
 function utxoToArtifact(utxo) {
-  const artifact = {
+  return {
     outpoint: {
       transactionId: utxo.outpoint.transactionId,
       index: utxo.outpoint.index
     },
     address: utxo.address,
     amountSompi: utxo.amountSompi.toString(),
-    scriptPublicKey: utxo.scriptPublicKey
+    scriptPublicKey: utxo.scriptPublicKey,
+    ...utxo.blockDaaScore !== void 0 ? { blockDaaScore: utxo.blockDaaScore.toString() } : {},
+    ...utxo.isCoinbase !== void 0 ? { isCoinbase: utxo.isCoinbase } : {}
   };
-  if (utxo.blockDaaScore !== void 0) {
-    artifact.blockDaaScore = utxo.blockDaaScore.toString();
-  }
-  if (utxo.isCoinbase !== void 0) {
-    artifact.isCoinbase = utxo.isCoinbase;
-  }
-  return artifact;
 }
 function utxoFromArtifact(artifact) {
-  const utxo = {
+  return {
     outpoint: {
       transactionId: artifact.outpoint.transactionId,
       index: artifact.outpoint.index
     },
     address: artifact.address,
     amountSompi: safeParseBigInt(artifact.amountSompi, "UtxoArtifact.amountSompi"),
-    scriptPublicKey: artifact.scriptPublicKey
+    scriptPublicKey: artifact.scriptPublicKey,
+    ...artifact.blockDaaScore !== void 0 ? { blockDaaScore: safeParseBigInt(artifact.blockDaaScore, "UtxoArtifact.blockDaaScore") } : {},
+    ...artifact.isCoinbase !== void 0 ? { isCoinbase: artifact.isCoinbase } : {}
   };
-  if (artifact.blockDaaScore !== void 0) {
-    utxo.blockDaaScore = safeParseBigInt(artifact.blockDaaScore, "UtxoArtifact.blockDaaScore");
-  }
-  if (artifact.isCoinbase !== void 0) {
-    utxo.isCoinbase = artifact.isCoinbase;
-  }
-  return utxo;
 }
 function txOutputToArtifact(output) {
   return {
@@ -1068,7 +1195,7 @@ function createTxPlanArtifact(options) {
     hardkasVersion: HARDKAS_VERSION,
     version: ARTIFACT_VERSION,
     hashVersion: CURRENT_HASH_VERSION,
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    createdAt: new Date(options.ctx.clock.now()).toISOString(),
     networkId: options.networkId,
     mode: options.mode,
     from: {
@@ -1109,13 +1236,13 @@ function createTxPlanArtifact(options) {
 }
 
 // src/signed-tx.ts
-function createSimulatedSignedTxArtifact(plan, payload) {
+function createSimulatedSignedTxArtifact(plan, payload, ctx) {
   const artifact = {
     schema: "hardkas.signedTx",
     hardkasVersion: HARDKAS_VERSION,
     version: ARTIFACT_VERSION,
     hashVersion: CURRENT_HASH_VERSION,
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    createdAt: new Date(ctx.clock.now()).toISOString(),
     status: "signed",
     sourcePlanId: plan.planId,
     networkId: plan.networkId,
@@ -1134,13 +1261,13 @@ function createSimulatedSignedTxArtifact(plan, payload) {
   artifact.contentHash = hash;
   return artifact;
 }
-function createSimulatedTxReceipt(plan, txId, extra) {
+function createSimulatedTxReceipt(plan, txId, ctx, extra) {
   const artifact = {
     schema: "hardkas.txReceipt",
     hardkasVersion: HARDKAS_VERSION,
     version: ARTIFACT_VERSION,
     hashVersion: CURRENT_HASH_VERSION,
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    createdAt: new Date(ctx.clock.now()).toISOString(),
     txId,
     status: "accepted",
     mode: "simulated",
@@ -1203,7 +1330,8 @@ function validateSignedTxArtifact(value) {
   if (!v.signedTransaction) {
     errors.push("Missing signedTransaction object");
   } else {
-    if (!["kaspa-sdk", "hex", "simulated", "unknown"].includes(v.signedTransaction.format)) {
+    const st = v.signedTransaction;
+    if (!["kaspa-sdk", "hex", "simulated", "unknown"].includes(st.format)) {
       errors.push("Invalid signedTransaction.format");
     }
   }
@@ -1265,7 +1393,8 @@ function assertDecimalBigIntString2(value, field, errors) {
 }
 
 // src/explain.ts
-async function explainArtifact(artifact) {
+async function explainArtifact(artifactUnknown) {
+  const artifact = artifactUnknown;
   const schema = artifact.schema || "unknown";
   const type = schema.split(".")[1] || "unknown";
   const integrity = await verifyArtifactIntegrity(artifact);
@@ -1336,6 +1465,7 @@ async function explainArtifact(artifact) {
 // src/igra-io.ts
 import fs3 from "fs/promises";
 import path2 from "path";
+import { deterministicCompare as deterministicCompare3 } from "@hardkas/core";
 function getDefaultL2ReceiptsDir(cwd = process.cwd()) {
   return path2.join(cwd, ".hardkas", "l2-receipts");
 }
@@ -1371,7 +1501,7 @@ async function listIgraTxReceiptArtifacts(options) {
       } catch (e) {
       }
     }
-    return receipts.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    return receipts.sort((a, b) => deterministicCompare3(b.createdAt, a.createdAt));
   } catch (e) {
     if (e.code === "ENOENT") return [];
     throw e;
@@ -1440,7 +1570,7 @@ function isPrimitive(val) {
 
 // src/deployment.ts
 function createDeploymentRecord(opts) {
-  const record = {
+  const recordDraft = {
     schema: "hardkas.deployment.v1",
     label: opts.label,
     networkId: opts.networkId,
@@ -1449,28 +1579,33 @@ function createDeploymentRecord(opts) {
     hardkasVersion: HARDKAS_VERSION,
     version: ARTIFACT_VERSION,
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    mode: "real"
+    mode: "real",
+    ...opts.txId ? { txId: opts.txId } : {},
+    ...opts.planArtifactId ? { planArtifactId: opts.planArtifactId } : {},
+    ...opts.receiptArtifactId ? { receiptArtifactId: opts.receiptArtifactId } : {},
+    ...opts.deployedAddresses ? { deployedAddresses: opts.deployedAddresses } : {},
+    ...opts.deployer ? { deployer: opts.deployer } : {},
+    ...opts.payloadHash ? { payloadHash: opts.payloadHash } : {},
+    ...opts.notes ? { notes: opts.notes } : {}
+  };
+  const contentHash = calculateContentHash(recordDraft, CURRENT_HASH_VERSION);
+  return {
+    ...recordDraft,
+    contentHash
   };
-  if (opts.txId) record.txId = opts.txId;
-  if (opts.planArtifactId) record.planArtifactId = opts.planArtifactId;
-  if (opts.receiptArtifactId) record.receiptArtifactId = opts.receiptArtifactId;
-  if (opts.deployedAddresses) record.deployedAddresses = opts.deployedAddresses;
-  if (opts.deployer) record.deployer = opts.deployer;
-  if (opts.payloadHash) record.payloadHash = opts.payloadHash;
-  if (opts.notes) record.notes = opts.notes;
-  record.contentHash = calculateContentHash(record, CURRENT_HASH_VERSION);
-  return record;
 }
 function updateDeploymentStatus(record, newStatus, txId) {
-  const updated = {
+  const updatedDraft = {
     ...record,
     status: newStatus,
-    deployedAt: (/* @__PURE__ */ new Date()).toISOString()
+    deployedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...txId ? { txId } : {}
+  };
+  const contentHash = calculateContentHash(updatedDraft, CURRENT_HASH_VERSION);
+  return {
+    ...updatedDraft,
+    contentHash
   };
-  if (txId) updated.txId = txId;
-  delete updated.contentHash;
-  updated.contentHash = calculateContentHash(updated, CURRENT_HASH_VERSION);
-  return updated;
 }
 
 // src/deployment-store.ts
@@ -1562,6 +1697,7 @@ export {
   TxPlanSchema,
   TxReceiptSchema,
   TxTraceSchema,
+  WorkflowSchema,
   assertDecimalBigIntString,
   assertEvmAddress,
   assertEvmTxHash,

package/package.json

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