@net-protocol/cli 0.1.42 → 0.1.44

package/dist/feed/index.mjs

@@ -1,7 +1,7 @@
 import chalk12 from 'chalk';
 import { isCommentTopic, parseCommentData, FeedRegistryClient, FeedClient, AgentRegistryClient, COMMENT_TOPIC_SUFFIX, FEED_TOPIC_PREFIX } from '@net-protocol/feeds';
 import '@net-protocol/chats';
-import { NULL_ADDRESS, getPublicClient, getNetContract, getBaseDataSuffix, getChainRpcUrls, NetClient } from '@net-protocol/core';
+import { NULL_ADDRESS, getPublicClient, getNetContract, getBaseDataSuffix, getChainRpcUrls, getChainBlockExplorer, NetClient, getChainSlug } from '@net-protocol/core';
 import '@net-protocol/storage';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -91,6 +91,61 @@ function exitWithError(message) {
   console.error(chalk12.red(`Error: ${message}`));
   process.exit(1);
 }
+var WEBSITE_BASE = "https://netprotocol.app";
+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 explorerTxUrl(chainId, txHash) {
+  const base = getChainBlockExplorer({ chainId })?.url;
+  if (!base) return null;
+  return `${base}/tx/${txHash}`;
+}
+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()}`;
+}
+
+// src/commands/feed/format.ts
 function truncateAddress(address) {
   if (address.length <= 12) return address;
   return `${address.slice(0, 6)}...${address.slice(-4)}`;
@@ -144,38 +199,70 @@ function formatComment(comment, depth) {
   ];
   return lines.join("\n");
 }
-function postToJson(post, index, commentCount) {
+function stripFeedPrefix2(topic) {
+  const match = topic.match(/^(.+?):comments:/);
+  const base = match ? match[1] : topic;
+  return base.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);
@@ -185,12 +272,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));
@@ -208,7 +300,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(chalk12.yellow("No registered feeds found"));
@@ -434,26 +530,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,
@@ -469,7 +570,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) {
@@ -546,6 +653,34 @@ function encodeTransaction(config, chainId) {
     value: config.value?.toString() ?? "0"
   };
 }
+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;
@@ -597,11 +732,23 @@ ${options.body}` : message;
     commonOptions.chainId,
     commonOptions.rpcUrl
   );
-  console.log(chalk12.blue(`Posting to feed "${normalizedFeed}"...`));
+  if (!options.json) {
+    console.log(chalk12.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,
@@ -623,19 +770,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(
-      chalk12.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(chalk12.green(lines.join("\n")));
   } catch (error) {
     exitWithError(
       `Failed to post message: ${error instanceof Error ? error.message : String(error)}`
@@ -650,7 +814,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);
   });
 }
@@ -679,11 +846,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;
@@ -716,17 +878,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
@@ -750,26 +915,81 @@ async function executeFeedCommentWrite(feed, postId, message, options) {
     commonOptions.chainId,
     commonOptions.rpcUrl
   );
-  console.log(chalk12.blue(`Commenting on post ${postId}...`));
+  if (!options.json) {
+    console.log(chalk12.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(
-      chalk12.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(chalk12.green(lines.join("\n")));
   } catch (error) {
     exitWithError(
       `Failed to post comment: ${error instanceof Error ? error.message : String(error)}`
@@ -786,6 +1006,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);
   });
@@ -812,17 +1035,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) {
@@ -843,7 +1074,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 {
@@ -984,8 +1219,10 @@ async function executeFeedReplies(options) {
     rpcUrl: options.rpcUrl
   });
   const client = createFeedClient(readOnlyOptions);
-  console.log(chalk12.blue(`Checking replies on ${postsWithIds.length} posts...
+  if (!options.json) {
+    console.log(chalk12.blue(`Checking replies on ${postsWithIds.length} posts...
 `));
+  }
   const results = [];
   for (const entry of postsWithIds) {
     try {
@@ -1000,12 +1237,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 {
     }
@@ -1090,7 +1346,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(
         chalk12.white(`Found ${messages.length} post(s) by ${address}:
@@ -1268,11 +1531,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;
@@ -1446,7 +1712,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) {
@@ -1505,9 +1773,13 @@ async function executeFeedVerifyClaim(txHash, options) {
   const netClient = createNetClient(readOnlyOptions);
   const existingHistory = getHistory();
   if (existingHistory.some((entry) => entry.txHash === txHash)) {
-    console.log(
-      chalk12.yellow("Transaction already recorded in history. Skipping.")
-    );
+    if (options.json) {
+      printJson({ alreadyRecorded: true, txHash });
+    } else {
+      console.log(
+        chalk12.yellow("Transaction already recorded in history. Skipping.")
+      );
+    }
     return;
   }
   const receipt = await publicClient.getTransactionReceipt({ hash: txHash }).catch(
@@ -1542,11 +1814,13 @@ async function executeFeedVerifyClaim(txHash, options) {
       "Transaction does not contain any Net protocol messages."
     );
   }
-  console.log(
-    chalk12.blue(
-      `Found ${messageSentEvents.length} message(s) in transaction. Fetching details...`
-    )
-  );
+  if (!options.json) {
+    console.log(
+      chalk12.blue(
+        `Found ${messageSentEvents.length} message(s) in transaction. Fetching details...`
+      )
+    );
+  }
   const messages = await Promise.all(
     messageSentEvents.map(
       (event) => netClient.getMessageAtIndex({
@@ -1554,41 +1828,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(
-        chalk12.yellow(
-          `  Could not fetch message at index ${messageSentEvents[i].messageIndex}. Skipping.`
-        )
-      );
+      if (!options.json) {
+        console.log(
+          chalk12.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,
@@ -1597,11 +1870,49 @@ async function executeFeedVerifyClaim(txHash, options) {
       feed: feedName,
       sender: message.sender,
       text: message.text,
-      postId
+      postId: type === "comment" ? parentPostId : postId
     });
-    console.log(chalk12.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(chalk12.green(`  ${label}`));
+    }
     recorded++;
   }
+  if (options.json) {
+    printJson({ recorded, entries });
+    return;
+  }
   if (recorded > 0) {
     console.log(
       chalk12.green(`
@@ -1616,7 +1927,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);
   });
 }