파일 시스템

Decentraland 프로토콜의 다양한 콘텐츠 API의 기반에는 분산 파일 시스템 구현이 있습니다. 각 콘텐츠 서버는 전체 저장소의 복사본을 보유하며, 수신한 업데이트를 다른 인스턴스들과 동기화합니다.

시스템에 업로드된 파일은 불변입니다. 배포되면 식별자도 내용도 변경되지 않습니다. 파일은 새 버전을 업로드하고 애플리케이션이 그것을 사용하도록 선택하는 의미에서만 업데이트될 수 있으며, 이전 버전은 폐기할 수 있습니다.

Decentraland의 파일 시스템은 평면 인덱스(즉, 디렉터리의 자연스러운 계층 구조가 없음)로 구성되어 있으며, 각 파일은 고유한 문자열로 식별됩니다.

식별자 문자열은 다음으로 시작하는 base32 인코딩된 파일 내용의 SHA-256 해시이며, IPFS CID v1 알고리즘을 사용합니다. 다음과 같은 형태입니다:

bafybeicgclohdfaccu2sqqkzrzuenjxzcry3m5vcb4mpxgucjl3oheq5tq

앞부분 몇 바이트의 접두사는 식별자 자체의 인코딩, 버전, 해시 유형을 나타냅니다.

역사적인 이유로 일부 API는 파일 식별자를 hash 대신 id라고 부르지만, 이는 같은 것을 가리킵니다. 오래된 콘텐츠에서는 조금 다른 옛 식별자를 볼 수도 있습니다.

실제로 이러한 세부 사항은 콘텐츠를 찾고 다운로드하는 데 필요하지 않습니다. 프로토콜의 대부분 클라이언트는 기능을 잃지 않고 식별자를 불투명한 문자열처럼 취급할 수 있습니다.

현대적인 CIDv1 식별자는 IPFS와 호환되어 같은 파일에 대해 동일한 CID를 생성하므로, IPFS를 파일 제공자로 사용할 수 있습니다.

다음을 제외하고 스냅샷, 네트워크에 저장된 파일은 엔티티를 이더리움 계정이 소유합니다. 소유자만 엔티티와 관련 파일을 업데이트할 수 있습니다.

콘텐츠 서버는 프로토콜에 따라 엔티티와 그 파일의 최신 버전을 항상 저장해야 하지만, 자체 설정에 따라 이전 버전을 보존할지는 선택할 수 있습니다.

이 /contents/<fileId> 콘텐츠 서버의 엔드포인트를 사용하여 어떤 파일이든 다운로드할 수 있습니다. 해당 식별자는 상위 엔티티의매니페스트에서 찾을 수 있습니다.

파일은 개별적으로 업로드되지 않습니다. 대신 엔티티 내부에 패키징되어 콘텐츠 서버에 엔티티를 배포할 때 업로드됩니다.

다음을 참조하세요 콘텐츠 제작자 문서 에서 자세한 내용을 확인하세요.

마지막 업데이트 10개월 전