@intentsolutionsio/token-launch-tracker 1.0.0

package/skills/tracking-token-launches/config/settings.yaml

@@ -0,0 +1,166 @@
+# Token Launch Tracker Configuration
+# Author: Jeremy Longshore <jeremy@intentsolutions.io>
+# Version: 1.0.0
+
+# Default settings
+defaults:
+  chain: ethereum
+  hours: 24
+  limit: 50
+  format: text
+  analyze: false
+
+# Chain configurations
+chains:
+  ethereum:
+    rpc_url: https://eth.llamarpc.com
+    block_time: 12.0
+    explorer_url: https://etherscan.io
+    native_symbol: ETH
+    wrapped_native: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
+
+  bsc:
+    rpc_url: https://bsc-dataseed1.binance.org
+    block_time: 3.0
+    explorer_url: https://bscscan.com
+    native_symbol: BNB
+    wrapped_native: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c"
+
+  arbitrum:
+    rpc_url: https://arb1.arbitrum.io/rpc
+    block_time: 0.25
+    explorer_url: https://arbiscan.io
+    native_symbol: ETH
+    wrapped_native: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1"
+
+  base:
+    rpc_url: https://mainnet.base.org
+    block_time: 2.0
+    explorer_url: https://basescan.org
+    native_symbol: ETH
+    wrapped_native: "0x4200000000000000000000000000000000000006"
+
+  polygon:
+    rpc_url: https://polygon-rpc.com
+    block_time: 2.0
+    explorer_url: https://polygonscan.com
+    native_symbol: MATIC
+    wrapped_native: "0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270"
+
+# Risk analysis settings
+risk_analysis:
+  # Risk score thresholds
+  thresholds:
+    high: 70
+    medium: 40
+    low: 20
+
+  # Function signatures to detect (high risk)
+  # Note: 0xa9059cbb is the standard ERC20 transfer function, not blacklist
+  risky_functions:
+    mint: "0x40c10f19"
+    blacklist: "0x44337ea1"  # addToBlacklist(address)
+    burn: "0x42966c68"
+    transferOwnership: "0xf2fde38b"
+
+  # Risk weights by indicator
+  weights:
+    mint_function: 30
+    proxy_contract: 20
+    not_verified: 15
+    has_owner: 10
+    has_blacklist: 15
+    transferable_ownership: 5
+
+  # Proxy detection patterns
+  proxy_patterns:
+    - "363d3d373d3d3d363d73"  # Minimal proxy
+    - "5155f3"                 # DELEGATECALL
+    - "363d3d373d3d3d363d"    # EIP-1167
+
+# DEX configurations
+dex:
+  # Uniswap V2-style PairCreated event
+  pair_created_topic_v2: "0x0d3648bd0f6ba80134a33ba9275ac585d9d315f0ad8355cddefde31afa28d0e9"
+
+  # Uniswap V3 PoolCreated event
+  pool_created_topic_v3: "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118"
+
+  # Factory addresses by chain
+  factories:
+    ethereum:
+      uniswap_v2: "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f"
+      uniswap_v3: "0x1F98431c8aD98523631AE4a59f267346ea31F984"
+      sushiswap: "0xC0AEe478e3658e2610c5F7A4A2E1777cE9e4f2Ac"
+
+    bsc:
+      pancakeswap_v2: "0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73"
+      pancakeswap_v3: "0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865"
+
+    arbitrum:
+      uniswap_v3: "0x1F98431c8aD98523631AE4a59f267346ea31F984"
+      camelot: "0x6EcCab422D763aC031210895C81787E87B43A652"
+      sushiswap: "0xc35DADB65012eC5796536bD9864eD8773aBc74C4"
+
+    base:
+      uniswap_v3: "0x33128a8fC17869897dcE68Ed026d694621f6FDfD"
+      aerodrome: "0x420DD381b31aEf6683db6B902084cB0FFECe40Da"
+
+    polygon:
+      uniswap_v3: "0x1F98431c8aD98523631AE4a59f267346ea31F984"
+      quickswap: "0x5757371414417b8C6CAad45bAeF941aBc7d3Ab32"
+      sushiswap: "0xc35DADB65012eC5796536bD9864eD8773aBc74C4"
+
+# Stablecoins for base token detection
+stablecoins:
+  ethereum:
+    - "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"  # USDC
+    - "0xdAC17F958D2ee523a2206206994597C13D831ec7"  # USDT
+    - "0x6B175474E89094C44Da98b954E2deC563975aA61"  # DAI
+
+  bsc:
+    - "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d"  # USDC
+    - "0x55d398326f99059fF775485246999027B3197955"  # USDT
+    - "0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56"  # BUSD
+
+  arbitrum:
+    - "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8"  # USDC.e
+    - "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"  # USDC
+    - "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9"  # USDT
+
+  base:
+    - "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"  # USDC
+    - "0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA"  # USDbC
+
+  polygon:
+    - "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"  # USDC
+    - "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"  # USDT
+    - "0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063"  # DAI
+
+# Explorer API configuration
+explorer_apis:
+  ethereum: https://api.etherscan.io/api
+  bsc: https://api.bscscan.com/api
+  arbitrum: https://api.arbiscan.io/api
+  base: https://api.basescan.org/api
+  polygon: https://api.polygonscan.com/api
+
+# Cache settings
+cache:
+  enabled: true
+  token_info_ttl: 3600    # 1 hour
+  analysis_ttl: 1800      # 30 minutes
+  block_ttl: 60           # 1 minute
+
+# Rate limiting
+rate_limits:
+  rpc_requests_per_second: 10
+  explorer_requests_per_second: 5
+  backoff_multiplier: 2
+  max_retries: 3
+
+# Output settings
+output:
+  table_width: 90
+  address_length: 10
+  max_indicators: 10

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

