Descripción general

Todo lo que puedes encontrar dentro del mundo virtual de Decentraland se aloja en una red distribuida de servidores conocida como Catalysts, que proporcionan (entre otras cosas) la API de contenido. Son el medio por el que los clientes suben y descargan contenido.

La API completa del Catalyst está disponible en su propia referencia. Aquí nos centraremos en comprender cómo se organiza el contenido y cómo puede descubrirse y descargarse.

Todos los conceptos importantes mencionados a continuación se describen con más detalle en sus propias páginas.

Archivos, Entities, Pointers

Hay tres capas en el sistema de contenido de Decentraland: archivos se empaquetan dentro de entidades, y las entities se descubren usando pointers.

Archivos se almacenan en un sistema de archivos descentralizado similar a IPFS y se sincronizan automáticamente entre los servidores de contenido. Se identifican mediante una ID de cadena única que se calcula a partir del contenido del archivo, y tanto el identificador como el contenido están inmutables. No existe algo como actualizar un archivo. En su lugar, se suben archivos de reemplazo y se eliminan los archivos obsoletos.

Entities son paquetes atómicos de archivos y representan contenido real que se encuentra en el mundo, como escenas y elementos de vestimenta. Tienen al menos un archivo, llamado manifest, con una descripción general y metadatos. Al igual que los archivos individuales que contienen, son inmutables y se identifican por una cadena única y determinista. Todas las entities tienen un propietario, que posee las claves privadas requeridas para gestionarlas.

Punteros son referencias estables que pueden resolverse a la ID de una entity. Cuando la entity es reemplazada (es decir, el propietario sube un nuevo paquete y el anterior se elimina), los archivos y metadatos contenidos son diferentes y también lo son sus identificadores, pero los pointers permanecen iguales y se redirigen a la nueva versión.

Snapshots

Los servidores de contenido también alojan grandes archivos JSON delimitados por nuevas líneas con resúmenes de todas las entities activas (es decir, aquellas actualmente referenciadas por pointers) en un determinado punto en el tiempo. Estos se llaman snapshots, y pueden usarse para explorar todo el contenido disponible.