> 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-pt/arquitetura/architecture.md). # Visão geral Decentraland é uma plataforma de mundo virtual descentralizado construída sobre uma arquitetura híbrida que combina propriedade em blockchain, entrega de conteúdo descentralizada e serviços centralizados para uma experiência do usuário aprimorada. ## Princípios Arquiteturais ### Descentralização Onde Importa * **Propriedade** - LAND, wearables e names são NFTs no Ethereum * **Governança** - DAO controla smart contracts críticos e o tesouro * **Conteúdo** - Distribuído entre nós Catalyst * **Identidade** - Autenticação baseada em wallet (sem senhas) ### Centralização para Desempenho * **Serviços em tempo real** - Comunicações WebSocket, chat de voz * **Descoberta** - Busca, eventos, conteúdo em destaque * **Recursos sociais** - Amigos, comunidades, notificações * **Otimização** - Processamento de assets, geração de imagens ## Camadas do Sistema ### Clients Os jogadores interagem por meio de vários clients: * **Unity Explorer** - Client principal para desktop (Windows, Mac, Linux) * **Web Explorer** - Client baseado em navegador * **CLI** - Ferramenta de desenvolvimento para criação e deployment de scenes * **Clients da Comunidade** (mobile, VR, etc) - Implementações alternativas para o client de referência usando diferentes tecnologias de rendering. Todos os clients se autenticam via wallets cripto e seguem os mesmos protocolos. ### Descoberta (Realm Provider) Ponto de entrada único que fornece aos clients uma descrição do realm: * Nós Catalyst disponíveis (localização, capacidade, saúde) * Endpoints de serviços de backend Permite seleção inteligente de servidor com base na geografia e na carga. ### Conteúdo Descentralizado (Catalyst Network) Rede sem permissão de nós Catalyst que armazenam e servem: * Definições de scenes e assets * Perfis de avatar e wearables Cada node valida e armazena o conteúdo de forma independente. Os nodes sincronizam deploys, mas operam de forma autônoma. Veja [Catalyst Network](/contributor/contributor-pt/arquitetura/catalyst.md) para mais detalhes. ### Servidores Centralizados de Recursos Microservices de backend fornecem funcionalidades aprimoradas: * **Descoberta de serviços** - Seleção de realm e monitoramento de saúde * **Comunicações** - Clustering de WebSocket, controle de acesso a voz/vídeo * **Recursos de conteúdo** - Worlds, eventos, lugares, dados do atlas * **Recursos sociais** - Amigos, comunidades, notificações * **Recursos da plataforma** - Conquistas, recompensas, créditos virtuais * **Processamento de assets** - Otimização, miniaturas, traduções Veja [Serviços de Backend](/contributor/contributor-pt/arquitetura/services.md) para documentação completa dos serviços. ### Infraestrutura Sistemas de suporte e serviços de terceiros: * **Message Broker** - NATS para comunicação entre serviços * **Media Server** - LiveKit para voz e vídeo * **Indexadores de Blockchain** - Consultas rápidas para dados de NFT * **Serviço de Email** - SendGrid para notificações Veja [Infraestrutura](/contributor/contributor-pt/arquitetura/infrastructure.md) para mais detalhes. ### Blockchain Smart contracts no Ethereum e Polygon gerenciam: * **Propriedade** - LAND, wearables, names, estates * **Marketplace** - Trading e royalties * **DAO** - Governança e tesouro * **Moeda** - token MANA ## Modelo de Segurança ### Identidade e Autenticação * **Assinaturas de wallet** - Sem senhas, autenticação via assinaturas Ethereum * **Servidor de Auth** - Emite tokens JWT após a verificação da assinatura * **Signed Fetch** - APIs autenticam solicitações usando assinaturas de wallet ### Validação de Conteúdo * **Verificação de assinatura** - Todos os deploys assinados pela wallet * **Propriedade do pointer** - Somente o owner do LAND pode fazer deploy nas coordenadas * **Limites de tamanho** - O tamanho do conteúdo é restrito pela contagem de parcels ### Controle de Acesso * **Tokens com tempo limitado** - Tokens JWT e LiveKit expiram * **Limitação de taxa** - Limites de taxa da API por IP/user * **Proteção contra DDoS** - Rede Catalyst distribuída ## Abordagem de Escalabilidade ### Escalonamento Horizontal * **Nós Catalyst** - Adicionar nodes à medida que o conteúdo cresce * **Serviços de backend** - Microservices sem estado escalam de forma independente * **Ilhas** - Comunicações divididas em grupos baseados em proximidade ### Otimização * **Pacotes de assets** - Assets otimizados para a plataforma (Unity bundles) * **CDN** - Assets estáticos servidos via CDN * **Caching** - Caching agressivo em todas as camadas * **Indexadores** - Dados de blockchain armazenados em cache em bancos de dados rápidos ## Próximos passos Aprofunde-se em áreas arquiteturais específicas: * [**Serviços de Backend**](/contributor/contributor-pt/arquitetura/services.md) - Especificações detalhadas de serviços e integrações * [**Catalyst Network**](/contributor/contributor-pt/arquitetura/catalyst.md) - Entrega e deployment de conteúdo * [**Infraestrutura**](/contributor/contributor-pt/arquitetura/infrastructure.md) - Sistemas de suporte e serviços de terceiros ## Recursos Adicionais * [Referência da API](https://github.com/decentraland/docs/tree/main/apis/README.md) - Documentação completa da API * [Guias de Colaborador](/contributor/contributor-pt/guias-para-colaboradores/contributor-guides.md) - Padrões de desenvolvimento * [Organização no GitHub](https://github.com/decentraland) - Repositórios de código-fonte --- # 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-pt/arquitetura/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.