{"id":19593460,"url":"https://github.com/magicblock-labs/solana-generals","last_synced_at":"2025-07-13T04:35:01.354Z","repository":{"id":244915575,"uuid":"816369756","full_name":"magicblock-labs/solana-generals","owner":"magicblock-labs","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-08T08:53:46.000Z","size":1346,"stargazers_count":12,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-05T01:02:01.018Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://magicblock-labs.github.io/solana-generals/","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/magicblock-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":"2024-06-17T15:51:05.000Z","updated_at":"2024-12-30T17:09:47.000Z","dependencies_parsed_at":"2024-08-23T09:27:43.821Z","dependency_job_id":"9adad98b-2a30-4595-858a-d935b7b5f1a8","html_url":"https://github.com/magicblock-labs/solana-generals","commit_stats":null,"previous_names":["magicblock-labs/solana-generals"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicblock-labs%2Fsolana-generals","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicblock-labs%2Fsolana-generals/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicblock-labs%2Fsolana-generals/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicblock-labs%2Fsolana-generals/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/magicblock-labs","download_url":"https://codeload.github.com/magicblock-labs/solana-generals/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251162355,"owners_count":21545760,"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-11T08:39:42.319Z","updated_at":"2025-04-27T15:32:55.842Z","avatar_url":"https://github.com/magicblock-labs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# MagicBlock Engine Example\n\nThis repository contains an example for a fully featured game running 100% serverless using Solana's devnet and MagicBlock's devnet.\n\nDemo available [here](https://magicblock-labs.github.io/solana-generals/#/)\n\n# Demo\n\nRun the frontend that should already be pointing to solana's devnet:\n\n```bash\ncd backend\nbolt build\ncd ../frontend\nnpm install\nnpm run dev\n```\n\nYou can then head to: https://faucet.solana.com/ to get some devnet SOL you can use to fund your player's account to start testing.\n\n# Code organization\n\n## Backend\n\nThe `backend` folder contains all smart contract code, it uses MagicBlock's BOLT.\n\nThe smart contracts should already be deployed on devnet.\n\nYou can also locally run the integration tests:\n\n```bash\ncd backend\nbolt test\n```\n\nSome of the important code pieces are:\n\n- `backend/programs-ecs/components` - Contains the definition for the game datastructure\n- `backend/programs-ecs/systems` - Contains all possible game mutations available\n- `backend/tests` - Integration tests and example on how the game can be used\n\n## Frontend\n\nThe `frontend` folder contains an implementation for a React based web UI to interact with the smart contracts.\n\nSome of the important pieces of code are:\n\n- `frontend/src/states` - Utility functions to interact with the smart contract\n- `frontend/src/components/menu` - Wallet manipulation code (including session keys)\n- `frontend/src/components/page` - High level components for each page of the application\n\nReading some of those will help with the overall understanding of the architechture\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicblock-labs%2Fsolana-generals","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmagicblock-labs%2Fsolana-generals","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicblock-labs%2Fsolana-generals/lists"}