@intentsolutionsio/token-launch-tracker 1.0.0 → 1.0.7

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.
package/README.md CHANGED
@@ -20,6 +20,7 @@ Track new token launches, detect rugpulls, and analyze smart contract security f
20
20
  ## Usage
21
21
 
22
22
  The launch tracker agent automatically activates when you discuss:
23
+
23
24
  - New token launches and analysis
24
25
  - Rugpull detection and scam identification
25
26
  - Contract security verification
@@ -45,6 +46,7 @@ What are the safest new token launches today?
45
46
  ## Risk Assessment
46
47
 
47
48
  ### Critical Red Flags (Avoid)
49
+
48
50
  - Unverified contract source code
49
51
  - No liquidity lock
50
52
  - Owner has not renounced
@@ -53,6 +55,7 @@ What are the safest new token launches today?
53
55
  - No social media presence
54
56
 
55
57
  ### Warning Signs (High Risk)
58
+
56
59
  - Very new social accounts
57
60
  - Anonymous team, no KYC
58
61
  - Short liquidity lock (< 30 days)
@@ -60,11 +63,12 @@ What are the safest new token launches today?
60
63
  - Paid promotion only
61
64
 
62
65
  ### Safety Indicators
63
- - Contract verified
64
- - Liquidity locked > 1 year
65
- - Ownership renounced
66
- - Audit completed
67
- - Active community
66
+
67
+ - Contract verified
68
+ - Liquidity locked > 1 year
69
+ - Ownership renounced
70
+ - Audit completed
71
+ - Active community
68
72
 
69
73
  ## Configuration
70
74
 
@@ -94,30 +98,35 @@ Create a `.token-launch-config.json` file:
94
98
  ## Risk Scoring System
95
99
 
96
100
  **Contract Security (40 points)**
101
+
97
102
  - Verified source code
98
103
  - Ownership renounced
99
104
  - No dangerous functions
100
105
  - Audit completed
101
106
 
102
107
  **Liquidity (30 points)**
108
+
103
109
  - LP locked > 1 year
104
110
  - LP burned
105
111
  - Initial liquidity > $50k
106
112
 
107
113
  **Team & Community (20 points)**
114
+
108
115
  - KYC verified
109
116
  - Active socials
110
117
  - Organic community
111
118
 
112
119
  **Trading Metrics (10 points)**
120
+
113
121
  - Healthy distribution
114
122
  - Normal volume
115
123
 
116
124
  **Risk Levels:**
117
- - 80-100: Low Risk
125
+
126
+ - 80-100: Low Risk
118
127
  - 60-79: Medium Risk ️
119
- - 40-59: High Risk
120
- - 0-39: Critical Risk
128
+ - 40-59: High Risk
129
+ - 0-39: Critical Risk
121
130
 
122
131
  ## Data Sources
123
132
 
@@ -140,6 +149,7 @@ Create a `.token-launch-config.json` file:
140
149
  ️ **This plugin provides informational analysis only** and is NOT financial advice.
141
150
 
142
151
  Users must:
152
+
143
153
  - Conduct their own research (DYOR)
144
154
  - Understand investment risks
145
155
  - Only invest what they can afford to lose
@@ -155,7 +165,7 @@ MIT License - See LICENSE file for details
155
165
  ## Support
156
166
 
