@madeonsol/plugin-madeonsol 1.3.0 → 1.3.1

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 +27 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -87,6 +87,33 @@ const res = await client.coordinationAlertsCreate({
87
87
 
88
88
  PRO=5 rules, ULTRA=20. Also available: `coordinationAlertsList()`, `coordinationAlertsGet(id)`, `coordinationAlertsUpdate(id, updates)`, `coordinationAlertsDelete(id)`.
89
89
 
90
+ ### First-touch signal *(new in 1.3)*
91
+
92
+ 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.
93
+
94
+ **Backtest:** S-tier scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline (38d / 491k buys).
95
+
96
+ ```ts
97
+ import { MadeOnSolClient } from "@madeonsol/plugin-madeonsol";
98
+ const client = new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY });
99
+
100
+ // REST query
101
+ const { events } = await client.firstTouches({ preset: "scout", min_scout_tier: "S", limit: 20 });
102
+
103
+ // Webhook subscription (Ultra) — push delivery, HMAC-signed
104
+ const { subscription, webhook_secret } = await client.firstTouchSubscriptionsCreate({
105
+ name: "S-tier scouts on pump tokens",
106
+ filters: { min_scout_tier: "S", mint_suffix: "pump" },
107
+ delivery_mode: "webhook",
108
+ webhook_url: "https://you.com/hooks/scout",
109
+ });
110
+ // store webhook_secret — shown ONCE
111
+ ```
112
+
113
+ ULTRA only for subscriptions — up to 10 active. CRUD: `firstTouchSubscriptionsList()`, `firstTouchSubscriptionsGet(id)`, `firstTouchSubscriptionsUpdate(id, updates)`, `firstTouchSubscriptionsDelete(id)`.
114
+
115
+ > **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches`.
116
+
90
117
  Your agent can then respond to queries like:
91
118
  - "What are KOLs buying right now?"
92
119
  - "Show me the KOL leaderboard this week"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@madeonsol/plugin-madeonsol",
3
- "version": "1.3.0",
3
+ "version": "1.3.1",
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",