For the complete documentation index, see llms.txt. This page is also available as Markdown.

Rede Catalyst

A rede Catalyst é a infraestrutura descentralizada de entrega de conteúdo da Decentraland. Vários operadores independentes executam nós Catalyst que armazenam e servem conteúdo.

Visão geral

A rede Catalyst opera como um sistema distribuído totalmente em malha, no qual os nós se comunicam diretamente entre si para sincronizar conteúdo e manter a saúde da rede.

Topologia da rede Catalyst

Componentes do Catalyst

Cada nó Catalyst consiste em:

Content Server

Propósito: Armazenamento e recuperação de assets

Armazena e serve:

  • Definições de scene

  • Modelos 3D e textures

  • Arquivos de áudio

  • Scripts

  • Avatares e wearables

Referência da API: Catalyst API

Lambdas

Propósito: Funções de consulta serverless

Fornece endpoints consultáveis:

  • Pesquisas de entities

  • Consultas de perfil

  • Metadados de conteúdo

  • Histórico de deployments

As Lambdas são executadas como serviços separados que consultam a base de dados do Content Server.

Nginx

Propósito: Proxy reverso e balanceamento de carga

Encaminha requests para os serviços apropriados:

  • Content Server para uploads

  • Lambdas para consultas

  • Serviço de assets estáticos


Deployment de conteúdo

Fluxo de deployment

Etapas do deployment

  1. Compilar: CLI agrupa a scene usando build-ecs

  2. Assinar: Creator assina o deployment com a wallet

  3. Fazer upload: CLI faz upload para qualquer nó Catalyst

  4. Validar: Catalyst valida assinaturas e conteúdo

  5. Armazenar: Conteúdo salvo no armazenamento

  6. Propagar: Evento publicado na fila de deployment

  7. Processar: Backend services processam o novo conteúdo

Validação de conteúdo

Catalyst valida:

  • Assinaturas digitais (prova de propriedade)

  • Hashes de conteúdo (integridade)

  • Permissões de Parcel (propriedade da land)

  • Limites de tamanho de ficheiro

  • Conformidade com a política de conteúdo


Pipeline de deployments

Quando o conteúdo é implantado, vários sistemas reagem:

Processamento de assets

Serviços acionados:

  • Asset Bundle Converter - Cria bundles otimizados

  • Profile Images Producer - Gera miniaturas de avatar

  • Badges Processor - Verifica conquistas de deployment

Serviços de escuta

Serviços que monitorizam deployments:

  • Worlds - Para deployments de Worlds

  • Comms Gatekeeper - Para configuração de voz de World

  • Atlas Server - Para atualizações do mapa


Replicação de conteúdo

Os nós Catalyst replicam conteúdo para garantir a disponibilidade:

Estratégia de replicação

  • Sincronização ativa: Os nós sincronizam ativamente novos deployments

  • Baseado em pull: Os nós obtêm conteúdo em falta sob demanda

  • Protocolo gossip: Os anúncios de deployment propagam-se

Endereçamento de conteúdo

Todo o conteúdo é endereçado por conteúdo:

  • Ficheiros identificados por IPFS CID (Content Identifier)

  • Imutável depois de implantado

  • Deduplicação automática


Archipelago Workers (Comms)

A infraestrutura de comunicações funciona em paralelo com o Catalyst:

Componentes

WebSocket Connector

  • Mantém as conexões com o client

  • Tratamento de protocolo

  • Autenticação de conexão

Referência da API: Archipelago Workers API

Archipelago Core

  • Formação de islands - Agrupa jogadores próximos

  • Limites de peers - Impõe o máximo de peers por island (tipicamente 100)

  • Atualizações de posição - Transmite as posições dos players

  • Encaminhamento de mensagens - Encaminha chat e emotes

Serviço de estatísticas

  • Contagens de utilizadores ativos por scene

  • Estatísticas de conexão

  • Métricas de desempenho


Integração com blockchain

Subgraph Indexer

O Catalyst usa um indexer dedicado:

O Indexer indexa:

  • Propriedade de land (LAND NFTs)

  • Coleções de Wearable e Emotes

  • Registos de NAME

  • Transferências de NFTs


Próximos passos

Atualizado