@madeonsol/plugin-madeonsol 0.1.0

package/LICENSE

@@ -0,0 +1 @@
+MIT License

package/README.md

@@ -0,0 +1,67 @@
+# @madeonsol/plugin-madeonsol
+
+ElizaOS plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL trading intelligence and deployer analytics via x402 micropayments.
+
+## What it does
+
+Gives your ElizaOS agent access to MadeOnSol's x402-gated API endpoints. The agent pays per request with USDC on Solana — no API keys needed.
+
+| Action | Endpoint | Price |
+|--------|----------|-------|
+| `GET_KOL_FEED` | Real-time KOL trade feed (946 wallets) | $0.005 USDC |
+| `GET_KOL_COORDINATION` | Multi-KOL convergence signals | $0.02 USDC |
+| `GET_KOL_LEADERBOARD` | KOL PnL/win-rate rankings | $0.005 USDC |
+| `GET_DEPLOYER_ALERTS` | Pump.fun elite deployer alerts | $0.01 USDC |
+
+## Install
+
+```bash
+npm install @madeonsol/plugin-madeonsol @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
+```
+
+## Usage
+
+```typescript
+import { madeOnSolPlugin } from "@madeonsol/plugin-madeonsol";
+
+const agent = {
+  plugins: [madeOnSolPlugin],
+  settings: {
+    // Required for automatic x402 payments:
+    SVM_PRIVATE_KEY: "your_base58_solana_private_key",
+    // Optional:
+    MADEONSOL_API_URL: "https://madeonsol.com",
+  },
+};
+```
+
+The plugin's `init` function automatically:
+1. Creates a Solana signer from `SVM_PRIVATE_KEY`
+2. Registers the x402 payment scheme
+3. Wraps fetch with automatic 402 → pay → retry handling
+
+Your agent can then respond to queries like:
+- "What are KOLs buying right now?"
+- "Show me the KOL leaderboard this week"
+- "What tokens are multiple KOLs accumulating?"
+- "Any new deployer alerts from Pump.fun?"
+
+Without `SVM_PRIVATE_KEY`, the plugin runs in read-only mode and returns payment requirement info instead of data.
+
+## Wallet requirements
+
+The wallet needs:
+- ~0.01 SOL for transaction fees
+- USDC balance (even $0.10 covers 20+ requests)
+
+## Discovery endpoint
+
+```
+GET https://madeonsol.com/api/x402
+```
+
+Returns all available endpoints, prices, and parameter docs. No payment required.
+
+## License
+
+MIT

package/dist/actions/deployer-alerts.d.ts

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

package/dist/actions/deployer-alerts.js

@@ -0,0 +1,50 @@
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+function getClient(runtime) {
+    return runtime[MADEONSOL_CLIENT_KEY] ?? new MadeOnSolClient();
+}
+export const deployerAlertsAction = {
+    name: "GET_DEPLOYER_ALERTS",
+    description: "Get real-time Pump.fun deployer alerts from MadeOnSol. Shows new token launches from tracked elite/good deployers with stats, market cap, and KOL buy enrichment.",
+    similes: [
+        "deployer alerts",
+        "pump fun launches",
+        "new token alerts",
+        "deployer tracker",
+        "elite deployer tokens",
+    ],
+    validate: async (_runtime, message) => {
+        const text = (message.content?.text || "").toLowerCase();
+        return /\b(deployer|pump\.?fun|launch|new token)/i.test(text) && /\b(alert|track|monitor|latest|recent)/i.test(text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const client = getClient(runtime);
+        const text = (message.content?.text || "").toLowerCase();
+        const limit = text.match(/\b(\d+)\s*(alert|token|launch)/)?.[1] || "10";
+        const result = await client.getDeployerAlerts({ limit });
+        if (result.error) {
+            callback?.({ text: result.status === 402
+                    ? "x402 payment required but no wallet configured. Set SVM_PRIVATE_KEY to enable automatic USDC payments."
+                    : `Error: ${result.error}` });
+            return undefined;
+        }
+        const data = result.data;
+        const lines = (data.alerts || []).slice(0, 10).map((a) => {
+            const deployer = a.deployers;
+            const mc = a.market_cap_at_alert ? `$${(a.market_cap_at_alert / 1000).toFixed(1)}k` : "?";
+            const kols = a.kol_buys ? `${a.kol_buys.count} KOLs buying` : "";
+            return `[${deployer?.tier}] ${a.token_symbol || "?"} — MC: ${mc}${kols ? ` | ${kols}` : ""}`;
+        });
+        callback?.({
+            text: `Deployer Alerts:\n${lines.join("\n") || "No recent alerts."}`,
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "Show me the latest deployer alerts from Pump.fun" } },
+            { name: "assistant", content: { text: "Here are the latest deployer alerts..." } },
+        ],
+    ],
+};

