NEP-171 (NFTs da NEAR)

O que é NEP-171?

NEP-171 é o padrão central de tokens não fungíveis para NFTs na blockchain NEAR.

No universo cripto, NEP-171 define a interface básica que um contrato inteligente da NEAR precisa implementar para funcionar como um contrato de tokens não fungíveis.

Um NFT que segue o padrão NEP-171 pode representar um ativo digital único, como uma obra de arte, um item de jogo, um passe de associação, um ingresso, um certificado, um colecionável, um distintivo, um terreno virtual ou outro ativo com um ID de token exclusivo.

A especificação oficial da NEP-171 descreve o padrão como uma interface para tokens não fungíveis, ou seja, tokens em que cada unidade tem um ID exclusivo.

A NEP-171 não define todos os recursos de que um projeto completo de NFT pode precisar.

Em vez disso, ela define as funções essenciais e o comportamento esperado que permitem a contratos, carteiras, marketplaces, jogos e aplicativos de NFT da NEAR reconhecer as mesmas ações básicas de NFT.

Isso torna a NEP-171 semelhante, em propósito, aos padrões de NFT de outras redes de contratos inteligentes, mas ela foi projetada para o modelo de contas da NEAR, seu ambiente de execução assíncrono, seu modelo de armazenamento e seus padrões de chamadas entre contratos.

Um NFT NEP-171 não é armazenado como um arquivo dentro da carteira do usuário.

Em vez disso, o NFT fica em um contrato inteligente da NEAR, que funciona como registro de propriedade, transferências, aprovações e informações do token.

Por que a NEP-171 é importante

A NEP-171 é importante porque os padrões facilitam a integração de contratos de NFT em todo o ecossistema NEAR.

Sem um padrão compartilhado, cada contrato de NFT poderia usar nomes de métodos, regras de transferência, formatos de retorno e lógica de propriedade diferentes.

Isso dificultaria o suporte confiável a NFTs por carteiras, jogos, marketplaces, ferramentas de análise, indexadores e aplicativos com acesso restrito a tokens.

A NEP-171 oferece aos desenvolvedores uma interface comum para consultar dados de tokens, transferir NFTs, anexar NFTs a chamadas entre contratos e resolver transferências quando há contratos receptores envolvidos.

Para os usuários, a NEP-171 facilita armazenar, enviar, listar, exibir e usar NFTs da NEAR em aplicativos compatíveis.

Para os desenvolvedores, a NEP-171 reduz os atritos de integração, pois um aplicativo pode chamar métodos de NFT conhecidos, em vez de aprender uma interface personalizada para cada coleção.

Para os criadores, a NEP-171 oferece uma estrutura básica para lançar coleções de NFT sem precisar inventar do zero o comportamento essencial de um NFT.

Para o ecossistema cripto mais amplo, a NEP-171 ajuda os NFTs da NEAR a se comportarem de forma previsível o suficiente para dar suporte a arte, jogos, associações, ingressos, credenciais, recompensas e aplicativos descentralizados.

O padrão é importante porque o valor de um NFT depende não apenas da arte ou da utilidade, mas também de uma lógica confiável de propriedade e transferência.

Como a NEP-171 funciona

A NEP-171 funciona por meio de um contrato inteligente que armazena a propriedade dos NFTs e disponibiliza métodos padronizados.

Quando um NFT da NEAR é emitido, o contrato registra um

exclusivo e o associa a um .

Quando um usuário ou uma conta aprovada transfere o NFT, o contrato atualiza o registro de propriedade.

Quando um aplicativo precisa consultar um NFT, pode chamar o método somente leitura

.

Quando um usuário quer enviar um NFT para outra conta, o contrato pode processar o método

.

Quando um usuário quer enviar um NFT a outro contrato inteligente e acionar uma lógica nesse contrato receptor, o contrato pode usar

.

Se o contrato receptor rejeitar o NFT ou devolvê-lo durante o fluxo de chamada de transferência, o contrato do NFT pode usar uma função de resolução para tratar o resultado.

Esse desenho de métodos é importante na NEAR porque as chamadas entre contratos são assíncronas.

Assim, a NEP-171 oferece suporte tanto a transferências simples entre carteiras quanto a fluxos mais avançados em que os NFTs interagem com outros contratos.

Métodos centrais da NEP-171

A interface central da NEP-171 inclui métodos que definem como funcionam a propriedade e as transferências básicas de NFTs.

O método

retorna informações sobre um token para determinado ID de token.

O método

transfere um token do proprietário atual ou de uma conta aprovada para uma conta receptora.

O método

transfere um token e chama um método do contrato receptor em um único fluxo.

O método do contrato receptor

é usado quando se espera que um contrato receba NFTs.

O método

é usado como callback para concluir o fluxo de chamada de transferência e tratar a lógica de devolução quando necessário.

O guia oficial do padrão de NFT da NEAR lista esses métodos e explica o comportamento esperado da interface.

Esses métodos são a base que permite reconhecer um contrato de NFT da NEAR como tal.

Recursos adicionais, como metadados, aprovações, enumeração, royalties e eventos, são tratados por meio de padrões e extensões relacionados.

NEP-171 e IDs de token

Um ID de token é o identificador exclusivo de um NFT dentro de um contrato de NFT da NEAR.

Cada NFT precisa ser distinguível dos demais NFTs do mesmo contrato.

O ID de token permite que carteiras, usuários, aplicativos e contratos façam referência a um NFT específico.

Por exemplo, uma coleção pode usar IDs como

, e , ou IDs mais longos que incluam informações da coleção, série ou edição.

O formato exato do ID de token é determinado pelo projeto do contrato.

O importante é que o contrato consiga identificar claramente o token e retornar informações sobre o proprietário e os metadados quando consultado.

Um ID de token não é o mesmo que o arquivo de mídia, o título da obra de arte ou o nome da coleção.

É a referência on-chain exclusiva usada pelo contrato.

Ao verificar um NFT da NEAR, os usuários devem conferir tanto a conta do contrato quanto o ID do token.

NEP-171 e IDs de proprietário

Um ID de proprietário é a conta NEAR que, segundo o contrato do NFT, possui determinado NFT.

