@hardkas/accounts 0.6.0-alpha → 0.7.1-alpha

package/dist/index.d.ts

@@ -265,6 +265,7 @@ declare function importRealDevAccount(store: RealAccountStore, account: {
     readonly address: string;
     readonly publicKey?: string;
     readonly privateKey?: string;
+    readonly keystoreRef?: string;
 }): RealAccountStore;
 declare function removeRealDevAccount(store: RealAccountStore, name: string): RealAccountStore;
 declare function getRealDevAccount(store: RealAccountStore, name: string): RealDevAccount | null;
@@ -366,4 +367,12 @@ declare class KeystoreManager {
     static saveEncryptedKeystore(filePath: string, keystore: EncryptedKeystoreV2): Promise<void>;
 }
 
-export { type CreateKaspaWalletOptions, type EncryptedKeystoreV2, type EvmExportResult, type GeneratedKaspaDevAccount, type HardkasAccount, type HardkasAccountKind, type HardkasBaseAccount, type HardkasEvmPrivateKeyAccount, type HardkasExternalWalletAccount, type HardkasKaspaPrivateKeyAccount, type HardkasSigner, type HardkasSignerKind, type HardkasSimulatedAccount, type HardkasTxPlanSigner, type KaspaKeyGenerator, KaspaSdkKeyGenerator, type KaspaSdkKeyGeneratorOptions, KaspaSdkRealTxSigner, type KaspaSdkRealTxSignerOptions, type KaspaSigningBackendStatus, KaspaWasmPrivateKeySigner, type KeystoreCipherParams, type KeystoreKdfParams, KeystoreManager, type KeystorePayload, type KeystoreUnlockResult, type RealAccountStore, type RealDevAccount, type RealTxSigner, type RealTxSigningInput, type RealTxSigningResult, type ResolveAccountOptions, type SignTxPlanInput, type SignTxPlanResult, SimulatedSigner, SimulatedTxPlanSigner, UnsupportedKaspaKeyGenerator, UnsupportedRealKaspaSigner, UnsupportedRealTxSigner, assertSigningNetworkAllowed, createEmptyRealAccountStore, createLocalKaspaWallet, describeAccount, getDefaultRealAccountsPath, getKaspaSigningBackendStatus, getRealDevAccount, getRequiredEnv, importRealDevAccount, listHardkasAccounts, listRealDevAccounts, loadKaspaWasm, loadOrCreateRealAccountStore, loadRealAccountStore, loadRealAccountStoreSync, prepareEvmAccountExport, removeRealDevAccount, resolveHardkasAccount, resolveHardkasAccountAddress, resolveRealAccountOrAddress, saveRealAccountStore, signTxPlanArtifact, validateAccountName, validateAddressPrefix };
+declare const DEV_ACCOUNTS_PASSWORD = "hardkas-local-dev";
+declare function ensureDevAccounts(workspaceDir: string): Promise<void>;
+declare function getOrCreateDevAccount(workspaceDir: string, index: number, alias: string): Promise<GeneratedKaspaDevAccount>;
+declare function listDevAccountsSync(workspaceDir: string): {
+    name: string;
+    address: string;
+}[];
+
+export { type CreateKaspaWalletOptions, DEV_ACCOUNTS_PASSWORD, type EncryptedKeystoreV2, type EvmExportResult, type GeneratedKaspaDevAccount, type HardkasAccount, type HardkasAccountKind, type HardkasBaseAccount, type HardkasEvmPrivateKeyAccount, type HardkasExternalWalletAccount, type HardkasKaspaPrivateKeyAccount, type HardkasSigner, type HardkasSignerKind, type HardkasSimulatedAccount, type HardkasTxPlanSigner, type KaspaKeyGenerator, KaspaSdkKeyGenerator, type KaspaSdkKeyGeneratorOptions, KaspaSdkRealTxSigner, type KaspaSdkRealTxSignerOptions, type KaspaSigningBackendStatus, KaspaWasmPrivateKeySigner, type KeystoreCipherParams, type KeystoreKdfParams, KeystoreManager, type KeystorePayload, type KeystoreUnlockResult, type RealAccountStore, type RealDevAccount, type RealTxSigner, type RealTxSigningInput, type RealTxSigningResult, type ResolveAccountOptions, type SignTxPlanInput, type SignTxPlanResult, SimulatedSigner, SimulatedTxPlanSigner, UnsupportedKaspaKeyGenerator, UnsupportedRealKaspaSigner, UnsupportedRealTxSigner, assertSigningNetworkAllowed, createEmptyRealAccountStore, createLocalKaspaWallet, describeAccount, ensureDevAccounts, getDefaultRealAccountsPath, getKaspaSigningBackendStatus, getOrCreateDevAccount, getRealDevAccount, getRequiredEnv, importRealDevAccount, listDevAccountsSync, listHardkasAccounts, listRealDevAccounts, loadKaspaWasm, loadOrCreateRealAccountStore, loadRealAccountStore, loadRealAccountStoreSync, prepareEvmAccountExport, removeRealDevAccount, resolveHardkasAccount, resolveHardkasAccountAddress, resolveRealAccountOrAddress, saveRealAccountStore, signTxPlanArtifact, validateAccountName, validateAddressPrefix };

