FA2 (Tezos)

O que é FA2 na Tezos?

FA2 é um padrão unificado de tokens para contratos inteligentes na blockchain Tezos.

Ele define uma interface comum que carteiras, aplicativos descentralizados, exploradores de blockchain, marketplaces, jogos e outras ferramentas cripto podem usar para interagir com tokens Tezos.

O padrão está formalmente especificado na Proposta de Melhoria da Tezos 12, ou TZIP-12.

O padrão pode oferecer suporte a tokens fungíveis, tokens não fungíveis, ativos intransferíveis e contratos que gerenciam vários tipos de tokens ao mesmo tempo.

Essa flexibilidade permite que um contrato FA2 gerencie uma única criptomoeda, uma coleção de NFTs, vários ativos de um jogo ou uma combinação de diferentes modelos de tokens.

FA2 não determina o valor econômico, o status legal, a oferta ou a finalidade de um token.

Em vez disso, padroniza operações técnicas importantes, como transferir tokens, consultar saldos e autorizar operadores.

Um token FA2 não fica armazenado diretamente na conta Tezos do usuário da mesma forma que o tez, o ativo nativo da Tezos.

O contrato inteligente FA2 mantém um registro que indica qual conta possui cada token ou saldo de token.

A documentação oficial FA2 da Tezos descreve o FA2 como um padrão flexível que permite comportamentos personalizados de tokens, mantendo a compatibilidade com aplicativos existentes.

O que significa FA em FA2?

FA significa Financial Application (aplicação financeira).

O nome reflete o papel do padrão na definição de interfaces reutilizáveis para ativos financeiros e aplicativos tokenizados na Tezos.

FA2 é mais recente e flexível do que a interface de tokens FA1.2 anterior.

O número 2 identifica a família do padrão, e não uma versão de token escolhida de forma independente por cada emissor.

Um projeto não se torna compatível com FA2 apenas por incluir “FA2” no nome ou nos metadados do token.

O contrato inteligente precisa implementar as interfaces e o comportamento exigidos pela TZIP-12.

Por que a Tezos precisa de um padrão de tokens?

Uma blockchain permite que desenvolvedores criem muitos contratos inteligentes diferentes, mas interfaces de tokens completamente distintas dificultariam as integrações.

Uma carteira precisaria de código personalizado para cada contrato de token se cada contrato usasse funções diferentes para transferências e saldos.

Um marketplace também teria de aprender um processo de aprovação diferente para cada coleção de NFTs.

O FA2 fornece entrypoints e estruturas de dados previsíveis que reduzem esse problema de integração.

Uma carteira compatível pode reconhecer como consultar um saldo ou preparar uma transferência sem conhecer todos os detalhes do armazenamento interno.

Um marketplace compatível pode solicitar permissão de operador por meio de um processo padronizado.

Um explorador de blockchain ou indexador pode identificar movimentações de tokens e organizar saldos por endereço do contrato e ID do token.

A padronização melhora a interoperabilidade, mas não garante que todo contrato que use a interface seja seguro ou honesto.

A documentação de tokens da Tezos alerta que qualquer pessoa pode criar um contrato de token e definir comportamentos potencialmente prejudiciais ou restritivos.

Como funciona um token FA2?

Um token FA2 é controlado por um contrato inteligente criado na Tezos.

O contrato armazena um registro que representa a propriedade ou os saldos dos tokens.

No caso de um token fungível, o registro geralmente associa uma conta e um ID de token a uma quantidade.

No caso de um NFT, o registro pode associar um ID de token único ao seu proprietário ou registrar um saldo de uma unidade para o proprietário.

Quando ocorre uma transferência, o contrato FA2 verifica a autoridade do remetente e o saldo disponível.

Em seguida, o contrato subtrai os tokens da conta de origem e os adiciona à conta de destino.

O contrato inteligente também pode aplicar restrições personalizadas antes de aceitar a transferência.

Por exemplo, um token pode permitir transferências apenas pelo proprietário, aceitar operadores aprovados, pausar transferências ou proibi-las completamente.

Todas as alterações válidas de estado são registradas na Tezos e podem ser examinadas com ferramentas de blockchain compatíveis.

Como identificar um token FA2?

Um token FA2 é identificado de forma única pela combinação do endereço do contrato inteligente e do ID do token.

O ID do token é um número inteiro não negativo atribuído pelo contrato.

