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.

Preciso aprender sobre o IPFS agora?

Depende do método escolhido para mintar seu NFT:

• Usando código vanilla (como viem ou ethers): Sim, você precisa de um tokenURI válido (ex.: ipfs://.../metadata.json) com antecedência.

• Por meio de um dashboard como o thirdweb: Não. O upload para IPFS está integrado. Você ainda pode colar um ipfs://... existente se tiver um nos parâmetros do NFT.

• Usando a maioria dos SDKs Web3 (como o Rarible Multichain SDK): Sim, eles esperarão um URI. Algumas ferramentas podem ajudar com uploads, mas a maioria não.

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:

{ 
    "name": "Stadium Pass #25456456", 
    "description": "PSG supporter entry ticket", 
    "image": "ipfs:///filename.png",           // for static images only!
    // "animation_url": "ipfs:///filename.mp4" // for video and audio files.
    "attributes": [
    { 
        "trait_type": "Tier", 
        "value": "Gold" 
    }] 
}

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:

Metadata StandardsOpenSea Developer Documentation

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

Você pode executar seu próprio nó IPFS ou pagar por um serviço de hospedagem IPFS, como o Pinata, que oferece um plano gratuito que pode ser suficiente para suas necessidades.

Siga o guia de início rápido da Pinata para obter suas credenciais de API (composta de chave de API, segredo de API e token JWT) e seu domínio de Gateway Dedicado (por exemplo, blue-genetic-quail-122.mypinata.cloud).

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:

How does IPFS work with NFTs? - Pinata DocsPinata Docs

... ou este post do thirdweb:

What Is IPFS and How Does it Store NFT Metadata?thirdweb