@hardkas/accounts 0.5.5-alpha → 0.7.0-alpha

package/dist/index.d.ts

@@ -52,6 +52,7 @@ interface HardkasBaseAccount {
 interface HardkasSimulatedAccount extends HardkasBaseAccount {
     kind: "simulated";
     address: string;
+    evmAddress?: string;
 }
 interface HardkasKaspaPrivateKeyAccount extends HardkasBaseAccount {
     kind: "kaspa-private-key";
@@ -107,7 +108,7 @@ interface ResolveAccountOptions {
 }
 declare function resolveHardkasAccount(options: ResolveAccountOptions): HardkasAccount;
 declare function listHardkasAccounts(config?: HardkasConfig): HardkasAccount[];
-declare function resolveHardkasAccountAddress(accountOrAddress: string, config?: HardkasConfig): string;
+declare function resolveHardkasAccountAddress(accountOrAddress: string, config?: HardkasConfig, context?: "L1" | "L2"): string;
 declare function describeAccount(account: HardkasAccount): Record<string, unknown>;
 
 interface EvmExportResult {
@@ -264,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;

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 {
@@ -178,7 +179,8 @@ function resolveHardkasAccount(options) {
     return {
       name: det.name,
       kind: "simulated",
-      address: det.address
+      address: det.address,
+      evmAddress: det.evmAddress
     };
   }
   const available = listHardkasAccounts(config).map((a) => a.name).join(", ");
@@ -191,7 +193,8 @@ function listHardkasAccounts(config) {
     accounts.set(det.name, {
       name: det.name,
       kind: "simulated",
-      address: det.address
+      address: det.address,
+      evmAddress: det.evmAddress
     });
   }
   const realStore = loadRealAccountStoreSync();
@@ -206,6 +209,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")) {
@@ -236,11 +242,24 @@ function listHardkasAccounts(config) {
   }
   return Array.from(accounts.values());
 }
-function resolveHardkasAccountAddress(accountOrAddress, config) {
+function resolveHardkasAccountAddress(accountOrAddress, config, context = "L1") {
   if (accountOrAddress.startsWith("kaspa:") || accountOrAddress.startsWith("kaspatest:") || accountOrAddress.startsWith("kaspasim:")) {
+    if (context === "L2") {
+      throw new Error(`Invalid L2 address provided: ${accountOrAddress}. Expected EVM address or account alias.`);
+    }
+    return accountOrAddress;
+  }
+  if (accountOrAddress.startsWith("0x") && accountOrAddress.length === 42) {
     return accountOrAddress;
   }
   const account = resolveHardkasAccount({ nameOrAddress: accountOrAddress, config });
+  if (context === "L2") {
+    const evmAddress = account.evmAddress;
+    if (!evmAddress) {
+      throw new Error(`Account '${account.name}' does not have an EVM address configured for L2.`);
+    }
+    return evmAddress;
+  }
   if (!account.address) {
     throw new Error(`Account '${account.name}' does not have a resolved address yet.`);
   }
@@ -319,6 +338,7 @@ import {
   calculateContentHash as calculateContentHash2,
   HARDKAS_VERSION as HARDKAS_VERSION2
 } from "@hardkas/artifacts";
+import { systemRuntimeContext } from "@hardkas/core";
 
 // src/signer-backend.ts
 async function loadKaspaWasm() {
@@ -377,7 +397,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,
@@ -455,9 +478,10 @@ var UnsupportedRealKaspaSigner = class {
 };
 async function signTxPlanArtifact(input) {
   const { planArtifact, account } = input;
+  const planRecord = planArtifact;
   if (planArtifact.schema === "hardkas.txPlan") {
-  } else if (planArtifact.status !== "built" && planArtifact.status !== "unsigned") {
-    throw new Error(`Cannot sign artifact with status: ${planArtifact.status}`);
+  } else if (planRecord.status !== "built" && planRecord.status !== "unsigned") {
+    throw new Error(`Cannot sign artifact with status: ${planRecord.status}`);
   }
   if (planArtifact.mode === "simulated") {
     if (account.kind !== "simulated") {
@@ -474,7 +498,8 @@ async function signTxPlanArtifact(input) {
   if (account.kind === "simulated") {
     return createSimulatedSignedTxArtifact(
       planArtifact,
-      `simulated-signed-tx:${planArtifact.planId}`
+      `simulated-signed-tx:${planArtifact.planId}`,
+      systemRuntimeContext
     );
   }
   if (account.kind === "kaspa-private-key") {
@@ -520,7 +545,8 @@ async function signTxPlanArtifact(input) {
   if (account.kind === "evm-private-key") {
     throw new Error("EVM accounts are reserved for future Igra support and cannot sign Kaspa L1 transactions.");
   }
-  throw new Error(`Unsupported account kind for signing: ${account.kind}`);
+  const accountRecord = account;
+  throw new Error(`Unsupported account kind for signing: ${accountRecord.kind}`);
 }
 
 // src/kaspa-sdk-keygen.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/accounts",
-  "version": "0.5.5-alpha",
+  "version": "0.7.0-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.5.5-alpha",
-    "@hardkas/localnet": "0.5.5-alpha",
-    "@hardkas/config": "0.5.5-alpha",
-    "@hardkas/core": "0.5.5-alpha"
+    "@hardkas/artifacts": "0.7.0-alpha",
+    "@hardkas/localnet": "0.7.0-alpha",
+    "@hardkas/config": "0.7.0-alpha",
+    "@hardkas/core": "0.7.0-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",