@hardkas/sdk 0.7.6-alpha → 0.7.7-alpha

package/dist/index.d.ts

@@ -30,6 +30,24 @@ declare class HardkasAccounts {
         sompi: bigint;
         formatted: string;
     }>;
+    /**
+     * Alias for getBalance.
+     */
+    balance(accountNameOrAddress: string): Promise<{
+        sompi: bigint;
+        formatted: string;
+    }>;
+    /**
+     * Lists all configured account names.
+     */
+    list(): Promise<string[]>;
+    /**
+     * Funds an account from another account (defaults to 'default' account).
+     */
+    fund(accountNameOrAddress: string, options?: {
+        from?: string;
+        amount?: string | bigint;
+    }): Promise<any>;
 }
 
 /**
@@ -73,6 +91,14 @@ declare class HardkasTx {
         receipt: TxReceiptArtifact;
         receiptPath: string;
     }>;
+    /**
+     * Explicitly appends a signature to a partially signed transaction.
+     */
+    appendSignature(plan: SignedTxArtifact, account?: HardkasAccount | string): Promise<SignedTxArtifact>;
+    /**
+     * Fetches the current status of a transaction by ID.
+     */
+    status(txId: string): Promise<any>;
 }
 
 /**
@@ -217,6 +243,14 @@ declare class HardkasArtifactsManager {
      * Reads an artifact by path or ID/hash from the workspace.
      */
     read(id: string): Promise<any>;
+    /**
+     * Alias for read().
+     */
+    get(id: string): Promise<any>;
+    /**
+     * Lists all artifacts in the workspace.
+     */
+    list(): Promise<any[]>;
 }
 
 interface WorkflowRunOptions {

package/dist/index.js

@@ -40,6 +40,36 @@ var HardkasAccounts = class {
       formatted: formatSompi(sompi)
     };
   }
+  /**
+   * Alias for getBalance.
+   */
+  async balance(accountNameOrAddress) {
+    return this.getBalance(accountNameOrAddress);
+  }
+  /**
+   * Lists all configured account names.
+   */
+  async list() {
+    return Object.keys(this.sdk.config.config.accounts || {});
+  }
+  /**
+   * Funds an account from another account (defaults to 'default' account).
+   */
+  async fund(accountNameOrAddress, options) {
+    const from = options?.from || "default";
+    const amount = options?.amount || "1000000000";
+    const plan = await this.sdk.tx.plan({
+      from,
+      to: accountNameOrAddress,
+      amount
+    });
+    const signed = await this.sdk.tx.sign(plan, from);
+    if (this.sdk.network === "simulated") {
+      return this.sdk.tx.simulate(signed);
+    } else {
+      return this.sdk.tx.send(signed);
+    }
+  }
 };
 
 // src/tx.ts
