Skip to content

ROF Smart Contracts v1.0

Addresses (Base Network)

  • Farm Manager: 0x4f97765617a6fc188E0A28a0678d529508F51f78
  • Item Data Store: 0x07596444051EFDF0499d690f04971C5576327f05
  • Farm NFT: 0x6F907A73373d42b35eC349a95c50c7EFCCAe902F
  • Game Items: 0x204d7C962505fF8FD461A632e8227a6FCC22A4d5
  • Leaderboard Manager: 0x890989ee93d86e960137eA11D78e292139D274EC
  • Trading Hub: 0xf6C1002cb5706A0cB627386aD1Ca36122900373E

Glossary

Farm NFT

An ERC721 token representing a player's farm. Each user must own a Farm NFT to participate in the game, as it symbolizes their virtual farm.

Farm Manager

Smart contract that handles the core game mechanics, such as planting, harvesting, using items, burning crops, crafting items, and other farm-related operations.

Leaderboard Manager

A contract managing the monthly leaderboard prize pool. It collects funds from the marketplace and may receive external/sponsor contributions, allowing users to claim their prizes.

Items Data Store

A storage contract containing all in-game item data, such as growth times, XP gained from harvesting crops, crafting recipes, and additional item metadata.

Game Items (ERC1155)

ERC1155 tokens representing all in-game objects, including seeds, crops, fertilizers, boosters, and other crafted or earned game items.

Trading Hub

The peer-to-peer marketplace with an on-chain order book. Supports:

  • USDC ↔ ERC1155 trading
  • ERC1155 ↔ ERC1155 bartering*

*not currently supported in the app.

The Trading Hub can only be used by holding a FarmNFT token.

Notes

The game has just launched and is currently in its first stage. During this initial period, the Builders Garden team maintains certain administrative permissions on the protocol. This allows us to ensure the game launches smoothly, verify that everything works as expected, and quickly address any potential bugs in the contracts or economic imbalances.

After this first period, we may renounce some or all of these privileged admin permissions as the game matures.

Upgradability

Farm Manager and Items Data Store are upgradable by the admin. This enables us to fix bugs, improve game mechanics, and adjust economic parameters during the initial launch phase.

Admin Permissions

The protocol includes the following relevant administrative roles:

  • Game Admin: Can change game settings on all main contracts. This includes adjusting parameters such as growth times, XP values, crafting recipes, and other gameplay mechanics.

  • Minter Role: Can mint FarmNFT, GameItems and Farm License tokens. This allows the team to:

    • Balance the game economy during the initial launch including market making activities
    • Run incentivized campaigns
    • Distribute rewards (eg. seed packs)
    • Support community growth initiatives