@alchemy/cli 0.14.0 → 0.15.0

package/dist/{chunk-22KBYYLI.js → chunk-UL5ZSWTE.js}

@@ -53,7 +53,7 @@ function semverLT(a, b) {
   return false;
 }
 function currentVersion() {
-  return true ? "0.14.0" : "0.0.0";
+  return true ? "0.15.0" : "0.0.0";
 }
 function toUpdateStatus(latestVersion, checkedAt) {
   const current = currentVersion();

package/dist/index.js

@@ -68,7 +68,7 @@ import {
   getAvailableUpdate,
   getUpdateStatus,
   printUpdateNotice
-} from "./chunk-22KBYYLI.js";
+} from "./chunk-UL5ZSWTE.js";
 import {
   bold,
   brand,
@@ -3371,6 +3371,60 @@ function registerWebhooks(program2) {
   });
 }
 
+// src/lib/solana-rpc.ts
+var SOLANA_DAS_METHODS = /* @__PURE__ */ new Set([
+  "getAsset",
+  "getAssetsByOwner",
+  "searchAssets",
+  "getTokenAccounts",
+  "getAssets",
+  "getAssetProof",
+  "getAssetsByAuthority",
+  "getAssetsByGroup",
+  "getAssetsByCreator",
+  "getAssetSignatures",
+  "getNftEditions"
+]);
+function errorText(err) {
+  if (err instanceof CLIError) {
+    return [err.message, err.details].filter(Boolean).join(" ");
+  }
+  if (err instanceof Error) {
+    return err.message;
+  }
+  return String(err);
+}
+function solanaRpcFamilyForMethod(method) {
+  return SOLANA_DAS_METHODS.has(method) ? "das" : "rpc";
+}
+function normalizeSolanaDasPaywallError(err) {
+  if (err instanceof CLIError && err.code === ErrorCode.PAYMENT_REQUIRED) {
+    return err;
+  }
+  const detail = errorText(err);
+  if (!/\b(free tier|payg|paid tier|paid plan|upgrade|plan does not|current plan|not available on your plan)\b/i.test(detail)) {
+    return null;
+  }
+  return new CLIError(
+    ErrorCode.PAYMENT_REQUIRED,
+    "Solana DAS request requires a paid Alchemy plan.",
+    "Upgrade your app to PAYG or use a plan with Solana DAS access at https://dashboard.alchemy.com/.",
+    detail || void 0
+  );
+}
+async function callSolana(client, family, method, params) {
+  const startedAt = Date.now();
+  debug(`solana ${family} ${method} params`, params);
+  try {
+    const result = await client.call(method, params);
+    debug(`solana ${family} ${method} ok ${Date.now() - startedAt}ms`);
+    return result;
+  } catch (err) {
+    debug(`solana ${family} ${method} failed ${Date.now() - startedAt}ms`, errorText(err));
+    throw err;
+  }
+}
+
 // src/commands/network.ts
 function registerNetwork(program2) {
   const cmd = program2.command("network").description("Manage networks");
@@ -6020,7 +6074,7 @@ function registerRpcSurfaceCommand({ root, parent, method }) {
         result = await withSpinner(
           `Calling ${method.name}...`,
           `Called ${method.name}`,
-          () => client.call(method.rpcMethod, params)
+          () => callNetworkRpcMethod(client, method, params)
         );
       }
       printSyntaxJSON(result);
@@ -6029,6 +6083,20 @@ function registerRpcSurfaceCommand({ root, parent, method }) {
     }
   });
 }
