solana-agent-kit-plugin-madeonsol 0.2.0 → 0.3.0

package/README.md

@@ -1,54 +1,69 @@
-# solana-agent-kit-plugin-madeonsol
-
-[Solana Agent Kit](https://github.com/sendaifun/solana-agent-kit) plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL intelligence and deployer analytics via x402 micropayments.
-
-## Install
-
-```bash
-npm install solana-agent-kit-plugin-madeonsol @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
-```
-
-## Usage
-
-```typescript
-import { SolanaAgentKit } from "solana-agent-kit";
-import MadeOnSolPlugin from "solana-agent-kit-plugin-madeonsol";
-
-const agent = new SolanaAgentKit(privateKey, rpcUrl, {
-  SVM_PRIVATE_KEY: "your_solana_private_key_base58",
-});
-
-agent.use(MadeOnSolPlugin);
-
-// Use via methods
-const trades = await agent.methods.kolFeed(agent, { limit: 10, action: "buy" });
-
-// Or let the LLM trigger actions via natural language
-// "What are KOLs buying right now?" → MADEONSOL_KOL_FEED_ACTION
-```
-
-## Actions
-
-| Action | Price | Triggers on |
-|---|---|---|
-| `MADEONSOL_KOL_FEED_ACTION` | $0.005 | "kol trades", "what are kols buying" |
-| `MADEONSOL_KOL_COORDINATION_ACTION` | $0.02 | "kol convergence", "tokens kols accumulating" |
-| `MADEONSOL_KOL_LEADERBOARD_ACTION` | $0.005 | "top kols", "kol rankings", "best kol" |
-| `MADEONSOL_DEPLOYER_ALERTS_ACTION` | $0.01 | "deployer alerts", "pump fun launches" |
-
-## Config
-
-Set `SVM_PRIVATE_KEY` in your agent config for automatic x402 USDC payments. The wallet needs SOL (fees) and USDC on Solana mainnet.
-
-## 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 |
-| MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) |
-| ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
-
-## License
-
-MIT
+# solana-agent-kit-plugin-madeonsol
+
+[Solana Agent Kit](https://github.com/sendaifun/solana-agent-kit) plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL intelligence and deployer analytics.
+
+## Authentication
+
+Three options (in priority order):
+
+| Method | Config key | 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 |
+
+## Install
+
+```bash
+npm install solana-agent-kit-plugin-madeonsol
+```
+
+> x402 peer deps (`@x402/fetch @x402/svm @x402/core @solana/kit @scure/base`) are only needed when using `SVM_PRIVATE_KEY`.
+
+## Usage
+
+```typescript
+import { SolanaAgentKit } from "solana-agent-kit";
+import MadeOnSolPlugin from "solana-agent-kit-plugin-madeonsol";
+
+const agent = new SolanaAgentKit(privateKey, rpcUrl, {
+  // Option 1: API key (simplest)
+  MADEONSOL_API_KEY: "msk_your_api_key_here",
+
+  // Option 2: RapidAPI key
+  // RAPIDAPI_KEY: "your_rapidapi_key",
+
+  // Option 3: x402 micropayments
+  // SVM_PRIVATE_KEY: "your_solana_private_key_base58",
+});
+
+agent.use(MadeOnSolPlugin);
+
+// Use via methods
+const trades = await agent.methods.kolFeed(agent, { limit: 10, action: "buy" });
+
+// Or let the LLM trigger actions via natural language
+// "What are KOLs buying right now?" → MADEONSOL_KOL_FEED_ACTION
+```
+
+## Actions
+
+| Action | Triggers on |
+|---|---|
+| `MADEONSOL_KOL_FEED_ACTION` | "kol trades", "what are kols buying" |
+| `MADEONSOL_KOL_COORDINATION_ACTION` | "kol convergence", "tokens kols accumulating" |
+| `MADEONSOL_KOL_LEADERBOARD_ACTION` | "top kols", "kol rankings", "best kol" |
+| `MADEONSOL_DEPLOYER_ALERTS_ACTION` | "deployer alerts", "pump fun launches" |
+
+## 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 |
+| MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) |
+| ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
+
+## License
+
+MIT

package/dist/actions/deployerAlerts.d.ts