package/dist/index.js

@@ -23,8 +23,9 @@ import fs from "fs";
 import path from "path";
 import { writeFileAtomicSync } from "@hardkas/core";
 import { HARDKAS_VERSION, ARTIFACT_SCHEMAS, ARTIFACT_VERSION } from "@hardkas/artifacts";
-function getDefaultRealAccountsPath(cwd = process.cwd()) {
-  return path.join(cwd, ".hardkas", "accounts.real.json");
+function getDefaultRealAccountsPath(cwd) {
+  const root = cwd ?? process.cwd();
+  return path.join(root, ".hardkas", "accounts.real.json");
 }
 function createEmptyRealAccountStore() {
   return {
@@ -155,15 +156,34 @@ function resolveHardkasAccount(options) {
       address: nameOrAddress
     };
   }
-  if (config?.accounts && config.accounts[nameOrAddress]) {
-    const accConfig = config.accounts[nameOrAddress];
+  let alias = nameOrAddress;
+  if (alias === "0") alias = "alice";
+  if (alias === "1") alias = "bob";
+  const workspaceRoot = config?.cwd || process.cwd();
+  const devAccountPath = path2.join(workspaceRoot, ".hardkas", "dev-accounts", `${alias}.json`);
+  if (fs2.existsSync(devAccountPath)) {
+    try {
+      const data = fs2.readFileSync(devAccountPath, "utf-8");
+      const keystore = JSON.parse(data);
+      if (keystore.type === "hardkas.encryptedKeystore.v2") {
+        return {
+          name: alias,
+          kind: "kaspa-private-key",
+          address: keystore.metadata?.address
+        };
+      }
+    } catch (e) {
+    }
+  }
+  if (config?.accounts && config.accounts[alias]) {
+    const accConfig = config.accounts[alias];
     return {
-      name: nameOrAddress,
+      name: alias,
       ...accConfig
     };
   }
   const realStore = loadRealAccountStoreSync();
-  const realAcc = realStore ? getRealDevAccount(realStore, nameOrAddress) : null;
+  const realAcc = realStore ? getRealDevAccount(realStore, alias) : null;
   if (realAcc) {
     return {
       name: realAcc.name,
@@ -173,7 +193,7 @@ function resolveHardkasAccount(options) {
     };
   }
   const detAccounts = createDeterministicAccounts();
-  const det = detAccounts.find((a) => a.name === nameOrAddress);
+  const det = detAccounts.find((a) => a.name === alias);
   if (det) {
     return {
       name: det.name,
@@ -196,6 +216,28 @@ function listHardkasAccounts(config) {
       evmAddress: det.evmAddress
     });
   }
+  const workspaceRoot = config?.cwd || process.cwd();
+  const devAccountsDir = path2.join(workspaceRoot, ".hardkas", "dev-accounts");
+  if (fs2.existsSync(devAccountsDir)) {
+    const files = fs2.readdirSync(devAccountsDir);
+    for (const file of files) {
+      if (file.endsWith(".json")) {
+        try {
+          const name = path2.basename(file, ".json");
+          const data = fs2.readFileSync(path2.join(devAccountsDir, file), "utf-8");
+          const keystore = JSON.parse(data);
+          if (keystore.type === "hardkas.encryptedKeystore.v2") {
+            accounts.set(name, {
+              name,
+              kind: "kaspa-private-key",
+              address: keystore.payload?.address || keystore.metadata?.address
+            });
+          }
+        } catch (e) {
+        }
+      }
+    }
+  }
   const realStore = loadRealAccountStoreSync();
   if (realStore) {
     for (const realAcc of listRealDevAccounts(realStore)) {
@@ -208,6 +250,9 @@ function listHardkasAccounts(config) {
   }
   const keystoreDir = path2.join(process.cwd(), ".hardkas", "keystore");
   if (fs2.existsSync(keystoreDir)) {
+    if (!config || !config.cwd) {
+      throw new Error("Workspace root/cwd is required for hermetic keystore path resolution");
+    }
     const files = fs2.readdirSync(keystoreDir);
     for (const file of files) {
       if (file.endsWith(".json")) {
@@ -393,7 +438,10 @@ var KaspaWasmPrivateKeySigner = class {
         if (!u.outpoint.transactionId || u.outpoint.index === void 0) {
           throw new Error(`UTXO is missing transactionId or index. Re-run tx plan.`);
         }
-        const spk = u.scriptPublicKey || "mock-script";
+        const spk = u.scriptPublicKey;
+        if (!spk) {
+          throw new Error("UTXO is missing scriptPublicKey. Real signing flows must never fabricate cryptographic state.");
+        }
         return new sdk.UtxoEntry(
           BigInt(u.amountSompi),
           spk,
@@ -839,7 +887,105 @@ var KeystoreManager = class {
     }
   }
 };
+
+// src/dev-accounts.ts
+import fs4 from "fs";
+import path4 from "path";
+import crypto2 from "crypto";
+var DEV_ACCOUNTS_PASSWORD = "hardkas-local-dev";
+var SIMNET_DETERMINISTIC_SEED = "hardkas-deterministic-simnet-seed-v1";
+async function ensureDevAccounts(workspaceDir) {
+  const devAccountsDir = path4.join(workspaceDir, ".hardkas", "dev-accounts");
+  if (!fs4.existsSync(devAccountsDir)) {
+    await fs4.promises.mkdir(devAccountsDir, { recursive: true });
+  }
+  await getOrCreateDevAccount(workspaceDir, 0, "alice");
+  await getOrCreateDevAccount(workspaceDir, 1, "bob");
+}
+async function getOrCreateDevAccount(workspaceDir, index, alias) {
+  const devAccountsDir = path4.join(workspaceDir, ".hardkas", "dev-accounts");
+  const filePath = path4.join(devAccountsDir, `${alias}.json`);
+  if (fs4.existsSync(filePath)) {
+    const keystore2 = await KeystoreManager.loadEncryptedKeystore(filePath);
+    const unlock = await KeystoreManager.decryptEncryptedKeystore(keystore2, DEV_ACCOUNTS_PASSWORD);
+    if (!unlock.success || !unlock.payload) {
+      throw new Error(`Failed to decrypt dev account ${alias}. Expected password: ${DEV_ACCOUNTS_PASSWORD}`);
+    }
+    return {
+      address: unlock.payload.address,
+      privateKey: unlock.payload.privateKey,
+      publicKey: unlock.payload.publicKey
+    };
+  }
+  const seedString = `${SIMNET_DETERMINISTIC_SEED}-${index}`;
+  const privateKeyHex = crypto2.createHash("sha256").update(seedString).digest("hex");
+  let sdk;
+  try {
+    sdk = await import("@kaspa/core-lib");
+  } catch (e) {
+    console.warn(`
+[Warning] Kaspa SDK (@kaspa/core-lib) is not installed in the workspace.
+Could not generate dev account '${alias}'.`);
+    return { address: "", privateKey: "", publicKey: "" };
+  }
+  const privKey = new sdk.PrivateKey(privateKeyHex);
+  const pubKey = privKey.toPublicKey();
+  const address = pubKey.toAddress("simnet").toString();
+  const accountData = {
+    address,
+    privateKey: privKey.toString(),
+    publicKey: pubKey.toString()
+  };
+  if (!fs4.existsSync(devAccountsDir)) {
+    await fs4.promises.mkdir(devAccountsDir, { recursive: true });
+  }
+  const payload = {
+    address: accountData.address,
+    privateKey: accountData.privateKey,
+    network: "simnet"
+  };
+  if (accountData.publicKey) {
+    payload.publicKey = accountData.publicKey;
+  }
+  const keystore = await KeystoreManager.createEncryptedKeystore(
+    payload,
+    DEV_ACCOUNTS_PASSWORD,
+    {
+      label: alias,
+      network: "simnet"
+    }
+  );
+  await KeystoreManager.saveEncryptedKeystore(filePath, keystore);
+  return accountData;
+}
+function listDevAccountsSync(workspaceDir) {
+  const devAccountsDir = path4.join(workspaceDir, ".hardkas", "dev-accounts");
+  if (!fs4.existsSync(devAccountsDir)) {
+    return [];
+  }
+  const accounts = [];
+  const files = fs4.readdirSync(devAccountsDir);
+  for (const file of files) {
+    if (file.endsWith(".json")) {
+      const name = path4.basename(file, ".json");
+      try {
+        const data = fs4.readFileSync(path4.join(devAccountsDir, file), "utf-8");
+        const keystore = JSON.parse(data);
+        if (keystore.type === "hardkas.encryptedKeystore.v2") {
+          accounts.push({
+            name,
+            address: keystore.metadata?.address || ""
+          });
+        }
+      } catch (e) {
+      }
+    }
+  }
+  accounts.sort((a, b) => a.name.localeCompare(b.name));
+  return accounts;
+}
 export {
+  DEV_ACCOUNTS_PASSWORD,
   KaspaSdkKeyGenerator,
   KaspaSdkRealTxSigner,
   KaspaWasmPrivateKeySigner,
@@ -853,11 +999,14 @@ export {
   createEmptyRealAccountStore,
   createLocalKaspaWallet,
   describeAccount,
+  ensureDevAccounts,
   getDefaultRealAccountsPath,
   getKaspaSigningBackendStatus,
+  getOrCreateDevAccount,
   getRealDevAccount,
   getRequiredEnv,
   importRealDevAccount,
+  listDevAccountsSync,
   listHardkasAccounts,
   listRealDevAccounts,
   loadKaspaWasm,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/accounts",
-  "version": "0.6.0-alpha",
+  "version": "0.7.1-alpha",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -17,10 +17,10 @@
   ],
   "dependencies": {
     "hash-wasm": "^4.12.0",
-    "@hardkas/artifacts": "0.6.0-alpha",
-    "@hardkas/config": "0.6.0-alpha",
-    "@hardkas/localnet": "0.6.0-alpha",
-    "@hardkas/core": "0.6.0-alpha"
+    "@hardkas/artifacts": "0.7.1-alpha",
+    "@hardkas/config": "0.7.1-alpha",
+    "@hardkas/localnet": "0.7.1-alpha",
+    "@hardkas/core": "0.7.1-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",