Dois tokens podem ter o mesmo ID se pertencerem a contratos FA2 diferentes, pois os endereços dos contratos os distinguem.

Portanto, informar apenas que um token tem ID 0 não é suficiente para identificá-lo de forma única.

Os usuários também precisam confirmar o endereço do contrato.

Se um contrato FA2 oferecer suporte a apenas um tipo de token, o ID do token deverá ser 0 segundo o padrão.

Se o contrato gerenciar vários tipos de tokens, poderá atribuir IDs diferentes a esses ativos.

A visão geral FA2 da SmartPy confirma que o endereço do contrato e o ID do token formam o identificador on-chain completo do token.

Que tipos de tokens o FA2 pode suportar?

Tokens fungíveis

Um token fungível consiste em unidades intercambiáveis que têm as mesmas características e o mesmo valor dentro do contrato.

Em geral, uma unidade pode ser trocada por outra unidade do mesmo token sem alterar a posição econômica do detentor.

Tokens fungíveis FA2 podem representar ativos de pagamento, unidades de governança, pontos de fidelidade, ativos de valor estável, ativos wrapped ou outras criptomoedas divisíveis.

O campo decimals dos metadados informa às carteiras onde exibir a vírgula decimal, mas os saldos são armazenados como unidades inteiras de números naturais.

Tokens não fungíveis

Um NFT FA2 representa um token distinto, identificado por um ID de token único.

O token pode estar associado a arte digital, itens de jogos, associações, certificados, acesso a eventos ou registros do mundo real.

Os metadados podem descrever a mídia, o criador, os atributos e outras informações relacionadas ao NFT.

A propriedade de um NFT não transfere automaticamente direitos autorais, propriedade intelectual ou propriedade legal de um objeto off-chain.

Esses direitos dependem dos termos do emissor e da legislação aplicável.

Contratos multiativos

Um contrato FA2 pode gerenciar vários IDs de tokens diferentes.

Um jogo poderia usar um contrato para moedas, armas, terrenos, personagens e recompensas colecionáveis.

Um projeto de NFT poderia gerenciar uma coleção inteira em um único contrato.

Um aplicativo financeiro poderia emitir vários ativos fungíveis relacionados por meio de uma mesma interface.

Usar um único contrato pode simplificar operações em lote e reduzir o número de contratos separados que os aplicativos precisam integrar.

Contratos híbridos de tokens

Um contrato FA2 pode combinar diferentes comportamentos de tokens em uma única implementação.

Por exemplo, um ID de token poderia representar um ativo fungível, enquanto outros IDs representariam NFTs únicos.

Um projeto também pode combinar ativos transferíveis e intransferíveis sob políticas cuidadosamente definidas.

Os aplicativos não devem presumir que todos os IDs de token dentro do mesmo contrato FA2 têm oferta, casas decimais, regras de transferência ou metadados idênticos.

Tokens intransferíveis

O FA2 pode oferecer suporte a ativos que não podem ser transferidos livremente após a emissão.

Esses tokens podem representar credenciais, distintivos, reputação, licenças ou registros vinculados a uma conta.

Uma tentativa de transferência pode falhar com o erro padrão de transação FA2 negada quando a política do contrato bloquear transferências.

Os usuários devem verificar as regras de transferência antes de adquirir um token, pois um saldo exibido na carteira não comprova que o ativo possa ser vendido ou movimentado.

Quais são os entrypoints obrigatórios do FA2?

Um contrato compatível com FA2 deve fornecer três entrypoints padronizados chamados transfer, balance_of e update_operators.

Esses entrypoints formam a interface comum usada por aplicativos externos.

Os desenvolvedores podem adicionar outros entrypoints, mas recursos adicionais não substituem as interfaces obrigatórias.

A documentação de entrypoints FA2 da SmartPy explica os parâmetros e o comportamento esperado dessas operações.

Entrypoint transfer

O entrypoint transfer movimenta tokens de uma conta para uma ou mais contas de destino.

Cada item de transferência especifica o endereço de origem, o endereço de destino, o ID do token e a quantidade.

O entrypoint aceita lotes, em vez de limitar cada chamada a uma única transferência.

Um lote pode incluir várias transferências envolvendo diferentes contas e IDs de tokens.

O contrato verifica se cada token indicado existe.

Também verifica se a conta de origem tem tokens suficientes e se quem chamou a função tem permissão para movimentá-los.

A transação falha se uma condição obrigatória não for atendida.

