1  ═══════════════════════════════════════════════════════════════════════════════
 2    TRANSACTION CORRELATION TOOL - QUICK START
 3  ═══════════════════════════════════════════════════════════════════════════════
 4  
 5  📍 LOCATION
 6    /home/eyawaa/composablescan/
 7  
 8  📝 FILES
 9    correlate-tx-monitor.js         - Main monitoring script
10    CORRELATION_TOOL_README.md      - Complete documentation
11    TOOL_SUMMARY.md                 - Results and overview
12    QUICK_START.txt                 - This file
13  
14  🚀 USAGE
15  
16    Monitor for 10 minutes (default):
17      node correlate-tx-monitor.js
18  
19    Monitor for 30 minutes:
20      node correlate-tx-monitor.js 30
21  
22    Monitor for 1 hour:
23      node correlate-tx-monitor.js 60
24  
25  📊 OUTPUT FILES (Generated Every Run)
26  
27    1. correlation-full-{timestamp}.json       (Complete data in JSON)
28    2. caff-transactions-{timestamp}.csv       (Caff Node 0x transactions)
29    3. espresso-transactions-{timestamp}.csv   (Espresso TX~ transactions)
30    4. correlations-{timestamp}.csv            (Matched pairs - if found)
31    5. correlation-report-{timestamp}.txt      (Human-readable summary)
32  
33  🔍 WHAT IT DOES
34  
35    1. Fetches current block heights from both networks
36    2. Scans last N minutes of blocks on both networks
37    3. Collects all transactions (TX~ from Espresso, 0x from Caff Node)
38    4. Correlates transactions within 5s-3min delay window
39    5. Calculates confidence scores for matches
40    6. Saves everything to files for analysis
41  
42  📈 CURRENT STATUS
43  
44    ✅ Tool: Working perfectly
45    ✅ Caff Node: Active (102 transactions collected)
46    ⚠️  RARI Namespace: Quiet (no transactions in test window)
47    
48    Next: Run when RARI namespace is active to find correlations
49  
50  💡 TIPS
51  
52    - Run for 30-60 minutes to catch more activity
53    - Check Espresso explorer for RARI namespace activity first
54    - All data is saved even if no correlations found
55    - CSV files can be opened in Excel/Google Sheets
56    - JSON file contains complete transaction data
57  
58  🔗 NETWORKS MONITORED
59  
60    Espresso Testnet:
61      API: https://query.decaf.testnet.espresso.network/v0
62      Namespace: 1380012617 (RARI)
63  
64    Caff Node (Rari Chain):
65      RPC: https://rari.caff.testnet.espresso.network
66      Format: Standard Ethereum JSON-RPC
67  
68  📚 DOCUMENTATION
69  
70    See CORRELATION_TOOL_README.md for:
71      - Detailed usage instructions
72      - Output file formats
73      - Analysis techniques
74      - Troubleshooting
75      - Configuration options
76  
77  ═══════════════════════════════════════════════════════════════════════════════