@hardkas/accounts 0.11.0-alpha → 0.11.2-alpha

package/dist/chunk-7QKDZQBR.js

@@ -0,0 +1,46 @@
+// src/signer-backend.ts
+async function loadKaspaWasm() {
+  try {
+    return await import("kaspa-wasm");
+  } catch (error) {
+    const err = new Error(
+      "SIGNER_BACKEND_UNAVAILABLE: Official Kaspa WASM backend is required to sign transactions.\nInstall it via: npm install kaspa-wasm"
+    );
+    err.code = "SIGNER_BACKEND_UNAVAILABLE";
+    throw err;
+  }
+}
+function detectCapabilities(sdk) {
+  let v1 = false;
+  if (sdk.createTransaction && sdk.createTransaction.length >= 8) {
+    v1 = true;
+  }
+  if (sdk.createV1Transaction || sdk.Transaction && sdk.Transaction.prototype && sdk.Transaction.prototype.computeBudget) {
+    v1 = true;
+  }
+  return { transactionV1Signing: v1 };
+}
+async function getKaspaSigningBackendStatus() {
+  try {
+    const sdk = await loadKaspaWasm();
+    return {
+      available: true,
+      name: "Kaspa WASM SDK",
+      version: sdk.version || "unknown",
+      capabilities: detectCapabilities(sdk)
+    };
+  } catch (error) {
+    return {
+      available: false,
+      name: "None",
+      error: error instanceof Error ? error.message : String(error),
+      capabilities: { transactionV1Signing: false }
+    };
+  }
+}
+
+export {
+  loadKaspaWasm,
+  detectCapabilities,
+  getKaspaSigningBackendStatus
+};

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { HardkasConfig } from '@hardkas/config';
 import { TxPlanArtifact, SignedTxArtifact, ExternalHardkasSigner, HardkasArtifactBase } from '@hardkas/artifacts';
 import { NetworkId } from '@hardkas/core';