A NEAR usa nomes de conta legíveis por humanos, o que pode facilitar a compreensão da propriedade em comparação com endereços hexadecimais longos.

Por exemplo, o nome de uma conta NEAR pode ser

ou outro formato válido de conta NEAR.

O contrato de NFT registra qual conta é proprietária de cada ID de token.

Quando a propriedade muda, o contrato atualiza o registro do proprietário.

Uma interface de carteira pode exibir um NFT consultando o contrato e verificando o ID do proprietário.

No entanto, a exibição visível na carteira não é, por si só, a fonte definitiva de verdade.

O estado de propriedade do contrato inteligente é a fonte que os aplicativos devem verificar.

Os usuários devem proteger cuidadosamente suas contas NEAR, pois o controle da conta determina o controle dos NFTs mantidos nela.

NEP-171 vs. NEP-177

A NEP-171 define a interface central de NFT, enquanto a NEP-177 define os metadados de NFT.

O padrão de metadados NEP-177 amplia a NEP-171 ao descrever metadados de contrato e de token.

Os metadados explicam aos usuários e aplicativos o que um NFT representa.

Os metadados do contrato podem incluir campos como nome da coleção, símbolo, ícone, URI base, referência e hash de referência.

Os metadados do token podem incluir campos como título, descrição, mídia, hash da mídia, cópias, data de emissão, data de expiração, data de início, data de atualização, dados extras, referência e hash de referência.

A NEP-171 pode definir que um token existe e indicar quem é seu proprietário.

A NEP-177 ajuda a definir o que o token deve representar.

Em geral, um projeto completo de NFT da NEAR deve considerar os dois padrões.

Sem metadados, um NFT pode ser tecnicamente transferível, mas difícil de entender ou exibir para os usuários.

NEP-171 vs. NEP-178

A NEP-178 define o gerenciamento de aprovações para NFTs da NEAR.

O padrão de aprovação NEP-178 explica como os proprietários de NFTs podem autorizar outra conta a transferir um NFT em seu nome.

Isso é importante quando um usuário quer listar um NFT por meio de um contrato de marketplace, sistema de escrow, contrato de jogo ou outro aplicativo que precise de permissão para transferi-lo.

Os principais métodos de aprovação incluem

, , e .

As aprovações podem ser úteis, mas também criam riscos de segurança se os usuários aprovarem a conta errada.

O usuário só deve aprovar contratos que conheça e em que confie.

As aprovações devem ser revogadas quando não forem mais necessárias.

A NEP-171 gerencia a propriedade e as transferências essenciais, enquanto a NEP-178 acrescenta uma forma padronizada de delegar autoridade de transferência.

NEP-171 vs. NEP-181

A NEP-181 define a enumeração para NFTs da NEAR.

O padrão de enumeração NEP-181 ajuda aplicativos a listar NFTs por proprietário, contrato ou consultas relacionadas à oferta.

A enumeração é útil porque muitos aplicativos precisam consultar mais de um token por vez.

Uma carteira pode precisar exibir todos os NFTs de uma conta dentro de um contrato.

Uma ferramenta de análise pode precisar calcular a oferta total.

Uma página de coleção pode precisar mostrar listas, páginas ou intervalos de tokens.

A NEP-171 pode retornar informações de um ID de token específico, enquanto a NEP-181 ajuda os aplicativos a percorrer conjuntos de tokens.

Nem todo fluxo básico de NFT precisa de enumeração, mas muitos aplicativos voltados aos usuários se beneficiam dela.

Para melhorar a experiência de uso de NFTs, o suporte à NEP-181 pode facilitar a descoberta e a indexação.

NEP-171 vs. NEP-199

A NEP-199 define um padrão para royalties e pagamentos de NFTs na NEAR.

O padrão de royalties e pagamentos NEP-199 ajuda contratos a descrever como os valores de uma venda podem ser divididos entre criadores, colaboradores, proprietários e outros destinatários.

Os royalties são importantes para artistas, estúdios de jogos, comunidades e criadores que desejam que vendas futuras contribuam para a continuidade do trabalho.

No entanto, informações sobre royalties não significam que o pagamento esteja garantido em todos os caminhos de negociação possíveis.

O contrato de venda, a lógica do marketplace e o fluxo da transação precisam efetivamente respeitar as regras de pagamento.

A NEP-171 cuida da propriedade e das transferências, enquanto a NEP-199 trata das informações de pagamento das vendas.

Os criadores devem informar claramente as expectativas de royalties antes de uma emissão ou venda.

Compradores e vendedores devem entender como os royalties e as taxas afetam os valores líquidos recebidos.

O projeto de royalties deve ser transparente, pois regras de pagamento pouco claras podem prejudicar a confiança.

NEP-171 e eventos NEP-297

A NEP-297 é o padrão de eventos usado por contratos da NEAR para emitir logs de eventos estruturados.

O padrão de eventos NEP-297 permite registrar eventos de forma consistente para aplicativos e indexadores.

A NEP-171 exige comportamentos de evento no ecossistema de padrões para que as ferramentas acompanhem com mais consistência emissões, transferências, queimas e outras atividades de NFTs.

Os eventos são importantes porque indexadores e aplicativos costumam depender dos logs para atualizar visualizações de propriedade, feeds de atividade, dashboards de análise e sistemas de notificação.

Uma carteira pode exibir um NFT recebido após indexar um evento de transferência.

Uma ferramenta de análise pode contabilizar a atividade de uma coleção lendo eventos padronizados de NFT.

Um marketplace pode usar dados de eventos para atualizar listagens, vendas e status de propriedade.

Sem eventos padronizados, cada aplicativo precisaria de uma lógica de análise personalizada.

Os eventos facilitam a observação e a integração dos dados de NFTs da NEAR.

NEP-171 e gerenciamento de armazenamento NEP-145

A NEAR tem um modelo de armazenamento que separa as taxas de computação dos custos de armazenamento persistente.

O padrão de gerenciamento de armazenamento NEP-145 define uma forma comum para os contratos gerenciarem depósitos de armazenamento.

Isso é importante para NFTs porque armazenar propriedade de tokens, referências de metadados, aprovações e registros de contas pode exigir espaço no contrato.

