Slot es un servicio gestionado que ofrece instancias alojadas de Katana y indexadores Torii para juegos Dojo. Esta guía explica paso a paso el flujo completo de despliegue, desde la autenticación hasta la puesta en producción. En Q2BSTUDIO impulsamos proyectos con software a medida y aplicaciones a medida, combinando inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi para acelerar la innovación. Si necesitas acompañamiento experto en despliegues y arquitectura, podemos ayudarte con servicios cloud aws y azure y con el desarrollo de aplicaciones a medida.
Prerrequisitos
Asegúrate de tener instalada la última versión de Dojo.
Comando sugerido: dojoup
Configuración de autenticación
Inicio de sesión inicial
Ejecuta: slot auth login
Se abrirá el navegador para completar la autenticación. Sigue las indicaciones hasta finalizar el proceso.
Solución de problemas de autenticación
Si aparecen problemas por credenciales antiguas, elimínalas y vuelve a iniciar sesión.
Comandos: rm ~/Library/Application Support/slot/credentials.json
Luego: slot auth login
Despliegue del backend Katana
Inicializa tu proyecto
Crea o entra a tu proyecto Dojo: sozo init dojo-starter && cd dojo-starter
Crea el despliegue de Katana
Comando: slot deployments create my-dojo-game katana
Este comando crea una instancia Katana, devuelve una URL de endpoint RPC y proporciona credenciales de cuenta únicas.
Configura tu proyecto
Tras el despliegue recibirás una URL RPC. Actualiza tu archivo Scarb.toml con los campos: rpc_url igual a la URL de Katana, account_address con el valor mostrado en los logs, private_key con la clave del despliegue y world_address se agregará tras la migración.
Nota: cada slot de Katana genera semillas de cuenta únicas, por lo que deberás actualizar estos valores en cada despliegue.
Supervisa los logs de Katana
Comando: slot deployments logs my-dojo-game katana -f
Verás logs en tiempo real y la información de cuentas necesaria para la configuración.
Compila y migra
Compila: sozo build
Migra: sozo migrate
Si la migración se completa correctamente, verás un mensaje confirmando el despliegue del World con una dirección tipo 0x seguido de la cadena hexadecimal. Guarda esa dirección como WORLD_ADDRESS para el despliegue de Torii.
Despliegue del indexador Torii
Despliega una instancia Torii usando la dirección del World y el RPC de Katana.
Comando: slot deployments create my-dojo-game torii --world 0x123456... --rpc https://api.cartridge.gg/x/your-deployment-id/katana --start-block 1
Parámetros clave
--world dirección del contrato World
--rpc endpoint de Katana
--start-block bloque desde el que iniciar la indexación usa 1 para el histórico completo
Al finalizar, recibirás el endpoint GraphQL para consultas y el endpoint gRPC para suscripciones en tiempo real.
Supervisa los logs de Torii
Comando: slot deployments logs my-dojo-game torii -f
Así verificas que el indexador sincroniza correctamente con el estado de tu World.
Verificación y pruebas
1 Verifica que Katana está en ejecución probando tu endpoint RPC.
2 Confirma que el World fue migrado correctamente y que las entidades están disponibles.
3 Prueba la indexación de Torii lanzando consultas GraphQL y validando los datos esperados.
Acceso a tus servicios
Ejemplos de endpoints:
Katana RPC: https://api.cartridge.gg/x/your-deployment-id/katana
Torii GraphQL: https://api.cartridge.gg/x/your-deployment-id/torii/graphql
Torii gRPC: https://api.cartridge.gg/x/your-deployment-id/torii
Gestión de despliegues
Listar despliegues activos
Comando: slot deployments list
Eliminar despliegues cuando ya no sean necesarios
Comandos: slot deployments delete my-dojo-game katana
y: slot deployments delete my-dojo-game torii
Mejores prácticas
- Usa un nombre de despliegue consistente para Katana y Torii.
- Mantén abiertos los streams de logs durante los primeros minutos para detectar incidencias.
- Actualiza tu configuración local cada vez que cambien endpoints o credenciales.
- No subas claves privadas ni datos sensibles a tu control de versiones.
Resolución de problemas
- Fallos de autenticación: borra credenciales y vuelve a iniciar sesión.
- Errores de migración: valida la URL RPC y la configuración de cuenta.
- Problemas de sincronización de Torii: revisa la dirección del World y el endpoint RPC.
Cómo obtener ayuda
1 Revisa los logs de despliegue en busca de mensajes de error.
2 Verifica que todos los valores de configuración son correctos y actuales.
3 Asegúrate de estar usando la última versión de Dojo con dojoup.
Enhorabuena, ya tienes un juego Dojo completamente desplegado con el secuenciador Katana y el indexador Torii operando en la infraestructura gestionada de Slot. Tu entorno queda listo para desarrollo y pruebas persistentes y escalables. En Q2BSTUDIO también te ayudamos a extender tu solución con seguridad avanzada, ciberseguridad, automatización y analítica, integrando servicios inteligencia de negocio con power bi y potenciando la ia para empresas con agentes IA para acelerar decisiones y operaciones.