BranchRPG is an example app to showcase smart account features for a web3 game. It is built on the ERC-4337 standard along with several open source tools:
- Game engine: RPG JS
- Contract accounts: zerodevapp/kernel
- JS SDK: userop.js
🚀 Are you building a web3 game and looking for access to hosted account abstraction infrastructure? Check out stackup.sh!
By design, this demo is extremely simple. The game state and every action is handled through an ERC-20 smart contract on Polygon Mumbai. The use of ERC-4337 contract accounts allows us to improve the UX by introducing batched and gas-less transactions.
The aim of the game is simply to:
- Fetch some water (an ERC-20 mint transaction)
- Water the garden patch (an ERC-20 burn transaction)
- Watch the global score increase as more people do the same thing.
The global score is a state stored on the contract. Which mean the business logic for this game is entirely decentralized.
Since the state of the game world is entirely on-chain, you can fork this repo, run a local instance, and make the client your own while still accessing the same score as the Stackup hosted version.
To run a local version:
# Copy and fill in the env variables.
# NODE_RPC_URL must be enabled to accept ERC-4337 bundler methods.
# PAYMASTER_RPC_URL should follow https://hackmd.io/@stackup/H1oIvV-qi
# Paymaster is optional. If not set, your account will need MATIC for gas.
cp .env.example .env
# RPG JS v3 is only compatible on Node v14.
npm install
npm run devDistributed under the MIT License. See LICENSE for more information.
Feel free to direct any technical related questions to the dev-hub channel in the Stackup Discord.