@madeonsol/plugin-madeonsol 1.0.0 → 1.1.0

package/README.md

@@ -4,6 +4,18 @@ ElizaOS plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL trading int
 
 > 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.
 
+## Quick start (10 seconds)
+
+```bash
+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
+// Then ask the agent: "What are KOLs buying right now?"
+```
+
 ## Authentication
 
 Three options (in priority order):
@@ -20,7 +32,7 @@ Gives your ElizaOS agent access to MadeOnSol's Solana intelligence API.
 | Action | Description |
 |--------|-------------|
 | `GET_KOL_FEED` | Real-time KOL trade feed (1,000+ wallets) |
-| `GET_KOL_COORDINATION` | Multi-KOL convergence signals |
+| `GET_KOL_COORDINATION` | Multi-KOL convergence (v1.1 — peak-density, exits, 0-100 score) |
 | `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 |
@@ -51,6 +63,30 @@ const agent = {
 };
 ```
 
+### v1.1 Coordination alerts (programmatic)
+
+The `GET_KOL_COORDINATION` action surfaces the v1.1 `coordination_score`, `peak_kols`, and `exited_count` fields. For **push alerts** (fires within ~1s of a qualifying trade via WS `kol:coordination` channel + HMAC-signed webhook), use the client directly from a custom action:
+
+```ts
+import { MadeOnSolClient } from "@madeonsol/plugin-madeonsol";
+
+const client = new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY });
+const res = await client.coordinationAlertsCreate({
+  name: "fresh pump cluster",
+  min_kols: 4,
+  window_minutes: 15,
+  min_score: 70,
+  include_majors: false,
+  cooldown_min: 60,
+  score_jump_break: 10,
+  delivery_mode: "both",
+  webhook_url: "https://you.com/hooks/coord",
+});
+// store res.data.webhook_secret — shown ONCE
+```
+
+PRO=5 rules, ULTRA=20. Also available: `coordinationAlertsList()`, `coordinationAlertsGet(id)`, `coordinationAlertsUpdate(id, updates)`, `coordinationAlertsDelete(id)`.
+
 Your agent can then respond to queries like:
 - "What are KOLs buying right now?"
 - "Show me the KOL leaderboard this week"
@@ -65,7 +101,7 @@ Your agent can then respond to queries like:
 |------|-------|-----------------|--------------|
 | BASIC | Free | 10 | 200 |
 | PRO | $49/mo | 50 | 10,000 |
-| ULTRA | $199/mo | 100 + WS events | 100,000 |
+| ULTRA | $149/mo | 100 + WS events | 100,000 |
 
 Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
 

package/dist/actions/kol-coordination.js

@@ -29,7 +29,12 @@ export const kolCoordinationAction = {
             return undefined;
         }
         const data = result.data;
-        const lines = (data.coordination || []).map((t) => `${t.token_symbol}: ${t.kol_count} KOLs ${t.signal} (${t.net_sol_flow > 0 ? "+" : ""}${t.net_sol_flow.toFixed(2)} SOL net)`);
+        const lines = (data.coordination || []).map((t) => {
+            const score = t.coordination_score != null ? ` · score ${t.coordination_score}/100` : "";
+            const peak = t.peak_kols != null ? ` · peak ${t.peak_kols}` : "";
+            const exited = t.exited_count ? ` · ${t.exited_count} exited` : "";
+            return `${t.token_symbol}: ${t.kol_count} KOLs ${t.signal} (${t.net_sol_flow > 0 ? "+" : ""}${t.net_sol_flow.toFixed(2)} SOL net)${score}${peak}${exited}`;
+        });
         callback?.({
             text: `KOL convergence signals (${period}):\n${lines.join("\n") || "No coordination signals found."}`,
             content: data,

package/dist/client.d.ts

@@ -45,6 +45,14 @@ export declare class MadeOnSolClient {
         period?: string;
         min_kols?: string;
         limit?: string;
+        /** v1.1 — include WIF/BONK/POPCAT etc. ("true" | "false", default "false") */
+        include_majors?: string;
+        /** v1.1 — peak-density window in minutes (1-60, default 15) */
+        window_minutes?: string;
+        /** v1.1 — minimum composite coordination_score (0-100) */
+        min_score?: string;
+        min_avg_winrate?: string;
+        unique_strategies?: string;
     }): Promise<{
         data?: unknown;
         error?: string;
@@ -265,6 +273,41 @@ export declare class MadeOnSolClient {
         error?: string;
         status: number;
     }>;
+    coordinationAlertsList(): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    coordinationAlertsCreate(params: {
+        name?: string;
+        min_kols?: number;
+        window_minutes?: number;
+        min_score?: number;
+        include_majors?: boolean;
+        cooldown_min?: number;
+        score_jump_break?: number;
+        delivery_mode?: "websocket" | "webhook" | "both";
+        webhook_url?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    coordinationAlertsGet(ruleId: string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    coordinationAlertsUpdate(ruleId: string, updates: Record<string, unknown>): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    coordinationAlertsDelete(ruleId: string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
     copyTradeSignals(params?: {
         rule_id?: string;
         limit?: string;

package/dist/client.js

@@ -26,6 +26,9 @@ 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" +
+                "  → Then: new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY })\n");
         }
     }
     captureRateLimit(res) {
@@ -110,7 +113,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 madeonsol.com/developer", status: 401 };
+            return { error: "MadeOnSol API key required for this endpoint. Get a free `msk_` key at https://madeonsol.com/developer", status: 401 };
         }
         const res = await this.fetchFn(`${this.baseUrl}/api/v1${path}`, {
             method,
@@ -212,6 +215,22 @@ export class MadeOnSolClient {
     copyTradeDelete(ruleId) {
         return this.restRequest("DELETE", `/copy-trade/rules/${encodeURIComponent(ruleId)}`);
     }
+    // ── Coordination alerts (PRO/ULTRA, v1.1) ──
+    coordinationAlertsList() {
+        return this.restRequest("GET", "/kol/coordination/alerts");
+    }
+    coordinationAlertsCreate(params) {
+        return this.restRequest("POST", "/kol/coordination/alerts", params);
+    }
+    coordinationAlertsGet(ruleId) {
+        return this.restRequest("GET", `/kol/coordination/alerts/${encodeURIComponent(ruleId)}`);
+    }
+    coordinationAlertsUpdate(ruleId, updates) {
+        return this.restRequest("PATCH", `/kol/coordination/alerts/${encodeURIComponent(ruleId)}`, updates);
+    }
+    coordinationAlertsDelete(ruleId) {
+        return this.restRequest("DELETE", `/kol/coordination/alerts/${encodeURIComponent(ruleId)}`);
+    }
     copyTradeSignals(params) {
         const qs = new URLSearchParams();
         if (params)

package/dist/index.js

@@ -57,7 +57,9 @@ export const madeOnSolPlugin = {
             }
         }
         else {
-            console.log("[madeonsol] No auth configured. Set MADEONSOL_API_KEY (free at madeonsol.com/developer) or SVM_PRIVATE_KEY.");
+            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" +
+                "  → Or set SVM_PRIVATE_KEY for x402 micropayments.");
         }
         const madeOnSolClient = new MadeOnSolClient({ baseUrl, apiKey, fetchFn });
         runtime[MADEONSOL_CLIENT_KEY] = madeOnSolClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madeonsol/plugin-madeonsol",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "ElizaOS plugin for MadeOnSol — Solana KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",
@@ -51,4 +51,4 @@
   "devDependencies": {
     "@elizaos/core": "^2.0.0-alpha.77"
   }
-}
+}