@@ -1,41 +1,41 @@
-import { z } from "zod";
-export declare const deployerAlertsAction: {
-    name: string;
-    similes: string[];
-    description: string;
-    examples: {
-        input: {
-            limit: number;
-        };
-        output: {
-            status: string;
-        };
-        explanation: string;
-    }[][];
-    schema: z.ZodObject<{
-        limit: z.ZodDefault<z.ZodNumber>;
-        offset: z.ZodDefault<z.ZodNumber>;
-        since: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        limit: number;
-        offset: number;
-        since?: string | undefined;
-    }, {
-        limit?: number | undefined;
-        offset?: number | undefined;
-        since?: string | undefined;
-    }>;
-    handler: (agent: unknown, input: {
-        limit?: number;
-        offset?: number;
-        since?: string;
-    }) => Promise<{
-        status: string;
-        result: any;
-        message?: undefined;
-    } | {
-        status: string;
-        message: string;
-        result?: undefined;
-    }>;
-};
+import { z } from "zod";
+export declare const deployerAlertsAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        offset: z.ZodDefault<z.ZodNumber>;
+        since: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        offset: number;
+        since?: string | undefined;
+    }, {
+        limit?: number | undefined;
+        offset?: number | undefined;
+        since?: string | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        limit?: number;
+        offset?: number;
+        since?: string;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/deployerAlerts.js

@@ -1,24 +1,24 @@
-import { z } from "zod";
-import { deployerAlerts } from "../tools/index.js";
-export const deployerAlertsAction = {
-    name: "MADEONSOL_DEPLOYER_ALERTS_ACTION",
-    similes: ["deployer alerts", "pump fun launches", "new token alerts", "elite deployer tokens"],
-    description: "Get real-time alerts from elite Pump.fun deployers with KOL buy enrichment. Costs $0.01 USDC per request.",
-    examples: [
-        [{ input: { limit: 10 }, output: { status: "success" }, explanation: "Get the 10 most recent deployer alerts" }],
-    ],
-    schema: z.object({
-        limit: z.number().min(1).max(100).default(10).describe("Number of alerts"),
-        offset: z.number().min(0).default(0).describe("Pagination offset"),
-        since: z.string().optional().describe("ISO8601 timestamp to filter alerts after"),
-    }),
-    handler: async (agent, input) => {
-        try {
-            const data = await deployerAlerts(agent, input);
-            return { status: "success", result: data };
-        }
-        catch (err) {
-            return { status: "error", message: err.message };
-        }
-    },
-};
+import { z } from "zod";
+import { deployerAlerts } from "../tools/index.js";
+export const deployerAlertsAction = {
+    name: "MADEONSOL_DEPLOYER_ALERTS_ACTION",
+    similes: ["deployer alerts", "pump fun launches", "new token alerts", "elite deployer tokens"],
+    description: "Get real-time alerts from elite Pump.fun deployers with KOL buy enrichment. Costs $0.01 USDC per request.",
+    examples: [
+        [{ input: { limit: 10 }, output: { status: "success" }, explanation: "Get the 10 most recent deployer alerts" }],
+    ],
+    schema: z.object({
+        limit: z.number().min(1).max(100).default(10).describe("Number of alerts"),
+        offset: z.number().min(0).default(0).describe("Pagination offset"),
+        since: z.string().optional().describe("ISO8601 timestamp to filter alerts after"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await deployerAlerts(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolCoordination.d.ts

@@ -1,42 +1,42 @@
-import { z } from "zod";
-export declare const kolCoordinationAction: {
-    name: string;
-    similes: string[];
-    description: string;
-    examples: {
-        input: {
-            period: string;
-            min_kols: number;
-        };
-        output: {
-            status: string;
-        };
-        explanation: string;
-    }[][];
-    schema: z.ZodObject<{
-        period: z.ZodDefault<z.ZodEnum<["1h", "6h", "24h", "7d"]>>;
-        min_kols: z.ZodDefault<z.ZodNumber>;
-        limit: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        limit: number;
-        period: "24h" | "1h" | "6h" | "7d";
-        min_kols: number;
-    }, {
-        limit?: number | undefined;
-        period?: "24h" | "1h" | "6h" | "7d" | undefined;
-        min_kols?: number | undefined;
-    }>;
-    handler: (agent: unknown, input: {
-        period?: string;
-        min_kols?: number;
-        limit?: number;
-    }) => Promise<{
-        status: string;
-        result: any;
-        message?: undefined;
-    } | {
-        status: string;
-        message: string;
-        result?: undefined;
-    }>;
-};
+import { z } from "zod";
+export declare const kolCoordinationAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            period: string;
+            min_kols: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        period: z.ZodDefault<z.ZodEnum<["1h", "6h", "24h", "7d"]>>;
+        min_kols: z.ZodDefault<z.ZodNumber>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        period: "24h" | "1h" | "6h" | "7d";
+        min_kols: number;
+    }, {
+        limit?: number | undefined;
+        period?: "24h" | "1h" | "6h" | "7d" | undefined;
+        min_kols?: number | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        period?: string;
+        min_kols?: number;
+        limit?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolCoordination.js

@@ -1,24 +1,24 @@
-import { z } from "zod";
-import { kolCoordination } from "../tools/index.js";
-export const kolCoordinationAction = {
-    name: "MADEONSOL_KOL_COORDINATION_ACTION",
-    similes: ["kol convergence", "what tokens are kols accumulating", "kol coordination", "smart money convergence"],
-    description: "Get KOL convergence signals — tokens being accumulated by multiple KOLs simultaneously. Costs $0.02 USDC per request.",
-    examples: [
-        [{ input: { period: "24h", min_kols: 3 }, output: { status: "success" }, explanation: "Get tokens where 3+ KOLs are converging in the last 24 hours" }],
-    ],
-    schema: z.object({
-        period: z.enum(["1h", "6h", "24h", "7d"]).default("24h").describe("Time period"),
-        min_kols: z.number().min(2).max(50).default(3).describe("Minimum KOLs converging"),
-        limit: z.number().min(1).max(50).default(20).describe("Number of results"),
-    }),
-    handler: async (agent, input) => {
-        try {
-            const data = await kolCoordination(agent, input);
-            return { status: "success", result: data };
-        }
-        catch (err) {
-            return { status: "error", message: err.message };
-        }
-    },
-};
+import { z } from "zod";
+import { kolCoordination } from "../tools/index.js";
+export const kolCoordinationAction = {
+    name: "MADEONSOL_KOL_COORDINATION_ACTION",
+    similes: ["kol convergence", "what tokens are kols accumulating", "kol coordination", "smart money convergence"],
+    description: "Get KOL convergence signals — tokens being accumulated by multiple KOLs simultaneously. Costs $0.02 USDC per request.",
+    examples: [
+        [{ input: { period: "24h", min_kols: 3 }, output: { status: "success" }, explanation: "Get tokens where 3+ KOLs are converging in the last 24 hours" }],
+    ],
+    schema: z.object({
+        period: z.enum(["1h", "6h", "24h", "7d"]).default("24h").describe("Time period"),
+        min_kols: z.number().min(2).max(50).default(3).describe("Minimum KOLs converging"),
+        limit: z.number().min(1).max(50).default(20).describe("Number of results"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolCoordination(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolFeed.d.ts

@@ -1,42 +1,42 @@
-import { z } from "zod";
-export declare const kolFeedAction: {
-    name: string;
-    similes: string[];
-    description: string;
-    examples: {
-        input: {
-            limit: number;
-            action: string;
-        };
-        output: {
-            status: string;
-        };
-        explanation: string;
-    }[][];
-    schema: z.ZodObject<{
-        limit: z.ZodDefault<z.ZodNumber>;
-        action: z.ZodOptional<z.ZodEnum<["buy", "sell"]>>;
-        kol: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        limit: number;
-        action?: "buy" | "sell" | undefined;
-        kol?: string | undefined;
-    }, {
-        limit?: number | undefined;
-        action?: "buy" | "sell" | undefined;
-        kol?: string | undefined;
-    }>;
-    handler: (agent: unknown, input: {
-        limit?: number;
-        action?: string;
-        kol?: string;
-    }) => Promise<{
-        status: string;
-        result: any;
-        message?: undefined;
-    } | {
-        status: string;
-        message: string;
-        result?: undefined;
-    }>;
-};
+import { z } from "zod";
+export declare const kolFeedAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            limit: number;
+            action: string;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        action: z.ZodOptional<z.ZodEnum<["buy", "sell"]>>;
+        kol: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        action?: "buy" | "sell" | undefined;
+        kol?: string | undefined;
+    }, {
+        limit?: number | undefined;
+        action?: "buy" | "sell" | undefined;
+        kol?: string | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        limit?: number;
+        action?: string;
+        kol?: string;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolFeed.js

@@ -1,24 +1,24 @@
-import { z } from "zod";
-import { kolFeed } from "../tools/index.js";
-export const kolFeedAction = {
-    name: "MADEONSOL_KOL_FEED_ACTION",
-    similes: ["kol trades", "what are kols buying", "kol feed", "smart money trades", "kol activity"],
-    description: "Get real-time Solana KOL trades from 946 tracked wallets via MadeOnSol x402 API. Costs $0.005 USDC per request.",
-    examples: [
-        [{ input: { limit: 10, action: "buy" }, output: { status: "success" }, explanation: "Fetch the 10 most recent KOL buy trades" }],
-    ],
-    schema: z.object({
-        limit: z.number().min(1).max(100).default(10).describe("Number of trades"),
-        action: z.enum(["buy", "sell"]).optional().describe("Filter by trade type"),
-        kol: z.string().optional().describe("Filter by KOL wallet address"),
-    }),
-    handler: async (agent, input) => {
-        try {
-            const data = await kolFeed(agent, input);
-            return { status: "success", result: data };
-        }
-        catch (err) {
-            return { status: "error", message: err.message };
-        }
-    },
-};
+import { z } from "zod";
+import { kolFeed } from "../tools/index.js";
+export const kolFeedAction = {
+    name: "MADEONSOL_KOL_FEED_ACTION",
+    similes: ["kol trades", "what are kols buying", "kol feed", "smart money trades", "kol activity"],
+    description: "Get real-time Solana KOL trades from 946 tracked wallets via MadeOnSol x402 API. Costs $0.005 USDC per request.",
+    examples: [
+        [{ input: { limit: 10, action: "buy" }, output: { status: "success" }, explanation: "Fetch the 10 most recent KOL buy trades" }],
+    ],
+    schema: z.object({
+        limit: z.number().min(1).max(100).default(10).describe("Number of trades"),
+        action: z.enum(["buy", "sell"]).optional().describe("Filter by trade type"),
+        kol: z.string().optional().describe("Filter by KOL wallet address"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolFeed(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolLeaderboard.d.ts

@@ -1,38 +1,38 @@
-import { z } from "zod";
-export declare const kolLeaderboardAction: {
-    name: string;
-    similes: string[];
-    description: string;
-    examples: {
-        input: {
-            period: string;
-            limit: number;
-        };
-        output: {
-            status: string;
-        };
-        explanation: string;
-    }[][];
-    schema: z.ZodObject<{
-        period: z.ZodDefault<z.ZodEnum<["today", "7d", "30d"]>>;
-        limit: z.ZodDefault<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        limit: number;
-        period: "7d" | "today" | "30d";
-    }, {
-        limit?: number | undefined;
-        period?: "7d" | "today" | "30d" | undefined;
-    }>;
-    handler: (agent: unknown, input: {
-        period?: string;
-        limit?: number;
-    }) => Promise<{
-        status: string;
-        result: any;
-        message?: undefined;
-    } | {
-        status: string;
-        message: string;
-        result?: undefined;
-    }>;
-};
+import { z } from "zod";
+export declare const kolLeaderboardAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            period: string;
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        period: z.ZodDefault<z.ZodEnum<["today", "7d", "30d"]>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        period: "7d" | "today" | "30d";
+    }, {
+        limit?: number | undefined;
+        period?: "7d" | "today" | "30d" | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        period?: string;
+        limit?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolLeaderboard.js

@@ -1,23 +1,23 @@
-import { z } from "zod";
-import { kolLeaderboard } from "../tools/index.js";
-export const kolLeaderboardAction = {
-    name: "MADEONSOL_KOL_LEADERBOARD_ACTION",
-    similes: ["kol leaderboard", "top kols", "best performing kols", "kol rankings", "kol pnl"],
-    description: "Get KOL performance rankings by PnL and win rate. Costs $0.005 USDC per request.",
-    examples: [
-        [{ input: { period: "7d", limit: 10 }, output: { status: "success" }, explanation: "Get the top 10 KOLs by PnL this week" }],
-    ],
-    schema: z.object({
-        period: z.enum(["today", "7d", "30d"]).default("7d").describe("Time period"),
-        limit: z.number().min(1).max(50).default(20).describe("Number of KOLs"),
-    }),
-    handler: async (agent, input) => {
-        try {
-            const data = await kolLeaderboard(agent, input);
-            return { status: "success", result: data };
-        }
-        catch (err) {
-            return { status: "error", message: err.message };
-        }
-    },
-};
+import { z } from "zod";
+import { kolLeaderboard } from "../tools/index.js";
+export const kolLeaderboardAction = {
+    name: "MADEONSOL_KOL_LEADERBOARD_ACTION",
+    similes: ["kol leaderboard", "top kols", "best performing kols", "kol rankings", "kol pnl"],
+    description: "Get KOL performance rankings by PnL and win rate. Costs $0.005 USDC per request.",
+    examples: [
+        [{ input: { period: "7d", limit: 10 }, output: { status: "success" }, explanation: "Get the top 10 KOLs by PnL this week" }],
+    ],
+    schema: z.object({
+        period: z.enum(["today", "7d", "30d"]).default("7d").describe("Time period"),
+        limit: z.number().min(1).max(50).default(20).describe("Number of KOLs"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolLeaderboard(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};