803de231ba
Restructured project for V2 refactor: **Structure Changes:** - Moved all V1 code to orig/ folder (preserved with git mv) - Created docs/planning/ directory - Added orig/README_V1.md explaining V1 preservation **Planning Documents:** - 00_V2_MASTER_PLAN.md: Complete architecture overview - Executive summary of critical V1 issues - High-level component architecture diagrams - 5-phase implementation roadmap - Success metrics and risk mitigation - 07_TASK_BREAKDOWN.md: Atomic task breakdown - 99+ hours of detailed tasks - Every task < 2 hours (atomic) - Clear dependencies and success criteria - Organized by implementation phase **V2 Key Improvements:** - Per-exchange parsers (factory pattern) - Multi-layer strict validation - Multi-index pool cache - Background validation pipeline - Comprehensive observability **Critical Issues Addressed:** - Zero address tokens (strict validation + cache enrichment) - Parsing accuracy (protocol-specific parsers) - No audit trail (background validation channel) - Inefficient lookups (multi-index cache) - Stats disconnection (event-driven metrics) Next Steps: 1. Review planning documents 2. Begin Phase 1: Foundation (P1-001 through P1-010) 3. Implement parsers in Phase 2 4. Build cache system in Phase 3 5. Add validation pipeline in Phase 4 6. Migrate and test in Phase 5 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
23 lines
743 B
Go
23 lines
743 B
Go
package interfaces
|
|
|
|
import "github.com/ethereum/go-ethereum/common"
|
|
|
|
// TokenExtractor defines the interface for extracting tokens from transaction data
|
|
type TokenExtractor interface {
|
|
// ExtractTokensFromMulticallData extracts token addresses from multicall transaction data
|
|
ExtractTokensFromMulticallData(params []byte) (token0, token1 string)
|
|
|
|
// ExtractTokensFromCalldata extracts tokens from raw calldata using known function signatures
|
|
ExtractTokensFromCalldata(calldata []byte) (token0, token1 common.Address, err error)
|
|
}
|
|
|
|
// SwapEvent represents a standardized swap event structure
|
|
type SwapEvent struct {
|
|
TokenIn common.Address
|
|
TokenOut common.Address
|
|
AmountIn string
|
|
AmountOut string
|
|
Protocol string
|
|
Valid bool
|
|
}
|