@@ -0,0 +1,167 @@
+# Error Handling Reference
+
+## 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
+
+## 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
+
+## 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
+
+## 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
+
+## 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
+
+## Common Error Patterns
+
+| Error | Likely Cause | Quick Fix |
+|-------|--------------|-----------|
+| Connection timeout | RPC overloaded | Use backup RPC |
+| 429 Too Many Requests | Rate limited | Add delay |
+| No pairs found | Wrong timeframe | Increase --hours |
+| Bytecode not found | Wrong address/chain | Verify address |
+| Unknown token | Non-standard ERC20 | Use --verbose |
+| API key invalid | Wrong chain API | Match key to chain |
+
+## Fallback Chain
+
+The system uses this fallback chain for RPC failures:
+
+1. **Primary RPC** - Configured URL
+2. **Environment Variable** - `{CHAIN}_RPC_URL`
+3. **Default Public RPC** - From settings.yaml
+4. **Error** - If all fail
+
+## 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
+- Analysis progress
+
+---
+*[Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)*

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

@@ -0,0 +1,292 @@
+# Usage Examples
+
+## Recent Token Launches
+
+### Basic Usage
+```bash
+# Show launches from last 24 hours on Ethereum
+python launch_tracker.py recent --chain ethereum
+
+# Output:
+# NEW TOKEN LAUNCHES
+# ==========================================================================================
+# Time         Token                DEX             Chain      Risk            Pair
+# ------------------------------------------------------------------------------------------
+# 2m ago       PEPE2.0              Uniswap V2      ethereum   [HIGH RISK: 75] 0x1234...5678
+# 15m ago      DOGE420              Uniswap V2      ethereum   [MEDIUM: 45]    0xabcd...efgh
+# 1h ago       SAFE                 SushiSwap       ethereum   [OK: 15]        0x9876...5432
+# ==========================================================================================
+# Total: 47 new pairs
+```
+
+### With Risk Analysis
+```bash
+# Include token and contract analysis
+python launch_tracker.py recent --chain base --analyze --hours 12
+
+# Output includes enriched token data with risk scores
+```
+
+### 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
+```
+
+## Token Details
+
+### Get Full Token Information
+```bash
+python launch_tracker.py detail \
+  --address 0x6982508145454ce325ddbe47a25d4ec3d2311933 \
+  --chain ethereum
+
+# Output:
+# TOKEN LAUNCH: PEPE
+# ============================================================
+# Name:         Pepe
+# Symbol:       PEPE
+# Address:      0x6982508145454ce325ddbe47a25d4ec3d2311933
+# Pair:         Unknown
+#
+# LAUNCH INFO
+# ------------------------------------------------------------
+# DEX:          Unknown
+# Chain:        ETHEREUM
+# Block:        0
+# Time:         2024-01-20 15:30 (5m ago)
+# Tx:
+#
+# TOKEN INFO
+# ------------------------------------------------------------
+# Decimals:     18
+# Total Supply: 420.69T
+# Owner:        None
+# Verified:     Yes
+#
+# RISK ANALYSIS
+# ------------------------------------------------------------
+# Risk Score:   25/100 [LOW: 25]
+# Is Proxy:     No
+# Ownership:    Renounced
+#
+# Indicators:
+#   .  Has burn: Contract has burn function
+#      Ownership Renounced: Ownership has been renounced
+#
+# LINKS
+# ------------------------------------------------------------
+# Explorer:     https://etherscan.io/address/0x698250...
+# DEXScreener:  https://dexscreener.com/ethereum/Unknown
+# ============================================================
+```
+
+## Risk Analysis
+
+### Analyze Token Contract
+```bash
+python launch_tracker.py risk \
+  --address 0x1234567890abcdef1234567890abcdef12345678 \
+  --chain ethereum
+
+# Output:
+# RISK ANALYSIS
+# ============================================================
+# Address:      0x1234567890abcdef1234567890abcdef12345678
+# Chain:        ETHEREUM
+#
+# Risk Score:   75/100 [HIGH RISK: 75]
+# Risk Level:   HIGH RISK
+#
+# CONTRACT INFO
+# ------------------------------------------------------------
+# Bytecode:     8,456 bytes
+# Is Proxy:     Yes
+# Ownership:    Active
+#
+# RISK INDICATORS
+# ------------------------------------------------------------
+#   !! [HIGH  ] Has mint
+#               Contract has mint function
+#   !  [MEDIUM] Proxy Contract
+#               Contract is a proxy - implementation can be changed
+#   !  [MEDIUM] Not Verified
+#               Contract source code not verified
+#   .  [LOW   ] Has Owner
+#               Contract has active owner: 0x9876543210ab...
+#
+# ============================================================
+```
+
+### With Etherscan Verification
+```bash
+# Include contract verification check
+python launch_tracker.py risk \
+  --address 0x... \
+  --chain ethereum \
+  --etherscan-key YOUR_API_KEY
+```
+
+## Launch Summary
+
+### Cross-Chain Summary
+```bash
+python launch_tracker.py summary --hours 24
+
+# Output:
+# LAUNCHES BY CHAIN
+# ========================================
+#   BSC                      156
+#   ETHEREUM                  89
+#   BASE                      67
+#   ARBITRUM                  45
+#   POLYGON                   34
+# ----------------------------------------
+#   TOTAL                    391
+# ========================================
+#
+# LAUNCHES BY DEX
+# ========================================
+#   bsc:PancakeSwap V2       134
+#   ethereum:Uniswap V2       72
+#   base:Aerodrome            52
+#   arbitrum:Camelot          38
+#   bsc:PancakeSwap V3        22
+# ========================================
+```
+
+### Specific Chains Only
+```bash
+# Only Ethereum and Base
+python launch_tracker.py summary --chains ethereum,base --hours 12
+```
+
+## List DEXes and Chains
+
+### Show Supported Chains
+```bash
+python launch_tracker.py chains
+
+# Output:
+# SUPPORTED CHAINS
+# ======================================================================
+# Chain           Name                 ID         Symbol   Block
+# ----------------------------------------------------------------------
+# ethereum        Ethereum             1          ETH      12.0s
+# bsc             BNB Chain            56         BNB      3.0s
+# arbitrum        Arbitrum One         42161      ETH      0.25s
+# base            Base                 8453       ETH      2.0s
+# polygon         Polygon              137        MATIC    2.0s
+# ======================================================================
+```
+
+### Show DEXes for Chain
+```bash
+python launch_tracker.py dexes --chain bsc
+
+# Output:
+# SUPPORTED DEXES ON BSC
+# ============================================================
+#   PancakeSwap V2            (v2)
+#     Factory: 0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73
+#   PancakeSwap V3            (v3)
+#     Factory: 0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865
+# ============================================================
+```
+
+### All DEXes (JSON)
+```bash
+python launch_tracker.py -f json dexes
+```
+
+## Custom RPC Usage
+
+### Use Custom RPC Endpoint
+```bash
+python launch_tracker.py recent \
+  --chain ethereum \
+  --rpc-url https://mainnet.infura.io/v3/YOUR_PROJECT_ID
+```
+
+### Via Environment Variable
+```bash
+export ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_PROJECT_ID
+python launch_tracker.py recent --chain ethereum
+```
+
+## Verbose Output
+
+### Debug Mode
+```bash
+python launch_tracker.py --verbose recent --chain base --hours 1
+
+# Shows:
+# RPC: eth_blockNumber
+# RPC: eth_getLogs
+# RPC: eth_getBlockByNumber
+#   [1/12] MEME
+#   [2/12] WAGMI
+# ...
+```
+
+## Common Workflows
+
+### Find High-Risk New Tokens
+```bash
+# Get recent launches with analysis, output as JSON
+python launch_tracker.py -f json recent \
+  --chain ethereum \
+  --hours 6 \
+  --analyze \
+  --limit 100 > launches.json
+
+# Filter for high risk (in Python/jq)
+jq '.[] | select(.analysis.risk_score >= 70)' launches.json
+```
+
+### Monitor Multiple Chains
+```bash
+#!/bin/bash
+for chain in ethereum bsc base arbitrum; do
+  echo "=== $chain ==="
+  python launch_tracker.py recent --chain $chain --hours 1 --limit 5
+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'
+```
+
+## Integration Examples
+
+### Python Import
+```python
+from event_monitor import EventMonitor
+from token_analyzer import TokenAnalyzer
+
+# Monitor new pairs
+monitor = EventMonitor(chain="ethereum")
+pairs = monitor.get_recent_pairs(hours=1)
+
+for pair in pairs:
+    new_token = monitor.identify_new_token(pair)
+    print(f"New token: {new_token} on {pair.dex}")
+
+# Analyze risk
+analyzer = TokenAnalyzer(chain="ethereum")
+for pair in pairs[:5]:
+    new_token = monitor.identify_new_token(pair)
+    analysis = analyzer.analyze_contract(new_token)
+    print(f"  Risk: {analysis.risk_score}/100")
+```
+
+---
+*[Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)*

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

@@ -0,0 +1,36 @@
+# 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
+4. Verify rate limits and subscription tiers
+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
+4. Retrieve exchange order book and trade history
+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
+- Compare across timeframes and assets
+- 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
+- Risk assessment and position sizing guidance
+- Historical context and trend analysis
+
+---
+*[Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)*