@hardkas/config 0.5.0-alpha → 0.5.2-alpha

package/dist/index.d.ts

@@ -4,24 +4,28 @@ type HardkasTargetKind = "simulated" | "kaspa-node" | "kaspa-rpc" | "igra";
 type HardkasNetworkName = string;
 interface HardkasSimulatedTarget {
     kind: "simulated";
+    description?: string;
 }
 interface HardkasKaspaNodeTarget {
     kind: "kaspa-node";
-    network: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "devnet";
+    network: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "devnet" | "simnet";
     rpcUrl?: string;
     dataDir?: string;
     binaryPath?: string;
+    description?: string;
 }
 interface HardkasKaspaRpcTarget {
     kind: "kaspa-rpc";
-    network: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "devnet";
+    network: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "devnet" | "simnet";
     rpcUrl: string;
+    description?: string;
 }
 interface HardkasIgraTarget {
     kind: "igra";
     chainId: number;
     rpcUrl: string;
     currencySymbol?: "iKAS";
+    description?: string;
 }
 type HardkasNetworkTarget = HardkasSimulatedTarget | HardkasKaspaNodeTarget | HardkasKaspaRpcTarget | HardkasIgraTarget;
 type HardkasAccountConfig = {

package/dist/index.js

@@ -12,8 +12,15 @@ import { createJiti } from "jiti";
 var DEFAULT_HARDKAS_CONFIG = {
   defaultNetwork: "simnet",
   networks: {
+    simulated: {
+      kind: "simulated",
+      description: "Pure local simulation \u2014 no Docker, no RPC, no node"
+    },
     simnet: {
-      kind: "simulated"
+      kind: "kaspa-node",
+      network: "simnet",
+      rpcUrl: "ws://127.0.0.1:18210",
+      description: "Local Docker kaspad on simnet \u2014 requires hardkas node start"
     },
     devnet: {
       kind: "kaspa-node",
@@ -81,11 +88,25 @@ async function loadConfigFile(filePath, cwd) {
   try {
     const jiti = createJiti(import.meta.url);
     const module = await jiti.import(filePath);
-    const config = module.default || module.config || module;
+    const userConfig = module.default || module.config || module;
+    const mergedConfig = {
+      ...DEFAULT_HARDKAS_CONFIG,
+      ...userConfig,
+      // Merge networks: built-ins + user custom networks
+      networks: {
+        ...DEFAULT_HARDKAS_CONFIG.networks,
+        ...userConfig.networks && typeof userConfig.networks === "object" ? userConfig.networks : {}
+      },
+      // Merge accounts: only if user provides an object (not a number)
+      accounts: {
+        ...DEFAULT_HARDKAS_CONFIG.accounts,
+        ...userConfig.accounts && typeof userConfig.accounts === "object" && !Array.isArray(userConfig.accounts) ? userConfig.accounts : {}
+      }
+    };
     return {
       path: filePath,
       cwd,
-      config
+      config: mergedConfig
     };
   } catch (error) {
     throw new Error(`Failed to load HardKAS config at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/config",
-  "version": "0.5.0-alpha",
+  "version": "0.5.2-alpha",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -17,7 +17,7 @@
   ],
   "dependencies": {
     "jiti": "^2.4.2",
-    "@hardkas/core": "0.5.0-alpha"
+    "@hardkas/core": "0.5.2-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",