@fiber-pay/cli 0.1.0-rc.5 → 0.1.0-rc.7

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { join as join9 } from "path";
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
 // src/commands/binary.ts
 import { DEFAULT_FIBER_VERSION, downloadFiberBinary } from "@fiber-pay/node";
@@ -169,12 +169,61 @@ import {
   shannonsToCkb,
   toHex
 } from "@fiber-pay/sdk";
+var SHANNONS_PER_CKB = 100000000n;
 function truncateMiddle(value, start = 10, end = 8) {
   if (!value || value.length <= start + end + 3) {
     return value;
   }
   return `${value.slice(0, start)}...${value.slice(-end)}`;
 }
+function sanitizeForTerminal(value) {
+  const input = String(value ?? "");
+  let output = "";
+  for (let i = 0; i < input.length; i++) {
+    const code = input.charCodeAt(i);
+    if (code === 27) {
+      i++;
+      if (i >= input.length) break;
+      if (input.charCodeAt(i) === 91) {
+        i++;
+        while (i < input.length) {
+          const csiCode = input.charCodeAt(i);
+          if (csiCode >= 64 && csiCode <= 126) {
+            break;
+          }
+          i++;
+        }
+      }
+      continue;
+    }
+    if (code === 9 || code === 10 || code === 13) {
+      output += " ";
+      continue;
+    }
+    if (code >= 0 && code <= 8 || code >= 11 && code <= 31) {
+      continue;
+    }
+    if (code >= 127 && code <= 159) {
+      continue;
+    }
+    output += input[i];
+  }
+  return output;
+}
+function formatShannonsAsCkb(shannons, fractionDigits = 8) {
+  const value = typeof shannons === "bigint" ? shannons : BigInt(shannons);
+  const sign = value < 0n ? "-" : "";
+  const abs = value < 0n ? -value : value;
+  const safeDigits = Math.max(0, Math.min(8, Math.trunc(fractionDigits)));
+  const multiplier = 10n ** BigInt(safeDigits);
+  const scaled = (abs * multiplier + SHANNONS_PER_CKB / 2n) / SHANNONS_PER_CKB;
+  const whole = scaled / multiplier;
+  if (safeDigits === 0) {
+    return `${sign}${whole}`;
+  }
+  const fraction = (scaled % multiplier).toString().padStart(safeDigits, "0");
+  return `${sign}${whole}.${fraction}`;
+}
 function parseHexTimestampMs(hexTimestamp) {
   if (!hexTimestamp) return null;
   try {
@@ -931,20 +980,20 @@ function registerChannelRebalanceCommand(parent, config) {
 // src/commands/channel.ts
 function createChannelCommand(config) {
   const channel = new Command2("channel").description("Channel lifecycle and status commands");
-  channel.command("list").option("--state <state>").option("--peer <peerId>").option("--include-closed").option("--raw").option("--json").action(async (options) => {
+  channel.command("list").option("--state <state>").option("--peer <peerId>").option("--include-closed").option("--json").action(async (options) => {
     const rpc = await createReadyRpcClient(config);
     const stateFilter = parseChannelState(options.state);
     const response = await rpc.listChannels(
       options.peer ? { peer_id: options.peer, include_closed: Boolean(options.includeClosed) } : { include_closed: Boolean(options.includeClosed) }
     );
     const channels = stateFilter ? response.channels.filter((item) => item.state.state_name === stateFilter) : response.channels;
-    if (options.raw || options.json) {
+    if (options.json) {
       printJsonSuccess({ channels, count: channels.length });
     } else {
       printChannelListHuman(channels);
     }
   });
-  channel.command("get").argument("<channelId>").option("--raw").option("--json").action(async (channelId, options) => {
+  channel.command("get").argument("<channelId>").option("--json").action(async (channelId, options) => {
     const rpc = await createReadyRpcClient(config);
     const response = await rpc.listChannels({ include_closed: true });
     const found = response.channels.find((item) => item.channel_id === channelId);
@@ -962,7 +1011,7 @@ function createChannelCommand(config) {
       }
       process.exit(1);
     }
-    if (options.raw || options.json) {
+    if (options.json) {
       printJsonSuccess(found);
     } else {
       printChannelDetailHuman(found);
@@ -3256,6 +3305,167 @@ function inferDateFromPaths(paths) {
 // src/commands/node.ts
 import { Command as Command8 } from "commander";
 
+// src/lib/node-info.ts
+async function runNodeInfoCommand(config, options) {
+  const rpc = await createReadyRpcClient(config);
+  const nodeInfo = await rpc.nodeInfo();
+  if (options.json) {
+    printJsonSuccess(nodeInfo);
+    return;
+  }
+  console.log("\u2705 Node info retrieved");
+  console.log(`  Version: ${nodeInfo.version}`);
+  console.log(`  Commit: ${nodeInfo.commit_hash}`);
+  console.log(`  Node ID: ${nodeInfo.node_id}`);
+  if (nodeInfo.features.length > 0) {
+    console.log("  Features:");
+    for (const feature of nodeInfo.features) {
+      console.log(`    - ${sanitizeForTerminal(feature)}`);
+    }
+  }
+  console.log(`  Name: ${sanitizeForTerminal(nodeInfo.node_name ?? "-")}`);
+  if (nodeInfo.addresses.length > 0) {
+    console.log("  Addresses:");
+    for (const address of nodeInfo.addresses) {
+      console.log(`    - ${sanitizeForTerminal(address)}`);
+    }
+  }
+  console.log(`  Chain Hash: ${nodeInfo.chain_hash}`);
+  console.log(`  Channels: ${BigInt(nodeInfo.channel_count)}`);
+  console.log(`  Pending Channels: ${BigInt(nodeInfo.pending_channel_count)}`);
+  console.log(`  Peers: ${BigInt(nodeInfo.peers_count)}`);
+  if (nodeInfo.udt_cfg_infos.length > 0) {
+    console.log("  UDT Configs:");
+    for (const udt of nodeInfo.udt_cfg_infos) {
+      console.log(`    - Name: ${sanitizeForTerminal(udt.name)}`);
+      console.log(`      Script: ${JSON.stringify(udt.script, null, 6)}`);
+      if (udt.auto_accept_amount) {
+        console.log(`      Auto Accept Amount: ${BigInt(udt.auto_accept_amount)}`);
+      }
+      if (udt.cell_deps.length > 0) {
+        console.log("      Cell Deps:");
+        for (const dep of udt.cell_deps) {
+          console.log(
+            `        - Cell Dep: ${dep.cell_dep ? JSON.stringify(dep.cell_dep) : "null"}`
+          );
+          console.log(`          Type ID: ${dep.type_id ? JSON.stringify(dep.type_id) : "null"}`);
+        }
+      }
+    }
+  }
+}
+
+// src/lib/node-network.ts
+import { shannonsToCkb as shannonsToCkb5, toHex as toHex4 } from "@fiber-pay/sdk";
+async function runNodeNetworkCommand(config, options) {
+  const rpc = await createReadyRpcClient(config);
+  const [nodeInfo, localPeers, localChannels, graphNodes, graphChannels] = await Promise.all([
+    rpc.nodeInfo(),
+    rpc.listPeers(),
+    rpc.listChannels({ include_closed: false }),
+    rpc.graphNodes({}),
+    rpc.graphChannels({})
+  ]);
+  const graphNodesMap = /* @__PURE__ */ new Map();
+  for (const node of graphNodes.nodes) {
+    graphNodesMap.set(node.node_id, node);
+  }
+  const peerIdToNodeIdMap = /* @__PURE__ */ new Map();
+  for (const peer of localPeers.peers) {
+    peerIdToNodeIdMap.set(peer.peer_id, peer.pubkey);
+  }
+  const graphChannelsMap = /* @__PURE__ */ new Map();
+  for (const channel of graphChannels.channels) {
+    if (channel.channel_outpoint) {
+      const outpointKey = `${channel.channel_outpoint.tx_hash}:${channel.channel_outpoint.index}`;
+      graphChannelsMap.set(outpointKey, channel);
+    }
+  }
+  const enrichedPeers = localPeers.peers.map((peer) => ({
+    ...peer,
+    nodeInfo: graphNodesMap.get(peer.pubkey)
+  }));
+  const enrichedChannels = localChannels.channels.map((channel) => {
+    const nodeId = peerIdToNodeIdMap.get(channel.peer_id) || channel.peer_id;
+    const peerNodeInfo = graphNodesMap.get(nodeId);
+    let graphChannelInfo;
+    if (channel.channel_outpoint) {
+      const outpointKey = `${channel.channel_outpoint.tx_hash}:${channel.channel_outpoint.index}`;
+      graphChannelInfo = graphChannelsMap.get(outpointKey);
+    }
+    return {
+      ...channel,
+      peerNodeInfo,
+      graphChannelInfo
+    };
+  });
+  const activeChannels = enrichedChannels.filter((ch) => ch.state?.state_name === "CHANNEL_READY");
+  const totalChannelCapacityShannons = activeChannels.reduce((sum, ch) => {
+    const capacity = ch.graphChannelInfo?.capacity ? ch.graphChannelInfo.capacity : toHex4(BigInt(ch.local_balance) + BigInt(ch.remote_balance));
+    return sum + BigInt(capacity);
+  }, 0n);
+  const totalChannelCapacity = formatShannonsAsCkb(totalChannelCapacityShannons, 1);
+  const networkData = {
+    localNodeId: nodeInfo.node_id,
+    peers: enrichedPeers,
+    channels: enrichedChannels,
+    graphNodes: graphNodes.nodes,
+    graphChannels: graphChannels.channels,
+    summary: {
+      connectedPeers: enrichedPeers.length,
+      activeChannels: activeChannels.length,
+      totalChannelCapacity
+    }
+  };
+  if (options.json) {
+    printJsonSuccess(networkData);
+    return;
+  }
+  printNodeNetworkHuman(networkData);
+}
+function printNodeNetworkHuman(data) {
+  console.log("Node Network Overview");
+  console.log("=====================");
+  console.log("");
+  console.log(`Connected Peers: ${data.summary.connectedPeers}`);
+  console.log(`Active Channels: ${data.summary.activeChannels}`);
+  console.log(`Total Channel Capacity: ${data.summary.totalChannelCapacity} CKB`);
+  console.log("");
+  if (data.peers.length > 0) {
+    console.log("Peers:");
+    console.log("  PEER_ID                ALIAS                ADDRESS                    VERSION");
+    console.log(
+      "  --------------------------------------------------------------------------------"
+    );
+    for (const peer of data.peers) {
+      const peerId = truncateMiddle(peer.peer_id, 10, 8).padEnd(22, " ");
+      const alias = sanitizeForTerminal(peer.nodeInfo?.node_name || "(unnamed)").slice(0, 20).padEnd(20, " ");
+      const address = truncateMiddle(sanitizeForTerminal(peer.address), 15, 8).padEnd(25, " ");
+      const version = sanitizeForTerminal(peer.nodeInfo?.version || "?").slice(0, 8).padEnd(8, " ");
+      console.log(`  ${peerId} ${alias} ${address} ${version}`);
+    }
+    console.log("");
+  }
+  if (data.channels.length > 0) {
+    console.log("Channels:");
+    console.log(
+      "  CHANNEL_ID             PEER_ALIAS           STATE          LOCAL_BAL     REMOTE_BAL   CAPACITY"
+    );
+    console.log(
+      "  -----------------------------------------------------------------------------------------------"
+    );
+    for (const channel of data.channels) {
+      const channelId = truncateMiddle(channel.channel_id, 10, 8).padEnd(22, " ");
+      const peerAlias = sanitizeForTerminal(channel.peerNodeInfo?.node_name || "(unnamed)").slice(0, 18).padEnd(18, " ");
+      const state = (channel.state?.state_name || "UNKNOWN").slice(0, 13).padEnd(13, " ");
+      const localBal = shannonsToCkb5(channel.local_balance).toFixed(1).padStart(11, " ");
+      const remoteBal = shannonsToCkb5(channel.remote_balance).toFixed(1).padStart(11, " ");
+      const capacity = channel.graphChannelInfo?.capacity ? shannonsToCkb5(channel.graphChannelInfo.capacity).toFixed(1).padStart(8, " ") : shannonsToCkb5(toHex4(BigInt(channel.local_balance) + BigInt(channel.remote_balance))).toFixed(1).padStart(8, " ");
+      console.log(`  ${channelId} ${peerAlias} ${state} ${localBal} ${remoteBal} ${capacity}`);
+    }
+  }
+}
+
 // src/lib/node-start.ts
 import { spawn } from "child_process";
 import { mkdirSync as mkdirSync3 } from "fs";
@@ -4136,6 +4346,7 @@ async function runNodeStatusCommand(config, options) {
   const nodeRunning = Boolean(pid && isProcessRunning(pid));
   let rpcResponsive = false;
   let nodeId = null;
+  let nodeName = null;
   let addresses = [];
   let chainHash = null;
   let version = null;
@@ -4163,6 +4374,7 @@ async function runNodeStatusCommand(config, options) {
       const channels = await rpc.listChannels({ include_closed: false });
       rpcResponsive = true;
       nodeId = nodeInfo.node_id;
+      nodeName = nodeInfo.node_name;
       addresses = nodeInfo.addresses;
       chainHash = nodeInfo.chain_hash;
       version = nodeInfo.version;
@@ -4234,6 +4446,7 @@ async function runNodeStatusCommand(config, options) {
     rpcTarget: resolvedRpc.target,
     resolvedRpcUrl: resolvedRpc.url,
     nodeId,
+    nodeName,
     addresses,
     chainHash,
     version,
@@ -4296,8 +4509,11 @@ async function runNodeStatusCommand(config, options) {
     console.log(`\u2705 Node is running (PID: ${output.pid})`);
     if (output.rpcResponsive) {
       console.log(`   Node ID: ${String(output.nodeId)}`);
+      if (output.nodeName) {
+        console.log(`   Name: ${sanitizeForTerminal(output.nodeName)}`);
+      }
       if (output.version) {
-        console.log(`   Version: ${String(output.version)}`);
+        console.log(`   Version: ${sanitizeForTerminal(output.version)}`);
       }
       if (output.chainHash) {
         console.log(`   Chain Hash: ${String(output.chainHash)}`);
@@ -4320,7 +4536,7 @@ async function runNodeStatusCommand(config, options) {
       if (output.addresses.length > 0) {
         console.log("   Addresses:");
         for (const address of output.addresses) {
-          console.log(`     - ${address}`);
+          console.log(`     - ${sanitizeForTerminal(address)}`);
         }
       }
     } else {
@@ -4797,6 +5013,12 @@ function createNodeCommand(config) {
   node.command("status").option("--json").action(async (options) => {
     await runNodeStatusCommand(config, options);
   });
+  node.command("network").description("Display comprehensive network topology and connections").option("--json").action(async (options) => {
+    await runNodeNetworkCommand(config, options);
+  });
+  node.command("info").description("Display information about the running node").option("--json").action(async (options) => {
+    await runNodeInfoCommand(config, options);
+  });
   node.command("ready").description("Agent-oriented readiness summary for automation").option("--json").action(async (options) => {
     await runNodeReadyCommand(config, options);
   });
@@ -4810,7 +5032,7 @@ function createNodeCommand(config) {
 }
 
 // src/commands/payment.ts
-import { ckbToShannons as ckbToShannons4, shannonsToCkb as shannonsToCkb5 } from "@fiber-pay/sdk";
+import { ckbToShannons as ckbToShannons4, shannonsToCkb as shannonsToCkb6 } from "@fiber-pay/sdk";
 import { Command as Command9 } from "commander";
 function createPaymentCommand(config) {
   const payment = new Command9("payment").description("Payment lifecycle and status commands");
@@ -4896,7 +5118,7 @@ function createPaymentCommand(config) {
     const payload = {
       paymentHash: result.payment_hash,
       status: result.status === "Success" ? "success" : result.status === "Failed" ? "failed" : "pending",
-      feeCkb: shannonsToCkb5(result.fee),
+      feeCkb: shannonsToCkb6(result.fee),
       failureReason: result.failed_error
     };
     if (json) {
@@ -5076,7 +5298,7 @@ function createPaymentCommand(config) {
         console.log(
           `    Outpoint:   ${hop.channel_outpoint.tx_hash}:${hop.channel_outpoint.index}`
         );
-        console.log(`    Amount:     ${shannonsToCkb5(hop.amount_received)} CKB`);
+        console.log(`    Amount:     ${shannonsToCkb6(hop.amount_received)} CKB`);
         console.log(`    Expiry:     ${hop.incoming_tlc_expiry}`);
       }
     }
@@ -5115,7 +5337,7 @@ function createPaymentCommand(config) {
     const payload = {
       paymentHash: result.payment_hash,
       status: result.status === "Success" ? "success" : result.status === "Failed" ? "failed" : "pending",
-      feeCkb: shannonsToCkb5(result.fee),
+      feeCkb: shannonsToCkb6(result.fee),
       failureReason: result.failed_error,
       dryRun: Boolean(options.dryRun)
     };
@@ -5139,7 +5361,7 @@ function getJobPaymentHash(job) {
 }
 function getJobFeeCkb(job) {
   const result = job.result;
-  return result?.fee ? shannonsToCkb5(result.fee) : 0;
+  return result?.fee ? shannonsToCkb6(result.fee) : 0;
 }
 function getJobFailure(job) {
   const result = job.result;
@@ -5521,7 +5743,7 @@ function createRuntimeCommand(config) {
       if (fallback && isFiberRuntimeCommand(fallback.command)) {
         pid = fallback.pid;
         writeRuntimePid(config.dataDir, pid);
-      } else if (fallback && fallback.command) {
+      } else if (fallback?.command) {
         const details = fallback.command ? `PID ${fallback.pid} (${fallback.command})` : `PID ${fallback.pid}`;
         if (asJson) {
           printJsonError({
@@ -5618,7 +5840,7 @@ function createRuntimeCommand(config) {
       if (fallback && isFiberRuntimeCommand(fallback.command)) {
         pid = fallback.pid;
         writeRuntimePid(config.dataDir, pid);
-      } else if (fallback && fallback.command) {
+      } else if (fallback?.command) {
         const details = fallback.command ? `PID ${fallback.pid} (${fallback.command})` : `PID ${fallback.pid}`;
         if (asJson) {
           printJsonError({
@@ -5702,8 +5924,8 @@ function createRuntimeCommand(config) {
 import { Command as Command12 } from "commander";
 
 // src/lib/build-info.ts
-var CLI_VERSION = "0.1.0-rc.5";
-var CLI_COMMIT = "28cee07226e004d775ed747bbcbf61474f93c492";
+var CLI_VERSION = "0.1.0-rc.7";
+var CLI_COMMIT = "f71c561d8f423b9c88b79f5568dc1c6f9fbc93e3";
 
 // src/commands/version.ts
 function createVersionCommand() {
@@ -5721,6 +5943,64 @@ function createVersionCommand() {
   });
 }
 
+// src/commands/wallet.ts
+import { Command as Command13 } from "commander";
+
+// src/lib/wallet-address.ts
+import { scriptToAddress as scriptToAddress2 } from "@fiber-pay/sdk";
+async function runWalletAddressCommand(config, options) {
+  const rpc = await createReadyRpcClient(config);
+  const nodeInfo = await rpc.nodeInfo();
+  const address = scriptToAddress2(
+    nodeInfo.default_funding_lock_script,
+    config.network === "mainnet" ? "mainnet" : "testnet"
+  );
+  if (options.json) {
+    printJsonSuccess({ address });
+    return;
+  }
+  console.log("\u2705 Funding address retrieved");
+  console.log(`  Address: ${address}`);
+}
+
+// src/lib/wallet-balance.ts
+async function runWalletBalanceCommand(config, options) {
+  if (!config.ckbRpcUrl) {
+    throw new Error(
+      "CKB RPC URL is not configured. Set FIBER_CKB_RPC_URL or add ckb.rpc_url to config.yml."
+    );
+  }
+  const rpc = await createReadyRpcClient(config);
+  const nodeInfo = await rpc.nodeInfo();
+  const balanceShannons = await getLockBalanceShannons(
+    config.ckbRpcUrl,
+    nodeInfo.default_funding_lock_script
+  );
+  const balanceCkb = formatShannonsAsCkb(balanceShannons, 8);
+  if (options.json) {
+    printJsonSuccess({
+      balance_ckb: balanceCkb,
+      balance_shannons: balanceShannons.toString()
+    });
+    return;
+  }
+  console.log("\u2705 CKB balance retrieved");
+  console.log(`  Balance: ${balanceCkb} CKB`);
+  console.log(`  Balance (shannons): ${balanceShannons.toString()}`);
+}
+
+// src/commands/wallet.ts
+function createWalletCommand(config) {
+  const wallet = new Command13("wallet").description("Wallet management");
+  wallet.command("address").description("Display the funding address").option("--json").action(async (options) => {
+    await runWalletAddressCommand(config, options);
+  });
+  wallet.command("balance").description("Display the CKB balance").option("--json").action(async (options) => {
+    await runWalletBalanceCommand(config, options);
+  });
+  return wallet;
+}
+
 // src/lib/argv.ts
 var GLOBAL_OPTIONS_WITH_VALUE = /* @__PURE__ */ new Set([
   "--profile",
@@ -5886,7 +6166,7 @@ async function main() {
   }
   applyGlobalOverrides(argv);
   const config = getEffectiveConfig(explicitFlags).config;
-  const program = new Command13();
+  const program = new Command14();
   program.name("fiber-pay").description("AI Agent Payment SDK for CKB Lightning Network").option("--profile <name>", "Use profile at ~/.fiber-pay/profiles/<name>").option("--data-dir <path>", "Override data directory for all commands").option("--rpc-url <url>", "Override RPC URL for all commands").option("--rpc-biscuit-token <token>", "Set RPC Authorization Bearer token for all commands").option("--network <network>", "Override network for all commands (testnet|mainnet)").option("--key-password <password>", "Override key password for all commands").option("--binary-path <path>", "Override fiber binary path for all commands").showHelpAfterError().showSuggestionAfterError();
   program.exitOverride();
   program.configureOutput({
@@ -5909,6 +6189,7 @@ async function main() {
   program.addCommand(createConfigCommand(config));
   program.addCommand(createRuntimeCommand(config));
   program.addCommand(createVersionCommand());
+  program.addCommand(createWalletCommand(config));
   await program.parseAsync(argv);
 }
 main().catch((error) => {