Dojo: The Provable Game Engine

Dojo is a community driven open-source, Provable Game Engine, providing a comprehensive toolkit for building verifiable games and autonomous worlds.

You can get started by simply bootstrapping dojo world like so. You will need dojo installed.

npx @dojoengine/create-dojo

Contributing to dojo.js

Dojo.js is MIT licensed and welcomes contributors. Setting up your environment is simple.

From the repository root, run the following to install all the necessary package dependencies:

pnpm install

Building Packages:

Note: Before running the examples, you must build each package.

To do so, navigate to a specific package directory and run the command below. This will initiate pnpm in watch mode, which will automatically compile and update based on local changes:

pnpm run build --watch

To build all packages, from the root directory, run:

pnpm run build

To watch for changes on all packages in parallel, from the root directory, run:

pnpm run build-watch

Dojo starter:

To install dojo-starter submodule (which allows interactions with the examples), run:

git submodule update --init --recursive

Debugging

If you have issues on WSL, install package first then run command:

npm i @dojoengine/create-dojo -g
npx @dojoengine/create-dojo

Examples

To run the examples that have the linked packages, follow the steps below:

Terminal 1: Set up the dojo starter with specific configurations.

cd examples/dojo-starter
katana --disable-fee --block-time 1000

Terminal 2: Build and migrate the dojo starter.

cd examples/dojo-starter
sozo build
sozo migrate

Terminal 3: Start the React app.