@hardkas/core 0.8.20-alpha → 0.9.0-alpha

package/dist/index.d.ts

@@ -793,7 +793,7 @@ declare class AppendCoordinator {
     };
 }
 
-declare const CURRENT_RUNTIME_VERSION = "0.8.20-alpha";
+declare const CURRENT_RUNTIME_VERSION = "0.9.0-alpha";
 declare const MIN_SUPPORTED_VERSION = "0.5.0-alpha";
 interface MigrationStatus {
     needsMigration: boolean;
@@ -808,16 +808,39 @@ declare class MigrationManager {
     private static compareSemver;
 }
 
+/**
+ * Creates a Kaspa standard P2SH locking script (BIP16-like but with Blake2b).
+ * Version is always 0 for standard script hashes in Kaspa currently,
+ * although future VM versions might use 8.
+ *
+ * @param redeemScriptHex The compiled script hex string
+ */
+declare function createKaspaP2shBlake2bLock(redeemScriptHex: string): {
+    scriptPublicKeyVersion: number;
+    lockingScriptHex: string;
+    redeemScriptHash: string;
+    redeemScriptHex: string;
+};
+/**
+ * Creates a valid Kaspa v2.0.0 signature script for a P2SH UTXO.
+ * The signature script must be push-only. It pushes any arguments,
+ * followed by the raw redeem script itself.
+ *
+ * @param args Array of hex strings representing the arguments to push
+ * @param redeemScriptHex The compiled script hex string
+ */
+declare function createPushOnlySignatureScript(args: string[], redeemScriptHex: string): string;
+
 declare const SOMPI_PER_KAS = 100000000n;
 declare const kaspaNetworkIdSchema: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet", "simulated", "igra"]>;
 type NetworkId = Brand<z.infer<typeof kaspaNetworkIdSchema>, "NetworkId">;
 declare const executionModeSchema: z.ZodEnum<["simulated", "real", "readonly"]>;
 type ExecutionMode = z.infer<typeof executionModeSchema>;
-declare const artifactTypeSchema: z.ZodEnum<["txPlan", "signedTx", "txReceipt", "txTrace", "snapshot", "workflow.v1", "policy.v1", "networkProfile.v1", "assumption.v1", "migrationReceipt.v1"]>;
+declare const artifactTypeSchema: z.ZodEnum<["txPlan", "signedTx", "txReceipt", "txTrace", "snapshot", "workflow.v1", "policy.v1", "networkProfile.v1", "assumption.v1", "migrationReceipt.v1", "silver.compile", "silver.test", "silver.spendPlan", "silver.deployPlan", "silver.deploy", "silver.spendReceipt", "silver.deploySimulation", "silver.spendSimulation"]>;
 type ArtifactType = z.infer<typeof artifactTypeSchema>;
 declare const NetworkIdSchema: z.ZodEnum<["mainnet", "testnet-10", "testnet-11", "testnet-12", "simnet", "simnet-1", "devnet", "simulated", "igra"]>;
 declare const ExecutionModeSchema: z.ZodEnum<["simulated", "real", "readonly"]>;
-declare const ArtifactTypeSchema: z.ZodEnum<["txPlan", "signedTx", "txReceipt", "txTrace", "snapshot", "workflow.v1", "policy.v1", "networkProfile.v1", "assumption.v1", "migrationReceipt.v1"]>;
+declare const ArtifactTypeSchema: z.ZodEnum<["txPlan", "signedTx", "txReceipt", "txTrace", "snapshot", "workflow.v1", "policy.v1", "networkProfile.v1", "assumption.v1", "migrationReceipt.v1", "silver.compile", "silver.test", "silver.spendPlan", "silver.deployPlan", "silver.deploy", "silver.spendReceipt", "silver.deploySimulation", "silver.spendSimulation"]>;
 declare const hardkasConfigSchema: z.ZodObject<{
     project: z.ZodObject<{
         name: z.ZodString;
@@ -898,4 +921,4 @@ declare function parseHardkasConfig(input: unknown): HardkasConfig;
 declare function parseKasToSompi(input: string): bigint;
 declare function formatSompi(amountSompi: bigint): string;
 
-export { type AcquireLockArgs, type AnomalyEvent, type AnomalyType, AppendCoordinator, type ArtifactId, type ArtifactStatus, type ArtifactType, ArtifactTypeSchema, type Brand, type Branded, CURRENT_RUNTIME_VERSION, type ContentHash, type CoreEvent, type CoreEventListener, type CorrelationId, type CorruptionCode, type CorruptionIssue, type CorruptionSeverity, type CreateSnapshotOptions, type DaaScore, type DeterministicClock, type DeterministicDiff, type DeterministicRandom, EnvironmentTelemetry, type EventDomain, type EventEnvelope, type EventId, type EventKind, type EventPayloadByKind, type EventSequence, type ExecutionMode, ExecutionModeSchema, type HardkasConfig, HardkasError, type IdProvider, type IntegrityStatus, type InvariantDomain, type InvariantSeverity, InvariantViolationError, type KaspaAddress, LOCK_ORDER, type LayeredReplayDiff, type LineageId, type LockHandle, type LockMetadata, MIN_SUPPORTED_VERSION, MigrationManager, type MigrationResult, type MigrationStatus, type NetworkId, NetworkIdSchema, type ReplayContext, type RotationResult, type RpcEndpointId, type RuntimeContext, type RuntimeNoiseDiff, SOMPI_PER_KAS, type SchemaVersion, type SemanticDriftReport, type SemanticIdentity, type Severity, type SnapshotManifest, type StampedEvent, type StateProvenance, type StructuralDiff, TelemetryManager, TelemetryRotator, type TelemetrySubsystem, type TxId, type UnknownEventPayload, type WorkflowId, type WriteFileAtomicOptions, acquireLock, artifactTypeSchema, asArtifactId, asContentHash, asCorrelationId, asDaaScore, asEventId, asEventSequence, asKaspaAddress, asLineageId, asNetworkId, asRpcEndpointId, asTxId, asWorkflowId, assertNoSemanticDrift, attachLedgerAppender, classifyArtifactStatus, clearLock, comparePrePostMigrationLineage, coreEvents, createEventEnvelope, createSnapshot, detectSemanticDrift, deterministicCompare, diffReplays, executionModeSchema, formatCorruptionIssue, formatSompi, getTelemetry, globalTelemetry, hardkasConfigSchema, isProcessAlive, kaspaNetworkIdSchema, listLocks, maskSecrets, migrateArtifact, parseHardkasConfig, parseKasToSompi, readSnapshotManifest, redactSecret, resolveCanonicalArtifact, resolveLineage, systemRuntimeContext, telemetryContextStorage, validateEventEnvelope, validateStatusTransition, verifyArtifactIntegrity, verifyCapabilityBoundary, verifyMigrationIntegrity, verifyProjectionFreshness, verifyReplay, withLock, withLocks, writeFileAtomic, writeFileAtomicSync };
+export { type AcquireLockArgs, type AnomalyEvent, type AnomalyType, AppendCoordinator, type ArtifactId, type ArtifactStatus, type ArtifactType, ArtifactTypeSchema, type Brand, type Branded, CURRENT_RUNTIME_VERSION, type ContentHash, type CoreEvent, type CoreEventListener, type CorrelationId, type CorruptionCode, type CorruptionIssue, type CorruptionSeverity, type CreateSnapshotOptions, type DaaScore, type DeterministicClock, type DeterministicDiff, type DeterministicRandom, EnvironmentTelemetry, type EventDomain, type EventEnvelope, type EventId, type EventKind, type EventPayloadByKind, type EventSequence, type ExecutionMode, ExecutionModeSchema, type HardkasConfig, HardkasError, type IdProvider, type IntegrityStatus, type InvariantDomain, type InvariantSeverity, InvariantViolationError, type KaspaAddress, LOCK_ORDER, type LayeredReplayDiff, type LineageId, type LockHandle, type LockMetadata, MIN_SUPPORTED_VERSION, MigrationManager, type MigrationResult, type MigrationStatus, type NetworkId, NetworkIdSchema, type ReplayContext, type RotationResult, type RpcEndpointId, type RuntimeContext, type RuntimeNoiseDiff, SOMPI_PER_KAS, type SchemaVersion, type SemanticDriftReport, type SemanticIdentity, type Severity, type SnapshotManifest, type StampedEvent, type StateProvenance, type StructuralDiff, TelemetryManager, TelemetryRotator, type TelemetrySubsystem, type TxId, type UnknownEventPayload, type WorkflowId, type WriteFileAtomicOptions, acquireLock, artifactTypeSchema, asArtifactId, asContentHash, asCorrelationId, asDaaScore, asEventId, asEventSequence, asKaspaAddress, asLineageId, asNetworkId, asRpcEndpointId, asTxId, asWorkflowId, assertNoSemanticDrift, attachLedgerAppender, classifyArtifactStatus, clearLock, comparePrePostMigrationLineage, coreEvents, createEventEnvelope, createKaspaP2shBlake2bLock, createPushOnlySignatureScript, createSnapshot, detectSemanticDrift, deterministicCompare, diffReplays, executionModeSchema, formatCorruptionIssue, formatSompi, getTelemetry, globalTelemetry, hardkasConfigSchema, isProcessAlive, kaspaNetworkIdSchema, listLocks, maskSecrets, migrateArtifact, parseHardkasConfig, parseKasToSompi, readSnapshotManifest, redactSecret, resolveCanonicalArtifact, resolveLineage, systemRuntimeContext, telemetryContextStorage, validateEventEnvelope, validateStatusTransition, verifyArtifactIntegrity, verifyCapabilityBoundary, verifyMigrationIntegrity, verifyProjectionFreshness, verifyReplay, withLock, withLocks, writeFileAtomic, writeFileAtomicSync };

package/dist/index.js

@@ -956,7 +956,7 @@ async function createSnapshot(options) {
   const manifest = {
     snapshotVersion: 1,
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    hardkasVersion: "0.8.20-alpha",
+    hardkasVersion: "0.9.0-alpha",
     stateAuthority: "filesystem",
     projectionAuthority: "sqlite",
     deterministicScope,
@@ -1205,7 +1205,7 @@ Resolution Command: ${report.exactReplayCommand}`
 // src/migrations.ts
 import fs6 from "fs";
 import path8 from "path";
-var CURRENT_RUNTIME_VERSION = "0.8.20-alpha";
+var CURRENT_RUNTIME_VERSION = "0.9.0-alpha";
 var MIN_SUPPORTED_VERSION = "0.5.0-alpha";
 var MigrationManager = class {
   static checkVersion(rootDir) {
@@ -1299,6 +1299,64 @@ var MigrationManager = class {
   }
 };
 
+// src/silver.ts
+import { blake2b } from "@noble/hashes/blake2.js";
+function createKaspaP2shBlake2bLock(redeemScriptHex) {
+  const scriptBytes = Buffer.from(redeemScriptHex, "hex");
+  const redeemScriptHashBytes = blake2b(scriptBytes, { dkLen: 32 });
+  const redeemScriptHash = Buffer.from(redeemScriptHashBytes).toString("hex");
+  const lockingScriptHex = `aa20${redeemScriptHash}87`;
+  return {
+    scriptPublicKeyVersion: 0,
+    lockingScriptHex,
+    redeemScriptHash,
+    redeemScriptHex
+  };
+}
+function getPushDataPrefix(byteCount) {
+  if (byteCount < 0) {
+    throw new HardkasError("SILVERSCRIPT_INVALID_PUSHDATA", "Negative byte count");
+  }
+  if (byteCount === 0) {
+    return "00";
+  }
+  if (byteCount <= 75) {
+    return byteCount.toString(16).padStart(2, "0");
+  }
+  if (byteCount <= 255) {
+    return `4c${byteCount.toString(16).padStart(2, "0")}`;
+  }
+  if (byteCount <= 65535) {
+    const hex2 = byteCount.toString(16).padStart(4, "0");
+    const le2 = hex2.substring(2, 4) + hex2.substring(0, 2);
+    return `4d${le2}`;
+  }
+  const hex = byteCount.toString(16).padStart(8, "0");
+  const le = hex.substring(6, 8) + hex.substring(4, 6) + hex.substring(2, 4) + hex.substring(0, 2);
+  return `4e${le}`;
+}
+function createPushOnlySignatureScript(args, redeemScriptHex) {
+  if (!redeemScriptHex || redeemScriptHex.trim() === "") {
+    throw new HardkasError("SILVERSCRIPT_INVALID_REDEEM_SCRIPT", "Redeem script cannot be empty");
+  }
+  if (!/^[0-9a-fA-F]*$/.test(redeemScriptHex) || redeemScriptHex.length % 2 !== 0) {
+    throw new HardkasError("SILVERSCRIPT_INVALID_REDEEM_SCRIPT", "Redeem script must be valid hex");
+  }
+  let signatureScript = "";
+  for (const argHex of args) {
+    if (!/^[0-9a-fA-F]*$/.test(argHex) || argHex.length % 2 !== 0) {
+      throw new HardkasError("SILVERSCRIPT_SIGNATURE_SCRIPT_NOT_PUSH_ONLY", `Argument must be valid hex: ${argHex}`);
+    }
+    const byteCount = argHex.length / 2;
+    const prefix = getPushDataPrefix(byteCount);
+    signatureScript += prefix + argHex;
+  }
+  const redeemScriptByteCount = redeemScriptHex.length / 2;
+  const redeemPrefix = getPushDataPrefix(redeemScriptByteCount);
+  signatureScript += redeemPrefix + redeemScriptHex;
+  return signatureScript;
+}
+
 // src/index.ts
 var SOMPI_PER_KAS = 100000000n;
 var kaspaNetworkIdSchema = z.enum([
@@ -1323,7 +1381,15 @@ var artifactTypeSchema = z.enum([
   "policy.v1",
   "networkProfile.v1",
   "assumption.v1",
-  "migrationReceipt.v1"
+  "migrationReceipt.v1",
+  "silver.compile",
+  "silver.test",
+  "silver.spendPlan",
+  "silver.deployPlan",
+  "silver.deploy",
+  "silver.spendReceipt",
+  "silver.deploySimulation",
+  "silver.spendSimulation"
 ]);
 var NetworkIdSchema = kaspaNetworkIdSchema;
 var ExecutionModeSchema = executionModeSchema;
@@ -1429,6 +1495,8 @@ export {
   comparePrePostMigrationLineage,
   coreEvents,
   createEventEnvelope,
+  createKaspaP2shBlake2bLock,
+  createPushOnlySignatureScript,
   createSnapshot,
   detectSemanticDrift,
   deterministicCompare,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/core",
-  "version": "0.8.20-alpha",
+  "version": "0.9.0-alpha",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,6 +12,7 @@
     }
   },
   "dependencies": {
+    "@noble/hashes": "^2.2.0",
     "pino": "^9.5.0",
     "zod": "^3.24.1"
   },