@parallel-protocol/cli 0.2.7 → 0.2.9

package/README.md

@@ -192,7 +192,7 @@ parallel swap redeem     --collateral <symbol> --amount <n> --chain <chain> --wa
 parallel swap redeem-all --amount <n> --chain <chain> --wallet   # proportional redeem
 ```
 
-> Command names match the MCP tools since 0.2.7: `redeem` targets ONE
+> Command names match the MCP tools: `redeem` targets ONE
 > collateral (formerly `burn`), `redeem-all` redeems proportionally across the
 > whole basket (formerly `redeem`). The old `swap burn` keeps working as a
 > hidden legacy command.
@@ -438,7 +438,7 @@ Not all chains support every feature. Use `parallel protocol chains` to see the
 | `RPC_ERROR` | An HTTP provider (facilitator, history APIs) is unreachable |
 | `UNKNOWN` | Any other failure |
 
-Protocol-layer errors (caps, bridge limits, sunset chains, partial reads…) are surfaced with their own code in the `code` field since 0.2.7 — e.g. `EXCEEDS_CAP`, `EXCEEDS_BRIDGE_LIMIT`, `EXCEEDS_GLOBAL_LIMIT`, `CHAIN_SUNSET`, `ROUTE_UNAVAILABLE`, `PARTIAL_READ`, `PARALLELIZER_NOT_DEPLOYED`, `COLLATERAL_NOT_SUPPORTED`, `INSUFFICIENT_BALANCE`. Match on `error.code`; the message carries the human detail (remaining capacity, valid values…) without the code prefix.
+Protocol-layer errors (caps, bridge limits, sunset chains, partial reads…) are surfaced with their own code in the `code` field — e.g. `EXCEEDS_CAP`, `EXCEEDS_BRIDGE_LIMIT`, `EXCEEDS_GLOBAL_LIMIT`, `CHAIN_SUNSET`, `ROUTE_UNAVAILABLE`, `PARTIAL_READ`, `PARALLELIZER_NOT_DEPLOYED`, `COLLATERAL_NOT_SUPPORTED`, `INSUFFICIENT_BALANCE`. Match on `error.code`; the message carries the human detail (remaining capacity, valid values…) without the code prefix.
 
 ---
 

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { AsyncLocalStorage } from 'async_hooks';
-import { Command, Option, CommanderError } from 'commander';
+import { Command, CommanderError } from 'commander';
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
@@ -1635,7 +1635,7 @@ function suppressLogs() {
 
 // package.json
 var package_default = {
-  version: "0.2.7"};
+  version: "0.2.9"};
 function findEnvFile(dir) {
   const candidate = join(dir, ".env");
   if (existsSync(candidate)) return candidate;
@@ -5722,7 +5722,7 @@ function toTxData(tx) {
 function quoteCmd() {
   return new Command("quote").description("Get a LayerZero bridge fee quote").option(
     "--token <token>",
-    "token to bridge: usdp|susdp|prl (default: usdp)",
+    "token to bridge: usdp (the only token currently bridgeable)",
     "usdp"
   ).option("--from <chain>", "source chain").option("--to <chain>", "destination chain").option("--amount <n>", "amount to bridge").action(async function() {
     const opts = resolveOpts(this);
@@ -5772,7 +5772,11 @@ function quoteCmd() {
   });
 }
 function feesCmd() {
-  return new Command("fees").description("Show LayerZero bridge fees to all destinations from a chain").option("--token <token>", "token: usdp|susdp|prl (default: usdp)", "usdp").option("--from <chain>", "source chain").action(async function() {
+  return new Command("fees").description("Show LayerZero bridge fees to all destinations from a chain").option(
+    "--token <token>",
+    "token: usdp (the only token currently bridgeable)",
+    "usdp"
+  ).option("--from <chain>", "source chain").action(async function() {
     const opts = resolveOpts(this);
     try {
       if (!opts.from)
@@ -5805,7 +5809,7 @@ function feesCmd() {
 function sendCmd() {
   return new Command("send").description("Bridge tokens cross-chain via LayerZero OFT").option(
     "--token <token>",
-    "token to bridge: usdp|susdp|prl (default: usdp)",
+    "token to bridge: usdp (the only token currently bridgeable)",
     "usdp"
   ).option("--from <chain>", "source chain").option("--to <chain>", "destination chain").option("--amount <n>", "amount to bridge").option("--recipient <addr>", "override destination recipient address").option("-w, --wallet [path|env]", "keystore path or 'env'").option("--address <addr>", "sender address (for dry-run without --wallet)").option("--dry-run", "build tx without broadcasting").action(async function() {
     const opts = resolveOpts(this);
@@ -7153,7 +7157,11 @@ var TTL = {
   SUPPLY: 6e4,
   SAVINGS_RATE: 3e4,
   EXCHANGE_RATE: 3e4,
-  STAKING: 6e4};
+  STAKING: 6e4,
+  // Forum topics do not move once created — a long TTL also makes the
+  // Discourse search deterministic across consecutive calls.
+  FORUM_URL: 6e5
+};
 var lru = new I({
   max: 500,
   allowStale: false
@@ -7689,29 +7697,37 @@ async function getFeeRates(chain, collateral) {
   );
 }
 
+// ../shared/src/infra/http.ts
+function fetchWithTimeout(url, init = {}, timeoutMs = 1e4) {
+  return fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+}
+
 // ../mcp-server/src/services/governance/proposals.ts
 var SNAPSHOT_HUB = "https://hub.snapshot.org/graphql";
 var SNAPSHOT_SPACE = "parallel-protocol.eth";
 var DISCOURSE_BASE = "https://gov.parallel.best";
-async function fetchForumUrl(friendlyId) {
-  try {
-    const res = await fetch(
-      `${DISCOURSE_BASE}/search.json?q=${encodeURIComponent(friendlyId)}`
-    );
-    if (!res.ok) return null;
-    const data = await res.json();
-    const topic = data.topics?.[0];
-    if (!topic) return null;
-    return `${DISCOURSE_BASE}/t/${topic.slug}/${topic.id}`;
-  } catch {
-    return null;
-  }
+function fetchForumUrl(friendlyId) {
+  return getOrSet(`gov:forum:${friendlyId}`, TTL.FORUM_URL, async () => {
+    try {
+      const res = await fetchWithTimeout(
+        `${DISCOURSE_BASE}/search.json?q=${encodeURIComponent(friendlyId)}`,
+        {},
+        3e3
+      );
+      if (!res.ok) return null;
+      const data = await res.json();
+      const topic = data.topics?.[0];
+      if (!topic) return null;
+      return `${DISCOURSE_BASE}/t/${topic.slug}/${topic.id}`;
+    } catch {
+      return null;
+    }
+  });
 }
 async function enrichWithForumUrls(proposals) {
   const urls = await Promise.all(
     proposals.map((p) => {
-      if (p.forumUrl?.startsWith(DISCOURSE_BASE))
-        return Promise.resolve(p.forumUrl);
+      if (p.forumUrl) return Promise.resolve(p.forumUrl);
       if (p.id !== p.snapshotId) return fetchForumUrl(p.id);
       return Promise.resolve(null);
     })
@@ -7719,11 +7735,18 @@ async function enrichWithForumUrls(proposals) {
   return proposals.map((p, i) => ({ ...p, forumUrl: urls[i] ?? null }));
 }
 async function querySnapshot(query, variables) {
-  const res = await fetch(SNAPSHOT_HUB, {
-    method: "POST",
-    headers: { "Content-Type": "application/json", Accept: "application/json" },
-    body: JSON.stringify({ query, variables })
-  });
+  const res = await fetchWithTimeout(
+    SNAPSHOT_HUB,
+    {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json"
+      },
+      body: JSON.stringify({ query, variables })
+    },
+    1e4
+  );
   if (!res.ok)
     throw new Error(`Snapshot API error: ${res.status} ${res.statusText}`);
   const json = await res.json();
@@ -7743,14 +7766,23 @@ function inferFriendlyId(title) {
   const match = title.match(/\b(PIP|PGP|PIR)-(\d+(?:\.\d+)?)/i);
   return match ? `${match[1].toUpperCase()}-${match[2]}` : null;
 }
-function mapDetailedStatus(state, scoresTotal, quorum) {
-  if (state === "active") return "active";
-  if (state === "pending") return "pending";
-  if (state === "closed") {
-    if (scoresTotal < quorum) return "rejected";
+function isForAgainstVote(choices) {
+  if (!choices || choices.length < 2) return false;
+  const second = choices[1].toLowerCase();
+  return second.startsWith("against") || second.startsWith("no");
+}
+function mapDetailedStatus(p) {
+  if (p.state === "active") return "active";
+  if (p.state === "pending") return "pending";
+  if (p.state === "closed") {
+    if (p.quorum > 0 && p.scores_total < p.quorum) return "rejected";
+    if (isForAgainstVote(p.choices)) {
+      const scores = p.scores ?? [];
+      return (scores[0] ?? 0) > (scores[1] ?? 0) ? "passed" : "rejected";
+    }
     return "passed";
   }
-  return state;
+  return p.state;
 }
 function summarizeProposal(p) {
   const scores = p.scores ?? [];
@@ -7763,11 +7795,11 @@ function summarizeProposal(p) {
     title: p.title,
     author: p.author,
     type: inferProposalType(p.title),
-    status: mapDetailedStatus(p.state, p.scores_total, p.quorum),
+    status: mapDetailedStatus(p),
     createdAt: new Date(p.created * 1e3).toISOString(),
     votingEndsAt: new Date(p.end * 1e3).toISOString(),
     snapshotUrl: `https://snapshot.org/#/${SNAPSHOT_SPACE}/proposal/${p.id}`,
