CryptoClash: Strategic Battles for Market Dominance

Dive into our strategy game, becoming both a cunning currency issuer and a ruthless investor. Promote your currency to skyrocket it, strategically trade opponents' tokens, and make massive profits!

Comment

Inspiration

AI's Potential

Inspired by the powerful capabilities of AI, we are developing an economic strategy game that leverages AI to revolutionize and enhance game mechanics. We discovered that AI can be utilized for dynamic simulation and price prediction based on the prompts we provide.

Madness of Crypto

Beyond AI's abilities, we've been captivated by the wild, unpredictable nature of the crypto world, especially the exhilarating chaos of pump-and-dump schemes that happen all too often. This frenetic madness has not only inspired us but has become the centerpiece of our game, promising an electrifying and unpredictable gameplay experience where fortunes can be made or lost in the blink of an eye.

What It Does

Token Issuance and Management

This game provides players with the opportunity to learn about and simulate investments, while also allowing them to experience working with and issuing their own currencies, such as controlling the number of their tokens on the market. This innovative approach aims to educate and engage players in the complexities of financial strategies and cryptocurrency markets, making learning both interactive and enjoyable.

Trade Other Players’ Tokens to Profit or Dump the Price

In addition to managing their own tokens, players can trade others' tokens to make a profit. However, be cautious—after purchasing other tokens, their price may increase, benefiting the token issuer! Conversely, you can accumulate a significant amount of a token and then sell it all to dump the price. This is why our game dApp is called a strategy game, as it incorporates elements of game theory.

Interplay Between AI-Powered Market Simulation and Players' Actions

Players' decisions will be closely monitored by the AI, which will simulate market responses based on their actions, creating a dynamic and interactive gameplay experience. As players make moves to promote their currencies, trade tokens, and strategize their investments, the AI will adjust the market conditions accordingly. This continuous feedback loop ensures that every decision has a significant impact, challenging players to think ahead and adapt their strategies in real-time.

More Randomness to The Market

Will the market be influenced solely by players? Absolutely not. To more accurately simulate the real-world financial environment, we've introduced elements of randomness to the game. Market conditions can be unpredictably affected by random events, causing certain token prices to fluctuate dramatically. These random events ensure that no two game sessions are ever the same, compelling players to remain vigilant, adaptable, and ready to seize opportunities or mitigate risks at any moment. This infusion of randomness not only enhances realism but also keeps the gameplay thrilling and unpredictable, mirroring the volatile nature of real-world markets.

How We Built It

Since we're building a game dApp supported by Chainlink products, it's better to have a central contract for creating new game instances, receiving Chainlink responses, and then distributing the responses to certain game instances.

UpperControl.sol - Management Contract

It serves three main functionalities:

  1. Contract Factory: Responsible for allowing players to create and record new games
  2. Game Instances Tracking: Monitors the state of game instances to prevent unauthorized access.
  3. Chainlink Callee and Information Distributor: UpperControl is subscribed to Chainlink Functions and VRF. When it receives data from Chainlink, it distributes it to designated game instances or performs specific actions on them.

UpperControl.sol Etherscan

When a game instance needs random words or AI-generated data, it sends a signal along with information or prompts to UpperColtrol, and then UpperControl requests Chainlink VRF or Functions. After it’s triggered by Chainlink, it sends received data back to the game instances. (See picture two on the top for a more detailed structure)

Game.sol - Game Logic and Flow

  1. Players enter the game with an entry fee.
  2. Players issued their own tokens and have 10000 stable coin initially.
  3. Contract asks for random words and uses them to trigger random event types. (e.g., A company bought a token issued by player 1, so his token price pumps up.)
  4. Contract sends random event type to AI along with token prices currently.
  5. AI generates a detailed random event and decides each token price after the event then sends it back to the game contract.
  6. Players will be notified of the event details and know the prices change.
  7. Contract updates token prices.
  8. Players receive the AI assistant’s investment advice and then buy and sell tokens issued by him and other players according to new token prices. (Players attempt to make a profit and dump prices of tokens issued by others to make them lose money.)
  9. Loop for ten rounds, except the first round, AI will receive random event types, players’ trade action, and token prices now to generate more precise prices. After ten rounds, settle each player’s total balance(All the tokens issued by each player + stable coin) to decide the winner. The winner receives the entry fee of all players.

Chainlink Products Used

  • Chalink Functions: provide random events and then generate new prices based on players' actions, event details, and token prices currently. Also serves as players' investment assistant.

  • Chainlink VRF: decide which random event type to be triggered.

  • Chainlink Called Tx

Challenges We Ran into

  1. When we use an LLM for generating responses, it doesn't save the chat history like in conversations between humans and AI.
  2. Requesting AI caused overtime errors frequently.
  3. Ran out of test tokens often.

Accomplishments That We're Proud of

  1. We managed to solve the AI requesting issues mentioned above by several methods. If AI can't save the previous chat, then we add the condensed chat history as a recap to the prompt. When encountering overtime errors, we shorten the prompt, only containing the most important information that would affect the token prices.

What We Learned

  1. How to integrate smart contracts with Chainlink products to make imaginary things possible.
  2. The design of smart contract architecture will deeply affect the user interaction and test difficulty.

What's Next For CryptoClash

Upgradeability

Currently, both UpperControl.sol and Game.sol aren’t upgradeable. This feature will be implemented soon.

Thorough Testing

Our contracts are tested with several unit tests now. Further unit tests and integration tests should be done to ensure more code coverage.

More Clean Chainlink Subscription Code

Currently, we make UpperControl.sol subscribed to Chainlink, and send received data to game instances. However, a better way is to make UpperControl.sol the subscription creator(add createSubscription method to the code) and add each game instance as a consumer(add addConsumer.sol to the code), then remove consumer after the game finished(add removeConsumer to the code). Due to limited time, we haven’t implemented it yet.

Built With

Share this project:

Updates