@@ -78,6 +108,9 @@ var HardkasTx = class {
     if (!toAccount.address)
       throw new Error(`To account ${toAccount.name} has no address.`);
     const amountSompi = typeof options.amount === "string" ? parseKasToSompi(options.amount) : typeof options.amount === "number" ? BigInt(options.amount) : options.amount;
+    if (amountSompi === 0n) {
+      throw new Error("Kaspa value-transfer outputs require amount > 0.\nFor metadata/notary/DID marker transactions use --amount 1.\nFuture: hardkas tx anchor.");
+    }
     let builderUtxos = [];
     if (this.sdk.network === "simulated") {
       const { loadOrCreateLocalnetState, getSpendableUtxos } = await import("@hardkas/localnet");
@@ -160,6 +193,9 @@ var HardkasTx = class {
           "Cannot append signature to an already completed signed transaction."
         );
       }
+      if (options?.append === void 0 && plan.status === "partially_signed") {
+        options = { ...options, append: true };
+      }
       if (!options?.append) {
         throw new Error(
           "Input file is a partially signed transaction. Use the --append flag to add your signature."
@@ -247,7 +283,12 @@ var HardkasTx = class {
         if (!signerAddress) {
           throw new Error(`Signer account '${resolvedAccount.name}' has no address.`);
         }
-        const requiredSigners = options?.requiredSigners || [signerAddress];
+        const requiredSignersList = options?.requiredSigners || [signerAddress];
+        const requiredSigners = [];
+        for (const r of requiredSignersList) {
+          const acc = await this.sdk.accounts.resolve(r);
+          requiredSigners.push(acc.address || r);
+        }
         if (!requiredSigners.includes(signerAddress)) {
           throw new Error(
             `Signer '${signerAddress}' is not an authorized signer for this transaction.`
@@ -514,6 +555,23 @@ var HardkasTx = class {
       receiptPath
     };
   }
+  /**
+   * Explicitly appends a signature to a partially signed transaction.
+   */
+  async appendSignature(plan, account) {
+    return this.sign(plan, account, { append: true });
+  }
+  /**
+   * Fetches the current status of a transaction by ID.
+   */
+  async status(txId) {
+    const isLocal = txId.startsWith("simulated-");
+    if (isLocal) {
+      return { status: "simulated_confirmed" };
+    }
+    const result = await this.sdk.rpc.getTransaction(txId);
+    return result;
+  }
 };
 
 // src/l2.ts
@@ -1019,6 +1077,33 @@ var HardkasArtifactsManager = class {
     }
     return readArtifact(filePath);
   }
+  /**
+   * Alias for read().
+   */
+  async get(id) {
+    return this.read(id);
+  }
+  /**
+   * Lists all artifacts in the workspace.
+   */
+  async list() {
+    if (!fs3.existsSync(this.workspace.artifactsDir)) {
+      return [];
+    }
+    const { readArtifact } = await import("@hardkas/artifacts");
+    const files = fs3.readdirSync(this.workspace.artifactsDir);
+    const artifacts = [];
+    for (const file of files) {
+      if (file.endsWith(".json")) {
+        try {
+          const artifact = await readArtifact(path3.join(this.workspace.artifactsDir, file));
+          artifacts.push(artifact);
+        } catch (e) {
+        }
+      }
+    }
+    return artifacts;
+  }
 };
 
 // src/workflow.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/sdk",
-  "version": "0.7.6-alpha",
+  "version": "0.7.7-alpha",
   "type": "module",
   "files": [
     "dist",
@@ -23,23 +23,23 @@
     }
   },
   "dependencies": {
-    "@hardkas/config": "0.7.6-alpha",
-    "@hardkas/artifacts": "0.7.6-alpha",
-    "@hardkas/accounts": "0.7.6-alpha",
-    "@hardkas/core": "0.7.6-alpha",
-    "@hardkas/l2": "0.7.6-alpha",
-    "@hardkas/simulator": "0.7.6-alpha",
-    "@hardkas/localnet": "0.7.6-alpha",
-    "@hardkas/query": "0.7.6-alpha",
-    "@hardkas/tx-builder": "0.7.6-alpha",
-    "@hardkas/wallet-adapter": "0.7.6-alpha",
-    "@hardkas/kaspa-rpc": "0.7.6-alpha"
+    "@hardkas/artifacts": "0.7.7-alpha",
+    "@hardkas/accounts": "0.7.7-alpha",
+    "@hardkas/core": "0.7.7-alpha",
+    "@hardkas/kaspa-rpc": "0.7.7-alpha",
+    "@hardkas/localnet": "0.7.7-alpha",
+    "@hardkas/query": "0.7.7-alpha",
+    "@hardkas/config": "0.7.7-alpha",
+    "@hardkas/simulator": "0.7.7-alpha",
+    "@hardkas/tx-builder": "0.7.7-alpha",
+    "@hardkas/l2": "0.7.7-alpha",
+    "@hardkas/wallet-adapter": "0.7.7-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
-    "@hardkas/query-store": "0.7.6-alpha"
+    "@hardkas/query-store": "0.7.7-alpha"
   },
   "license": "MIT",
   "author": "Javier Rodriguez",