Add reallocation functionality to transfer process

[purplesmoke05]

📌 Description

This pull request introduces a new "Reallocation" transfer event type to the system, updates related models and schemas, and adds functionality to detect and handle this event during batch processing. It also includes tests to validate the new functionality.

✅ Related Issues

• Close [FEATURE] Support annotation-based reallocation transfers #1657

🔄 Changes

Enhancements to Transfer Event Types

• Added a new REALLOCATION event type to the IDXTransferSourceEventType and TransferSourceEvent enums in app/model/db/idx_transfer.py and app/model/schema/token.py. [1] [2]
• Updated the TransferHistory and TransferHistoriesResponse models to include the new REALLOCATION event type. [1] [2]

Batch Processing Updates

• Modified batch/indexer_Transfer.py to detect "Reallocation" events by checking transaction data for a specific marker (c0ffee00) and added logic to process these events accordingly.
• Added HexBytes import to support transaction data handling.

Testing Enhancements

• Added a new helper function reallocate_share_token in tests/contract_modules.py to simulate "Reallocation" events.
• Updated tests/batch/indexer_Transfer_test.py to include tests for "Reallocation" events, ensuring proper detection, processing, and database insertion. [1] [2] [3] [4] [5] [6] [7]

📌 Checklist

• I have added tests where necessary.
• I have updated the documentation where necessary.

[github-actions]

Coverage Report •

File	Stmts	Miss	Cover	Missing
app/model/db
idx_transfer.py	46	1	97%	98
app/model/schema
token.py	210	0	100%
batch
indexer_Transfer.py	311	50	83%	98, 118, 194–196, 252–256, 294, 369, 393–394, 459, 476–477, 527, 544–545, 595, 612–613, 631–632, 635–643, 646–657, 661–664
tests
contract_modules.py	401	26	93%	209–211, 218–220, 377–379, 452–453, 660, 662–663, 772–774, 848–850, 980–981, 984, 1068–1069, 1072
tests/batch
indexer_Transfer_test.py	595	0	100%
TOTAL	44323	1575	96%

Tests	Skipped	Failures	Errors	Time
1485	0 💤	0 ❌	0 🔥	12m 56s ⏱️

[purplesmoke05]

Additionally fixed the API docs schema: a0bda94