@hardkas/cli 0.1.0

package/dist/replay-verify-runner-WBK2FCWC.js

@@ -0,0 +1,37 @@
+import {
+  UI
+} from "./chunk-M54KNJEH.js";
+
+// src/runners/replay-verify-runner.ts
+import { readTxPlanArtifact, readTxReceiptArtifact } from "@hardkas/artifacts";
+import { loadOrCreateLocalnetState, verifyReplay } from "@hardkas/localnet";
+import path from "path";
+async function runReplayVerify(options) {
+  const artifactDir = path.resolve(process.cwd(), options.path);
+  const planPath = path.join(artifactDir, "tx-plan.json");
+  const receiptPath = path.join(artifactDir, "tx-receipt.json");
+  UI.header(`Replay Verification: ${path.basename(artifactDir)}`);
+  try {
+    const plan = await readTxPlanArtifact(planPath);
+    const receipt = await readTxReceiptArtifact(receiptPath);
+    const state = await loadOrCreateLocalnetState();
+    const report = verifyReplay(state, plan, receipt);
+    if (report.invariantsOk) {
+      UI.success("Replay Verified Successfully");
+      console.log(`  Plan Hash:    \u2713 MATCH`);
+      console.log(`  State Hashes: \u2713 MATCH`);
+      console.log(`  Mass/Fees:    \u2713 MATCH`);
+      console.log(`  Status:       \u2713 MATCH`);
+    } else {
+      UI.error("Replay Verification Failed");
+      report.errors.forEach((err) => console.log(`  [!] ${err}`));
+      process.exitCode = 1;
+    }
+  } catch (e) {
+    UI.error(`Failed to perform replay verification: ${e.message}`);
+    process.exitCode = 1;
+  }
+}
+export {
+  runReplayVerify
+};

package/dist/rpc-doctor-runner-RKGKFGMM.js

