@hardkas/config 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Javier Rodriguez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import { NetworkId } from '@hardkas/core';
+
+type HardkasTargetKind = "simulated" | "kaspa-node" | "kaspa-rpc" | "igra";
+type HardkasNetworkName = string;
+interface HardkasSimulatedTarget {
+    kind: "simulated";
+}
+interface HardkasKaspaNodeTarget {
+    kind: "kaspa-node";
+    network: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "devnet";
+    rpcUrl?: string;
+    dataDir?: string;
+    binaryPath?: string;
+}
+interface HardkasKaspaRpcTarget {
+    kind: "kaspa-rpc";
+    network: "mainnet" | "testnet-10" | "testnet-11" | "testnet-12" | "devnet";
+    rpcUrl: string;
+}
+interface HardkasIgraTarget {
+    kind: "igra";
+    chainId: number;
+    rpcUrl: string;
+    currencySymbol?: "iKAS";
+}
+type HardkasNetworkTarget = HardkasSimulatedTarget | HardkasKaspaNodeTarget | HardkasKaspaRpcTarget | HardkasIgraTarget;
+type HardkasAccountConfig = {
+    kind: "simulated";
+    address?: string;
+} | {
+    kind: "kaspa-private-key";
+    privateKeyEnv: string;
+    address?: string;
+} | {
+    kind: "external-wallet";
+    walletId?: string;
+    address?: string;
+} | {
+    kind: "evm-private-key";
+    privateKeyEnv: string;
+    address?: string;
+};
+interface HardkasConfig {
+    defaultNetwork?: HardkasNetworkName;
+    networks?: Record<HardkasNetworkName, HardkasNetworkTarget>;
+    accounts?: Record<string, HardkasAccountConfig>;
+}
+interface LoadedHardkasConfig {
+    path?: string;
+    cwd: string;
+    config: HardkasConfig;
+}
+
+declare function defineHardkasConfig(config: HardkasConfig): HardkasConfig;
+
+interface LoadHardkasConfigOptions {
+    cwd?: string;
+    configPath?: string;
+}
+declare function loadHardkasConfig(options?: LoadHardkasConfigOptions): Promise<LoadedHardkasConfig>;
+
+interface ResolveNetworkTargetOptions {
+    config: HardkasConfig;
+    network?: string;
+}
+
+declare function resolveNetworkTarget(options: ResolveNetworkTargetOptions): {
+    name: NetworkId;
+    target: HardkasNetworkTarget;
+};
+
+declare const DEFAULT_HARDKAS_CONFIG: HardkasConfig;
+
+export { DEFAULT_HARDKAS_CONFIG, type HardkasAccountConfig, type HardkasConfig, type HardkasIgraTarget, type HardkasKaspaNodeTarget, type HardkasKaspaRpcTarget, type HardkasNetworkName, type HardkasNetworkTarget, type HardkasSimulatedTarget, type HardkasTargetKind, type LoadHardkasConfigOptions, type LoadedHardkasConfig, type ResolveNetworkTargetOptions, defineHardkasConfig, loadHardkasConfig, resolveNetworkTarget };

package/dist/index.js

@@ -0,0 +1,105 @@
+// src/define.ts
+function defineHardkasConfig(config) {
+  return config;
+}
+
+// src/load.ts
+import path from "path";
+import fs from "fs";
+import { createJiti } from "jiti";
+
+// src/defaults.ts
+var DEFAULT_HARDKAS_CONFIG = {
+  defaultNetwork: "simnet",
+  networks: {
+    simnet: {
+      kind: "simulated"
+    },
+    devnet: {
+      kind: "kaspa-node",
+      network: "devnet",
+      rpcUrl: "ws://127.0.0.1:18310"
+    },
+    testnet10: {
+      kind: "kaspa-rpc",
+      network: "testnet-10",
+      rpcUrl: "ws://127.0.0.1:18210"
+    }
+  },
+  accounts: {
+    alice: { kind: "simulated", address: "kaspa:sim_alice" },
+    bob: { kind: "simulated", address: "kaspa:sim_bob" },
+    carol: { kind: "simulated", address: "kaspa:sim_carol" }
+  }
+};
+
+// src/load.ts
+async function loadHardkasConfig(options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  if (options.configPath) {
+    const absolutePath = path.resolve(cwd, options.configPath);
+    if (!fs.existsSync(absolutePath)) {
+      throw new Error(`HardKAS config file not found at ${absolutePath}`);
+    }
+    return loadConfigFile(absolutePath, cwd);
+  }
+  const indicators = [
+    "hardkas.config.ts",
+    "hardkas.config.mts",
+    "hardkas.config.js",
+    "hardkas.config.mjs"
+  ];
+  let current = cwd;
+  const root = path.parse(current).root;
+  while (current !== root) {
+    for (const indicator of indicators) {
+      const p = path.join(current, indicator);
+      if (fs.existsSync(p)) {
+        return loadConfigFile(p, current);
+      }
+    }
+    const parent = path.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return {
+    cwd,
+    config: DEFAULT_HARDKAS_CONFIG
+  };
+}
+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;
+    return {
+      path: filePath,
+      cwd,
+      config
+    };
+  } catch (error) {
+    throw new Error(`Failed to load HardKAS config at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+// src/resolve.ts
+function resolveNetworkTarget(options) {
+  const { config, network } = options;
+  const name = network || config.defaultNetwork || "simnet";
+  const networks = config.networks && Object.keys(config.networks).length > 0 ? config.networks : DEFAULT_HARDKAS_CONFIG.networks;
+  const target = networks[name];
+  if (!target) {
+    const available = Object.keys(networks).join(", ");
+    throw new Error(`Unknown HardKAS network '${name}'. Available networks: ${available}`);
+  }
+  return {
+    name,
+    target
+  };
+}
+export {
+  DEFAULT_HARDKAS_CONFIG,
+  defineHardkasConfig,
+  loadHardkasConfig,
+  resolveNetworkTarget
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@hardkas/config",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "jiti": "^2.4.2",
+    "@hardkas/core": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "license": "MIT",
+  "author": "Javier Rodriguez",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jrodrg92/Hardkas.git",
+    "directory": "packages/config"
+  },
+  "bugs": {
+    "url": "https://github.com/jrodrg92/Hardkas/issues"
+  },
+  "homepage": "https://github.com/jrodrg92/Hardkas/tree/main/packages/config#readme",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --watch --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}