Alguns fluxos de NFT e marketplace exigem que usuários ou projetos cubram custos de armazenamento antes que determinadas ações possam ser concluídas.

Por exemplo, um contrato de marketplace pode exigir um depósito de armazenamento antes de guardar os dados de listagem de um usuário.

Isso é diferente de simplesmente pagar gas pela computação.

O gas paga pela execução, enquanto os depósitos de armazenamento ajudam a cobrir dados persistentes mantidos on-chain.

Os usuários devem entender que uma ação com NFT na NEAR pode incluir custos de gas e de armazenamento.

Os desenvolvedores devem projetar fluxos de armazenamento de forma clara para que os usuários não sejam surpreendidos por transações com falha ou depósitos ausentes.

NEP-171 e emissão de NFTs

A emissão é o processo de criar um novo NFT dentro de um contrato de NFT da NEAR.

A NEP-171 define o comportamento básico dos NFTs, mas os métodos de emissão podem variar conforme a implementação do contrato.

Muitos contratos de NFT da NEAR usam um método como

para criar um token e atribuí-lo a uma conta receptora.

O guia oficial de uso de NFTs da NEAR apresenta exemplos em que a emissão envia um ID de token, um ID de destinatário e os metadados do token ao contrato.

Durante a emissão, o contrato pode armazenar a propriedade, os metadados do token, as informações de royalties e os dados da coleção.

O contrato também pode exigir um depósito anexado para cobrir o armazenamento usado pelo novo NFT.

Os criadores devem testar a lógica de emissão antes do lançamento, pois erros nos IDs de token, metadados, oferta ou permissões podem ser difíceis de corrigir depois.

Os usuários só devem emitir NFTs por meio de links e contas de contrato oficiais do projeto.

Uma página de emissão falsa pode induzir os usuários a assinar ações inseguras, mesmo que a coleção verdadeira seja legítima.

NEP-171 e transferências

As transferências movem um NFT NEP-171 de uma conta NEAR para outra.

O método básico de transferência é

.

Quem chama o método deve ser o proprietário atual ou uma conta aprovada de acordo com as regras de aprovação do contrato.

O guia do padrão de NFT da NEAR informa que

exige que exatamente 1 yoctoNEAR seja anexado.

Esse pequeno depósito anexado é usado com frequência no projeto de contratos da NEAR para exigir a assinatura de uma chave de acesso total em ações confidenciais.

Uma transferência pode incluir um campo de memo opcional para informações adicionais.

As transferências são importantes para presentear, mover NFTs entre contas, vender NFTs, usar fluxos de escrow ou enviar ativos para aplicativos compatíveis.

Os usuários devem sempre confirmar a conta receptora antes de transferir.

Transferências em blockchain podem ser difíceis ou impossíveis de reverter se forem enviadas à conta errada.

NEP-171 e chamadas de transferência

O método

é um dos recursos mais importantes da NEP-171.

Ele permite que um usuário transfira um NFT para um contrato receptor e chame um método desse contrato no mesmo fluxo de alto nível.

Isso permite vincular NFTs à lógica de aplicativos.

Por exemplo, um NFT pode ser enviado para um contrato de jogo, escrow, staking, aluguel, empréstimo ou para um aplicativo de NFT composável que saiba lidar com o token recebido.

O contrato receptor implementa

para decidir o que deve acontecer após receber o NFT.

Se o receptor rejeitar o NFT, o fluxo de resolução pode devolvê-lo ao remetente.

Esse padrão é poderoso porque a NEAR usa chamadas assíncronas entre contratos.

Os desenvolvedores devem tratar cuidadosamente a lógica das chamadas de transferência, pois callbacks com falha, valores de retorno incorretos ou comportamento inseguro do receptor podem confundir os usuários.

Os usuários só devem usar fluxos de chamada de transferência com contratos que conheçam e em que confiem.

NEP-171 e aprovações

As aprovações permitem que o proprietário de um NFT conceda a outra conta permissão para transferir um token.

Na prática, as aprovações são usadas com frequência para listar um NFT, iniciar um fluxo de escrow ou permitir que um contrato de aplicativo mova o NFT quando uma condição for atendida.

O método

pode conceder autoridade de transferência a outra conta.

O método

pode remover a aprovação de uma conta.

O método

pode remover todas as aprovações de um token.

O método

pode verificar se uma conta tem aprovação.

As aprovações são úteis, mas não devem ser tratadas com descuido.

Se um usuário aprovar um contrato malicioso ou comprometido, o NFT poderá ser transferido de uma forma que ele não esperava.

Boas interfaces de carteiras e aplicativos devem identificar claramente os destinatários da aprovação antes de o usuário assinar.

NEP-171 e metadados

Os metadados são as informações que tornam um NFT NEP-171 compreensível para pessoas e aplicativos.

Os metadados NEP-177 podem descrever o título, a descrição, a mídia, o hash da mídia, as cópias da edição, a data de emissão, a data de atualização, o link de referência e o hash de referência do NFT.

A mídia pode apontar para uma imagem, vídeo, arquivo de áudio, arquivo 3D, animação ou outro ativo.

Quando possível, o padrão de metadados incentiva o uso de armazenamento descentralizado endereçado pelo conteúdo.

A qualidade dos metadados é fundamental, pois um token sem metadados confiáveis pode parecer danificado ou confuso em carteiras e aplicativos.

Os metadados também podem afetar raridade, pesquisa, exibição, lógica de jogos, licenciamento e confiança dos usuários.

Os criadores devem evitar metadados vagos, enganosos ou mutáveis, a menos que o comportamento dinâmico faça parte claramente do projeto.

Os usuários devem verificar se os metadados são definitivos, mutáveis, dinâmicos, revelados posteriormente ou controlados por uma conta administradora.

Um NFT tecnicamente válido ainda pode ser fraco se seus metadados não forem confiáveis.

Exemplo de metadados NEP-177 para um NFT NEP-171

Um objeto simples de metadados de token para um NFT NEP-171 pode ser assim:

Este exemplo mostra como um NFT da NEAR pode vincular um token a título, descrição, mídia, quantidade de cópias da edição e outras informações estruturadas.

O campo

aponta para o ativo principal.

Os campos

