@hardkas/accounts 0.7.0-alpha → 0.7.3-alpha

package/dist/index.d.ts

@@ -367,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

@@ -156,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,
@@ -174,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,
@@ -197,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)) {
@@ -563,7 +604,7 @@ var KaspaSdkKeyGenerator = class {
         return await rawLoader();
       } catch (e) {
         throw new Error(
-          "Kaspa SDK key generation dependency is not installed. Install/configure the supported Kaspa WASM SDK adapter. Use 'hardkas accounts real import' to add accounts manually for now."
+          "Kaspa cryptography adapter missing. Real account generation requires WASM execution.\nRun: npm install @kaspa/wallet-wasm\nUse 'hardkas accounts real import' to add accounts manually for now."
         );
       }
     };
@@ -846,7 +887,109 @@ 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 sdkModule;
+  try {
+    sdkModule = await import(
+      /* @vite-ignore */
+      "@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 sdk = sdkModule.default || sdkModule;
+  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,
@@ -860,11 +1003,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.7.0-alpha",
+  "version": "0.7.3-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.7.0-alpha",
-    "@hardkas/localnet": "0.7.0-alpha",
-    "@hardkas/config": "0.7.0-alpha",
-    "@hardkas/core": "0.7.0-alpha"
+    "@hardkas/artifacts": "0.7.3-alpha",
+    "@hardkas/core": "0.7.3-alpha",
+    "@hardkas/config": "0.7.3-alpha",
+    "@hardkas/localnet": "0.7.3-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",