{"id":26845668,"url":"https://github.com/guilyx/trackdrop","last_synced_at":"2026-01-23T22:03:06.521Z","repository":{"id":193470787,"uuid":"675350956","full_name":"guilyx/TrackDrop","owner":"guilyx","description":"Track your wallet's interactions on chains/protocols that will potentially airdrop their tokens.","archived":false,"fork":false,"pushed_at":"2024-11-29T23:14:16.000Z","size":325,"stargazers_count":14,"open_issues_count":22,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-30T20:26:42.919Z","etag":null,"topics":["airdrop","arbitrum","base","coinbase","ethereum","explorer","linea","tracker","zksync"],"latest_commit_sha":null,"homepage":"https://trackdrop.xyz","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guilyx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-06T16:22:01.000Z","updated_at":"2025-01-10T20:41:37.000Z","dependencies_parsed_at":null,"dependency_job_id":"d3647540-5a53-4887-a7ba-87223a3c859e","html_url":"https://github.com/guilyx/TrackDrop","commit_stats":null,"previous_names":["guilyx/trackdrop"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/guilyx/TrackDrop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilyx%2FTrackDrop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilyx%2FTrackDrop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilyx%2FTrackDrop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilyx%2FTrackDrop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guilyx","download_url":"https://codeload.github.com/guilyx/TrackDrop/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilyx%2FTrackDrop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28700849,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T17:25:48.045Z","status":"ssl_error","status_checked_at":"2026-01-23T17:25:47.153Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["airdrop","arbitrum","base","coinbase","ethereum","explorer","linea","tracker","zksync"],"created_at":"2025-03-30T19:37:57.670Z","updated_at":"2026-01-23T22:03:06.504Z","avatar_url":"https://github.com/guilyx.png","language":"TypeScript","readme":"# TrackDrop\n[![build](https://github.com/guilyx/TrackDrop/actions/workflows/build.yml/badge.svg)](https://github.com/guilyx/TrackDrop/actions/workflows/build.yml)\n![vercel](https://vercelbadge.vercel.app/api/guilyx/trackdrop)\n[![codecov](https://codecov.io/gh/guilyx/trackdrop/branch/master/graph/badge.svg)](https://codecov.io/gh/guilyx/trackdrop)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n\nTrack your wallet's interactions on chains/protocols that will potentially airdrop their tokens. TrackDrop is a fork from `zkFlow`.\n\n## Features\n\n- View number of interactions, volume and gas spent for a given address.\n- View token balances for a specific address.\n- Track time statistics about your interactions (see Arbitrum airdrop criteria).\n\n## Getting Started\n\nTo get `TrackDrop` up and running locally on your machine, follow these steps:\n\n### Running the TrackDrop Docker Container\n\nThe TrackDrop Docker container allows you to run the application in an isolated environment.\nFollow these steps to build and run the Docker container:\n\n### Prerequisites\n\nBefore you begin, make sure you have the following software installed on your system:\n\n- Docker: [Install Docker](https://docs.docker.com/get-docker/)\n\n### Build the Docker Image\n\n1. Clone the repository:\n\n   ```sh\n   git clone \u003crepository-url\u003e\n   ```\n\n2. Navigate to the project directory:\n\n   ```sh\n   cd TrackDrop\n   ```\n\n3. Run the following command to build the Docker image using the provided Dockerfile:\n\n   ```bash\n   docker-compose -f docker/docker-compose.yml build\n   ```\n\n   This command will use the `Dockerfile` located in the `docker` directory to build the Docker image named `trackdrop`.\n\n### Run the Docker Container\n\n1. After successfully building the Docker image, you can run the Docker container using the following command:\n\n   ```bash\n   docker-compose -f docker/docker-compose.yml up\n   ```\n\n2. Once the container is up and running, you can access the TrackDrop application by opening a web browser and navigating to `http://localhost:5173`.\n\n### Stopping and Removing the Container\n\nWhen you're done using the TrackDrop application, you can stop and remove the Docker container:\n\n1. Run the following command to stop and remove the Docker container:\n\n   ```bash\n   docker-compose -f docker/docker-compose.yml down\n   ```\n\n### Additional Notes\n\n- 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.\n- The Docker container exposes the application on port 8080. You can modify the `docker-compose.yml` file to change the port mapping if needed.\n\n---\n\nWith 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.\n\n## Disclaimer\n\nI 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. \n\n## Contributing\n\nI 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:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix.\n3. Commit your changes and push to your forked repository.\n4. Create a pull request to the main repository.\n\n## License\n\nThis project is licensed under the [GPLv3 License](LICENSE).\n\n```\n1. Anyone can copy, modify and distribute this software.\n2. You have to include the license and copyright notice with each and every distribution.\n3. You can use this software privately.\n4. You can use this software for commercial purposes.\n5. If you dare build your business solely from this code, you risk open-sourcing the whole code base.\n6. If you modify it, you have to indicate changes made to the code.\n7. Any modifications of this code base MUST be distributed with the same license, GPLv3.\n8. This software is provided without warranty.\n9. The software author or license can not be held liable for any damages inflicted by the software.\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguilyx%2Ftrackdrop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguilyx%2Ftrackdrop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguilyx%2Ftrackdrop/lists"}