Entrypoint balance_of

O entrypoint balance_of solicita os saldos de um ou mais pares de conta e ID de token.

Ele usa um contrato de callback para receber as informações de saldo solicitadas.

Esse mecanismo de callback permite que outro contrato inteligente solicite saldos e receba os resultados por meio de uma operação interna da Tezos.

Quando apropriado, aplicativos off-chain também podem usar indexadores ou views padronizadas.

Uma consulta de saldo precisa identificar tanto o endereço do proprietário quanto o ID do token.

Saber apenas o endereço da conta não é suficiente quando um contrato gerencia vários tipos de tokens.

Entrypoint update_operators

O entrypoint update_operators permite que os proprietários de tokens adicionem ou removam operadores autorizados.

Cada autorização identifica o proprietário, o operador e o ID do token.

Em geral, apenas o proprietário do token pode alterar as permissões de operador referentes aos próprios tokens.

O contrato pode rejeitar atualizações de operadores quando sua política de transferência não oferece suporte a operadores.

As permissões de operador devem ser removidas quando o marketplace, jogo ou aplicativo não precisar mais delas.

O que são transferências em lote?

As transferências em lote permitem incluir várias movimentações de tokens em uma única chamada ao entrypoint transfer.

Um único lote pode enviar um tipo de token para vários destinatários.

Também pode transferir vários IDs de tokens gerenciados pelo mesmo contrato.

Essa estrutura pode reduzir a repetição de confirmações na carteira e de chamadas ao contrato.

Ela é especialmente útil para jogos, coleções de NFTs, distribuições de tesouraria e aplicativos que gerenciam muitos tipos de ativos.

Toda a operação da Tezos segue regras de execução atômica.

Se uma transferência obrigatória da chamada falhar, a execução relacionada do contrato não deixará um estado parcialmente concluído.

Ainda assim, os aplicativos devem limitar o tamanho dos lotes, pois operações maiores exigem mais processamento computacional e de armazenamento.

O que é um operador FA2?

Um operador é uma conta ou contrato inteligente autorizado a transferir um tipo específico de token em nome de seu proprietário.

Um usuário pode autorizar um marketplace como operador para que ele conclua uma venda depois que um comprador aceitar uma oferta.

A permissão de operador está associada a um proprietário, a um endereço de operador e a um ID de token.

A autorização não se aplica automaticamente a todos os tokens da carteira do proprietário.

No entanto, para o ID de token especificado, o operador geralmente pode transferir qualquer quantidade que o proprietário detenha, de acordo com o modelo padrão de operador.

A permissão não é uma autorização numérica limitada que diminui a cada transferência.

Isso torna prática a aprovação de operadores, mas também cria riscos caso o aplicativo aprovado seja malicioso ou comprometido.

Quando a política do contrato permitir, o proprietário poderá remover um operador pelo entrypoint update_operators.

Como funcionam as políticas de transferência do FA2?

O FA2 permite que os contratos definam diferentes políticas de permissão, mantendo uma interface de transferência compartilhada.

O padrão pode especificar se as transferências são permitidas e se operadores podem ser autorizados.

A documentação de políticas de transferência da SmartPy apresenta modelos comuns de políticas para implementações FA2.

Política sem transferência

Uma política sem transferência impede que detentores e operadores transfiram os tokens afetados.

Esse modelo pode oferecer suporte a credenciais, registros de identidade, distintivos e outros ativos vinculados a uma conta.

Política de transferência pelo proprietário

Uma política de transferência pelo proprietário permite que os proprietários movimentem seus próprios tokens, mas não oferece suporte a operadores.

Um marketplace que dependa de autorização de operador pode não funcionar com esses tokens.

Política de proprietário ou operador

Uma política de proprietário ou operador permite que o proprietário do token ou um operador aprovado o transfira.

Esse é um modelo comum para tokens negociáveis e NFTs.

Transferências pausáveis

Uma implementação personalizada de FA2 pode permitir que um administrador pause transferências e a atividade de operadores.

A pausa pode ajudar a responder a um incidente de segurança.

Ela também concede ao administrador um controle significativo sobre a possibilidade de os detentores movimentarem seus ativos.

Os usuários devem verificar se existe autoridade para pausar, quem a controla e se ela pode ser removida.

O FA2 exige minting?

Não. O FA2 não exige um entrypoint de minting.

Um contrato pode inicializar todos os tokens no momento de sua criação e não oferecer nenhum método para criar mais.

