📘
Play it live
https://branch-rpg.stackup.sh/

Getting Started

View the code here: https://github.com/stackup-wallet/branch-rpg

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

Game Play

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.

Running an Instance

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 dev

License

Distributed under the MIT License.