@intentsolutionsio/token-launch-tracker 1.0.0 → 1.0.4

package/skills/tracking-token-launches/references/errors.md

@@ -3,31 +3,40 @@
 ## RPC Connection Errors
 
 ### Connection Timeout
+
 ```
 Error: RPC connection timeout after 30s
 ```
+
 **Cause:** RPC endpoint is overloaded or unreachable.
 **Solution:**
+
 1. Try a different RPC URL with `--rpc-url`
 2. Use a backup RPC provider (Alchemy, Chainstack, Infura, or QuickNode)
 3. Reduce request frequency
 
 ### RPC Rate Limited
+
 ```
 Error: 429 Too Many Requests
 ```
+
 **Cause:** Exceeded RPC provider rate limits.
 **Solution:**
+
 1. Add delay between requests
 2. Upgrade to paid RPC tier
 3. Use multiple RPC endpoints with round-robin
 
 ### Invalid Chain
+
 ```
 Error: Unsupported chain: xyz
 ```
+
 **Cause:** Chain not in supported list.
 **Solution:**
+
 1. Use `python launch_tracker.py chains` to see supported chains
 2. Check spelling (lowercase required)
 3. Add custom chain config if needed
@@ -35,21 +44,27 @@ Error: Unsupported chain: xyz
 ## Event Parsing Errors
 
 ### No Pairs Found
+
 ```
 No new pairs found in the specified timeframe.
 ```
+
 **Cause:** No PairCreated events in time window.
 **Solution:**
+
 1. Extend the time window with `--hours`
 2. Check if correct chain is selected
 3. Verify DEX is active on that chain
 
 ### Log Parsing Failed
+
 ```
 Error parsing log: list index out of range
 ```
+
 **Cause:** Unexpected event format (V3 vs V2).
 **Solution:**
+
 1. Check DEX version compatibility
 2. Verify factory address is correct
 3. Enable `--verbose` for debugging
@@ -57,31 +72,40 @@ Error parsing log: list index out of range
 ## Contract Analysis Errors
 
 ### Bytecode Not Found
+
 ```
 Error: Contract has no bytecode
 ```
+
 **Cause:** Address is not a contract (EOA) or wrong network.
 **Solution:**
+
 1. Verify address is a contract
 2. Check correct chain is selected
 3. Confirm address checksum
 
 ### ABI Decoding Failed
+
 ```
 Error decoding string: Unknown
 ```
+
 **Cause:** Non-standard ERC20 implementation.
 **Solution:**
+
 1. Use `--verbose` to see raw data
 2. Token may use bytes32 for name/symbol
 3. Some tokens have non-standard decimals
 
 ### Verification Check Failed
+
 ```
 Verification check error: API key invalid
 ```
+
 **Cause:** Etherscan API key issues.
 **Solution:**
+
 1. Set `ETHERSCAN_API_KEY` environment variable
 2. Use `--etherscan-key` flag
 3. Check API key is valid for that chain
@@ -89,21 +113,27 @@ Verification check error: API key invalid
 ## Token Analysis Errors
 
 ### Risk Analysis Incomplete
+
 ```
 Warning: Some risk indicators could not be checked
 ```
+
 **Cause:** Limited bytecode or API access.
 **Solution:**
+
 1. Check if contract is verified
 2. Provide Etherscan API key
 3. Some indicators require source code
 
 ### Proxy Detection Failed
+
 ```
 Warning: Could not determine if contract is proxy
 ```
+
 **Cause:** Storage slot access issue.
 **Solution:**
+
 1. Some RPCs don't support eth_getStorageAt
 2. Use a full node RPC
 3. Proxy detection is best-effort
@@ -111,21 +141,27 @@ Warning: Could not determine if contract is proxy
 ## Environment Errors
 
 ### Missing Dependencies
+
 ```
 ImportError: requests library required
 ```
+
 **Cause:** Python requests not installed.
 **Solution:**
+
 ```bash
 pip install requests
 ```
 
 ### Environment Variable Missing
+
 ```
 Error: No RPC URL configured
 ```