e podem ajudar a verificar se o conteúdo vinculado não foi substituído sem aviso.

O campo

pode conter JSON convertido em string com características específicas do projeto, raridade, estatísticas de jogo ou outros detalhes.

Em uma coleção real, os metadados devem ser testados antes da emissão, pois links quebrados e hashes incorretos podem prejudicar a confiança dos usuários.

NEP-171 e armazenamento de mídia

A NEP-171 define o comportamento dos contratos de NFT, mas o armazenamento de mídia costuma ser feito por meio de metadados e sistemas externos.

Alguns NFTs da NEAR podem armazenar pequenos dados on-chain, mas arquivos de mídia ricos costumam ser grandes demais para armazenamento direto on-chain.

Muitos projetos de NFT usam IPFS ou outro sistema endereçado pelo conteúdo para arquivos de mídia e metadados.

O guia de dados de NFT do IPFS explica práticas para armazenar dados de NFT e proporcionar uma experiência melhor e mais duradoura a criadores e proprietários.

O armazenamento endereçado pelo conteúdo pode ajudar os usuários a detectar alterações porque o identificador de conteúdo está vinculado ao próprio conteúdo.

No entanto, o IPFS não garante automaticamente disponibilidade permanente.

Os arquivos ainda precisam de pinning, backups, monitoramento e planejamento de preservação a longo prazo.

Os criadores devem tratar o armazenamento como parte do produto NFT, e não como algo secundário.

Os usuários devem verificar se a mídia e as referências são duráveis antes de presumir que um NFT NEP-171 permanecerá exibível para sempre.

NEP-171 e royalties

Royalties são um recurso comum de NFTs, especialmente em coleções de arte, música, jogos e criadores.

Na NEAR, os royalties e os pagamentos costumam ser discutidos por meio da NEP-199, e não apenas do padrão central NEP-171.

Um NFT NEP-171 pode ser transferível sem qualquer lógica de royalties.

Um marketplace ou contrato de venda pode precisar consultar as informações de pagamento e direcionar os valores da venda de acordo com as regras do projeto.

Os criadores devem explicar os percentuais de royalties, as contas de pagamento, os colaboradores e se os royalties podem mudar.

Os colecionadores devem entender que o suporte a royalties depende do fluxo de venda e da integração do contrato.

Os royalties podem apoiar os criadores, mas também podem afetar os valores que os vendedores recebem na revenda.

Informações claras sobre royalties reduzem conflitos entre criadores, colecionadores e desenvolvedores de aplicativos.

O projeto de royalties deve ser prático, transparente e coerente com as expectativas dos usuários.

NEP-171 e marketplaces

A NEP-171 não transforma automaticamente todo contrato de NFT em um marketplace.

Um contrato básico de NFT NEP-171 pode armazenar e transferir NFTs sem implementar listagens de venda, ofertas, escrow, liquidação ou descoberta de preços.

As funcionalidades de marketplace normalmente são gerenciadas por contratos de marketplace separados ou por camadas de aplicativo.

Para listar um NFT da NEAR à venda, o usuário pode precisar cobrir os custos de armazenamento do marketplace e aprovar o contrato do marketplace para transferir o NFT caso ocorra uma venda.

Essa aprovação costuma ser feita por meio da lógica de aprovação da NEP-178.

Os usuários devem entender que aprovar um contrato de venda concede a ele poder sobre o NFT nas condições definidas.

Antes da aprovação, devem verificar a conta do contrato do marketplace.

Também devem conferir o preço, os royalties, as taxas, os depósitos de armazenamento e as regras de cancelamento.

A NEP-171 fornece a base do NFT, enquanto os contratos de marketplace oferecem o comportamento de negociação.

NEP-171 e jogos

A NEP-171 pode oferecer suporte a NFTs usados em jogos blockchain na NEAR.

Um NFT de jogo pode representar um personagem, carta, skin, terreno, arma, animal de estimação, veículo, distintivo, recurso, conquista ou passe de acesso.

A interface central da NEP-171 ajuda o jogo a verificar quem é o proprietário de um token e a transferir ativos quando necessário.

Os metadados NEP-177 podem descrever estatísticas de jogo, raridade, classe, nível, aparência ou tipo de item.

O comportamento de chamada de transferência pode permitir que NFTs interajam com contratos de jogos e outras lógicas de aplicativos.

Os desenvolvedores de jogos devem ter cuidado com a oferta, o equilíbrio, as atualizações de metadados, as restrições de transferência e os custos de armazenamento.

Os jogadores devem verificar se a utilidade do NFT já está disponível ou se foi apenas planejada.

Um item de jogo NEP-171 pode ser tecnicamente válido e ainda assim perder valor se o jogo estiver inativo ou tiver um equilíbrio inadequado.

Um bom projeto de NFT para jogos deve tornar a propriedade útil sem deixar a jogabilidade injusta ou confusa.

NEP-171 e NFTs de associação

A NEP-171 também pode oferecer suporte a NFTs de associação e acesso.

Um NFT de associação pode liberar acesso a uma comunidade, portal de aprendizagem, evento, assinatura, benefício de fidelidade ou funcionalidade de produto restrita a tokens.

Um aplicativo pode verificar se uma conta NEAR possui um NFT qualificado antes de conceder acesso.

O contrato do NFT fornece os dados de propriedade, enquanto o aplicativo define a experiência de acesso.

Os NFTs de associação devem explicar claramente se os benefícios são permanentes, sazonais, renováveis, revogáveis, transferíveis ou vinculados a uma única conta.

Se um NFT de associação for transferível, a venda do token também poderá transferir o acesso ao novo proprietário.

Se o projeto desejar um acesso de identidade intransferível, talvez seja necessário outro tipo de estrutura.

Os usuários não devem presumir que um NFT NEP-171 concede acesso permanente, a menos que os termos do projeto digam isso.

A propriedade do token e a prestação do serviço estão relacionadas, mas não são a mesma coisa.

NEP-171 e ingressos

Os NFTs NEP-171 podem representar ingressos ou passes para eventos.

Um NFT de ingresso pode incluir nos metadados o nome do evento, a data, o tipo de assento, o nível de acesso, o status de resgate ou o registro de presença.