Outra implementação pode incluir uma função de minting controlada por um administrador.

Um jogo pode criar novos itens quando os jogadores concluírem determinadas ações.

Um contrato de NFT pode criar um novo ID de token para cada novo item colecionável.

O tutorial de minting e burning da Tezos explica como adicionar recursos opcionais por meio de uma biblioteca de contratos.

Investidores devem verificar a autoridade de minting efetiva, em vez de presumir que o FA2 estabelece uma oferta máxima fixa.

O FA2 exige burning?

Não. Um entrypoint de burning também é opcional.

O burning remove permanentemente unidades de tokens, de acordo com as regras contábeis do contrato.

Um contrato pode permitir que os usuários queimem seus próprios tokens.

Outro contrato pode restringir o burning a um administrador ou não oferecer nenhum mecanismo para isso.

As permissões de burning afetam a oferta, o resgate, a mecânica dos jogos e a economia do token.

A existência de uma função de burning não garante que o ativo seja deflacionário, pois o minting pode superar o burning.

Como funcionam os metadados de tokens FA2?

Os metadados do token descrevem informações associadas a um ID de token específico.

Os campos comuns incluem nome, símbolo, casas decimais, descrição e links para mídia.

A documentação de metadados de tokens FA2 explica que cada ID de token está associado a seu próprio objeto de metadados.

Os metadados podem ser armazenados diretamente no contrato ou referenciados por um URI externo.

Os metadados de NFTs costumam ser armazenados em um documento JSON referenciado pelo contrato.

O InterPlanetary File System é frequentemente usado para oferecer armazenamento endereçado por conteúdo para esses documentos e arquivos de mídia.

Um link externo para metadados não garante que as informações vinculadas continuarão disponíveis para sempre.

Os arquivos devem ser fixados e ter cópias de segurança para reduzir o risco de desaparecimento.

Quais são os campos padrão dos metadados?

O campo name fornece um nome de exibição para o token.

O campo symbol fornece um identificador curto usado por carteiras e aplicativos.

O campo decimals informa às interfaces como exibir o saldo de um token fungível.

Uma chave de metadados vazia pode apontar para um documento JSON externo com informações adicionais.

Campos personalizados podem descrever arte, atributos, criadores, termos de licenciamento ou dados específicos do aplicativo.

Carteiras podem ignorar campos personalizados desconhecidos.

Os metadados melhoram a apresentação, mas não substituem o registro efetivo do contrato nem sua lógica de transferência.

Um token pode exibir um nome ou símbolo conhecido e, ainda assim, ser emitido por um contrato sem relação com ele.

O endereço do contrato e o ID do token continuam sendo os identificadores técnicos confiáveis.

Metadados do token vs. metadados do contrato

Os metadados do token descrevem um ID de token individual.

Os metadados do contrato descrevem o próprio contrato inteligente FA2.

Os metadados do contrato podem identificar seu nome, versão, autores, interfaces, informações do código-fonte e views disponíveis.

Os metadados de contrato TZIP-16 fornecem uma estrutura padronizada para publicar essas informações on-chain ou por meio de um URI externo.

Um contrato multiativo pode ter um documento de metadados do contrato e vários objetos de metadados de tokens separados.

Os aplicativos não devem confundir o nome de exibição do contrato com o nome de cada token gerenciado por ele.

O que significa o campo decimals?

O campo decimals controla como os aplicativos exibem o saldo inteiro de um token.

Suponha que um contrato registre um saldo bruto de 1,000,000 e que o token use seis casas decimais.

A carteira exibirá esse valor como 1.000000 token.

O contrato continua armazenando um saldo de número natural, e não um valor de ponto flutuante.

Em geral, NFTs usam zero casas decimais, pois cada unidade é indivisível.

Um valor incorreto no campo decimals pode fazer com que a carteira exiba uma quantidade enganosa.

As casas decimais não determinam o preço de mercado nem a oferta máxima do token.

FA2 vs. tez

Tez é a criptomoeda nativa da blockchain Tezos.

Tokens FA2 são ativos gerenciados por contratos inteligentes.

Os saldos de tez fazem parte da contabilidade de contas do protocolo, enquanto os saldos FA2 são registros no armazenamento de um contrato de token.

As taxas de transação da rede são pagas em tez, mesmo quando um usuário transfere um token FA2.

Manter um token FA2 não fornece automaticamente tez suficiente para pagar por uma transação on-chain.

