https://github.com/zt-9/wallet-balance-tracker
https://github.com/zt-9/wallet-balance-tracker
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/zt-9/wallet-balance-tracker
- Owner: zt-9
- License: mit
- Created: 2025-05-28T20:09:44.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-29T00:09:34.000Z (about 1 year ago)
- Last Synced: 2025-06-09T08:14:57.064Z (about 1 year ago)
- Language: TypeScript
- Size: 276 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# Wallet Tracker
Track historical wallet balances across any EVM-compatible network with support for native tokens and custom ERC20 tokens.
## Prerequisites
- Node.js v22+
- pnpm
## Installation
```sh
pnpm install
```
## Configuration
Edit `config.toml` to set up:
- Networks (id, name, rpc_url, native_token, tokens)
- Wallet addresses file
- `history_days` (number of days to backfill)
Create a `.env` file containing all the RPC URLs used in `config.toml`
## Usage
**Fetch balances (historical & current):**
```sh
pnpm dev-fetcher
```
**Terminal UI:**
```sh
pnpm dev-ui
```
- Data is stored in `data/balances.db` (SQLite)
- Only missing or outdated data is fetched
## Future Plans
- [ ] Web UI with interactive charts and filters
- [ ] Show Uniswap v3/v4 position fees
---
For issues or improvements, open a PR or issue.