A possibilidade de transferência é importante porque alguns ingressos devem ser livremente transferíveis, enquanto outros devem ter restrições para reduzir fraudes ou cambismo.

Os organizadores de eventos devem explicar como a propriedade é verificada na entrada.

Também devem explicar se o ingresso expira, se vira um colecionável após o uso ou se continua transferível depois do evento.

Os metadados devem evitar a exposição de informações pessoais confidenciais, pois os dados da blockchain podem ser públicos.

Os usuários devem verificar o contrato oficial antes de comprar ou aceitar um NFT de ingresso.

Uma imagem copiada do ingresso não comprova acesso válido ao evento.

O estado do contrato e as regras do organizador determinam se o ingresso é válido.

NEP-171 e certificados

A NEP-171 pode ser usada para certificados, distintivos, credenciais ou registros de comprovação de participação.

Um NFT de certificado pode indicar que uma conta concluiu um curso, participou de um evento, conquistou uma função ou recebeu um reconhecimento.

No entanto, NFTs de credenciais exigem um projeto cuidadoso, pois a possibilidade de transferência pode gerar problemas de confiança.

Se um certificado puder ser vendido, talvez ele deixe de comprovar que o titular atual o conquistou.

Alguns casos de uso de credenciais podem exigir modelos intransferíveis ou com transferência restrita, diferentes de um NFT normalmente negociável.

Os metadados não devem incluir dados pessoais desnecessários.

Antes de emitir NFTs de credenciais, os projetos devem considerar privacidade, revogação, expiração e verificação.

Os usuários devem entender se o NFT é um distintivo colecionável ou uma credencial oficial.

A NEP-171 pode fornecer o token, mas o significado do certificado depende do emissor e das regras.

NEP-171 e segurança

A segurança é importante para NFTs NEP-171 porque a propriedade e os direitos de transferência são controlados por contratos inteligentes e permissões de conta.

Os usuários devem verificar os nomes das contas de contrato antes de emitir, transferir, listar ou aprovar NFTs.

Devem tomar cuidado com páginas falsas de emissão, coleções copiadas, links de phishing, airdrops falsos e solicitações maliciosas de aprovação.

O guia da FTC sobre golpes com criptomoedas recomenda cautela com ofertas cripto que usam personificação, alegações urgentes ou promessas suspeitas.

Nenhum projeto legítimo de NFT deve pedir uma seed phrase, frase de recuperação ou chave privada.

Os usuários devem ler atentamente as solicitações da carteira antes de assinar.

Os desenvolvedores devem usar bibliotecas testadas, revisar chamadas entre contratos, proteger métodos restritos ao proprietário e evitar poderes administrativos desnecessários.

Auditorias e testes de contratos inteligentes podem reduzir riscos, mas não os eliminam por completo.

O uso seguro da NEP-171 exige tanto código seguro quanto comportamento cuidadoso dos usuários.

NEP-171 e permissões de conta

As contas NEAR podem ter diferentes chaves de acesso e permissões.

Isso é importante porque uma transferência ou aprovação de NFT pode exigir a autoridade correta da conta.

Uma chave de acesso total pode assinar ações confidenciais, enquanto permissões limitadas podem restringir o que um aplicativo pode fazer.

Os usuários devem entender quais permissões uma carteira ou aplicativo está solicitando.

Um fluxo de login prático não deve ocultar comportamentos perigosos de transferência ou aprovação.

Os desenvolvedores devem solicitar somente as permissões necessárias ao aplicativo.

Os usuários devem remover chaves de acesso não utilizadas e evitar conceder permissões de longo prazo a aplicativos desconhecidos.

A segurança da conta faz parte da segurança dos NFTs, pois uma conta comprometida pode perder seus NFTs.

A gestão adequada de permissões é especialmente importante para colecionadores, jogos, criadores e marketplaces com interações frequentes com NFTs.

NEP-171 e chamadas entre contratos

O modelo assíncrono de contratos inteligentes da NEAR torna as chamadas entre contratos importantes para aplicativos de NFT.

A NEP-171 oferece suporte a esse modelo por meio de

e da lógica relacionada do contrato receptor.

Isso permite enviar um NFT a outro contrato e acionar uma ação ao mesmo tempo.

Por exemplo, um contrato pode receber um NFT e decidir se o aceita, rejeita, bloqueia, utiliza ou devolve.

Esse modelo possibilita casos de uso composáveis de NFT, como jogos, escrow, empréstimos, aluguéis, staking, criação de itens e depósitos específicos de aplicativos.

Os desenvolvedores precisam tratar cuidadosamente os resultados assíncronos, pois as chamadas podem falhar ou retornar valores inesperados.

A etapa de resolução é importante porque determina se o NFT permanece com o receptor ou volta ao remetente.

Os usuários devem entender que enviar um NFT a um contrato é diferente de enviá-lo a uma conta comum.

Os contratos podem conter uma lógica personalizada que afeta o que acontece em seguida.

NEP-171 e indexadores

Os indexadores coletam dados da blockchain e os organizam para aplicativos.

Para NFTs NEP-171, os indexadores podem acompanhar eventos de emissão, transferência e queima, histórico de propriedade, aprovações, referências de metadados e atividade da coleção.

Os indexadores são importantes porque carteiras e aplicativos costumam precisar de buscas rápidas, difíceis de realizar diretamente a partir do estado bruto da blockchain.

Um aplicativo de portfólio pode precisar exibir todos os NFTs de uma conta.

Um jogo pode precisar verificar o inventário.

Uma ferramenta de análise pode precisar consultar a oferta da coleção e a atividade de transferências.

Métodos e eventos padronizados tornam a indexação mais fácil e confiável.

No entanto, os dados do indexador podem estar atrasados, em cache, incompletos ou incorretos.

Quando a precisão é importante, os aplicativos devem entender a diferença entre dados indexados e o estado do contrato.

NEP-171 e exibição em carteiras

As carteiras exibem NFTs NEP-171 lendo os dados do contrato e os metadados.

Uma carteira pode mostrar o título do NFT, a imagem, o nome da coleção, o ID do token, a conta proprietária e os botões de ação.

Se os metadados estiverem ausentes ou a mídia indisponível, a carteira poderá exibir uma imagem em branco ou quebrada.

