@hardkas/artifacts 0.2.1-alpha → 0.2.2-alpha.1

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { ArtifactType, NetworkId, ExecutionMode, ContentHash, WorkflowId, Artifa
 import { z } from 'zod';
 import { TxOutput, Utxo, TxPlan as TxPlan$1 } from '@hardkas/tx-builder';
 
-declare const HARDKAS_VERSION = "0.2.0-alpha";
+declare const HARDKAS_VERSION = "0.2.2-alpha.1";
 declare const ARTIFACT_SCHEMAS: {
     readonly LOCALNET_STATE: "hardkas.localnetState.v1";
     readonly REAL_ACCOUNT_STORE: "hardkas.realAccountStore.v1";
@@ -42,6 +42,7 @@ declare const BaseArtifactSchema: z.ZodObject<{
     schema: z.ZodString;
     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"]>;
     mode: z.ZodEnum<["simulated", "real", "readonly"]>;
     contentHash: z.ZodOptional<z.ZodString>;
@@ -72,6 +73,7 @@ declare const BaseArtifactSchema: z.ZodObject<{
     networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -87,6 +89,7 @@ declare const BaseArtifactSchema: z.ZodObject<{
     networkId: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "simnet" | "simnet-1" | "devnet";
     mode: "simulated" | "real" | "readonly";
     createdAt: string;
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -112,6 +115,7 @@ declare const AccountRefSchema: z.ZodObject<{
 declare const TxPlanSchema: z.ZodObject<{
     hardkasVersion: z.ZodString;
     version: z.ZodLiteral<"1.0.0-alpha">;
+    hashVersion: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     contentHash: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     lineage: z.ZodOptional<z.ZodObject<{
@@ -245,6 +249,7 @@ declare const TxPlanSchema: z.ZodObject<{
         address: string;
         amountSompi: string;
     }[];
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -290,6 +295,7 @@ declare const TxPlanSchema: z.ZodObject<{
         address: string;
         amountSompi: string;
     }[];
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -374,6 +380,7 @@ declare const LocalnetUtxoSchemaV2: z.ZodObject<{
 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"]>;
     mode: z.ZodEnum<["simulated", "real", "readonly"]>;
     contentHash: z.ZodOptional<z.ZodString>;
@@ -452,6 +459,7 @@ declare const SnapshotSchema: z.ZodObject<{
         spent: boolean;
         createdAtDaaScore: string;
     }[];
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -483,6 +491,7 @@ declare const SnapshotSchema: z.ZodObject<{
         spent: boolean;
         createdAtDaaScore: string;
     }[];
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -499,6 +508,7 @@ declare const SnapshotSchema: z.ZodObject<{
 declare const TxReceiptSchema: z.ZodObject<{
     hardkasVersion: z.ZodString;
     version: z.ZodLiteral<"1.0.0-alpha">;
+    hashVersion: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     contentHash: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     lineage: z.ZodOptional<z.ZodObject<{
@@ -636,6 +646,7 @@ declare const TxReceiptSchema: z.ZodObject<{
     amountSompi: string;
     txId: string;
     feeSompi: string;
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -692,6 +703,7 @@ declare const TxReceiptSchema: z.ZodObject<{
     amountSompi: string;
     txId: string;
     feeSompi: string;
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -731,6 +743,7 @@ declare const TxReceiptSchema: z.ZodObject<{
 declare const SignedTxSchema: z.ZodObject<{
     hardkasVersion: z.ZodString;
     version: z.ZodLiteral<"1.0.0-alpha">;
+    hashVersion: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     contentHash: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     lineage: z.ZodOptional<z.ZodObject<{
@@ -823,6 +836,7 @@ declare const SignedTxSchema: z.ZodObject<{
         format: string;
         payload: string;
     };
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -858,6 +872,7 @@ declare const SignedTxSchema: z.ZodObject<{
         format: string;
         payload: string;
     };
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -872,6 +887,7 @@ declare const SignedTxSchema: z.ZodObject<{
 declare const TxTraceSchema: z.ZodObject<{
     hardkasVersion: z.ZodString;
     version: z.ZodLiteral<"1.0.0-alpha">;
+    hashVersion: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     contentHash: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodString;
     lineage: z.ZodOptional<z.ZodObject<{
@@ -976,6 +992,7 @@ declare const TxTraceSchema: z.ZodObject<{
         timestamp: string;
         details?: any;
     }[];
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -1012,6 +1029,7 @@ declare const TxTraceSchema: z.ZodObject<{
         timestamp: string;
         details?: any;
     }[];
+    hashVersion?: string | number | undefined;
     contentHash?: string | undefined;
     lineage?: {
         artifactId: string;
@@ -1118,15 +1136,16 @@ declare function assertDecimalBigIntString(value: any, field: string, errors: st
 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 createIgraPlanId(): string;
-declare function createIgraSignedId(): string;
-declare function createIgraDeployPlanId(): string;
+declare function createIgraPlanId(hash: string): string;
+declare function createIgraSignedId(hash: string): string;
+declare function createIgraDeployPlanId(hash: string): string;
 
 type AssumptionLevel = "dev" | "trusted" | "network-observed";
 interface HardkasArtifactBase {
     schema: HardkasArtifactSchema;
     hardkasVersion: string;
     version: string;
+    hashVersion?: number | string;
     networkId: NetworkId;
     mode: ExecutionMode;
     createdAt: string;
@@ -1135,6 +1154,7 @@ interface BaseArtifact<T extends ArtifactType> {
     schema: `hardkas.${T}`;
     hardkasVersion: string;
     version: string;
+    hashVersion?: number | string;
     networkId: NetworkId;
     mode: ExecutionMode;
     createdAt: string;

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/constants.ts
-var HARDKAS_VERSION = "0.2.0-alpha";
+var HARDKAS_VERSION = "0.2.2-alpha.1";
 var ARTIFACT_SCHEMAS = {
   LOCALNET_STATE: "hardkas.localnetState.v1",
   REAL_ACCOUNT_STORE: "hardkas.realAccountStore.v1",
@@ -121,14 +121,14 @@ function assertEvmTxHash(value, field, errors) {
     errors.push(`Invalid ${field}: must be a 0x-prefixed 64-character EVM transaction hash`);
   }
 }
-function createIgraPlanId() {
-  return `igra-plan-${Date.now()}-${Math.floor(Math.random() * 1e3)}`;
+function createIgraPlanId(hash) {
+  return `igra-plan-${hash.slice(0, 16)}`;
 }
-function createIgraSignedId() {
-  return `igra-signed-${Date.now()}-${Math.floor(Math.random() * 1e3)}`;
+function createIgraSignedId(hash) {
+  return `igra-signed-${hash.slice(0, 16)}`;
 }
-function createIgraDeployPlanId() {
-  return `igradeploy_${Date.now()}_${Math.floor(Math.random() * 1e3)}`;
+function createIgraDeployPlanId(hash) {
+  return `igradeploy_${hash.slice(0, 16)}`;
 }
 
 // src/canonical.ts
@@ -143,8 +143,23 @@ function canonicalStringify(obj) {
   if (Array.isArray(obj)) {
     return "[" + obj.map((item) => canonicalStringify(item)).join(",") + "]";
   }
+  const SEMANTIC_EXCLUSIONS = /* @__PURE__ */ new Set([
+    "contentHash",
+    "artifactId",
+    "planId",
+    "lineage",
+    "createdAt",
+    "rpcUrl",
+    "indexedAt",
+    "file_path",
+    "file_mtime_ms",
+    "hardkasVersion",
+    "version",
+    "parentArtifactId",
+    "signedId"
+  ]);
   const sortedKeys = Object.keys(obj).filter(
-    (key) => key !== "contentHash" && key !== "artifactId" && key !== "lineage" && obj[key] !== void 0
+    (key) => !SEMANTIC_EXCLUSIONS.has(key) && obj[key] !== void 0
   ).sort();
   const result = sortedKeys.map((key) => {
     const value = obj[key];
@@ -172,6 +187,7 @@ var BaseArtifactSchema = z.object({
   schema: z.string(),
   hardkasVersion: z.string(),
   version: z.literal(ARTIFACT_VERSION),
+  hashVersion: z.union([z.number(), z.string()]).optional(),
   networkId: kaspaNetworkIdSchema,
   mode: executionModeSchema,
   contentHash: z.string().optional(),
@@ -1048,7 +1064,6 @@ function createTxPlanArtifact(options) {
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     networkId: options.networkId,
     mode: options.mode,
-    planId: `plan-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
     from: {
       address: options.from.address,
       accountName: options.from.accountName,
@@ -1080,7 +1095,9 @@ function createTxPlanArtifact(options) {
       amountSompi: options.plan.change.amountSompi.toString()
     };
   }
-  artifact.contentHash = calculateContentHash(artifact);
+  const hash = calculateContentHash(artifact);
+  artifact.planId = `plan-${hash.slice(0, 16)}`;
+  artifact.contentHash = hash;
   return artifact;
 }
 
@@ -1090,22 +1107,24 @@ function createSimulatedSignedTxArtifact(plan, payload) {
     schema: "hardkas.signedTx",
     hardkasVersion: HARDKAS_VERSION,
     version: ARTIFACT_VERSION,
+    hashVersion: 1,
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     status: "signed",
-    signedId: `signed-${Date.now()}`,
     sourcePlanId: plan.planId,
     networkId: plan.networkId,
     mode: plan.mode,
     from: { address: plan.from.address },
     to: { address: plan.to.address },
     amountSompi: plan.amountSompi,
-    txId: `simulated-${plan.planId}-${Date.now()}`,
     signedTransaction: {
       format: "simulated",
       payload
     }
   };
-  artifact.contentHash = calculateContentHash(artifact);
+  const hash = calculateContentHash(artifact);
+  artifact.signedId = `signed-${hash.slice(0, 16)}`;
+  artifact.txId = `simulated-${plan.planId}-${hash.slice(0, 8)}`;
+  artifact.contentHash = hash;
   return artifact;
 }
 function createSimulatedTxReceipt(plan, txId, extra) {
@@ -1113,6 +1132,7 @@ function createSimulatedTxReceipt(plan, txId, extra) {
     schema: "hardkas.txReceipt",
     hardkasVersion: HARDKAS_VERSION,
     version: ARTIFACT_VERSION,
+    hashVersion: 1,
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     txId,
     status: "accepted",
@@ -1127,7 +1147,8 @@ function createSimulatedTxReceipt(plan, txId, extra) {
     createdUtxoIds: extra?.createdUtxoIds,
     daaScore: extra?.daaScore
   };
-  artifact.contentHash = calculateContentHash(artifact);
+  const hash = calculateContentHash(artifact);
+  artifact.contentHash = hash;
   return artifact;
 }
 function getBroadcastableSignedTransaction(artifact) {

package/package.json

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