@hardkas/cli 0.2.2-alpha.1 → 0.4.0-alpha

package/dist/kaspa-doctor-runner-F2ISPABM.js

@@ -0,0 +1,81 @@
+import {
+  handleError
+} from "./chunk-K7XPWWIO.js";
+
+// src/runners/kaspa-doctor-runner.ts
+import pc from "picocolors";
+async function runKaspaDoctor(options) {
+  const checks = [];
+  let finalStatus = "ready";
+  try {
+    const { JsonWrpcKaspaClient } = await import("@hardkas/kaspa-rpc");
+    const client = new JsonWrpcKaspaClient({ rpcUrl: options.rpcUrl, timeoutMs: 3e3 });
+    try {
+      const info = await client.getInfo();
+      checks.push({ name: "RPC Reachability", status: "success", message: `Connected to kaspad ${info.serverVersion || ""}` });
+      if (info.isSynced) {
+        checks.push({ name: "Sync Status", status: "success", message: "Node is synced" });
+      } else {
+        checks.push({ name: "Sync Status", status: "warning", message: "Node is still syncing" });
+        if (finalStatus === "ready") finalStatus = "warning";
+      }
+      if (info.isUtxoIndexed) {
+        checks.push({ name: "UTXO Index", status: "success", message: "Indexed and searchable" });
+      } else {
+        checks.push({ name: "UTXO Index", status: "error", message: "UTXO index disabled (required for wallet balance/send)" });
+        finalStatus = "failed";
+      }
+      try {
+        const dag = await client.getBlockDagInfo();
+        checks.push({ name: "DAG Status", status: "success", message: `Network: ${dag.networkId}, DAA Score: ${dag.virtualDaaScore}` });
+      } catch (e) {
+        checks.push({ name: "DAG Status", status: "error", message: `Failed to fetch DAG info: ${e.message}` });
+        finalStatus = "failed";
+      }
+      try {
+        const mempoolSize = info.mempoolSize ?? 0;
+        checks.push({ name: "Mempool", status: "success", message: `${mempoolSize} transactions pending` });
+      } catch (e) {
+      }
+    } catch (e) {
+      checks.push({ name: "RPC Reachability", status: "error", message: `Failed to connect: ${e.message}` });
+      finalStatus = "failed";
+    }
+    if (options.json) {
+      const result = {
+        schema: "hardkas.kaspaDoctor.v1",
+        status: finalStatus,
+        checks
+      };
+      console.log(JSON.stringify(result, null, 2));
+      if (finalStatus === "failed") process.exitCode = 1;
+      return;
+    }
+    console.log(pc.bold("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    console.log(pc.bold(`HardKAS \u2022 Kaspa Doctor (L1)`));
+    console.log(pc.bold("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+    for (const check of checks) {
+      const icon = check.status === "success" ? pc.green("\u2713") : check.status === "warning" ? pc.yellow("\u26A0") : pc.red("\u2717");
+      console.log(`${icon} ${pc.bold(check.name)}: ${check.message}`);
+    }
+    console.log(pc.bold("\nStatus: ") + (finalStatus === "ready" ? pc.green("READY") : finalStatus === "warning" ? pc.yellow("WARNING") : pc.red("FAILED")));
+    if (finalStatus === "failed") {
+      console.log(`
+${pc.red("Fix recommendations:")}`);
+      if (checks.some((c) => c.name === "RPC Reachability" && c.status === "error")) {
+        console.log(`  - Ensure kaspad is running with ${pc.white("--rpclisten-json")}.`);
+        console.log(`  - Check if the port ${pc.white("16110")} is open.`);
+      }
+      if (checks.some((c) => c.name === "UTXO Index" && c.status === "error")) {
+        console.log(`  - Start kaspad with ${pc.white("--utxoindex")}.`);
+      }
+      process.exitCode = 1;
+    }
+  } catch (e) {
+    process.exitCode = 1;
+    handleError(e);
+  }
+}
+export {
+  runKaspaDoctor
+};

package/dist/kaspa-wallet-runner-ORJ5YFKU.js

@@ -0,0 +1,179 @@
+import {
+  UI,
+  handleError
+} from "./chunk-K7XPWWIO.js";
+
+// src/runners/kaspa-wallet-runner.ts
+import pc from "picocolors";
+import { loadHardkasConfig } from "@hardkas/config";
+async function runKaspaWalletCreate(name, options) {
+  try {
+    const { createLocalKaspaWallet } = await import("@hardkas/accounts");
+    console.log(pc.bold("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    console.log(pc.bold(`HardKAS \u2022 Kaspa Wallet Creation`));
+    console.log(pc.bold("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+    const wallet = await createLocalKaspaWallet({ networkId: options.network });
+    console.log(`  ${pc.green("\u2713")} New Kaspa L1 wallet generated:`);
+    console.log(`    Name:    ${pc.white(name)}`);
+    console.log(`    Address: ${pc.white(wallet.address)}`);
+    console.log(`    Network: ${pc.white(options.network)}`);
+    console.log(`
+  ${pc.yellow("Action Required:")} Add this to your ${pc.white("hardkas.config.ts")}:`);
+    console.log(pc.gray("  ----------------------------------------"));
+    console.log(pc.white(`  accounts: {`));
+    console.log(pc.white(`    ${name}: {`));
+    console.log(pc.white(`      kind: "kaspa-private-key",`));
+    console.log(pc.white(`      address: "${wallet.address}",`));
+    console.log(pc.white(`      privateKeyEnv: "${name.toUpperCase()}_PRIVATE_KEY"`));
+    console.log(pc.white(`    }`));
+    console.log(pc.white(`  }`));
+    console.log(pc.gray("  ----------------------------------------"));
+    console.log(`
+  ${pc.dim("Set your private key in .env:")}`);
+    console.log(`  ${name.toUpperCase()}_PRIVATE_KEY=${wallet.privateKey}
+`);
+    console.log(`${pc.dim("HardKAS never auto-writes secrets for your protection.")}`);
+  } catch (e) {
+    handleError(e);
+  }
+}
+async function runKaspaWalletList(options) {
+  try {
+    const config = await loadHardkasConfig();
+    const { listHardkasAccounts } = await import("@hardkas/accounts");
+    const accounts = listHardkasAccounts(config.config).filter((a) => a.kind === "kaspa-private-key" || a.kind === "simulated");
+    if (options.json) {
+      console.log(JSON.stringify(accounts, null, 2));
+      return;
+    }
+    console.log(pc.bold("\nLocal Kaspa Wallets"));
+    console.log(pc.dim("----------------------------------------"));
+    for (const acc of accounts) {
+      console.log(`${pc.white(acc.name.padEnd(12))} ${pc.cyan(acc.address?.padEnd(40))} ${pc.dim(`(${acc.kind})`)}`);
+    }
+    console.log("");
+  } catch (e) {
+    handleError(e);
+  }
+}
+async function runKaspaWalletAddress(name) {
+  try {
+    const config = await loadHardkasConfig();
+    const { resolveHardkasAccountAddress } = await import("@hardkas/accounts");
+    const address = resolveHardkasAccountAddress(name, config.config);
+    console.log(address);
+  } catch (e) {
+    handleError(e);
+    process.exitCode = 1;
+  }
+}
+async function runKaspaWalletBalance(name, options) {
+  try {
+    const config = await loadHardkasConfig();
+    const { resolveHardkasAccountAddress } = await import("@hardkas/accounts");
+    const { JsonWrpcKaspaClient } = await import("@hardkas/kaspa-rpc");
+    const address = resolveHardkasAccountAddress(name, config.config);
+    const client = new JsonWrpcKaspaClient({ rpcUrl: options.rpcUrl });
+    const balance = await client.getBalanceByAddress(address);
+    if (options.json) {
+      console.log(JSON.stringify(balance, (k, v) => typeof v === "bigint" ? v.toString() : v, 2));
+      return;
+    }
+    console.log(`
+Wallet:  ${pc.white(name)}`);
+    console.log(`Address: ${pc.dim(address)}`);
+    console.log(`Balance: ${pc.green(Number(balance.balanceSompi) / 1e8)} KAS
+`);
+  } catch (e) {
+    handleError(e);
+    process.exitCode = 1;
+  }
+}
+async function runKaspaWalletSend(from, to, options) {
+  try {
+    const config = await loadHardkasConfig();
+    const { resolveHardkasAccount, resolveHardkasAccountAddress } = await import("@hardkas/accounts");
+    const { JsonWrpcKaspaClient } = await import("@hardkas/kaspa-rpc");
+    const { buildPaymentPlan } = await import("@hardkas/tx-builder");
+    const { signTxPlanArtifact } = await import("@hardkas/accounts");
+    const { HARDKAS_VERSION } = await import("@hardkas/artifacts");
+    const sender = resolveHardkasAccount({ nameOrAddress: from, config: config.config });
+    const targetAddress = resolveHardkasAccountAddress(to, config.config);
+    const amountSompi = BigInt(Math.floor(parseFloat(options.amount) * 1e8));
+    const client = new JsonWrpcKaspaClient({ rpcUrl: options.rpcUrl });
+    const utxos = await client.getUtxosByAddress(sender.address);
+    const plan = buildPaymentPlan({
+      fromAddress: sender.address,
+      outputs: [{ address: targetAddress, amountSompi }],
+      availableUtxos: utxos.map((u) => ({
+        outpoint: u.outpoint,
+        address: u.address,
+        amountSompi: u.amountSompi,
+        scriptPublicKey: u.scriptPublicKey || ""
+      })),
+      feeRateSompiPerMass: 1n,
+      // Default 1 sompi/mass
+      changeAddress: sender.address
+    });
+    console.log(pc.bold("\nTransaction Plan"));
+    console.log(pc.dim("----------------------------------------"));
+    console.log(`From:    ${pc.white(from)} (${sender.address})`);
+    console.log(`To:      ${pc.white(to)} (${targetAddress})`);
+    console.log(`Amount:  ${pc.green(Number(amountSompi) / 1e8)} KAS`);
+    console.log(`Fee:     ${pc.yellow(Number(plan.estimatedFeeSompi) / 1e8)} KAS`);
+    console.log(`Mass:    ${plan.estimatedMass}`);
+    console.log(`Inputs:  ${plan.inputs.length} UTXOs`);
+    console.log(pc.dim("----------------------------------------\n"));
+    if (options.dryRun) {
+      console.log(pc.blue("Dry-run mode: Transaction NOT signed or broadcast.\n"));
+      return;
+    }
+    const confirm = await UI.confirm(`Proceed with signing and broadcasting this transaction?`);
+    if (!confirm) {
+      console.log(pc.red("Cancelled.\n"));
+      return;
+    }
+    const planArtifact = {
+      schema: "hardkas.txPlan",
+      planId: `plan-${Date.now()}`,
+      hardkasVersion: HARDKAS_VERSION,
+      version: "1.0.0-alpha",
+      networkId: config.config.networkId || config.config.defaultNetwork || "simnet",
+      mode: sender.kind === "simulated" ? "simulated" : "real",
+      from: { address: sender.address },
+      to: { address: targetAddress },
+      amountSompi,
+      inputs: plan.inputs,
+      outputs: plan.outputs,
+      change: plan.change,
+      estimatedFeeSompi: plan.estimatedFeeSompi
+    };
+    const signedArtifact = await signTxPlanArtifact({
+      planArtifact,
+      account: sender,
+      config: config.config
+    });
+    console.log(`  ${pc.green("\u2713")} Transaction signed.`);
+    const submitResult = await client.submitTransaction(signedArtifact.signedTransaction.payload);
+    if (submitResult.accepted) {
+      console.log(`  ${pc.green("\u2713")} Transaction accepted by node.`);
+      console.log(`  TXID: ${pc.bold(pc.white(submitResult.transactionId))}
+`);
+    } else {
+      console.log(`  ${pc.red("\u2717")} Transaction rejected by node.`);
+      console.log(`  Details: ${JSON.stringify(submitResult.raw)}
+`);
+      process.exitCode = 1;
+    }
+  } catch (e) {
+    handleError(e);
+    process.exitCode = 1;
+  }
+}
+export {
+  runKaspaWalletAddress,
+  runKaspaWalletBalance,
+  runKaspaWalletCreate,
+  runKaspaWalletList,
+  runKaspaWalletSend
+};

package/dist/local-wizard-runner-GCAWGZ6D.js

@@ -0,0 +1,144 @@
+import {
+  UI,
+  handleError
+} from "./chunk-K7XPWWIO.js";
+
+// src/runners/local-wizard-runner.ts
+import pc from "picocolors";
+import { loadHardkasConfig } from "@hardkas/config";
+async function runLocalWizard(options) {
+  try {
+    const config = await loadHardkasConfig();
+    const networkId = config.config.networkId || config.config.defaultNetwork || "simnet";
+    const { getL2NetworkProfile, EvmJsonRpcClient } = await import("@hardkas/l2");
+    const { listHardkasAccounts } = await import("@hardkas/accounts");
+    if (!options.json) {
+      console.log(pc.bold("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+      console.log(pc.bold(`HardKAS \u2022 Local Dev Wizard`));
+      console.log(pc.bold("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+    }
+    const result = {
+      schema: "hardkas.localWizard.v1",
+      step: "preflight",
+      status: "pending"
+    };
+    if (!options.json) console.log(`${pc.cyan(pc.bold("1. Checking Environment"))}`);
+    let profile;
+    try {
+      profile = await getL2NetworkProfile({
+        name: options.profile,
+        userProfiles: config.config.l2?.networks,
+        cliOverrides: {
+          rpcUrl: options.rpcUrl || (networkId === "simnet" || networkId === "localnet" ? "http://127.0.0.1:8545" : void 0),
+          chainId: networkId === "simnet" || networkId === "localnet" ? 19416 : void 0
+        }
+      });
+      const client2 = new EvmJsonRpcClient({ url: profile.rpcUrl, timeoutMs: 2e3 });
+      await client2.getBlockNumber();
+      if (!options.json) console.log(`  ${pc.green("\u2713")} Igra RPC is reachable (${profile.rpcUrl})`);
+    } catch (e) {
+      if (!options.json) {
+        console.log(`  ${pc.red("\u2717")} Igra RPC is unreachable.`);
+        console.log(`    ${pc.dim("Please start your local node first.")}`);
+      }
+      result.status = "failed";
+      result.suggestion = "Start local Igra node";
+      if (options.json) console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    result.step = "accounts";
+    if (!options.json) console.log(`
+${pc.cyan(pc.bold("2. Checking Accounts"))}`);
+    const accounts = listHardkasAccounts(config.config);
+    let targetAccount = accounts.find((a) => a.name === options.account && a.kind === "evm-private-key");
+    if (!targetAccount) {
+      if (options.nonInteractive) {
+        result.status = "failed";
+        result.suggestion = `Account "${options.account}" missing. Run in interactive mode to generate.`;
+        if (options.json) console.log(JSON.stringify(result, null, 2));
+        else console.log(`  ${pc.red("\u2717")} Account missing (non-interactive mode).`);
+        return;
+      }
+      if (!options.json) console.log(`  ${pc.yellow("\u26A0")} No EVM account named "${options.account}" found.`);
+      const confirm = await UI.confirm(`Would you like to generate a new local EVM account for "${options.account}"?`);
+      if (confirm) {
+        const { generatePrivateKey, privateKeyToAccount } = await import("viem/accounts");
+        const privKey = generatePrivateKey();
+        const account = privateKeyToAccount(privKey);
+        if (!options.json) {
+          console.log(`
+  ${pc.bgYellow(pc.black(pc.bold(" SECURITY ACTION: PRIVATE KEY GENERATED ")))}`);
+          console.log(`  ${pc.yellow("This key is for LOCAL DEVELOPMENT ONLY. Never use it for real assets.")}
+`);
+          console.log(`  ${pc.green("\u2713")} New account generated:`);
+          console.log(`    Name:    ${pc.white(options.account)}`);
+          console.log(`    Address: ${pc.white(account.address)}`);
+          console.log(`
+  ${pc.yellow("Action Required:")} Add this to your ${pc.white("hardkas.config.ts")}:`);
+          console.log(pc.gray("  ----------------------------------------"));
+          console.log(pc.white(`  accounts: {`));
+          console.log(pc.white(`    ${options.account}: {`));
+          console.log(pc.white(`      kind: "evm-private-key",`));
+          console.log(pc.white(`      address: "${account.address}",`));
+          console.log(pc.white(`      privateKey: "${privKey}"`));
+          console.log(pc.white(`    }`));
+          console.log(pc.white(`  }`));
+          console.log(pc.gray("  ----------------------------------------"));
+          console.log(`
+  ${pc.dim("HardKAS does not automatically write secrets to your config for safety.")}`);
+          console.log(`  ${pc.dim("Please update your config and run the wizard again to finish setup.")}`);
+        }
+        result.status = "pending";
+        result.accountCreated = true;
+        result.suggestion = "Update hardkas.config.ts with generated key";
+        if (options.json) console.log(JSON.stringify(result, null, 2));
+        return;
+      } else {
+        if (!options.json) console.log(`  ${pc.red("\u2717")} Setup cancelled.`);
+        result.status = "failed";
+        if (options.json) console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+    } else {
+      if (!options.json) console.log(`  ${pc.green("\u2713")} Account "${targetAccount.name}" found (${targetAccount.address})`);
+    }
+    result.step = "balance";
+    if (!options.json) console.log(`
+${pc.cyan(pc.bold("3. Checking Balance"))}`);
+    const client = new EvmJsonRpcClient({ url: profile.rpcUrl });
+    const balance = await client.getBalanceWei(targetAccount.address);
+    const kasBalance = Number(balance) / 1e18;
+    if (kasBalance === 0) {
+      if (!options.json) {
+        console.log(`  ${pc.yellow("\u26A0")} Account has 0 iKAS.`);
+        console.log(`  ${pc.dim("Please fund your account manually or via local faucet.")}`);
+      }
+      result.status = "failed";
+      result.suggestion = "Fund local account";
+    } else {
+      if (!options.json) console.log(`  ${pc.green("\u2713")} Balance: ${kasBalance} iKAS`);
+    }
+    result.status = kasBalance > 0 ? "success" : "failed";
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (result.status === "success") {
+      console.log(`
+${pc.cyan(pc.bold("4. MetaMask Onboarding"))}`);
+      console.log(`  ${pc.dim("To add this network to MetaMask, run:")}`);
+      console.log(`  ${pc.white("hardkas metamask snippet")}`);
+      console.log(`
+${pc.bold(pc.green("READY!"))} Local environment is set up.`);
+      console.log(`
+${pc.cyan("Final step:")} Import your account into MetaMask:`);
+      console.log(`  hardkas metamask account ${pc.white(options.account)} --show-private-key
+`);
+    }
+  } catch (e) {
+    handleError(e);
+  }
+}
+export {
+  runLocalWizard
+};

package/dist/metamask-runner-PRIOW4J3.js

@@ -0,0 +1,132 @@
+import {
+  handleError
+} from "./chunk-K7XPWWIO.js";
+
+// src/runners/metamask-runner.ts
+import pc from "picocolors";
+import { loadHardkasConfig } from "@hardkas/config";
+async function runMetamaskNetwork(options) {
+  try {
+    const config = await loadHardkasConfig();
+    const networkId = config.config.networkId || config.config.defaultNetwork || "simnet";
+    if (networkId === "mainnet" || networkId.startsWith("testnet")) {
+      throw new Error(`MetaMask onboarding is only allowed on local development networks (simnet, localnet). Current network: ${networkId}`);
+    }
+    const { getL2NetworkProfile } = await import("@hardkas/l2");
+    const { generateAddEthereumChainPayload } = await import("@hardkas/l2");
+    const profile = await getL2NetworkProfile({
+      name: options.profile,
+      userProfiles: config.config.l2?.networks,
+      cliOverrides: {
+        rpcUrl: networkId === "simnet" || networkId === "localnet" ? "http://127.0.0.1:8545" : void 0,
+        chainId: networkId === "simnet" || networkId === "localnet" ? 19416 : void 0
+      }
+    });
+    const payload = generateAddEthereumChainPayload(profile);
+    if (options.json) {
+      console.log(JSON.stringify(payload, null, 2));
+      return;
+    }
+    console.log(pc.bold("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    console.log(pc.bold(`HardKAS \u2022 MetaMask Network`));
+    console.log(pc.bold("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+    console.log(`${pc.cyan(pc.bold("Network Details"))}`);
+    console.log(`  Name:      ${pc.white(payload.chainName)}`);
+    console.log(`  RPC URL:   ${pc.white(payload.rpcUrls[0])}`);
+    console.log(`  Chain ID:  ${pc.white(parseInt(payload.chainId, 16))} (${payload.chainId})`);
+    console.log(`  Currency:  ${pc.white(payload.nativeCurrency.symbol)} (${payload.nativeCurrency.name})`);
+    if (payload.blockExplorerUrls) {
+      console.log(`  Explorer:  ${pc.white(payload.blockExplorerUrls[0])}`);
+    }
+    console.log(`
+${pc.yellow("To add this network to MetaMask:")}`);
+    console.log(`  1. Open MetaMask settings`);
+    console.log(`  2. Go to Networks -> Add a network -> Add a network manually`);
+    console.log(`  3. Fill in the details above.
+`);
+    console.log(`${pc.dim("Alternatively, run: ")} ${pc.cyan("hardkas metamask snippet")}
+`);
+  } catch (e) {
+    handleError(e);
+  }
+}
+async function runMetamaskSnippet(options) {
+  try {
+    const config = await loadHardkasConfig();
+    const networkId = config.config.networkId || config.config.defaultNetwork || "simnet";
+    if (networkId === "mainnet" || networkId.startsWith("testnet")) {
+      throw new Error(`MetaMask onboarding is only allowed on local development networks (simnet, localnet).`);
+    }
+    const { getL2NetworkProfile } = await import("@hardkas/l2");
+    const { generateMetaMaskSnippet } = await import("@hardkas/l2");
+    const profile = await getL2NetworkProfile({
+      name: options.profile,
+      userProfiles: config.config.l2?.networks,
+      cliOverrides: {
+        rpcUrl: networkId === "simnet" || networkId === "localnet" ? "http://127.0.0.1:8545" : void 0,
+        chainId: networkId === "simnet" || networkId === "localnet" ? 19416 : void 0
+      }
+    });
+    const snippet = generateMetaMaskSnippet(profile);
+    console.log(pc.bold("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    console.log(pc.bold(`HardKAS \u2022 MetaMask Snippet`));
+    console.log(pc.bold("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+    console.log(`${pc.yellow("Copy and paste this snippet into your browser console while MetaMask is open:")}
+`);
+    console.log(pc.gray("```javascript"));
+    console.log(pc.white(snippet));
+    console.log(pc.gray("```\n"));
+  } catch (e) {
+    handleError(e);
+  }
+}
+async function runMetamaskAccount(name, options) {
+  try {
+    const config = await loadHardkasConfig();
+    const { resolveHardkasAccount, prepareEvmAccountExport } = await import("@hardkas/accounts");
+    const account = resolveHardkasAccount({ nameOrAddress: name, config: config.config });
+    const networkId = config.config.networkId || config.config.defaultNetwork || "simnet";
+    const includeSecretRequested = options.json ? options.includeSecret && options.showPrivateKey : options.showPrivateKey;
+    const exportData = await prepareEvmAccountExport(account, networkId, {
+      includeSecret: includeSecretRequested
+    });
+    if (options.json) {
+      if (!options.includeSecret) {
+        delete exportData.privateKey;
+      }
+      console.log(JSON.stringify(exportData, null, 2));
+      return;
+    }
+    console.log(pc.bold("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+    console.log(pc.bold(`HardKAS \u2022 MetaMask Export`));
+    console.log(pc.bold("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n"));
+    console.log(`${pc.cyan(pc.bold("Account"))}`);
+    console.log(`  Name:      ${pc.white(name)}`);
+    console.log(`  Address:   ${pc.white(exportData.address)}`);
+    if (options.showPrivateKey && exportData.privateKey) {
+      console.log(`
+  ${pc.bgRed(pc.white(pc.bold(" SECURITY WARNING ")))}`);
+      console.log(`  ${pc.red("This is a LOCAL DEV ONLY account. Never share private keys.")}
+`);
+      console.log(`  Private Key: ${pc.white(exportData.privateKey)}`);
+    } else {
+      console.log(`
+  Private Key: ${pc.dim("[HIDDEN]")}`);
+      console.log(`  ${pc.dim("Run with ")} ${pc.cyan("--show-private-key")} ${pc.dim("to reveal.")}`);
+    }
+    console.log(`
+${pc.yellow("To import this account into MetaMask:")}`);
+    console.log(`  1. Open MetaMask`);
+    console.log(`  2. Click the Account menu (top right)`);
+    console.log(`  3. Click "Import Account"`);
+    console.log(`  4. Paste the private key above.
+`);
+  } catch (e) {
+    handleError(e);
+  }
+}
+export {
+  runMetamaskAccount,
+  runMetamaskNetwork,
+  runMetamaskSnippet
+};

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

@@ -0,0 +1,50 @@
+import {
+  UI
+} from "./chunk-K7XPWWIO.js";
+
+// src/runners/replay-verify-runner.ts
+import { readTxPlanArtifact, readTxReceiptArtifact } from "@hardkas/artifacts";
+import { loadOrCreateLocalnetState, verifyReplay } from "@hardkas/localnet";
+import path from "path";
+import pc from "picocolors";
+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);
+    console.log(`  Workflow:      ${report.checks.workflowDeterministic === "reproduced" ? pc.green("\u2713 REPRODUCED") : pc.red("\u2717 DIVERGED")}`);
+    console.log(`  Consensus:     ${pc.yellow("- UNIMPLEMENTED")} (HardKAS does not validate network consensus)`);
+    console.log(`  L2 Logic:      ${pc.yellow("- UNIMPLEMENTED")} (HardKAS does not validate bridge protocol)`);
+    console.log("");
+    if (report.invariantsOk) {
+      UI.success("Artifact workflow is deterministic.");
+      console.log(`  Plan Hash:     \u2713 MATCH`);
+      console.log(`  Semantic Diff: \u2713 NO CHANGES`);
+    } else {
+      UI.error("Replay Verification Failed");
+      if (report.divergences.length > 0) {
+        console.log(pc.bold("\n  Divergences found:"));
+        for (const div of report.divergences) {
+          console.log(`    ${pc.cyan(div.path)}:`);
+          console.log(`      Expected: ${pc.green(JSON.stringify(div.expected))}`);
+          console.log(`      Actual:   ${pc.red(JSON.stringify(div.actual))}`);
+        }
+      }
+      if (report.errors.length > 0 && report.divergences.length === 0) {
+        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-ERWXOXSE.js → rpc-doctor-runner-V7H7AAX4.js}

@@ -1,6 +1,6 @@
 import {
   UI
-} from "./chunk-AQWQW5ZG.js";
+} from "./chunk-K7XPWWIO.js";
 
 // src/runners/rpc-doctor-runner.ts
 import { KaspaJsonRpcClient } from "@hardkas/kaspa-rpc";