Se a carteira não aceitar determinado formato de metadados ou tipo de mídia, o NFT poderá não ser exibido como esperado.

A exibição em uma carteira não comprova que o NFT é oficial.

NFTs de spam ou cópias também podem aparecer em carteiras se contratos enviarem tokens a uma conta.

Antes de confiar em um NFT, os usuários devem verificar a conta do contrato, a origem do projeto, os metadados e o histórico de transações.

As carteiras devem exibir informações do contrato com clareza suficiente para ajudar os usuários a evitar ativos falsos.

Uma boa exibição na carteira deve ajudar os usuários a entender tanto o ativo quanto os riscos.

NEP-171 e propriedade de NFTs

Ser proprietário de um NFT NEP-171 significa que o contrato do NFT registra uma conta NEAR como proprietária de determinado ID de token.

Isso é diferente de possuir o arquivo de mídia, a marca, os direitos autorais ou o ativo do mundo real que o NFT possa referenciar.

O token pode comprovar a propriedade no nível do contrato, mas os direitos legais e práticos dependem dos termos do projeto.

O estudo sobre NFTs do U.S. Copyright Office e da USPTO explica que a propriedade de um NFT e os direitos de propriedade intelectual podem ser questões distintas.

Os criadores devem explicar quais direitos são concedidos aos titulares do NFT.

Os colecionadores devem ler os termos da licença antes de usar comercialmente arte, música, personagens ou marcas de NFTs.

Em alguns NFTs, a propriedade pode significar apenas o controle de um token.

Em outros, a propriedade também pode liberar acesso, utilidade em jogos ou direitos limitados sobre conteúdo.

Uma descrição clara dos direitos evita confusão entre a propriedade do token e a propriedade do conteúdo.

NEP-171 e impostos

As atividades com NFTs NEP-171 podem gerar dúvidas sobre declaração de impostos, dependendo do país e da situação pessoal do usuário.

A página oficial do IRS sobre ativos digitais inclui tokens não fungíveis na categoria de ativos digitais e informa que transações com ativos digitais podem precisar ser declaradas na declaração de imposto.

Emitir, comprar, vender, trocar, receber, presentear, ganhar ou usar NFTs da NEAR pode ter consequências fiscais em algumas jurisdições.

Em alguns lugares, o uso de criptomoedas para comprar um NFT também pode ser considerado uma alienação tributável do ativo usado no pagamento.

Os criadores podem precisar registrar receitas de emissão, royalties, depósitos de armazenamento, taxas de gas, distribuições gratuitas e despesas comerciais.

Os colecionadores podem precisar registrar preço de compra, valores de venda, taxas, datas, IDs de token e valores justos de mercado.

Jogadores podem precisar registrar recompensas, vendas de itens e conversões de tokens.

As regras fiscais variam bastante, por isso usuários com atividades relevantes devem consultar um profissional tributário qualificado.

Manter bons registros é importante, pois pode ser difícil reconstruir transações da blockchain posteriormente.

NEP-171 e desenvolvedores

Os desenvolvedores podem criar contratos de NFT NEP-171 diretamente ou usar ferramentas já existentes da NEAR.

O guia oficial de ferramentas para contratos de NFT da NEAR explica como usar essas ferramentas para implementar funcionalidades de NFT e padrões relacionados.

As responsabilidades dos desenvolvedores incluem escolher IDs de token, projetar regras de emissão, gerenciar depósitos de armazenamento, definir metadados, adicionar aprovações, emitir eventos e testar transferências.

Os desenvolvedores devem decidir se o projeto precisa de enumeração, royalties, funções de queima, controles de pausa, acesso baseado em funções, metadados dinâmicos ou utilidade personalizada.

Devem escrever testes para transferências normais, transferências aprovadas, chamadas de transferência, chamadas de receptor com falha, casos extremos de armazenamento e ações não autorizadas.

Também devem considerar a possibilidade de atualização e os controles administrativos antes do lançamento.

Um contrato de NFT seguro não deve se apoiar apenas no fato de seguir um padrão.

Os padrões definem interfaces, mas a qualidade da implementação continua sendo importante.

Um bom desenvolvimento NEP-171 exige tanto compatibilidade quanto um projeto cuidadoso do contrato.

NEP-171 e criadores

Os criadores podem usar NFTs NEP-171 para publicar arte, colecionáveis, associações, ingressos, distintivos, ativos de jogos ou edições digitais na NEAR.

Antes do lançamento, os criadores devem definir a finalidade da coleção, a oferta, a estrutura das edições, o formato dos metadados, o plano de armazenamento, as regras de royalties e os direitos dos titulares.

Devem garantir que possuem ou têm permissão para usar as obras de arte, o áudio, os vídeos, os personagens ou outras mídias incluídas no NFT.

Devem divulgar as informações oficiais do contrato para que os colecionadores possam evitar coleções copiadas.

Devem informar se os metadados são definitivos, mutáveis, dinâmicos, não revelados ou controlados por uma conta administradora.

Devem explicar depósitos de armazenamento e taxas caso os usuários precisem pagá-los durante a emissão ou listagem.

Devem evitar prometer valor de revenda garantido.

Os criadores devem pensar na preservação dos arquivos a longo prazo, pois a confiança nos NFTs pode diminuir se a mídia desaparecer.

Um projeto NEP-171 sólido se baseia em um projeto claro, direitos bem definidos, metadados confiáveis e comunicação transparente.

NEP-171 e colecionadores

Os colecionadores devem verificar o contrato do NFT antes de comprar, emitir ou aceitar um NFT NEP-171.

Devem conferir a conta do contrato, o ID do token, a origem do criador, os metadados, o armazenamento da mídia, as regras de royalties e o status das aprovações.

Também devem avaliar se o NFT tem utilidade real ou apenas alegações promocionais.

Para NFTs de arte, os colecionadores devem avaliar originalidade, reputação do criador, tamanho da edição e termos de licenciamento.

Para NFTs de jogos, devem avaliar a utilidade disponível no jogo, a oferta, o equilíbrio dos itens, a possibilidade de transferência e a atividade do projeto.

