- Directory Structure
- Getting Started
- System Architecture
- Entity Relationship Diagram
- Sequence Diagram
- Discover the Hidden Mysteries on the Blockchain with Cryptopasta
- Inspiration
- Features
- Examples of Cryptopasta
- Challenges and Solutions
- Future Work
- Team
- License
- assets: Contains images and other assets used in the README.
- examples: Contains examples of Cryptopasta stories.
- server: Contains the server code written in Go.
- subgraphs: Contains the subgraph schemas and code.
- web: Contains the web app code using Next.js.
- zksync: Contains the smart contract code written in Solidity with Hardhat.
Ensure you have the following installed:
- Clone the repo
$ git clone https://github.com/piatoss3612/Cryptopasta.git- Change the directory
$ cd Cryptopasta-
Run the docker-compose
$ docker-compose up -d
or
$ make up
Discover the Hidden Mysteries on the Blockchain with Cryptopasta
Together, we can build a whole new world of mystery and intrigue on the blockchain. Fuel your imagination, embark on an adventure, and uncover the secrets of Cryptopasta.
Cryptopasta brings urban legend storytelling to the blockchain realm. Imagine a hidden space between blockchain layers, inhabited by unknown entities, or a 'meme killer' that targets and eliminates meme coins.
Cryptopasta invites you to become an agent, crafting your own lore and exploring the blockchain through a thrilling text-based adventure game. Accessible to all, regardless of technical expertise, this game makes learning about blockchain concepts and terminology both fun and interactive.
Together, we can build a whole new world of mystery and intrigue on the blockchain. Fuel your imagination, embark on an adventure, and uncover the secrets of Cryptopasta.
Blockchain realms are often enigmatic, filled with complex concepts and terminology that can be challenging for newcomers. Despite the abundance of educational resources, they can be uninspiring and dry, making it difficult for users to retain information. As a result, many potential users are deterred from exploring the blockchain space, missing out on the excitement and opportunities it offers.
As a fan of urban fantasy like SCP Foundation and Creepypasta, I wondered what makes people fascinated by these stories. I found that there are two key factors:
- Stimulation of Raw Emotions: These stories evoke human raw emotions like fear, curiosity, and excitement.
- Community-Driven Content: They provide a wealth of base content that can be expanded by anyone, leading to derivative works such as fan art, fan fiction, and games created by the community.
These insights led me to consider how we could leverage these elements to attract more users to the blockchain space by entertaining and educating them with engaging content.
Based on these insights, I decided to create a text-based adventure game that merges interactive storytelling with blockchain technology. By allowing users to craft their own stories and explore the blockchain realm, Cryptopasta makes learning fun and engaging. Our goal is to attract a wider audience to the blockchain space and inspire a new generation of blockchain enthusiasts. Furthermore, we aim to expand the world of Cryptopasta with derivative works created by the community.
- Social Login: Users can log in using their social media accounts, simplifying access to the dApp.
- Account Abstraction:
- Users can create smart contract accounts and interact with the blockchain without needing to understand the underlying technology.
- Transaction fees can be sponsored by a Paymaster, making it easier for users to use the dApp.
- The native account abstraction (AA) of zkSync allows transactions to be processed at the protocol level without third-party involvement.
- more details: zksync
- User-friendly Interface: The UI is designed to be intuitive, guiding users through the game with ease.
- USD Pricing: Implement USD-based pricing leveraging Chainlink Price Feeds for transactions to enhance user convenience and reduce complexity associated with cryptocurrency price fluctuations.
- User-generated Content: Users can create and share their own stories, contributing to the Cryptopasta lore and earning rewards for their creativity.
- Blockchain Integration: Each user-created story is tokenized and stored on the blockchain, ensuring transparency and immutability. Memorable game scenes can also be captured and stored as NFTs.
- Onboarding to the Blockchain: The game can introduce newcomers to blockchain concepts and terminology in an engaging and interactive manner.
- Interactive Storytelling: The game features an AI-powered, text-based adventure where users can craft their own stories and explore the blockchain realm. Each choice impacts the storyline, creating a unique experience for every player.
- Community Engagement: Users can share their stories within the community, rate and comment on others' stories, and participate in discussions. This fosters a sense of community and collaboration, encouraging users to learn from one another.
- Ownership and Rewards: Users retain ownership of their stories, which are tokenized on the blockchain. They can earn rewards for their contributions, such as creating popular stories or completing community challenges.
- Attempted to use foundry-zksync for smart contract development.
- Required
via-irflag to compile, which is slow on my machine. - Bytecode differs from that generated by Hardhat, causing the account abstraction contract to malfunction.
- Contract verification is not supported yet.
- Chose Hardhat for stable smart contract development.
- Added missing features (e.g., safeTransfer Receiver, multicall) to the account abstraction contract to ensure proper functionality.
- Considered using Ollama, a local LLM framework, for the AI-powered text-based adventure game.
- My machine's GPU is insufficient for the required computations.
- Running it on the cloud would be costly and time-consuming.
- Opted for OpenAI's GPT-4o model, which is more powerful and efficient for testing and development.
- GPT-4o enhances gameplay, making it more natural and engaging, providing a better user experience.
- Initially designed to integrate AI with the blockchain for transparency, immutability, and interaction cost tracking.
- This approach required users to pay for each AI interaction, which could be costly and deter gameplay.
- Chainlink functions is not supported on the zkSync Sepolia network, thus it is hard to use it and native account abstraction of zkSync together.
- Decided to keep AI operations off-chain to reduce costs and improve user experience.
- The game is played off-chain, with only selected storylines tokenized and stored on the blockchain.
- This approach ensures users can enjoy the game without incurring high transaction fees, making it more accessible and engaging.
- Currently using WebSocket for real-time interactions between the web app and the server.
- WebSocket is bidirectional and can handle multiple connections, but it requires more resources and may not scale well.
- SSE is a more lightweight alternative that can handle real-time updates in unidirectional communication from the server to the client.
- Consider switching to SSE for real-time updates in the web app and server communication to improve scalability and resource efficiency.
-
Credits and Rewards System: Introduce a credit system to manage and limit the number of interactions a user can have with the game, preventing excessive resource consumption. Implement a reward mechanism where users receive incentives based on the quality and popularity of their stories, promoting creativity and active participation.
-
Governance Mechanism: Establish a Decentralized Autonomous Organization (DAO) to allow the community to vote on qualified stories and manage reward distribution. This approach ensures transparency, fairness, and community involvement in decision-making processes. Community members can propose and vote on new features, improvements, and content.
-
Community Discussions and Forums: Develop a dedicated platform for users to discuss stories, share tips, and collaborate on new ideas. This space would enhance community engagement, foster collaboration, and support the exchange of knowledge and experiences.
 |
|---|
| piatoss3612 |
| Fullstack Developer |
| piatoss3612@gmail.com |
| Attract the world to the blockchain! |
This project is licensed under the MIT License. See the LICENSE file for more details.