@hardkas/tx-builder 0.8.5-alpha → 0.8.9-alpha

package/dist/index.d.ts

@@ -48,6 +48,14 @@ declare function estimateTransactionMass(input: {
  */
 declare function estimateFeeFromMass(mass: bigint, feeRateSompiPerMass: bigint): bigint;
 
+/**
+ * Kaspa dust threshold in sompi.
+ * Based on the rusty-kaspa wallet heuristic for standard P2PK outputs:
+ *   value * 1000 / (STANDARD_OUTPUT_SIZE_PLUS_INPUT_SIZE * 3) < MINIMUM_RELAY_TRANSACTION_FEE
+ * For standard outputs this equates to ~546 sompi.
+ * We use 600 as a conservative margin, consistent with the localnet.
+ */
+declare const DUST_THRESHOLD_SOMPI = 600n;
 type SemanticVerificationSeverity = "info" | "warning" | "error" | "critical";
 interface SemanticVerificationIssue {
     code: string;
@@ -147,4 +155,4 @@ declare function createMockUtxo(input: {
     readonly index?: number;
 }): Utxo;
 
-export { KASPA_MASS_CONSTANTS, type MassBreakdown, type MassEstimateResult, type Outpoint, type SemanticVerificationIssue, type SemanticVerificationResult, type SemanticVerificationSeverity, type SemanticVerifyContext, type Sompi, type TxBuildRequest, type TxOutput, type TxPlan, type Utxo, buildPaymentPlan, createMockUtxo, estimateFeeFromMass, estimateMass, estimateTransactionMass, verifySignedTxSemantics, verifyTxPlanSemantics, verifyTxReceiptSemantics };
+export { DUST_THRESHOLD_SOMPI, KASPA_MASS_CONSTANTS, type MassBreakdown, type MassEstimateResult, type Outpoint, type SemanticVerificationIssue, type SemanticVerificationResult, type SemanticVerificationSeverity, type SemanticVerifyContext, type Sompi, type TxBuildRequest, type TxOutput, type TxPlan, type Utxo, buildPaymentPlan, createMockUtxo, estimateFeeFromMass, estimateMass, estimateTransactionMass, verifySignedTxSemantics, verifyTxPlanSemantics, verifyTxReceiptSemantics };

package/dist/index.js

@@ -64,6 +64,7 @@ function estimateFeeFromMass(mass, feeRateSompiPerMass) {
 }
 
 // src/verify.ts
+var DUST_THRESHOLD_SOMPI = 600n;
 function verifyTxPlanSemantics(plan, context = {}) {
   const issues = [];
   const addIssue = (code, severity, message, path) => {
@@ -145,20 +146,20 @@ function verifyTxPlanSemantics(plan, context = {}) {
         `outputs[${i}]`
       );
     }
-    if (BigInt(o.amountSompi) < 600n) {
+    if (BigInt(o.amountSompi) < DUST_THRESHOLD_SOMPI) {
       addIssue(
         "DUST_OUTPUT",
-        "warning",
-        `Output ${i} might be dust: ${o.amountSompi} sompi`,
+        "error",
+        `Output ${i} is below dust threshold (${DUST_THRESHOLD_SOMPI} sompi): ${o.amountSompi} sompi`,
         `outputs[${i}]`
       );
     }
   });
-  if (plan.change && BigInt(plan.change.amountSompi) < 600n) {
+  if (plan.change && BigInt(plan.change.amountSompi) < DUST_THRESHOLD_SOMPI) {
     addIssue(
       "DUST_CHANGE",
-      "warning",
-      `Change output might be dust: ${plan.change.amountSompi} sompi`,
+      "error",
+      `Change output is below dust threshold (${DUST_THRESHOLD_SOMPI} sompi): ${plan.change.amountSompi} sompi`,
       "change"
     );
   }
@@ -319,7 +320,7 @@ function buildPaymentPlan(request) {
     const estimatedFeeSompi = estimatedMass * request.feeRateSompiPerMass;
     if (selectedAmount >= target + estimatedFeeSompi) {
       const changeAmount = selectedAmount - target - estimatedFeeSompi;
-      const hasActualChange = changeAmount > 0n;
+      const hasActualChange = changeAmount >= DUST_THRESHOLD_SOMPI;
       let finalMass = estimatedMass;
       let finalFee = estimatedFeeSompi;
       if (!hasActualChange) {
@@ -376,6 +377,7 @@ function createMockUtxo(input) {
   };
 }
 export {
+  DUST_THRESHOLD_SOMPI,
   KASPA_MASS_CONSTANTS,
   buildPaymentPlan,
   createMockUtxo,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/tx-builder",
-  "version": "0.8.5-alpha",
+  "version": "0.8.9-alpha",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,7 +12,7 @@
     }
   },
   "dependencies": {
-    "@hardkas/core": "0.8.5-alpha"
+    "@hardkas/core": "0.8.9-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",