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

Catalyst 네트워크

Catalyst 네트워크는 Decentraland의 분산형 콘텐츠 전송 인프라입니다. 여러 독립적인 운영자가 콘텐츠를 저장하고 제공하는 Catalyst 노드를 운영합니다.

개요

Catalyst 네트워크는 노드들이 콘텐츠를 동기화하고 네트워크 상태를 유지하기 위해 서로 직접 통신하는 완전 메시형 분산 시스템으로 작동합니다.

Catalyst 네트워크 토폴로지

Catalyst 구성 요소

각 Catalyst 노드는 다음으로 구성됩니다:

콘텐츠 서버

목적: 자산 저장 및 검색

저장하고 제공하는 항목:

  • 씬 정의

  • 3D 모델 및 텍스처

  • 오디오 파일

  • 스크립트

  • 아바타 및 착용 아이템

API 참조: Catalyst API

람다

목적: 서버리스 쿼리 함수

쿼리 가능한 엔드포인트를 제공합니다:

  • 엔티티 검색

  • 프로필 쿼리

  • 콘텐츠 메타데이터

  • 배포 기록

람다는 콘텐츠 서버의 데이터베이스를 조회하는 별도의 서비스로 실행됩니다.

Nginx

목적: 리버스 프록시 및 로드 밸런싱

요청을 적절한 서비스로 라우팅합니다:

  • 업로드용 콘텐츠 서버

  • 쿼리용 람다

  • 정적 자산 제공


콘텐츠 배포

배포 흐름

배포 단계

  1. 컴파일: CLI가 build-ecs를 사용하여 씬을 번들링합니다

  2. 서명: 제작자가 지갑으로 배포에 서명합니다

  3. 업로드: CLI가 임의의 Catalyst 노드에 업로드합니다

  4. 검증: Catalyst가 서명과 콘텐츠를 검증합니다

  5. 저장: 콘텐츠가 저장소에 저장됩니다

  6. 전파: 이벤트가 배포 큐에 게시됩니다

  7. 처리: 백엔드 서비스가 새 콘텐츠를 처리합니다

콘텐츠 검증

Catalyst는 다음을 검증합니다:

  • 디지털 서명(소유권 증명)

  • 콘텐츠 해시(무결성)

  • 구획 권한(토지 소유권)

  • 파일 크기 제한

  • 콘텐츠 정책 준수


배포 파이프라인

콘텐츠가 배포되면 여러 시스템이 반응합니다:

자산 처리

트리거되는 서비스:

  • 자산 번들 변환기 - 최적화된 번들을 생성합니다

  • 프로필 이미지 생성기 - 아바타 썸네일을 생성합니다

  • 배지 처리기 - 배포 업적을 확인합니다

모니터링 서비스

배포를 모니터링하는 서비스:

  • 월드 - 월드 배포용

  • 통신 게이트키퍼 - 월드 음성 설정용

  • 아틀라스 서버 - 지도 업데이트용


콘텐츠 복제

Catalyst 노드는 가용성을 보장하기 위해 콘텐츠를 복제합니다:

복제 전략

  • 능동 동기화: 노드가 새 배포를 능동적으로 동기화합니다

  • 풀 기반: 노드가 누락된 콘텐츠를 필요 시 가져옵니다

  • 가십 프로토콜: 배포 알림이 전파됩니다

콘텐츠 주소 지정

모든 콘텐츠는 콘텐츠 주소 지정 방식입니다:

  • 파일은 IPFS CID(콘텐츠 식별자)로 식별됩니다

  • 배포 후에는 불변입니다

  • 중복 제거 자동 적용


Archipelago Workers(통신)

통신 인프라는 Catalyst와 함께 실행됩니다:

구성 요소

WebSocket 커넥터

  • 클라이언트 연결을 유지합니다

  • 프로토콜 처리

  • 연결 인증

API 참조: Archipelago Workers API

Archipelago Core

  • 섬 형성 - 인근 플레이어를 그룹화합니다

  • 피어 제한 - 섬당 최대 피어 수를 제한합니다(보통 100)

  • 위치 업데이트 - 플레이어 위치를 브로드캐스트합니다

  • 메시지 라우팅 - 채팅과 이모트를 라우팅합니다

통계 서비스

  • 씬별 활성 사용자 수

  • 연결 통계

  • 성능 지표


블록체인 통합

서브그래프 인덱서

Catalyst는 전용 인덱서를 사용합니다:

이 인덱서 색인합니다:

  • 토지 소유권(LAND NFT)

  • 착용 아이템 및 이모트 컬렉션

  • 이름 등록

  • NFT 이전


다음 단계

마지막 업데이트