@vultisig/cli 2.19.10 → 2.19.11

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @vultisig/cli
 
+## 2.19.11
+
+### Patch Changes
+
+- [#1129](https://github.com/vultisig/vultisig-sdk/pull/1129) [`5949742`](https://github.com/vultisig/vultisig-sdk/commit/59497426a238a75576e92d18023747d66c9d4e7a) Thanks [@neavra](https://github.com/neavra)! - fix(portfolio): report per-chain failures instead of silently swallowing them. The `portfolio` command now fetches each chain independently — one unreachable chain no longer fails the whole command, and a fiat-value lookup failure no longer silently drops the value. The `-o json` envelope always carries a `failures: [{ chain, stage, error }]` array (empty on full success), partial failures still exit 0, and an all-chains-failed run exits with a network error (code 3).
+
+- Updated dependencies [[`3bf18a1`](https://github.com/vultisig/vultisig-sdk/commit/3bf18a18606fd1b45d50abb562eb6c3011182d48)]:
+  - @vultisig/sdk@2.19.11
+
 ## 2.19.10
 
 ### Patch Changes

package/README.md

@@ -1153,6 +1153,43 @@ Configuration is stored in `~/.vultisig/`:
 > truth) and are covered by a doc-lint test that fails if this table drifts from the code. Run
 > `vultisig --help` for the same list.
 
+### Partial failures (`portfolio`)
+
+The `portfolio` command fetches every chain independently, so one unreachable chain no longer
+fails the whole command. The `-o json` envelope always carries a `failures` array (empty when
+everything succeeded):
+
+```jsonc
+{
+  "success": true,
+  "v": 1,
+  "data": {
+    "portfolio": { "totalValue": { ... }, "chainBalances": [ /* only the chains that loaded */ ] },
+    "currency": "usd",
+    "failures": [
+      { "chain": "Bitcoin", "stage": "balance", "error": "ECONNREFUSED btc-rpc" },
+      { "chain": "Ethereum", "stage": "value",   "error": "pricing service unavailable" }
+    ]
+  }
+}
+```
+
+- `stage: "balance"` — the balance fetch failed; the chain is omitted from `chainBalances`.
+- `stage: "value"` — the balance loaded but its fiat value did not; the chain still appears in
+  `chainBalances` (without a `value`) and is also listed here.
+- `error` is a concise single-line message — never a stack trace or filesystem path.
+
+**Partial-success exit contract:** if _some_ chains loaded, the command exits **0** and reports
+the rest under `failures`. Machine consumers should branch on `data.failures.length`, not `$?`.
+If _every_ chain fails to fetch a balance, the command exits **3** (network error, retryable).
+On the human-readable (table) output, failures are printed as `Warning:` lines below the table.
+
+> **Note on `totalValue`:** `failures` describes the per-chain _breakdown_ pass (`chainBalances`).
+> `portfolio.totalValue` is computed by an independent best-effort aggregate that includes token
+> values (not just native) and silently omits any chain/token it could not price. It is therefore
+> not guaranteed to be consistent with `chainBalances`/`failures` — treat it as an approximate
+> total, and rely on `failures` (not the total) to detect which chains had problems.
+
 ## Troubleshooting
 
 ### "No active vault" error

package/dist/index.js

@@ -5839,6 +5839,10 @@ async function confirmSwap() {
 }
 
 // src/commands/balance.ts
+function conciseError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  return message.split("\n")[0].trim() || "Unknown error";
+}
 async function executeBalance(ctx2, options = {}) {
   const vault = await ctx2.ensureActiveVault();
   const spinner = createSpinner("Loading balances...");
@@ -5876,24 +5880,50 @@ async function executePortfolio(ctx2, options = {}) {
   const spinner = createSpinner(`Loading portfolio in ${currencyName}...`);
   const totalValue = await vault.getTotalValue(currency);
   const chains = vault.chains;
-  const chainBalances = await Promise.all(
+  const results = await Promise.all(
     chains.map(async (chain) => {
-      const balance = await vault.balance(chain);
+      let balance;
+      try {
+        balance = await vault.balance(chain);
+      } catch (err) {
+        return { failure: { chain, stage: "balance", error: conciseError(err) } };
+      }
       try {
         const value = await vault.getValue(chain, void 0, currency);
-        return { chain, balance, value };
-      } catch {
-        return { chain, balance };
+        return { entry: { chain, balance, value } };
+      } catch (err) {
+        return { entry: { chain, balance }, failure: { chain, stage: "value", error: conciseError(err) } };
       }
     })
   );
+  const chainBalances = [];
+  const failures = [];
+  for (const result of results) {
+    if (result.entry) chainBalances.push(result.entry);
+    if (result.failure) failures.push(result.failure);
+  }
+  if (failures.length > 0 && chainBalances.length === 0) {
+    spinner.fail("Portfolio failed to load");
+    throw new NetworkError(
+      `Failed to load balances for all ${failures.length} chain(s): ${failures.map((f) => `${f.chain} (${f.error})`).join("; ")}`,
+      "All chain balance fetches failed \u2014 likely a network/RPC issue",
+      ["Check your internet connection", "Retry in a few moments"]
+    );
+  }
   const portfolio = { totalValue, chainBalances };
   spinner.succeed("Portfolio loaded");
   if (isJsonOutput()) {
-    outputJson({ portfolio, currency });
+    outputJson({ portfolio, currency, failures });
     return;
   }
   displayPortfolio(portfolio, currency, options.raw ?? false);
+  if (failures.length > 0) {
+    warn(`
+Warning: ${failures.length} chain(s) failed to load fully:`);
+    for (const f of failures) {
+      warn(`  - ${f.chain} (${f.stage}): ${f.error}`);
+    }
+  }
 }
 
 // src/commands/chains.ts
@@ -14568,7 +14598,7 @@ var cachedVersion = null;
 function getVersion() {
   if (cachedVersion) return cachedVersion;
   if (true) {
-    cachedVersion = "2.19.10";
+    cachedVersion = "2.19.11";
     return cachedVersion;
   }
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vultisig/cli",
-  "version": "2.19.10",
+  "version": "2.19.11",
   "description": "The self-custody MPC wallet CLI for AI coding agents (Claude Code, Cursor, OpenCode). Natural-language agent mode, 36+ chains, DKLS23 threshold signatures. Seedless.",
   "type": "module",
   "bin": {
@@ -76,7 +76,7 @@
     "@vultisig/client-shared": "^0.2.17",
     "@vultisig/core-chain": "^2.24.2",
     "@vultisig/rujira": "^52.0.0",
-    "@vultisig/sdk": "^2.19.10",
+    "@vultisig/sdk": "^2.19.11",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^15.0.0",