@net-protocol/cli 0.1.43 → 0.1.44

package/dist/cli/index.mjs

@@ -6,10 +6,10 @@ import { createRequire } from 'module';
 import chalk4 from 'chalk';
 import * as fs6 from 'fs';
 import { readFileSync, existsSync, mkdirSync, writeFileSync } from 'fs';
-import { OPTIMAL_CHUNK_SIZE, StorageClient, detectFileTypeFromBase64, base64ToDataUri, shouldSuggestXmlStorage, getStorageKeyBytes, encodeStorageKeyForUrl, chunkDataForStorage, CHUNKED_STORAGE_CONTRACT, STORAGE_CONTRACT as STORAGE_CONTRACT$1 } from '@net-protocol/storage';
+import { OPTIMAL_CHUNK_SIZE, StorageClient, detectFileTypeFromBase64, base64ToDataUri, shouldSuggestXmlStorage, getStorageKeyBytes, chunkDataForStorage, CHUNKED_STORAGE_CONTRACT, STORAGE_CONTRACT as STORAGE_CONTRACT$1, encodeStorageKeyForUrl } from '@net-protocol/storage';
 import { createPublicClient, http, createWalletClient, stringToHex, hexToString, parseEther, encodeFunctionData, publicActions, concat, defineChain, decodeEventLog, formatEther, isAddress } from 'viem';
+import { getSupportedChains, getNetContract, getChainName, getChainRpcUrls, getPublicClient, getBaseDataSuffix, NetClient, toBytes32, getChainBlockExplorer, NULL_ADDRESS, getChainSlug } from '@net-protocol/core';
 import { privateKeyToAccount } from 'viem/accounts';
-import { getNetContract, getChainName, getChainRpcUrls, getPublicClient, getBaseDataSuffix, NetClient, toBytes32, NULL_ADDRESS } from '@net-protocol/core';
 import { fundBackendWallet, checkBackendWalletBalance, createRelayX402Client, createRelaySession, batchTransactions, submitTransactionsViaRelay, waitForConfirmations, retryFailedTransactions as retryFailedTransactions$1 } from '@net-protocol/relay';
 import { isCommentTopic, parseCommentData, FeedRegistryClient, FeedClient, AgentRegistryClient, COMMENT_TOPIC_SUFFIX, FEED_TOPIC_PREFIX } from '@net-protocol/feeds';
 import '@net-protocol/chats';
@@ -130,6 +130,75 @@ function parseCommonOptionsWithDefault(options, supportsEncodeOnly = false) {
     rpcUrl: getRpcUrlWithBotchanFallback(options.rpcUrl)
   };
 }
