{"id":29416226,"url":"https://github.com/tinodcodes/simuka-drace-blockdag-hackathon-dapp","last_synced_at":"2026-04-16T10:01:48.773Z","repository":{"id":303058698,"uuid":"1014221391","full_name":"TinoDCodes/Simuka-DRace-BlockDAG-Hackathon-dApp","owner":"TinoDCodes","description":"RaceChain is a decentralized horse racing protocol that brings transparency, automation, and accessibility to global horse race betting. Built using Solidity, NextJS, C#, and PostgreSQL, RaceChain delivers a trustless, fast, and globally accessible betting experience.","archived":false,"fork":false,"pushed_at":"2025-07-25T10:45:47.000Z","size":4682,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-05T15:00:04.540Z","etag":null,"topics":["blockchain","blockdag","ethereum","hardhat","heroui","nextjs","solidity","tailwindcss","tanstack-react-query","web3-dapp"],"latest_commit_sha":null,"homepage":"https://simuka-race-chain.vercel.app","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/TinoDCodes.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-05T09:33:56.000Z","updated_at":"2025-07-25T10:46:11.000Z","dependencies_parsed_at":"2025-07-20T13:14:45.786Z","dependency_job_id":"f9354d75-5680-4f10-9936-e4a7c9495804","html_url":"https://github.com/TinoDCodes/Simuka-DRace-BlockDAG-Hackathon-dApp","commit_stats":null,"previous_names":["tinodcodes/simuka-drace-blockdag-hackathon-dapp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TinoDCodes/Simuka-DRace-BlockDAG-Hackathon-dApp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TinoDCodes%2FSimuka-DRace-BlockDAG-Hackathon-dApp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TinoDCodes%2FSimuka-DRace-BlockDAG-Hackathon-dApp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TinoDCodes%2FSimuka-DRace-BlockDAG-Hackathon-dApp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TinoDCodes%2FSimuka-DRace-BlockDAG-Hackathon-dApp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TinoDCodes","download_url":"https://codeload.github.com/TinoDCodes/Simuka-DRace-BlockDAG-Hackathon-dApp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TinoDCodes%2FSimuka-DRace-BlockDAG-Hackathon-dApp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31880882,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T09:23:21.276Z","status":"ssl_error","status_checked_at":"2026-04-16T09:23:15.028Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["blockchain","blockdag","ethereum","hardhat","heroui","nextjs","solidity","tailwindcss","tanstack-react-query","web3-dapp"],"created_at":"2025-07-11T19:02:15.990Z","updated_at":"2026-04-16T10:01:48.759Z","avatar_url":"https://github.com/TinoDCodes.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RaceChain\n\nRaceChain is a decentralized horse racing protocol that brings transparency, automation, and accessibility to global horse race betting. Built using Solidity, NextJS, C#, and PostgreSQL, RaceChain delivers a trustless, fast, and globally accessible betting experience.\n\n![RaceChain Banner](frontend/public/racechain-banner.png)\n\n## 🚀 Features\n- 🏇 On-chain horse race betting (fixed odds and tote liquidity options)\n- 💸 Only 1% platform fees (vs traditional 10-15%)\n- 🔗 Smart contract-based payouts and liquidity management\n- ⚡ Block DAG infrastructure for high scalability\n- 📊 Immutable race history and odds transparency\n- 👥 DAO and AI-driven odds engine\n- 🌐 Global access to horse racing markets\n- 💡 Real-time racing data ingestion\n- 💰 Decentralized liquidity pools\n\n## Table of Contents\n- [Installation](#-local-setup)\n- [Usage](#-usage)\n- [Technology Stack](#%EF%B8%8F-technology-stack)\n- [Project Structure](#-project-structure)\n- [License](#license)\n\n---\n\n## 🧪 Local Setup\n\n### Prerequisites\n- Node.js (v18+)\n- npm (v9+)\n- Hardhat\n- Git\n\n### Setup Instructions\n\n1. **Clone the repository**:\n   ```bash\n   git clone [https://github.com/your-username/RaceChain.git](https://github.com/TinoDCodes/Simuka-DRace-BlockDAG-Hackathon-dApp.git)\n   cd Simuka-DRace-BlockDAG-Hackathon-dApp\n   ```\n\n2. **Set up the smart contract environment (dApp folder)**:\n   ```bash\n   cd dApp\n   npm install\n   ```\n\n3. **Set up the frontend (frontend folder)**:\n   ```bash\n   cd ../frontend\n   npm install\n   ```\n\n4. **Configure environment variables**:\n   - Create `.env` files in both `dApp` and `frontend` directories based on the provided `.env.example` files\n   - Add your Infura/Alchemy API keys, wallet private key (for deployment), and other required secrets\n  \n\n## 🔧 Usage\n\n### Compile \u0026 Deploy Smart Contracts\n\n1. Set up `parameters.json` in the `ignition` folder with relevant contract deployment params.\n\n2. **Compile the smart contracts**:\n   ```bash\n   cd dApp\n   npx hardhat compile\n   ```\n\n3. **Deploy contracts**:\n   ```bash\n   npx hardhat ignition deploy .\\ignition\\modules\\\u003ccdeployment-module\u003e --network \u003cnetwork-name\u003e --parameters .\\ignition\\\u003cpath-to-parameters-file\u003e\n   ```\n(See the Hardhat and Hardhat Ignition documentations for more information.)\n\n### Run Frontend (Next.js)\n\n1. Navigate to `frontend/`\n2. Install and run:\n   ```bash\n   npm run dev\n   ```\n---\n\n## ⚙️ Technology Stack\n\n### Smart Contracts (dApp folder)\n- **Solidity**: For writing smart contracts\n- **Hardhat**: Development environment for Ethereum\n- **Ethers.js \u0026 Hardhat Ignition**: Interacting with Ethereum blockchain\n- **Mocha**: Smart contract testing\n- **OpenZeppelin**: Secure smart contract libraries\n\n### Frontend (frontend folder)\n- **Next.js**: React framework for server-rendered applications\n- **Tailwind CSS**: Utility-first CSS framework\n- **Wagmi**: React hooks for Ethereum\n- **Hero UI**: Component library\n- **Recharts**: Data visualization library\n- **Framer Motion**: Animation library\n- **RainbowKit**: Wallet adapter library\n\n### Backend (Hosted Privately)\n- ASP.NET Core (C#) + EF Core\n- PostgreSQL\n- Nethereum\n- Chainlink Oracle (planned)\n- Docker + Azure App Services (deployment)\n- Serilog + Application Insights (monitoring)\n\n## 📂 Project Structure\n\n```\nRaceChain/\n├── dApp/                   # Smart contract project\n│   ├── contracts/          # Solidity smart contracts\n│   ├── scripts/            # Custom scripts\n│   ├── ignition/           # Ignition modules\n│   ├── typechain-types/    # Typescript factories and helpers\n│   ├── test/               # Smart contract tests\n│   ├── hardhat.config.js   # Hardhat configuration\n│   └── package.json\n│\n├── frontend/               # Next.js application\n│   ├── public/             # Static assets\n│   ├── app/                # Next.js pages, layouts \u0026 api routes\n│   ├── components/         # React components\n│   ├── hooks/              # Custom hooks\n│   ├── utils/              # Utility functions \u0026 files\n│   │   └── ...             \n│   ├── next.config.js      # Next.js configuration\n│   └── package.json\n│\n├── LICENSE\n└── README.md                # This file\n```\n\n## 💰 Revenue Model\n\n- 🏛️ DAO collects a small settlement fee on liquidity pool settlements.\n- 🤖 Stakers co-own the AI model that generates odds and trading signals.\n- 🔄 A tiny fee is applied to peer-to-peer betswaps.\n- 💸 Revenue is distributed between the DAO treasury and staking participants.\n\n---\n\n## 🧠 About\n\nRaceChain is developed by **Simuka Solutions**, a blockchain innovation firm focused on real-world decentralized applications in sports, finance, and governance.\n\n🌐 Visit us: [simukasolutions.com](https://simukasolutions.com)\n\n---\n\n## 🪪 License\n\nMIT License. See [LICENSE](./LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinodcodes%2Fsimuka-drace-blockdag-hackathon-dapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftinodcodes%2Fsimuka-drace-blockdag-hackathon-dapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinodcodes%2Fsimuka-drace-blockdag-hackathon-dapp/lists"}