{"id":24586896,"url":"https://github.com/autonomys/astral","last_synced_at":"2025-04-28T14:28:18.510Z","repository":{"id":62370071,"uuid":"550364272","full_name":"autonomys/astral","owner":"autonomys","description":"Home of our Block Explorer","archived":false,"fork":false,"pushed_at":"2025-04-28T13:53:32.000Z","size":193091,"stargazers_count":14,"open_issues_count":48,"forks_count":14,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-28T13:57:21.251Z","etag":null,"topics":["autonomys","block-explorer","typescript"],"latest_commit_sha":null,"homepage":"https://explorer.autonomys.xyz","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/autonomys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2022-10-12T16:29:07.000Z","updated_at":"2025-04-25T23:03:19.000Z","dependencies_parsed_at":"2023-08-15T22:26:04.074Z","dependency_job_id":"e437b62c-5579-4915-b24c-edf368d99d9f","html_url":"https://github.com/autonomys/astral","commit_stats":null,"previous_names":["subspace/astral","autonomys/astral"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomys%2Fastral","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomys%2Fastral/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomys%2Fastral/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomys%2Fastral/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/autonomys","download_url":"https://codeload.github.com/autonomys/astral/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251329252,"owners_count":21572077,"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":["autonomys","block-explorer","typescript"],"created_at":"2025-01-24T06:15:28.313Z","updated_at":"2025-04-28T14:28:18.502Z","avatar_url":"https://github.com/autonomys.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Astral Block Explorer\n\n![Autonomys Banner](https://github.com/autonomys/astral/blob/main/.github/images/autonomys-banner.webp)\n\n![build](https://github.com/autonomys/astral/actions/workflows/build.yaml/badge.svg)\n\n- [Astral Block Explorer](https://explorer.autonomys.xyz/) Astral Block Explorer\n\n## Astral Block Explorer\n\n\u003cpicture\u003e\n   \u003csource \n      srcset=\"https://github.com/autonomys/astral/blob/main/.github/images/explorer-dark.png\"\n      media=\"(prefers-color-scheme: dark)\"\n   /\u003e\n   \u003csource\n      srcset=\"https://github.com/autonomys/astral/blob/main/.github/images/explorer-light.png\"\n      media=\"(prefers-color-scheme: light), (prefers-color-scheme: no-preference)\"\n   /\u003e\n   \u003cimg\n      alt=\"Autonomys Network Explorer\"\n      src=\"https://github.com/autonomys/astral/blob/main/.github/images/explorer-light.png\"\n      width=\"100%\"\n   /\u003e\n\u003c/picture\u003e\n\n## Overview\n\n- [Explorer](./explorer/README.md) - Next.js app based on React and Tailwind CSS, uses Apollo Client to fetch data from Astral Indexers\n- [Indexers](./indexers/README.md) - Includes various SubQuery indexers organized by network and functionality\n\n## Development\n\n### Prerequisites\n\nEnsure you have the following installed on your local development machine:\n\n- Node.js (v18.x or later)\n- Yarn (v2.x or later)\n\nYou can check your Node and Yarn versions with 'node -v' and 'yarn -v' respectively.\n\n### Installation\n\nThese step focus on setting up the development environment for the Astral Block Explorer.\nYou can also find the instructions for setting up the Squid backend and Health check services in their respective directories.\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/autonomys/astral.git\n   cd astral\n   ```\n\n2. **Move to the explorer directory:**\n\n   ```bash\n   cd explorer\n   ```\n\n3. **Install the dependencies:**\n\n   ```bash\n   yarn install\n   ```\n\n4. **Copy the environment variables:**\n\n   ```bash\n   cp .env.sample .env\n   ```\n\n5. **Run the development server:**\n\n   ```bash\n   yarn dev\n   ```\n\n   Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\n### Multi-Network Indexers Setup\n\nTo set up the multi-network indexers, follow these steps:\n\n1. **Navigate to the indexers directory:**\n\n   ```bash\n   cd indexers\n   ```\n\n2. **Install the dependencies:**\n\n   ```bash\n   yarn\n   ```\n\n3. **Build the indexers:**\n\n   ```bash\n   yarn codegen \u0026\u0026 yarn build\n   ```\n\n4. **Start a local node, the PostgreSQL database with multiple tables, Hasura, and various SubQuery nodes and a TaskBoard (BullMQ) using Docker Compose:**\n\n   From the root directory, run:\n\n   ```bash\n   yarn dev\n   ```\n\nThis command will initialize a PostgreSQL database configured with multiple tables, launch the Hasura GraphQL engine, and start multiple Subquery nodes to index all networks. This setup provides all the necessary data for different sections of the explorer, ensuring a comprehensive indexing solution for the application.\n\n## Contributing\n\nWe welcome contributions to this project. If you are interested in enhancing the features of the app or fixing bugs, please follow these steps:\n\n1. **Fork the Repository**\n\n   Fork the project to your own GitHub account. This will be your private workspace for staging changes.\n\n2. **Create a Branch**\n\n   Create a branch in your forked repository for each set of changes you intend to make or issue you are addressing.\n\n   ```bash\n   git checkout -b your-branch-name\n   ```\n\n3. **Discuss New Features**\n\n   For new features, it's preferable to first open an issue to discuss potential changes. This helps ensure that your efforts align with the project direction and that duplicate work is avoided.\n\n4. **Bug Fixes**\n\n   For bug fixes, feel free to create a branch and proceed with fixes. Please ensure to clearly describe the bug and how your code resolves it.\n\n5. **Make Your Changes**\n\n   Make the necessary modifications to the codebase and commit them. Please keep your commits granular and well-explained.\n\n6. **Write Tests**\n\n   Ensure that your code is tested to prevent regressions.\n\n7. **Pull Request**\n\n   Submit a pull request to the main branch of the original repository. Provide a clear description of the problem and solution. Include relevant issue numbers if applicable.\n\n8. **Code Review**\n\n   Your changes will be reviewed by maintainers, who may provide feedback or questions. Address feedback and push your fixes as additional commits.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautonomys%2Fastral","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fautonomys%2Fastral","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautonomys%2Fastral/lists"}