madeonsol-x402 0.1.0 → 0.2.0

package/LICENSE

@@ -1 +1 @@
-MIT License
+MIT License

package/README.md

@@ -1,60 +1,69 @@
-# madeonsol-x402
-
-Zero-config x402 client SDK for the [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. Pay-per-request with USDC on Solana.
-
-## Install
-
-```bash
-npm install madeonsol-x402 @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
-```
-
-## Quick Start
-
-```ts
-import { createClient } from "madeonsol-x402";
-
-const client = createClient(process.env.SOLANA_PRIVATE_KEY!);
-const { trades } = await client.kolFeed({ limit: 10 });
-console.log(trades);
-```
-
-## Endpoints
-
-| Method | Price | Description |
-|---|---|---|
-| `kolFeed(params?)` | $0.005 | Real-time KOL trade feed from 946+ tracked wallets |
-| `kolCoordination(params?)` | $0.02 | Tokens being accumulated by multiple KOLs simultaneously |
-| `kolLeaderboard(params?)` | $0.005 | KOL performance rankings by PnL and win rate |
-| `deployerAlerts(params?)` | $0.01 | Alerts from elite Pump.fun deployers with KOL enrichment |
-| `discovery()` | Free | Lists all endpoints, prices, and parameter docs |
-
-## Parameters
-
-**kolFeed** — `limit` (1-100), `action` ("buy" | "sell"), `kol` (wallet address)
-
-**kolCoordination** — `period` ("1h" | "6h" | "24h" | "7d"), `min_kols` (2-50), `limit` (1-50)
-
-**kolLeaderboard** — `period` ("today" | "7d" | "30d"), `limit` (1-50)
-
-**deployerAlerts** — `since` (ISO8601), `limit` (1-100), `offset` (number)
-
-## How it works
-
-The SDK wraps the [x402 payment protocol](https://x402.org). When you call an endpoint, the library automatically:
-
-1. Sends the request
-2. Receives the 402 Payment Required response
-3. Signs a USDC payment on Solana using your private key
-4. Retries the request with the payment proof
-5. Returns typed data
-
-Your wallet needs USDC (SPL token) on Solana mainnet. Payments are settled via the PayAI facilitator.
-
-## Discovery
-
-```ts
-const info = await client.discovery();
-console.log(info.endpoints); // all endpoints with prices and params
-```
-
-Docs: [madeonsol.com/solana-api](https://madeonsol.com/solana-api)
+# madeonsol-x402
+
+Zero-config x402 client SDK for the [MadeOnSol](https://madeonsol.com) Solana KOL intelligence API. Pay-per-request with USDC on Solana.
+
+## Install
+
+```bash
+npm install madeonsol-x402 @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
+```
+
+## Quick Start
+
+```ts
+import { createClient } from "madeonsol-x402";
+
+const client = createClient(process.env.SOLANA_PRIVATE_KEY!);
+const { trades } = await client.kolFeed({ limit: 10 });
+console.log(trades);
+```
+
+## Endpoints
+
+| Method | Price | Description |
+|---|---|---|
+| `kolFeed(params?)` | $0.005 | Real-time KOL trade feed from 946+ tracked wallets |
+| `kolCoordination(params?)` | $0.02 | Tokens being accumulated by multiple KOLs simultaneously |
+| `kolLeaderboard(params?)` | $0.005 | KOL performance rankings by PnL and win rate |
+| `deployerAlerts(params?)` | $0.01 | Alerts from elite Pump.fun deployers with KOL enrichment |
+| `discovery()` | Free | Lists all endpoints, prices, and parameter docs |
+
+## Parameters
+
+**kolFeed** — `limit` (1-100), `action` ("buy" | "sell"), `kol` (wallet address)
+
+**kolCoordination** — `period` ("1h" | "6h" | "24h" | "7d"), `min_kols` (2-50), `limit` (1-50)
+
+**kolLeaderboard** — `period` ("today" | "7d" | "30d"), `limit` (1-50)
+
+**deployerAlerts** — `since` (ISO8601), `limit` (1-100), `offset` (number)
+
+## How it works
+
+The SDK wraps the [x402 payment protocol](https://x402.org). When you call an endpoint, the library automatically:
+
+1. Sends the request
+2. Receives the 402 Payment Required response
+3. Signs a USDC payment on Solana using your private key
+4. Retries the request with the payment proof
+5. Returns typed data
+
+Your wallet needs USDC (SPL token) on Solana mainnet. Payments are settled via the PayAI facilitator.
+
+## Discovery
+
+```ts
+const info = await client.discovery();
+console.log(info.endpoints); // all endpoints with prices and params
+```
+
+Docs: [madeonsol.com/solana-api](https://madeonsol.com/solana-api)
+
+## Also Available
+
+| Platform | Package |
+|---|---|
+| 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) |
+| Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |

package/dist/index.d.ts

@@ -1,29 +1,29 @@
-import type { KolFeedParams, KolFeedResponse, KolCoordinationParams, KolCoordinationResponse, KolLeaderboardParams, KolLeaderboardResponse, DeployerAlertsParams, DeployerAlertsResponse, DiscoveryResponse } from "./types.js";
-export type { KolTrade, KolFeedParams, KolFeedResponse, KolCoordinationToken, KolCoordinationParams, KolCoordinationResponse, KolLeaderboardEntry, KolLeaderboardParams, KolLeaderboardResponse, DeployerAlert, DeployerAlertsParams, DeployerAlertsResponse, DiscoveryEndpoint, DiscoveryResponse, } from "./types.js";
-interface MadeOnSolX402Options {
-    /** Base58-encoded Solana private key */
-    privateKey: string;
-    /** API base URL (default: https://madeonsol.com) */
-    baseUrl?: string;
-}
-export declare class MadeOnSolX402 {
-    private paidFetch;
-    private baseUrl;
-    private ready;
-    constructor(opts: MadeOnSolX402Options);
-    private init;
-    private request;
-    /** Real-time KOL trade feed from 946+ tracked wallets. ($0.005/req) */
-    kolFeed(params?: KolFeedParams): Promise<KolFeedResponse>;
-    /** KOL convergence signals — tokens being accumulated by multiple KOLs. ($0.02/req) */
-    kolCoordination(params?: KolCoordinationParams): Promise<KolCoordinationResponse>;
-    /** KOL performance rankings by PnL and win rate. ($0.005/req) */
-    kolLeaderboard(params?: KolLeaderboardParams): Promise<KolLeaderboardResponse>;
-    /** Real-time alerts from elite Pump.fun deployers. ($0.01/req) */
-    deployerAlerts(params?: DeployerAlertsParams): Promise<DeployerAlertsResponse>;
-    /** Free discovery endpoint — lists all available endpoints and prices. */
-    discovery(): Promise<DiscoveryResponse>;
-}
-/** Convenience factory — creates a ready-to-use client. */
-export declare function createClient(privateKey: string, baseUrl?: string): MadeOnSolX402;
+import type { KolFeedParams, KolFeedResponse, KolCoordinationParams, KolCoordinationResponse, KolLeaderboardParams, KolLeaderboardResponse, DeployerAlertsParams, DeployerAlertsResponse, DiscoveryResponse } from "./types.js";
+export type { KolTrade, KolFeedParams, KolFeedResponse, KolCoordinationToken, KolCoordinationParams, KolCoordinationResponse, KolLeaderboardEntry, KolLeaderboardParams, KolLeaderboardResponse, DeployerAlert, DeployerAlertsParams, DeployerAlertsResponse, DiscoveryEndpoint, DiscoveryResponse, } from "./types.js";
+interface MadeOnSolX402Options {
+    /** Base58-encoded Solana private key */
+    privateKey: string;
+    /** API base URL (default: https://madeonsol.com) */
+    baseUrl?: string;
+}
+export declare class MadeOnSolX402 {
+    private paidFetch;
+    private baseUrl;
+    private ready;
+    constructor(opts: MadeOnSolX402Options);
+    private init;
+    private request;
+    /** Real-time KOL trade feed from 946+ tracked wallets. ($0.005/req) */
+    kolFeed(params?: KolFeedParams): Promise<KolFeedResponse>;
+    /** KOL convergence signals — tokens being accumulated by multiple KOLs. ($0.02/req) */
+    kolCoordination(params?: KolCoordinationParams): Promise<KolCoordinationResponse>;
+    /** KOL performance rankings by PnL and win rate. ($0.005/req) */
+    kolLeaderboard(params?: KolLeaderboardParams): Promise<KolLeaderboardResponse>;
+    /** Real-time alerts from elite Pump.fun deployers. ($0.01/req) */
+    deployerAlerts(params?: DeployerAlertsParams): Promise<DeployerAlertsResponse>;
+    /** Free discovery endpoint — lists all available endpoints and prices. */
+    discovery(): Promise<DiscoveryResponse>;
+}
+/** Convenience factory — creates a ready-to-use client. */
+export declare function createClient(privateKey: string, baseUrl?: string): MadeOnSolX402;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,65 +1,65 @@
-const DEFAULT_BASE_URL = "https://madeonsol.com";
-export class MadeOnSolX402 {
-    paidFetch;
-    baseUrl;
-    ready;
-    constructor(opts) {
-        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
-        this.ready = this.init(opts.privateKey);
-    }
-    async init(privateKey) {
-        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));
-        this.paidFetch = wrapFetchWithPayment(fetch, client);
-    }
-    async request(path, params) {
-        await this.ready;
-        const url = new URL(path, this.baseUrl);
-        if (params) {
-            for (const [k, v] of Object.entries(params)) {
-                if (v !== undefined)
-                    url.searchParams.set(k, String(v));
-            }
-        }
-        const res = await this.paidFetch(url.toString());
-        if (!res.ok) {
-            const body = await res.text().catch(() => "");
-            throw new Error(`MadeOnSol API error ${res.status}: ${body}`);
-        }
-        return res.json();
-    }
-    /** Real-time KOL trade feed from 946+ tracked wallets. ($0.005/req) */
-    async kolFeed(params) {
-        return this.request("/api/x402/kol/feed", params);
-    }
-    /** KOL convergence signals — tokens being accumulated by multiple KOLs. ($0.02/req) */
-    async kolCoordination(params) {
-        return this.request("/api/x402/kol/coordination", params);
-    }
-    /** KOL performance rankings by PnL and win rate. ($0.005/req) */
-    async kolLeaderboard(params) {
-        return this.request("/api/x402/kol/leaderboard", params);
-    }
-    /** Real-time alerts from elite Pump.fun deployers. ($0.01/req) */
-    async deployerAlerts(params) {
-        return this.request("/api/x402/deployer-hunter/alerts", params);
-    }
-    /** Free discovery endpoint — lists all available endpoints and prices. */
-    async discovery() {
-        const res = await fetch(new URL("/api/x402", this.baseUrl).toString());
-        if (!res.ok)
-            throw new Error(`Discovery failed: ${res.status}`);
-        return res.json();
-    }
-}
-/** Convenience factory — creates a ready-to-use client. */
-export function createClient(privateKey, baseUrl) {
-    return new MadeOnSolX402({ privateKey, baseUrl });
-}
+const DEFAULT_BASE_URL = "https://madeonsol.com";
+export class MadeOnSolX402 {
+    paidFetch;
+    baseUrl;
+    ready;
+    constructor(opts) {
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+        this.ready = this.init(opts.privateKey);
+    }
+    async init(privateKey) {
+        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));
+        this.paidFetch = wrapFetchWithPayment(fetch, client);
+    }
+    async request(path, params) {
+        await this.ready;
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, String(v));
+            }
+        }
+        const res = await this.paidFetch(url.toString());
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new Error(`MadeOnSol API error ${res.status}: ${body}`);
+        }
+        return res.json();
+    }
+    /** Real-time KOL trade feed from 946+ tracked wallets. ($0.005/req) */
+    async kolFeed(params) {
+        return this.request("/api/x402/kol/feed", params);
+    }
+    /** KOL convergence signals — tokens being accumulated by multiple KOLs. ($0.02/req) */
+    async kolCoordination(params) {
+        return this.request("/api/x402/kol/coordination", params);
+    }
+    /** KOL performance rankings by PnL and win rate. ($0.005/req) */
+    async kolLeaderboard(params) {
+        return this.request("/api/x402/kol/leaderboard", params);
+    }
+    /** Real-time alerts from elite Pump.fun deployers. ($0.01/req) */
+    async deployerAlerts(params) {
+        return this.request("/api/x402/deployer-hunter/alerts", params);
+    }
+    /** Free discovery endpoint — lists all available endpoints and prices. */
+    async discovery() {
+        const res = await fetch(new URL("/api/x402", this.baseUrl).toString());
+        if (!res.ok)
+            throw new Error(`Discovery failed: ${res.status}`);
+        return res.json();
+    }
+}
+/** Convenience factory — creates a ready-to-use client. */
+export function createClient(privateKey, baseUrl) {
+    return new MadeOnSolX402({ privateKey, baseUrl });
+}
 //# sourceMappingURL=index.js.map