@@ -0,0 +1,74 @@
+import {
+  UI
+} from "./chunk-M54KNJEH.js";
+
+// src/runners/rpc-doctor-runner.ts
+import { KaspaJsonRpcClient } from "@hardkas/kaspa-rpc";
+import { loadHardkasConfig } from "@hardkas/config";
+async function runRpcDoctor(options) {
+  let endpoints = options.endpoints || [];
+  if (endpoints.length === 0) {
+    const loaded = await loadHardkasConfig(options.config ? { configPath: options.config } : {});
+    const networks = loaded.config.networks || {};
+    const defaultNetwork = loaded.config.defaultNetwork || "simnet";
+    const network = networks[defaultNetwork];
+    if (network?.rpcUrl) {
+      endpoints = [network.rpcUrl];
+    } else {
+      endpoints = ["http://127.0.0.1:18210"];
+    }
+  }
+  UI.header("HardKAS RPC Doctor");
+  console.log(`Auditing ${endpoints.length} endpoint(s)...
+`);
+  const results = [];
+  for (const url of endpoints) {
+    const client = new KaspaJsonRpcClient({ url, timeoutMs: 5e3 });
+    const health = await client.healthCheck();
+    results.push({ url, health });
+    const statusIcon = health.status === "healthy" ? "\u2713" : health.status === "stale" ? "\u26A0" : "\u2717";
+    console.log("\u250C\u2500\u2500 RPC HEALTH \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    console.log(`\u2502 ENDPOINT:   ${url.padEnd(48)} \u2502`);
+    console.log(`\u2502 STATE:      ${health.status.toUpperCase().padEnd(48)} \u2502`);
+    console.log(`\u2502 CONFIDENCE: ${health.confidence?.toUpperCase().padEnd(36)} [${(health.score ?? 0).toString().padStart(3)}%] \u2502`);
+    console.log(`\u2502 LATENCY:    ${(health.latencyMs + "ms").padEnd(48)} \u2502`);
+    console.log(`\u2502 NETWORK:    ${(health.info?.networkId || "unknown").padEnd(48)} \u2502`);
+    console.log(`\u2502 DAA SCORE:  ${(health.info?.virtualDaaScore?.toString() || "0").padEnd(48)} \u2502`);
+    console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    const { calculateConfidence } = await import("@hardkas/kaspa-rpc");
+    const resilience = calculateConfidence({
+      latencyMs: health.latencyMs || null,
+      successRate: health.successRate ?? 100,
+      retries: health.retries ?? 0,
+      stale: !!health.stale,
+      reachable: !!health.reachable,
+      circuitOpen: health.circuitState === "OPEN"
+    });
+    if (resilience.issues.length > 0) {
+      console.log("\n[ ISSUES ]");
+      resilience.issues.forEach((issue) => console.log(`  \u2022 ${issue}`));
+    } else {
+      UI.success("\n  \u2713 No operational issues detected.");
+    }
+    console.log("\n[ TRACE ]");
+    console.log(`  - Retries:      ${health.retries ?? 0}`);
+    console.log(`  - Circuit:      ${health.circuitState || "CLOSED"}`);
+    console.log(`  - Sync Status:  ${health.info?.isSynced ? "SYNCED" : "STALE"}`);
+    console.log(`  - Version:      ${health.info?.serverVersion || "unknown"}`);
+    console.log("");
+  }
+  if (endpoints.length > 1) {
+    UI.divider();
+    const healthy = results.filter((r) => r.health.reachable);
+    if (healthy.length === endpoints.length) {
+      UI.success("All endpoints are healthy and ready for failover.");
+    } else if (healthy.length > 0) {
+      UI.warning(`${healthy.length}/${endpoints.length} endpoints are healthy. Load balancing will be degraded.`);
+    } else {
+      UI.error("CRITICAL: All endpoints are unreachable.");
+    }
+  }
+}
+export {
+  runRpcDoctor
+};

package/dist/snapshot-restore-runner-P26HDE74.js

@@ -0,0 +1,31 @@
+import {
+  UI
+} from "./chunk-M54KNJEH.js";
+
+// src/runners/snapshot-restore-runner.ts
+import {
+  loadOrCreateLocalnetState,
+  restoreLocalnetSnapshot,
+  saveLocalnetState,
+  calculateStateHash
+} from "@hardkas/localnet";
+async function runSnapshotRestore(options) {
+  try {
+    const state = await loadOrCreateLocalnetState();
+    const preHash = calculateStateHash(state);
+    UI.header(`Restoring Snapshot: ${options.idOrName}`);
+    const nextState = restoreLocalnetSnapshot(state, options.idOrName);
+    const postHash = calculateStateHash(nextState);
+    await saveLocalnetState(nextState);
+    UI.success("Snapshot Restored Successfully");
+    console.log(`  Previous State Hash: ${preHash.slice(0, 16)}...`);
+    console.log(`  New State Hash:      ${postHash.slice(0, 16)}...`);
+    console.log(`  DAA Score:           ${nextState.daaScore}`);
+  } catch (e) {
+    UI.error(`Restore failed: ${e.message}`);
+    process.exitCode = 1;
+  }
+}
+export {
+  runSnapshotRestore
+};

package/dist/snapshot-verify-runner-UYTXXQ7A.js

@@ -0,0 +1,38 @@
+import {
+  UI
+} from "./chunk-M54KNJEH.js";
+
+// src/runners/snapshot-verify-runner.ts
+import { loadOrCreateLocalnetState, verifySnapshot } from "@hardkas/localnet";
+async function runSnapshotVerify(options) {
+  try {
+    const state = await loadOrCreateLocalnetState();
+    const snapshot = state.snapshots?.find(
+      (s) => s.id === options.idOrName || s.name === options.idOrName || s.contentHash === options.idOrName
+    );
+    if (!snapshot) {
+      UI.error(`Snapshot not found: ${options.idOrName}`);
+      process.exitCode = 1;
+      return;
+    }
+    UI.header(`Snapshot Verification: ${snapshot.name || snapshot.contentHash}`);
+    const result = verifySnapshot(snapshot);
+    if (result.ok) {
+      UI.success("Snapshot Integrity Verified");
+      console.log(`  Accounts Hash:  \u2713 MATCH (${snapshot.accountsHash?.slice(0, 8)}...)`);
+      console.log(`  UTXO Set Hash:  \u2713 MATCH (${snapshot.utxoSetHash?.slice(0, 8)}...)`);
+      console.log(`  State Hash:     \u2713 MATCH (${snapshot.stateHash?.slice(0, 8)}...)`);
+      console.log(`  Content Hash:   \u2713 MATCH (${snapshot.contentHash?.slice(0, 8)}...)`);
+    } else {
+      UI.error("Snapshot Integrity Compromised");
+      result.errors.forEach((err) => console.log(`  [!] ${err}`));
+      process.exitCode = 1;
+    }
+  } catch (e) {
+    UI.error(`Verification failed: ${e.message}`);
+    process.exitCode = 1;
+  }
+}
+export {
+  runSnapshotVerify
+};

package/dist/tx-verify-runner-GPPVBQIF.js

@@ -0,0 +1,66 @@
+import {
+  UI
+} from "./chunk-M54KNJEH.js";
+
+// src/runners/tx-verify-runner.ts
+import { readTxPlanArtifact } from "@hardkas/artifacts";
+import { verifyTxPlanSemantics } from "@hardkas/tx-builder";
+import { formatSompi } from "@hardkas/core";
+import path from "path";
+async function runTxVerify(options) {
+  const absolutePath = path.resolve(process.cwd(), options.path);
+  UI.header(`Transaction Verification: ${path.basename(options.path)}`);
+  try {
+    const artifact = await readTxPlanArtifact(absolutePath);
+    const result = verifyTxPlanSemantics(artifact);
+    if (options.json) {
+      console.log(JSON.stringify(result, (key, value) => typeof value === "bigint" ? value.toString() : value, 2));
+      return result;
+    }
+    console.log(`Plan ID:      ${artifact.planId}`);
+    console.log(`Network:      ${artifact.networkId}`);
+    console.log(`Mode:         ${artifact.mode}`);
+    console.log("");
+    console.log("Economic Audit:");
+    console.log(`  Inputs:     ${formatSompi(result.inputTotalSompi)}`);
+    console.log(`  Outputs:    ${formatSompi(result.outputTotalSompi)}`);
+    console.log(`  Change:     ${formatSompi(result.changeAmountSompi)}`);
+    console.log(`  Fee (calc): ${formatSompi(result.recomputedFeeSompi)}`);
+    console.log(`  Mass:       ${result.recomputedMass}`);
+    console.log("");
+    if (result.issues.length > 0) {
+      console.log("Issues Found:");
+      result.issues.forEach((issue) => {
+        const prefix = getSeverityPrefix(issue.severity);
+        console.log(`  ${prefix} [${issue.code}] ${issue.message}`);
+        if (issue.path) console.log(`      Path: ${issue.path}`);
+      });
+      console.log("");
+    }
+    if (result.ok) {
+      UI.success("SEMANTIC VERIFICATION PASSED");
+    } else {
+      UI.error("SEMANTIC VERIFICATION FAILED");
+      process.exitCode = 1;
+    }
+    return result;
+  } catch (e) {
+    UI.error(`Verification error: ${e.message}`);
+    process.exitCode = 1;
+  }
+}
+function getSeverityPrefix(severity) {
+  switch (severity) {
+    case "critical":
+      return "[!!!]";
+    case "error":
+      return "[!]  ";
+    case "warning":
+      return "[?]  ";
+    default:
+      return "[i]  ";
+  }
+}
+export {
+  runTxVerify
+};

package/dist/ui-DXULTF7Q.js

@@ -0,0 +1,8 @@
+import {
+  UI,
+  handleError
+} from "./chunk-M54KNJEH.js";
+export {
+  UI,
+  handleError
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@hardkas/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "hardkas": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean",
+    "dev": "tsx src/index.ts",
+    "hardkas": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@hardkas/accounts": "workspace:*",
+    "@hardkas/artifacts": "workspace:*",
+    "@hardkas/config": "workspace:*",
+    "@hardkas/core": "workspace:*",
+    "@hardkas/kaspa-rpc": "workspace:*",
+    "@hardkas/query": "workspace:*",
+    "@hardkas/l2": "workspace:*",
+    "@hardkas/localnet": "workspace:*",
+    "@hardkas/node-orchestrator": "workspace:*",
+    "@hardkas/node-runner": "workspace:*",
+    "@hardkas/query-store": "workspace:*",
+    "@hardkas/sdk": "workspace:*",
+    "@hardkas/simulator": "workspace:*",
+    "@hardkas/tx-builder": "workspace:*",
+    "commander": "^12.1.0",
+    "enquirer": "^2.4.1",
+    "picocolors": "^1.1.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "license": "MIT",
+  "author": "Javier Rodriguez",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KasLabDevs/HardKas.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/KasLabDevs/HardKas/issues"
+  },
+  "homepage": "https://github.com/KasLabDevs/HardKas/tree/main/packages/cli#readme"
+}