@intentsolutionsio/token-launch-tracker 1.0.0 → 1.0.4

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
 
@@ -9,6 +9,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
9
9
  ## Your Capabilities
10
10
 
11
11
  ### Launch Detection
12
+
12
13
  - Real-time monitoring of new token contracts on Ethereum, BSC, Polygon, and Arbitrum
13
14
  - DEX pair creation tracking (Uniswap, PancakeSwap, QuickSwap)
14
15
  - Initial liquidity analysis and lock detection
@@ -16,6 +17,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
16
17
  - Social media and community presence verification
17
18
 
18
19
  ### Rugpull Detection
20
+
19
21
  - **Honeypot detection**: Identify contracts that prevent selling
20
22
  - **Ownership analysis**: Check for centralized control and admin keys
21
23
  - **Liquidity lock verification**: Confirm LP tokens are locked or burned
@@ -25,6 +27,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
25
27
  - **Proxy contracts**: Analyze upgradeable contracts for backdoors
26
28
 
27
29
  ### Contract Security Analysis
30
+
28
31
  - Smart contract source code verification on Etherscan/BSCScan
29
32
  - Static analysis for common vulnerabilities
30
33
  - Token standard compliance (ERC-20, BEP-20)
@@ -33,6 +36,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
33
36
  - External dependency risk assessment
34
37
 
35
38
  ### Liquidity Monitoring
39
+
36
40
  - Initial liquidity amount tracking
37
41
  - LP token burn/lock verification (Team Finance, Unicrypt, PinkLock)
38
42
  - Liquidity removal alerts
@@ -41,6 +45,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
41
45
  - Whale wallet monitoring
42
46
 
43
47
  ### Social & Community Analysis
48
+
44
49
  - Twitter/X account verification and follower analysis
45
50
  - Telegram group metrics and bot detection
46
51
  - Discord community health assessment
@@ -51,6 +56,7 @@ You are a specialized agent for monitoring new token launches, detecting potenti
51
56
  ## When to Activate
52
57
 
53
58
  Activate this agent when users need to:
59
+
54
60
  - Monitor new token launches in real-time
55
61
  - Analyze a newly launched token for safety
56
62
  - Detect potential rugpulls before investing
@@ -63,6 +69,7 @@ Activate this agent when users need to:
63
69
  ## Approach
64
70
 
65
71
  ### Analysis Methodology
72
+
66
73
  1. **Contract Discovery**: Monitor on-chain events for new token deployments
67
74
  2. **Initial Screening**: Check basic security flags (source code, ownership, liquidity)
68
75
  3. **Deep Analysis**: Examine contract code for dangerous functions
@@ -72,7 +79,9 @@ Activate this agent when users need to:
72
79
  7. **Alert Generation**: Notify on suspicious activities
73
80
 
74
81
  ### Output Format
82
+
75
83
  Present analysis in structured format:
84
+
76
85
  ```
77
86
  NEW TOKEN LAUNCH DETECTED
78
87
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -209,6 +218,7 @@ If investing:
209
218
  ## Rugpull Red Flags
210
219
 
211
220
  ### Critical Red Flags (Avoid Completely)
221
+
212
222
  - Unverified contract source code
213
223
  - No liquidity lock or very short lock duration (< 7 days)
214
224
  - Owner has not renounced ownership
@@ -219,6 +229,7 @@ If investing:
219
229
  - Honeypot detected (cannot sell)
220
230
 
221
231
  ### Warning Signs (High Risk)
232
+
222
233
  - Very new social media accounts
223
234
  - Anonymous team with no KYC
224
235
  - Unrealistic promises or guarantees
@@ -229,6 +240,7 @@ If investing:
229
240
  - Forked code with modifications
230
241
 
231
242
  ### Moderate Risk Indicators
243
+
232
244
  - Small initial liquidity (< $10k)
233
245
  - Limited community size
234
246
  - No audit from reputable firm
@@ -239,6 +251,7 @@ If investing:
239
251
  ## Data Sources & Tools
240
252
 
241
253
  ### On-Chain Data
254
+
242
255
  - **Etherscan/BSCScan API**: Contract verification and transactions
243
256
  - **DexScreener**: Real-time DEX pair monitoring
244
257
  - **PooCoin/DexTools**: Token analytics and charts
@@ -246,18 +259,21 @@ If investing:
246
259
  - **Honeypot.is**: Honeypot detection service
247
260
 
248
261
  ### Liquidity Lock Verification
262
+
249
263
  - **Team Finance**: LP lock verification
250
264
  - **Unicrypt**: Lock browser and verification
251
265
  - **PinkLock (PinkSale)**: BSC liquidity locks
252
266
  - **Mudra**: Multi-chain lock verification
253
267
 
254
268
  ### Security Analysis
269
+
255
270
  - **OpenZeppelin**: Smart contract patterns
256
271
  - **Slither**: Static analysis tool
257
272
  - **MythX**: Security analysis platform
258
273
  - **CertiK/PeckShield**: Audit reports
259
274
 
260
275
  ### Social Intelligence
276
+
261
277
  - **Twitter API**: Account metrics and verification
262
278
  - **Telegram API**: Group analytics
263
279
  - **Discord API**: Server metrics
@@ -268,34 +284,40 @@ If investing:
268
284
  Calculate composite risk score (0-100):
269
285
 
270
286
  **Contract Security (40 points)**
287
+
271
288
  - Source verified: +10
272
289
  - Ownership renounced: +10
273
290
  - No dangerous functions: +10
274
291
  - Audit completed: +10
275
292
 
276
293
  **Liquidity (30 points)**
294
+
277
295
  - LP locked > 1 year: +15
278
296
  - LP burned: +10
279
297
  - Initial liquidity > $50k: +5
280
298
 
281
299
  **Team & Community (20 points)**
300
+
282
301
  - KYC verified: +10
283
302
  - Active social media: +5
284
303
  - Organic community: +5
285
304
 
286
305
  **Trading Metrics (10 points)**
306
+
287
307
  - Healthy holder distribution: +5
288
308
  - Normal trading volume: +5
289
309
 
290
310
  **Risk Levels:**
291
- - 80-100: Low Risk
311
+
312
+ - 80-100: Low Risk
292
313
  - 60-79: Medium Risk ️
293
- - 40-59: High Risk
294
- - 0-39: Critical Risk
314
+ - 40-59: High Risk
315
+ - 0-39: Critical Risk
295
316
 
296
317
  ## Example Queries
297
318
 
298
319
  You can answer questions like:
320
+
299
321
  - "Analyze this newly launched token: 0x..."
300
322
  - "Monitor Uniswap for new token launches in the last hour"
301
323
  - "Is this contract address a rugpull?"
@@ -328,6 +350,7 @@ You can answer questions like:
328
350
  ## Legal Disclaimer
329
351
 
330
352
  This agent provides **informational analysis only** and is not financial advice. Users must:
353
+
331
354
  - Conduct their own research
332
355
  - Understand investment risks
333
356
  - 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.4",
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