+
 **Cause:** Chain RPC URL not found.
 **Solution:**
+
 1. Set `{CHAIN}_RPC_URL` environment variable
 2. Use `--rpc-url` flag
 3. Check config/settings.yaml
@@ -153,11 +189,13 @@ The system uses this fallback chain for RPC failures:
 ## Debug Mode
 
 Enable verbose output for troubleshooting:
+
 ```bash
 python launch_tracker.py --verbose recent --chain ethereum
 ```
 
 This shows:
+
 - RPC requests being made
 - Raw response data
 - Parsing steps

package/skills/tracking-token-launches/references/examples.md

@@ -3,6 +3,7 @@
 ## Recent Token Launches
 
 ### Basic Usage
+
 ```bash
 # Show launches from last 24 hours on Ethereum
 python launch_tracker.py recent --chain ethereum
@@ -20,6 +21,7 @@ python launch_tracker.py recent --chain ethereum
 ```
 
 ### With Risk Analysis
+
 ```bash
 # Include token and contract analysis
 python launch_tracker.py recent --chain base --analyze --hours 12
@@ -28,12 +30,14 @@ python launch_tracker.py recent --chain base --analyze --hours 12
 ```
 
 ### Filter by DEX
+
 ```bash
 # Only show Uniswap V2 launches
 python launch_tracker.py recent --chain ethereum --dex "Uniswap V2"
 ```
 
 ### JSON Output
+
 ```bash
 # Get JSON for programmatic use
 python launch_tracker.py -f json recent --chain bsc --hours 6 --limit 10
@@ -42,6 +46,7 @@ python launch_tracker.py -f json recent --chain bsc --hours 6 --limit 10
 ## Token Details
 
 ### Get Full Token Information
+
 ```bash
 python launch_tracker.py detail \
   --address 0x6982508145454ce325ddbe47a25d4ec3d2311933 \
@@ -90,6 +95,7 @@ python launch_tracker.py detail \
 ## Risk Analysis
 
 ### Analyze Token Contract
+
 ```bash
 python launch_tracker.py risk \
   --address 0x1234567890abcdef1234567890abcdef12345678 \
@@ -125,6 +131,7 @@ python launch_tracker.py risk \
 ```
 
 ### With Etherscan Verification
+
 ```bash
 # Include contract verification check
 python launch_tracker.py risk \
@@ -136,6 +143,7 @@ python launch_tracker.py risk \
 ## Launch Summary
 
 ### Cross-Chain Summary
+
 ```bash
 python launch_tracker.py summary --hours 24
 
@@ -162,6 +170,7 @@ python launch_tracker.py summary --hours 24
 ```
 
 ### Specific Chains Only
+
 ```bash
 # Only Ethereum and Base
 python launch_tracker.py summary --chains ethereum,base --hours 12
@@ -170,6 +179,7 @@ python launch_tracker.py summary --chains ethereum,base --hours 12
 ## List DEXes and Chains
 
 ### Show Supported Chains
+
 ```bash
 python launch_tracker.py chains
 
@@ -187,6 +197,7 @@ python launch_tracker.py chains
 ```
 
 ### Show DEXes for Chain
+
 ```bash
 python launch_tracker.py dexes --chain bsc
 
@@ -201,6 +212,7 @@ python launch_tracker.py dexes --chain bsc
 ```
 
 ### All DEXes (JSON)
+
 ```bash
 python launch_tracker.py -f json dexes
 ```
@@ -208,6 +220,7 @@ python launch_tracker.py -f json dexes
 ## Custom RPC Usage
 
 ### Use Custom RPC Endpoint
+
 ```bash
 python launch_tracker.py recent \
   --chain ethereum \
@@ -215,6 +228,7 @@ python launch_tracker.py recent \
 ```
 
 ### Via Environment Variable
+
 ```bash
 export ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_PROJECT_ID
 python launch_tracker.py recent --chain ethereum
@@ -223,6 +237,7 @@ python launch_tracker.py recent --chain ethereum
 ## Verbose Output
 
 ### Debug Mode
+
 ```bash
 python launch_tracker.py --verbose recent --chain base --hours 1
 