package/dist/actions/kol-coordination.d.ts

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

package/dist/actions/kol-coordination.js

@@ -0,0 +1,45 @@
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+function getClient(runtime) {
+    return runtime[MADEONSOL_CLIENT_KEY] ?? new MadeOnSolClient();
+}
+export const kolCoordinationAction = {
+    name: "GET_KOL_COORDINATION",
+    description: "Get KOL convergence signals from MadeOnSol — tokens being accumulated by multiple KOLs simultaneously. Shows which tokens smart money is converging on.",
+    similes: [
+        "kol convergence",
+        "what tokens are kols accumulating",
+        "kol coordination",
+        "smart money convergence",
+        "multiple kols buying",
+    ],
+    validate: async (_runtime, message) => {
+        const text = (message.content?.text || "").toLowerCase();
+        return /\b(kol|smart money)\b/.test(text) && /\b(converg|coordinat|accumul|same token|multiple)/i.test(text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const client = getClient(runtime);
+        const text = (message.content?.text || "").toLowerCase();
+        const period = text.includes("1h") ? "1h" : text.includes("7d") ? "7d" : text.includes("6h") ? "6h" : "24h";
+        const result = await client.getKolCoordination({ period, limit: "10" });
+        if (result.error) {
+            callback?.({ text: result.status === 402
+                    ? "x402 payment required but no wallet configured. Set SVM_PRIVATE_KEY to enable automatic USDC payments."
+                    : `Error: ${result.error}` });
+            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)`);
+        callback?.({
+            text: `KOL convergence signals (${period}):\n${lines.join("\n") || "No coordination signals found."}`,
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "What tokens are multiple KOLs accumulating?" } },
+            { name: "assistant", content: { text: "Here are the KOL convergence signals..." } },
+        ],
+    ],
+};

package/dist/actions/kol-feed.d.ts

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

package/dist/actions/kol-feed.js

@@ -0,0 +1,46 @@
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+function getClient(runtime) {
+    return runtime[MADEONSOL_CLIENT_KEY] ?? new MadeOnSolClient();
+}
+export const kolFeedAction = {
+    name: "GET_KOL_FEED",
+    description: "Get the real-time Solana KOL trade feed from MadeOnSol. Shows latest buys and sells from 946 tracked KOL wallets with deployer enrichment.",
+    similes: [
+        "kol trades",
+        "what are kols buying",
+        "solana kol feed",
+        "kol activity",
+        "smart money trades",
+        "what did kols trade",
+    ],
+    validate: async (_runtime, message) => {
+        const text = (message.content?.text || "").toLowerCase();
+        return /\b(kol|smart money)\b/.test(text) && /\b(feed|trade|buy|sell|activit)/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.getKolFeed({ limit: "10", ...(action ? { action } : {}) });
+        if (result.error) {
+            callback?.({ text: result.status === 402
+                    ? "x402 payment required but no wallet configured. Set SVM_PRIVATE_KEY to enable automatic USDC payments."
+                    : `Error: ${result.error}` });
+            return undefined;
+        }
+        const data = result.data;
+        const lines = (data.trades || []).slice(0, 10).map((t) => `${t.kol_name || "Unknown"} ${t.action === "buy" ? "bought" : "sold"} ${t.token_symbol || "?"} for ${Number(t.sol_amount).toFixed(2)} SOL`);
+        callback?.({
+            text: `Latest KOL trades:\n${lines.join("\n")}`,
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "What are the latest KOL trades on Solana?" } },
+            { name: "assistant", content: { text: "Here are the latest KOL trades from MadeOnSol..." } },
+        ],
+    ],
+};

package/dist/actions/kol-leaderboard.d.ts

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

package/dist/actions/kol-leaderboard.js

@@ -0,0 +1,45 @@
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+function getClient(runtime) {
+    return runtime[MADEONSOL_CLIENT_KEY] ?? new MadeOnSolClient();
+}
+export const kolLeaderboardAction = {
+    name: "GET_KOL_LEADERBOARD",
+    description: "Get KOL performance rankings from MadeOnSol — top Solana KOLs ranked by PnL, volume, and win rate.",
+    similes: [
+        "kol leaderboard",
+        "best performing kols",
+        "top kol traders",
+        "kol rankings",
+        "who is the best kol",
+    ],
+    validate: async (_runtime, message) => {
+        const text = (message.content?.text || "").toLowerCase();
+        return /\b(kol|smart money)\b/.test(text) && /\b(leaderboard|ranking|top|best|perform|pnl|win rate)/i.test(text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const client = getClient(runtime);
+        const text = (message.content?.text || "").toLowerCase();
+        const period = text.includes("today") ? "today" : text.includes("30d") || text.includes("month") ? "30d" : "7d";
+        const result = await client.getKolLeaderboard({ period, limit: "10" });
+        if (result.error) {
+            callback?.({ text: result.status === 402
+                    ? "x402 payment required but no wallet configured. Set SVM_PRIVATE_KEY to enable automatic USDC payments."
+                    : `Error: ${result.error}` });
+            return undefined;
+        }
+        const data = result.data;
+        const lines = (data.leaderboard || []).map((k, i) => `${i + 1}. ${k.name}: ${k.pnl_sol > 0 ? "+" : ""}${k.pnl_sol.toFixed(2)} SOL PnL (${k.buy_count}B/${k.sell_count}S${k.win_rate != null ? `, ${(k.win_rate * 100).toFixed(0)}% WR` : ""})`);
+        callback?.({
+            text: `KOL Leaderboard (${period}):\n${lines.join("\n") || "No data for this period."}`,
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "Show me the top performing KOLs this week" } },
+            { name: "assistant", content: { text: "Here are the top KOLs by PnL..." } },
+        ],
+    ],
+};

package/dist/client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MadeOnSol x402 API client.
+ * Uses @x402/fetch to automatically handle 402 → sign USDC → retry flow.
+ */
+export interface MadeOnSolClientOptions {
+    baseUrl?: string;
+    /**
+     * A fetch function that handles x402 payments automatically.
+     * Created via wrapFetchWithPayment() from @x402/fetch.
+     * If not provided, uses plain fetch (requests will return 402).
+     */
+    fetchFn?: typeof fetch;
+}
+export declare class MadeOnSolClient {
+    private baseUrl;
+    private fetchFn;
+    constructor(options?: MadeOnSolClientOptions);
+    query<T = unknown>(path: string, params?: Record<string, string | undefined>): Promise<{
+        data?: T;
+        error?: string;
+        status: number;
+    }>;
+    getKolFeed(params?: {
+        limit?: string;
+        action?: string;
+        kol?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    getKolCoordination(params?: {
+        period?: string;
+        min_kols?: string;
+        limit?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    getKolLeaderboard(params?: {
+        period?: string;
+        limit?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    getDeployerAlerts(params?: {
+        since?: string;
+        limit?: string;
+        offset?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+}

package/dist/client.js

@@ -0,0 +1,45 @@
+/**
+ * MadeOnSol x402 API client.
+ * Uses @x402/fetch to automatically handle 402 → sign USDC → retry flow.
+ */
+const DEFAULT_BASE = "https://madeonsol.com";
+export class MadeOnSolClient {
+    baseUrl;
+    fetchFn;
+    constructor(options = {}) {
+        this.baseUrl = options.baseUrl || DEFAULT_BASE;
+        this.fetchFn = options.fetchFn || globalThis.fetch;
+    }
+    async query(path, params) {
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, v);
+            }
+        }
+        const res = await this.fetchFn(url.toString(), { method: "GET" });
+        if (res.status === 402) {
+            const body = await res.json();
+            return { error: `Payment required: ${JSON.stringify(body.accepts?.[0] || body)}`, status: 402 };
+        }
+        if (!res.ok) {
+            const text = await res.text().catch(() => "Unknown error");
+            return { error: text, status: res.status };
+        }
+        const data = await res.json();
+        return { data, status: res.status };
+    }
+    getKolFeed(params) {
+        return this.query("/api/x402/kol/feed", params);
+    }
+    getKolCoordination(params) {
+        return this.query("/api/x402/kol/coordination", params);
+    }
+    getKolLeaderboard(params) {
+        return this.query("/api/x402/kol/leaderboard", params);
+    }
+    getDeployerAlerts(params) {
+        return this.query("/api/x402/deployer-hunter/alerts", params);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from "@elizaos/core";
+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";
+/** 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 };

package/dist/index.js

@@ -0,0 +1,52 @@
+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 { MadeOnSolClient } from "./client.js";
+/** Key used to store the initialized client on the runtime */
+export const MADEONSOL_CLIENT_KEY = "madeonsol:client";
+export const madeOnSolPlugin = {
+    name: "madeonsol",
+    description: "Query Solana KOL trading intelligence and deployer analytics from MadeOnSol via x402 micropayments. Tracks 946 KOL wallets and 4000+ Pump.fun deployers.",
+    actions: [
+        kolFeedAction,
+        kolCoordinationAction,
+        kolLeaderboardAction,
+        deployerAlertsAction,
+    ],
+    /**
+     * Initialize the x402 payment-enabled client.
+     * Requires SVM_PRIVATE_KEY in the runtime settings for automatic payments.
+     * Without it, the plugin still works but requests will return 402 payment info.
+     */
+    init: async (_config, runtime) => {
+        const baseUrl = String(runtime.getSetting?.("MADEONSOL_API_URL") || "https://madeonsol.com");
+        const privateKey = runtime.getSetting?.("SVM_PRIVATE_KEY");
+        let fetchFn;
+        if (privateKey) {
+            try {
+                const { wrapFetchWithPayment } = await import("@x402/fetch");
+                const { x402Client } = await import("@x402/core/client");
+                const { ExactSvmScheme } = await import("@x402/svm/exact/client");
+                const { createKeyPairSignerFromBytes } = await import("@solana/kit");
+                const { base58 } = await import("@scure/base");
+                const signer = await createKeyPairSignerFromBytes(base58.decode(privateKey));
+                const client = new x402Client();
+                client.register("solana:*", new ExactSvmScheme(signer));
+                fetchFn = wrapFetchWithPayment(fetch, client);
+                console.log(`[madeonsol] x402 payments enabled, wallet: ${signer.address}`);
+            }
+            catch (err) {
+                console.warn("[madeonsol] x402 payment setup failed, running in read-only mode:", err);
+            }
+        }
+        else {
+            console.log("[madeonsol] No SVM_PRIVATE_KEY — running in read-only mode (402 info only)");
+        }
+        const madeOnSolClient = new MadeOnSolClient({ baseUrl, fetchFn });
+        runtime[MADEONSOL_CLIENT_KEY] = madeOnSolClient;
+    },
+};
+export default madeOnSolPlugin;
+export { MadeOnSolClient } from "./client.js";
+export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@madeonsol/plugin-madeonsol",
+  "version": "0.1.0",
+  "description": "ElizaOS plugin for MadeOnSol — Solana KOL intelligence and deployer analytics via x402 micropayments",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": ""
+  },
+  "peerDependencies": {
+    "@elizaos/core": ">=1.0.0",
+    "@scure/base": ">=1.0.0",
+    "@solana/kit": ">=2.0.0",
+    "@x402/core": ">=0.1.0",
+    "@x402/fetch": ">=0.1.0",
+    "@x402/svm": ">=0.1.0"
+  },
+  "agentConfig": {
+    "pluginType": "elizaos:plugin:1.0.0",
+    "pluginParameters": {
+      "MADEONSOL_API_URL": {
+        "type": "string",
+        "description": "MadeOnSol API base URL",
+        "required": false,
+        "default": "https://madeonsol.com"
+      },
+      "SVM_PRIVATE_KEY": {
+        "type": "string",
+        "description": "Solana private key (base58) for automatic x402 USDC payments",
+        "required": true,
+        "sensitive": true
+      }
+    }
+  },
+  "keywords": [
+    "elizaos",
+    "plugin",
+    "solana",
+    "kol",
+    "x402",
+    "madeonsol"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@elizaos/core": "^2.0.0-alpha.77"
+  }
+}