+import { TxPlan } from '@hardkas/tx-builder';
 
 type HardkasAccountKind = "simulated" | "kaspa-private-key" | "external-wallet" | "evm-private-key";
 interface KeystorePayload {
@@ -162,12 +163,21 @@ interface KaspaSigningBackendStatus {
     name: string;
     version?: string;
     error?: string;
+    capabilities: {
+        transactionV1Signing: boolean;
+    };
 }
 /**
  * Loads the official Kaspa WASM SDK dynamically.
  * This ensures the toolkit remains usable even if the SDK is not installed.
  */
 declare function loadKaspaWasm(): Promise<any>;
+/**
+ * Detects the specific capabilities supported by the installed kaspa-wasm SDK.
+ */
+declare function detectCapabilities(sdk: any): {
+    transactionV1Signing: boolean;
+};
 /**
  * Checks if the Kaspa WASM SDK is available without throwing.
  */
@@ -297,7 +307,7 @@ declare function resolveRealAccountOrAddress(store: RealAccountStore | null, nam
 };
 
 interface RealTxSigningInput {
-    readonly plan: TxPlanArtifact;
+    readonly plan: TxPlan;
     readonly account: RealDevAccount;
 }
 interface RealTxSigningResult {
@@ -522,4 +532,4 @@ declare class WalletStateStoreJson {
     nextChangeIndex(walletId: string): number;
 }
 
-export { AddressManager, type ChainType, type CreateKaspaWalletOptions, DEV_ACCOUNTS_PASSWORD, type DeriveRequest, type DerivedAddress, type EncryptedKeystoreV2, type EvmExportResult, type GeneratedKaspaDevAccount, type HardkasAccount, type HardkasAccountKind, type HardkasBaseAccount, type HardkasEvmPrivateKeyAccount, type HardkasExternalWalletAccount, HardkasFixtureSigner, type HardkasKaspaPrivateKeyAccount, type HardkasSigner, type HardkasSignerKind, type HardkasSimulatedAccount, type HardkasTxPlanSigner, type HelperDeriveRequest, type KaspaKeyGenerator, KaspaSdkKeyGenerator, type KaspaSdkKeyGeneratorOptions, KaspaSdkRealTxSigner, type KaspaSdkRealTxSignerOptions, type KaspaSigningBackendStatus, KaspaWasmPrivateKeySigner, type KeystoreCipherParams, type KeystoreKdfParams, KeystoreManager, type KeystorePayload, type KeystoreUnlockResult, type NetworkType, type PathRequest, type RealAccountStore, type RealDevAccount, type RealTxSigner, type RealTxSigningInput, type RealTxSigningResult, type ResolveAccountOptions, type SignTxPlanInput, type SignTxPlanResult, SimulatedSigner, SimulatedTxPlanSigner, UnsupportedKaspaKeyGenerator, UnsupportedRealKaspaSigner, UnsupportedRealTxSigner, type WalletArtifact, type WalletClaims, type WalletCreateRequest, type WalletImportRequest, WalletManager, WalletManagerImpl, type WalletMetadata, type WalletState, WalletStateStoreJson, type WalletStateStoreOptions, appendToKeystoreJson, 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, validateAddressNetwork, validateAddressPrefix, withKeystoreLock };
+export { AddressManager, type ChainType, type CreateKaspaWalletOptions, DEV_ACCOUNTS_PASSWORD, type DeriveRequest, type DerivedAddress, type EncryptedKeystoreV2, type EvmExportResult, type GeneratedKaspaDevAccount, type HardkasAccount, type HardkasAccountKind, type HardkasBaseAccount, type HardkasEvmPrivateKeyAccount, type HardkasExternalWalletAccount, HardkasFixtureSigner, type HardkasKaspaPrivateKeyAccount, type HardkasSigner, type HardkasSignerKind, type HardkasSimulatedAccount, type HardkasTxPlanSigner, type HelperDeriveRequest, type KaspaKeyGenerator, KaspaSdkKeyGenerator, type KaspaSdkKeyGeneratorOptions, KaspaSdkRealTxSigner, type KaspaSdkRealTxSignerOptions, type KaspaSigningBackendStatus, KaspaWasmPrivateKeySigner, type KeystoreCipherParams, type KeystoreKdfParams, KeystoreManager, type KeystorePayload, type KeystoreUnlockResult, type NetworkType, type PathRequest, type RealAccountStore, type RealDevAccount, type RealTxSigner, type RealTxSigningInput, type RealTxSigningResult, type ResolveAccountOptions, type SignTxPlanInput, type SignTxPlanResult, SimulatedSigner, SimulatedTxPlanSigner, UnsupportedKaspaKeyGenerator, UnsupportedRealKaspaSigner, UnsupportedRealTxSigner, type WalletArtifact, type WalletClaims, type WalletCreateRequest, type WalletImportRequest, WalletManager, WalletManagerImpl, type WalletMetadata, type WalletState, WalletStateStoreJson, type WalletStateStoreOptions, appendToKeystoreJson, assertSigningNetworkAllowed, createEmptyRealAccountStore, createLocalKaspaWallet, describeAccount, detectCapabilities, ensureDevAccounts, getDefaultRealAccountsPath, getKaspaSigningBackendStatus, getOrCreateDevAccount, getRealDevAccount, getRequiredEnv, importRealDevAccount, listDevAccountsSync, listHardkasAccounts, listRealDevAccounts, loadKaspaWasm, loadOrCreateRealAccountStore, loadRealAccountStore, loadRealAccountStoreSync, prepareEvmAccountExport, removeRealDevAccount, resolveHardkasAccount, resolveHardkasAccountAddress, resolveRealAccountOrAddress, saveRealAccountStore, signTxPlanArtifact, validateAccountName, validateAddressNetwork, validateAddressPrefix, withKeystoreLock };

package/dist/index.js

@@ -1,3 +1,9 @@
+import {
+  detectCapabilities,
+  getKaspaSigningBackendStatus,
+  loadKaspaWasm
+} from "./chunk-7QKDZQBR.js";
+
 // src/simulated.ts
 var SimulatedSigner = class {
   constructor(account) {
@@ -534,35 +540,6 @@ import {
 } from "@hardkas/artifacts";
 import { systemRuntimeContext } from "@hardkas/core";
 
-// src/signer-backend.ts
-async function loadKaspaWasm() {
-  try {
-    return await import("kaspa-wasm");
-  } catch (error) {
-    const err = new Error(
-      "SIGNER_BACKEND_UNAVAILABLE: Official Kaspa WASM backend is required to sign transactions.\nInstall it via: npm install kaspa-wasm"
-    );
-    err.code = "SIGNER_BACKEND_UNAVAILABLE";
-    throw err;
-  }
-}
-async function getKaspaSigningBackendStatus() {
-  try {
-    const sdk = await loadKaspaWasm();
-    return {
-      available: true,
-      name: "Kaspa WASM SDK",
-      version: sdk.version || "unknown"
-    };
-  } catch (error) {
-    return {
-      available: false,
-      name: "None",
-      error: error instanceof Error ? error.message : String(error)
-    };
-  }
-}
-
 // src/kaspa-wasm-signer.ts
 import { calculateContentHash } from "@hardkas/artifacts";
 
@@ -930,6 +907,13 @@ var KaspaWasmPrivateKeySigner = class {
     const plan = input.planArtifact;
     const account = this.options.account;
     const sdk = await loadKaspaWasm();
+    const { detectCapabilities: detectCapabilities2 } = await import("./signer-backend-T4JT2RCK.js");
+    const capabilities = detectCapabilities2(sdk);
+    if (plan.computeBudget !== void 0 || plan.outputs.some((o) => o.covenant)) {
+      if (!capabilities.transactionV1Signing) {
+        throw new Error("Transaction V1 signing is not supported by the installed kaspa-wasm version");
+      }
+    }
     assertSigningNetworkAllowed({
       network: plan.networkId,
       mode: plan.mode,
@@ -1424,11 +1408,6 @@ var KaspaSdkRealTxSigner = class {
     if (!account.privateKey) {
       throw new Error("Account has no private key available for signing.");
     }
-    if (plan.from.address !== account.address) {
-      throw new Error(
-        `Address mismatch: Plan requires ${plan.from.address}, but account has ${account.address}.`
-      );
-    }
     try {
       const privateKey = new sdk.PrivateKey(account.privateKey);
       const utxos = plan.inputs.map((u) => {
@@ -1437,19 +1416,30 @@ var KaspaSdkRealTxSigner = class {
             `UTXO ${u.outpoint.transactionId}:${u.outpoint.index} is missing scriptPublicKey required for signing.`
           );
         }
-        const spk = u.scriptPublicKey;
-        return new sdk.UtxoEntry(
-          BigInt(u.amountSompi),
-          spk,
-          u.outpoint.transactionId,
-          u.outpoint.index,
-          plan.from.address
-        );
+        let spkHex = String(u.scriptPublicKey);
+        let spkVersion = 0;
+        if (spkHex.length >= 68) {
+          spkVersion = parseInt(spkHex.slice(0, 4), 16) || 0;
+          spkHex = spkHex.slice(4);
+        }
+        return {
+          address: account.address,
+          outpoint: {
+            transactionId: u.outpoint.transactionId,
+            index: u.outpoint.index
+          },
+          utxoEntry: {
+            amount: BigInt(u.amountSompi),
+            scriptPublicKey: new sdk.ScriptPublicKey(spkVersion, spkHex),
+            blockDaaScore: BigInt(u.blockDaaScore ?? 0),
+            isCoinbase: u.isCoinbase ?? false
+          }
+        };
       });
-      const outputs = [
-        new sdk.PaymentOutput(new sdk.Address(plan.to.address), BigInt(plan.amountSompi))
-      ];
-      const changeAddress = plan.change ? new sdk.Address(plan.change.address) : void 0;
+      const outputs = plan.outputs.map(
+        (o) => new sdk.PaymentOutput(new sdk.Address(o.address), BigInt(o.amountSompi))
+      );
+      const changeAddress = plan.change ? plan.change.address : account.address;
       const priorityFee = BigInt(plan.estimatedFeeSompi);
       const unsignedTx = sdk.createTransaction(
         utxos,
@@ -1458,17 +1448,22 @@ var KaspaSdkRealTxSigner = class {
         priorityFee
       );
       const signedTx = sdk.signTransaction(unsignedTx, [privateKey], true);
-      const payload = signedTx.serialize ? signedTx.serialize() : JSON.stringify(signedTx.toRpcTransaction());
-      const txId = signedTx.id;
+      const innerTx = signedTx.tx;
+      const txId = innerTx?.id;
+      const payload = JSON.stringify(
+        innerTx.toJSON(),
+        (_k, v) => typeof v === "bigint" ? v.toString() : v
+      );
       return {
         signedTransaction: {
           format: "kaspa-sdk",
-          payload
+          payload,
+          raw: innerTx
         },
         txId
       };
     } catch (e) {
-      const msg = e instanceof Error ? e instanceof Error ? e instanceof Error ? e.message : String(e) : String(e) : String(e);
+      const msg = e instanceof Error ? e.message : String(e);
       if (msg.includes("is not a constructor") || msg.includes("is not a function")) {
         throw new Error(
           `Kaspa SDK signer adapter could not find required transaction signing primitives: ${msg}`
@@ -1560,6 +1555,8 @@ async function appendToKeystoreJson(workspaceRoot, alias, accountData) {
 
 // src/address-manager.ts
 import { createHash } from "crypto";
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
 function resolveChain(chain) {
   if (chain === "receive" || chain === 0) return 0;
   if (chain === "change" || chain === 1) return 1;
@@ -1588,9 +1585,16 @@ var AddressManager = {
       addressIndex: opts.addressIndex
     });
     const payload = `${opts.seedRef}:${derivationPath}:${network}`;
-    const hash = createHash("sha256").update(payload).digest("hex").slice(0, 42);
-    const prefix = network.includes("sim") ? "kaspasim" : "kaspatest";
-    const address = `${prefix}:q${hash}`;
+    const hash = createHash("sha256").update(payload).digest("hex");
+    let address;
+    try {
+      const kaspa = require2("kaspa-wasm");
+      const priv = new kaspa.PrivateKey(hash);
+      address = priv.toKeypair().toAddress(network).toString();
+    } catch (e) {
+      const prefix = network.includes("sim") ? "kaspasim" : "kaspatest";
+      address = `${prefix}:q${hash.slice(0, 42)}`;
+    }
     return {
       address,
       path: derivationPath,
@@ -1791,6 +1795,7 @@ export {
   createEmptyRealAccountStore,
   createLocalKaspaWallet,
   describeAccount,
+  detectCapabilities,
   ensureDevAccounts,
   getDefaultRealAccountsPath,
   getKaspaSigningBackendStatus,

package/dist/signer-backend-T4JT2RCK.js

@@ -0,0 +1,10 @@
+import {
+  detectCapabilities,
+  getKaspaSigningBackendStatus,
+  loadKaspaWasm
+} from "./chunk-7QKDZQBR.js";
+export {
+  detectCapabilities,
+  getKaspaSigningBackendStatus,
+  loadKaspaWasm
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/accounts",
-  "version": "0.11.0-alpha",
+  "version": "0.11.2-alpha",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -19,10 +19,11 @@
   "dependencies": {
     "hash-wasm": "^4.12.0",
     "kaspa-wasm": "0.13.0",
-    "@hardkas/artifacts": "0.11.0-alpha",
-    "@hardkas/config": "0.11.0-alpha",
-    "@hardkas/core": "0.11.0-alpha",
-    "@hardkas/localnet": "0.11.0-alpha"
+    "@hardkas/artifacts": "0.11.2-alpha",
+    "@hardkas/config": "0.11.2-alpha",
+    "@hardkas/core": "0.11.2-alpha",
+    "@hardkas/tx-builder": "0.11.2-alpha",
+    "@hardkas/localnet": "0.11.2-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",