{"id":23219414,"url":"https://github.com/mirrorworld-universe/cascade-protocol","last_synced_at":"2025-08-19T09:32:33.427Z","repository":{"id":245472111,"uuid":"818235190","full_name":"mirrorworld-universe/cascade-protocol","owner":"mirrorworld-universe","description":"A Solana explorer for humans","archived":false,"fork":false,"pushed_at":"2024-07-12T17:10:19.000Z","size":1757,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-13T18:23:53.401Z","etag":null,"topics":["cascade","explorer","rollup","solana","svm","ux"],"latest_commit_sha":null,"homepage":"https://cascade.sonic.game","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/mirrorworld-universe.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}},"created_at":"2024-06-21T11:47:44.000Z","updated_at":"2024-07-12T17:10:22.000Z","dependencies_parsed_at":"2024-06-27T21:21:38.230Z","dependency_job_id":null,"html_url":"https://github.com/mirrorworld-universe/cascade-protocol","commit_stats":null,"previous_names":["mirrorworld-universe/cascade-protocol"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirrorworld-universe%2Fcascade-protocol","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirrorworld-universe%2Fcascade-protocol/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirrorworld-universe%2Fcascade-protocol/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mirrorworld-universe%2Fcascade-protocol/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mirrorworld-universe","download_url":"https://codeload.github.com/mirrorworld-universe/cascade-protocol/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230343186,"owners_count":18211657,"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":["cascade","explorer","rollup","solana","svm","ux"],"created_at":"2024-12-18T21:32:19.599Z","updated_at":"2024-12-18T21:32:20.070Z","avatar_url":"https://github.com/mirrorworld-universe.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/mirrorworld-universe/cascade-protocol\"\u003e\n    \u003cimg src=\"https://github.com/mirrorworld-universe/cascade/blob/main/media/logos/cascade-logotype.png?raw=true\" alt=\"Cascade logo\" width=\"300\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eSolana's human-readable explorer. 🌊\u003c/h1\u003e\n\n\u003cbr /\u003e\n\nThis repository comprises of two kinds of workspaces:\n\n- **Packages**:\n  - [**Core**](./packages/core): The core package provides the basic building blocks for building Solana-first dApps.\n  - [**React**](./packages/react): The React package provides a React hooks for building Solana-first dApps, making them easy to use for the end user.\n- **Apps**:\n  - [**Cascade Explorer**](./apps/explorer): The Cascade Explorer is a web application that allows users to explore the Solana blockchain and interact with programs deployed on Solana or any SVM Rollup.\n  - [**Cascade Wallet**](./apps/wallet): The Cascade Wallet is a web application that allows users to interact with programs deployed on Solana or any SVM Rollup.\n\n### npm Packages\n\n| Package                       | Link                                        | Version                                        |\n| :---------------------------- | :------------------------------------------ | :--------------------------------------------- |\n| **`@cascade-protocol/core`**  | [cascade-protocol-core][cascade-core-npm]   | [![NPM][cascade-core-img]][cascade-core-npm]   |\n| **`@cascade-protocol/react`** | [cascade-protocol-react][cascade-react-npm] | [![NPM][cascade-react-img]][cascade-react-npm] |\n\n## Installation\n\nThis repository is a monorepo managed with [bun](https://bun.sh/).\n\nTo install the dependencies, run `bun install`.\n\n```\nbun install\n```\n\n## Local database setup (optional)\n\nWe use PostgresQL to store a few things:\n\n- Price history for the SOL in USD\n\nThis in only optional, and is used to ensure that migrations are executed will for further additions to the stack.\n\nInstall Postgres locally and create a local database called `cascade_db_local`.\n\nCreate a `.env` file in the `apps/api/.env` directory with the following variables:\n\n```env\nDATABASE_USERNAME=\nDATABASE_PASSWORD=\nDATABASE_HOST=127.0.0.1\nDATABASE_PORT=5432\nDATABASE_NAME=\"cascade_db_local\"\n```\n\nRun the migration script:\n\n```sh\nbun run --filter=@cascade-protocol/api ./db/migrate.ts\n```\n\n## Contributing\n\nFeel like contributing? That's awesome! We have a\n[contributing guide](./CONTRIBUTING.md) to help guide you.\n\n\u003c!-- Links --\u003e\n\n[cascade-core-npm]: https://npmjs.com/package/@cascade-protocol/core\n[cascade-react-npm]: https://npmjs.com/package/@cascade-protocol/react\n[cascade-vue-npm]: https://npmjs.com/package/@cascade-protocol/vue\n[cascade-core-img]: https://img.shields.io/npm/v/@cascade-protocol/core?logo=typescript\n[cascade-react-img]: https://img.shields.io/npm/v/@cascade-protocol/react?logo=typescript\n[cascade-vue-img]: https://img.shields.io/npm/v/@cascade-protocol/vue?logo=typescript\n\n# License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirrorworld-universe%2Fcascade-protocol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmirrorworld-universe%2Fcascade-protocol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmirrorworld-universe%2Fcascade-protocol/lists"}