Warhead is an interactive treasure hunt and community game designed to engage users in two modes: Open Drop and Friend-to-Friend Drop. The game leverages geolocation to create immersive and fun experiences for both individual users and groups.

The smart contracts for Warhead have been deployed on Linea Mainnet and Mantle Mainnet.

1. WarheadFactory
2. WarheadNft
3. ERC6551Account
4. ERC6551Registry
5. LocationRegistry

The WarheadFactory contract manages the creation, launching, and claiming of warheads.

The WarheadNft contract implements an ERC721 token representing the warhead and uses ERC6551Registry for creating token-bound smart accounts to hold rewards.

• Open Drop Mode

  • Drop a warhead at a specific location filled with rewards.
  • People present at that location at the specified time can collect the reward.

• Friend-to-Friend Drop Mode

  • Send money or rewards to a friend by dropping a warhead at a specific location.
  • The friend must go to the designated location to collect the reward.

• WarheadCreated(uint256 warheadId, address dropper, address warheadAddress)
• WarheadCreatedWithReceiver(uint256 warheadId, address dropper, address warheadAddress, address targetReceiver)
• WarheadDropped(uint256 warheadId, int256 targetLat, int256 targetLong, uint256 impactTime)
• WarheadClaimed(uint256 warheadId, address claimer, uint256 claimedAt)

To create a new warhead, call the createWarhead function with the target receiver's address.

function createWarhead(address targetReceiver) external;

To drop a warhead at a specific location, call the dropWarhead function with the warhead ID, coordinates, and impact time.

function dropWarhead(uint256 warheadId, Coord memory coord, uint256 impactTime) external;

To claim a warhead, call the claim function with the location coordinates and warhead ID.

function claim(Coord calldata location, uint256 warheadId) external;

To fetch the information of a specific warhead, call the fetchWarheadInfo function with the warhead ID.

function fetchWarheadInfo(uint256 warheadId) public view returns (WarheadObject memory);

The subgraph for this project is deployed on The Graph Protocol and can be accessed via the following link:

• Warheads Subgraph

The substream for this project is available at:

• Warheads Substream

• The contracts use Ownable for access control.
• Geolocation and time checks ensure the integrity of the game mechanics.
• The WarheadNft contract secures rewards using ERC6551 token-bound smart accounts.

For security issues or inquiries, please contact: [email protected]

This project is licensed under the MIT License.

This project utilizes OpenZeppelin's smart contract library for secure and reliable contract development.

Use the contracts at your own risk. The authors are not responsible for any loss of funds or damages incurred from using these contracts.