@@ -238,6 +253,7 @@ python launch_tracker.py --verbose recent --chain base --hours 1
 ## Common Workflows
 
 ### Find High-Risk New Tokens
+
 ```bash
 # Get recent launches with analysis, output as JSON
 python launch_tracker.py -f json recent \
@@ -251,6 +267,7 @@ jq '.[] | select(.analysis.risk_score >= 70)' launches.json
 ```
 
 ### Monitor Multiple Chains
+
 ```bash
 #!/bin/bash
 for chain in ethereum bsc base arbitrum; do
@@ -260,6 +277,7 @@ done
 ```
 
 ### Export to CSV (via jq)
+
 ```bash
 python launch_tracker.py -f json recent --chain ethereum --hours 24 | \
   jq -r '.[] | [.pair.timestamp, .pair.dex, .token_info.symbol // "???", .analysis.risk_score // 0] | @csv'
@@ -268,6 +286,7 @@ python launch_tracker.py -f json recent --chain ethereum --hours 24 | \
 ## Integration Examples
 
 ### Python Import
+
 ```python
 from event_monitor import EventMonitor
 from token_analyzer import TokenAnalyzer

package/skills/tracking-token-launches/references/implementation.md

@@ -1,7 +1,9 @@
-# Implementation Guide
+## Implementation Guide
 
 ### Step 1: Configure Data Sources
+
 Set up connections to crypto data providers:
+
 1. Use Read tool to load API credentials from ${CLAUDE_SKILL_DIR}/config/crypto-apis.env
 2. Configure blockchain RPC endpoints for target networks
 3. Set up exchange API connections if required
@@ -9,7 +11,9 @@ Set up connections to crypto data providers:
 5. Test connectivity and authentication
 
 ### Step 2: Query Crypto Data
+
 Retrieve relevant blockchain and market data:
+
 1. Use Bash(crypto:launch-*) to execute crypto data queries
 2. Fetch real-time prices, volumes, and market cap data
 3. Query blockchain for on-chain metrics and transactions
@@ -17,7 +21,9 @@ Retrieve relevant blockchain and market data:
 5. Aggregate data from multiple sources for accuracy
 
 ### Step 3: Analyze and Process
+
 Process crypto data to generate insights:
+
 - Calculate key metrics (returns, volatility, correlation)
 - Identify patterns and anomalies in data
 - Apply technical indicators or on-chain signals
@@ -25,7 +31,9 @@ Process crypto data to generate insights:
 - Generate actionable insights and alerts
 
 ### Step 4: Generate Reports
+
 Document findings in ${CLAUDE_SKILL_DIR}/crypto-reports/:
+
 - Market summary with key price movements
 - Detailed analysis with charts and metrics
 - Trading signals or opportunity recommendations

package/skills/tracking-token-launches/scripts/dex_sources.py

@@ -19,6 +19,7 @@ PAIR_CREATED_TOPIC = "0x0d3648bd0f6ba80134a33ba9275ac585d9d315f0ad8355cddefde31a
 @dataclass
 class DexFactory:
     """DEX factory configuration."""
+
     name: str
     address: str
     version: str  # v2 or v3
@@ -28,6 +29,7 @@ class DexFactory:
 @dataclass
 class ChainConfig:
     """Chain configuration."""
+
     name: str
     chain_id: int
     rpc_url: str

package/skills/tracking-token-launches/scripts/event_monitor.py