157
167
  - GitHub Issues: [Report bugs](https://github.com/jeremylongshore/claude-code-plugins/issues)
158
- - Documentation: [Full docs](https://docs.claude-code-plugins.com)
168
+ - Documentation: Full docs
159
169
 
160
170
  ---
161
171
 
@@ -1,6 +1,35 @@
1
1
  ---
2
2
  name: launch-tracker-agent
3
3
  description: New token launch monitoring and rugpull detection specialist
4
+ tools:
5
+ - Read
6
+ - Write
7
+ - Edit
8
+ - Bash
9
+ - Glob
10
+ - Grep
11
+ - WebFetch
12
+ - WebSearch
13
+ - Task
14
+ - TodoWrite
15
+ model: sonnet
16
+ color: green
17
+ version: 1.0.0
18
+ author: Jeremy Longshore <jeremy@intentsolutions.io>
19
+ tags:
20
+ - crypto
21
+ - launch
22
+ - tracker
23
+ disallowedTools: []
24
+ skills: []
25
+ background: false
26
+ # ── upgrade levers — uncomment + set when tuning this agent ──
27
+ # effort: high # reasoning depth: low/medium/high/xhigh/max (omit = inherit session)
28
+ # maxTurns: 50 # cap the agentic loop (omit = engine default)
29
+ # memory: project # persistent scope: user/project/local (omit = ephemeral)
30
+ # isolation: worktree # run in an isolated git worktree
31
+ # initialPrompt: "…" # seed the agent's first turn
32
+ # hooks / mcpServers / permissionMode → set at the PLUGIN level, not on a plugin agent
4
33
  ---
5
34
  # Token Launch Tracker Agent
6
35
 
@@ -9,6 +38,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
9
38
  ## Your Capabilities
10
39
 
11
40
  ### Launch Detection
41
+
12
42
  - Real-time monitoring of new token contracts on Ethereum, BSC, Polygon, and Arbitrum
13
43
  - DEX pair creation tracking (Uniswap, PancakeSwap, QuickSwap)
14
44
  - Initial liquidity analysis and lock detection
@@ -16,6 +46,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
16
46
  - Social media and community presence verification
17
47
 
18
48
  ### Rugpull Detection
49
+
19
50
  - **Honeypot detection**: Identify contracts that prevent selling
20
51
  - **Ownership analysis**: Check for centralized control and admin keys
21
52
  - **Liquidity lock verification**: Confirm LP tokens are locked or burned
@@ -25,6 +56,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
25
56
  - **Proxy contracts**: Analyze upgradeable contracts for backdoors
26
57
 
27
58
  ### Contract Security Analysis
59
+
28
60
  - Smart contract source code verification on Etherscan/BSCScan
29
61
  - Static analysis for common vulnerabilities
30
62
  - Token standard compliance (ERC-20, BEP-20)
@@ -33,6 +65,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
33
65
  - External dependency risk assessment
34
66
 
35
67
  ### Liquidity Monitoring
68
+
36
69
  - Initial liquidity amount tracking
37
70
  - LP token burn/lock verification (Team Finance, Unicrypt, PinkLock)
38
71
  - Liquidity removal alerts
@@ -41,6 +74,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
41
74
  - Whale wallet monitoring
42
75
 
43
76
  ### Social & Community Analysis
77
+
44
78
  - Twitter/X account verification and follower analysis
45
79
  - Telegram group metrics and bot detection
46
80
  - Discord community health assessment
@@ -51,6 +85,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
51
85
  ## When to Activate
52
86
 
53
87
  Activate this agent when users need to:
88
+
54
89
  - Monitor new token launches in real-time
55
90
  - Analyze a newly launched token for safety
56
91
  - Detect potential rugpulls before investing
@@ -63,6 +98,7 @@ Activate this agent when users need to:
63
98
  ## Approach
64
99
 
65
100
  ### Analysis Methodology
101
+
66
102
  1. **Contract Discovery**: Monitor on-chain events for new token deployments
67
103
  2. **Initial Screening**: Check basic security flags (source code, ownership, liquidity)
68
104
  3. **Deep Analysis**: Examine contract code for dangerous functions
@@ -72,7 +108,9 @@ Activate this agent when users need to:
72
108
  7. **Alert Generation**: Notify on suspicious activities
73
109
 
74
110
  ### Output Format
111
+
75
112
  Present analysis in structured format:
113
+
76
114
  ```
77
115
  NEW TOKEN LAUNCH DETECTED
78
116
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -209,6 +247,7 @@ If investing:
209
247
  ## Rugpull Red Flags
210
248
 
211
249
  ### Critical Red Flags (Avoid Completely)
250
+
212
251
  - Unverified contract source code
213
252
  - No liquidity lock or very short lock duration (< 7 days)
214
253
  - Owner has not renounced ownership
@@ -219,6 +258,7 @@ If investing:
219
258
  - Honeypot detected (cannot sell)
220
259
 
221
260
  ### Warning Signs (High Risk)
261
+
222
262
  - Very new social media accounts
223
263
  - Anonymous team with no KYC
224
264
  - Unrealistic promises or guarantees
@@ -229,6 +269,7 @@ If investing:
229
269
  - Forked code with modifications
230
270
 
231
271
  ### Moderate Risk Indicators
272
+
232
273
  - Small initial liquidity (< $10k)
233
274
  - Limited community size
234
275
  - No audit from reputable firm
@@ -239,6 +280,7 @@ If investing:
239
280
  ## Data Sources & Tools
240
281
 
241
282
  ### On-Chain Data
283
+
242
284
  - **Etherscan/BSCScan API**: Contract verification and transactions
243
285
  - **DexScreener**: Real-time DEX pair monitoring
244
286
  - **PooCoin/DexTools**: Token analytics and charts
@@ -246,18 +288,21 @@ If investing:
246
288
  - **Honeypot.is**: Honeypot detection service
247
289
 
248
290
  ### Liquidity Lock Verification
291
+
249
292
  - **Team Finance**: LP lock verification
250
293
  - **Unicrypt**: Lock browser and verification
251
294
  - **PinkLock (PinkSale)**: BSC liquidity locks
252
295
  - **Mudra**: Multi-chain lock verification
253
296
 
254
297
  ### Security Analysis
298
+
255
299
  - **OpenZeppelin**: Smart contract patterns
256
300
  - **Slither**: Static analysis tool
257
301
  - **MythX**: Security analysis platform
258
302
  - **CertiK/PeckShield**: Audit reports
259
303
 
260
304
  ### Social Intelligence
305
+
261
306
  - **Twitter API**: Account metrics and verification
262
307
  - **Telegram API**: Group analytics
263
308
  - **Discord API**: Server metrics
@@ -268,34 +313,40 @@ If investing:
268
313
  Calculate composite risk score (0-100):
269
314
 
270
315
  **Contract Security (40 points)**
316
+
271
317
  - Source verified: +10
272
318
  - Ownership renounced: +10
273
319
  - No dangerous functions: +10
274
320
  - Audit completed: +10
275
321
 
276
322
  **Liquidity (30 points)**
323
+
277
324
  - LP locked > 1 year: +15
278
325
  - LP burned: +10
279
326
  - Initial liquidity > $50k: +5
280
327
 
281
328
  **Team & Community (20 points)**
329
+
282
330
  - KYC verified: +10
283
331
  - Active social media: +5
284
332
  - Organic community: +5
285
333
 
286
334
  **Trading Metrics (10 points)**
335
+
287
336
  - Healthy holder distribution: +5
288
337
  - Normal trading volume: +5
289
338
 
290
339
  **Risk Levels:**
291
- - 80-100: Low Risk
340
+
341
+ - 80-100: Low Risk
292
342
  - 60-79: Medium Risk ️
293
- - 40-59: High Risk
294
- - 0-39: Critical Risk
343
+ - 40-59: High Risk
344
+ - 0-39: Critical Risk
295
345
 
296
346
  ## Example Queries
297
347
 
298
348
  You can answer questions like:
349
+
299
350
  - "Analyze this newly launched token: 0x..."
300
351
  - "Monitor Uniswap for new token launches in the last hour"
301
352
  - "Is this contract address a rugpull?"
@@ -328,6 +379,7 @@ You can answer questions like:
328
379
  ## Legal Disclaimer
329
380
 
330
381
  This agent provides **informational analysis only** and is not financial advice. Users must:
382
+
331
383
  - Conduct their own research
332
384
  - Understand investment risks
333
385
  - Only invest what they can afford to lose
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@intentsolutionsio/token-launch-tracker",
3
- "version": "1.0.0",
3
+ "version": "1.0.7",
4
4
  "description": "Track new token launches, detect rugpulls, and analyze contract security for early-stage crypto projects",
5
5
  "keywords": [
6
6
  "crypto",
@@ -1,4 +1,3 @@
1
1
  # References
2
2
 
3
3
  Bundled resources for token-launch-tracker skill
4
-
@@ -7,11 +7,13 @@ This document provides practical examples of how to use this skill effectively.
7
7
  ### Example 1: Simple Activation
8
8
 
9
9
  **User Request:**
10
+
10
11
  ```
11
12
  [Describe trigger phrase here]
12
13
  ```
13
14
 
14
15
  **Skill Response:**
16
+
15
17
  1. Analyzes the request
16
18
  2. Performs the required action
17
19
  3. Returns results
@@ -19,11 +21,13 @@ This document provides practical examples of how to use this skill effectively.
19
21
  ### Example 2: Complex Workflow
20
22
 
21
23
  **User Request:**
24
+
22
25
  ```
23
26
  [Describe complex scenario]
24
27
  ```
25
28
 
26
29
  **Workflow:**
30
+
27
31
  1. Step 1: Initial analysis
28
32
  2. Step 2: Data processing
29
33
  3. Step 3: Result generation
@@ -34,6 +38,7 @@ This document provides practical examples of how to use this skill effectively.
34
38
  ### Pattern 1: Chaining Operations
35
39
 
36
40
  Combine this skill with other tools:
41
+
37
42
  ```
38
43
  Step 1: Use this skill for [purpose]
39
44
  Step 2: Chain with [other tool]
@@ -43,6 +48,7 @@ Step 3: Finalize with [action]
43
48
  ### Pattern 2: Error Handling
44
49
 
45
50
  If issues occur:
51
+
46
52
  - Check trigger phrase matches
47
53
  - Verify context is available
48
54
  - Review allowed-tools permissions
@@ -54,20 +54,24 @@ skills/tracking-token-launches/
54
54
  ## API Integration
55
55
 
56
56
  ### Ethereum RPC (eth_getLogs)
57
+
57
58
  - **Events**: PairCreated, Transfer, Mint
58
59
  - **Data**: New pair address, token addresses, reserves
59
60
 
60
61
  ### DexScreener API
62
+
61
63
  - **Endpoint**: `https://api.dexscreener.com/latest/dex/tokens/{address}`
62
64
  - **Data**: Price, liquidity, volume, pair info
63
65
 
64
66
  ### GeckoTerminal API
67
+
65
68
  - **Endpoint**: `https://api.geckoterminal.com/api/v2/`
66
69
  - **Data**: New pools, token info, trading data
67
70
 
68
71
  ## Component Design
69
72
 
70
73
  ### event_monitor.py
74
+
71
75
  ```python
72
76
  class EventMonitor:
73
77
  def get_recent_pairs(chain, dex, hours) -> List[PairCreated]
@@ -76,6 +80,7 @@ class EventMonitor:
76
80
  ```
77
81
 
78
82
  ### token_analyzer.py
83
+
79
84
  ```python
80
85
  class TokenAnalyzer:
81
86
  def get_token_info(address) -> TokenInfo
@@ -85,6 +90,7 @@ class TokenAnalyzer:
85
90
  ```
86
91
 
87
92
  ### dex_sources.py
93
+
88
94
  ```python
89
95
  # DEX factory addresses per chain
90
96
  DEX_FACTORIES = {
@@ -100,6 +106,7 @@ DEX_FACTORIES = {
100
106
  ## Data Structures
101
107
 
102
108
  ### PairCreated Event
109
+
103
110
  ```python
104
111
  @dataclass
105
112
  class PairCreated:
@@ -113,6 +120,7 @@ class PairCreated:
113
120
  ```
114
121
 
115
122
  ### TokenInfo
123
+
116
124
  ```python
117
125
  @dataclass
118
126
  class TokenInfo:
@@ -126,6 +134,7 @@ class TokenInfo:
126
134
  ```
127
135
 
128
136
  ### ContractAnalysis
137
+
129
138
  ```python
130
139
  @dataclass
131
140
  class ContractAnalysis:
@@ -36,17 +36,20 @@ New token launches happen constantly across multiple chains and DEXes. Traders m
36
36
  ## Data Sources
37
37
 
38
38
  ### On-Chain Detection
39
+
39
40
  - Factory contract events (PairCreated)
40
41
  - Token deployment transactions
41
42
  - Liquidity mint events
42
43
 
43
44
  ### IDO/IEO Platforms
45
+
44
46
  - CoinList
45
47
  - Pinksale
46
48
  - DxSale
47
49
  - Unicrypt
48
50
 
49
51
  ### Aggregators
52
+
50
53
  - DEXTools
51
54
  - DexScreener
52
55
  - GeckoTerminal
@@ -1,17 +1,24 @@
1
1
  ---
2
2
  name: tracking-token-launches
3
- description: |
4
- Track new token launches across DEXes with risk analysis and contract verification.
3
+ description: 'Track new token launches across DEXes with risk analysis and contract
4
+ verification.
5
+
5
6
  Use when discovering new token launches, monitoring IDOs, or analyzing token contracts.
7
+
6
8
  Trigger with phrases like "track launches", "find new tokens", "new pairs on uniswap",
9
+
7
10
  "token risk analysis", or "monitor IDOs".
8
11
 
12
+ '
9
13
  allowed-tools: Read, Write, Edit, Grep, Glob, Bash(python:*launch_tracker*)
10
14
  version: 1.0.0
11
15
  author: Jeremy Longshore <jeremy@intentsolutions.io>
12
16
  license: MIT
13
- compatible-with: claude-code, codex, openclaw
14
- tags: [crypto, monitoring, tracking-token]
17
+ tags:
18
+ - crypto
19
+ - monitoring
20
+ - tracking-token
21
+ compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
15
22
  ---
16
23
  # Token Launch Tracker
17
24
 
@@ -22,6 +29,7 @@ Monitor new token launches across decentralized exchanges. Detect PairCreated ev
22
29
  ## Prerequisites
23
30
 
24
31
  Before using this skill, ensure you have:
32
+
25
33
  - Python 3.8+ with `requests` library
26
34
  - RPC endpoint access (public endpoints work for basic usage)
27
35
  - Optional: Etherscan API key for contract verification checks
@@ -30,6 +38,7 @@ Before using this skill, ensure you have:
30
38
  ## Commands
31
39
 
32
40
  ### recent - Show Recent Launches
41
+
33
42
  ```bash
34
43
  python launch_tracker.py recent --chain ethereum --hours 24
35
44
  python launch_tracker.py recent --chain base --analyze --limit 20
@@ -37,6 +46,7 @@ python launch_tracker.py recent --chain bsc --dex "PancakeSwap V2" -f json
37
46
  ```
38
47
 
39
48
  Options:
49
+
40
50
  - `--chain, -c`: Chain to scan (ethereum, bsc, arbitrum, base, polygon)
41
51
  - `--hours, -H`: Hours to look back (default: 24)
42
52
  - `--dex, -d`: Filter by DEX name
@@ -45,22 +55,26 @@ Options:
45
55
  - `--rpc-url`: Custom RPC URL
46
56
 
47
57
  ### detail - Token Details
58
+
48
59
  ```bash
49
60
  python launch_tracker.py detail --address 0x... --chain ethereum
50
61
  ```
51
62
 
52
63
  Options:
64
+
53
65
  - `--address, -a`: Token contract address (required)
54
66
  - `--chain, -c`: Chain (default: ethereum)
55
67
  - `--pair, -p`: Pair address (optional)
56
68
  - `--etherscan-key`: API key for verification check
57
69
 
58
70
  ### risk - Risk Analysis
71
+
59
72
  ```bash
60
73
  python launch_tracker.py risk --address 0x... --chain base
61
74
  ```
62
75
 
63
76
  Analyzes contract for risk indicators:
77
+
64
78
  - Mint function (HIGH risk)
65
79
  - Proxy contract (MEDIUM risk)
66
80
  - Not verified (MEDIUM risk)
@@ -68,17 +82,20 @@ Analyzes contract for risk indicators:
68
82
  - Active owner (LOW risk)
69
83
 
70
84
  ### summary - Launch Statistics
85
+
71
86
  ```bash
72
87
  python launch_tracker.py summary --hours 24
73
88
  python launch_tracker.py summary --chains ethereum,base,arbitrum
74
89
  ```
75
90
 
76
91
  ### dexes - List DEXes
92
+
77
93
  ```bash
78
94
  python launch_tracker.py dexes --chain bsc
79
95
  ```
80
96
 
81
97
  ### chains - List Chains
98
+
82
99
  ```bash
83
100
  python launch_tracker.py chains
84
101
  ```
@@ -86,27 +103,32 @@ python launch_tracker.py chains
86
103
  ## Instructions
87
104
 
88
105
  1. **Check recent launches** on a specific chain:
106
+
89
107
  ```bash
90
108
  cd ${CLAUDE_SKILL_DIR}/scripts
91
109
  python launch_tracker.py recent --chain ethereum --hours 6
92
110
  ```
93
111
 
94
112
  2. **Get detailed token info** for a specific address:
113
+
95
114
  ```bash
96
115
  python launch_tracker.py detail --address 0x6982508145454ce325ddbe47a25d4ec3d2311933 --chain ethereum
97
116
  ```
98
117
 
99
118
  3. **Analyze token risk** before interaction:
119
+
100
120
  ```bash
101
121
  python launch_tracker.py risk --address 0x... --chain base --etherscan-key YOUR_KEY
102
122
  ```
103
123
 
104
124
  4. **View cross-chain summary**:
125
+
105
126
  ```bash
106
127
  python launch_tracker.py summary --hours 24
107
128
  ```
108
129
 
109
130
  5. **Export to JSON** for programmatic use:
131
+
110
132
  ```bash
111
133
  python launch_tracker.py -f json recent --chain ethereum --analyze > launches.json
112
134
  ```
@@ -142,6 +164,7 @@ python launch_tracker.py chains
142
164
  ## Error Handling
143
165
 
144
166
  See `${CLAUDE_SKILL_DIR}/references/errors.md` for comprehensive error handling including:
167
+
145
168
  - RPC connection issues and fallback chain
146
169
  - Rate limiting and backoff strategies
147
170
  - Contract analysis edge cases
@@ -149,6 +172,7 @@ See `${CLAUDE_SKILL_DIR}/references/errors.md` for comprehensive error handling
149
172
  ## Examples
150
173
 
151
174
  See `${CLAUDE_SKILL_DIR}/references/examples.md` for detailed examples including:
175
+
152
176
  - Finding high-risk tokens
153
177
  - Multi-chain monitoring scripts
154
178
  - Python integration
@@ -156,6 +180,6 @@ See `${CLAUDE_SKILL_DIR}/references/examples.md` for detailed examples including
156
180
  ## Resources
157
181
 
158
182
  - [Uniswap V2 Factory](https://docs.uniswap.org/contracts/v2/reference/smart-contracts/factory)
159
- - [PancakeSwap Factory](https://docs.pancakeswap.finance/developers/smart-contracts)
183
+ - PancakeSwap Factory
160
184
  - [DEXScreener](https://dexscreener.com/) - Real-time pair data
161
- - [Etherscan API](https://docs.etherscan.io/) - Contract verification
185
+ - [Etherscan API](https://docs.etherscan.io/) - Contract verification