docs: update Discord bot invitation instructions

- Replace dead discordjs.guide link with comprehensive self-contained instructions
- Add step-by-step guide for using Discord's OAuth2 URL Generator
- Include quick invite URL template with pre-calculated permissions (18432)
- Permissions: Send Messages (2048) + Embed Links (16384)

Author: ryanio

README.md

@@ -96,9 +96,20 @@ Originally developed for [@dutchtide](https://twitter.com/dutchtide)'s [𝕄𝕚
 
 **Discord Setup:**
 1. [Create a Discord application](https://discord.com/developers/applications)
-2. Create a bot with permissions: `Send Messages` and `Embed Links`
-3. [Add bot to your server](https://discordjs.guide/preparations/adding-your-bot-to-servers.html#bot-invite-links)
+2. Go to the **Bot** tab and click "Add Bot"
+3. Under **Privileged Gateway Intents**, enable any intents you need (none required for this bot)
 4. Copy the bot token to `DISCORD_TOKEN`
+5. **Invite bot to your server:**
+   - Go to **OAuth2** → **URL Generator**
+   - Under **Scopes**, select `bot`
+   - Under **Bot Permissions**, select `Send Messages` and `Embed Links`
+   - Copy the generated URL and open it in your browser
+   - Select your server and authorize
+
+**Quick Invite URL** (replace `YOUR_CLIENT_ID` with your application's Client ID from the OAuth2 page):
+```
+https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=18432&scope=bot
+```
 
 **DISCORD_EVENTS Format:**
 - Single channel: `CHANNEL_ID=event1,event2`

package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensea-activity-bot",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "A bot that shares new OpenSea events for a collection to Discord and Twitter.",
   "author": "Ryan Ghods <ryan@ryanio.com>",
   "license": "MIT",

src/index.ts

@@ -7,11 +7,17 @@ import {
 import { messageEvents } from "./platforms/discord";
 import { tweetEvents } from "./platforms/twitter";
 import type { OpenSeaAssetEvent } from "./types";
+import { MS_PER_SECOND } from "./utils/constants";
 import { getDefaultEventGroupConfig } from "./utils/event-grouping";
 import { logger } from "./utils/logger";
-import { botInterval, chain, fullTokenAddr, minOfferETH } from "./utils/utils";
-
-const MILLISECONDS_PER_SECOND = 1000;
+import {
+  botInterval,
+  chain,
+  formatReadableDate,
+  formatTimeAgo,
+  fullTokenAddr,
+  minOfferETH,
+} from "./utils/utils";
 
 const logPlatformConfig = (
   twitterEnabled: boolean,
@@ -36,9 +42,7 @@ const logPlatformConfig = (
       process.env.TWITTER_PREPEND_TWEET || process.env.TWITTER_APPEND_TWEET;
     logger.info(`│     ${hasPrependOrAppend ? "├─" : "└─"} Grouping`);
     logger.info(`│        ├─ Min Group Size: ${config.minGroupSize} items`);
-    logger.info(
-      `│        └─ Settle Time: ${config.settleMs / MILLISECONDS_PER_SECOND}s`
-    );
+    logger.info(`│        └─ Settle Time: ${config.settleMs / MS_PER_SECOND}s`);
   }
   logger.info("│");
   logger.info(
@@ -50,9 +54,7 @@ const logPlatformConfig = (
     const config = getDefaultEventGroupConfig("DISCORD");
     logger.info("│     └─ Grouping");
     logger.info(`│        ├─ Min Group Size: ${config.minGroupSize} items`);
-    logger.info(
-      `│        └─ Settle Time: ${config.settleMs / MILLISECONDS_PER_SECOND}s`
-    );
+    logger.info(`│        └─ Settle Time: ${config.settleMs / MS_PER_SECOND}s`);
   }
   logger.info("│");
 };
@@ -117,7 +119,10 @@ const logStartupConfiguration = async () => {
   logger.info(`│  ⛓️   Chain: ${chain}`);
   logger.info(`│  ⏱️   Poll Interval: ${botInterval}s`);
   if (eventTimestampInfo) {
-    logger.info(`│  🕐  Event Timestamp: ${eventTimestampInfo.timestamp}`);
+    const ts = eventTimestampInfo.timestamp;
+    logger.info(
+      `│  🕐  Last Event: ${formatReadableDate(ts)} (${formatTimeAgo(ts)})`
+    );
     logger.info(
       `│      └─ Source: ${formatTimestampSource(eventTimestampInfo.source)}`
     );
@@ -152,7 +157,6 @@ async function main() {
   await logStartupConfiguration();
   run();
 
-  const MS_PER_SECOND = 1000;
   const interval = setInterval(run.bind(this), botInterval * MS_PER_SECOND);
 
   process.on("SIGINT", () => {

src/platforms/twitter.ts

@@ -2,6 +2,7 @@ import { TwitterApi } from "twitter-api-v2";
 import { EventType, getCollectionSlug, opensea, username } from "../opensea";
 import type { BotEvent, OpenSeaAssetEvent, OpenSeaPayment } from "../types";
 import { txHashFor } from "../utils/aggregator";
+import { MS_PER_SECOND, SECONDS_PER_MINUTE } from "../utils/constants";
 import {
   calculateTotalSpent,
   EventGroupManager,
@@ -41,11 +42,9 @@ const tweetedEventsCache = new LRUCache<string, boolean>(
 // Queue + backoff config
 const DEFAULT_TWEET_DELAY_MS = 3000;
 const DEFAULT_BACKOFF_BASE_MS = 15_000;
-const MINUTES = 60;
-const SECONDS_PER_MINUTE = 60;
-const MS_PER_SECOND = 1000;
 const BACKOFF_MAX_MINUTES = 15;
-const DEFAULT_BACKOFF_MAX_MS = BACKOFF_MAX_MINUTES * MINUTES * MS_PER_SECOND;
+const DEFAULT_BACKOFF_MAX_MS =
+  BACKOFF_MAX_MINUTES * SECONDS_PER_MINUTE * MS_PER_SECOND;
 const DEFAULT_PROCESSING_TIMEOUT_MINUTES = 2;
 const DEFAULT_PROCESSING_TIMEOUT_MS =
   DEFAULT_PROCESSING_TIMEOUT_MINUTES * SECONDS_PER_MINUTE * MS_PER_SECOND;

src/utils/constants.ts

@@ -12,5 +12,6 @@ export const NULL_ONE_ADDRESS = "0x0000000000000000000000000000000000000001";
 export const MIN_GROUP_SIZE = 2;
 export const DEFAULT_SETTLE_MS = 60_000;
 
-// Milliseconds per second (for utility conversions)
+// Time constants (for utility conversions)
 export const MS_PER_SECOND = 1000;
+export const SECONDS_PER_MINUTE = 60;

src/utils/event-state.ts

@@ -1,9 +1,9 @@
 import { promises as fs } from "node:fs";
 import { dirname, join } from "node:path";
+import { SECONDS_PER_MINUTE } from "./constants";
 import { logger } from "./logger";
 
 const DEFAULT_DEDUPE_WINDOW_MINUTES = 60;
-const SECONDS_PER_MINUTE = 60;
 
 export type EventCursor = {
   source: string;

src/utils/utils.ts

@@ -4,6 +4,7 @@ import type { NFTLike } from "./aggregator";
 import {
   DEAD_ADDRESS,
   GLYPHBOTS_CONTRACT_ADDRESS,
+  MS_PER_SECOND,
   NULL_ADDRESS,
   NULL_ONE_ADDRESS,
 } from "./constants";
@@ -13,9 +14,45 @@ export function timeout(ms: number) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-const SECONDS_PER_MS = 1000;
 export const unixTimestamp = (date: Date) =>
-  Math.floor(date.getTime() / SECONDS_PER_MS);
+  Math.floor(date.getTime() / MS_PER_SECOND);
+
+/**
+ * Formats a Unix timestamp as a relative time string (e.g., "2 hours ago")
+ */
+export const formatTimeAgo = (timestamp: number): string => {
+  const now = Date.now();
+  const diffMs = now - timestamp * MS_PER_SECOND;
+  const diffSeconds = Math.floor(diffMs / MS_PER_SECOND);
+  const diffMinutes = Math.floor(diffSeconds / 60);
+  const diffHours = Math.floor(diffMinutes / 60);
+  const diffDays = Math.floor(diffHours / 24);
+
+  if (diffDays > 0) {
+    return `${diffDays} day${diffDays === 1 ? "" : "s"} ago`;
+  }
+  if (diffHours > 0) {
+    return `${diffHours} hour${diffHours === 1 ? "" : "s"} ago`;
+  }
+  if (diffMinutes > 0) {
+    return `${diffMinutes} minute${diffMinutes === 1 ? "" : "s"} ago`;
+  }
+  return "just now";
+};
+
+/**
+ * Formats a Unix timestamp as a human-readable date (e.g., "Dec 4, 2025, 10:30 AM")
+ */
+export const formatReadableDate = (timestamp: number): string => {
+  const date = new Date(timestamp * MS_PER_SECOND);
+  return date.toLocaleDateString("en-US", {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    hour: "numeric",
+    minute: "2-digit",
+  });
+};
 
 /**
  * Returns a shortened version of a full ethereum address