CLI 예제

이 실습에서는 터미널에서 콘텐츠 API를 다루는 방법을 보여줍니다. 우리는 Decentraland Foundation의 인스턴스를 사용할 것입니다 peer.decentraland.org, 그리고 필요한 것은 curl 명령줄 도구뿐입니다.

다음을 사용할 수 있습니다 httpie 또는 다음으로 응답을 포맷할 수 있습니다 jq 를 사용해 각 요청에서 더 읽기 쉬운 JSON을 얻을 수 있습니다. 이 가이드에서는 명확성을 위해 포맷된 문서를 보여드리겠습니다.

우리가 할 일은 다음과 같습니다:

1. 콘텐츠 서버의 상태를 조회합니다.

2. 일일 스냅샷 엔티티 목록이 포함된.

3. 엔터티의 매니페스트를 가져옵니다.

4. 엔터티의 파일 중 하나를 다운로드합니다.

다음 명령어를 사용하여 서버 상태를 조회하는 것부터 시작합시다 /about:

curl "https://peer.decentraland.org/about"

{
  "healthy": true,
  "content": {
    "healthy": true,
    "version": "6.5.0",
  },
  // ... 더 많은 서버 정보(기능 플래그, 버전, 경로 등)
}

서버가 정상적으로 실행 중인 것 같습니다 ("healthy": true), 그리고 구현한 각 기능 세트의 버전과 인스턴스의 몇 가지 구성 옵션에 대한 정보를 제공하고 있습니다.

다운로드할 콘텐츠에 관심이 있으니, 사용 가능한 스냅샷 를 통해 몇 가지 식별자를 얻어봅시다 /content/snapshots.

curl "https://peer.decentraland.org/content/snapshots"

[
  {
    "hash": "bafybeia6qoum64psaooiqo3f45i6hykfwx723uc236waub3gng2naof224",
    "timeRange": {
      "initTimestamp": 1689120000000,
      "endTimestamp": 1689206400000
    },
    "replacedSnapshotHashes": [],
    "numberOfEntities": 981,
    "generationTimestamp": 1689219353866
  },
  // ...더 많은 스냅샷 파일
]

배열의 각 항목은 하나의 스냅샷. 그럼 하나를 가져와 봅시다 hash 그리고 파일을 다음에서 다운로드합니다 /content/contents 엔드포인트.

curl "https://peer.decentraland.org/content/contents/bafybeia6qoum64psaooiqo3f45i6hykfwx723uc236waub3gng2naof224" > snapshot

고급 Python 예제에서처럼 더 큰 스냅샷을 실험해 볼 수 있습니다 고급 Python 예제. 이를 대화형으로 시도해 보려면, 아마도 더 작은 것 중 하나를 원할 것입니다.

첫 번째 줄을 확인하여, 우리가 알고 있는 형식의 올바른 파일을 다운로드했는지 확인할 수 있습니다:

head -n1 snapshot

### Decentraland json snapshot

좋습니다! 이제 그 스냅샷에 캡처된 모든 엔터티의 로컬 요약이 있습니다. 목록의 첫 번째 항목(파일의 두 번째 줄)인 프로필:

tail -n+2 snapshot | head -n1 

{
  "entityId": "bafkreif7hjremkxlvixyxoxnoo7bdcnf7qqp245sjb2pag2nk3n6o6yc4c",
  "entityType": "profile",
  "pointers": [
    "0x271cdb3b1c792c336c4b2bdc52c4f415d0046b92"
  ],
  "authChain": [
    // https://docs.decentraland.org/contributor/auth/authchain/를 참조하세요
  ],
  "entityTimestamp": 1689120135624
}

스냅샷은 만료되고 엔터티는 교체되므로, 이 글의 식별자는 작동하지 않습니다. 실제로 활성화된 파일 ID를 얻으려면 명령줄에서 따라 해 보세요.

우리가 저장할 수 있는 정보입니다. 우리는 entityId 를 사용해 엔터티의 JSON 매니페스트를 다운로드할 것입니다. 하지만 목록에 나온 포인터 을 보존해 두는 것은, 나중에 이 엔터티와 업데이트된 버전을 찾고 싶을 때 좋은 생각입니다.

또한 다음도 있습니다 인증 체인 이 엔터티에 서명할 때 사용된 것이며, 다운로드하는 관련 파일의 진위 여부를 확인하기 위해 목록에 있는 서명을 검증할 수도 있습니다.

엔터티 매니페스트를 가져와 봅시다. 기억하세요, entityId 는 파일 식별자 우리가 필요한 /content/contents 엔드포인트를 다시 사용할 수 있습니다:

curl "https://peer.decentraland.org/content/contents/bafkreigcreq7rv6b2wf4zc4fsnif43ziwb4q46v4qhsewpf7gbsyxew3om"

{
  "version": "v3",
  "type": "profile",
  "pointers": [
    "0x273cdb3b1c791c336c4b2bcc52c4f415d0046b91"
  ],
  "timestamp": 1689120135624,
  "content": [
    {
      "file": "body.png",
      "hash": "bafybeibzaqkirz7fk474xvyhurho5xviphs7anawaceb6gscuigia4x33u"
    },
    // ...더 많은 파일
  ],
  "metadata": {
    // ...아바타 및 기타 정보
  }
}

이 프로필 엔터티에는 World Explorers가 플레이어를 렌더링하고 애니메이션 처리하는 데 사용하는 모든 정보가 들어 있습니다. 패키징된 파일 중 하나를 얻는 데 관심이 있다면, 계속해서 /content/contents 엔드포인트.

만약 우리가 콘텐츠 필드를 살펴보면, hash 내부적으로 호출되는 파일의 body.png. 그걸 가져와 봅시다:

curl "https://peer.decentraland.org/content/contents/bafybeibzaqkirz7fk474xvyhurho5xviphs7anawaceb6gscuigia4x33u" > body.png

이 png 파일을 이미지 뷰어나 웹 브라우저에서 열고, 저자의 작업을 확인해 보세요. 멋지네요!