solana-agent-kit-plugin-madeonsol 1.4.0 → 1.6.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/kolTokenEntryOrder.d.ts

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

package/dist/actions/kolTokenEntryOrder.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { kolTokenEntryOrder } from "../tools/index.js";
+export const kolTokenEntryOrderAction = {
+    name: "MADEONSOL_KOL_TOKEN_ENTRY_ORDER_ACTION",
+    similes: ["who bought first", "first kol buyers", "kol entry order", "token entry ranking"],
+    description: "Get the ranked order of KOL first-buyers for a specific Solana token. Each entry includes seconds_after_first relative to the first KOL entry. PRO+ adds percentile_pnl_7d per entry.",
+    examples: [
+        [{ input: { mint: "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", limit: 20 }, output: { status: "success" }, explanation: "Who were the first 20 KOLs to buy this token?" }],
+    ],
+    schema: z.object({
+        mint: z.string().describe("Token mint address (base58)"),
+        limit: z.number().min(1).max(200).default(50).describe("Max ranked entries"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolTokenEntryOrder(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, {
+        period: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h";
+        min_kols: number;
+        limit: number;
+    }, {
+        period?: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h" | undefined;
+        min_kols?: number | undefined;
+        limit?: 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/actions/walletTracker.d.ts

@@ -0,0 +1,176 @@
+import { z } from "zod";
+export declare const walletTrackerWatchlistAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {};
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    handler: (agent: unknown) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};
+export declare const walletTrackerAddAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            wallet_address: string;
+            label: string;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        wallet_address: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        wallet_address: string;
+        label?: string | undefined;
+    }, {
+        wallet_address: string;
+        label?: string | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        wallet_address: string;
+        label?: string;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};
+export declare const walletTrackerRemoveAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            wallet_address: string;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        wallet_address: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        wallet_address: string;
+    }, {
+        wallet_address: string;
+    }>;
+    handler: (agent: unknown, input: {
+        wallet_address: string;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};
+export declare const walletTrackerTradesAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        wallet: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodEnum<["buy", "sell", "transfer_in", "transfer_out"]>>;
+        event_type: z.ZodOptional<z.ZodEnum<["swap", "transfer"]>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        before: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        wallet?: string | undefined;
+        action?: "buy" | "sell" | "transfer_in" | "transfer_out" | undefined;
+        event_type?: "swap" | "transfer" | undefined;
+        before?: number | undefined;
+    }, {
+        limit?: number | undefined;
+        wallet?: string | undefined;
+        action?: "buy" | "sell" | "transfer_in" | "transfer_out" | undefined;
+        event_type?: "swap" | "transfer" | undefined;
+        before?: number | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        wallet?: string;
+        action?: string;
+        event_type?: string;
+        limit?: number;
+        before?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};
+export declare const walletTrackerSummaryAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            period: string;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        period: z.ZodDefault<z.ZodEnum<["24h", "7d", "30d"]>>;
+        wallet: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        period: "24h" | "7d" | "30d";
+        wallet?: string | undefined;
+    }, {
+        period?: "24h" | "7d" | "30d" | undefined;
+        wallet?: string | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        period?: string;
+        wallet?: string;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/walletTracker.js

@@ -0,0 +1,106 @@
+import { z } from "zod";
+import { walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary } from "../tools/index.js";
+export const walletTrackerWatchlistAction = {
+    name: "MADEONSOL_WALLET_TRACKER_WATCHLIST_ACTION",
+    similes: ["wallet watchlist", "tracked wallets", "my watchlist", "wallet tracker list"],
+    description: "List wallets in your MadeOnSol watchlist with labels and remaining capacity.",
+    examples: [
+        [{ input: {}, output: { status: "success" }, explanation: "Get your tracked wallet list" }],
+    ],
+    schema: z.object({}),
+    handler: async (agent) => {
+        try {
+            const data = await walletTrackerWatchlist(agent);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};
+export const walletTrackerAddAction = {
+    name: "MADEONSOL_WALLET_TRACKER_ADD_ACTION",
+    similes: ["track wallet", "add wallet to watchlist", "watch wallet", "monitor wallet"],
+    description: "Add a Solana wallet to your MadeOnSol watchlist for swap/transfer tracking.",
+    examples: [
+        [{ input: { wallet_address: "ABC...xyz", label: "whale #1" }, output: { status: "success" }, explanation: "Add a wallet to watchlist" }],
+    ],
+    schema: z.object({
+        wallet_address: z.string().describe("Solana wallet address (base58) to track"),
+        label: z.string().optional().describe("Optional human-readable label"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await walletTrackerAdd(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};
+export const walletTrackerRemoveAction = {
+    name: "MADEONSOL_WALLET_TRACKER_REMOVE_ACTION",
+    similes: ["untrack wallet", "remove wallet from watchlist", "stop watching wallet"],
+    description: "Remove a Solana wallet from your MadeOnSol watchlist.",
+    examples: [
+        [{ input: { wallet_address: "ABC...xyz" }, output: { status: "success" }, explanation: "Remove a wallet from watchlist" }],
+    ],
+    schema: z.object({
+        wallet_address: z.string().describe("Solana wallet address (base58) to remove"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await walletTrackerRemove(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};
+export const walletTrackerTradesAction = {
+    name: "MADEONSOL_WALLET_TRACKER_TRADES_ACTION",
+    similes: ["wallet tracker trades", "tracked wallet trades", "watchlist activity", "wallet swaps", "wallet transfers"],
+    description: "Get recent swap and transfer events from wallets in your MadeOnSol watchlist.",
+    examples: [
+        [{ input: { limit: 20 }, output: { status: "success" }, explanation: "Get recent trades from tracked wallets" }],
+    ],
+    schema: z.object({
+        wallet: z.string().optional().describe("Filter to a specific wallet address"),
+        action: z.enum(["buy", "sell", "transfer_in", "transfer_out"]).optional().describe("Filter by action type"),
+        event_type: z.enum(["swap", "transfer"]).optional().describe("Filter by event type"),
+        limit: z.number().min(1).max(200).default(50).describe("Max results (1-200)"),
+        before: z.number().optional().describe("Pagination cursor: block_time of last event"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await walletTrackerTrades(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};
+export const walletTrackerSummaryAction = {
+    name: "MADEONSOL_WALLET_TRACKER_SUMMARY_ACTION",
+    similes: ["wallet tracker summary", "tracked wallet stats", "watchlist summary", "wallet activity stats"],
+    description: "Get per-wallet stats (swap counts, SOL bought/sold, last activity) for your MadeOnSol watchlist.",
+    examples: [
+        [{ input: { period: "7d" }, output: { status: "success" }, explanation: "Get 7d stats for all tracked wallets" }],
+    ],
+    schema: z.object({
+        period: z.enum(["24h", "7d", "30d"]).default("7d").describe("Time window for stats"),
+        wallet: z.string().optional().describe("Filter to a specific wallet address"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await walletTrackerSummary(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};