Por isso, uma carteira pode exibir um saldo valioso de tokens, mas não conseguir movimentá-los até que a conta receba tez suficiente para pagar as taxas e os custos de armazenamento.

FA2 vs. FA1.2

FA1.2 é uma interface anterior da Tezos para tokens, projetada para tokens fungíveis.

O FA2 oferece suporte a uma gama mais ampla de ativos, incluindo tokens fungíveis, NFTs, tokens intransferíveis e contratos multiativos.

O FA2 também usa IDs de tokens e operações orientadas a lotes.

O modelo de operadores difere de um modelo de autorização numérica porque um operador FA2 aprovado geralmente pode transferir o saldo disponível do proprietário para o ID de token especificado.

Um token FA1.2 não se torna automaticamente um token FA2.

Se um emissor decidir mudar de padrão, a migração exige um processo deliberado de contrato e conversão de ativos.

Os dois padrões podem continuar coexistindo na Tezos.

FA2 vs. NFT

FA2 é uma interface de tokens, enquanto NFT descreve um tipo de ativo não fungível.

Um NFT na Tezos pode ser implementado por meio de um contrato compatível com FA2.

No entanto, nem todo token FA2 é um NFT.

O mesmo padrão pode gerenciar saldos fungíveis comuns e muitos outros modelos de tokens.

Chamar um ativo de FA2 descreve sua interface técnica, mas não explica completamente suas características econômicas.

FA2 vs. contrato multiativo

O FA2 permite contratos multiativos, mas um contrato FA2 não precisa conter vários tipos de tokens.

Um contrato fungível com um único token ainda pode seguir o FA2.

Um contrato de uma coleção de NFTs também pode seguir o FA2.

O suporte a vários ativos é uma capacidade do padrão, e não uma exigência de uso para todas as implementações.

Como as carteiras exibem tokens FA2?

Uma carteira pode usar o endereço do contrato, o ID do token, as informações do registro, os metadados e os dados do indexador para exibir um ativo FA2.

A carteira pode mostrar o nome, o símbolo, o saldo, a imagem e as opções de transferência do token.

Alguns tokens podem não aparecer automaticamente se os metadados estiverem ausentes ou se a carteira ainda não tiver indexado o contrato.

A ausência de exibição não significa necessariamente que o saldo on-chain seja zero.

Os usuários devem confirmar o endereço do contrato, o ID do token e os dados da blockchain por meio de um explorador ou indexador compatível.

A interface de uma carteira não deve ser tratada como a fonte definitiva quando divergir do armazenamento real do contrato.

Como os marketplaces usam operadores FA2?

Um marketplace pode pedir ao proprietário do token que adicione o contrato do marketplace como operador.

Essa permissão permite que o marketplace transfira o token especificado após a conclusão de uma venda.

O proprietário não precisa assinar uma transação separada de transferência do token exatamente no momento em que o comprador aceita a listagem.

O marketplace deve usar a permissão somente conforme as regras de venda publicadas.

Um marketplace malicioso poderia tentar uma transferência não autorizada enquanto a aprovação permanecesse ativa.

Os usuários devem verificar o endereço do operador antes de aprová-lo.

Também devem remover as permissões de aplicativos em que já não confiam ou que não usam mais.

Quais são os erros padrão do FA2?

O FA2 define nomes de erros padrão para que carteiras e aplicativos descentralizados interpretem falhas comuns de maneira consistente.

A documentação de erros FA2 lista as categorias padrão de erro usadas por implementações compatíveis.

FA2_TOKEN_UNDEFINED significa que o ID de token solicitado não existe no contrato.

FA2_INSUFFICIENT_BALANCE significa que a conta de origem não possui tokens suficientes para a transferência solicitada.

FA2_NOT_OPERATOR significa que quem chamou a função não tem permissão para transferir os tokens do proprietário.

FA2_NOT_OWNER significa que uma ação reservada ao proprietário foi solicitada por outra conta.

FA2_TX_DENIED significa que a política do contrato rejeitou a transferência.

FA2_OPERATORS_UNSUPPORTED significa que o contrato não permite o comportamento de operador solicitado.

Os contratos podem definir outros erros personalizados para recursos que não fazem parte do padrão.

Riscos de segurança dos tokens FA2

A compatibilidade com FA2 não garante a segurança de um contrato inteligente.

Um contrato pode conter uma falha que altere incorretamente os saldos ou permita minting não autorizado.

