solana-agent-kit-plugin-madeonsol 0.4.0 → 0.5.0

package/dist/actions/kolPnl.d.ts

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

package/dist/actions/kolPnl.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { kolPnl } from "../tools/index.js";
+export const kolPnlAction = {
+    name: "MADEONSOL_KOL_PNL_ACTION",
+    similes: ["kol pnl", "kol profit", "kol performance", "wallet pnl", "kol win rate", "kol drawdown"],
+    description: "Get deep per-wallet PnL breakdown — realized PnL, win rate, profit factor, max drawdown, daily equity curve, and per-token positions via MadeOnSol API.",
+    examples: [
+        [{ input: { wallet: "ABC...xyz", period: "30d" }, output: { status: "success" }, explanation: "Get 30-day PnL breakdown for a KOL wallet" }],
+    ],
+    schema: z.object({
+        wallet: z.string().describe("KOL wallet address (base58)"),
+        period: z.enum(["7d", "30d", "90d", "180d"]).default("30d").describe("Time period"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolPnl(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolTrendingTokens.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export declare const kolTrendingTokensAction: {
+    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<["5m", "15m", "30m", "1h", "2h", "4h", "12h"]>>;
+        min_kols: z.ZodDefault<z.ZodNumber>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        period: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h";
+        min_kols: number;
+    }, {
+        limit?: number | undefined;
+        period?: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h" | 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/kolTrendingTokens.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { kolTrendingTokens } from "../tools/index.js";
+export const kolTrendingTokensAction = {
+    name: "MADEONSOL_KOL_TRENDING_TOKENS_ACTION",
+    similes: ["trending tokens", "kol volume", "what are kols buying now", "hot buys", "kol capital flow"],
+    description: "Get tokens ranked by KOL buy volume — pure capital-flow signal. Sub-hour periods (5m/15m/30m) require PRO/ULTRA. Costs $0.005 USDC per request.",
+    examples: [
+        [{ input: { period: "1h", min_kols: 2 }, output: { status: "success" }, explanation: "Get tokens with highest KOL buy volume in the last hour, with at least 2 KOLs buying" }],
+    ],
+    schema: z.object({
+        period: z.enum(["5m", "15m", "30m", "1h", "2h", "4h", "12h"]).default("1h").describe("Time window"),
+        min_kols: z.number().min(1).max(20).default(1).describe("Minimum KOL buyers"),
+        limit: z.number().min(1).max(50).default(20).describe("Number of tokens"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolTrendingTokens(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/index.d.ts

@@ -2,7 +2,9 @@ import { kolFeedAction } from "./actions/kolFeed.js";
 import { kolCoordinationAction } from "./actions/kolCoordination.js";
 import { kolLeaderboardAction } from "./actions/kolLeaderboard.js";
 import { deployerAlertsAction } from "./actions/deployerAlerts.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken } from "./tools/index.js";
+import { kolPnlAction } from "./actions/kolPnl.js";
+import { kolTrendingTokensAction } from "./actions/kolTrendingTokens.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken } from "./tools/index.js";
 declare const MadeOnSolPlugin: {
     name: string;
     methods: {
@@ -10,6 +12,8 @@ declare const MadeOnSolPlugin: {
         kolCoordination: typeof kolCoordination;
         kolLeaderboard: typeof kolLeaderboard;
         deployerAlerts: typeof deployerAlerts;
+        kolPnl: typeof kolPnl;
+        kolTrendingTokens: typeof kolTrendingTokens;
         createWebhook: typeof createWebhook;
         listWebhooks: typeof listWebhooks;
         deleteWebhook: typeof deleteWebhook;
@@ -175,9 +179,85 @@ declare const MadeOnSolPlugin: {
             message: string;
             result?: undefined;
         }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                wallet: string;
+                period: string;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            wallet: import("zod").ZodString;
+            period: import("zod").ZodDefault<import("zod").ZodEnum<["7d", "30d", "90d", "180d"]>>;
+        }, "strip", import("zod").ZodTypeAny, {
+            period: "7d" | "30d" | "90d" | "180d";
+            wallet: string;
+        }, {
+            wallet: string;
+            period?: "7d" | "30d" | "90d" | "180d" | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            wallet: string;
+            period?: string;
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                period: string;
+                min_kols: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            period: import("zod").ZodDefault<import("zod").ZodEnum<["5m", "15m", "30m", "1h", "2h", "4h", "12h"]>>;
+            min_kols: import("zod").ZodDefault<import("zod").ZodNumber>;
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        }, "strip", import("zod").ZodTypeAny, {
+            limit: number;
+            period: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h";
+            min_kols: number;
+        }, {
+            limit?: number | undefined;
+            period?: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h" | 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;
+        }>;
     })[];
     initialize(_agent: unknown): void;
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken };
+export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction };

package/dist/index.js

@@ -2,7 +2,9 @@ import { kolFeedAction } from "./actions/kolFeed.js";
 import { kolCoordinationAction } from "./actions/kolCoordination.js";
 import { kolLeaderboardAction } from "./actions/kolLeaderboard.js";
 import { deployerAlertsAction } from "./actions/deployerAlerts.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken } from "./tools/index.js";
+import { kolPnlAction } from "./actions/kolPnl.js";
+import { kolTrendingTokensAction } from "./actions/kolTrendingTokens.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken } from "./tools/index.js";
 const MadeOnSolPlugin = {
     name: "madeonsol",
     methods: {
@@ -10,6 +12,8 @@ const MadeOnSolPlugin = {
         kolCoordination,
         kolLeaderboard,
         deployerAlerts,
+        kolPnl,
+        kolTrendingTokens,
         createWebhook,
         listWebhooks,
         deleteWebhook,
@@ -21,11 +25,13 @@ const MadeOnSolPlugin = {
         kolCoordinationAction,
         kolLeaderboardAction,
         deployerAlertsAction,
+        kolPnlAction,
+        kolTrendingTokensAction,
     ],
     initialize(_agent) {
         // No-op — payment setup is lazy in tool functions
     },
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken };
+export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction };

package/dist/tools/index.d.ts

@@ -42,6 +42,15 @@ export declare function kolHotTokens(agent: Agent, params?: {
     min_kols?: number;
     limit?: number;
 }): Promise<any>;
+export declare function kolTrendingTokens(agent: Agent, params?: {
+    period?: string;
+    min_kols?: number;
+    limit?: number;
+}): Promise<any>;
+export declare function kolPnl(agent: Agent, params: {
+    wallet: string;
+    period?: string;
+}): Promise<any>;
 export declare function kolTiming(agent: Agent, params: {
     wallet: string;
     period?: string;

package/dist/tools/index.js

@@ -102,6 +102,14 @@ export async function kolHotTokens(agent, params = {}) {
     await initAuth(agent);
     return query("/api/x402/kol/tokens/hot", params);
 }
+export async function kolTrendingTokens(agent, params = {}) {
+    await initAuth(agent);
+    return query("/api/x402/kol/tokens/trending", params);
+}
+export async function kolPnl(agent, params) {
+    const qs = params.period ? `?period=${params.period}` : "";
+    return restQuery(agent, "GET", `/kol/${params.wallet}/pnl${qs}`);
+}
 export async function kolTiming(agent, params) {
     const qs = params.period ? `?period=${params.period}` : "";
     return restQuery(agent, "GET", `/kol/${params.wallet}/timing${qs}`);

package/package.json

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