@madeonsol/plugin-madeonsol 0.5.0 → 0.6.0

package/README.md

@@ -1,8 +1,8 @@
 # @madeonsol/plugin-madeonsol
 
-ElizaOS plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL trading intelligence and deployer analytics.
+ElizaOS plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL trading intelligence, deployer analytics, and wallet tracking.
 
-> Real-time Solana trading intelligence: track 1,000+ KOL wallets with <3s latency, score 6,700+ Pump.fun deployers by reputation, detect multi-KOL coordination signals, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/developer](https://madeonsol.com/developer) — no credit card required.
+> Real-time Solana trading intelligence: track 1,000+ KOL wallets with <3s latency, score 6,700+ Pump.fun deployers by reputation, detect multi-KOL coordination signals, monitor any Solana wallet for swaps and transfers, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/developer](https://madeonsol.com/developer) — no credit card required.
 
 ## Authentication
 
@@ -11,20 +11,20 @@ Three options (in priority order):
 | Method | Setting | Best for |
 |---|---|---|
 | **MadeOnSol API key** (recommended) | `MADEONSOL_API_KEY` | Developers — [get a free key](https://madeonsol.com/developer) |
-| RapidAPI key | `RAPIDAPI_KEY` | RapidAPI subscribers |
 | x402 micropayments | `SVM_PRIVATE_KEY` | AI agents with Solana wallets |
 
 ## What it does
 
 Gives your ElizaOS agent access to MadeOnSol's Solana intelligence API.
 
-| Action | Endpoint |
-|--------|----------|
+| Action | Description |
+|--------|-------------|
 | `GET_KOL_FEED` | Real-time KOL trade feed (1,000+ wallets) |
 | `GET_KOL_COORDINATION` | Multi-KOL convergence signals |
-| `GET_KOL_LEADERBOARD` | KOL PnL/win-rate rankings (180 days of history, periods: today/7d/30d/90d/180d) |
-| `GET_DEPLOYER_ALERTS` | Pump.fun deployer alerts. PRO/ULTRA: filter by deployer tier (elite/good/moderate/rising/cold). |
-| `GET_TOKEN_INFO` | Token intelligence — price, market cap, deployer, KOL activity |
+| `GET_KOL_LEADERBOARD` | KOL PnL/win-rate rankings (180 days of history) |
+| `GET_DEPLOYER_ALERTS` | Pump.fun deployer alerts with KOL enrichment |
+| `WALLET_TRACKER_WATCHLIST` | List your tracked wallets and remaining capacity |
+| `WALLET_TRACKER_TRADES` | Recent swaps and transfers from your watchlist |
 
 ## Install
 
@@ -45,10 +45,7 @@ const agent = {
     // Option 1: API key (simplest — get one free at madeonsol.com/developer)
     MADEONSOL_API_KEY: "msk_your_api_key_here",
 
-    // Option 2: RapidAPI key
-    // RAPIDAPI_KEY: "your_rapidapi_key",
-
-    // Option 3: x402 micropayments (AI agents)
+    // Option 2: x402 micropayments (AI agents)
     // SVM_PRIVATE_KEY: "your_base58_solana_private_key",
   },
 };
@@ -59,21 +56,25 @@ Your agent can then respond to queries like:
 - "Show me the KOL leaderboard this week"
 - "What tokens are multiple KOLs accumulating?"
 - "Any new deployer alerts from Pump.fun?"
+- "Show my wallet tracker watchlist"
+- "What did my tracked wallets trade recently?"
 
-## Discovery endpoint
+## Tiers
 
-```
-GET https://madeonsol.com/api/x402
-```
+| Tier | Price | Wallets tracked | Requests/day |
+|------|-------|-----------------|--------------|
+| BASIC | Free | 10 | 200 |
+| PRO | $49/mo | 50 | 10,000 |
+| ULTRA | $199/mo | 100 + WS events | 100,000 |
 
-Returns all available endpoints, prices, and parameter docs. No auth required.
+Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
 
 ## Also Available
 
 | Platform | Package |
 |---|---|
-| TypeScript SDK | [`madeonsol-x402`](https://www.npmjs.com/package/madeonsol-x402) |
-| Python (LangChain, CrewAI) | [`madeonsol-x402`](https://github.com/LamboPoewert/madeonsol-python) on PyPI |
+| TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
+| Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
 | MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) |
 | Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |
 

package/dist/actions/wallet-tracker.d.ts

@@ -0,0 +1,3 @@
+import type { Action } from "@elizaos/core";
+export declare const walletTrackerWatchlistAction: Action;
+export declare const walletTrackerTradesAction: Action;

package/dist/actions/wallet-tracker.js

@@ -0,0 +1,84 @@
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+function getClient(runtime) {
+    return runtime[MADEONSOL_CLIENT_KEY] ?? new MadeOnSolClient();
+}
+export const walletTrackerWatchlistAction = {
+    name: "WALLET_TRACKER_WATCHLIST",
+    description: "List wallets in your MadeOnSol wallet watchlist with labels and remaining capacity.",
+    similes: [
+        "wallet watchlist",
+        "tracked wallets",
+        "my wallets",
+        "wallet tracker list",
+        "show tracked wallets",
+    ],
+    validate: async (_runtime, message) => {
+        const text = (message.content?.text || "").toLowerCase();
+        return /\b(wallet.tracker|watchlist|tracked wallet)/i.test(text) && /\b(list|show|get|my)\b/i.test(text);
+    },
+    handler: async (runtime, _message, _state, _options, callback) => {
+        const client = getClient(runtime);
+        const result = await client.getWalletTrackerWatchlist();
+        if (result.error) {
+            callback?.({ text: `Error: ${result.error}` });
+            return undefined;
+        }
+        const data = result.data;
+        const lines = (data.wallets || []).map((w) => `${w.label ? `[${w.label}] ` : ""}${w.wallet_address}`);
+        callback?.({
+            text: lines.length
+                ? `Tracked wallets (${data.count}/${data.limit}):\n${lines.join("\n")}\n${data.remaining} slot(s) remaining.`
+                : `No wallets tracked yet. Limit: ${data.limit}.`,
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "Show my wallet tracker watchlist" } },
+            { name: "assistant", content: { text: "Here are your tracked wallets..." } },
+        ],
+    ],
+};
+export const walletTrackerTradesAction = {
+    name: "WALLET_TRACKER_TRADES",
+    description: "Get recent swap and transfer events from wallets in your MadeOnSol watchlist.",
+    similes: [
+        "wallet tracker trades",
+        "tracked wallet activity",
+        "watchlist trades",
+        "wallet swaps",
+        "wallet transfers",
+        "what did my tracked wallets do",
+    ],
+    validate: async (_runtime, message) => {
+        const text = (message.content?.text || "").toLowerCase();
+        return /\b(wallet.tracker|watchlist|tracked wallet)/i.test(text) && /\b(trade|swap|transfer|activity|buy|sell)\b/i.test(text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const client = getClient(runtime);
+        const text = (message.content?.text || "").toLowerCase();
+        const action = text.includes("buy") ? "buy" : text.includes("sell") ? "sell" : undefined;
+        const result = await client.getWalletTrackerTrades({ limit: "20", ...(action ? { action } : {}) });
+        if (result.error) {
+            callback?.({ text: `Error: ${result.error}` });
+            return undefined;
+        }
+        const data = result.data;
+        const lines = (data.events || []).slice(0, 15).map((e) => `${e.label || e.wallet_address.slice(0, 8)} ${e.action} ${e.token_symbol || "?"} for ${Number(e.sol_amount).toFixed(2)} SOL`);
+        callback?.({
+            text: lines.length
+                ? `Recent wallet tracker events:\n${lines.join("\n")}`
+                : "No recent events for your tracked wallets.",
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "What did my tracked wallets trade recently?" } },
+            { name: "assistant", content: { text: "Here are the latest trades from your watchlist..." } },
+        ],
+    ],
+};

package/dist/client.d.ts

@@ -138,4 +138,38 @@ export declare class MadeOnSolClient {
         error?: string;
         status: number;
     }>;
+    getWalletTrackerWatchlist(): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    addToWatchlist(walletAddress: string, label?: string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    removeFromWatchlist(walletAddress: string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    getWalletTrackerTrades(params?: {
+        wallet?: string;
+        action?: string;
+        event_type?: string;
+        limit?: string;
+        before?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    getWalletTrackerSummary(params?: {
+        period?: string;
+        wallet?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
 }

package/dist/client.js

@@ -123,4 +123,33 @@ export class MadeOnSolClient {
     getStreamToken() {
         return this.restRequest("POST", "/stream/token");
     }
+    // ── Wallet Tracker ──
+    getWalletTrackerWatchlist() {
+        return this.restRequest("GET", "/wallet-tracker/watchlist");
+    }
+    addToWatchlist(walletAddress, label) {
+        return this.restRequest("POST", "/wallet-tracker/watchlist", { wallet_address: walletAddress, ...(label ? { label } : {}) });
+    }
+    removeFromWatchlist(walletAddress) {
+        return this.restRequest("DELETE", `/wallet-tracker/watchlist/${encodeURIComponent(walletAddress)}`);
+    }
+    getWalletTrackerTrades(params) {
+        const url = new URL(`${this.baseUrl}/api/v1/wallet-tracker/trades`);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, v);
+            }
+        }
+        return this.restRequest("GET", `/wallet-tracker/trades${url.search}`);
+    }
+    getWalletTrackerSummary(params) {
+        const qs = new URLSearchParams();
+        if (params?.period)
+            qs.set("period", params.period);
+        if (params?.wallet)
+            qs.set("wallet", params.wallet);
+        const query = qs.toString() ? `?${qs.toString()}` : "";
+        return this.restRequest("GET", `/wallet-tracker/summary${query}`);
+    }
 }

package/dist/index.d.ts

@@ -3,9 +3,11 @@ import { kolFeedAction } from "./actions/kol-feed.js";
 import { kolCoordinationAction } from "./actions/kol-coordination.js";
 import { kolLeaderboardAction } from "./actions/kol-leaderboard.js";
 import { deployerAlertsAction } from "./actions/deployer-alerts.js";
+import { walletTrackerWatchlistAction, walletTrackerTradesAction } from "./actions/wallet-tracker.js";
 /** Key used to store the initialized client on the runtime */
 export declare const MADEONSOL_CLIENT_KEY = "madeonsol:client";
 export declare const madeOnSolPlugin: Plugin;
 export default madeOnSolPlugin;
 export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
+export { walletTrackerWatchlistAction, walletTrackerTradesAction };

package/dist/index.js

@@ -2,6 +2,7 @@ import { kolFeedAction } from "./actions/kol-feed.js";
 import { kolCoordinationAction } from "./actions/kol-coordination.js";
 import { kolLeaderboardAction } from "./actions/kol-leaderboard.js";
 import { deployerAlertsAction } from "./actions/deployer-alerts.js";
+import { walletTrackerWatchlistAction, walletTrackerTradesAction } from "./actions/wallet-tracker.js";
 import { MadeOnSolClient } from "./client.js";
 /** Key used to store the initialized client on the runtime */
 export const MADEONSOL_CLIENT_KEY = "madeonsol:client";
@@ -13,6 +14,8 @@ export const madeOnSolPlugin = {
         kolCoordinationAction,
         kolLeaderboardAction,
         deployerAlertsAction,
+        walletTrackerWatchlistAction,
+        walletTrackerTradesAction,
     ],
     /**
      * Initialize the MadeOnSol client.
@@ -58,3 +61,4 @@ export const madeOnSolPlugin = {
 export default madeOnSolPlugin;
 export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
+export { walletTrackerWatchlistAction, walletTrackerTradesAction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madeonsol/plugin-madeonsol",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "ElizaOS plugin for MadeOnSol \u00e2\u20ac\u201d Solana KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",

package/src/actions/wallet-tracker.ts

@@ -0,0 +1,119 @@
+import type { Action, IAgentRuntime, Memory, State, HandlerCallback } from "@elizaos/core";
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+
+function getClient(runtime: IAgentRuntime): MadeOnSolClient {
+  return ((runtime as unknown as Record<string, unknown>)[MADEONSOL_CLIENT_KEY] as MadeOnSolClient) ?? new MadeOnSolClient();
+}
+
+export const walletTrackerWatchlistAction: Action = {
+  name: "WALLET_TRACKER_WATCHLIST",
+  description:
+    "List wallets in your MadeOnSol wallet watchlist with labels and remaining capacity.",
+  similes: [
+    "wallet watchlist",
+    "tracked wallets",
+    "my wallets",
+    "wallet tracker list",
+    "show tracked wallets",
+  ],
+
+  validate: async (_runtime: IAgentRuntime, message: Memory): Promise<boolean> => {
+    const text = (message.content?.text || "").toLowerCase();
+    return /\b(wallet.tracker|watchlist|tracked wallet)/i.test(text) && /\b(list|show|get|my)\b/i.test(text);
+  },
+
+  handler: async (
+    runtime: IAgentRuntime,
+    _message: Memory,
+    _state?: State,
+    _options?: unknown,
+    callback?: HandlerCallback,
+  ) => {
+    const client = getClient(runtime);
+    const result = await client.getWalletTrackerWatchlist();
+
+    if (result.error) {
+      callback?.({ text: `Error: ${result.error}` });
+      return undefined;
+    }
+
+    const data = result.data as { wallets: Array<{ wallet_address: string; label: string | null; added_at: string }>; count: number; limit: number; remaining: number };
+    const lines = (data.wallets || []).map(
+      (w) => `${w.label ? `[${w.label}] ` : ""}${w.wallet_address}`
+    );
+
+    callback?.({
+      text: lines.length
+        ? `Tracked wallets (${data.count}/${data.limit}):\n${lines.join("\n")}\n${data.remaining} slot(s) remaining.`
+        : `No wallets tracked yet. Limit: ${data.limit}.`,
+      content: data,
+    });
+    return undefined;
+  },
+
+  examples: [
+    [
+      { name: "user1", content: { text: "Show my wallet tracker watchlist" } },
+      { name: "assistant", content: { text: "Here are your tracked wallets..." } },
+    ],
+  ] as Action["examples"],
+};
+
+export const walletTrackerTradesAction: Action = {
+  name: "WALLET_TRACKER_TRADES",
+  description:
+    "Get recent swap and transfer events from wallets in your MadeOnSol watchlist.",
+  similes: [
+    "wallet tracker trades",
+    "tracked wallet activity",
+    "watchlist trades",
+    "wallet swaps",
+    "wallet transfers",
+    "what did my tracked wallets do",
+  ],
+
+  validate: async (_runtime: IAgentRuntime, message: Memory): Promise<boolean> => {
+    const text = (message.content?.text || "").toLowerCase();
+    return /\b(wallet.tracker|watchlist|tracked wallet)/i.test(text) && /\b(trade|swap|transfer|activity|buy|sell)\b/i.test(text);
+  },
+
+  handler: async (
+    runtime: IAgentRuntime,
+    message: Memory,
+    _state?: State,
+    _options?: unknown,
+    callback?: HandlerCallback,
+  ) => {
+    const client = getClient(runtime);
+    const text = (message.content?.text || "").toLowerCase();
+    const action = text.includes("buy") ? "buy" : text.includes("sell") ? "sell" : undefined;
+
+    const result = await client.getWalletTrackerTrades({ limit: "20", ...(action ? { action } : {}) });
+
+    if (result.error) {
+      callback?.({ text: `Error: ${result.error}` });
+      return undefined;
+    }
+
+    const data = result.data as { events: Array<{ wallet_address: string; label: string | null; action: string; token_symbol: string | null; sol_amount: number; block_time_iso: string }>; count: number };
+    const lines = (data.events || []).slice(0, 15).map(
+      (e) => `${e.label || e.wallet_address.slice(0, 8)} ${e.action} ${e.token_symbol || "?"} for ${Number(e.sol_amount).toFixed(2)} SOL`
+    );
+
+    callback?.({
+      text: lines.length
+        ? `Recent wallet tracker events:\n${lines.join("\n")}`
+        : "No recent events for your tracked wallets.",
+      content: data,
+    });
+    return undefined;
+  },
+
+  examples: [
+    [
+      { name: "user1", content: { text: "What did my tracked wallets trade recently?" } },
+      { name: "assistant", content: { text: "Here are the latest trades from your watchlist..." } },
+    ],
+  ] as Action["examples"],
+};

package/src/client.ts

@@ -157,4 +157,36 @@ export class MadeOnSolClient {
   getStreamToken() {
     return this.restRequest("POST", "/stream/token");
   }
+
+  // ── Wallet Tracker ──
+
+  getWalletTrackerWatchlist() {
+    return this.restRequest("GET", "/wallet-tracker/watchlist");
+  }
+
+  addToWatchlist(walletAddress: string, label?: string) {
+    return this.restRequest("POST", "/wallet-tracker/watchlist", { wallet_address: walletAddress, ...(label ? { label } : {}) });
+  }
+
+  removeFromWatchlist(walletAddress: string) {
+    return this.restRequest("DELETE", `/wallet-tracker/watchlist/${encodeURIComponent(walletAddress)}`);
+  }
+
+  getWalletTrackerTrades(params?: { wallet?: string; action?: string; event_type?: string; limit?: string; before?: string }) {
+    const url = new URL(`${this.baseUrl}/api/v1/wallet-tracker/trades`);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined) url.searchParams.set(k, v);
+      }
+    }
+    return this.restRequest("GET", `/wallet-tracker/trades${url.search}`);
+  }
+
+  getWalletTrackerSummary(params?: { period?: string; wallet?: string }) {
+    const qs = new URLSearchParams();
+    if (params?.period) qs.set("period", params.period);
+    if (params?.wallet) qs.set("wallet", params.wallet);
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return this.restRequest("GET", `/wallet-tracker/summary${query}`);
+  }
 }

package/src/index.ts

@@ -3,6 +3,7 @@ import { kolFeedAction } from "./actions/kol-feed.js";
 import { kolCoordinationAction } from "./actions/kol-coordination.js";
 import { kolLeaderboardAction } from "./actions/kol-leaderboard.js";
 import { deployerAlertsAction } from "./actions/deployer-alerts.js";
+import { walletTrackerWatchlistAction, walletTrackerTradesAction } from "./actions/wallet-tracker.js";
 import { MadeOnSolClient } from "./client.js";
 
 /** Key used to store the initialized client on the runtime */
@@ -17,6 +18,8 @@ export const madeOnSolPlugin: Plugin = {
     kolCoordinationAction,
     kolLeaderboardAction,
     deployerAlertsAction,
+    walletTrackerWatchlistAction,
+    walletTrackerTradesAction,
   ],
 
   /**
@@ -65,3 +68,4 @@ export const madeOnSolPlugin: Plugin = {
 export default madeOnSolPlugin;
 export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
+export { walletTrackerWatchlistAction, walletTrackerTradesAction };