Um administrador pode ter permissão para pausar transferências, criar tokens sem limite, modificar metadados ou controlar outros comportamentos importantes.

Um contrato malicioso pode exibir o nome de um token conhecido e, ainda assim, usar regras econômicas sem relação com ele.

As permissões de operador podem expor ativos quando os usuários aprovam um aplicativo inseguro.

Metadados externos podem desaparecer ou mudar quando não são armazenados por um método que protege sua integridade.

Entrypoints personalizados não verificados podem criar comportamentos que as interfaces padrão das carteiras não revelam.

Os usuários devem verificar o endereço do contrato, o código-fonte, o histórico de auditorias, os controles de minting, a política de transferência, o armazenamento de metadados e os poderes administrativos.

Risco das permissões de operador

Uma aprovação de operador FA2 é poderosa porque está vinculada a um ID de token, e não a uma pequena quantidade de uso único.

Enquanto a autorização estiver ativa, o operador pode movimentar o saldo disponível do proprietário para aquele tipo de token.

Um aplicativo enganoso pode apresentar uma solicitação de operador como se fosse um login ou uma conexão de conta inofensiva.

Os usuários de carteiras devem ler os detalhes da transação e verificar o endereço do operador.

Desconectar uma carteira de um site não necessariamente remove uma autorização de operador on-chain.

Quando precisar revogar a permissão, o usuário deverá enviar a ação apropriada de remoção do operador.

Risco de minting e de oferta

O padrão FA2 não impõe uma oferta máxima universal.

O emissor do token pode manter a capacidade de criar tokens adicionais.

Novas emissões podem diluir os detentores existentes ou reduzir a escassez de uma coleção de NFTs.

O comprometimento de uma chave de administrador pode gerar oferta não autorizada quando o poder de minting é centralizado.

Os usuários devem descobrir quem pode criar tokens, se existe um limite e se a autoridade pode ser alterada.

As alegações de metadados sobre oferta fixa devem ser confirmadas pelo comportamento efetivo do contrato.

Risco de restrições de transferência

Um token FA2 pode usar uma política que limite ou impeça completamente as transferências.

Assim, um token pode aparecer em uma carteira, mas ser impossível de vender ou enviar.

Um administrador também pode ter um mecanismo de pausa quando a implementação inclui esse recurso.

Restrições de transferência podem atender a finalidades legítimas de segurança, identidade ou conformidade.

Elas também podem criar riscos inesperados de custódia e liquidez para os detentores.

Antes de atribuir valor financeiro a um token desconhecido, os usuários devem testar ou verificar suas regras de transferência.

Risco de metadados e mídia

A propriedade on-chain não garante acesso permanente à mídia off-chain.

Um NFT pode apontar para uma imagem ou documento hospedado fora da blockchain.

O arquivo pode ficar indisponível se a hospedagem for encerrada ou se um objeto de armazenamento não fixado for removido.

Um endereço web mutável também pode exibir conteúdo diferente posteriormente.

O armazenamento endereçado por conteúdo melhora a integridade, pois a alteração do arquivo muda seu identificador de conteúdo.

A disponibilidade ainda depende de alguém manter e fornecer os dados.

Os colecionadores devem verificar o URI dos metadados, o método de armazenamento, o hash do conteúdo e o plano de cópias de segurança.

Como desenvolvedores podem criar contratos FA2

Os desenvolvedores podem implementar a TZIP-12 diretamente, mas o uso de uma biblioteca mantida pode reduzir erros de interface e de testes.

A biblioteca FA2 da SmartPy fornece classes-base para tokens fungíveis, NFTs e contratos de ativo único.

Ela também fornece módulos opcionais para recursos como administração, minting, burning e políticas de transferência.

Os desenvolvedores devem escolher apenas os recursos exigidos pelo projeto.

Poderes administrativos não utilizados podem aumentar o risco sem melhorar a funcionalidade.

Cada entrypoint personalizado deve preservar o comportamento obrigatório e as expectativas de erro do padrão.

Os contratos devem ser testados em um ambiente de testes da Tezos antes da implantação na mainnet.

Boas práticas de desenvolvimento para FA2

Use as estruturas de parâmetros exatas da TZIP-12 para os entrypoints obrigatórios.

Teste transferências individuais, transferências em lote, transferências de valor zero e saldos insuficientes.

Teste todas as ações de operador compatíveis e não compatíveis.

