Description:
The project needs better onboarding documentation and test coverage to help new contributors understand and maintain the codebase.

Current Issue: Lack of docs and limited test coverage for transaction parsing and error cases

Proposed Changes:

Documentation:

• Create docs about:
  • Project structure overview
  • Document high-level architecture
  • Document proto structure decisions
  • Explain type system design choices
  • Development environment setup guide
  • Common troubleshooting steps

Test Coverage:

• Add integration tests for:
  • Transaction parsing with different proto versions
  • Error handling scenarios
  • Type conversions and transformations
• Create mock data fixtures for testing
• Add unit tests for core functionality

Expected Outcome:

• Easier onboarding for new contributors
• More robust codebase with better test coverage
• Clear documentation of project architecture and dependencies