{"id":31835333,"url":"https://github.com/pisuthd/backhack-dev","last_synced_at":"2025-10-12T00:58:23.608Z","repository":{"id":275270186,"uuid":"925504575","full_name":"pisuthd/backhack-dev","owner":"pisuthd","description":"A fun DeFi prediction market focused on hackathon results on Sui","archived":false,"fork":false,"pushed_at":"2025-02-10T08:11:23.000Z","size":1572,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-01T02:11:07.656Z","etag":null,"topics":["ai","atoma","deepseek","ethglobal","move","sui"],"latest_commit_sha":null,"homepage":"https://backhack.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit-0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pisuthd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2025-02-01T02:54:26.000Z","updated_at":"2025-02-10T08:11:27.000Z","dependencies_parsed_at":"2025-02-01T10:29:42.694Z","dependency_job_id":null,"html_url":"https://github.com/pisuthd/backhack-dev","commit_stats":null,"previous_names":["pisuthd/backhack-dev"],"tags_count":0,"template":false,"template_full_name":"aws-samples/amplify-next-template","purl":"pkg:github/pisuthd/backhack-dev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pisuthd%2Fbackhack-dev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pisuthd%2Fbackhack-dev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pisuthd%2Fbackhack-dev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pisuthd%2Fbackhack-dev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pisuthd","download_url":"https://codeload.github.com/pisuthd/backhack-dev/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pisuthd%2Fbackhack-dev/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279009509,"owners_count":26084609,"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","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","atoma","deepseek","ethglobal","move","sui"],"created_at":"2025-10-12T00:57:22.683Z","updated_at":"2025-10-12T00:58:23.601Z","avatar_url":"https://github.com/pisuthd.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## BackHack.dev\n\n**BackHack.dev** makes any hackathon experience more engaging and fun by allowing you and your supporters to bet on results and earn when successful. It leverages **Atoma Network**'s decentralized AI and the **DeepSeek R1** model to quickly sync teams, automate result resolution from official hackathon websites.\n\nThe system is live on the Sui Testnet. With **zkLogin** enabling seamless Google sign-in, there's no need for a sophisticated Web3 wallet.\n\n- https://backhack.dev\n- [YouTube](https://www.youtube.com/watch?v=c7kE_27zz-U)\n\n## Background\n\nAt some point, most Web3 builders participate in hackathons—whether to learn new things or compete for prizes. What if they could also bet on the results, allowing both participants and supporters to place bets on promising teams? With AI handling tasks like scoring teams, providing feedback, and ensuring fair odds. \n\nThis opens the door for greater team interaction, where teams can review one another and potentially collaborate in the future. Making the hackathon not the end, but the beginning of something great.\n\n## Overview\n\nThe system uses AWS Amplify Stack for fast development during the Sui AI-Agent Typhoon Hackathon and is deployed on AWS Cloud. It stores hackathon-related data in a database, while bets are processed on-chain via smart contracts. This helps us easily clean up duplicated or unrelated entries that may have been mistakenly input by users.\n\n![backhack-dev drawio (2)](https://github.com/user-attachments/assets/1610d181-8692-4139-9790-96c0a31f3102)\n\nPrizes are re-categorized or grouped for easier betting, ideally into 4-5 tiers, as shown in the table below:\n\n![Screenshot from 2025-02-09 20-32-45](https://github.com/user-attachments/assets/dc128cd5-7933-4c9a-adc5-2893c2ce5e8c)\n\nBettors select a team to place their bet on, with all bets pooled together for each hackathon. If the selected team finishes in the Top 10 Finalists, 0.28 SUI will be distributed among all bettors who chose teams within the tier. Sometime the team can be classified in multiple tiers, so bettors who choose that team will receive payouts from each applicable tier.\n\n## AI-Agent\n\nThe AI-agent plays a major role in the system, leveraging Atoma Network's decentralized AI to ensure the privacy of each team's information. While this information is currently public, in the future, teams may interact with the AI privately and receive feedback. DeepSeek R1 serves as the primary LLM for handling the following actions:\n\n### Fetch Teams from Official Listings\n\nMost hackathons display all the teams participating during the judging period, usually lasting 1-2 weeks. This allows judges to review and others to vote or check out what other projects are doing. \n\nEach hackathon may collaborate with different organizers and have various website layouts and styles. This creates difficulty in importing the data to other platforms, and having an API to provide this information is unlikely in this industry.\n\n![Untitled design](https://github.com/user-attachments/assets/c04b4488-6af3-472e-a24a-55c01e9f1789)\n\nWith the AI-agent, as shown above. It will start analyzing the URLs and extracting team information regardless of the layout or style.\n\nAs an AI-based application that works with prompts, we need to provide specific prompts to guide the system, one to list all teams and another to extract team information based on the given team name.\n\n```\n(1) Guide the system\nYou are an AI assistant that reads official website content to fetch teams.\n\n(2) List all teams\nList all teams from the provided markdown content.\nProvided content:\n${content} (website data in markdown)\n\n(3) Extract team info\nFetching description from Team: ${team}\n```\n\nThis is also done by calling the Atoma completion chat API: https://api.atoma.network/v1/chat/completions\n\n## Review Team\n\nAnother action we use is to review teams based on the provided description. This allows the agent to analyze each project, ensuring alignment with the hackathon theme and rules. If the deadline hasn’t passed, early feedback can help teams improve their submissions. \n\nAnd for bettors, this allows them to make more informed decisions by understanding each team's details before placing their bets.\n\n![Screenshot from 2025-02-09 21-24-53](https://github.com/user-attachments/assets/c5f48bdc-293d-43db-93f8-3ecca4bcc6c3)\n\nDue to the limited time of the hackathon, we can analyze only the description. However, in the future, imagine AI reviewing codebases, social activity and providing insights to help projects go beyond the hackathon.\n\n## Future Works\n\nThe current hackathon version can only fetch teams and review descriptions but in the future, we plan to do much more, such as:\n\n- **Deeper Team Analysis** - Analyze team codebases and social activity to provide detailed feedback and accurate improvement suggestions.\n- **Code Review** - Automate smart contract and code audits to help teams launch with ease and confidence.\n- **Odds Adjustment** - Dynamically adjust prize odds based on team quantity and AI-assessed performance.\n- **Matchmaking** - Identify potential collaborations between teams that could partner or work together.\n\n## How to Use\n\nSimply navigate to https://backhack.dev, select a hackathon to bet on, and follow these steps:\n\n**1. Login with Google**\n\n* Click 'Login' and choose an authentication method (currently supports Google only).\n* Check your unique wallet address. Ensure it's funded.\n\n**2. Choose a Team**\n\n* On the hackathon page, review the available prize tiers and browse all participating teams.\n* Use AI-agent actions to sync teams and review projects.\n* Place bets on one (or more) teams you believe will advance to prize-winning rounds.\n\n**3. Claim Rewards**\n\n* Once the hackathon ends, if your chosen team wins, you can claim rewards.\n* All bets for the hackathon are aggregated into a single pool and distributed based on odds and bettor contributions.\n\n## How to Test\n\nThe project is built using the AWS Amplify Stack with Next.js for the frontend. All backend configurations are managed inside the `/amplify` folder. When the GitHub repo is updated, AWS automatically deploys services like real-time databases and APIs. \n\nHowever, outside of this stack, we also have a Sui Move smart contract that handles all betting processes. To run the system locally after downloading:\n\n```\nnpm install\n```\n\nYou must retrieve `amplify_outputs.json` from the AWS Dashboard after linking your GitHub repo to AWS and place it in the root folder. \n\nAlso, ensure you obtain API keys from the AI services we use and add them to the .env file:\n\n```\n# 3rd parties AI services\nFIRECRAWL_API_KEY=your-api-key\nATOMA_API_KEY=your-api-key\n\n# ZKlogin \nENOKI_API_KEY=your-api-key\nGOOGLE_CLIENT_ID=your-client-id\n```\n\nWe can run the frontend with:\n\n```\nnpm run dev\n```\n\nFor the smart contract, navigate to `/sui-contract/backhack` and run test cases with:\n\n```\nsui move test\n```\n\nRefer to the Sui documentation for deploying a new contract on the live network and updating the JSON file in the project accordingly.\n\nFor detailed instructions on deploying to AWS cloud, refer to the [deployment section](https://docs.amplify.aws/nextjs/start/quickstart/nextjs-app-router-client-components/#deploy-a-fullstack-app-to-aws) of our documentation.\n\n## Deployment\n\n### Sui Testnet\n\nComponent Name | ID/Address\n--- | --- \nPackage ID |  0x962321d30ccbf9c4c5de58bc32d64ab6fa2777ede18d1107dcb080d6acad8583\nMarket State | 0x3909e8b32318a0fbe27c365288f0d2a14d364218f743773c7f475e898e17824a\n\n## License\n\nThis library is licensed under the MIT-0 License. See the LICENSE file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpisuthd%2Fbackhack-dev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpisuthd%2Fbackhack-dev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpisuthd%2Fbackhack-dev/lists"}