Verifique se IDs de tokens inexistentes geram as falhas apropriadas.

Documente claramente as permissões de minting, burning, pausa e administração.

Publique os metadados do contrato e dos tokens em locais estáveis que protejam sua integridade.

Use os nomes de erros padrão para falhas abrangidas pelo FA2.

Teste as integrações com carteiras, indexadores, marketplaces e aplicativos.

Revise o crescimento do armazenamento e os custos de transação para lotes ou coleções grandes.

Solicite uma análise de segurança independente antes de gerenciar ativos valiosos.

O que é FA2.1?

FA2.1 é uma evolução proposta da interface de tokens FA2.

Está associada à TZIP-26 e adiciona conceitos como eventos, views on-chain, autorizações finitas e tickets Tezos.

A documentação atual da SmartPy descreve o FA2.1 como um rascunho.

Os desenvolvedores não devem presumir que todas as carteiras ou aplicativos FA2 oferecem suporte automático aos recursos específicos do FA2.1.

Os contratos FA2 existentes continuam sendo implantações distintas e não mudam automaticamente quando uma proposta mais recente é desenvolvida.

Os projetos que consideram o FA2.1 devem estudar cuidadosamente seus mecanismos adicionais e o suporte atual das ferramentas.

Equívocos comuns sobre FA2

FA2 não é uma criptomoeda por si só.

É um padrão que contratos inteligentes de tokens podem implementar.

FA2 não significa que todos os tokens sejam fungíveis.

FA2 não significa que todos os tokens sejam NFTs.

Um contrato FA2 não necessariamente gerencia vários ativos.

O ID do token, por si só, não identifica um token FA2 de forma única.

A compatibilidade com FA2 não garante uma oferta fixa.

Minting e burning não são exigidos pelo padrão.

Um operador FA2 não está necessariamente limitado a uma unidade de token ou a uma única transferência.

Os metadados não determinam a propriedade efetiva nem os direitos de transferência.

Um saldo visível na carteira não comprova que o token possa ser transferido ou vendido.

A conformidade com FA2 não comprova que o contrato tenha sido auditado ou esteja livre de comportamentos maliciosos.

Perguntas frequentes

O que significa FA2 na Tezos?

FA2 significa Financial Application 2, um padrão unificado de tokens da Tezos formalmente definido pela TZIP-12.

FA2 é uma criptomoeda?

Não. FA2 é uma interface de contrato inteligente que pode ser usada para criar muitas criptomoedas e ativos digitais diferentes.

FA2 serve apenas para NFTs?

Não. FA2 oferece suporte a tokens fungíveis, NFTs, contratos multiativos, ativos intransferíveis e modelos personalizados de tokens.

Um contrato FA2 pode conter vários tokens?

Sim. Um contrato pode gerenciar vários IDs de tokens com ofertas, proprietários, metadados e comportamentos diferentes.

Como identificar um token FA2 de forma única?

Ele é identificado pela combinação do endereço do contrato Tezos e do ID do token.

Qual ID de token um contrato FA2 de token único usa?

Um contrato que oferece suporte a apenas um tipo de token deve usar o ID 0.

Onde os saldos FA2 ficam armazenados?

Eles ficam armazenados no registro mantido pelo contrato inteligente FA2.

Os tokens FA2 ficam armazenados diretamente em uma carteira?

A carteira controla a conta, enquanto o registro do contrato do token mantém o saldo ou a propriedade dessa conta.

Quais são os entrypoints obrigatórios do FA2?

Os entrypoints obrigatórios são transfer, balance_of e update_operators.

O que faz o entrypoint transfer?

Ele movimenta uma ou mais quantidades de tokens de contas de origem para contas de destino por meio de uma interface que permite operações em lote.

O que faz balance_of?

Ele solicita saldos para pares de conta e ID de token e envia os resultados para um contrato de callback.

O que faz update_operators?

Ele permite que os proprietários de tokens adicionem ou removam contas autorizadas a transferir, em seu nome, os IDs de tokens especificados.

O que é um operador FA2?

Um operador é uma conta ou contrato autorizado a movimentar um tipo especificado de token pertencente a outra conta.

Um operador pode transferir todos os tokens de um proprietário?

Para o ID de token autorizado, o operador geralmente pode transferir o saldo disponível do proprietário enquanto a aprovação estiver ativa.

Uma aprovação de operador FA2 pode ser removida?

