Slot Deploy
Manage the lifecycle of Slot deployments — Katana (execution layer) and Torii (indexer).
Prerequisites
Install the Slot CLI:
curl -L https://slot.cartridge.sh | bash
Authenticate:
slot auth login
For CI/scripts, generate a token and set the SLOT_AUTH env var:
slot auth token
Creating Deployments
Katana
slot deployments create <Project Name> katana
Torii
Torii requires a TOML configuration file:
slot deployments create <Project Name> torii --config <path/to/torii.toml>
Minimal torii.toml :
rpc = "https://api.cartridge.gg/x/starknet/mainnet" world_address = "0x3fa481f41522b90b3684ecfab7650c259a76387fab9c380b7a959e3d4ac69f"
Extended config options:
[indexing] allowed_origins = ["*"] index_pending = true index_transactions = false polling_interval = 1000 contracts = [ "erc20:<contract-address>", "erc721:<contract-address>" ]
[events] raw = true historical = ["namespace-EventName"]
When you create a service with a new project name, a team is automatically created.
Updating Deployments
slot deployments update <Project Name> torii --version v1.0.0 slot deployments update <Project Name> torii --config <path/to/torii.toml> slot deployments update <Project Name> torii --replicas 3
Deleting Deployments
slot deployments delete <Project Name> <katana | torii>
Inspecting Deployments
List all deployments
slot deployments list
View configuration
slot deployments describe <Project Name> <katana | torii>
Read logs
slot deployments logs <Project Name> <katana | torii>
View predeployed Katana accounts
slot deployments accounts <Project Name> katana
Transferring Services
Transfer a service to another team:
slot d transfer <Project Name> <katana | torii> <To Team Name>
Observability
Enable Prometheus and Grafana monitoring ($10/month per deployment).
On creation
slot deployments create <Project Name> --observability katana slot deployments create <Project Name> --observability torii --config <path/to/torii.toml>
On existing deployment
slot deployments update <Project Name> --observability katana slot deployments update <Project Name> --observability torii
Accessing dashboards
-
Prometheus: https://<deployment-url>/prometheus
-
Grafana: https://<deployment-url>/grafana
Both are protected by username/password credentials provided when observability is enabled.