@byreal-io/byreal-cli-realclaw 0.3.9 → 0.3.10

package/README.md

@@ -85,6 +85,7 @@ All commands support `-o json` for structured output.
 | `wallet balance`          | Query wallet balance                           |
 | `jup swap`                | Swap tokens via Jupiter aggregator              |
 | `jup price`               | Get token price from Jupiter                    |
+| `kamino reserves`         | Show Kamino Lend APY for SOL/USDC/USDT (or a specific token) |
 | `kamino deposit`          | Deposit tokens into Kamino Lend                 |
 | `kamino withdraw`         | Withdraw tokens from Kamino Lend                |
 | `kamino status`           | View Kamino lending positions and yield          |

package/dist/index.cjs

@@ -3033,7 +3033,7 @@ var INJECTED_VERSION, VERSION, CLI_NAME, NPM_PACKAGE, API_BASE_URL, API_ENDPOINT
 var init_constants = __esm({
   "src/core/constants.ts"() {
     "use strict";
-    INJECTED_VERSION = true ? "0.3.9" : void 0;
+    INJECTED_VERSION = true ? "0.3.10" : void 0;
     VERSION = INJECTED_VERSION ?? process.env.npm_package_version ?? "0.0.0";
     CLI_NAME = "byreal-cli";
     NPM_PACKAGE = "@byreal-io/byreal-cli-realclaw";
@@ -84350,6 +84350,7 @@ byreal-cli catalog show dex.pool.list
 | update.install | Install latest CLI version |
 | defi.jup.swap | Swap tokens via Jupiter aggregator |
 | defi.jup.price | Get token prices from Jupiter |
+| defi.kamino.reserves | Show Kamino Lend APY for SOL/USDC/USDT (or a specific --token) |
 | defi.kamino.deposit | Deposit to Kamino Lend |
 | defi.kamino.withdraw | Withdraw from Kamino Lend |
 | defi.kamino.status | View Kamino positions and APY |
@@ -84424,6 +84425,8 @@ Present on-chain data first, then external context, then synthesize how external
 | Jupiter swap preview | \`byreal-cli jup swap --input-mint <mint> --output-mint <mint> --amount <amt> --dry-run --wallet-address <addr>\` |
 | Jupiter swap execute | \`byreal-cli jup swap --input-mint <mint> --output-mint <mint> --amount <amt> --wallet-address <addr>\` |
 | Jupiter token price | \`byreal-cli jup price --mint <mint>\` |
+| Kamino APY (SOL/USDC/USDT) | \`byreal-cli kamino reserves\` |
+| Kamino APY (specific token) | \`byreal-cli kamino reserves --token <symbol|mint>\` |
 | Kamino deposit | \`byreal-cli kamino deposit --amount <amt> --wallet-address <addr>\` |
 | Kamino withdraw | \`byreal-cli kamino withdraw --amount <amt> --wallet-address <addr>\` |
 | Kamino status | \`byreal-cli kamino status --wallet-address <addr>\` |
@@ -84556,9 +84559,10 @@ When user wants to swap tokens via Jupiter (not the built-in Byreal swap):
 ## Workflow: Idle Yield with Kamino
 
 When user wants to earn yield on idle tokens (e.g. USDC):
-1. **Check status**: \`byreal-cli kamino status --wallet-address <addr>\` \u2014 view current positions and APY
-2. **Deposit**: \`byreal-cli kamino deposit --amount <amt> --wallet-address <addr>\` \u2014 deposit USDC (default) or specify \`--mint <mint>\` for other tokens
-3. **Withdraw**: \`byreal-cli kamino withdraw --amount <amt> --wallet-address <addr>\` \u2014 withdraw back to wallet
+1. **Check APY**: \`byreal-cli kamino reserves\` \u2014 shows the supply/borrow APY for SOL, USDC, USDT. For any other token, pass \`--token <symbol|mint>\` (e.g. \`--token JitoSOL\`). This is an aid, not a browser \u2014 do not attempt to list every reserve.
+2. **Check status**: \`byreal-cli kamino status --wallet-address <addr>\` \u2014 view current positions and APY
+3. **Deposit**: \`byreal-cli kamino deposit --amount <amt> --wallet-address <addr>\` \u2014 deposit USDC (default) or specify \`--mint <mint>\` for other tokens
+4. **Withdraw**: \`byreal-cli kamino withdraw --amount <amt> --wallet-address <addr>\` \u2014 withdraw back to wallet
 
 Default market: Kamino Main Market. Use \`--market <address>\` for a different market.
 
@@ -84999,23 +85003,43 @@ function sfToRaw(valueSf) {
     return "0";
   }
 }
-async function getReserveMetrics(market) {
+function toReserveMetrics(r) {
+  const totalSupplyUsd = parseFloat(r.totalSupplyUsd) || 0;
+  const totalBorrowUsd = parseFloat(r.totalBorrowUsd) || 0;
+  return {
+    reserveAddress: r.reserve,
+    mintAddress: r.liquidityTokenMint,
+    symbol: r.liquidityToken,
+    supplyApy: parseFloat(r.supplyApy) || 0,
+    borrowApy: parseFloat(r.borrowApy) || 0,
+    totalSupplyUsd,
+    totalBorrowUsd,
+    utilization: totalSupplyUsd > 0 ? totalBorrowUsd / totalSupplyUsd : 0,
+    maxLtv: parseFloat(r.maxLtv) || 0
+  };
+}
+async function getReservesMetrics(market) {
   try {
     const response = await fetch(`${KAMINO_API}/kamino-market/${market}/reserves/metrics`);
-    if (!response.ok) return {};
-    const data = await response.json();
-    const result = {};
-    for (const r of data) {
-      result[r.reserve] = {
-        supplyApy: parseFloat(r.supplyApy) || 0,
-        borrowApy: parseFloat(r.borrowApy) || 0
-      };
+    if (!response.ok) {
+      const text = await response.text();
+      return err(apiError(`Kamino reserves metrics failed: ${text}`, response.status));
     }
-    return result;
-  } catch {
-    return {};
+    const data = await response.json();
+    return ok(data.map(toReserveMetrics));
+  } catch (error) {
+    return err(networkError(`Kamino reserves metrics: ${error.message}`));
   }
 }
+async function getReserveApyMap(market) {
+  const result = await getReservesMetrics(market);
+  if (!result.ok) return {};
+  const map = {};
+  for (const r of result.value) {
+    map[r.reserveAddress] = { supplyApy: r.supplyApy, borrowApy: r.borrowApy };
+  }
+  return map;
+}
 async function getExchangeRate(market, reserve) {
   try {
     const now = /* @__PURE__ */ new Date();
@@ -85054,7 +85078,7 @@ async function enrichObligations(rawObligations, market) {
   }
   const [priceResult, reserveMetrics, ...exchangeRateResults] = await Promise.all([
     mintsToPrice.size > 0 ? getPrice([...mintsToPrice]) : Promise.resolve({ ok: false, error: null }),
-    getReserveMetrics(market),
+    getReserveApyMap(market),
     ...[...activeReserves].map((r) => getExchangeRate(market, r).then((rate) => ({ reserve: r, rate })))
   ]);
   const prices = priceResult.ok ? priceResult.value : {};
@@ -85265,6 +85289,88 @@ Error: ${message}`));
     }
   });
 }