Sim. O proprietário pode enviar uma ação de remoção do operador quando a política de transferência do contrato oferecer suporte a operadores.

Desconectar uma carteira remove um operador?

Não. Desconectar uma sessão de um site não revoga automaticamente uma permissão de operador on-chain.

Os tokens FA2 podem ser intransferíveis?

Sim. Uma implementação FA2 pode usar uma política que rejeite todas as transferências comuns.

Um contrato FA2 pode pausar transferências?

Pode, se a implementação incluir um recurso de pausa controlado por um administrador.

O FA2 exige uma função de minting?

Não. O minting é opcional e depende do projeto do contrato.

O FA2 exige uma função de burning?

Não. O burning também é um recurso opcional.

O FA2 garante uma oferta máxima?

Não. Os limites de oferta e a autoridade de minting são definidos por cada contrato de token.

O que são metadados de tokens FA2?

São informações associadas a um ID de token, como nome, símbolo, casas decimais, descrição e links para mídia.

O que são metadados de contrato FA2?

São informações sobre o próprio contrato inteligente, incluindo nome, versão, interfaces, informações do código-fonte e views.

O que o campo decimals faz?

Ele informa às carteiras como exibir o saldo inteiro do token com uma vírgula decimal.

As casas decimais tornam um token divisível?

Elas definem uma convenção de exibição para unidades inteiras, enquanto a lógica de transferência e de oferta do contrato determina a divisibilidade prática do ativo.

As taxas de transação FA2 são pagas no próprio token?

Em geral, as taxas do protocolo Tezos são pagas em tez, mesmo quando a transação transfere um token FA2.

Qual é a diferença entre tez e um token FA2?

Tez é a criptomoeda nativa da Tezos, enquanto um token FA2 é gerenciado pelo registro de um contrato inteligente.

Qual é a diferença entre FA1.2 e FA2?

FA1.2 se concentra em tokens fungíveis, enquanto FA2 oferece suporte a tipos mais amplos de tokens, IDs de tokens, transferências em lote e contratos multiativos.

Uma carteira consegue detectar automaticamente todos os tokens FA2?

Nem sempre. A detecção depende da indexação, dos metadados, do suporte do contrato e da integração da carteira.

Um token FA2 pode ter metadados falsos?

Sim. Qualquer pessoa pode criar um contrato com nome, símbolo, imagem ou descrição enganosos.

A conformidade com FA2 significa que um token é seguro?

Não. A conformidade demonstra compatibilidade de interface, mas não comprova segurança, valor, legitimidade ou status legal.

Um NFT FA2 pode perder sua imagem?

Sim. A mídia armazenada externamente pode ficar indisponível quando não é preservada ou hospedada de forma confiável.

O que é FA2.1?

FA2.1 é um rascunho de evolução do FA2 que propõe recursos como eventos, views on-chain, autorizações finitas e tickets.

FA2.1 substitui automaticamente o FA2?

Não. Os contratos FA2 existentes continuam sendo implantações separadas, e o suporte a recursos específicos do FA2.1 depende dos padrões e das ferramentas atuais.

Conclusão

FA2 é o padrão unificado de tokens da Tezos, definido pela TZIP-12.

Ele fornece uma interface comum para tokens fungíveis, NFTs, ativos intransferíveis, sistemas híbridos de tokens e contratos inteligentes multiativos.

Cada token FA2 é identificado pela combinação do endereço do contrato e do ID do token.

O padrão exige os entrypoints transfer, balance_of e update_operators.

Seu design orientado a lotes permite processar várias movimentações ou solicitações de tokens por meio de uma chamada ao contrato.

As permissões de operador permitem que aplicativos transfiram tipos especificados de tokens em nome dos proprietários, mas os usuários devem revogar as permissões de que já não precisam.

O FA2 dá aos desenvolvedores ampla liberdade para definir políticas de transferência, regras de oferta, minting, burning, administração e recursos personalizados.

Essa flexibilidade oferece suporte a muitos casos de uso cripto, mas torna essencial a análise criteriosa de cada contrato.

Antes de interagir com um ativo FA2 desconhecido, os usuários devem verificar o endereço do contrato, o ID do token, os metadados, os controles de oferta, as regras de transferência, as permissões de operador, o código-fonte e a autoridade administrativa.

A padronização FA2 melhora a compatibilidade em todo o ecossistema Tezos, mas não garante que um token seja seguro, valioso, transferível ou legítimo.