Deploy Dojo worlds to local Katana, testnet, or mainnet. Configure Katana sequencer and manage deployments with sozo. Use when deploying your game or starting local development environment.
Instrucciones de origen · Vista previa de solo lectura
name
dojo-deploy
description
Deploy Dojo worlds to local Katana, testnet, or mainnet. Configure Katana sequencer and manage deployments with sozo. Use when deploying your game or starting local development environment.
allowed-tools
Read, Bash, Grep
Dojo Deployment
Deploy your Dojo world to local Katana sequencer, Sepolia testnet, or Starknet mainnet.
When to Use This Skill
"Deploy my world to Katana"
"Start Katana sequencer"
"Deploy to Sepolia testnet"
"Deploy to mainnet"
What This Skill Does
Handles deployment workflows:
Start and configure Katana sequencer
Deploy worlds with sozo migrate
Verify deployments
Manage world addresses
Configure network settings
Quick Start
Local development:
"Start Katana and deploy my world"
Testnet deployment:
"Deploy my world to Sepolia"
Mainnet deployment:
"Deploy to Starknet mainnet"
Deployment Workflow
1. Local Development (Katana)
Start Katana:
katana --dev --dev.no-fee
This launches Katana with:
RPC server at http://localhost:5050
10 pre-funded accounts
Instant block mining
Gas fees disabled
Build and deploy:
sozo build && sozo migrate
Verify:
# Preview deployment
sozo inspect
# Execute a system
sozo execute dojo_starter-actions spawn
When using Cartridge Controller locally, Katana must deploy Controller contracts at genesis.
Without this, Controller transactions fail with "Requested contract address ... is not deployed".
# katana.toml[cartridge]paymaster = true# Enables paymaster AND deploys Controller contracts at genesis
Note: paymaster = true implicitly enables controllers = true.
See the Controller setup docs for client-side configuration.
This skill includes deploy_local.sh, a template script for automated local development.
Copy it into your project's scripts/ directory and customize it for your needs.
Setup:
Copy the script to your project: cp deploy_local.sh your-project/scripts/
Adjust configuration variables (profile name, URLs) as needed
Make executable: chmod +x scripts/deploy_local.sh
Run:
# Default dev profile
./scripts/deploy_local.sh
# Specific profile
PROFILE=staging ./scripts/deploy_local.sh
What it does:
Checks for required tools (katana, sozo, torii, jq)