https://github.com/guilyx/trackdrop
Track your wallet's interactions on chains/protocols that will potentially airdrop their tokens.
https://github.com/guilyx/trackdrop
airdrop arbitrum base coinbase ethereum explorer linea tracker zksync
Last synced: about 2 months ago
JSON representation
Track your wallet's interactions on chains/protocols that will potentially airdrop their tokens.
- Host: GitHub
- URL: https://github.com/guilyx/trackdrop
- Owner: guilyx
- License: gpl-3.0
- Created: 2023-08-06T16:22:01.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-11-29T23:14:16.000Z (7 months ago)
- Last Synced: 2025-03-30T19:38:22.798Z (3 months ago)
- Topics: airdrop, arbitrum, base, coinbase, ethereum, explorer, linea, tracker, zksync
- Language: TypeScript
- Homepage: https://trackdrop.xyz
- Size: 317 KB
- Stars: 14
- Watchers: 2
- Forks: 5
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TrackDrop
[](https://github.com/guilyx/TrackDrop/actions/workflows/build.yml)
[](https://codecov.io/gh/guilyx/trackdrop)
[](https://www.gnu.org/licenses/gpl-3.0)
Track your wallet's interactions on chains/protocols that will potentially airdrop their tokens. TrackDrop is a fork from `zkFlow`.
## Features
- View number of interactions, volume and gas spent for a given address.
- View token balances for a specific address.
- Track time statistics about your interactions (see Arbitrum airdrop criteria).
## Getting Started
To get `TrackDrop` up and running locally on your machine, follow these steps:
### Running the TrackDrop Docker Container
The TrackDrop Docker container allows you to run the application in an isolated environment.
Follow these steps to build and run the Docker container:
### Prerequisites
Before you begin, make sure you have the following software installed on your system:
- Docker: [Install Docker](https://docs.docker.com/get-docker/)
### Build the Docker Image
1. Clone the repository:
```sh
git clone
```
2. Navigate to the project directory:
```sh
cd TrackDrop
```
3. Run the following command to build the Docker image using the provided Dockerfile:
```bash
docker-compose -f docker/docker-compose.yml build
```
This command will use the `Dockerfile` located in the `docker` directory to build the Docker image named `trackdrop`.
### Run the Docker Container
1. After successfully building the Docker image, you can run the Docker container using the following command:
```bash
docker-compose -f docker/docker-compose.yml up
```
2. Once the container is up and running, you can access the TrackDrop application by opening a web browser and navigating to `http://localhost:5173`.
### Stopping and Removing the Container
When you're done using the TrackDrop application, you can stop and remove the Docker container:
1. Run the following command to stop and remove the Docker container:
```bash
docker-compose -f docker/docker-compose.yml down
```
### Additional Notes
- If you want to make changes to the application code, you can do so in your local project directory, and the changes will be reflected in the running Docker container.
- The Docker container exposes the application on port 8080. You can modify the `docker-compose.yml` file to change the port mapping if needed.
---
With these instructions, you should be able to build and run the TrackDrop Docker container on your system. If you encounter any issues, refer to the Docker documentation or seek assistance from your development team.
## Disclaimer
I am not a web developer, and have heavily based what I did on `zkFlow`. Credit goes to them for the squeletton and design premises of the web app.
## Contributing
I come from a different background, I expect to have made a lot of design/architecture mistakes. Never used TS before, with that in mind, **contributions** to `TrackDrop` are not only welcome, they're heavily encouraged! To contribute:
1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Commit your changes and push to your forked repository.
4. Create a pull request to the main repository.
## License
This project is licensed under the [GPLv3 License](LICENSE).
```
1. Anyone can copy, modify and distribute this software.
2. You have to include the license and copyright notice with each and every distribution.
3. You can use this software privately.
4. You can use this software for commercial purposes.
5. If you dare build your business solely from this code, you risk open-sourcing the whole code base.
6. If you modify it, you have to indicate changes made to the code.
7. Any modifications of this code base MUST be distributed with the same license, GPLv3.
8. This software is provided without warranty.
9. The software author or license can not be held liable for any damages inflicted by the software.
```