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

Hospedar seu NFT no IPFS

Hospede arquivos de mídia NFT e JSON de metadados no IPFS para armazenamento permanente e descentralizado do tokenURI usando Pinata ou outros provedores IPFS para projetos NFT na Chiliz Chain.

Se você ainda não sabe, ter um NFT não significa que o arquivo do NFT está carregado diretamente no blockchain. Em vez disso, um NFT corresponde a um bloco do blockchain que contém um certo token. Esse token armazena um "ponteiro" ou link, chamado tokenURI, que contém o endereço online de um arquivo de metadados, que por sua vez referencia o arquivo de mídia usando outro URI.

Devido à natureza peer-to-peer do blockchain, você não pode simplesmente hospedar seu arquivo NFT e seu arquivo de metadados em qualquer serviço de hospedagem web. Seu tokenURI precisa ser permanente (ou "imutável") e portátil entre apps e marketplaces, pelo maior tempo possível, talvez para sempre.

É aqui que o IPFS entra em cena.

Sobre o IPFS

O IPFS, sigla para InterPlanetary File System, é uma rede de arquivos descentralizada que serve para hospedar e compartilhar dados em redes distribuídas. Plataformas NFT podem buscar dados do IPFS em vez de depender de um único servidor, e o protocolo IPFS faz com que pareça que todos os arquivos hospedados são locais.

O site do IPFS tem uma página extensa sobre melhores práticas de armazenamento de NFTs.

Detalhes do upload de NFT

Ao fazer o upload do seu NFT, você precisa realizar dois uploads para o Content Identifier (CID) que o IPFS gera para você:

  • O conteúdo em si, para o qual o IPFS retorna uma URL IPFS para o arquivo hospedado.

  • O arquivo de metadados, que referencia o CID do arquivo de mídia e deve conter a URL IPFS para o arquivo.

Ambos devem ser carregados no IPFS sob o mesmo CID.

Idealmente, seu conjunto de ferramentas cuida disso para que você não precise fazer tudo manualmente.

Para fins informativos, veja como seria um arquivo metadata.json mínimo:

Para saber mais sobre a estrutura de metadados de NFT (por exemplo, por que você deve usar image para imagens e animation_url para vídeos), recomendamos ler este documento da OpenSea:

Nota: Você não deve escrever o arquivo de metadados do zero! Seu conjunto de ferramentas deve ser capaz de gerá-lo para você.

Como esta documentação não pretende descrever tudo sobre o IPFS, recomendamos que você explore o tema por meio de pesquisas online. Você pode começar com este explicador da Pinata:

... ou este post do thirdweb:

Atualizado

Isto foi útil?