+var DEFAULT_RESERVE_SYMBOLS = ["SOL", "USDC", "USDT"];
+function formatUsdThousands(value) {
+  return `$${value.toLocaleString("en-US", { maximumFractionDigits: 2 })}`;
+}
+function createKaminoReservesCommand() {
+  return new Command("reserves").description("Show Kamino Lend supply/borrow APY for SOL, USDC, USDT (or a specific --token)").option("--market <address>", "Market address", KAMINO_MAIN_MARKET).option("--token <symbolOrMint>", "Query a single token by symbol (e.g. JitoSOL) or mint address instead of the default set").action(async (options, cmdObj) => {
+    const globalOptions = cmdObj.optsWithGlobals();
+    const format = globalOptions.output;
+    const startTime = Date.now();
+    try {
+      const result = await getReservesMetrics(options.market);
+      if (!result.ok) {
+        format === "json" ? outputErrorJson(result.error) : outputErrorTable(result.error);
+        process.exit(1);
+      }
+      const all = result.value;
+      let reserves;
+      if (options.token) {
+        const needle = String(options.token).trim();
+        const bySymbol = all.filter((r) => r.symbol.toLowerCase() === needle.toLowerCase());
+        const byMint = all.filter((r) => r.mintAddress === needle);
+        reserves = bySymbol.length > 0 ? bySymbol : byMint;
+        if (reserves.length === 0) {
+          const msg = `Token "${needle}" not found in Kamino market ${options.market}. Pass a valid symbol (e.g. JitoSOL) or mint address.`;
+          format === "json" ? outputErrorJson({ code: "NOT_FOUND", type: "VALIDATION", message: msg, retryable: false }) : console.error(source_default.red(`
+Error: ${msg}`));
+          process.exit(1);
+        }
+      } else {
+        const order = new Map(DEFAULT_RESERVE_SYMBOLS.map((s, i) => [s, i]));
+        reserves = all.filter((r) => order.has(r.symbol)).sort((a, b) => (order.get(a.symbol) ?? 0) - (order.get(b.symbol) ?? 0));
+      }
+      if (format === "json") {
+        outputJson({
+          market: options.market,
+          query: options.token ?? "default",
+          total: reserves.length,
+          reserves
+        }, startTime);
+        return;
+      }
+      const table = new import_cli_table33.default({
+        head: [
+          source_default.cyan.bold("Token"),
+          source_default.cyan.bold("Supply APY"),
+          source_default.cyan.bold("Borrow APY"),
+          source_default.cyan.bold("TVL (USD)"),
+          source_default.cyan.bold("Borrowed (USD)"),
+          source_default.cyan.bold("Utilization"),
+          source_default.cyan.bold("Max LTV"),
+          source_default.cyan.bold("Mint"),
+          source_default.cyan.bold("Reserve")
+        ],
+        chars: TABLE_CHARS
+      });
+      for (const r of reserves) {
+        table.push([
+          r.symbol,
+          `${(r.supplyApy * 100).toFixed(2)}%`,
+          `${(r.borrowApy * 100).toFixed(2)}%`,
+          formatUsdThousands(r.totalSupplyUsd),
+          formatUsdThousands(r.totalBorrowUsd),
+          `${(r.utilization * 100).toFixed(2)}%`,
+          `${(r.maxLtv * 100).toFixed(0)}%`,
+          r.mintAddress,
+          r.reserveAddress
+        ]);
+      }
+      console.log(source_default.cyan.bold("\n  Kamino Lend Reserves"));
+      console.log(source_default.gray(`  Market: ${options.market}`));
+      if (!options.token) {
+        console.log(source_default.gray(`  Showing default set: ${DEFAULT_RESERVE_SYMBOLS.join(", ")}  (use --token <symbol|mint> for others)`));
+      }
+      console.log(table.toString());
+    } catch (e) {
+      const message = e.message || "Kamino reserves failed";
+      format === "json" ? outputErrorJson({ code: "API_ERROR", type: "NETWORK", message, retryable: true }) : console.error(source_default.red(`
+Error: ${message}`));
+      process.exit(1);
+    }
+  });
+}
 function createKaminoStatusCommand() {
   return new Command("status").description("View Kamino Lend positions and APY").option("--market <address>", "Market address", KAMINO_MAIN_MARKET).action(async (options, cmdObj) => {
     const globalOptions = cmdObj.optsWithGlobals();
@@ -85367,6 +85473,18 @@ var capabilities2 = [
     params: [
       { name: "market", type: "string", required: false, description: "Kamino market address", default: "main market" }
     ]
+  },
+  {
+    id: "defi.kamino.reserves",
+    name: "Kamino Reserves",
+    description: "Show Kamino Lend supply/borrow APY for SOL, USDC, USDT by default. Use --token <symbol|mint> to query a specific other token.",
+    category: "query",
+    auth_required: false,
+    command: "byreal-cli kamino reserves",
+    params: [
+      { name: "market", type: "string", required: false, description: "Kamino market address", default: "main market" },
+      { name: "token", type: "string", required: false, description: "Query a single token by symbol or mint address instead of the default SOL/USDC/USDT set" }
+    ]
   }
 ];
 var kaminoPlugin = {
@@ -85374,6 +85492,7 @@ var kaminoPlugin = {
   name: "Kamino Lend",
   createCommand() {
     const cmd = new Command("kamino").description("Kamino Lend \u2014 deposit, withdraw, yield status");
+    cmd.addCommand(createKaminoReservesCommand());
     cmd.addCommand(createKaminoDepositCommand());
     cmd.addCommand(createKaminoWithdrawCommand());
     cmd.addCommand(createKaminoStatusCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byreal-io/byreal-cli-realclaw",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "description": "AI-native CLI for Byreal CLMM DEX on Solana",
   "type": "module",
   "main": "dist/index.cjs",