Dojo Configuration Management Skill

Dojo Configuration Management

Manage Dojo project configuration including Scarb.toml, deployment profiles, and world settings.

When to Use This Skill

"Configure Dojo for my project"
"Update Scarb.toml dependencies"
"Set up deployment profiles"
"Configure world settings"

What This Skill Does

Manages configuration files:

Scarb.toml - Package and dependencies
dojo_dev.toml - Local development profile
dojo_release.toml - Production deployment profile
World configuration and namespaces

Quick Start

Interactive mode:

"Update my Dojo configuration"

I'll ask about:

What to configure (dependencies, profiles, world)
Environment (dev, testnet, mainnet)
Specific settings

Direct mode:

"Add the Origami library to my dependencies"
"Configure production deployment for Sepolia"

Configuration Files

Scarb.toml

Package manager configuration:

[package]
name = "my_game"
version = "0.1.0"
edition = "2024_07"

[dependencies]
dojo = { git = "https://github.com/dojoengine/dojo", tag = "v1.0.0" }

[[target.dojo]]

[tool.dojo]
initializer_class_hash = "0x..."

[tool.dojo.env]
rpc_url = "http://localhost:5050/"
account_address = "0x..."
private_key = "0x..."
world_address = "0x..."

Key sections:

[package] - Project metadata
[dependencies] - Dojo and library versions
[[target.dojo]] - Build target
[tool.dojo] - Dojo-specific settings
[tool.dojo.env] - Environment variables

dojo_dev.toml

Local development configuration:

[env]
rpc_url = "http://localhost:5050/"
account_address = "0xb3ff441a68610b30fd5e2abbf3a1548eb6ba6f3559f2862bf2dc757e5828ca"
private_key = "0x2bbf4f9fd0bbb2e60b0316c1fe0b76cf7a4d0198bd493ced9b8df2a3a24d68a"
world_address = ""

[world]
name = "my_game"
seed = "my_game"

dojo_release.toml

Production deployment configuration:

[env]
rpc_url = "https://api.cartridge.gg/x/starknet/sepolia"
account_address = "YOUR_ACCOUNT_ADDRESS"
private_key = "YOUR_PRIVATE_KEY"
world_address = "DEPLOYED_WORLD_ADDRESS"

[world]
name = "my_game_production"
seed = "my_game_prod"

Common Configuration Tasks

Add Dependencies

Origami library:

[dependencies]
origami_token = { git = "https://github.com/dojoengine/origami", tag = "v1.0.0" }

Alexandria library:

[dependencies]
alexandria_math = { git = "https://github.com/keep-starknet-strange/alexandria" }

Configure Profiles

Development (Katana):

[env]
rpc_url = "http://localhost:5050/"
account_address = "0xb3ff441a68610b30fd5e2abbf3a1548eb6ba6f3559f2862bf2dc757e5828ca"

Testnet (Sepolia):

[env]
rpc_url = "https://api.cartridge.gg/x/starknet/sepolia"
account_address = "YOUR_ACCOUNT"

Mainnet:

[env]
rpc_url = "https://api.cartridge.gg/x/starknet/mainnet"
account_address = "YOUR_ACCOUNT"

World Configuration

Namespace setup:

[world]
name = "my_game"
namespace = "my_game"
seed = "my_game_v1"

Description and metadata:

[world]
name = "my_game"
description = "A provable on-chain game"
icon_uri = "https://example.com/icon.png"
cover_uri = "https://example.com/cover.png"

Configuration Patterns

Multi-Environment Setup

Create separate profile files:

dojo_dev.toml - Local Katana
dojo_sepolia.toml - Sepolia testnet
dojo_mainnet.toml - Mainnet

Deploy with:

sozo migrate --profile dev
sozo migrate --profile sepolia
sozo migrate --profile mainnet

Version Management

Pin Dojo version:

[dependencies]
dojo = { git = "https://github.com/dojoengine/dojo", tag = "v1.0.0" }

Use latest:

[dependencies]
dojo = { git = "https://github.com/dojoengine/dojo" }

Account Configuration

Development (Katana default):

account_address = "0xb3ff441a68610b30fd5e2abbf3a1548eb6ba6f3559f2862bf2dc757e5828ca"
private_key = "0x2bbf4f9fd0bbb2e60b0316c1fe0b76cf7a4d0198bd493ced9b8df2a3a24d68a"

Production (Argent/Braavos):

account_address = "YOUR_WALLET_ADDRESS"
private_key = "YOUR_PRIVATE_KEY"  # Store securely!

Best Practices

Never commit private keys - Use .gitignore for dojo_release.toml
Pin versions - Use specific tags for production
Separate profiles - Different configs for dev/test/prod
Document settings - Add comments explaining non-obvious config
Test configurations - Verify RPC connectivity before deploying

Security

Protecting Secrets

Option 1: Environment variables

[env]
private_key = "${DOJO_PRIVATE_KEY}"

Option 2: Separate secrets file

# dojo_release.toml (committed)
[env]
rpc_url = "https://api.cartridge.gg/x/starknet/mainnet"

# dojo_secrets.toml (gitignored)
[env]
account_address = "..."
private_key = "..."

.gitignore

# Ignore sensitive configs
dojo_release.toml
dojo_secrets.toml
dojo_*.toml

# Keep development config
!dojo_dev.toml

Troubleshooting

"World not found":

Check world_address is set after migration
Verify RPC URL is correct

"Account not found":

Ensure account is deployed on target network
Check account_address format

"Invalid private key":

Verify private key starts with "0x"
Ensure no extra whitespace

Next Steps

After configuration:

Use dojo-deploy skill to deploy with your config
Use dojo-migrate skill when updating deployments
Use dojo-init skill to regenerate configs if needed

Related Skills

dojo-init: Initialize configuration
dojo-deploy: Deploy using configuration
dojo-migrate: Update deployed worlds
dojo-world: Manage world permissions

Agent Skills: Dojo Configuration Management

Skill Files