Coleções

Collections são grupos de wearables e emotes definidos no mesmo namespace off-chain ou contrato on-chain.

Eles não são entidades por si só, mas os seus itens individuais podem ser obtidos de content servers normalmente usando ponteiros.

URNs and Pointers

Collections são identificadas usando URNs, que são prefixos para as URNs dos seus itens. Existem 4 tipos gerais de URNs:

• v1 collections com conteúdo aprovado pela Foundation (deprecated).

• v2 collections com conteúdo aprovado pela comunidade.

• thirdparty collections com itens associados a NFTs fora de Decentraland.

• off-chain collections, contendo principalmente itens padrão para novos avatars.

Apesar do facto de que v1 collections estão deprecated e já não serão criadas nem atualizadas, continuam válidas e os seus itens podem ser usados.

Collections das versões 1 e 2

Tanto o antigo v1 como o atual v2 namespaces de collections têm URNs da mesma forma:

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

Por exemplo:

# Uma collection no espaço v1 deprecated:
urn:decentraland:mainnet:collections-v1:DCL Test Masks

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

Se o :<id> segmento for acrescentado no final, a URN torna-se uma pointer para um item dentro da collection. Consulte wearable pointers e emote pointers para informação sobre estes.

Collections de terceiros

As third-party collections, também conhecidas como linked wearables, são diferentes dos wearables normais, pois estão ligadas a NFTs existentes fora de Decentraland. Elas permitem que os players exibam NFTs do seu conjunto pessoal nos seus avatars in-world.

As suas URNs têm este aspeto:

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

Pode encontrar muitas informações sobre estas na linked wearables documentação para criadores.

Descobrir Collections

Os content servers podem fornecer-lhe uma lista de todas as collections 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": "Coleção de roupas de inverno"
    },
    // ... muitas mais
  ]
}