Skip to content

CodeHawks-Contests/2025-04-eggstravaganza

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EggHuntGame: Eggstravaganza NFT Hunt


EggHuntGame


Contest Details

Prize Pool

  • High - 100xp

  • Medium - 20xp

  • Low - 2xp

  • Starts: TBD

  • Ends: TBD

Stats

  • nSLOC: 129
  • Complexity Score: Moderate

About the Project

About

EggHuntGame is a gamified NFT experience where participants search for hidden eggs to mint unique Eggstravaganza Egg NFTs.
Players engage in an interactive hunt during a designated game period, and successful egg finds can be deposited into a secure Egg Vault.

DocumentationWebsiteTwitterGitHub

Actors

Actors:
    Game Owner: The deployer/administrator who starts and ends the game, adjusts game parameters, and manages ownership.
    Player: Participants who call the egg search function, mint Egg NFTs upon successful searches, and may deposit them into the vault.
    Vault Owner: The owner of the EggVault contract responsible for managing deposited eggs.

Scope (contracts)

All contracts in the `src` directory are in scope.
src/
├── EggHuntGame.sol       // Main game contract managing the egg hunt lifecycle and minting process.
├── EggVault.sol          // Vault contract for securely storing deposited Egg NFTs.
└── EggstravaganzaNFT.sol // ERC721-style NFT contract for minting unique Egg NFTs.

Compatibilities

Compatibilities:
  Blockchains:
      - Ethereum / Any EVM-compatible chain
  Tokens:
      - Custom ERC721 EggstravaganzaEggNFT tokens

Setup

Build

forge build

Deployment

  1. Deploy EggstravaganzaEggNFT Contract:
    This contract handles the minting of unique Egg NFTs.
  2. Deploy EggVault Contract:
    Acts as the secure vault for storing Egg NFTs.
  3. Deploy EggHuntGame Contract:
    Initialize by passing in the deployed addresses of the Egg NFT and Egg Vault contracts.
  4. Set Ownership:
    Ensure the deployer (or designated admin) holds ownership to manage game functions.

Running Tests

forge test

None Reported!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published