Para NFTs de associação, devem verificar se os benefícios são transferíveis, limitados no tempo ou revogáveis.

Para NFTs de ingresso, devem verificar se o organizador do evento reconhece o token.

Os colecionadores não devem comprar algo apenas porque uma carteira ou um aplicativo exibe uma imagem atraente.

O contrato oficial e os termos do projeto são mais importantes do que a imagem de pré-visualização.

Benefícios da NEP-171

A NEP-171 oferece uma base técnica comum para os NFTs da NEAR.

Ela oferece suporte a IDs de token exclusivos, consultas de propriedade, transferências, chamadas de transferência e comportamento de receptores.

Permite que carteiras e aplicativos integrem contratos de NFT com mais facilidade.

Funciona com padrões relacionados a metadados, aprovações, enumeração, royalties, armazenamento e eventos.

Oferece suporte a casos de uso composáveis por meio de chamadas entre contratos.

É compatível com o modelo de contas e contratos inteligentes assíncronos da NEAR.

Pode dar suporte a arte, jogos, associações, ingressos, distintivos, credenciais e colecionáveis digitais.

Ajuda os desenvolvedores a evitar a criação do zero de comportamentos de NFT incompatíveis.

O principal benefício da NEP-171 é tornar previsíveis os comportamentos de propriedade e transferência de NFTs entre aplicativos da NEAR.

Riscos e limitações da NEP-171

A NEP-171 é um padrão, não uma garantia de segurança ou valor.

Um contrato pode afirmar que segue o padrão e ainda ter metadados ruins, segurança fraca, direitos pouco claros ou um projeto mal elaborado.

Um NFT válido ainda pode ser um golpe, token de spam, ativo copiado ou coleção de baixa qualidade.

A NEP-171 não oferece automaticamente funcionalidades de marketplace, royalties, enumeração, gerenciamento de armazenamento ou qualidade de metadados, a menos que padrões relacionados e escolhas de implementação sejam usados corretamente.

Ela também não garante que a mídia off-chain permanecerá disponível.

Ela não concede automaticamente direitos autorais ou comerciais ao titular do NFT.

Ela não torna um NFT líquido ou valioso.

Os usuários devem avaliar todo o sistema do NFT, e não apenas o rótulo do padrão.

O padrão é necessário para a compatibilidade, mas, por si só, não basta para gerar confiança.

Como avaliar um NFT NEP-171

Comece verificando a origem oficial do projeto e a conta do contrato.

Verifique o ID do token e a conta proprietária por meio de uma carteira, explorador, indexador ou consulta direta ao contrato confiável.

Confira se o contrato segue a NEP-171 e se também oferece suporte aos metadados NEP-177.

Analise os campos de metadados, o link da mídia, o hash da mídia, o link de referência e o método de armazenamento.

Verifique se foram concedidas aprovações a algum marketplace, aplicativo ou contrato.

Avalie se o NFT tem royalties ou regras de pagamento baseadas no comportamento da NEP-199.

Confira se o NFT é transferível, bloqueado, dinâmico, sujeito a expiração ou vinculado a um aplicativo.

Leia a licença antes de presumir que há direitos comerciais.

Um bom NFT NEP-171 deve ser verificável, compreensível e útil antes de o usuário assinar qualquer transação.

Boas práticas para usuários da NEP-171

Os usuários devem verificar as contas oficiais dos contratos antes de emitir ou comprar NFTs.

Devem revisar as solicitações da carteira antes de assinar transferências, aprovações ou chamadas de transferência.

Devem evitar aprovar contratos desconhecidos para transferir NFTs.

Devem revogar aprovações que não forem mais necessárias.

Devem verificar os metadados e o armazenamento da mídia antes de avaliar a qualidade de um NFT.

Devem ler os direitos dos titulares e os termos de licenciamento antes de usar a mídia comercialmente.

Devem manter registros de emissões, compras, vendas, depósitos de armazenamento, taxas de gas e royalties.

Devem ignorar NFTs suspeitos, airdrops falsos e links de emissão enviados por mensagens diretas.

Devem lembrar que a compatibilidade com a NEP-171 não garante desempenho de preço nem a confiabilidade do projeto.

Boas práticas para desenvolvedores da NEP-171

Os desenvolvedores devem implementar corretamente a interface exigida pela NEP-171.

Devem usar metadados NEP-177 ao criar NFTs voltados aos usuários.

Devem oferecer aprovações NEP-178 somente quando necessário e garantir que sejam seguras.

Devem considerar o uso da enumeração NEP-181 se carteiras, aplicativos ou usuários precisarem listar tokens.

Devem implementar logs de eventos padronizados para que indexadores possam acompanhar as atividades dos NFTs.

Devem explicar claramente os depósitos de armazenamento e evitar custos ocultos.

Devem testar chamadas de transferência, callbacks, receptores com falha, IDs de aprovação e acessos não autorizados.

Devem divulgar permissões de atualização, métodos restritos ao proprietário, funções de pausa e controle dos metadados.

Um contrato NEP-171 deve ser compatível, seguro, eficiente e compreensível.

Erros comuns com a NEP-171

Um erro comum é pensar que a NEP-171, por si só, inclui metadados, royalties, enumeração e vendas em marketplaces.

Outro erro é tratar a exibição em uma carteira como prova de que um NFT é oficial.

Um terceiro erro é aprovar um contrato desconhecido para transferir um NFT.

Um quarto erro é ignorar os depósitos de armazenamento e não entender por que uma listagem ou emissão falha.

Um quinto erro é presumir que a propriedade do token concede automaticamente direitos autorais.

Um sexto erro é confiar em um NFT copiado porque ele usa a mesma imagem de um ativo oficial.

Um sétimo erro é ignorar se os metadados são mutáveis ou estão armazenados de forma confiável.

Um oitavo erro é enviar um NFT a um contrato sem entender o comportamento da chamada de transferência.

Um nono erro é presumir que todo NFT NEP-171 pode ser vendido facilmente.

Um décimo erro é não manter registros fiscais das atividades com NFTs.

Equívocos comuns sobre a NEP-171

Um equívoco comum é pensar que a NEP-171 representa todo o sistema de NFTs da NEAR.