+var WEBSITE_BASE = "https://netprotocol.app";
+var STORAGE_BASE = "https://storedon.net";
+function chainSlug(chainId) {
+  return getChainSlug({ chainId }) ?? null;
+}
+function stripFeedPrefix(topic) {
+  const lower = topic.toLowerCase();
+  return lower.startsWith("feed-") ? lower.slice(5) : lower;
+}
+function feedUrl(chainId, feedName) {
+  const slug = chainSlug(chainId);
+  if (!slug) return null;
+  return `${WEBSITE_BASE}/app/feed/${slug}/${stripFeedPrefix(feedName)}`;
+}
+function walletUrl(chainId, address) {
+  const slug = chainSlug(chainId);
+  if (!slug) return null;
+  return `${WEBSITE_BASE}/app/feed/${slug}/${address.toLowerCase()}`;
+}
+function profileUrl(chainId, address) {
+  const slug = chainSlug(chainId);
+  if (!slug) return null;
+  return `${WEBSITE_BASE}/app/profile/${slug}/${address.toLowerCase()}`;
+}
+function tokenUrl(chainId, tokenAddress) {
+  const slug = chainSlug(chainId);
+  if (!slug) return null;
+  return `${WEBSITE_BASE}/app/token/${slug}/${tokenAddress.toLowerCase()}`;
+}
+function storageUrl(chainId, operatorAddress, key) {
+  return `${STORAGE_BASE}/net/${chainId}/storage/load/${operatorAddress.toLowerCase()}/${encodeStorageKeyForUrl(
+    key
+  )}`;
+}
+function explorerTxUrl(chainId, txHash) {
+  const base9 = getChainBlockExplorer({ chainId })?.url;
+  if (!base9) return null;
+  return `${base9}/tx/${txHash}`;
+}
+function explorerAddressUrl(chainId, address) {
+  const base9 = getChainBlockExplorer({ chainId })?.url;
+  if (!base9) return null;
+  return `${base9}/address/${address}`;
+}
+function postIdToCommentParam(postId) {
+  const colon = postId.indexOf(":");
+  if (colon === -1) return postId;
+  return `${postId.slice(0, colon)}-${postId.slice(colon + 1)}`;
+}
+function postPermalink(chainId, opts) {
+  const slug = chainSlug(chainId);
+  if (!slug) return null;
+  const params = new URLSearchParams();
+  if (opts.globalIndex != null) {
+    params.set("index", String(opts.globalIndex));
+  } else if (opts.topic != null && opts.topicIndex != null) {
+    params.set("topic", stripFeedPrefix(opts.topic));
+    params.set("index", String(opts.topicIndex));
+  } else if (opts.user != null && opts.userIndex != null) {
+    params.set("user", opts.user.toLowerCase());
+    params.set("index", String(opts.userIndex));
+  } else {
+    return null;
+  }
+  if (opts.commentId) {
+    params.set("commentId", postIdToCommentParam(opts.commentId));
+  }
+  return `${WEBSITE_BASE}/app/feed/${slug}/post?${params.toString()}`;
+}
 async function checkNormalStorageExists(params) {
   const { storageClient, storageKey, operatorAddress, expectedContent } = params;
   const existing = await storageClient.get({
@@ -213,7 +282,7 @@ function extractTypedArgsFromTransaction(tx, type) {
 }
 function generateStorageUrl(operatorAddress, chainId, storageKey) {
   if (!operatorAddress) return void 0;
-  return `https://storedon.net/net/${chainId}/storage/load/${operatorAddress}/${encodeStorageKeyForUrl(storageKey)}`;
+  return storageUrl(chainId, operatorAddress, storageKey);
 }
 async function checkTransactionExists(params) {
   const { storageClient, tx, operatorAddress } = params;
@@ -1182,6 +1251,11 @@ async function executeStorageRead(options) {
         key: options.key,
         operator: options.operator,
         chainId: readOnlyOptions.chainId,
+        storageUrl: storageUrl(
+          readOnlyOptions.chainId,
+          options.operator,
+          options.key
+        ),
         text: result.text,
         data: options.raw ? result.data : result.data,
         isXml: result.isXml,
@@ -1374,7 +1448,7 @@ function registerStorageCommand(program2) {
     try {
       console.log(chalk4.blue(`\u{1F4C1} Reading file: ${options.file}`));
       const result = await uploadFile(uploadOptions);
-      const storageUrl = generateStorageUrl(
+      const storageUrl2 = generateStorageUrl(
         result.operatorAddress,
         commonOptions.chainId,
         options.key
@@ -1384,8 +1458,8 @@ function registerStorageCommand(program2) {
           chalk4.green(
             `\u2713 All data already stored - skipping upload
   Storage Key: ${options.key}
-  Skipped: ${result.transactionsSkipped} transaction(s)${storageUrl ? `
-  Storage URL: ${chalk4.cyan(storageUrl)}` : ""}`
+  Skipped: ${result.transactionsSkipped} transaction(s)${storageUrl2 ? `
+  Storage URL: ${chalk4.cyan(storageUrl2)}` : ""}`
           )
         );
         process.exit(0);
@@ -1398,8 +1472,8 @@ function registerStorageCommand(program2) {
   Storage Type: ${result.storageType === "xml" ? "XML" : "Normal"}
   Transactions Sent: ${result.transactionsSent}
   Transactions Skipped: ${result.transactionsSkipped}
-  Final Transaction Hash: ${result.finalHash || "N/A"}${storageUrl ? `
-  Storage URL: ${chalk4.cyan(storageUrl)}` : ""}`
+  Final Transaction Hash: ${result.finalHash || "N/A"}${storageUrl2 ? `
+  Storage URL: ${chalk4.cyan(storageUrl2)}` : ""}`
           )
         );
         process.exit(0);
@@ -1456,7 +1530,7 @@ function registerStorageCommand(program2) {
     try {
       console.log(chalk4.blue(`\u{1F4C1} Reading file: ${options.file}`));
       const result = await previewFile(previewOptions);
-      const storageUrl = generateStorageUrl(
+      const storageUrl2 = generateStorageUrl(
         result.operatorAddress,
         commonOptions.chainId,
         options.key
@@ -1492,8 +1566,8 @@ function registerStorageCommand(program2) {
       console.log(
         `  Operator Address: ${chalk4.gray(result.operatorAddress)}`
       );
-      if (storageUrl) {
-        console.log(`  Storage URL: ${chalk4.cyan(storageUrl)}`);
+      if (storageUrl2) {
+        console.log(`  Storage URL: ${chalk4.cyan(storageUrl2)}`);
       }
       if (result.needToStoreChunks === 0 && !result.metadataNeedsStorage) {
         console.log(
@@ -1569,7 +1643,7 @@ function registerStorageCommand(program2) {
       const result = await uploadFileWithRelay(uploadRelayOptions);
       const { privateKeyToAccount: privateKeyToAccount28 } = await import('viem/accounts');
       const userAccount = privateKeyToAccount28(commonOptions.privateKey);
-      const storageUrl = generateStorageUrl(
+      const storageUrl2 = generateStorageUrl(
         userAccount.address,
         commonOptions.chainId,
         options.key
@@ -1585,8 +1659,8 @@ function registerStorageCommand(program2) {
   Metadata Submitted: ${result.metadataSubmitted ? "Yes" : "No (already exists)"}
   Backend Wallet: ${result.backendWalletAddress}
   Chunk Transaction Hashes: ${result.chunkTransactionHashes.length > 0 ? result.chunkTransactionHashes.join(", ") : "None"}${result.metadataTransactionHash ? `
-  Metadata Transaction Hash: ${result.metadataTransactionHash}` : ""}${storageUrl ? `
-  Storage URL: ${chalk4.cyan(storageUrl)}` : ""}`
+  Metadata Transaction Hash: ${result.metadataTransactionHash}` : ""}${storageUrl2 ? `
+  Storage URL: ${chalk4.cyan(storageUrl2)}` : ""}`
           )
         );
         process.exit(0);
@@ -1935,33 +2009,25 @@ function registerMessageCommand(program2) {
   messageCommand.addCommand(readCommand);
   messageCommand.addCommand(countCommand);
 }
-var SUPPORTED_CHAINS = [
-  { id: 8453, name: "Base", type: "mainnet" },
-  { id: 1, name: "Ethereum", type: "mainnet" },
-  { id: 666666666, name: "Degen", type: "mainnet" },
-  { id: 5112, name: "Ham", type: "mainnet" },
-  { id: 57073, name: "Ink", type: "mainnet" },
-  { id: 130, name: "Unichain", type: "mainnet" },
-  { id: 999, name: "HyperEVM", type: "mainnet" },
-  { id: 9745, name: "Plasma", type: "mainnet" },
-  { id: 143, name: "Monad", type: "mainnet" },
-  { id: 84532, name: "Base Sepolia", type: "testnet" },
-  { id: 11155111, name: "Sepolia", type: "testnet" }
-];
 function registerChainsCommand(program2) {
   program2.command("chains").description("List supported chains").option("--json", "Output in JSON format").action((options) => {
+    const chains = getSupportedChains();
     if (options.json) {
-      console.log(JSON.stringify(SUPPORTED_CHAINS, null, 2));
+      console.log(JSON.stringify(chains, null, 2));
       return;
     }
     console.log(chalk4.white.bold("Supported Chains:\n"));
     console.log(chalk4.cyan("Mainnets:"));
-    SUPPORTED_CHAINS.filter((c) => c.type === "mainnet").forEach((chain) => {
-      console.log(`  ${chalk4.white(chain.name)} ${chalk4.gray(`(${chain.id})`)}`);
+    chains.filter((c) => c.type === "mainnet").forEach((chain) => {
+      console.log(
+        `  ${chalk4.white(chain.name)} ${chalk4.gray(`(${chain.chainId})`)}`
+      );
     });
     console.log(chalk4.cyan("\nTestnets:"));
-    SUPPORTED_CHAINS.filter((c) => c.type === "testnet").forEach((chain) => {
-      console.log(`  ${chalk4.white(chain.name)} ${chalk4.gray(`(${chain.id})`)}`);
+    chains.filter((c) => c.type === "testnet").forEach((chain) => {
+      console.log(
+        `  ${chalk4.white(chain.name)} ${chalk4.gray(`(${chain.chainId})`)}`
+      );
     });
   });
 }
@@ -2225,10 +2291,19 @@ async function executeTokenInfo(options) {
       const output = {
         address: tokenAddress,
         chainId: readOnlyOptions.chainId,
+        tokenUrl: tokenUrl(readOnlyOptions.chainId, tokenAddress),
+        explorerAddressUrl: explorerAddressUrl(
+          readOnlyOptions.chainId,
+          tokenAddress
+        ),
         token: {
           name: token.name,
           symbol: token.symbol,
           deployer: token.deployer,
+          deployerProfileUrl: profileUrl(
+            readOnlyOptions.chainId,
+            token.deployer
+          ),
           image: token.image,
           animation: token.animation || null,
           fid: token.fid.toString(),
@@ -2427,6 +2502,8 @@ async function executeProfileGet(options) {
       const output = {
         address: options.address,
         chainId: readOnlyOptions.chainId,
+        profileUrl: profileUrl(readOnlyOptions.chainId, options.address),
+        walletUrl: walletUrl(readOnlyOptions.chainId, options.address),
         profilePicture: profilePicture || null,
         displayName: displayName || null,
         xUsername: xUsername || null,
@@ -5679,38 +5756,70 @@ function formatComment(comment, depth) {
   ];
   return lines.join("\n");
 }
-function postToJson(post, index, commentCount) {
+function stripFeedPrefix2(topic) {
+  const match = topic.match(/^(.+?):comments:/);
+  const base9 = match ? match[1] : topic;
+  return base9.replace(/^feed-/i, "");
+}
+function postToJson(post, options) {
+  const { chainId, topicIndex, userIndex, globalIndex, commentCount } = options;
+  const feedName = stripFeedPrefix2(post.topic);
+  const postId = `${post.sender}:${post.timestamp}`;
+  const permalink = postPermalink(chainId, {
+    globalIndex,
+    topic: post.topic,
+    topicIndex,
+    user: userIndex !== void 0 ? post.sender : void 0,
+    userIndex
+  });
   const result = {
-    index,
+    postId,
+    permalink,
     sender: post.sender,
+    senderProfileUrl: profileUrl(chainId, post.sender),
+    senderWalletUrl: walletUrl(chainId, post.sender),
     text: post.text,
     timestamp: Number(post.timestamp),
+    feed: feedName,
+    feedUrl: feedUrl(chainId, feedName),
     topic: post.topic
   };
-  if (commentCount !== void 0) {
-    result.commentCount = commentCount;
-  }
-  if (post.data && post.data !== "0x") {
-    result.data = post.data;
-  }
+  if (topicIndex !== void 0) result.topicIndex = topicIndex;
+  if (userIndex !== void 0) result.userIndex = userIndex;
+  if (globalIndex !== void 0) result.globalIndex = globalIndex;
+  if (commentCount !== void 0) result.commentCount = commentCount;
+  if (post.data && post.data !== "0x") result.data = post.data;
   return result;
 }
-function feedToJson(feed, index) {
-  return {
+function feedToJson(feed, index, chainId) {
+  const result = {
     index,
     feedName: feed.feedName,
     registrant: feed.registrant,
     timestamp: feed.timestamp
   };
+  if (chainId !== void 0) {
+    result.feedUrl = feedUrl(chainId, feed.feedName);
+  }
+  return result;
 }
-function commentToJson(comment, depth) {
-  return {
+function commentToJson(comment, options) {
+  const { chainId, depth, parentPostUrl } = options;
+  const commentParam = `${comment.sender}-${comment.timestamp}`;
+  const permalink = parentPostUrl ? `${parentPostUrl}${parentPostUrl.includes("?") ? "&" : "?"}commentId=${commentParam}` : null;
+  const result = {
+    commentId: `${comment.sender}:${comment.timestamp}`,
+    permalink,
     sender: comment.sender,
+    senderProfileUrl: profileUrl(chainId, comment.sender),
     text: comment.text,
     timestamp: Number(comment.timestamp),
-    depth,
-    data: comment.data !== "0x" ? comment.data : void 0
+    depth
   };
+  if (comment.data !== "0x") {
+    result.data = comment.data;
+  }
+  return result;
 }
 function formatAgent(agent, index) {
   const timestamp = formatTimestamp(agent.timestamp);
@@ -5720,12 +5829,17 @@ function formatAgent(agent, index) {
   ];
   return lines.join("\n");
 }
-function agentToJson(agent, index) {
-  return {
+function agentToJson(agent, index, chainId) {
+  const result = {
     index,
     address: agent.address,
     timestamp: agent.timestamp
   };
+  if (chainId !== void 0) {
+    result.profileUrl = profileUrl(chainId, agent.address);
+    result.walletUrl = walletUrl(chainId, agent.address);
+  }
+  return result;
 }
 function printJson(data) {
   console.log(JSON.stringify(data, null, 2));
@@ -5743,7 +5857,11 @@ async function executeFeedList(options) {
       maxFeeds: options.limit ?? 50
     });
     if (options.json) {
-      printJson(feeds.map((feed, i) => feedToJson(feed, i)));
+      printJson(
+        feeds.map(
+          (feed, i) => feedToJson(feed, i, readOnlyOptions.chainId)
+        )
+      );
     } else {
       if (feeds.length === 0) {
         console.log(chalk4.yellow("No registered feeds found"));
@@ -5969,26 +6087,31 @@ async function executeFeedRead(feed, options) {
       return;
     }
     const fetchLimit = options.sender ? Math.max(limit * 5, 100) : limit;
-    let posts = await client.getFeedPosts({
+    const fetched = await client.getFeedPostsWithIndex({
       topic: normalizedFeed,
       maxPosts: fetchLimit
     });
+    let postsWithIndex = fetched.messages.map((post, i) => ({
+      post,
+      topicIndex: fetched.startIndex + i
+    }));
     if (options.sender) {
       const senderLower = options.sender.toLowerCase();
-      posts = posts.filter(
-        (post) => post.sender.toLowerCase() === senderLower
+      postsWithIndex = postsWithIndex.filter(
+        ({ post }) => post.sender.toLowerCase() === senderLower
       );
-      posts = posts.slice(0, limit);
+      postsWithIndex = postsWithIndex.slice(0, limit);
     }
     if (options.unseen) {
       const lastSeen = getLastSeenTimestamp(normalizedFeed);
       const myAddress = getMyAddress();
-      posts = posts.filter((post) => {
+      postsWithIndex = postsWithIndex.filter(({ post }) => {
         const isNew = lastSeen === null || Number(post.timestamp) > lastSeen;
         const isFromOther = !myAddress || post.sender.toLowerCase() !== myAddress;
         return isNew && isFromOther;
       });
     }
+    const posts = postsWithIndex.map(({ post }) => post);
     if (options.markSeen) {
       const allPosts = await client.getFeedPosts({
         topic: normalizedFeed,
@@ -6004,7 +6127,13 @@ async function executeFeedRead(feed, options) {
     );
     if (options.json) {
       printJson(
-        posts.map((post, i) => postToJson(post, i, commentCounts[i]))
+        postsWithIndex.map(
+          ({ post, topicIndex }, i) => postToJson(post, {
+            chainId: readOnlyOptions.chainId,
+            topicIndex,
+            commentCount: commentCounts[i]
+          })
+        )
       );
     } else {
       if (posts.length === 0) {
@@ -6066,6 +6195,34 @@ async function executeTransaction(walletClient, txConfig) {
   });
   return hash;
 }
+async function getMessageIndicesFromTx(params) {
+  const publicClient = getPublicClient({
+    chainId: params.chainId,
+    rpcUrl: params.rpcUrl
+  });
+  const netContract = getNetContract(params.chainId);
+  const contractAddress = netContract.address.toLowerCase();
+  const receipt = await publicClient.waitForTransactionReceipt({
+    hash: params.txHash
+  });
+  const indices = [];
+  for (const log of receipt.logs) {
+    if (log.address.toLowerCase() !== contractAddress) continue;
+    try {
+      const decoded = decodeEventLog({
+        abi: netContract.abi,
+        data: log.data,
+        topics: log.topics
+      });
+      if (decoded.eventName === "MessageSent") {
+        const args = decoded.args;
+        indices.push(Number(args.messageIndex));
+      }
+    } catch {
+    }
+  }
+  return indices;
+}
 
 // src/commands/feed/post.ts
 var MAX_MESSAGE_LENGTH = 4e3;
@@ -6117,11 +6274,23 @@ ${options.body}` : message;
     commonOptions.chainId,
     commonOptions.rpcUrl
   );
-  console.log(chalk4.blue(`Posting to feed "${normalizedFeed}"...`));
+  if (!options.json) {
+    console.log(chalk4.blue(`Posting to feed "${normalizedFeed}"...`));
+  }
   try {
     const hash = await executeTransaction(walletClient, txConfig);
     const senderAddress = walletClient.account.address;
     let postId;
+    let globalIndex;
+    try {
+      const indices = await getMessageIndicesFromTx({
+        chainId: commonOptions.chainId,
+        rpcUrl: commonOptions.rpcUrl,
+        txHash: hash
+      });
+      globalIndex = indices[0];
+    } catch {
+    }
     try {
       const posts = await client.getFeedPosts({
         topic: normalizedFeed,
@@ -6143,19 +6312,36 @@ ${options.body}` : message;
       sender: senderAddress,
       text: fullMessage,
       postId
-      // Now we have the actual post ID for checking comments later
     });
+    const permalink = postPermalink(commonOptions.chainId, {
+      globalIndex
+    });
+    if (options.json) {
+      printJson({
+        success: true,
+        txHash: hash,
+        explorerTxUrl: explorerTxUrl(commonOptions.chainId, hash),
+        postId,
+        globalIndex,
+        permalink,
+        feed: normalizedFeed,
+        feedUrl: feedUrl(commonOptions.chainId, normalizedFeed),
+        sender: senderAddress,
+        senderProfileUrl: profileUrl(commonOptions.chainId, senderAddress),
+        text: fullMessage
+      });
+      return;
+    }
     const displayText = options.body ? `${message} (+ body)` : message;
-    const postIdInfo = postId ? `
-  Post ID: ${postId}` : "";
-    console.log(
-      chalk4.green(
-        `Message posted successfully!
-  Transaction: ${hash}
-  Feed: ${normalizedFeed}${postIdInfo}
-  Text: ${displayText}`
-      )
-    );
+    const lines = [
+      `Message posted successfully!`,
+      `  Transaction: ${hash}`,
+      `  Feed: ${normalizedFeed}`
+    ];
+    if (postId) lines.push(`  Post ID: ${postId}`);
+    if (permalink) lines.push(`  Permalink: ${permalink}`);
+    lines.push(`  Text: ${displayText}`);
+    console.log(chalk4.green(lines.join("\n")));
   } catch (error) {
     exitWithError(
       `Failed to post message: ${error instanceof Error ? error.message : String(error)}`
@@ -6170,7 +6356,10 @@ function registerFeedPostCommand(parent) {
   ).option("--rpc-url <url>", "Custom RPC URL").option("--private-key <key>", "Private key (0x-prefixed)").option(
     "--encode-only",
     "Output transaction data as JSON instead of executing"
-  ).option("--data <data>", "Optional data to attach to the post").option("--body <text>", "Post body (message becomes the title)").action(async (feed, message, options) => {
+  ).option("--data <data>", "Optional data to attach to the post").option("--body <text>", "Post body (message becomes the title)").option(
+    "--json",
+    "Output structured JSON (includes permalink and other URLs) after submission"
+  ).action(async (feed, message, options) => {
     await executeFeedPost(feed, message, options);
   });
 }
@@ -6199,11 +6388,6 @@ function parsePostId(postId) {
     timestamp
   };
 }
-function findPostByParsedId(posts, parsedId) {
-  return posts.find(
-    (p) => p.sender.toLowerCase() === parsedId.sender.toLowerCase() && p.timestamp === parsedId.timestamp
-  );
-}
 
 // src/commands/feed/comment-write.ts
 var MAX_MESSAGE_LENGTH2 = 4e3;
@@ -6236,17 +6420,20 @@ async function executeFeedCommentWrite(feed, postId, message, options) {
       `Feed "${normalizedFeed}" has no posts. Cannot find post ${postId}.`
     );
   }
-  const posts = await client.getFeedPosts({
+  const fetched = await client.getFeedPostsWithIndex({
     topic: normalizedFeed,
     maxPosts: 100
-    // Fetch enough to find the post
   });
-  const targetPost = findPostByParsedId(posts, parsedId);
+  const matchOffset = fetched.messages.findIndex(
+    (p) => p.sender.toLowerCase() === parsedId.sender.toLowerCase() && p.timestamp === parsedId.timestamp
+  );
+  const targetPost = matchOffset >= 0 ? fetched.messages[matchOffset] : void 0;
   if (!targetPost) {
     exitWithError(
       `Post not found with ID ${postId} in feed "${normalizedFeed}". Make sure the sender and timestamp are correct.`
     );
   }
+  const parentTopicIndex = fetched.startIndex + matchOffset;
   const txConfig = client.prepareComment({
     post: targetPost,
     text: message
@@ -6270,26 +6457,81 @@ async function executeFeedCommentWrite(feed, postId, message, options) {
     commonOptions.chainId,
     commonOptions.rpcUrl
   );
-  console.log(chalk4.blue(`Commenting on post ${postId}...`));
+  if (!options.json) {
+    console.log(chalk4.blue(`Commenting on post ${postId}...`));
+  }
   try {
     const hash = await executeTransaction(walletClient, txConfig);
+    const senderAddress = walletClient.account.address;
+    let globalIndex;
+    try {
+      const indices = await getMessageIndicesFromTx({
+        chainId: commonOptions.chainId,
+        rpcUrl: commonOptions.rpcUrl,
+        txHash: hash
+      });
+      globalIndex = indices[0];
+    } catch {
+    }
+    let commentTimestamp;
+    if (globalIndex !== void 0) {
+      try {
+        const netClient = createNetClient(commonOptions);
+        const fetchedComment = await netClient.getMessageAtIndex({
+          messageIndex: globalIndex
+        });
+        if (fetchedComment) {
+          commentTimestamp = Number(fetchedComment.timestamp);
+        }
+      } catch {
+      }
+    }
     addHistoryEntry({
       type: "comment",
       txHash: hash,
       chainId: commonOptions.chainId,
       feed: normalizedFeed,
-      sender: walletClient.account.address,
+      sender: senderAddress,
       text: message,
       postId
     });
-    console.log(
-      chalk4.green(
-        `Comment posted successfully!
-  Transaction: ${hash}
-  Post: ${postId}
-  Comment: ${message}`
-      )
-    );
+    const parentPostUrl = postPermalink(commonOptions.chainId, {
+      topic: normalizedFeed,
+      topicIndex: parentTopicIndex
+    });
+    const commentPermalink = commentTimestamp !== void 0 ? postPermalink(commonOptions.chainId, {
+      topic: normalizedFeed,
+      topicIndex: parentTopicIndex,
+      commentId: `${senderAddress}-${commentTimestamp}`
+    }) : postPermalink(commonOptions.chainId, { globalIndex });
+    if (options.json) {
+      printJson({
+        success: true,
+        txHash: hash,
+        explorerTxUrl: explorerTxUrl(commonOptions.chainId, hash),
+        globalIndex,
+        permalink: commentPermalink,
+        parentPostId: postId,
+        parentPostUrl,
+        feed: normalizedFeed,
+        feedUrl: feedUrl(commonOptions.chainId, normalizedFeed),
+        sender: senderAddress,
+        senderProfileUrl: profileUrl(commonOptions.chainId, senderAddress),
+        text: message,
+        ...commentTimestamp !== void 0 && {
+          commentId: `${senderAddress}:${commentTimestamp}`
+        }
+      });
+      return;
+    }
+    const lines = [
+      `Comment posted successfully!`,
+      `  Transaction: ${hash}`,
+      `  Post: ${postId}`
+    ];
+    if (commentPermalink) lines.push(`  Permalink: ${commentPermalink}`);
+    lines.push(`  Comment: ${message}`);
+    console.log(chalk4.green(lines.join("\n")));
   } catch (error) {
     exitWithError(
       `Failed to post comment: ${error instanceof Error ? error.message : String(error)}`
@@ -6306,6 +6548,9 @@ function registerFeedCommentWriteCommand(parent) {
   ).option("--rpc-url <url>", "Custom RPC URL").option("--private-key <key>", "Private key (0x-prefixed)").option(
     "--encode-only",
     "Output transaction data as JSON instead of executing"
+  ).option(
+    "--json",
+    "Output structured JSON (includes permalink and other URLs) after submission"
   ).action(async (feed, postId, message, options) => {
     await executeFeedCommentWrite(feed, postId, message, options);
   });
@@ -6332,17 +6577,25 @@ async function executeFeedCommentRead(feed, postId, options) {
         `Feed "${normalizedFeed}" has no posts. Cannot find post ${postId}.`
       );
     }
-    const posts = await client.getFeedPosts({
+    const fetched = await client.getFeedPostsWithIndex({
       topic: normalizedFeed,
       maxPosts: 100
       // Fetch enough to find the post
     });
-    const targetPost = findPostByParsedId(posts, parsedId);
+    const matchIndex = fetched.messages.findIndex(
+      (p) => p.sender.toLowerCase() === parsedId.sender.toLowerCase() && p.timestamp === parsedId.timestamp
+    );
+    const targetPost = matchIndex >= 0 ? fetched.messages[matchIndex] : void 0;
     if (!targetPost) {
       exitWithError(
         `Post not found with ID ${postId} in feed "${normalizedFeed}". Make sure the sender and timestamp are correct.`
       );
     }
+    const parentTopicIndex = fetched.startIndex + matchIndex;
+    const parentPostUrl = postPermalink(readOnlyOptions.chainId, {
+      topic: normalizedFeed,
+      topicIndex: parentTopicIndex
+    });
     const commentCount = await client.getCommentCount(targetPost);
     if (commentCount === 0) {
       if (options.json) {
@@ -6363,7 +6616,11 @@ async function executeFeedCommentRead(feed, postId, options) {
     if (options.json) {
       printJson(
         commentsWithDepth.map(
-          ({ comment, depth }) => commentToJson(comment, depth)
+          ({ comment, depth }) => commentToJson(comment, {
+            chainId: readOnlyOptions.chainId,
+            depth,
+            parentPostUrl
+          })
         )
       );
     } else {
@@ -6504,8 +6761,10 @@ async function executeFeedReplies(options) {
     rpcUrl: options.rpcUrl
   });
   const client = createFeedClient(readOnlyOptions);
-  console.log(chalk4.blue(`Checking replies on ${postsWithIds.length} posts...
+  if (!options.json) {
+    console.log(chalk4.blue(`Checking replies on ${postsWithIds.length} posts...
 `));
+  }
   const results = [];
   for (const entry of postsWithIds) {
     try {
@@ -6520,12 +6779,31 @@ async function executeFeedReplies(options) {
         data: "0x"
       };
       const commentCount = await client.getCommentCount(postObj);
+      let permalink = null;
+      try {
+        const indices = await getMessageIndicesFromTx({
+          chainId: readOnlyOptions.chainId,
+          rpcUrl: readOnlyOptions.rpcUrl,
+          txHash: entry.txHash
+        });
+        if (indices[0] !== void 0) {
+          permalink = postPermalink(readOnlyOptions.chainId, {
+            globalIndex: indices[0]
+          });
+        }
+      } catch {
+      }
       results.push({
         feed: entry.feed,
         postId: entry.postId,
         text: entry.text ?? "",
         postedAt: entry.timestamp,
-        commentCount: Number(commentCount)
+        commentCount: Number(commentCount),
+        permalink,
+        feedUrl: feedUrl(readOnlyOptions.chainId, entry.feed),
+        senderProfileUrl: entry.sender ? profileUrl(readOnlyOptions.chainId, entry.sender) : null,
+        explorerTxUrl: explorerTxUrl(readOnlyOptions.chainId, entry.txHash),
+        txHash: entry.txHash
       });
     } catch {
     }
@@ -6610,7 +6888,14 @@ async function executeFeedPosts(address, options) {
       endIndex: count
     });
     if (options.json) {
-      printJson(messages.map((msg, i) => postToJson(msg, i)));
+      printJson(
+        messages.map(
+          (msg, i) => postToJson(msg, {
+            chainId: readOnlyOptions.chainId,
+            userIndex: startIndex + i
+          })
+        )
+      );
     } else {
       console.log(
         chalk4.white(`Found ${messages.length} post(s) by ${address}:
@@ -6788,11 +7073,14 @@ function historyEntryToJson(entry, index) {
     type: entry.type,
     timestamp: entry.timestamp,
     txHash: entry.txHash,
+    explorerTxUrl: explorerTxUrl(entry.chainId, entry.txHash),
     chainId: entry.chainId,
-    feed: entry.feed
+    feed: entry.feed,
+    feedUrl: feedUrl(entry.chainId, entry.feed)
   };
   if (entry.sender) {
     result.sender = entry.sender;
+    result.senderProfileUrl = profileUrl(entry.chainId, entry.sender);
   }
   if (entry.text) {
     result.text = entry.text;
@@ -6966,7 +7254,9 @@ async function executeListAgents(options) {
     if (options.json) {
       printJson({
         totalCount,
-        agents: agents.map((agent, i) => agentToJson(agent, i))
+        agents: agents.map(
+          (agent, i) => agentToJson(agent, i, readOnlyOptions.chainId)
+        )
       });
     } else {
       if (agents.length === 0) {
@@ -7025,9 +7315,13 @@ async function executeFeedVerifyClaim(txHash, options) {
   const netClient = createNetClient(readOnlyOptions);
   const existingHistory = getHistory();
   if (existingHistory.some((entry) => entry.txHash === txHash)) {
-    console.log(
-      chalk4.yellow("Transaction already recorded in history. Skipping.")
-    );
+    if (options.json) {
+      printJson({ alreadyRecorded: true, txHash });
+    } else {
+      console.log(
+        chalk4.yellow("Transaction already recorded in history. Skipping.")
+      );
+    }
     return;
   }
   const receipt = await publicClient.getTransactionReceipt({ hash: txHash }).catch(
@@ -7062,11 +7356,13 @@ async function executeFeedVerifyClaim(txHash, options) {
       "Transaction does not contain any Net protocol messages."
     );
   }
-  console.log(
-    chalk4.blue(
-      `Found ${messageSentEvents.length} message(s) in transaction. Fetching details...`
-    )
-  );
+  if (!options.json) {
+    console.log(
+      chalk4.blue(
+        `Found ${messageSentEvents.length} message(s) in transaction. Fetching details...`
+      )
+    );
+  }
   const messages = await Promise.all(
     messageSentEvents.map(
       (event) => netClient.getMessageAtIndex({
@@ -7074,41 +7370,40 @@ async function executeFeedVerifyClaim(txHash, options) {
       })
     )
   );
+  const entries = [];
   let recorded = 0;
   for (let i = 0; i < messages.length; i++) {
     const message = messages[i];
     if (!message) {
-      console.log(
-        chalk4.yellow(
-          `  Could not fetch message at index ${messageSentEvents[i].messageIndex}. Skipping.`
-        )
-      );
+      if (!options.json) {
+        console.log(
+          chalk4.yellow(
+            `  Could not fetch message at index ${messageSentEvents[i].messageIndex}. Skipping.`
+          )
+        );
+      }
       continue;
     }
+    const globalIndex = Number(messageSentEvents[i].messageIndex);
     const feedName = extractFeedName(message.topic);
     const isComment = isCommentTopic(message.topic);
     let type;
     let postId;
-    let label;
+    let parentPostId;
+    let permalink = null;
     if (isComment) {
       type = "comment";
       const commentData = parseCommentData(message.data);
-      postId = commentData ? `${commentData.parentSender}:${commentData.parentTimestamp}` : void 0;
-      label = `Verified comment:
-    Feed: ${feedName}
-    Sender: ${message.sender}
-    Text: ${message.text}
-    Parent post: ${postId ?? "unknown"}
-    Tx: ${txHash}`;
+      parentPostId = commentData ? `${commentData.parentSender}:${commentData.parentTimestamp}` : void 0;
+      const commentParam = `${message.sender}-${Number(message.timestamp)}`;
+      permalink = postPermalink(readOnlyOptions.chainId, {
+        globalIndex,
+        commentId: commentParam
+      });
     } else {
       type = "post";
       postId = createPostId(message);
-      label = `Verified post:
-    Feed: ${feedName}
-    Sender: ${message.sender}
-    Text: ${message.text}
-    Post ID: ${postId}
-    Tx: ${txHash}`;
+      permalink = postPermalink(readOnlyOptions.chainId, { globalIndex });
     }
     addHistoryEntry({
       type,
@@ -7117,11 +7412,49 @@ async function executeFeedVerifyClaim(txHash, options) {
       feed: feedName,
       sender: message.sender,
       text: message.text,
-      postId
+      postId: type === "comment" ? parentPostId : postId
     });
-    console.log(chalk4.green(`  ${label}`));
+    const entry = {
+      type,
+      txHash,
+      explorerTxUrl: explorerTxUrl(readOnlyOptions.chainId, txHash),
+      globalIndex,
+      permalink,
+      feed: feedName,
+      feedUrl: feedUrl(readOnlyOptions.chainId, feedName),
+      sender: message.sender,
+      senderProfileUrl: profileUrl(
+        readOnlyOptions.chainId,
+        message.sender
+      ),
+      text: message.text,
+      timestamp: Number(message.timestamp)
+    };
+    if (type === "post") entry.postId = postId;
+    if (type === "comment") entry.parentPostId = parentPostId;
+    entries.push(entry);
+    if (!options.json) {
+      const label = type === "comment" ? `Verified comment:
+    Feed: ${feedName}
+    Sender: ${message.sender}
+    Text: ${message.text}
+    Parent post: ${parentPostId ?? "unknown"}
+    Permalink: ${permalink ?? "(unavailable)"}
+    Tx: ${txHash}` : `Verified post:
+    Feed: ${feedName}
+    Sender: ${message.sender}
+    Text: ${message.text}
+    Post ID: ${postId}
+    Permalink: ${permalink ?? "(unavailable)"}
+    Tx: ${txHash}`;
+      console.log(chalk4.green(`  ${label}`));
+    }
     recorded++;
   }
+  if (options.json) {
+    printJson({ recorded, entries });
+    return;
+  }
   if (recorded > 0) {
     console.log(
       chalk4.green(`
@@ -7136,7 +7469,10 @@ function registerFeedVerifyClaimCommand(parent) {
     "--chain-id <id>",
     "Chain ID (default: 8453 for Base)",
     (value) => parseInt(value, 10)
-  ).option("--rpc-url <url>", "Custom RPC URL").action(async (txHash, options) => {
+  ).option("--rpc-url <url>", "Custom RPC URL").option(
+    "--json",
+    "Output structured JSON (includes permalink and other URLs)"
+  ).action(async (txHash, options) => {
     await executeFeedVerifyClaim(txHash, options);
   });
 }
@@ -7332,6 +7668,7 @@ async function executeGetUpvotes(options) {
         JSON.stringify(
           {
             tokenAddress,
+            tokenUrl: tokenUrl(readOnlyOptions.chainId, tokenAddress),
             scoreKey,
             total,
             strategies: strategyCounts.map((s) => ({
@@ -7500,6 +7837,8 @@ async function executeGetUserUpvotes(options) {
           {
             address: userAddress,
             chainId: readOnlyOptions.chainId,
+            profileUrl: profileUrl(readOnlyOptions.chainId, userAddress),
+            walletUrl: walletUrl(readOnlyOptions.chainId, userAddress),
             upvotesGiven: Number(given),
             upvotesReceived: Number(received),
             upvotePriceWei: upvotePrice.toString(),