+async function callNetworkRpcMethod(client, method, params) {
+  if (method.family !== "solana") {
+    return await client.call(method.rpcMethod, params);
+  }
+  const solanaFamily = solanaRpcFamilyForMethod(method.rpcMethod);
+  try {
+    return await callSolana(client, solanaFamily, method.rpcMethod, params);
+  } catch (err) {
+    if (solanaFamily === "das") {
+      throw normalizeSolanaDasPaywallError(err) ?? err;
+    }
+    throw err;
+  }
+}
 function parseRpcParams(input) {
   const parsed = parseRequiredJSON(input, "--params");
   if (Array.isArray(parsed)) {
@@ -6141,7 +6209,7 @@ function registerSolana(program2) {
       const result = await withSpinner(
         `Calling ${method}\u2026`,
         `Called ${method}`,
-        () => client.call(method, parseCLIParams(params))
+        () => callSolana(client, "rpc", method, parseCLIParams(params))
       );
       printSyntaxJSON(result);
     } catch (err) {
@@ -6158,7 +6226,9 @@ function registerSolana(program2) {
       const result = await withSpinner(
         `Calling ${method}\u2026`,
         `Called ${method}`,
-        () => client.call(method, rpcParams)
+        () => callSolana(client, "das", method, rpcParams).catch((err) => {
+          throw normalizeSolanaDasPaywallError(err) ?? err;
+        })
       );
       printSyntaxJSON(result);
     } catch (err) {
@@ -6807,7 +6877,7 @@ function registrySymbolSuggestions(network) {
 }
 
 // src/lib/preflight-errors.ts
-function errorText(err) {
+function errorText2(err) {
   if (err instanceof CLIError) {
     return [err.message, err.details].filter(Boolean).join(" ");
   }
@@ -6842,7 +6912,7 @@ function normalizePreflightRevertError(err) {
   if (err instanceof CLIError && err.code === ErrorCode.PREFLIGHT_REVERT) {
     return err;
   }
-  const detail = errorText(err);
+  const detail = errorText2(err);
   const reason = extractRevertReason(detail);
   if (!reason) return null;
   return errPreflightRevert(reason, detail || void 0);
@@ -8180,6 +8250,13 @@ Examples:
 }
 
 // src/commands/portfolio.ts
+var BALANCE_FIELD_NAMES = /* @__PURE__ */ new Set([
+  "balance",
+  "tokenbalance",
+  "rawbalance",
+  "rawtokenbalance",
+  "amount"
+]);
 async function runDataCall(program2, title, path, body) {
   const x402 = resolveX402Client(program2);
   return withSpinner(
@@ -8191,22 +8268,82 @@ async function runDataCall(program2, title, path, body) {
 function limitPayload(value, limit) {
   if (limit === void 0) return value;
   if (Array.isArray(value)) {
-    return value.slice(0, limit);
+    return value.slice(0, limit).map((item) => limitPayload(item, limit));
   }
-  if (value && typeof value === "object") {
+  if (isRecord(value)) {
     return Object.fromEntries(
       Object.entries(value).map(([key, nested]) => [
         key,
-        Array.isArray(nested) ? nested.slice(0, limit) : nested
+        limitPayload(nested, limit)
       ])
     );
   }
   return value;
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isHexQuantity(value) {
+  return /^0x[0-9a-f]+$/i.test(value);
+}
+function parseDecimals2(value) {
+  const decimals = typeof value === "number" ? value : typeof value === "string" && /^\d+$/.test(value) ? Number(value) : void 0;
+  if (decimals === void 0 || !Number.isInteger(decimals) || decimals < 0 || decimals > 255) {
+    return void 0;
+  }
+  return decimals;
+}
+function decimalsForRecord(value) {
+  const direct = parseDecimals2(value.decimals);
+  if (direct !== void 0) return direct;
+  for (const key of ["tokenMetadata", "metadata", "token"]) {
+    const nested = value[key];
+    if (isRecord(nested)) {
+      const decimals = parseDecimals2(nested.decimals);
+      if (decimals !== void 0) return decimals;
+    }
+  }
+  return void 0;
+}
+function formatRawAmount(raw, decimals) {
+  if (decimals === 0) return raw.toString();
+  const divisor = 10n ** BigInt(decimals);
+  const whole = raw / divisor;
+  const fraction = raw % divisor;
+  if (fraction === 0n) return whole.toString();
+  const fractionText = fraction.toString().padStart(decimals, "0").replace(/0+$/, "");
+  return `${whole}.${fractionText}`;
+}
+function shouldNormalizeBalanceField(key) {
+  const normalized = key.toLowerCase();
+  return BALANCE_FIELD_NAMES.has(normalized) || normalized.endsWith("balance");
+}
+function normalizePortfolioOutput(value) {
+  if (Array.isArray(value)) {
+    return value.map(normalizePortfolioOutput);
+  }
+  if (!isRecord(value)) {
+    return value;
+  }
+  const decimals = decimalsForRecord(value);
+  const output = {};
+  for (const [key, nested] of Object.entries(value)) {
+    output[key] = normalizePortfolioOutput(nested);
+    if (typeof nested !== "string" || !shouldNormalizeBalanceField(key) || !isHexQuantity(nested)) {
+      continue;
+    }
+    const raw = BigInt(nested);
+    output[`${key}Decimal`] = raw.toString();
+    if (decimals !== void 0) {
+      output[`${key}Formatted`] = formatRawAmount(raw, decimals);
+    }
+  }
+  return output;
+}
 async function runPortfolioCommand(program2, title, path, opts) {
   const limit = parseOptionalInt(opts.limit, "--limit");
   const result = await runDataCall(program2, title, path, JSON.parse(opts.body));
-  const output = limitPayload(result, limit);
+  const output = normalizePortfolioOutput(limitPayload(result, limit));
   if (isJSONMode()) printJSON(output);
   else printSyntaxJSON(output);
 }
@@ -8864,7 +9001,7 @@ function buildWalletQuoteClient(program2, address3) {
 }
 
 // src/lib/quote-errors.ts
-function errorText2(err) {
+function errorText3(err) {
   if (err instanceof CLIError) {
     return [err.message, err.details].filter(Boolean).join(" ");
   }
@@ -8922,7 +9059,7 @@ function normalizeQuoteError(err, flow) {
   if (err instanceof CLIError && err.code !== ErrorCode.RPC_ERROR && err.code !== ErrorCode.INTERNAL_ERROR) {
     return err;
   }
-  const detail = errorText2(err);
+  const detail = errorText3(err);
   const cause = classifyQuoteFailure(detail);
   return new CLIError(
     ErrorCode.QUOTE_FAILED,
@@ -9962,7 +10099,7 @@ function displayPath(path) {
   const home = getHomeDir();
   return path.startsWith(home) ? `~${path.slice(home.length)}` : path;
 }
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isClientId(value) {
@@ -10149,7 +10286,7 @@ async function readJSONConfig(path) {
     const raw = await readFile(path, "utf8");
     if (raw.trim().length === 0) return {};
     const parsed = JSON.parse(raw);
-    if (!isRecord(parsed)) {
+    if (!isRecord2(parsed)) {
       throw errInvalidArgs(`${displayPath(path)} must contain a JSON object.`);
     }
     return parsed;
@@ -10163,7 +10300,7 @@ async function readJSONConfig(path) {
 }
 function withMcpServerConfig(config) {
   const existing = config.mcpServers;
-  if (existing !== void 0 && !isRecord(existing)) {
+  if (existing !== void 0 && !isRecord2(existing)) {
     throw errInvalidArgs("Cursor mcpServers must be a JSON object.");
   }
   return {
@@ -10581,7 +10718,7 @@ async function flushProcessOutput() {
 }
 program.name("alchemy").description(
   "The Alchemy CLI lets you query blockchain data, call JSON-RPC methods, and manage your Alchemy configuration."
-).version("0.14.0", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option(
+).version("0.15.0", "-v, --version", "display CLI version").option("--api-key <key>", "Alchemy API key (env: ALCHEMY_API_KEY)").option(
   "-n, --network <network>",
   "Target network for networked commands"
 ).option("--x402", "Use x402 wallet-based gateway auth").option(
@@ -10807,7 +10944,7 @@ ${styledLine}`;
   if (isInteractiveAllowed(program)) {
     let latestForInteractiveStartup = null;
     if (shouldRunOnboarding(program, cfg)) {
-      const { runOnboarding } = await import("./onboarding-QE43IUEK.js");
+      const { runOnboarding } = await import("./onboarding-L2FTZRYN.js");
       const latest = getAvailableUpdateOnce();
       const completed = await runOnboarding(program, latest);
       updateShownDuringInteractiveStartup = Boolean(latest);
@@ -10821,7 +10958,7 @@ ${styledLine}`;
         latestForInteractiveStartup
       );
     }
-    const { startREPL } = await import("./interactive-XNDXNMAJ.js");
+    const { startREPL } = await import("./interactive-3ACOLHPG.js");
     program.exitOverride();
     program.configureOutput({
       writeErr: () => {

package/dist/{interactive-XNDXNMAJ.js → interactive-3ACOLHPG.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-CXR7CCJ7.js";
 import {
   getUpdateNoticeLines
-} from "./chunk-22KBYYLI.js";
+} from "./chunk-UL5ZSWTE.js";
 import {
   bold,
   brand,

package/dist/{onboarding-QE43IUEK.js → onboarding-L2FTZRYN.js}

@@ -2,7 +2,7 @@
 if(process.argv.includes("--no-color"))process.env.NO_COLOR="1";
 import {
   getUpdateNoticeLines
-} from "./chunk-22KBYYLI.js";
+} from "./chunk-UL5ZSWTE.js";
 import {
   bold,
   brand,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alchemy/cli",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Alchemy CLI — interact with blockchain data",
   "type": "module",
   "bin": {