@hardkas/cli 0.3.0-alpha → 0.5.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/public.d.ts

@@ -0,0 +1,9 @@
+import { HardkasConfig } from '@hardkas/config';
+
+/**
+ * Type-safe config helper for hardkas.config.ts files.
+ * This is a pass-through function that provides autocompletion.
+ */
+declare function defineConfig(config: Partial<HardkasConfig>): Partial<HardkasConfig>;
+
+export { defineConfig };

package/dist/public.js

@@ -0,0 +1,7 @@
+// src/define-config.ts
+function defineConfig(config) {
+  return config;
+}
+export {
+  defineConfig
+};

package/dist/session-runner-LDSGDP47.js

@@ -0,0 +1,118 @@
+import {
+  handleError
+} from "./chunk-K7XPWWIO.js";
+
+// src/runners/session-runner.ts
+import pc from "picocolors";
+import { loadHardkasConfig } from "@hardkas/config";
+async function runSessionCreate(name, options) {
+  try {
+    const config = await loadHardkasConfig();
+    const { createSession } = await import("@hardkas/sessions");
+    const { resolveHardkasAccountAddress } = await import("@hardkas/accounts");
+    const l1Address = resolveHardkasAccountAddress(options.l1, config.config);
+    const l2Address = resolveHardkasAccountAddress(options.l2, config.config);
+    await createSession({
+      schema: "hardkas.session.v1",
+      name,
+      l1: { wallet: options.l1, address: l1Address },
+      l2: { account: options.l2, address: l2Address },
+      bridge: { mode: "local-simulated" },
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    console.log(`
+${pc.green("\u2713")} Session "${pc.white(name)}" created.`);
+    console.log(`  L1: ${pc.cyan(options.l1)} (${l1Address})`);
+    console.log(`  L2: ${pc.cyan(options.l2)} (${l2Address})
+`);
+  } catch (e) {
+    handleError(e);
+  }
+}
+async function runSessionList() {
+  try {
+    const { loadSessionStoreWithDiagnostics } = await import("@hardkas/sessions");
+    const { store, diagnostics } = loadSessionStoreWithDiagnostics();
+    if (diagnostics.length > 0) {
+      console.log(pc.yellow(`
+\u26A0\uFE0F  Session Store Warnings:`));
+      for (const d of diagnostics) {
+        console.log(pc.yellow(`  - ${d}`));
+      }
+    }
+    const sessions = Object.values(store.sessions);
+    if (sessions.length === 0) {
+      console.log(`
+No sessions found. Create one with:`);
+      console.log(`hardkas session create dev-alice --l1 alice --l2 dev_alice
+`);
+      return;
+    }
+    console.log(pc.bold("\nHardKAS Developer Sessions"));
+    console.log(pc.dim("----------------------------------------"));
+    for (const s of sessions) {
+      const active = store.activeSession === s.name ? pc.green("\u25CF") : " ";
+      console.log(`${active} ${pc.white(s.name.padEnd(12))} ${pc.dim(`[L1: ${s.l1.wallet} | L2: ${s.l2.account}]`)}`);
+    }
+    console.log("");
+  } catch (e) {
+    handleError(e);
+  }
+}
+async function runSessionStatus() {
+  try {
+    const config = await loadHardkasConfig();
+    const { loadSessionStoreWithDiagnostics } = await import("@hardkas/sessions");
+    const { listHardkasAccounts } = await import("@hardkas/accounts");
+    const { store, diagnostics } = loadSessionStoreWithDiagnostics();
+    if (diagnostics.length > 0) {
+      console.log(pc.yellow(`
+\u26A0\uFE0F  Session Store Warnings:`));
+      for (const d of diagnostics) {
+        console.log(pc.yellow(`  - ${d}`));
+      }
+    }
+    const session = store.activeSession ? store.sessions[store.activeSession] : null;
+    if (!session) {
+      console.log(pc.yellow("\nNo active session."));
+      return;
+    }
+    const accounts = listHardkasAccounts(config.config);
+    const l1Found = accounts.some((a) => a.name === session.l1.wallet);
+    const l2Found = accounts.some((a) => a.name === session.l2.account);
+    console.log(pc.bold(`
+Active Session: ${pc.white(session.name)}`));
+    console.log(pc.dim("----------------------------------------"));
+    const l1Status = l1Found ? pc.green("\u2713") : pc.red("\u2717 MISSING");
+    console.log(`${l1Status} L1 Wallet:  ${pc.cyan(session.l1.wallet)} (${session.l1.address})`);
+    const l2Status = l2Found ? pc.green("\u2713") : pc.red("\u2717 MISSING");
+    console.log(`${l2Status} L2 Account: ${pc.cyan(session.l2.account)} (${session.l2.address})`);
+    console.log(`  Bridge:     ${pc.white(session.bridge.mode)}`);
+    console.log(pc.dim("----------------------------------------"));
+    if (!l1Found || !l2Found) {
+      console.log(`
+${pc.red(pc.bold("\u26A0 WARNING:"))} One or more accounts linked to this session are missing from your configuration.`);
+      console.log(`${pc.dim("Please update your hardkas.config.ts or recreate the session.")}`);
+    }
+    console.log("");
+  } catch (e) {
+    handleError(e);
+  }
+}
+async function runSessionUse(name) {
+  try {
+    const { setActiveSession } = await import("@hardkas/sessions");
+    await setActiveSession(name);
+    console.log(`
+${pc.green("\u2713")} Active session set to "${pc.white(name)}".
+`);
+  } catch (e) {
+    handleError(e);
+  }
+}
+export {
+  runSessionCreate,
+  runSessionList,
+  runSessionStatus,
+  runSessionUse
+};