Awesome
MemeSphinx: MEME Coin Riddles Game
MemeSphinx is an innovative text-based game designed to captivate Web3 enthusiasts. Players solve riddles about MEME coins presented by a mystical Sphinx, with the chance to win MEME coin rewards. Built using cutting-edge technologies such as XMTP and Flow blockchain, MemeSphinx combines fun, engagement, and security to create an unparalleled interactive experience.
π Git Config and Repository Clone
# First, increase Git buffer size (required for cloning large repositories)
git config --global http.postBuffer 524288000
# Clone the repository
git clone https://github.com/apac-chainchanger/MemeSphinx.git
π Key Features
π Interactive Gameplay(with XMTP)
- Riddles from the Sphinx: Encounter the Sphinx, a mystical character that presents clues and riddles about MEME coins.
- Example: "This coin is loved by Elon and adored by a certain Shiba Inu." (Answer: DOGE)
- Guess the MEME Coin: Players have 3 chances to guess the correct MEME coin and win rewards.
π° Rewards(with Flow)
- Correct guesses are rewarded with MEME coins distributed via a smart contract built on the Flow blockchain, leveraging its EVM compatibility introduced in the Crescendo update.
- Flowβs low fees, scalability, and developer-friendly environment made it the ideal choice for integrating MEME coin rewards.
- The smart contract ensures secure, efficient, and transparent reward distribution, fully utilizing Flow's robust ecosystem for seamless execution.
π Cross-Platform Integration
- XMTP: Offers wallet-based communication and verification through Converse.app for secure, identity-driven interactions.
- Telegram: Allows broader participation with a consistent experience, albeit without wallet-based verification.
π€ Advanced Bot Architecture
- Powered by GPT-4o, ensuring natural, dynamic, and engaging interactions.
- Built on XMTP's Message-kit Framework and Telegramβs python-telegram-bot with LangChain.
π οΈ How It Works
1. Start the Game
- Interact via XMTP (Converse.app) or Telegram.
- The Sphinx presents a randomized clue about a MEME coin.
2. Guess the MEME Coin
- Submit your answers directly through the chat interface.
- Three chances per riddle.
3. Win MEME Coin Rewards
- Correct guesses trigger a smart contract that distributes MEME coins to your wallet securely.
π Project Directory Structure
MemeSphinx/
βββ Telegram_bot/ # Telegram bot-related code
β βββ main.py # Main execution file for the bot
β βββ bot_logic.py # Bot game logic
β βββ requirements.txt # Python dependencies
βββ XMTP_bot/ # XMTP-based bot code
β βββ main.js # Main execution file for the bot
β βββ bot_logic.js # Bot game logic
β βββ package.json # Node.js dependencies
βββ contracts/ # Flow blockchain smart contract code
β βββ MemeSphinx.cdc # Flow Cadence contract code
βββ README.md # Project documentation
βββ LICENSE # License file
βββ .gitignore # Git ignore file
π Getting Started
1. Clone the Repository
git clone https://github.com/apac-chainchanger/MemeSphinx.git
2. Install Dependencies
- For Telegram Bot:
cd Telegram_bot pip install -r requirements.txt
- For XMTP Bot:
cd XMTP_bot yarn install
3. Run the Bots
- Telegram Bot:
python main.py
- XMTP Bot:
npm start
4. Deploy the Smart Contract
- Navigate to the
contracts/
directory and deploy the Flow blockchain smart contract using Flowβs development environment.
π Security Features
- Wallet Verification:
- XMTP ensures wallet-based identity for secure interactions.
- Smart Contract:
- Whitelisted users and pre-held MEME coins ensure secure reward distribution.
- Flow Blockchain:
- EVM-compatible, low-cost, and developer-friendly for efficient operations.
π Why MemeSphinx?
MemeSphinx isnβt just a gameβitβs a community-driven project aimed at enriching the Web3 ecosystem in Korea and beyond. By combining fun, engagement, and education, we foster active Web3 communities while promoting MEME coins and blockchain technology.
π License
This project is licensed under the MIT License. See the LICENSE file for details.
π€ Acknowledgments
Special thanks to our partners:
- XMTP: For wallet-based communication technology. [Github | Website]
- Flow Blockchain: For scalable and secure smart contracts. [Github | Website]
π₯ Who We Are?
π€ LLM Agent & Bot Developer
π¬ Contact on Telegram! @AndrewS0ng
- π Developed XMTP & Telegram bot integration
- π§ Implemented GPT-4 powered game logic
- π€ Created project presentation
π¨βπ» SmartContract Developer
π¬ Contact on Telegram! @jaysongthedev
- π§ Designed & implemented MemeSphinx Token Manager
- π‘οΈ Built secure token distribution system
- πͺ Developed test token contracts (tDOGE, tPEPE, tSHIB)
Start your journey with MemeSphinx today and dive into the world of MEME coins!