Na realidade, a NEP-171 é a interface central de NFT e funciona com padrões relacionados, como NEP-177, NEP-178, NEP-181, NEP-199 e NEP-297.

Outro equívoco é pensar que um NFT NEP-171 fica armazenado dentro de uma carteira.

O NFT é registrado no contrato de NFT, enquanto a carteira exibe a propriedade vinculada à conta do usuário.

Um terceiro equívoco é achar que todo NFT NEP-171 tem mídia permanente.

A disponibilidade da mídia depende do projeto de armazenamento, do pinning, dos backups e da manutenção do projeto.

Um quarto equívoco é acreditar que um NFT compatível com o padrão é automaticamente seguro.

Ainda podem existir golpes, metadados ruins, contratos vulneráveis, direitos pouco claros e baixa liquidez.

Um quinto equívoco é achar que a propriedade de um NFT NEP-171 sempre equivale à propriedade integral do ativo vinculado.

Os direitos legais dependem da licença do projeto e da legislação aplicável.

Resumo de SEO e AEO sobre NEP-171 (NFTs da NEAR)

NEP-171 é o padrão central de NFT para tokens não fungíveis na blockchain NEAR.

Ele define métodos padronizados para consultar dados de NFTs, transferi-los, anexá-los a chamadas entre contratos e resolver fluxos de chamada de transferência.

Os NFTs NEP-171 ficam em contratos inteligentes de NFT que registram IDs de token e contas proprietárias.

A NEP-177 acrescenta metadados de NFT; a NEP-178, gerenciamento de aprovações; a NEP-181, enumeração; a NEP-199, royalties e pagamentos; e a NEP-297 oferece suporte a logs de eventos.

A NEP-171 pode dar suporte a arte, jogos, associações, ingressos, distintivos, credenciais, colecionáveis e aplicativos com acesso restrito a tokens.

Antes de interagir com NFTs NEP-171, os usuários devem verificar contas de contrato, IDs de token, metadados, aprovações, armazenamento, royalties, direitos e solicitações da carteira.

Os desenvolvedores devem implementar a interface com cuidado e testar transferências, aprovações, armazenamento, metadados e fluxos entre contratos.

A NEP-171 cria uma base compartilhada de NFTs para a NEAR, mas não garante segurança, valor, direitos autorais ou permanência da mídia.

Perguntas frequentes

O que significa NEP-171?

NEP-171 é o padrão de tokens não fungíveis para NFTs na blockchain NEAR.

O que a NEP-171 define?

A NEP-171 define a interface e o comportamento centrais dos contratos de NFT da NEAR, incluindo consultas de tokens, transferências, chamadas de transferência e resolução de transferências.

NEP-171 é o mesmo que NEP-177?

Não. A NEP-171 define o comportamento central dos NFTs, enquanto a NEP-177 define os metadados de contratos e tokens de NFT.

Onde ficam armazenados os NFTs NEP-171?

Os NFTs NEP-171 ficam em contratos inteligentes de NFT, enquanto as carteiras exibem a propriedade e os metadados lendo os dados do contrato.

O que é

nft_transfer

na NEP-171?

é o método usado para transferir o ID de um NFT específico para outra conta NEAR.

O que é

nft_transfer_call

na NEP-171?

transfere um NFT para um contrato receptor e aciona a lógica desse contrato no mesmo fluxo.

A NEP-171 inclui royalties?

Não. Os royalties e os pagamentos são tratados por padrões relacionados, como a NEP-199, e não apenas pela interface central da NEP-171.

Ser proprietário de um NFT NEP-171 concede direitos autorais?

Não. Ser proprietário de um NFT NEP-171 não concede automaticamente direitos autorais, a menos que a licença do projeto conceda esses direitos com clareza.

Os NFTs NEP-171 podem ser usados em jogos?

Sim. Os NFTs NEP-171 podem representar itens, cartas, personagens, terrenos, distintivos, skins e outros ativos de jogo quando o jogo oferece suporte a eles.

Um NFT NEP-171 é sempre seguro?

Não. A compatibilidade com a NEP-171 não garante segurança. Os usuários ainda precisam verificar a confiabilidade do contrato, os metadados, as aprovações, o armazenamento, os direitos e possíveis golpes.

Conclusão

A NEP-171 é a base dos NFTs na blockchain NEAR.

Ela define a interface essencial que permite aos contratos de NFT oferecer suporte a IDs de token exclusivos, consultas de propriedade, transferências, chamadas de transferência e resolução de transferências.

Essa estrutura compartilhada ajuda carteiras, jogos, marketplaces, indexadores, criadores e aplicativos a interagir com NFTs da NEAR de forma mais previsível.

A NEP-171 é mais útil quando combinada com padrões relacionados, como NEP-177 para metadados, NEP-178 para aprovações, NEP-181 para enumeração, NEP-199 para royalties e pagamentos, NEP-145 para gerenciamento de armazenamento e NEP-297 para eventos.

Para os usuários, a NEP-171 facilita reconhecer e transferir NFTs da NEAR, mas não elimina a necessidade de verificá-los com cuidado.

Para os desenvolvedores, a NEP-171 oferece uma interface clara, mas a qualidade da implementação, os testes, o projeto de armazenamento e a segurança continuam importantes.

Para os criadores, a NEP-171 oferece suporte a coleções de NFT, associações, ingressos, itens de jogo, distintivos e ativos digitais, mas o projeto ainda precisa definir direitos, utilidade, oferta e acesso duradouro à mídia.

Para os colecionadores, as principais verificações incluem conta do contrato, ID do token, metadados, armazenamento, aprovações, regras de royalties, possibilidade de transferência e termos de licenciamento.

Um NFT NEP-171 pode ser tecnicamente válido e ainda apresentar riscos se tiver metadados ruins, mídia copiada, aprovações inseguras, direitos pouco claros ou demanda fraca.

A forma mais segura de entender a NEP-171 é considerá-la o padrão técnico central dos NFTs da NEAR, e não uma garantia completa de autenticidade, valor ou propriedade legal.

Quando usada com responsabilidade, a NEP-171 ajuda a NEAR a oferecer casos de uso interoperáveis de NFT em arte, jogos, associações, ingressos, credenciais, colecionáveis e aplicativos cripto.