> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/contributor/contributor-es/arquitectura/architecture.md). # Resumen Decentraland es una plataforma de mundo virtual descentralizado construida sobre una arquitectura híbrida que combina la propiedad en blockchain, la entrega de contenido descentralizada y servicios centralizados para una mejor experiencia de usuario. ## Principios arquitectónicos ### Descentralización donde importa * **Propiedad** - LAND, wearables y names son NFTs en Ethereum * **Gobernanza** - DAO controla los smart contracts críticos y la tesorería * **Contenido** - Distribuido a través de nodos Catalyst * **Identidad** - Autenticación basada en Wallet (sin contraseñas) ### Centralización para el rendimiento * **Servicios en tiempo real** - Comunicaciones WebSocket, chat de voz * **Descubrimiento** - Búsqueda, eventos, contenido destacado * **Funciones sociales** - Amigos, comunidades, notificaciones * **Optimización** - Procesamiento de assets, generación de imágenes ## Capas del sistema ### Clients Los jugadores interactúan a través de varios clients: * **Unity Explorer** - Cliente de escritorio principal (Windows, Mac, Linux) * **Web Explorer** - Cliente basado en navegador * **CLI** - Herramienta para developers para la creación y el deployment de escenas * **Clients de la comunidad** (móvil, VR, etc.) - Implementaciones alternativas para el client de referencia usando diferentes tecnologías de renderizado. Todos los clients se autentican mediante Wallets crypto y siguen los mismos protocolos. ### Discovery (Realm Provider) Punto de entrada único que proporciona a los clients una descripción de realm: * Nodos Catalyst disponibles (ubicación, capacidad, estado de salud) * Endpoints de servicios backend Permite una selección inteligente de servidor según la geografía y la carga. ### Contenido descentralizado (Catalyst Network) Red sin permisos de nodos Catalyst que almacenan y sirven: * Definiciones de escenas y assets * Perfiles de Avatar y wearables Cada nodo valida y almacena contenido de forma independiente. Los nodos sincronizan los deployments, pero operan de manera autónoma. Ver [Catalyst Network](/contributor/contributor-es/arquitectura/catalyst.md) para más detalles. ### Servidores de funciones centralizadas Los microservicios backend proporcionan funcionalidad mejorada: * **Descubrimiento de servicios** - Selección de realm y monitoreo del estado * **Comunicaciones** - Clustering de WebSocket, control de acceso a voz/video * **Funciones de contenido** - Worlds, eventos, lugares, datos del atlas * **Funciones sociales** - Amigos, comunidades, notificaciones * **Funciones de la plataforma** - Logros, recompensas, créditos virtuales * **Procesamiento de assets** - Optimización, miniaturas, traducciones Ver [Servicios backend](/contributor/contributor-es/arquitectura/services.md) para la documentación completa de los servicios. ### Infraestructura Sistemas de soporte y servicios de terceros: * **Message Broker** - NATS para la comunicación entre servicios * **Media Server** - LiveKit para voz y video * **Indexadores de blockchain** - Consultas rápidas para datos de NFT * **Servicio de correo electrónico** - SendGrid para notificaciones Ver [Infraestructura](/contributor/contributor-es/arquitectura/infrastructure.md) para más detalles. ### Blockchain Smart contracts en Ethereum y Polygon gestionan: * **Propiedad** - LAND, wearables, names, estates * **Marketplace** - Trading y royalties * **DAO** - Gobernanza y tesorería * **Moneda** - Token MANA ## Modelo de seguridad ### Identidad y autenticación * **Firmas de Wallet** - Sin contraseñas, autenticación mediante firmas de Ethereum * **Servidor de autenticación** - Emite tokens JWT después de verificar la firma * **Signed Fetch** - Las APIs autentican las solicitudes usando firmas de Wallet ### Validación de contenido * **Verificación de firma** - Todos los deployments firmados por Wallet * **Propiedad del puntero** - Solo el owner de LAND puede hacer deployment en coordenadas * **Límites de tamaño** - El tamaño del contenido está restringido por el número de parcels ### Control de acceso * **Tokens con tiempo limitado** - Los tokens JWT y LiveKit expiran * **Limitación de tasa** - Límites de tasa de la API por IP/usuario * **Protección DDoS** - Red distribuida de Catalyst ## Enfoque de escalabilidad ### Escalado horizontal * **Nodos Catalyst** - Añadir nodos a medida que crece el contenido * **Servicios backend** - Los microservicios sin estado escalan de forma independiente * **Islands** - Las comunicaciones se dividen en grupos basados en proximidad ### Optimización * **Paquetes de assets** - Assets optimizados para la plataforma (Unity bundles) * **CDN** - Assets estáticos servidos a través de CDN * **Caché** - Caché agresiva en todas las capas * **Indexadores** - Datos de blockchain almacenados en cachés en bases de datos rápidas ## Próximos pasos Profundiza más en áreas arquitectónicas específicas: * [**Servicios backend**](/contributor/contributor-es/arquitectura/services.md) - Especificaciones detalladas de servicios e integraciones * [**Catalyst Network**](/contributor/contributor-es/arquitectura/catalyst.md) - Entrega y deployment de contenido * [**Infraestructura**](/contributor/contributor-es/arquitectura/infrastructure.md) - Sistemas de soporte y servicios de terceros ## Recursos adicionales * [Referencia de API](https://github.com/decentraland/docs/tree/main/apis/README.md) - Documentación completa de la API * [Contributor Guides](/contributor/contributor-es/guias-para-colaboradores/contributor-guides.md) - Estándares de desarrollo * [Organización de GitHub](https://github.com/decentraland) - Repositorios de código fuente --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.decentraland.org/contributor/contributor-es/arquitectura/architecture.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.