Coleções

Coleções são grupos de wearables e emotes definidos no mesmo namespace off-chain ou no contrato on-chain.

Eles não são entities em si, mas seus itens individuais podem ser obtidos de servidores de conteúdo normalmente usando pointers.

URNs and Pointers

Coleções são identificadas usando URNs, que são prefixos dos URNs de seus itens. Existem 4 tipos gerais de URNs:

• v1 coleções com conteúdo aprovado pela Foundation (obsoleto).

• v2 coleções com conteúdo aprovado pela comunidade.

• thirdparty coleções com itens associados a NFTs fora do Decentraland.

• off-chain coleções, contendo principalmente itens padrão para novos avatares.

Apesar do fato de que v1 coleções estão obsoletas e não serão mais criadas ou atualizadas, elas ainda são válidas e seus itens podem ser usados.

Coleções Versão 1 e 2

Tanto o antigo v1 quanto o atual v2 namespaces de coleção têm URNs da mesma forma:

urn:decentraland:<blockchain>:<collections-version>:<contract-address>

Por exemplo:

# Uma coleção no espaço v1 obsoleto:
urn:decentraland:mainnet:collections-v1:DCL Test Masks

# Uma coleção no espaço v2 aprovado pela comunidade:
urn:decentraland:matic:collections-v2:0x25a1d66891d44cdf7b8c45802489c1dea7aadf8b

Se o :<id> segmento for anexado no final, o URN torna-se um pointer para um item dentro da coleção. Veja wearable pointers e emote pointers para informações sobre estes.

Coleções de Terceiros

Coleções de terceiros, também conhecidas como linked wearables, são diferentes dos wearables regulares porque estão vinculadas a NFTs existentes fora do Decentraland. Elas permitem que jogadores exibam NFTs do seu conjunto pessoal em seus avatares no mundo.

Seus URNs se parecem com isto:

urn:decentraland:<blockchain>:collections-thirdparty:<third-party-id>:<collection-id>

Você pode encontrar ampla informação sobre estas na linked wearables documentation for creators.

Descobrindo Coleções

Servidores de conteúdo podem fornecer uma lista de todas as coleções conhecidas, usando o /lambdas/collections endpoint.

A resposta será um objeto com uma collections propriedade, contendo um array de URNs e nomes. Por exemplo:

{
  "collections": [
    {
      "id": "urn:decentraland:amoy:collections-v2:0xff5d4ebc6bc1ff7262cab42d3c693d953f4614d2",
      "name": "Winter clothes collection"
    },
    // ... many more
  ]
}