polkadot-cli 0.6.1 → 0.6.2

package/README.md

@@ -144,10 +144,20 @@ Both dry-run and submission display the encoded call hex and a decoded human-rea
   Call:   0x0001076465616462656566
   Decode: System.remark(remark: 0xdeadbeef)
   Tx:     0xabc123...
-  Block:  #12345678 (0xdef...)
   Status: ok
 ```
 
+#### Exit codes
+
+The CLI exits with code **1** when a finalized transaction has a dispatch error (e.g. insufficient balance, bad origin). The full transaction output (events, explorer links) is still printed before the error so you can debug the failure. Module errors are formatted as `PalletName.ErrorVariant` (e.g. `Balances.InsufficientBalance`).
+
+```bash
+dot tx Balances.transferKeepAlive 5FHneW46... 999999999999999999 --from alice
+# ... events and explorer links ...
+# Error: Transaction dispatch error: Balances.InsufficientBalance
+echo $?  # 1
+```
+
 #### Custom signed extensions
 
 Chains with non-standard signed extensions (e.g. `people-preview`) are auto-handled:

package/dist/cli.mjs

@@ -5,7 +5,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // src/cli.ts
 import cac from "cac";
 // package.json
-var version = "0.6.1";
+var version = "0.6.2";
 
 // src/config/accounts-store.ts
 import { access as access2, mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
@@ -216,6 +216,7 @@ var isTTY = process.stdout.isTTY ?? false;
 var RESET = isTTY ? "\x1B[0m" : "";
 var CYAN = isTTY ? "\x1B[36m" : "";
 var GREEN = isTTY ? "\x1B[32m" : "";
+var RED = isTTY ? "\x1B[31m" : "";
 var YELLOW = isTTY ? "\x1B[33m" : "";
 var MAGENTA = isTTY ? "\x1B[35m" : "";
 var DIM = isTTY ? "\x1B[2m" : "";
@@ -1320,12 +1321,13 @@ function registerTxCommand(cli) {
       console.log(`  ${BOLD}Call:${RESET}   ${callHex}`);
       console.log(`  ${BOLD}Decode:${RESET} ${decodedStr}`);
       console.log(`  ${BOLD}Tx:${RESET}     ${result.txHash}`);
-      console.log(`  ${BOLD}Block:${RESET}  #${result.block.number} (${result.block.hash})`);
+      let dispatchErrorMsg;
       if (result.ok) {
         console.log(`  ${BOLD}Status:${RESET} ${GREEN}ok${RESET}`);
       } else {
-        console.log(`  ${BOLD}Status:${RESET} ${YELLOW}dispatch error${RESET}`);
-        console.log(`  ${BOLD}Error:${RESET}  ${result.dispatchError.type}${result.dispatchError.value ? `: ${JSON.stringify(result.dispatchError.value)}` : ""}`);
+        dispatchErrorMsg = formatDispatchError(result.dispatchError);
+        console.log(`  ${BOLD}Status:${RESET} ${RED}dispatch error${RESET}`);
+        console.log(`  ${BOLD}Error:${RESET}  ${dispatchErrorMsg}`);
       }
       if (result.events && result.events.length > 0) {
         console.log(`  ${BOLD}Events:${RESET}`);
@@ -1348,11 +1350,31 @@ function registerTxCommand(cli) {
         console.log(`    ${DIM}PAPI${RESET}        ${papiLink(rpcUrl, blockHash)}`);
       }
       console.log();
+      if (!result.ok) {
+        throw new CliError(`Transaction dispatch error: ${dispatchErrorMsg}`);
+      }
     } finally {
       clientHandle?.destroy();
     }
   });
 }
+function formatDispatchError(err) {
+  if (err.type === "Module" && err.value && typeof err.value === "object") {
+    const mod = err.value;
+    if (mod.type) {
+      const inner = mod.value;
+      if (inner && typeof inner === "object" && inner.type) {
+        return `${mod.type}.${inner.type}`;
+      }
+      return mod.type;
+    }
+  }
+  if (err.value !== undefined && err.value !== null) {
+    const val = typeof err.value === "string" ? err.value : JSON.stringify(err.value);
+    return `${err.type}: ${val}`;
+  }
+  return err.type;
+}
 function decodeCall(meta, callHex) {
   try {
     const viewBuilder = getViewBuilder(meta.lookup);
@@ -1810,7 +1832,7 @@ function watchTransaction(observable) {
             }
             break;
           case "finalized":
-            spinner.stop();
+            spinner.succeed(`Finalized in block #${event.block.number}`);
             resolve(event);
             break;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polkadot-cli",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "CLI tool for querying Polkadot-ecosystem on-chain state",
   "type": "module",
   "bin": {