package/dist/types.d.ts

@@ -1,126 +1,126 @@
-export interface KolTrade {
-    wallet_address: string;
-    kol_name: string | null;
-    kol_twitter: string | null;
-    token_mint: string;
-    token_name: string | null;
-    token_symbol: string | null;
-    action: "buy" | "sell";
-    sol_amount: number;
-    token_amount: number;
-    tx_signature: string;
-    deployer?: {
-        wallet: string;
-        tier: string;
-        bonding_rate: number | null;
-    };
-    traded_at: string;
-}
-export interface KolFeedResponse {
-    trades: KolTrade[];
-    count: number;
-}
-export interface KolFeedParams {
-    limit?: number;
-    action?: "buy" | "sell";
-    kol?: string;
-}
-export interface KolCoordinationToken {
-    token_mint: string;
-    token_symbol: string;
-    token_name: string;
-    kol_count: number;
-    total_buys: number;
-    total_sells: number;
-    net_sol_flow: number;
-    signal: "accumulating" | "distributing";
-    kols: {
-        name: string;
-        wallet: string;
-    }[];
-}
-export interface KolCoordinationResponse {
-    coordination: KolCoordinationToken[];
-    period: string;
-    min_kols: number;
-}
-export interface KolCoordinationParams {
-    period?: "1h" | "6h" | "24h" | "7d";
-    min_kols?: number;
-    limit?: number;
-}
-export interface KolLeaderboardEntry {
-    wallet_address: string;
-    name: string;
-    pnl_sol: number;
-    total_buy_sol: number;
-    total_sell_sol: number;
-    buy_count: number;
-    sell_count: number;
-    win_rate: number | null;
-}
-export interface KolLeaderboardResponse {
-    leaderboard: KolLeaderboardEntry[];
-    period: string;
-}
-export interface KolLeaderboardParams {
-    period?: "today" | "7d" | "30d";
-    limit?: number;
-}
-export interface DeployerAlert {
-    id: string;
-    token_mint: string;
-    token_name: string | null;
-    token_symbol: string | null;
-    alert_type: string;
-    title: string;
-    message: string;
-    priority: string;
-    created_at: string;
-    market_cap_at_alert: number | null;
-    deployers: {
-        wallet_address: string;
-        tier: string;
-        total_tokens_deployed: number;
-        total_bonded: number;
-        bonding_rate: number;
-        recent_outcomes: unknown;
-        recent_bond_rate: number;
-    };
-    kol_buys: {
-        count: number;
-        total_sol: number;
-        kols: string[];
-    } | null;
-}
-export interface DeployerAlertsResponse {
-    alerts: DeployerAlert[];
-    limit: number;
-    offset: number;
-}
-export interface DeployerAlertsParams {
-    since?: string;
-    limit?: number;
-    offset?: number;
-}
-export interface DiscoveryEndpoint {
-    path: string;
-    method: string;
-    price: string;
-    description: string;
-    params: Record<string, string>;
-}
-export interface DiscoveryResponse {
-    name: string;
-    description: string;
-    website: string;
-    x402Version: number;
-    payTo: string;
-    network: string;
-    paymentToken: string;
-    endpoints: DiscoveryEndpoint[];
-    docs: string;
-    totalKolsTracked: number;
-    totalDeployersTracked: string;
-}
+export interface KolTrade {
+    wallet_address: string;
+    kol_name: string | null;
+    kol_twitter: string | null;
+    token_mint: string;
+    token_name: string | null;
+    token_symbol: string | null;
+    action: "buy" | "sell";
+    sol_amount: number;
+    token_amount: number;
+    tx_signature: string;
+    deployer?: {
+        wallet: string;
+        tier: string;
+        bonding_rate: number | null;
+    };
+    traded_at: string;
+}
+export interface KolFeedResponse {
+    trades: KolTrade[];
+    count: number;
+}
+export interface KolFeedParams {
+    limit?: number;
+    action?: "buy" | "sell";
+    kol?: string;
+}
+export interface KolCoordinationToken {
+    token_mint: string;
+    token_symbol: string;
+    token_name: string;
+    kol_count: number;
+    total_buys: number;
+    total_sells: number;
+    net_sol_flow: number;
+    signal: "accumulating" | "distributing";
+    kols: {
+        name: string;
+        wallet: string;
+    }[];
+}
+export interface KolCoordinationResponse {
+    coordination: KolCoordinationToken[];
+    period: string;
+    min_kols: number;
+}
+export interface KolCoordinationParams {
+    period?: "1h" | "6h" | "24h" | "7d";
+    min_kols?: number;
+    limit?: number;
+}
+export interface KolLeaderboardEntry {
+    wallet_address: string;
+    name: string;
+    pnl_sol: number;
+    total_buy_sol: number;
+    total_sell_sol: number;
+    buy_count: number;
+    sell_count: number;
+    win_rate: number | null;
+}
+export interface KolLeaderboardResponse {
+    leaderboard: KolLeaderboardEntry[];
+    period: string;
+}
+export interface KolLeaderboardParams {
+    period?: "today" | "7d" | "30d";
+    limit?: number;
+}
+export interface DeployerAlert {
+    id: string;
+    token_mint: string;
+    token_name: string | null;
+    token_symbol: string | null;
+    alert_type: string;
+    title: string;
+    message: string;
+    priority: string;
+    created_at: string;
+    market_cap_at_alert: number | null;
+    deployers: {
+        wallet_address: string;
+        tier: string;
+        total_tokens_deployed: number;
+        total_bonded: number;
+        bonding_rate: number;
+        recent_outcomes: unknown;
+        recent_bond_rate: number;
+    };
+    kol_buys: {
+        count: number;
+        total_sol: number;
+        kols: string[];
+    } | null;
+}
+export interface DeployerAlertsResponse {
+    alerts: DeployerAlert[];
+    limit: number;
+    offset: number;
+}
+export interface DeployerAlertsParams {
+    since?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface DiscoveryEndpoint {
+    path: string;
+    method: string;
+    price: string;
+    description: string;
+    params: Record<string, string>;
+}
+export interface DiscoveryResponse {
+    name: string;
+    description: string;
+    website: string;
+    x402Version: number;
+    payTo: string;
+    network: string;
+    paymentToken: string;
+    endpoints: DiscoveryEndpoint[];
+    docs: string;
+    totalKolsTracked: number;
+    totalDeployersTracked: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -1,3 +1,3 @@
-/* ── KOL Feed ── */
-export {};
+/* ── KOL Feed ── */
+export {};
 //# sourceMappingURL=types.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "madeonsol-x402",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "x402 client SDK for MadeOnSol Solana KOL intelligence API",
   "type": "module",
   "main": "./dist/index.js",