{"id":21155999,"url":"https://github.com/function03-labs/WalletLabels","last_synced_at":"2025-07-09T12:32:13.534Z","repository":{"id":185084915,"uuid":"617320991","full_name":"function03-labs/WalletLabels","owner":"function03-labs","description":"A web app to search Ethereum wallets by names or labels. ","archived":false,"fork":false,"pushed_at":"2024-11-20T00:12:17.000Z","size":26132,"stargazers_count":83,"open_issues_count":8,"forks_count":14,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-20T01:18:08.475Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://walletlabels.xyz","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/function03-labs.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-03-22T06:25:00.000Z","updated_at":"2024-11-20T00:07:33.000Z","dependencies_parsed_at":"2024-11-03T02:32:28.504Z","dependency_job_id":null,"html_url":"https://github.com/function03-labs/WalletLabels","commit_stats":null,"previous_names":["0xaaiden/walletlabels","function03-labs/walletlabels"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/function03-labs%2FWalletLabels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/function03-labs%2FWalletLabels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/function03-labs%2FWalletLabels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/function03-labs%2FWalletLabels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/function03-labs","download_url":"https://codeload.github.com/function03-labs/WalletLabels/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225540015,"owners_count":17485431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-11-20T11:34:11.975Z","updated_at":"2024-11-20T11:34:14.869Z","avatar_url":"https://github.com/function03-labs.png","language":"TypeScript","funding_links":[],"categories":["Data Query","TypeScript"],"sub_categories":[],"readme":"# WalletLabels\n\nWalletLabels is a powerful and user-friendly web app that simplifies searching and identifying Ethereum wallets with custom labels. The application provides an intuitive interface, allowing users to search for wallet addresses by name, label or address. Visit the live website at [https://walletlabels.xyz](https://walletlabels.xyz).\n\n**Note**: This project provides the frontend and backend (API handling) for WalletLabels but does not include the database containing wallet addresses and labels. Users will need to set up their own database when deploying a local version of this project.\n\n## Table of Contents\n\n1. [Features](#features)\n2. [Folder Structure](#folder-structure)\n3. [Prerequisites](#prerequisites)\n4. [Getting Started](#getting-started)\n5. [API](#api)\n6. [Deployment](#deployment)\n7. [Contributing](#contributing)\n8. [License](#license)\n9. [Support](#support)\n\n## Features\n\n- Search for wallet addresses by name, label type, or label subtype\n- Displays wallet balance history in a graph\n- Retrieves the last transaction for each address\n- Responsive design for mobile and desktop devices\n- Dark and light theme support\n\n## Folder Structure\n\nBelow is an overview of the important files and folders in the WalletLabels project:\n\n- `components/`: Contains reusable UI components and layout related components.\n- `hooks/`: Contains custom React hooks used in the project.\n- `lib/`: Contains utility functions and database related logic.\n- `pages/`: Contains the main pages of the application and their corresponding API endpoints.\n- `public/`: Contains public assets such as images and icons.\n- `styles/`: Contains global and module-specific stylesheets.\n- `tsconfig.json`: TypeScript configuration file.\n- `next.config.mjs`: Next.js configuration file.\n- `package.json`: Contains project dependencies and scripts.\n\n## Prerequisites\n\nTo run WalletLabels locally, you need to have the following installed on your system:\n\n- Node.js (v14 or later)\n- npm (v6 or later)\n- MongoDB\n\nAdditionally, you need to set up some environment variables:\n\n- `MONGODB_URI`: The MongoDB connection URI\n- `DB_NAME`: The name of your MongoDB database\n\n## Getting Started\n\n1. Clone the repository\n\n```bash\ngit clone https://github.com/your-username/walletlabels.git\n```\n\n2. Change the current directory to the project folder\n\n```bash\ncd walletlabels\n```\n\n3. Install the required dependencies\n\n```bash\nnpm install\n```\n\n4. Create a `.env.local` file in the project root and add your environment variables:\n\n```\nMONGODB_URI=your-mongodb-uri\nDB_NAME=your-db-name\n```\n\n5. Start the development server\n\n```bash\nnpm run dev\n```\n\n6. Open your browser, and navigate to [http://localhost:3000](http://localhost:3000)\n\n## API\n\nWalletLabels provides a single API endpoint to fetch labeled Ethereum wallet addresses based on a search query.\n\n### Endpoint\n\n```\nGET /api/query?query={query}\u0026limit={limit}\n```\n\n### Parameters\n\n- `query`: The search string to filter wallet addresses by name, label type, or label subtype. (required)\n- `limit`: The maximum number of results to return. Default is 20, and the maximum allowed value is 100. (optional)\n\n### Example\n\n```\nGET /api/query?query=exchange\u0026limit=10\n```\n\nThis request will return up to 10 wallet addresses containing the word \"exchange\" in their name, label type, or label subtype.\n\n## Deployment\n\nTo deploy WalletLabels, you can use any platform that supports Next.js applications, like [Vercel](https://vercel.com) or [Netlify](https://netlify.com). Make sure to set your environment variables in your deployment platform.\n\n## Contributing\n\nIf you would like to contribute to the project, please fork the repository, create a new branch, and submit a pull request with your changes.\n\n## License\n\nWalletLabels is released under the MIT License. See the LICENSE file for more details.\n\n## Support\n\nIf you have any questions or issues, please open an issue on the GitHub repository or contact one of the maintainers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunction03-labs%2FWalletLabels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffunction03-labs%2FWalletLabels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunction03-labs%2FWalletLabels/lists"}