create an endpoint to query token balances

[iuwqyir]

TL;DR

Added a new API endpoint to fetch token balances by type (ERC20, ERC721, ERC1155) for a given address.

What changed?

• Added /balances/:owner/:type endpoint to retrieve token balances
• Created materialized views in ClickHouse to track token balances from transfer events
• Implemented balance querying with support for pagination and filtering
• Added support for hiding zero balances
• Introduced token balance data structures and query filters

How to test?

1. Start the API server
2. Query the endpoint: /balances/{address}/{token_type}
   • token_type: "erc20", "erc721", or "erc1155"
   • Optional query params:
     • hide_zero_balances: true/false
     • token_address: specific token contract
     • page and limit: for pagination
     • sort_by and sort_order: for sorting

Why make this change?

To provide a convenient way to fetch token balances for addresses across different token standards, enabling better wallet integration and portfolio tracking capabilities.

[iuwqyir]

• create an endpoint to query token balances #136 👈 (View in Graphite)
• Handle sigterm #150
• Chain based table name and default columns configuration #151
• Use VersionedCollapsingMergeTree and insert based deletes #149
• Specific column selection and api serialization #148
• Conform getTraces to api standard #147
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.