@madeonsol/plugin-madeonsol 1.7.0 → 1.7.2

package/README.md

@@ -2,7 +2,7 @@
 
 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, 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.
+> 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/pricing](https://madeonsol.com/pricing) — no credit card required.
 
 > **New in 1.7.0** *(2026-05-12)* — **Account introspection + token scanner actions.** Two new actions: `meAction` (`GET_MADEONSOL_ACCOUNT`) reports the caller's tier, daily/burst quota, and webhook / copy-trade / coord-rule slot counts; `tokensListAction` (`LIST_MADEONSOL_TOKENS`) scans the Solana token universe by MC, liquidity, 1h momentum, and primary DEX. New client methods: `client.getMe()` and `client.getTokensList(params)`. Token responses now expose **velocity / MEV-share enrichment** fields. The `/tokens` scanner applies a default `min_liq=2000` so the agent isn't drowned in dust pools by default. `/token/{mint}` HTTP 400s now return structured `code` / `reason` / `example` / `docs` so the agent can self-correct bad mints. Deprecated `avg_entry_mc_usd` has been removed from all leaderboard payloads.
 
@@ -14,7 +14,7 @@ npm install @madeonsol/plugin-madeonsol
 
 ```ts
 import { madeOnSolPlugin } from "@madeonsol/plugin-madeonsol";
-const agent = { plugins: [madeOnSolPlugin], settings: { MADEONSOL_API_KEY: "msk_..." } }; // free key: https://madeonsol.com/developer
+const agent = { plugins: [madeOnSolPlugin], settings: { MADEONSOL_API_KEY: "msk_..." } }; // free tier at https://madeonsol.com/pricing
 // Then ask the agent: "What are KOLs buying right now?"
 ```
 
@@ -24,7 +24,7 @@ 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) |
+| **MadeOnSol API key** (recommended) | `MADEONSOL_API_KEY` | Developers — [get a free key](https://madeonsol.com/pricing) |
 | x402 micropayments | `SVM_PRIVATE_KEY` | AI agents with Solana wallets |
 
 ## What it does
@@ -58,7 +58,7 @@ import { madeOnSolPlugin } from "@madeonsol/plugin-madeonsol";
 const agent = {
   plugins: [madeOnSolPlugin],
   settings: {
-    // Option 1: API key — get one free at madeonsol.com/developer
+    // Option 1: API key — get one free at madeonsol.com/pricing
     MADEONSOL_API_KEY: "msk_your_api_key_here",
 
     // Option 2: x402 micropayments (AI agents)
@@ -134,7 +134,7 @@ Your agent can then respond to queries like:
 | Pro | $49/mo | 50 | 10,000 |
 | Ultra | $149/mo | 100 + WS events | 100,000 |
 
-Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
+Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
 
 ## Also Available
 

package/dist/actions/deployer-alerts.js

@@ -29,7 +29,7 @@ export const deployerAlertsAction = {
         const result = await client.getDeployerAlerts(tier ? { limit, tier } : { limit });
         if (result.error) {
             callback?.({ text: result.status === 402
-                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/developer — or SVM_PRIVATE_KEY."
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
                     : `Error: ${result.error}` });
             return undefined;
         }

package/dist/actions/kol-alerts-recent.js

@@ -24,7 +24,7 @@ export const kolAlertsRecentAction = {
         const result = await client.getKolAlertsRecent({ window, limit: "20" });
         if (result.error) {
             callback?.({ text: result.status === 402
-                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/developer — or SVM_PRIVATE_KEY."
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
                     : `Error: ${result.error}` });
             return undefined;
         }

package/dist/actions/kol-compare.js

@@ -29,7 +29,7 @@ export const kolCompareAction = {
         const result = await client.getKolCompare(wallets);
         if (result.error) {
             callback?.({ text: result.status === 402
-                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/developer — or SVM_PRIVATE_KEY."
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
                     : `Error: ${result.error}` });
             return undefined;
         }

package/dist/actions/kol-coordination.js

@@ -24,7 +24,7 @@ export const kolCoordinationAction = {
         const result = await client.getKolCoordination({ period, limit: "10" });
         if (result.error) {
             callback?.({ text: result.status === 402
-                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/developer — or SVM_PRIVATE_KEY."
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
                     : `Error: ${result.error}` });
             return undefined;
         }

package/dist/actions/kol-feed.js

@@ -25,7 +25,7 @@ export const kolFeedAction = {
         const result = await client.getKolFeed({ limit: "10", ...(action ? { action } : {}) });
         if (result.error) {
             callback?.({ text: result.status === 402
-                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/developer — or SVM_PRIVATE_KEY."
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
                     : `Error: ${result.error}` });
             return undefined;
         }

package/dist/actions/kol-leaderboard.js

@@ -24,7 +24,7 @@ export const kolLeaderboardAction = {
         const result = await client.getKolLeaderboard({ period, limit: "10" });
         if (result.error) {
             callback?.({ text: result.status === 402
-                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/developer — or SVM_PRIVATE_KEY."
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
                     : `Error: ${result.error}` });
             return undefined;
         }

package/dist/actions/kol-token-entry-order.js

@@ -28,7 +28,7 @@ export const kolTokenEntryOrderAction = {
         const result = await client.getKolTokenEntryOrder(mint, { limit: "20" });
         if (result.error) {
             callback?.({ text: result.status === 402
-                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/developer — or SVM_PRIVATE_KEY."
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
                     : `Error: ${result.error}` });
             return undefined;
         }

package/dist/actions/me.d.ts

@@ -0,0 +1,6 @@
+import type { Action } from "@elizaos/core";
+/**
+ * Returns the authenticated caller's MadeOnSol account: tier, daily/burst
+ * quota usage, and feature slot counts (webhooks, copy-trade rules, coord rules).
+ */
+export declare const meAction: Action;

package/dist/actions/me.js

@@ -0,0 +1,59 @@
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+function getClient(runtime) {
+    return runtime[MADEONSOL_CLIENT_KEY] ?? new MadeOnSolClient();
+}
+/**
+ * Returns the authenticated caller's MadeOnSol account: tier, daily/burst
+ * quota usage, and feature slot counts (webhooks, copy-trade rules, coord rules).
+ */
+export const meAction = {
+    name: "GET_MADEONSOL_ACCOUNT",
+    description: "Get your MadeOnSol account info — current tier, daily request quota, burst limit, and how many webhook / copy-trade / coordination rule slots you have used.",
+    similes: [
+        "my account",
+        "my quota",
+        "how many requests",
+        "api usage",
+        "my tier",
+        "requests remaining",
+    ],
+    validate: async (_runtime, message) => {
+        const text = (message.content?.text || "").toLowerCase();
+        return /\b(my account|my quota|how many requests|api usage|tier|remaining)\b/.test(text);
+    },
+    handler: async (runtime, _message, _state, _options, callback) => {
+        const client = getClient(runtime);
+        const result = await client.getMe();
+        if (result.error) {
+            callback?.({ text: result.status === 401 || result.status === 402
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
+                    : `Error: ${result.error}` });
+            return undefined;
+        }
+        const data = result.data;
+        const tier = (data.tier || "unknown").toUpperCase();
+        const dUsed = data.quota?.daily?.used ?? 0;
+        const dLimit = data.quota?.daily?.limit ?? 0;
+        const dRem = data.quota?.daily?.remaining ?? Math.max(0, dLimit - dUsed);
+        const bUsed = data.quota?.burst?.used ?? 0;
+        const bLimit = data.quota?.burst?.limit ?? 0;
+        const whUsed = data.slots?.webhooks?.used ?? 0;
+        const whLimit = data.slots?.webhooks?.limit ?? 0;
+        const ctUsed = data.slots?.copy_trade_wallets?.used ?? 0;
+        const ctLimit = data.slots?.copy_trade_wallets?.limit ?? 0;
+        const crUsed = data.slots?.coordination_rules?.used ?? 0;
+        const crLimit = data.slots?.coordination_rules?.limit ?? 0;
+        callback?.({
+            text: `Your MadeOnSol account: ${tier} tier. Daily quota: ${dUsed}/${dLimit} (${dRem} left). Burst: ${bUsed}/${bLimit} per minute. Webhooks: ${whUsed}/${whLimit}, Copy-trade wallets: ${ctUsed}/${ctLimit}, Coord rules: ${crUsed}/${crLimit}.`,
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "What is my MadeOnSol tier and how many requests do I have remaining?" } },
+            { name: "assistant", content: { text: "Here is your MadeOnSol account info..." } },
+        ],
+    ],
+};

package/dist/actions/tokens-list.d.ts

@@ -0,0 +1,7 @@
+import type { Action } from "@elizaos/core";
+/**
+ * Scan the MadeOnSol token universe with MC, liquidity, momentum, and DEX filters.
+ * Heuristics pulled from the user prompt: "high liquidity" → min_liq=10000,
+ * "momentum"/"pumping" → mc_change_1h_min_pct=10, "pumpfun" → primary_dex=pumpfun.
+ */
+export declare const tokensListAction: Action;

package/dist/actions/tokens-list.js

@@ -0,0 +1,75 @@
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+function getClient(runtime) {
+    return runtime[MADEONSOL_CLIENT_KEY] ?? new MadeOnSolClient();
+}
+function fmtMc(mc) {
+    if (mc == null || !isFinite(mc) || mc <= 0)
+        return "?";
+    if (mc >= 1e6)
+        return `$${(mc / 1e6).toFixed(2)}M`;
+    if (mc >= 1e3)
+        return `$${(mc / 1e3).toFixed(1)}K`;
+    return `$${mc.toFixed(0)}`;
+}
+/**
+ * Scan the MadeOnSol token universe with MC, liquidity, momentum, and DEX filters.
+ * Heuristics pulled from the user prompt: "high liquidity" → min_liq=10000,
+ * "momentum"/"pumping" → mc_change_1h_min_pct=10, "pumpfun" → primary_dex=pumpfun.
+ */
+export const tokensListAction = {
+    name: "LIST_MADEONSOL_TOKENS",
+    description: "Scan MadeOnSol's Solana token universe by MC, liquidity, 1h MC momentum, primary DEX, or age. Returns the top matching tokens with mint, symbol, market cap, liquidity, and 1h MC change.",
+    similes: [
+        "top tokens",
+        "trending tokens",
+        "hot tokens",
+        "scan tokens",
+        "tokens by mc",
+        "liquid tokens",
+    ],
+    validate: async (_runtime, message) => {
+        const text = (message.content?.text || "").toLowerCase();
+        return /\b(top tokens|trending tokens|hot tokens|scan tokens|tokens by mc|liquid tokens)\b/.test(text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const client = getClient(runtime);
+        const text = (message.content?.text || "").toLowerCase();
+        const params = { limit: "10" };
+        if (/high liquidity/.test(text))
+            params.min_liq = "10000";
+        if (/momentum|pumping/.test(text))
+            params.mc_change_1h_min_pct = "10";
+        if (/pumpfun|pump\.fun/.test(text))
+            params.primary_dex = "pumpfun";
+        const result = await client.getTokensList(params);
+        if (result.error) {
+            callback?.({ text: result.status === 402
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
+                    : `Error: ${result.error}` });
+            return undefined;
+        }
+        const data = result.data;
+        const tokens = (data.tokens || []).slice(0, 10);
+        const lines = tokens.map((t, i) => {
+            const label = t.symbol || t.name || "?";
+            const change = t.mc_change_1h_pct != null && isFinite(t.mc_change_1h_pct)
+                ? ` (${t.mc_change_1h_pct >= 0 ? "+" : ""}${t.mc_change_1h_pct.toFixed(1)}% 1h)`
+                : "";
+            return `${i + 1}. ${label} ${t.mint.slice(0, 8)}… — MC ${fmtMc(t.mc_usd)}, Liq ${fmtMc(t.liquidity_usd)}${change}`;
+        });
+        callback?.({
+            text: tokens.length
+                ? `Top tokens:\n${lines.join("\n")}`
+                : "No tokens matched those filters.",
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "Show me the top trending tokens on Solana with high liquidity" } },
+            { name: "assistant", content: { text: "Here are the top trending tokens..." } },
+        ],
+    ],
+};

package/dist/client.d.ts

@@ -3,11 +3,11 @@
  * Two auth modes: MadeOnSol API key (`msk_`, recommended) or x402 micropayments.
  *
  * v1.0 breaking change: RapidAPI auth has been removed (marketplace retired 2026-04-19).
- * Get a free `msk_` key at https://madeonsol.com/developer.
+ * Get a free `msk_` key at https://madeonsol.com/pricing.
  */
 export interface MadeOnSolClientOptions {
     baseUrl?: string;
-    /** MadeOnSol API key — get one free at https://madeonsol.com/developer. Preferred. */
+    /** MadeOnSol API key — get one free at https://madeonsol.com/pricing. Preferred. */
     apiKey?: string;
     /** x402 payment-enabled fetch (for AI agents with SVM_PRIVATE_KEY). */
     fetchFn?: typeof fetch;
@@ -392,6 +392,33 @@ export declare class MadeOnSolClient {
         error?: string;
         status: number;
     }>;
+    /** Get the authenticated caller's account, tier, and quota usage. */
+    getMe(): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    /**
+     * List tokens with filters (mc band, liquidity, momentum, DEX, age, etc.).
+     * Default `min_liq` is 2000 server-side. Returns up to ~50 tokens per call.
+     */
+    getTokensList(params?: {
+        limit?: string;
+        offset?: string;
+        primary_dex?: string;
+        min_mc?: string;
+        max_mc?: string;
+        min_liq?: string;
+        max_age_min?: string;
+        mc_change_1h_min_pct?: string;
+        mc_change_1h_max_pct?: string;
+        sort?: string;
+        order?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
     copyTradeSignals(params?: {
         rule_id?: string;
         limit?: string;

package/dist/client.js

@@ -3,7 +3,7 @@
  * Two auth modes: MadeOnSol API key (`msk_`, recommended) or x402 micropayments.
  *
  * v1.0 breaking change: RapidAPI auth has been removed (marketplace retired 2026-04-19).
- * Get a free `msk_` key at https://madeonsol.com/developer.
+ * Get a free `msk_` key at https://madeonsol.com/pricing.
  */
 const DEFAULT_BASE = "https://madeonsol.com";
 export class MadeOnSolClient {
@@ -27,7 +27,7 @@ export class MadeOnSolClient {
         else {
             this.authMode = "none";
             console.warn("\n[madeonsol] MadeOnSolClient constructed without apiKey or fetchFn — every request will fail.\n" +
-                "  → Get a free key (200 req/day, no card) at https://madeonsol.com/developer\n" +
+                "  → Get a free key (200 req/day, no card) at https://madeonsol.com/pricing\n" +
                 "  → Then: new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY })\n");
         }
     }
@@ -114,7 +114,7 @@ export class MadeOnSolClient {
     // ── REST helper (used by webhooks, streaming, alpha, copy-trade, wallet-tracker) ──
     async restRequest(method, path, body) {
         if (this.authMode !== "madeonsol") {
-            return { error: "MadeOnSol API key required for this endpoint. Get a free `msk_` key at https://madeonsol.com/developer", status: 401 };
+            return { error: "MadeOnSol API key required for this endpoint. Get a free `msk_` key at https://madeonsol.com/pricing", status: 401 };
         }
         const res = await this.fetchFn(`${this.baseUrl}/api/v1${path}`, {
             method,
@@ -270,6 +270,27 @@ export class MadeOnSolClient {
     firstTouchSubscriptionsDelete(id) {
         return this.restRequest("DELETE", `/kol/first-touches/subscriptions/${encodeURIComponent(id)}`);
     }
+    // ── Account info ──
+    /** Get the authenticated caller's account, tier, and quota usage. */
+    getMe() {
+        return this.restRequest("GET", "/me");
+    }
+    // ── Token discovery / scanner ──
+    /**
+     * List tokens with filters (mc band, liquidity, momentum, DEX, age, etc.).
+     * Default `min_liq` is 2000 server-side. Returns up to ~50 tokens per call.
+     */
+    getTokensList(params) {
+        const qs = new URLSearchParams();
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined)
+                    qs.set(k, v);
+            }
+        }
+        const query = qs.toString() ? `?${qs.toString()}` : "";
+        return this.restRequest("GET", `/tokens${query}`);
+    }
     copyTradeSignals(params) {
         const qs = new URLSearchParams();
         if (params)

package/dist/index.d.ts

@@ -7,6 +7,8 @@ import { walletTrackerWatchlistAction, walletTrackerTradesAction } from "./actio
 import { kolTokenEntryOrderAction } from "./actions/kol-token-entry-order.js";
 import { kolCompareAction } from "./actions/kol-compare.js";
 import { kolAlertsRecentAction } from "./actions/kol-alerts-recent.js";
+import { meAction } from "./actions/me.js";
+import { tokensListAction } from "./actions/tokens-list.js";
 /** Key used to store the initialized client on the runtime */
 export declare const MADEONSOL_CLIENT_KEY = "madeonsol:client";
 export declare const madeOnSolPlugin: Plugin;
@@ -15,3 +17,4 @@ export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
 export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction };
+export { meAction, tokensListAction };

package/dist/index.js

@@ -6,6 +6,8 @@ import { walletTrackerWatchlistAction, walletTrackerTradesAction } from "./actio
 import { kolTokenEntryOrderAction } from "./actions/kol-token-entry-order.js";
 import { kolCompareAction } from "./actions/kol-compare.js";
 import { kolAlertsRecentAction } from "./actions/kol-alerts-recent.js";
+import { meAction } from "./actions/me.js";
+import { tokensListAction } from "./actions/tokens-list.js";
 import { MadeOnSolClient } from "./client.js";
 /** Key used to store the initialized client on the runtime */
 export const MADEONSOL_CLIENT_KEY = "madeonsol:client";
@@ -22,11 +24,13 @@ export const madeOnSolPlugin = {
         kolTokenEntryOrderAction,
         kolCompareAction,
         kolAlertsRecentAction,
+        meAction,
+        tokensListAction,
     ],
     /**
      * Initialize the MadeOnSol client.
      * Auth priority: MADEONSOL_API_KEY > SVM_PRIVATE_KEY (x402).
-     * Get a free `msk_` API key at madeonsol.com/developer — no wallet needed.
+     * Get a free `msk_` API key at madeonsol.com/pricing — no wallet needed.
      *
      * v1.0 breaking change: RAPIDAPI_KEY support has been removed
      * (MadeOnSol RapidAPI marketplace was retired 2026-04-19).
@@ -58,7 +62,7 @@ export const madeOnSolPlugin = {
         }
         else {
             console.warn("[madeonsol] No auth configured — every API call will fail.\n" +
-                "  → Get a free MADEONSOL_API_KEY (200 req/day, no card) at https://madeonsol.com/developer\n" +
+                "  → Get a free MADEONSOL_API_KEY (200 req/day, no card) at https://madeonsol.com/pricing\n" +
                 "  → Or set SVM_PRIVATE_KEY for x402 micropayments.");
         }
         const madeOnSolClient = new MadeOnSolClient({ baseUrl, apiKey, fetchFn });
@@ -70,3 +74,4 @@ export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
 export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction };
+export { meAction, tokensListAction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madeonsol/plugin-madeonsol",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "description": "ElizaOS plugin for MadeOnSol — Solana KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,9 @@
   ],
   "scripts": {
     "build": "tsc",
-    "dev": "tsc --watch"
+    "dev": "tsc --watch",
+    "preflight": "bash ../../scripts/preflight-publish.sh",
+    "prepublishOnly": "npm run preflight && npm run build"
   },
   "peerDependencies": {
     "@elizaos/core": ">=1.0.0",