@madeonsol/plugin-madeonsol 1.5.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +73 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,6 +4,20 @@ ElizaOS plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL trading int
4
4
 
5
5
  > Real-time Solana trading intelligence: track 1,000+ KOL wallets with <3s latency, score 6,700+ Pump.fun deployers by reputation, detect multi-KOL coordination signals, monitor any Solana wallet for swaps and transfers, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/developer](https://madeonsol.com/developer) — no credit card required.
6
6
 
7
+ > **New in 1.7.0** *(2026-05-12)* — **Account introspection + token scanner actions.** Two new actions: `meAction` (`GET_MADEONSOL_ACCOUNT`) reports the caller's tier, daily/burst quota, and webhook / copy-trade / coord-rule slot counts; `tokensListAction` (`LIST_MADEONSOL_TOKENS`) scans the Solana token universe by MC, liquidity, 1h momentum, and primary DEX. New client methods: `client.getMe()` and `client.getTokensList(params)`. Token responses now expose **velocity / MEV-share enrichment** fields. The `/tokens` scanner applies a default `min_liq=2000` so the agent isn't drowned in dust pools by default. `/token/{mint}` HTTP 400s now return structured `code` / `reason` / `example` / `docs` so the agent can self-correct bad mints. Deprecated `avg_entry_mc_usd` has been removed from all leaderboard payloads.
8
+
9
+ ## Quick start (10 seconds)
10
+
11
+ ```bash
12
+ npm install @madeonsol/plugin-madeonsol
13
+ ```
14
+
15
+ ```ts
16
+ import { madeOnSolPlugin } from "@madeonsol/plugin-madeonsol";
17
+ const agent = { plugins: [madeOnSolPlugin], settings: { MADEONSOL_API_KEY: "msk_..." } }; // free key: https://madeonsol.com/developer
18
+ // Then ask the agent: "What are KOLs buying right now?"
19
+ ```
20
+
7
21
  ## Authentication
8
22
 
9
23
  Three options (in priority order):
@@ -20,11 +34,13 @@ Gives your ElizaOS agent access to MadeOnSol's Solana intelligence API.
20
34
  | Action | Description |
21
35
  |--------|-------------|
22
36
  | `GET_KOL_FEED` | Real-time KOL trade feed (1,000+ wallets) |
23
- | `GET_KOL_COORDINATION` | Multi-KOL convergence signals |
37
+ | `GET_KOL_COORDINATION` | Multi-KOL convergence (v1.1 — peak-density, exits, 0-100 score) |
24
38
  | `GET_KOL_LEADERBOARD` | KOL PnL/win-rate rankings (180 days of history) |
25
39
  | `GET_DEPLOYER_ALERTS` | Pump.fun deployer alerts with KOL enrichment |
26
40
  | `WALLET_TRACKER_WATCHLIST` | List your tracked wallets and remaining capacity |
27
41
  | `WALLET_TRACKER_TRADES` | Recent swaps and transfers from your watchlist |
42
+ | `GET_MADEONSOL_ACCOUNT` | Your tier, daily quota, burst limit, and slot usage *(new in 1.7.0)* |
43
+ | `LIST_MADEONSOL_TOKENS` | Scan tokens by MC, liquidity, 1h momentum, primary DEX *(new in 1.7.0)* |
28
44
 
29
45
  ## Install
30
46
 
@@ -51,6 +67,57 @@ const agent = {
51
67
  };
52
68
  ```
53
69
 
70
+ ### v1.1 Coordination alerts (programmatic)
71
+
72
+ The `GET_KOL_COORDINATION` action surfaces the v1.1 `coordination_score`, `peak_kols`, and `exited_count` fields. For **push alerts** (fires within ~1s of a qualifying trade via WS `kol:coordination` channel + HMAC-signed webhook), use the client directly from a custom action:
73
+
74
+ ```ts
75
+ import { MadeOnSolClient } from "@madeonsol/plugin-madeonsol";
76
+
77
+ const client = new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY });
78
+ const res = await client.coordinationAlertsCreate({
79
+ name: "fresh pump cluster",
80
+ min_kols: 4,
81
+ window_minutes: 15,
82
+ min_score: 70,
83
+ include_majors: false,
84
+ cooldown_min: 60,
85
+ score_jump_break: 10,
86
+ delivery_mode: "both",
87
+ webhook_url: "https://you.com/hooks/coord",
88
+ });
89
+ // store res.data.webhook_secret — shown ONCE
90
+ ```
91
+
92
+ PRO=5 rules, ULTRA=20. Also available: `coordinationAlertsList()`, `coordinationAlertsGet(id)`, `coordinationAlertsUpdate(id, updates)`, `coordinationAlertsDelete(id)`.
93
+
94
+ ### First-touch signal *(new in 1.3)*
95
+
96
+ Every "first KOL buy on a token mint" event — when a tracked KOL is the first of the cohort to touch a token. Filterable by **scout tier** (S/A/B/C from `mv_kol_scout_score`), KOL winrate, token age, mint suffix.
97
+
98
+ **Backtest:** S-tier scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline (38d / 491k buys).
99
+
100
+ ```ts
101
+ import { MadeOnSolClient } from "@madeonsol/plugin-madeonsol";
102
+ const client = new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY });
103
+
104
+ // REST query
105
+ const { events } = await client.firstTouches({ preset: "scout", min_scout_tier: "S", limit: 20 });
106
+
107
+ // Webhook subscription (Ultra) — push delivery, HMAC-signed
108
+ const { subscription, webhook_secret } = await client.firstTouchSubscriptionsCreate({
109
+ name: "S-tier scouts on pump tokens",
110
+ filters: { min_scout_tier: "S", mint_suffix: "pump" },
111
+ delivery_mode: "webhook",
112
+ webhook_url: "https://you.com/hooks/scout",
113
+ });
114
+ // store webhook_secret — shown ONCE
115
+ ```
116
+
117
+ ULTRA only for subscriptions — up to 10 active. CRUD: `firstTouchSubscriptionsList()`, `firstTouchSubscriptionsGet(id)`, `firstTouchSubscriptionsUpdate(id, updates)`, `firstTouchSubscriptionsDelete(id)`.
118
+
119
+ > **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches`.
120
+
54
121
  Your agent can then respond to queries like:
55
122
  - "What are KOLs buying right now?"
56
123
  - "Show me the KOL leaderboard this week"
@@ -63,17 +130,18 @@ Your agent can then respond to queries like:
63
130
 
64
131
  | Tier | Price | Wallets tracked | Requests/day |
65
132
  |------|-------|-----------------|--------------|
66
- | BASIC | Free | 10 | 200 |
67
- | PRO | $49/mo | 50 | 10,000 |
68
- | ULTRA | $149/mo | 100 + WS events | 100,000 |
133
+ | Free | $0 | 10 | 200 |
134
+ | Pro | $49/mo | 50 | 10,000 |
135
+ | Ultra | $149/mo | 100 + WS events | 100,000 |
69
136
 
70
- Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
137
+ Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
71
138
 
72
139
  ## Also Available
73
140
 
74
141
  | Platform | Package |
75
142
  |---|---|
76
143
  | TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
144
+ | Rust SDK | [`madeonsol`](https://crates.io/crates/madeonsol) on crates.io |
77
145
  | Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
78
146
  | MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) |
79
147
  | Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@madeonsol/plugin-madeonsol",
3
- "version": "1.5.0",
3
+ "version": "1.7.0",
4
4
  "description": "ElizaOS plugin for MadeOnSol — Solana KOL intelligence and deployer analytics via x402 micropayments",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",