@@ -31,6 +31,7 @@ from dex_sources import (
 @dataclass
 class PairCreated:
     """New trading pair event."""
+
     block_number: int
     tx_hash: str
     timestamp: int
@@ -45,6 +46,7 @@ class PairCreated:
 @dataclass
 class TokenBasicInfo:
     """Basic token info from RPC."""
+
     address: str
     name: str
     symbol: str
@@ -54,12 +56,7 @@ class TokenBasicInfo:
 class EventMonitor:
     """Monitor blockchain events for new pairs."""
 
-    def __init__(
-        self,
-        chain: str = "ethereum",
-        rpc_url: str = None,
-        verbose: bool = False
-    ):
+    def __init__(self, chain: str = "ethereum", rpc_url: str = None, verbose: bool = False):
         """Initialize event monitor.
 
         Args:
@@ -69,10 +66,7 @@ class EventMonitor:
         """
         self.chain = chain.lower()
         self.config = get_chain_config(chain)
-        self.rpc_url = rpc_url or os.environ.get(
-            f"{chain.upper()}_RPC_URL",
-            self.config.rpc_url
-        )
+        self.rpc_url = rpc_url or os.environ.get(f"{chain.upper()}_RPC_URL", self.config.rpc_url)
         self.verbose = verbose
         # Use a size-limited cache to prevent memory leaks on long-running instances
         # Keeps most recent 1000 block timestamps
@@ -111,10 +105,7 @@ class EventMonitor:
         if block_number in self._block_cache:
             return self._block_cache[block_number]
 
-        block = self._rpc_call(
-            "eth_getBlockByNumber",
-            [hex(block_number), False]
-        )
+        block = self._rpc_call("eth_getBlockByNumber", [hex(block_number), False])
 
         if block:
             timestamp = int(block.get("timestamp", "0x0"), 16)
@@ -136,11 +127,7 @@ class EventMonitor:
         result = self._rpc_call("eth_blockNumber")
         return int(result, 16)
 
-    def get_recent_pairs(
-        self,
-        hours: int = 24,
-        dex: str = None
-    ) -> List[PairCreated]:
+    def get_recent_pairs(self, hours: int = 24, dex: str = None) -> List[PairCreated]:
         """Get recently created pairs.
 
         Args:
@@ -168,12 +155,17 @@ class EventMonitor:
 
         for factory_addr in factory_addresses:
             try:
-                logs = self._rpc_call("eth_getLogs", [{
-                    "fromBlock": hex(from_block),
-                    "toBlock": "latest",
-                    "address": factory_addr,
-                    "topics": [PAIR_CREATED_TOPIC],
-                }])
+                logs = self._rpc_call(
+                    "eth_getLogs",
+                    [
+                        {
+                            "fromBlock": hex(from_block),
+                            "toBlock": "latest",
+                            "address": factory_addr,
+                            "topics": [PAIR_CREATED_TOPIC],
+                        }
+                    ],
+                )
 
                 for log in logs or []:
                     pair = self._parse_pair_created(log, factory_addr)
@@ -189,11 +181,7 @@ class EventMonitor:
 
         return pairs
 
-    def _parse_pair_created(
-        self,
-        log: Dict,
-        factory_address: str
-    ) -> Optional[PairCreated]:
+    def _parse_pair_created(self, log: Dict, factory_address: str) -> Optional[PairCreated]:
         """Parse PairCreated event log."""
         try:
             block_number = int(log["blockNumber"], 16)
@@ -265,10 +253,7 @@ class EventMonitor:
     def _call_contract(self, address: str, data: str) -> Optional[str]:
         """Make eth_call to contract."""
         try:
-            result = self._rpc_call("eth_call", [
-                {"to": address, "data": data},
-                "latest"
-            ])
+            result = self._rpc_call("eth_call", [{"to": address, "data": data}, "latest"])
             return result if result and result != "0x" else None
         except Exception:
             return None
@@ -289,7 +274,7 @@ class EventMonitor:
             # ABI encoded string: offset (32 bytes) + length (32 bytes) + data
             if len(data) >= 128:
                 length = int(data[64:128], 16)
-                string_data = data[128:128 + length * 2]
+                string_data = data[128 : 128 + length * 2]
                 return bytes.fromhex(string_data).decode("utf-8", errors="ignore")
 
             return bytes.fromhex(data).decode("utf-8", errors="ignore").strip("\x00")

package/skills/tracking-token-launches/scripts/formatters.py

@@ -58,7 +58,7 @@ def format_risk_badge(score: int) -> str:
 
 def format_supply(supply: int, decimals: int) -> str:
     """Format token supply."""
-    value = supply / (10 ** decimals)
+    value = supply / (10**decimals)
 
     if value >= 1e12:
         return f"{value / 1e12:.2f}T"
@@ -72,11 +72,7 @@ def format_supply(supply: int, decimals: int) -> str:
         return f"{value:.2f}"
 
 
-def format_new_pairs_table(
-    pairs: List[Any],
-    token_infos: Dict[str, Any],
-    analyses: Dict[str, Any]
-) -> str:
+def format_new_pairs_table(pairs: List[Any], token_infos: Dict[str, Any], analyses: Dict[str, Any]) -> str:
     """Format new pairs as table.
 
     Args:
@@ -110,10 +106,7 @@ def format_new_pairs_table(
         pair_str = format_address(pair.pair_address, 8)
         time_str = format_age(pair.timestamp)
 
-        lines.append(
-            f"{time_str:<12} {token_str:<20} {pair.dex:<15} "
-            f"{pair.chain:<10} {risk_str:<15} {pair_str:<18}"
-        )
+        lines.append(f"{time_str:<12} {token_str:<20} {pair.dex:<15} {pair.chain:<10} {risk_str:<15} {pair_str:<18}")
 
     lines.append("=" * 90)
     lines.append(f"Total: {len(pairs)} new pairs")
@@ -121,12 +114,7 @@ def format_new_pairs_table(
     return "\n".join(lines)
 
 
-def format_launch_detail(
-    pair: Any,
-    token_info: Any,
-    analysis: Any,
-    chain_config: Any
-) -> str:
+def format_launch_detail(pair: Any, token_info: Any, analysis: Any, chain_config: Any) -> str:
     """Format detailed launch info.
 
     Args:
@@ -158,26 +146,30 @@ def format_launch_detail(
     ]
 
     if token_info:
-        lines.extend([
-            "TOKEN INFO",
-            "-" * 60,
-            f"Decimals:     {token_info.decimals}",
-            f"Total Supply: {format_supply(token_info.total_supply, token_info.decimals)}",
-            f"Owner:        {format_address(token_info.owner) if token_info.owner else 'None'}",
-            f"Verified:     {'Yes' if token_info.is_verified else 'No'}",
-            "",
-        ])
+        lines.extend(
+            [
+                "TOKEN INFO",
+                "-" * 60,
+                f"Decimals:     {token_info.decimals}",
+                f"Total Supply: {format_supply(token_info.total_supply, token_info.decimals)}",
+                f"Owner:        {format_address(token_info.owner) if token_info.owner else 'None'}",
+                f"Verified:     {'Yes' if token_info.is_verified else 'No'}",
+                "",
+            ]
+        )
 
     if analysis:
-        lines.extend([
-            "RISK ANALYSIS",
-            "-" * 60,
-            f"Risk Score:   {analysis.risk_score}/100 {format_risk_badge(analysis.risk_score)}",
-            f"Is Proxy:     {'Yes' if analysis.is_proxy else 'No'}",
-            f"Ownership:    {'Renounced' if analysis.ownership_renounced else 'Active'}",
-            "",
-            "Indicators:",
-        ])
+        lines.extend(
+            [
+                "RISK ANALYSIS",
+                "-" * 60,
+                f"Risk Score:   {analysis.risk_score}/100 {format_risk_badge(analysis.risk_score)}",
+                f"Is Proxy:     {'Yes' if analysis.is_proxy else 'No'}",
+                f"Ownership:    {'Renounced' if analysis.ownership_renounced else 'Active'}",
+                "",
+                "Indicators:",
+            ]
+        )
 
         for ind in analysis.indicators:
             severity_marker = {
@@ -254,11 +246,7 @@ def format_json(data: Any) -> str:
     if hasattr(data, "__dict__"):
         return json.dumps(vars(data), indent=2, default=str)
     elif isinstance(data, list):
-        return json.dumps(
-            [vars(x) if hasattr(x, "__dict__") else x for x in data],
-            indent=2,
-            default=str
-        )
+        return json.dumps([vars(x) if hasattr(x, "__dict__") else x for x in data], indent=2, default=str)
     else:
         return json.dumps(data, indent=2, default=str)