-    forumUrl: p.link ?? null,
+    forumUrl: p.discussion?.trim() ? p.discussion : null,
     summary: (p.body ?? "").slice(0, 200) + ((p.body?.length ?? 0) > 200 ? "\u2026" : ""),
     forVotes,
     againstVotes,
@@ -7795,7 +7827,7 @@ var PROPOSALS_QUERY = `
       scores
       choices
       quorum
-      link
+      discussion
     }
   }
 `;
@@ -7838,7 +7870,7 @@ var PROPOSAL_DETAILS_QUERY = `
       scores
       choices
       quorum
-      link
+      discussion
     }
   }
 `;
@@ -7846,23 +7878,28 @@ async function buildProposalDetails(p) {
   const [enriched] = await enrichWithForumUrls([summarizeProposal(p)]);
   const summary = enriched;
   const scores = p.scores ?? [];
+  const hasQuorum = p.quorum > 0;
+  const quorumReached = hasQuorum ? p.scores_total >= p.quorum : null;
   return {
     ...summary,
     description: p.body ?? "",
     choices: p.choices ?? [],
     scores,
     quorum: p.quorum,
-    quorumReached: p.scores_total >= p.quorum,
+    quorumReached,
     voteResults: {
       for: scores[0] ?? 0,
       against: scores[1] ?? 0,
       abstain: scores[2] ?? 0,
       quorum: p.quorum,
-      quorumReached: p.scores_total >= p.quorum
+      quorumReached
     },
     parametersChanged: null,
     executionTx: null,
     unavailableFields: {
+      ...hasQuorum ? {} : {
+        quorumReached: "No quorum is configured for this space on Snapshot (proposal quorum is 0) \u2014 pass/fail is derived from the For/Against split alone."
+      },
       parametersChanged: "Snapshot does not expose structured on-chain parameter changes \u2014 this information is in the proposal body text.",
       executionTx: "Snapshot does not record on-chain execution transactions \u2014 check the DAO's AccessManager or TimelockController on Etherscan."
     }
@@ -8161,7 +8198,7 @@ function proposalsCmd() {
           `--type must be PIP, PGP or PIR, got "${opts.type}"`
         );
       }
-      const STATUSES = ["active", "passed", "rejected", "executed"];
+      const STATUSES = ["active", "pending", "passed", "rejected"];
       if (opts.status && !STATUSES.includes(opts.status)) {
         throw new CliError(
           ErrorCode.INVALID_OPTION,
@@ -8208,7 +8245,11 @@ function proposalCmd() {
           ["Created", fmtDate(result.createdAt)],
           ["Voting Ends", fmtDate(result.votingEndsAt)],
           ["Quorum", fmtVotes(result.quorum)],
-          ["Quorum Reached", result.quorumReached ? "Yes \u2713" : "No \u2717"],
+          [
+            "Quorum Reached",
+            // null = no quorum configured — "No ✗" would be misleading.
+            result.quorumReached === null ? "\u2014" : result.quorumReached ? "Yes \u2713" : "No \u2717"
+          ],
           ["Snapshot URL", result.snapshotUrl],
           ["Forum URL", result.forumUrl ?? "\u2014"]
         ]);
@@ -8383,9 +8424,9 @@ async function getPaymentCapabilities(chain, {
   const hasUSDp = !!getUSDpAddress(chain);
   const hasSUSDp = !!CHAINS[chain].contracts.susdp;
   const hasUSDC = !!getUSDCAddress(chain);
-  const sunset = CHAINS[chain].status === "sunset";
-  const parallelizerActive = hasParallelizer && !sunset;
-  const susdpVaultActive = hasSUSDp && !sunset;
+  const chainActive = CHAINS[chain].status === "active";
+  const parallelizerActive = hasParallelizer && chainActive;
+  const susdpVaultActive = hasSUSDp && chainActive;
   const facilitatorSupported = parallelizerActive;
   const gasSponsored = parallelizerActive && chain !== "ethereum";
   let hasUsdcCollateral = false;
@@ -8409,7 +8450,7 @@ async function getPaymentCapabilities(chain, {
     }
   }
   const capabilities = [];
-  if (hasUSDp) {
+  if (hasUSDp && facilitatorSupported) {
     capabilities.push({
       route: "A",
       method: "transferWithAuthorization",
@@ -8449,7 +8490,7 @@ async function getPaymentCapabilities(chain, {
       gasSponsored
     });
   }
-  if (hasUSDp && susdpVaultActive) {
+  if (hasUSDp && susdpVaultActive && facilitatorSupported) {
     capabilities.push({
       route: "C",
       method: "depositWithAuthorization",
@@ -8469,7 +8510,7 @@ async function getPaymentCapabilities(chain, {
       gasSponsored
     });
   }
-  if (hasUSDC) {
+  if (hasUSDC && facilitatorSupported) {
     capabilities.push({
       route: "F",
       method: "transferWithAuthorization",
@@ -11143,7 +11184,7 @@ async function renderSupplyHistory(token, opts) {
   try {
     if (token.toLowerCase() !== "usdp")
       throw new CliError(
-        ErrorCode.UNKNOWN,
+        ErrorCode.INVALID_OPTION,
         `supply --history is only available for usdp (got "${token}")`,
         "Only USDp has a public historical supply source"
       );
@@ -12761,8 +12802,8 @@ async function getStakingOverview() {
         aprNote: "Base APR estimated from previous epoch rewards and token prices. Actual APR varies per user based on ParaBoost score. Same formula as app."
       } : {
         unavailableFields: {
-          sprl1APR: "APR unavailable \u2014 STAKE_API_URL not configured.",
-          sprl2APR: "APR unavailable \u2014 STAKE_API_URL not configured."
+          sprl1APR: "APR unavailable \u2014 the staking API returned no validated epoch data (unreachable, unauthorized, or no epoch settled yet).",
+          sprl2APR: "APR unavailable \u2014 the staking API returned no validated epoch data (unreachable, unauthorized, or no epoch settled yet)."
         }
       }
     };
@@ -12956,17 +12997,17 @@ async function getStakingInfo(userAddress) {
     estimatedAPR: userAPR,
     unavailableFields: {
       ...pendingRewards.sprl1Pending === null && {
-        "sprl1.pendingRewards": "sPRL1 rewards are distributed via an off-chain Merkle distributor \u2014 configure STAKE_API_URL and GOLDSKY_SUBGRAPH_URL to enable."
+        "sprl1.pendingRewards": "sPRL1 rewards are distributed via an off-chain Merkle distributor \u2014 the staking API returned no data for this field."
       },
       ...pendingRewards.currentEpoch === null && {
-        "sprl1.cooldown.epoch": "Current epoch unavailable \u2014 configure STAKE_API_URL to enable."
+        "sprl1.cooldown.epoch": "Current epoch unavailable \u2014 the staking API returned no epoch data."
       },
       "sprl2.auraRewards": "BAL and AURA rewards from Aura Finance are automatically forwarded to the DAO treasury, not distributed to individual stakers.",
       ...pendingRewards.sprl2Pending === null && {
-        "sprl2.protocolRewards": "Protocol rewards for sPRL2 are distributed via the same off-chain epoch-based Merkle distributor \u2014 configure STAKE_API_URL and GOLDSKY_SUBGRAPH_URL to enable."
+        "sprl2.protocolRewards": "Protocol rewards for sPRL2 are distributed via the same off-chain epoch-based Merkle distributor \u2014 the staking API returned no data for this field."
       },
       ...pendingRewards.paraboost === null && {
-        "sprl2.paraboost": "Paraboost multiplier unavailable \u2014 configure STAKE_API_URL to enable. Base multiplier is 2.5x; paraboost mechanics increase it over time."
+        "sprl2.paraboost": "Paraboost multiplier unavailable \u2014 the staking API returned no data. Base multiplier is 2.5x; paraboost mechanics increase it over time."
       },
       ...sprl2DelegationNotActive && {
         "sprl2.votingPower": `Voting power is 0 despite having BPT staked. This address has not self-delegated. Call delegate(yourAddress) on the sPRL2 contract (${SPRL2_ADDRESS}) to activate on-chain voting power.`
@@ -13055,7 +13096,7 @@ async function getCooldownStatus(userAddress) {
     address: userAddress,
     unavailableFields: {
       ...epochMeta === null && {
-        currentEpoch: "Current epoch unavailable \u2014 configure STAKE_API_URL to enable."
+        currentEpoch: "Current epoch unavailable \u2014 the staking API returned no epoch data."
       }
     }
   };
@@ -13257,7 +13298,7 @@ async function buildStakeSprl2Tx(amount, sender, wethAmount) {
   const estimatedVotingPower = prlPer1Bpt !== null ? (parseFloat(amount) * prlPer1Bpt * userParaboost).toFixed(6) : null;
   const unavailableFields = {};
   if (estimatedAPR === null) {
-    unavailableFields.estimatedAPR = "Failed to reach APR API \u2014 configure STAKE_API_URL to enable.";
+    unavailableFields.estimatedAPR = "Failed to reach the staking API \u2014 APR unavailable.";
   }
   const { simulation: simResult, warnings: simWarnings } = toSimFields(
     simulation,
@@ -15319,7 +15360,7 @@ function swapCommand() {
 
 // ../mcp-server/package.json
 var package_default2 = {
-  version: "1.0.0"};
+  version: "1.1.1"};
 
 // src/commands/version.ts
 function versionCommand() {
@@ -15357,7 +15398,7 @@ var program = new Command();
 program.name("parallel").description("Parallel Protocol CLI").version(package_default.version).option("-c, --chain <chain>", "target chain (e.g. base, ethereum)").option("-j, --json", "force JSON output").option("--dry-run", "build transaction without broadcasting").option(
   "-w, --wallet [path|env]",
   "keystore path, 'env', or alone to auto-resolve from config/env"
-).option("-v, --verbose", "verbose logs").option("--no-cache", "bypass TTL cache, force fresh RPC call").addOption(new Option("--rpc <url>", "(not implemented)").hideHelp()).addOption(new Option("--gas-limit <n>", "(not implemented)").hideHelp()).hook("preAction", (thisCommand) => {
+).option("-v, --verbose", "verbose logs").option("--no-cache", "bypass TTL cache, force fresh RPC call").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.json) process.env._PARALLEL_JSON_FLAG = "1";
 });
@@ -15403,7 +15444,17 @@ try {
       process.exitCode = 0;
     } else {
       if (isJsonMode()) {
-        const invoked = process.argv.slice(2).filter((a) => !a.startsWith("-"));
+        const invoked = [];
+        let node = program;
+        for (const token of process.argv.slice(2)) {
+          if (token.startsWith("-")) break;
+          const child = node.commands.find(
+            (c) => c.name() === token || c.aliases().includes(token)
+          );
+          if (!child) break;
+          invoked.push(token);
+          node = child;
+        }
         const message = err.code === "commander.help" ? `Missing subcommand for 'parallel ${invoked.join(" ")}'` : err.message.replace(/^error:\s*/, "");
         console.error(
           JSON.stringify(

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@parallel-protocol/cli",
-	"version": "0.2.7",
+	"version": "0.2.9",
 	"private": false,
 	"type": "module",
 	"files": [