Sumário
1 . Introdução
2 . Visão geral
4 . Implantando o contratato usando a ThirdWeb
5 . Verificar erros personalizados
6 . Função Getter
7 . Conclusão
Introdução
Neste tutorial, criaremos uma coleção de pacotes NFT ERC-1155 personalizada usando a ferramenta ContractKit da Thirdweb e Deploy. Em vez de cunhar todos os NFTs de uma só vez, permitimos que os usuários criem NFT de qualquer coleção de pacotes NFT, um por um. Também definimos um fornecimento máximo de NFTs; um usuário pode cunhar apenas um NFT.
Visão geral
O ERC-1155 emergiu como um padrão ouro para a criação de NFTs; todos os principais mercados listam novos tokens como um padrão ERC-1155. Usaremos A Thirdweb ContractKit para criar nosso contrato inteligente junto com alguma lógica personalizada. Permitimos que os usuários criem apenas um NFT por coleção de pacotes NFT.
Por que usar a ContractKit?
Cada recurso que você implementa em seus contratos inteligentes desbloqueia a funcionalidade no painel da Thirdweb e no SDK para ajudá-lo a criar aplicativos com base neles.
Por exemplo, se você implementar o contrato ERC721 base, desbloqueará o botão cunhar (mint) no painel e poderá usar a função cunhar no SDK; que carrega e fixa automaticamente seus metadados no IPFS!
O que é ERC-1155?
O ERC1155 é um padrão multi-token que permite a criação de tokens fungíveis, não fungíveis e semi-fungíveis em um único contrato. Antes do ERC-1155, se um caso de uso precisasse de tokens ERC-20 (fungíveis) e ERC-721 (não fungíveis), você precisaria criar contratos separados para conseguir isso. O ERC1155 também permite que várias coleções NFT sejam lançadas em apenas um contrato inteligente, em vez de criar um contrato diferente para cada coleção; isso aumenta a eficiência na construção de contratos inteligentes e minimiza a contagem de transações, o que é muito importante, pois consome menos espaço da blockchain. Com o ERC-1155, é possível a transferência em lote de tokens em vez de transferir um token para um único endereço nos padrões anteriores.
Um exemplo predominante do aplicativo ERC-1155 são os jogos descentralizados baseados em blockchain, que precisam de moedas e itens colecionáveis, então o ERC-1155 se tornou um padrão lá. O ERC1155 também se tornou um padrão no espaço NFT.
O ERC-721 anterior tinha um mapeamento um para um do ID do token com o endereço. O ERC-1155 possui um mapeamento bastante complexo onde o endereço em uma combinação de token ID é mapeado para o saldo do token.
Configurando o ambiente.
Em primeiro lugar, vamos configurar nosso ambiente e instalar as dependências. Para começar, execute o comando abaixo para criar um novo projeto abrindo o terminal do seu IDE preferido.
npx thirdweb create --contract
Você obterá algo assim:
Agora insira seus detalhes preferidos. Para este tutorial, selecionei a configuração abaixo
Após a conclusão, navegue e abra o novo diretório executando o seguinte comando.
cd dapp-name
code .
Você verá esse tipo de estrutura de arquivo.
Agora abra o diretório contracts e selecione o arquivo contract.sol. Você verá o código de demonstração. Agora copie o código do contrato inteligente abaixo e substitua-o pelo código de demonstração.
// SPDX-License-Identifier: MIT
/** @author Aayush gupta
* `TravelQuest` é um dapp POV (Proof-of-visit) que permite ao usuário cunhar 1 NFT por coleção
* utilizando a biblioteca 'ERC1155LazyMint' da 'ThirdWeb.
*/
pragma solidity ^0.8.0;
/**
* Importando a biblioteca 'ERC1155LazyMint' da 'ThirdWeb.
*/
import "@thirdweb-dev/contracts/base/ERC1155LazyMint.sol";
/**
* @title TravelQuest
* @dev herda e utiliza o `ERC1155LazyMint` no nosso contrato inteligente
*
*/
contract TravelQuest is ERC1155LazyMint{
// Número total de NFTs por coleção de pacotes
uint256[] private supplies = [50,50];
// Número total de NFTs cunhados
uint256[] private minted = [0,0];
// mapeamento aninhado para verificar se o usuário pode criar apenas um NFT por coleção de NFT
mapping(uint256 => mapping(address => bool)) public member;
/**
* @dev O construtor da biblioteca ERC1155LazyMint leva quatro Parâmetros
* _name of the NFT, _symbol do NFT,
* _royaltyRecipient (endereço) quem receberá royalties na venda secundária, _royaltyBps (porcentagem de royality)
* não precisamos definir Royality para o propósito de nosso contrato inteligente. definir _royaltyBps como Zero
* @param _name: nome de toda a coleção de pacotes NFT
* @param _symbol: símbolo de toda a coleção de pacotes NFT
*/
constructor(
string memory _name,
string memory _symbol
) ERC1155LazyMint (_name, _symbol, msg.sender, 0){}
/**
* @dev Cunha NFT e também verifica várias condições
* 1. Um usuário pode cunhar apenas um NFT por coleção de pacotes
* 2. Dá erro se _tokenId estiver errado
* 3. Verifica e dá erro se todos os NFTs forem cunhados
*
* @param _tokenId da coleção do pacote NFT
*/
function mintNFT(uint256 _tokenId)
external
{
require(
!member[_tokenId][msg.sender],
"Você já reivindicou este NFT."
);
require(_tokenId <= supplies.length-1,"O NFT não existe");
uint256 index = _tokenId;
require (minted[index] + 1 <= supplies[index], "Todos os NFT foram cunhados");
_mint(msg.sender, _tokenId, 1, "");
// "" são dados que são colocados vazios
minted[index] += 1;
member[_tokenId][msg.sender] = true;
}
/**
* @dev Dá o número total de NFTs cunhados por coleção de pacotes NFT
* @param _tokenId da coleção do pacote NFT
*/
function totalNftMinted(uint256 _tokenId) public view returns(uint256){
return minted[_tokenId];
}
}
Abaixo, vou explicar o código, mas antes de ver a explicação, peço que você tente entender os contratos inteligentes por conta própria, lendo o código e os comentários.
Explicação do contrato
Linha 1: Especificando o tipo de licença SPDX, que é adicionada após a versão ^0.6.8 do Solidity. Sempre que o código-fonte de um contrato inteligente é disponibilizado ao público, essas licenças podem ajudar a resolver/evitar problemas de direitos autorais. Se você não deseja especificar nenhum tipo de licença, pode usar um valor especial UNLICENSED ou pular todo o comentário (não resultará em erro, apenas em um aviso).
Linha 7: Declarando a versão do Solidity.
Linha 13: Importando o contrato thirdweb ERC1155LazyMint.
Linha 20: Herdando o contrato ERC1155LazyMint em nosso contrato inteligente TravelQuest. Para usar todas as funcionalidades do contrato ERC1155LazyMint.
Linha 22: supplies é uma matriz que rastreia o número Máximo de NFT disponível para cunhagem.
Linha 24: minted é uma matriz que rastreia quantos NFTs já foram cunhados.
Linha 27: member é um mapeamento aninhado para verificar se o usuário pode cunhar apenas um NFT por coleção de NFT
Linha 37: constructor: O construtor da biblioteca ERC1155LazyMint leva quatro parâmetros
_name: nome do NFT
_symbol: símbolo do NFT
_royaltyRecipient (endereço) que receberá royalties em uma venda secundária
_royaltyBps (porcentagem de royalties).
não precisamos definir royalties para fins de nosso contrato inteligente. definindo _royaltyBps como Zero.
Linha 38: string memory _name: nome de toda a coleção de pacotes NFT
Linha 39: string memory _symbol: símbolo de toda a coleção de pacotes NFT
Linha 51: function mintNFT: para permitir que os usuários criem NFT de nossa coleção de pacotes NFT. Um usuário pode cunhar apenas 1 NFT de cada coleção de NFT. Além disso, verifica várias condições
- Um usuário pode cunhar apenas um NFT por coleção de pacotes
- Dá erro se
_tokenIdestiver errado Verifica e dá um erro se todos os NFTs
_tokenIdsão cunhados: tokenId da coleção do pacote NFTLinha 72:
functiontotalNftMinted: é uma função getter. Fornece o número total de NFTs cunhados por coleção de pacote NFT._tokenIdé o tokenId da coleção de pacote NFT
BOOM: Você criou nosso contrato inteligente com lógica personalizada e Thirdweb ContractKit.
Implantando o contratato usando a ThirdWeb
Use a CLI para enviar nosso contrato diretamente para qualquer uma das redes suportadas pela Thirdweb usando seu painel.
npx thirdweb deploy
Executar este comando irá:
- Compilar todos os contratos no diretório atual.
- Permitir selecionar quais contratos você deseja implantar.
- Carregar o código-fonte do seu contrato (ABI) para o IPFS.
- Abrir o fluxo de implantação no painel para selecionar uma das redes com suporte da ThirdWeb para ser implantada.
- Você não precisa escrever seu script de implantação. Isso significa que você não precisa de sua
Private Keypara implantar seu contrato inteligente, o que economiza e elimina qualquer chance de expor sua chave privada.
Depois de executar o comando acima, você obterá algo assim:
Agora clique no link. Você abrirá o painel de implantação. Digite os detalhes (Nome do NFT, símbolo do NFT e rede que deseja implantar seu contrato inteligente) e clique no botão Deploy Now.
Após a implantação do seu contrato inteligente, você será direcionado para o Painel da Coleção NFT.
Clique em Single Upload para carregar os metadados do nosso NFT. Você também pode usarBatch Upload. Mas para este tutorial, vamos nos ater ao Single Upload.
Adicione os detalhes conforme mostrado acima e clique no botão Lazy Mint NFT.
Da mesma forma, vamos adicionar metadados para outro NFT.
Após a adição de metadados, sua seção de NFTs no painel ficará assim.
Agora que temos nossa coleção NFT junto com os metadados no pedido, vamos cunhar alguns NFTs.
Cunhar o NFT
Vá para a seção Explorer do painel da coleção de NFT. Você verá todas as funções que pode executar. Por enquanto, vamos nos concentrar apenas em nossa função personalizada mintNFT.
Digite o _tokenId (0 ou 1) e clique no botão Mint. Você cunhará o NFT e o painel mostrará todos os detalhes da transação.
Copie o endereço do seu contrato e cole o endereço na rede de teste Opensea para visualizar seu NFT com metadados.
Você cunhou com sucesso o NFT e o visualizou no Opensea. Você pode compartilhar o link do Opensea e se gabar dos NFTs como todos os nativos da web3 fazem.
Verificar erros personalizados
Você pode ter cunhado com sucesso o NFT. Agora vamos verificar os erros personalizados que adicionamos em nosso contrato inteligente.
TokenID Errado
Insira qualquer _tokenIderrado na função mintNFT.
Você verá esse erro personalizado bem definido com todos os detalhes.
Já Reivindicado
Tente cunhar o mesmo NFT com o mesmo endereço de carteira.
Novamente, você verá esse erro personalizado bem definido com todos os detalhes.
Função Getter
Já vimos como podemos acessar e usar a função setter na ThirdWeb. Agora vamos interagir com a função getter. Você pode acessar a função getter rolando a página explorer para baixo e clicando em sua função personalizada totalSupply.
Você vê que está obtendo o resultado certo.
Conclusão
Você concluiu todo o tutorial. Dê a si mesmo um tapinha nas costas.
Você aprendeu sobre:
- Padrão de token ERC-1155
- Criar seu próprio contrato inteligente personalizado usando
thirdweb contractkit - Implantar seu contrato inteligente usando
thirdwebdeploy - Armazenar seus metadados NFTs em IPFS usando
thirdwebdashboard - Cunhar seu NFT e interagir com seu contrato inteligente usando a seção
Explorerdothirdwebdashboard
Simplesmente UAU!
Se você aprender e gostar deste artigo, por favor, compartilhe este artigo com seus amigos. Espero que você tenha aprendido algo novo ou talvez até resolvido um problema. Obrigado por ler e divirta-se!
Você pode me seguir no Twitter e no LinkedIn. Mande suas sugestões/comentários!
WAGMI (“Todos nós vamos conseguir”)
Artigo escrito por Aayush Gupta e traduzido por Marcelo Panegali
Criar uma coleção de NFTs ERC-1155 é apenas o ponto de partida; os projetos incríveis da WEB3DEV representam a chave de entrada para o emocionante cenário web3. 🌐 Não espere mais! Corra para o nosso site agora mesmo e garanta sua inscrição nos próximos builds. A sua empolgante jornada rumo à maestria das aplicações web3 está prestes a começar! 🚀🔗
Oldest comments (0)