UTILITY_FILES_INDEX.md

Source Utility Files Index

Complete index of utility files in src/ directory (non-core bot files).

Last Updated: 2025-11-13

---

📋 Quick Reference

Most Used Utilities

• find-tokens.ts ⭐ - Find Steady Teddy and Mibera token IDs
• verify-mint.ts ⭐ - Verify mint transaction success
• analyze-successful-mints.ts ⭐ - Analyze successful mint transactions

---

🔧 Utility Files by Category

Token & Contract Discovery

Token Finding

• find-tokens.ts ⭐ - Find Steady Teddy and Mibera token IDs

  • Purpose: Automatically find token IDs owned by wallet
  • Usage: npm run find-tokens
  • Output: Token IDs for Steady Teddy and Mibera
  • When to Use: First-time setup, when you don't know token IDs

• find-miteddy-contract.ts - Find MiTeddy contract

  • Purpose: Locate MiTeddy contract address
  • Usage: Direct execution or via script
  • When to Use: Contract verification

---

Mint Verification & Analysis

Mint Verification

• verify-mint.ts ⭐ - Verify mint transaction success
  • Purpose: Verify if a transaction successfully minted a MiTeddy
  • Usage: npm run verify-mint <txHash>
  • Output: Mint verification status, token ID if successful
  • When to Use: After mint attempts, verification

Mint Analysis

• analyze-successful-mints.ts ⭐ - Analyze successful mint transactions
  • Purpose: Analyze gas/timing data for successful mints
  • Usage: npm run analyze:mints:known (via scripts/)
  • Output: Analysis data for gas strategy research
  • When to Use: Gas strategy research, competitive analysis

---

Timing & Calculation

Unlock Time Calculation

• calculate-unlock.ts - Calculate unlock time from timer
  • Purpose: Convert website timer to exact unlock timestamp
  • Usage: npm run calc-unlock "HH:MM:SS"
  • Output: Updates .env with EXPECTED_UNLOCK_TIME
  • When to Use: Time-based spam setup

Time Estimation

• estimate-time-20x.ts - Estimate time (20x multiplier)
• estimate-time-20x-final.ts - Final time estimation
• estimate-time-browser.ts - Browser-based time estimation
• estimate-time-browser-loop.ts - Browser loop estimation
• estimate-time-manual.ts - Manual time estimation
• estimate-time-multiple.ts - Multiple time estimation

Timer Reading

• read-timer-20x.ts - Read timer (20x)
• read-timer-20x-final.ts - Final timer reading

Time Sampling

• sample-timer-multiple.ts - Sample timer multiple times
• calc-mean-time.ts - Calculate mean time

Timing Pattern Analysis

• check-mint-timing-pattern.ts - Check mint timing patterns
  • Purpose: Analyze timing patterns in mint windows
  • When to Use: Timing research

---

Testing & Auditing

RPC Testing

• test-rpc-latency.ts - Test RPC latency
  • Purpose: Basic RPC latency testing
  • Note: Consider using scripts/latency-probe.ts instead

Bot Auditing

• audit-bot-run.ts - Audit bot run
  • Purpose: Audit bot execution
  • Usage: npm run audit:bot-run (if available)
  • When to Use: Post-mortem analysis

Post-Mortem Analysis

• post-mortem-analysis.ts - Post-mortem analysis
  • Purpose: Analyze bot failures
  • Usage: Direct execution or via script
  • When to Use: After failures, troubleshooting

---

Automation

Auto-Start

• auto-start.ts - Auto-start bot before unlock
  • Purpose: Automatically start bot 10 minutes before unlock
  • Usage: npm run auto-start
  • When to Use: Hands-free operation

---

📊 Files by Purpose

Setup & Configuration

1. find-tokens.ts - Find token IDs
2. calculate-unlock.ts - Calculate unlock time
3. find-miteddy-contract.ts - Find contract

Verification

1. verify-mint.ts - Verify mint success
2. test-rpc-latency.ts - Test RPC latency

Analysis

1. analyze-successful-mints.ts - Analyze mints
2. post-mortem-analysis.ts - Post-mortem analysis
3. check-mint-timing-pattern.ts - Timing patterns

Timing Research

1. estimate-time-*.ts - Various time estimation scripts
2. read-timer-*.ts - Timer reading scripts
3. sample-timer-multiple.ts - Timer sampling

---

🎯 Utility Usage Guide

First-Time Setup

# 1. Find your token IDs
npm run find-tokens

# 2. Calculate unlock time (if using time-based spam)
npm run calc-unlock "HH:MM:SS"

# 3. Auto-start before unlock (optional)
npm run auto-start

Verification

# Verify mint transaction
npm run verify-mint <txHash>

# Test RPC latency
npm run test-rpc-latency

Analysis

# Analyze successful mints
npm run analyze:mints:known

# Post-mortem analysis
npm run audit:bot-run

---

📖 Related Documentation

Primary Indexes

• Index of Indexes ⭐ - Master navigation hub for all indexes
• Documentation Index - Complete documentation index
• Scripts Index - Utility scripts index
• Guides Index - Complete guides index (27 guides)

Cross-Reference & Timeline

• Cross-Reference Map - Relationships between documents
• Timeline Index - Chronological index (117+ cross-references)
• Changelog - All changes (67+ cross-references)

Related Guides

• Configuration Guide - Configuration reference
• Getting Started - Setup guide

---

🔍 File Details

Core vs Utility Files

Core Bot Files (Not utilities)

• index.ts - Main bot logic
• config.ts - Configuration loading
• log.ts, log-hotpath.ts, detailed-log.ts - Logging
• cache.ts - Caching
• lockfile.ts - Lock management
• nonceStore.ts - Nonce persistence
• rpc-utils.ts - RPC utilities
• time-utils.ts - Time utilities
• rpc/ - RPC management
• timing/ - Timing system
• time/ - Time units
• helpers/ - Helper modules
• analysis/ - Analysis types

Utility Files (This index)

• Token finding scripts
• Mint verification scripts
• Timing calculation scripts
• Analysis scripts
• Testing scripts

---

Last Updated: 2025-11-13
Total Utility Files: 20+

⭐ = Most used / Recommended